X-Git-Url: https://git.saurik.com/apple/libc.git/blobdiff_plain/1f2f436a38f7ae2d39a943ad2898d8fed4ed2e58..fc56b708803d28b949a9181528bb0da4d25b3b7b:/gen/FreeBSD/exec.3 diff --git a/gen/FreeBSD/exec.3 b/gen/FreeBSD/exec.3 index bf5164e..2f49ef3 100644 --- a/gen/FreeBSD/exec.3 +++ b/gen/FreeBSD/exec.3 @@ -33,9 +33,8 @@ .Os .Sh NAME .Nm execl , -.Nm execlp , .Nm execle , -.Nm exect , +.Nm execlp , .Nm execv , .Nm execvp , .Nm execvP @@ -46,25 +45,43 @@ .In unistd.h .Vt extern char **environ ; .Ft int -.Fn execl "const char *path" "const char *arg" ... /* "(char *)0" */ -.Ft int -.Fn execlp "const char *file" "const char *arg" ... /* "(char *)0" */ +.Fo execl +.Fa "const char *path" +.Fa "const char *arg0" +.Fa ... /* "(char *)0" */ +.Fc .Ft int .Fo execle -.Fa "const char *path" "const char *arg" ... +.Fa "const char *path" +.Fa "const char *arg0" +.Fa ... .Fa /* .Bk -words .Fa "(char *)0" "char *const envp[]" */ .Ek .Fc .Ft int -.Fn exect "const char *path" "char *const argv[]" "char *const envp[]" +.Fo execlp +.Fa "const char *file" +.Fa "const char *arg0" +.Fa ... /* "(char *)0" */ +.Fc .Ft int -.Fn execv "const char *path" "char *const argv[]" +.Fo execv +.Fa "const char *path" +.Fa "char *const argv[]" +.Fc .Ft int -.Fn execvp "const char *file" "char *const argv[]" +.Fo execvp +.Fa "const char *file" +.Fa "char *const argv[]" +.Fc .Ft int -.Fn execvP "const char *file" "const char *search_path" "char *const argv[]" +.Fo execvP +.Fa "const char *file" +.Fa "const char *search_path" +.Fa "char *const argv[]" +.Fc .Sh DESCRIPTION The .Nm exec @@ -80,7 +97,7 @@ The initial argument for these functions is the pathname of a file which is to be executed. .Pp The -.Fa "const char *arg" +.Fa "const char *arg0" and subsequent ellipses in the .Fn execl , .Fn execlp , @@ -102,7 +119,6 @@ be terminated by a pointer. .Pp The -.Fn exect , .Fn execv , .Fn execvp , and @@ -119,10 +135,8 @@ pointer. .Pp The .Fn execle -and -.Fn exect -functions also specify the environment of the executed process by following -the +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. @@ -199,11 +213,6 @@ returned 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 @@ -277,7 +286,7 @@ The .Fn execl , .Fn execle , .Fn execlp , -.Fn execvp +.Fn execvp , and .Fn execvP functions @@ -289,11 +298,8 @@ and .Xr malloc 3 . .Pp The -.Fn exect -and .Fn execv -functions -may fail and set +function may fail and set .Va errno for any of the errors specified for the library function .Xr execve 2 . @@ -301,7 +307,6 @@ for any of the errors specified for the library function .Xr sh 1 , .Xr execve 2 , .Xr fork 2 , -.Xr ktrace 2 , .Xr ptrace 2 , .Xr environ 7 .Sh STANDARDS @@ -309,7 +314,7 @@ The .Fn execl , .Fn execv , .Fn execle , -.Fn execlp +.Fn execlp , and .Fn execvp functions