]> git.ipfire.org Git - thirdparty/man-pages.git/commitdiff
man/man3/: Use 'path' instead of 'pathname' for parameters
authorAlejandro Colomar <alx@kernel.org>
Sun, 30 Mar 2025 22:24:43 +0000 (00:24 +0200)
committerAlejandro Colomar <alx@kernel.org>
Sun, 30 Mar 2025 22:27:27 +0000 (00:27 +0200)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
man/man3/euidaccess.3
man/man3/exec.3
man/man3/fopen.3
man/man3/ftok.3
man/man3/mkfifo.3
man/man3/remove.3
man/man3/scandir.3

index f7071770cb592ede711fdc4008d410fa8cff975a..290dcfc3c1d310a5c9155844b0d8ed6de25aabef 100644 (file)
@@ -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,
index b2869db030d40048cccb892cc3a9858542f4cac8..79b4d39e03415379437c5acfd2ed278ad1e5148f 100644 (file)
@@ -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 "[]);"
index a4a8576b624588e635554a63eb954241e8360b3a..2e9ff01b2e86d96b4a3f4a79e11064e9b71ec573 100644 (file)
@@ -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 ;
index e54485714a3888f5b24ec5838865ddc3093bfa60..3846a5e3ccee75d0d855903401a032042255db65 100644 (file)
@@ -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
index f51a5e0d982c910d2d4498a521903afa13ce49f4..82f76562f86bd1e393e38a3d595a0d0108799f57 100644 (file)
@@ -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
index 384690646fa96bbc6e46443dccf681832f322070..cb733c7fda1b7548155b58016a9793e1a6191cee 100644 (file)
@@ -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 ()
index 71cfd7c85a5e96fe83a7e5da9cd72ffa9342b1af..6f4a1475a37efde0ecdbca5847e9e9a7f6a867da 100644 (file)
@@ -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