execlpe() -- General Function (libc)

Execute a load module
execlpe(file, arg0, arg1, ..., argn, NULL, env)
char *file, *arg0, *arg1, ..., *argn;
char *env[];

The function execlpe() calls the COHERENT system call execve() to execute a
program.  It initializes the new stack  of the process to contain a list of
strings that  are command arguments.  It  specifies arguments individually,
as a NULL-terminated list of arg parameters.

The argument  env points  to an  array of pointers  to strings  that define
file's environment.

Unlike the  related function  execl(), execlpe()  searches for file  in all
directories named in the environmental variable PATH-- that is, the current
PATH, not the one contained within the environmented pointed to by env.

For more information on program execution, see execution.

See Also

environ,
execution,
execl(),
execvep(),
libc

Diagnostics

execlpe() does not return if successful.  It returns -1 for errors, such as
file not  existing in  the directories named  in PATH, not  accessible with
execute permission, having a bad format, or too large to fit in memory.

execlpe() is not part of the  SVID specification.  Therefore, it may not be
present on non-COHERENT operating systems.

© 2012 by Stephen A. Ness