.\" Copyright (c) 1991 The Regents of the University of California.
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by the University of
.\" California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\" may be used to endorse or promote products derived from this software
.\" without specific prior written permission.
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" @(#)exec.3 6.4 (Berkeley) 4/19/91
.Vt extern char **environ;
.Fn execl "const char *path" "const char *arg" ...
.Fn execlp "const char *file" "const char *arg" ...
.Fn execle "const char *path" "const char *arg" ... "char *const envp[]"
.Fn exect "const char *path" "char *const argv[]"
.Fn execv "const char *path" "char *const argv[]"
.Fn execvp "const char *file" "char *const argv[]"
family of functions replaces the current process image with a
The functions described in this manual page are front-ends for the function
for detailed information about the replacement of the current process.)
The initial argument for these functions is the pathname of a file which
and subsequent ellipses in the
functions can be thought of as
Together they describe a list of one or more pointers to null-terminated
strings that represent the argument list available to the executed program.
The first argument, by convention, should point to the file name associated
with the file being executed.
functions provide an array of pointers to null-terminated strings that
represent the argument list available to the new program.
The first argument, by convention, should point to the file name associated
with the file begin executed.
functions also specify the environment of the executed process by following
pointer that terminates the list of arguments in the parameter list
or the pointer to the argv array with an additional parameter.
This additional parameter is an array of pointers to null-terminated strings
The other functions take the environment for the new process image from the
Some of these functions have special semantics.
will duplicate the actions of the shell in searching for an executable file
if the specified file name does not contain a slash
The search path is the path specified in the environment by
If this variable isn't specified, the default path
In addtion, certain errors are treated specially.
If permission is denied for a file (the attempted
these functions will continue searching the rest of
If no other file is found, however, they will return with the global variable
If the header of a file isn't recognized (the attempted
these functions will execute the shell with the path of
the file as its first argument.
(If this attempt fails, no further searching is done.)
If the file is currently busy (the attempted
these functions will sleep for several seconds,
periodically re-attempting to execute the file.
executes a file with the program tracing facilities enabled (see
functions returns, an error will have occurred.
The return value is \-1, and the global variable
will be set to indicate the error.
.Bl -tag -width /bin/sh - compact
for any of the errors specified for the library functions
for any of the errors specified for the library function
Historically, the default path for the
This was changed to place the current directory last to enhance system
when errors occur while attempting to execute the file is historic
practice, but has not traditionally been documented and is not specified
Traditionally, the functions
ignored all errors except for the ones described above and
upon which they returned.
They now return if any error other than the ones described above occurs.