locale.1, localedef.1, _exit.2, accept.2, access.2, acct.2, adjtimex.2, bdflush.2...

[thirdparty/man-pages.git] / man3 / exec.3

diff --git a/man3/exec.3 b/man3/exec.3
index e99780773944f06fd88a9ab57dd3afd56f3f8a41..bd8bad7e3c19392144624d8b8a0249ce3028583f 100644 (file)
--- a/man3/exec.3
+++ b/man3/exec.3
@@ -1,6 +1,7 @@
 .\" Copyright (c) 1991 The Regents of the University of California.
 .\" All rights reserved.
 .\"
+.\" %%%LICENSE_START(BSD_4_CLAUSE_UCB)
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
@@ -28,6 +29,7 @@
 .\" 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
 .\" SUCH DAMAGE.
+.\" %%%LICENSE_END
 .\"
 .\"     @(#)exec.3     6.4 (Berkeley) 4/19/91
 .\"
@@ -36,7 +38,7 @@
 .\" Modified, 24 Jun 2004, Michael Kerrisk <mtk.manpages@gmail.com>
 .\"     Added note on casting NULL
 .\"
-.TH EXEC 3  2010-09-25 "GNU" "Linux Programmer's Manual"
+.TH EXEC 3  2016-03-15 "GNU" "Linux Programmer's Manual"
 .SH NAME
 execl, execlp, execle, execv, execvp, execvpe \- execute a file
 .SH SYNOPSIS
@@ -44,13 +46,17 @@ execl, execlp, execle, execv, execvp, execvpe \- execute a file
 .sp
 .B extern char **environ;
 .sp
-.BI "int execl(const char *" path ", const char *" arg ", ...);"
+.BI "int execl(const char *" path ", const char *" arg ", ..."
 .br
-.BI "int execlp(const char *" file ", const char *" arg ", ...);"
+.B  "                /* (char  *) NULL */);"
 .br
-.BI "int execle(const char *" path ", const char *" arg ,
+.BI "int execlp(const char *" file ", const char *" arg ", ..."
 .br
-.BI "           ..., char * const " envp "[]);"
+.B  "                /* (char  *) NULL */);"
+.br
+.BI "int execle(const char *" path ", const char *" arg ", ..."
+.br
+.BI "                /*, (char *) NULL, char * const " envp "[] */);"
 .br
 .BI "int execv(const char *" path ", char *const " argv "[]);"
 .br
@@ -58,7 +64,7 @@ execl, execlp, execle, execv, execvp, execvpe \- execute a file
 .br
 .BI "int execvpe(const char *" file ", char *const " argv "[],"
 .br
-.BI "           char *const " envp "[]);"
+.BI "                char *const " envp "[]);"
 .sp
 .in -4n
 Feature Test Macro Requirements for glibc (see
@@ -82,7 +88,7 @@ The initial argument for these functions is the name of a file that is
 to be executed.
 .PP
 The
-.I "const char *arg"
+.I "const char\ *arg"
 and subsequent ellipses in the
 .BR execl (),
 .BR execlp (),
@@ -99,9 +105,9 @@ The first argument, by convention, should point to the filename associated
 with the file being executed.
 The list of arguments
 .I must
-be terminated by a NULL
-pointer, and, since these are variadic functions, this pointer must be cast
-.IR "(char *) NULL" .
+be terminated by a null pointer,
+and, since these are variadic functions, this pointer must be cast
+.IR "(char\ *) NULL" .
 .PP
 The
 .BR execv (),
@@ -114,7 +120,7 @@ The first argument, by convention, should point to the filename
 associated with the file being executed.
 The array of pointers
 .I must
-be terminated by a NULL pointer.
+be terminated by a null pointer.
 .PP
 The
 .BR execle ()
@@ -127,7 +133,7 @@ The
 .I envp
 argument is an array of pointers to null-terminated strings and
 .I must
-be terminated by a NULL pointer.
+be terminated by a null pointer.
 The other functions take the environment for the new process
 image from the external variable
 .I environ
@@ -178,10 +184,10 @@ these functions will execute the shell
 .RI ( /bin/sh )
 with the path of the file as its first argument.
 (If this attempt fails, no further searching is done.)
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 The
 .BR exec ()
-functions only return if an error has have occurred.
+functions return only if an error has occurred.
 The return value is \-1, and
 .I errno
 is set to indicate the error.
@@ -194,7 +200,26 @@ for any of the errors specified for
 The
 .BR execvpe ()
 function first appeared in glibc 2.11.
-.SH "CONFORMING TO"
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbw29 lb lb
+l l l.
+Interface      Attribute       Value
+T{
+.BR execl (),
+.BR execle (),
+.BR execv ()
+T}     Thread safety   MT-Safe
+T{
+.BR execlp (),
+.BR execvp (),
+.BR execvpe ()
+T}     Thread safety   MT-Safe env
+.TE
+.SH CONFORMING TO
 POSIX.1-2001, POSIX.1-2008.
 
 The
@@ -236,10 +261,12 @@ and
 upon which they returned.
 They now return if any error other than the ones
 described above occurs.
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR sh (1),
 .BR execve (2),
+.BR execveat (2),
 .BR fork (2),
 .BR ptrace (2),
 .BR fexecve (3),
+.BR system (3),
 .BR environ (7)