execve.2, exec.3: Consistently use the term 'pathname' (not 'path')

Reported-by: Dr. Jürgen Sauermann <mail@xn--jrgen-sauermann-zvb.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man2/execve.2 b/man2/execve.2
index 214ea2426f798d02f8c71ce5ef0b89423b6d22f5..1776314da7568f5861c561f48840d880b2923b36 100644 (file)
--- a/man2/execve.2
+++ b/man2/execve.2
@@ -40,17 +40,17 @@ execve \- execute program
 .SH SYNOPSIS
 .B #include <unistd.h>
 .PP
-.BI "int execve(const char *" filename ", char *const " argv "[], "
+.BI "int execve(const char *" pathname ", char *const " argv "[], "
 .br
 .BI "           char *const " envp []);
 .SH DESCRIPTION
 .BR execve ()
-executes the program referred to by \fIfilename\fP.
+executes the program referred to by \fIpathname\fP.
 This causes the program that is currently being run by the calling process
 to be replaced with a new program, with newly initialized stack, heap,
 and (initialized and uninitialized) data segments.
 .PP
-\fIfilename\fP must be either a binary executable, or a script
+\fIpathname\fP must be either a binary executable, or a script
 starting with a line of the form:
 .PP
 .in +4n
@@ -95,7 +95,7 @@ after a successful
 .BR execve ().
 .PP
 If the set-user-ID bit is set on the program file referred to by
-\fIfilename\fP,
+\fIpathname\fP,
 then the effective user ID of the calling process is changed
 to that of the owner of the program file.
 Similarly, when the set-group-ID
@@ -309,7 +309,7 @@ The
 .I interpreter
 must be a valid pathname for an executable file.
 If the
-.I filename
+.I pathname
 argument of
 .BR execve ()
 specifies an interpreter script, then
@@ -318,7 +318,7 @@ will be invoked with the following arguments:
 .PP
 .in +4n
 .EX
-\fIinterpreter\fP [optional-arg] \fIfilename\fP arg...
+\fIinterpreter\fP [optional-arg] \fIpathname\fP arg...
 .EE
 .in
 .PP
@@ -415,7 +415,7 @@ is too large.
 .TP
 .B EACCES
 Search permission is denied on a component of the path prefix of
-.I filename
+.I pathname
 or the name of a script interpreter.
 (See also
 .BR path_resolution (7).)
@@ -441,7 +441,7 @@ resource limit (see
 For a more detailed explanation of this error, see NOTES.
 .TP
 .B EFAULT
-.I filename
+.I pathname
 or one of the pointers in the vectors
 .I argv
 or
@@ -463,7 +463,7 @@ An ELF interpreter was not in a recognized format.
 .TP
 .B ELOOP
 Too many symbolic links were encountered in resolving
-.I filename
+.I pathname
 or the name of a script or ELF interpreter.
 .TP
 .B ELOOP
@@ -478,7 +478,7 @@ the error produced for this case was
 The per-process limit on the number of open file descriptors has been reached.
 .TP
 .B ENAMETOOLONG
-.I filename
+.I pathname
 is too long.
 .TP
 .B ENFILE
@@ -486,7 +486,7 @@ The system-wide limit on the total number of open files has been reached.
 .TP
 .B ENOENT
 The file
-.I filename
+.I pathname
 or a script or ELF interpreter does not exist, or a shared library
 .\" FIXME but see http://sourceware.org/bugzilla/show_bug.cgi?id=12241
 needed for the file or interpreter cannot be found.
@@ -501,7 +501,7 @@ Insufficient kernel memory was available.
 .TP
 .B ENOTDIR
 A component of the path prefix of
-.I filename
+.I pathname
 or a script or ELF interpreter is not a directory.
 .TP
 .B EPERM

diff --git a/man3/exec.3 b/man3/exec.3
index 2a0e1e5cdd02d33920e9de0d2f94698275e0f41a..499a0535810b30a171139155ac347a24fa8946d7 100644 (file)
--- a/man3/exec.3
+++ b/man3/exec.3
@@ -47,13 +47,13 @@ execl, execlp, execle, execv, execvp, execvpe \- execute a file
 .PP
 .B extern char **environ;
 .PP
-.BI "int execl(const char *" path ", const char *" arg ", ..."
+.BI "int execl(const char *" pathname ", const char *" arg ", ..."
 .B  "                /* (char  *) NULL */);"
 .BI "int execlp(const char *" file ", const char *" arg ", ..."
 .B  "                /* (char  *) NULL */);"
-.BI "int execle(const char *" path ", const char *" arg ", ..."
+.BI "int execle(const char *" pathname ", const char *" arg ", ..."
 .BI "                /*, (char *) NULL, char * const " envp "[] */);"
-.BI "int execv(const char *" path ", char *const " argv "[]);"
+.BI "int execv(const char *" pathname ", char *const " argv "[]);"
 .BI "int execvp(const char *" file ", char *const " argv "[]);"
 .BI "int execvpe(const char *" file ", char *const " argv "[],"
 .BI "                char *const " envp "[]);"