SYNTAX
#include "pathexec.h"
pathexec_run(char *p,char **a,char **e);
pathexec(char **a);
pathexec_env(char *s,char *t);
DESCRIPTION
pathexec_run searches for a program named p. It replaces the current
process with a copy of that program. The main function in that program
will be given arguments a and environment e. pathexec_run looks for p
as specified by the $PATH environment variable. $PATH is a colon-
separated list of directories d; pathexec_run tries execve on files
named d/p, in the order that the directories appear inside $PATH. An
empty directory name is treated as a single dot.
If $PATH is not set, pathexec_run uses the path /bin:/usr/bin; i.e., it
tries execve on /bin/p, then /usr/bin/p.
If p contains a slash, pathexec_run ignores $PATH and simply runs
execve on a file named p.
pathexec calls pathexec_run with program name a[0], arguments a, and
the same environment as the current process, modified as described
below. pathexec has the same return behavior as pathexec_run.
pathexec_env modifies the environment used by pathexec. It removes a
variable named s, if one exists. It then adds a variable named s with
value t, if the pointer t is nonzero. The name s must not contain =.
RETURN CODES
Normally pathexec_run does not return, because the process has been
replaced. However, if all the execve attempts fail, pathexec_run
returns, setting errno to the most interesting error returned by
execve. Furthermore, pathexec_run returns immediately if an execve
attempt fails with an error other than error_noent, error_acces,
error_perm, or error_isdir. This list is subject to change.
Normally pathexec_env returns 1. If it is unable to allocate memory,
it returns 0, leaving the pathexec environment alone.
SEE ALSO
error(3)
3 qlibs:(pathexec)
Man(1) output converted with
man2html