Loading...
gen/exec.3 Libc-763.11 Libc-262
--- Libc/Libc-763.11/gen/exec.3
+++ Libc/Libc-262/gen/exec.3
@@ -9,6 +9,10 @@
 .\" 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.
@@ -26,18 +30,18 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)exec.3	8.3 (Berkeley) 1/24/94
-.\" $FreeBSD: src/lib/libc/gen/exec.3,v 1.28 2008/06/23 05:22:06 ed Exp $
+.\" $FreeBSD: src/lib/libc/gen/exec.3,v 1.16 2001/10/01 16:08:50 ru Exp $
 .\"
 .Dd January 24, 1994
 .Dt EXEC 3
 .Os
 .Sh NAME
 .Nm execl ,
+.Nm execlp ,
 .Nm execle ,
-.Nm execlp ,
+.Nm exect ,
 .Nm execv ,
-.Nm execvp ,
-.Nm execvP
+.Nm execvp
 .Nd execute a file
 .Sh LIBRARY
 .Lb libc
@@ -45,43 +49,17 @@
 .In unistd.h
 .Vt extern char **environ ;
 .Ft int
-.Fo execl
-.Fa "const char *path"
-.Fa "const char *arg0"
-.Fa ... /* "(char *)0" */
-.Fc
-.Ft int
-.Fo execle
-.Fa "const char *path"
-.Fa "const char *arg0"
-.Fa ...
-.Fa /*
-.Bk -words
-.Fa "(char *)0" "char *const envp[]" */
-.Ek
-.Fc
-.Ft int
-.Fo execlp
-.Fa "const char *file"
-.Fa "const char *arg0"
-.Fa ... /* "(char *)0" */
-.Fc
-.Ft int
-.Fo execv
-.Fa "const char *path"
-.Fa "char *const argv[]"
-.Fc
-.Ft int
-.Fo execvp
-.Fa "const char *file"
-.Fa "char *const argv[]"
-.Fc
-.Ft int
-.Fo execvP
-.Fa "const char *file"
-.Fa "const char *search_path"
-.Fa "char *const argv[]"
-.Fc
+.Fn execl "const char *path" "const char *arg" ...
+.Ft int
+.Fn execlp "const char *file" "const char *arg" ...
+.Ft int
+.Fn execle "const char *path" "const char *arg" ...
+.Ft int
+.Fn exect "const char *path" "char *const argv[]" "char *const envp[]"
+.Ft int
+.Fn execv "const char *path" "char *const argv[]"
+.Ft int
+.Fn execvp "const char *file" "char *const argv[]"
 .Sh DESCRIPTION
 The
 .Nm exec
@@ -97,7 +75,7 @@
 is to be executed.
 .Pp
 The
-.Fa "const char *arg0"
+.Fa "const char *arg"
 and subsequent ellipses in the
 .Fn execl ,
 .Fn execlp ,
@@ -119,10 +97,10 @@
 pointer.
 .Pp
 The
+.Fn exect ,
 .Fn execv ,
-.Fn execvp ,
-and
-.Fn execvP
+and
+.Fn execvp
 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
@@ -135,12 +113,14 @@
 .Pp
 The
 .Fn execle
-function also specifies the environment of the executed process
-by following the
-.Dv NULL
-pointer that terminates the list of arguments in the argument list
-or the pointer to the argv array with an additional argument.
-This additional argument is an array of pointers to null-terminated strings
+and
+.Fn exect
+functions also specify the environment of the executed process by following
+the
+.Dv NULL
+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
 and
 .Em must
 be terminated by a
@@ -154,31 +134,23 @@
 Some of these functions have special semantics.
 .Pp
 The functions
-.Fn execlp ,
-.Fn execvp ,
-and
-.Fn execvP
+.Fn execlp
+and
+.Fn execvp
 will duplicate the actions of the shell in searching for an executable file
 if the specified file name does not contain a slash
 .Dq Li /
 character.
-For
-.Fn execlp
-and
-.Fn execvp ,
-search path is the path specified in the environment by
+The search path is the path specified in the environment by
 .Dq Ev PATH
 variable.
-If this variable is not specified,
+If this variable isn't specified,
 the default path is set according to the
 .Dv _PATH_DEFPATH
 definition in
-.In paths.h ,
+.Aq paths.h ,
 which is set to
 .Dq Ev /usr/bin:/bin .
-For
-.Fn execvP ,
-the search path is specified as an argument to the function.
 In addition, certain errors are treated specially.
 .Pp
 If an error is ambiguous (for simplicity, we shall consider all
@@ -206,13 +178,18 @@
 according to whether at least one file with suitable execute permissions
 was found.
 .Pp
-If the header of a file is not recognized (the attempted
+If the header of a file isn't recognized (the attempted
 .Fn execve
 returned
 .Er ENOEXEC ) ,
 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.)
+.Pp
+The function
+.Fn exect
+executes a file with the program tracing facilities enabled (see
+.Xr ptrace 2 ) .
 .Sh RETURN VALUES
 If any of the
 .Fn exec
@@ -225,6 +202,33 @@
 .It Pa /bin/sh
 The shell.
 .El
+.Sh ERRORS
+.Fn Execl ,
+.Fn execle ,
+.Fn execlp
+and
+.Fn execvp
+may fail and set
+.Va errno
+for any of the errors specified for the library functions
+.Xr execve 2
+and
+.Xr malloc 3 .
+.Pp
+.Fn Exect
+and
+.Fn execv
+may fail and set
+.Va errno
+for any of the errors specified for the library function
+.Xr execve 2 .
+.Sh SEE ALSO
+.Xr sh 1 ,
+.Xr execve 2 ,
+.Xr fork 2 ,
+.Xr ktrace 2 ,
+.Xr ptrace 2 ,
+.Xr environ 7
 .Sh COMPATIBILITY
 Historically, the default path for the
 .Fn execlp
@@ -281,46 +285,12 @@
 .Er EIO .
 The behaviour was changed to match the behaviour of
 .Xr sh 1 .
-.Sh ERRORS
-The
-.Fn execl ,
-.Fn execle ,
-.Fn execlp ,
-.Fn execvp ,
-and
-.Fn execvP
-functions
-may fail and set
-.Va errno
-for any of the errors specified for the library functions
-.Xr execve 2
-and
-.Xr malloc 3 .
-.Pp
-The
-.Fn execv
-function may fail and set
-.Va errno
-for any of the errors specified for the library function
-.Xr execve 2 .
-.Sh SEE ALSO
-.Xr sh 1 ,
-.Xr execve 2 ,
-.Xr fork 2 ,
-.Xr ptrace 2 ,
-.Xr environ 7
 .Sh STANDARDS
-The
-.Fn execl ,
+.Fn Execl ,
 .Fn execv ,
 .Fn execle ,
-.Fn execlp ,
-and
-.Fn execvp
-functions
+.Fn execlp
+and
+.Fn execvp
 conform to
 .St -p1003.1-88 .
-The
-.Fn execvP
-function first appeared in
-.Fx 5.2 .