From: Alejandro Colomar <alx@kernel.org>
Date: Sun, 30 Mar 2025 22:24:43 +0000 (+0200)
Subject: man/man3/: Use 'path' instead of 'pathname' for parameters
X-Git-Tag: man-pages-6.14~34
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=ea535c73418ab4c08305861e3a5d70a8a3b73b7e;p=thirdparty%2Fman-pages.git

man/man3/: Use 'path' instead of 'pathname' for parameters

Signed-off-by: Alejandro Colomar <alx@kernel.org>
---

diff --git a/man/man3/euidaccess.3 b/man/man3/euidaccess.3
index f7071770c..290dcfc3c 100644
--- a/man/man3/euidaccess.3
+++ b/man/man3/euidaccess.3
@@ -14,15 +14,15 @@ Standard C library
 .BR "#define _GNU_SOURCE" "             /* See feature_test_macros(7) */"
 .B #include <unistd.h>
 .P
-.BI "int euidaccess(const char *" pathname ", int " mode );
-.BI "int eaccess(const char *" pathname ", int " mode );
+.BI "int euidaccess(const char *" path ", int " mode );
+.BI "int eaccess(const char *" path ", int " mode );
 .fi
 .SH DESCRIPTION
 Like
 .BR access (2),
 .BR euidaccess ()
 checks permissions and existence of the file identified by its argument
-.IR pathname .
+.IR path .
 However, whereas
 .BR access (2)
 performs checks using the real user and group identifiers of the process,
diff --git a/man/man3/exec.3 b/man/man3/exec.3
index b2869db03..79b4d39e0 100644
--- a/man/man3/exec.3
+++ b/man/man3/exec.3
@@ -23,13 +23,13 @@ Standard C library
 .P
 .B extern char **environ;
 .P
-.BI "int execl(const char *" pathname ", const char *" arg ", ..."
+.BI "int execl(const char *" path ", const char *" arg ", ..."
 .B  "                /*, (char *) NULL */);"
 .BI "int execlp(const char *" file ", const char *" arg ", ..."
 .B  "                /*, (char *) NULL */);"
-.BI "int execle(const char *" pathname ", const char *" arg ", ..."
+.BI "int execle(const char *" path ", const char *" arg ", ..."
 .BI "                /*, (char *) NULL, char *const " envp "[] */);"
-.BI "int execv(const char *" pathname ", char *const " argv "[]);"
+.BI "int execv(const char *" path ", char *const " argv "[]);"
 .BI "int execvp(const char *" file ", char *const " argv "[]);"
 .BI "int execvpe(const char *" file ", char *const " argv \
 "[], char *const " envp "[]);"
diff --git a/man/man3/fopen.3 b/man/man3/fopen.3
index a4a8576b6..2e9ff01b2 100644
--- a/man/man3/fopen.3
+++ b/man/man3/fopen.3
@@ -24,11 +24,9 @@ Standard C library
 .nf
 .B #include <stdio.h>
 .P
-.BI "FILE *fopen(const char *restrict " pathname \
-", const char *restrict " mode );
+.BI "FILE *fopen(const char *restrict " path ", const char *restrict " mode );
 .BI "FILE *fdopen(int " fd ", const char *" mode );
-.BI "FILE *freopen(const char *restrict " pathname \
-", const char *restrict " mode ,
+.BI "FILE *freopen(const char *restrict " path ", const char *restrict " mode ,
 .BI "              FILE *restrict " stream );
 .fi
 .P
@@ -45,7 +43,7 @@ Feature Test Macro Requirements for glibc (see
 The
 .BR fopen ()
 function opens the file whose name is the string pointed to by
-.I pathname
+.I path
 and associates a stream with it.
 .P
 The argument
@@ -179,7 +177,7 @@ to a shared memory object is undefined.
 The
 .BR freopen ()
 function opens the file whose name is the string pointed to by
-.I pathname
+.I path
 and associates the stream pointed to by
 .I stream
 with it.
@@ -190,9 +188,9 @@ argument is used just as in the
 .BR fopen ()
 function.
 .P
-If the
-.I pathname
-argument is a null pointer,
+If
+.I path
+is a null pointer,
 .BR freopen ()
 changes the mode of the stream to that specified in
 .IR mode ;
diff --git a/man/man3/ftok.3 b/man/man3/ftok.3
index e54485714..3846a5e3c 100644
--- a/man/man3/ftok.3
+++ b/man/man3/ftok.3
@@ -18,12 +18,12 @@ Standard C library
 .B #include <sys/ipc.h>
 .fi
 .P
-.BI "key_t ftok(const char *" pathname ", int " proj_id );
+.BI "key_t ftok(const char *" path ", int " proj_id );
 .SH DESCRIPTION
 The
 .BR ftok ()
 function uses the identity of the file named by the given
-.I pathname
+.I path
 (which must refer to an existing, accessible file)
 and the least significant 8 bits of
 .I proj_id
@@ -73,7 +73,7 @@ On some ancient systems, the prototype was:
 .P
 .in +4n
 .EX
-.BI "key_t ftok(char *" pathname ", char " proj_id );
+.BI "key_t ftok(char *" path ", char " proj_id );
 .EE
 .in
 .P
diff --git a/man/man3/mkfifo.3 b/man/man3/mkfifo.3
index f51a5e0d9..82f76562f 100644
--- a/man/man3/mkfifo.3
+++ b/man/man3/mkfifo.3
@@ -17,12 +17,12 @@ Standard C library
 .B #include <sys/types.h>
 .B #include <sys/stat.h>
 .P
-.BI "int mkfifo(const char *" pathname ", mode_t " mode );
+.BI "int mkfifo(const char *" path ", mode_t " mode );
 .P
 .BR "#include <fcntl.h>           " "/* Definition of AT_* constants */"
 .B #include <sys/stat.h>
 .P
-.BI "int mkfifoat(int " dirfd ", const char *" pathname ", mode_t " mode );
+.BI "int mkfifoat(int " dirfd ", const char *" path ", mode_t " mode );
 .fi
 .P
 .RS -4
@@ -40,7 +40,7 @@ Feature Test Macro Requirements for glibc (see
 .SH DESCRIPTION
 .BR mkfifo ()
 makes a FIFO special file with name
-.IR pathname .
+.IR path .
 .I mode
 specifies the FIFO's permissions.
 It is modified by the
@@ -73,8 +73,8 @@ function operates in exactly the same way as
 .BR mkfifo (),
 except for the differences described here.
 .P
-If the pathname given in
-.I pathname
+If
+.I path
 is relative, then it is interpreted relative to the directory
 referred to by the file descriptor
 .I dirfd
@@ -84,19 +84,19 @@ the calling process, as is done by
 for a relative pathname).
 .P
 If
-.I pathname
+.I path
 is relative and
 .I dirfd
 is the special value
 .BR AT_FDCWD ,
 then
-.I pathname
+.I path
 is interpreted relative to the current working
 directory of the calling process (like
 .BR mkfifo ()).
 .P
 If
-.I pathname
+.I path
 is absolute, then
 .I dirfd
 is ignored.
@@ -118,12 +118,12 @@ is set to indicate the error.
 .TP
 .B EACCES
 One of the directories in
-.I pathname
+.I path
 did not allow search (execute) permission.
 .TP
 .B EBADF
 .RB ( mkfifoat ())
-.I pathname
+.I path
 is relative but
 .I dirfd
 is neither
@@ -135,15 +135,15 @@ The user's quota of disk blocks or inodes on the filesystem has been
 exhausted.
 .TP
 .B EEXIST
-.I pathname
+.I path
 already exists.
 This includes the case where
-.I pathname
+.I path
 is a symbolic link, dangling or not.
 .TP
 .B ENAMETOOLONG
 Either the total size of
-.I pathname
+.I path
 is greater than
 .BR PATH_MAX ,
 or an individual filename component has a length
@@ -155,7 +155,7 @@ limits on the length of a component.
 .TP
 .B ENOENT
 A directory component in
-.I pathname
+.I path
 does not exist or is a
 dangling symbolic link.
 .TP
@@ -164,19 +164,19 @@ The directory or filesystem has no room for the new file.
 .TP
 .B ENOTDIR
 A component used as a directory in
-.I pathname
+.I path
 is not, in fact,
 a directory.
 .TP
 .B ENOTDIR
 .RB ( mkfifoat ())
-.I pathname
-is a relative pathname and
+.I path
+is relative and
 .I dirfd
 is a file descriptor referring to a file other than a directory.
 .TP
 .B EROFS
-.I pathname
+.I path
 refers to a read-only filesystem.
 .SH ATTRIBUTES
 For an explanation of the terms used in this section, see
diff --git a/man/man3/remove.3 b/man/man3/remove.3
index 384690646..cb733c7fd 100644
--- a/man/man3/remove.3
+++ b/man/man3/remove.3
@@ -19,7 +19,7 @@ Standard C library
 .nf
 .B #include <stdio.h>
 .P
-.BI "int remove(const char *" pathname );
+.BI "int remove(const char *" path );
 .fi
 .SH DESCRIPTION
 .BR remove ()
diff --git a/man/man3/scandir.3 b/man/man3/scandir.3
index 71cfd7c85..6f4a1475a 100644
--- a/man/man3/scandir.3
+++ b/man/man3/scandir.3
@@ -118,7 +118,7 @@ function operates in exactly the same way as
 .BR scandir (),
 except for the differences described here.
 .P
-If the pathname given in
+If
 .I dirp
 is relative, then it is interpreted relative to the directory
 referred to by the file descriptor
@@ -193,7 +193,7 @@ is not a directory.
 .B ENOTDIR
 .RB ( scandirat ())
 .I dirp
-is a relative pathname and
+is relative and
 .I dirfd
 is a file descriptor referring to a file other than a directory.
 .SH ATTRIBUTES