mirror of https://github.com/mkerrisk/man-pages
Make naming of 'pathname' argument consistent; various minor rewordings.
This commit is contained in:
parent
237aa7c5b7
commit
1343b6043b
|
@ -31,7 +31,7 @@ file descriptor
|
|||
.nf
|
||||
.B #include <unistd.h>
|
||||
.sp
|
||||
.BI "int faccessat(int " dirfd ", const char *" path ", int " \
|
||||
.BI "int faccessat(int " dirfd ", const char *" pathname ", int " \
|
||||
mode ", int " flags );
|
||||
.fi
|
||||
.SH DESCRIPTION
|
||||
|
@ -42,7 +42,7 @@ system call operates in exactly the same way as
|
|||
except for the differences described in this manual page.
|
||||
|
||||
If the pathname given in
|
||||
.I path
|
||||
.I pathname
|
||||
is relative, then it is interpreted relative to the directory
|
||||
referred to by the file descriptor
|
||||
.IR dirfd
|
||||
|
@ -51,20 +51,20 @@ the calling process, as is done by
|
|||
.BR access (2)
|
||||
for a relative pathname).
|
||||
|
||||
If the pathname given in
|
||||
.I path
|
||||
If
|
||||
.I pathname
|
||||
is relative and
|
||||
.I dirfd
|
||||
is the special value
|
||||
.BR AT_FDCWD ,
|
||||
then
|
||||
.I path
|
||||
.I pathname
|
||||
is interpreted relative to the current working
|
||||
directory of the calling process (like
|
||||
.BR access (2)).
|
||||
|
||||
If the pathname given in
|
||||
.IR path
|
||||
If
|
||||
.IR pathname
|
||||
is absolute, then
|
||||
.I dirfd
|
||||
is ignored.
|
||||
|
@ -81,7 +81,7 @@ uses the effective IDs (like
|
|||
.TP
|
||||
.B AT_SYMLINK_NOFOLLOW
|
||||
If
|
||||
.I path
|
||||
.I pathname
|
||||
is a symbolic link, do not dereference it:
|
||||
instead return information about the link itself.
|
||||
.SH "RETURN VALUE"
|
||||
|
@ -108,7 +108,7 @@ Invalid flag specified in
|
|||
.IR flags .
|
||||
.TP
|
||||
.B ENOTDIR
|
||||
.I path
|
||||
.I pathname
|
||||
is relative and
|
||||
.I dirfd
|
||||
is a file descriptor referring to a file other than a directory.
|
||||
|
|
|
@ -31,7 +31,7 @@ file descriptor
|
|||
.nf
|
||||
.B #include <sys/stat.h>
|
||||
.sp
|
||||
.BI "int fchmodat(int " dirfd ", const char *" path ", mode_t " \
|
||||
.BI "int fchmodat(int " dirfd ", const char *" pathname ", mode_t " \
|
||||
mode ", int " flags );
|
||||
.fi
|
||||
.SH DESCRIPTION
|
||||
|
@ -42,7 +42,7 @@ system call operates in exactly the same way as
|
|||
except for the differences described in this manual page.
|
||||
|
||||
If the pathname given in
|
||||
.I path
|
||||
.I pathname
|
||||
is relative, then it is interpreted relative to the directory
|
||||
referred to by the file descriptor
|
||||
.IR dirfd
|
||||
|
@ -51,20 +51,20 @@ the calling process, as is done by
|
|||
.BR chmod (2)
|
||||
for a relative pathname).
|
||||
|
||||
If the pathname given in
|
||||
.I path
|
||||
If
|
||||
.I pathname
|
||||
is relative and
|
||||
.I dirfd
|
||||
is the special value
|
||||
.BR AT_FDCWD ,
|
||||
then
|
||||
.I path
|
||||
.I pathname
|
||||
is interpreted relative to the current working
|
||||
directory of the calling process (like
|
||||
.BR chmod (2)).
|
||||
|
||||
If the pathname given in
|
||||
.IR path
|
||||
If
|
||||
.IR pathname
|
||||
is absolute, then
|
||||
.I dirfd
|
||||
is ignored.
|
||||
|
@ -74,7 +74,7 @@ can either be 0, or include the following flag:
|
|||
.TP
|
||||
.B AT_SYMLINK_NOFOLLOW
|
||||
If
|
||||
.I path
|
||||
.I pathname
|
||||
is a symbolic link, do not dereference it:
|
||||
instead operate on the link itself.
|
||||
This flag is not currently implemented.
|
||||
|
@ -102,7 +102,7 @@ Invalid flag specified in
|
|||
.IR flags .
|
||||
.TP
|
||||
.B ENOTDIR
|
||||
.I path
|
||||
.I pathname
|
||||
is relative and
|
||||
.I dirfd
|
||||
is a file descriptor referring to a file other than a directory.
|
||||
|
|
|
@ -31,7 +31,7 @@ file descriptor
|
|||
.nf
|
||||
.B #include <unistd.h>
|
||||
.sp
|
||||
.BI "int fchownat(int " dirfd ", const char *" path ,
|
||||
.BI "int fchownat(int " dirfd ", const char *" pathname ,
|
||||
.BI " uid_t " owner ", gid_t " group ", int " flags );
|
||||
.fi
|
||||
.SH DESCRIPTION
|
||||
|
@ -42,7 +42,7 @@ system call operates in exactly the same way as
|
|||
except for the differences described in this manual page.
|
||||
|
||||
If the pathname given in
|
||||
.I path
|
||||
.I pathname
|
||||
is relative, then it is interpreted relative to the directory
|
||||
referred to by the file descriptor
|
||||
.IR dirfd
|
||||
|
@ -51,20 +51,20 @@ the calling process, as is done by
|
|||
.BR chown (2)
|
||||
for a relative pathname).
|
||||
|
||||
If the pathname given in
|
||||
.I path
|
||||
If
|
||||
.I pathname
|
||||
is relative and
|
||||
.I dirfd
|
||||
is the special value
|
||||
.BR AT_FDCWD ,
|
||||
then
|
||||
.I path
|
||||
.I pathname
|
||||
is interpreted relative to the current working
|
||||
directory of the calling process (like
|
||||
.BR chown (2)).
|
||||
|
||||
If the pathname given in
|
||||
.IR path
|
||||
If
|
||||
.IR pathname
|
||||
is absolute, then
|
||||
.I dirfd
|
||||
is ignored.
|
||||
|
@ -74,7 +74,7 @@ can either be 0, or include the following flag:
|
|||
.TP
|
||||
.B AT_SYMLINK_NOFOLLOW
|
||||
If
|
||||
.I path
|
||||
.I pathname
|
||||
is a symbolic link, do not dereference it:
|
||||
instead operate on the link itself, like
|
||||
.BR lchown (2).
|
||||
|
@ -106,7 +106,7 @@ Invalid flag specified in
|
|||
.IR flags .
|
||||
.TP
|
||||
.B ENOTDIR
|
||||
.I path
|
||||
.I pathname
|
||||
is relative and
|
||||
.I dirfd
|
||||
is a file descriptor referring to a file other than a directory.
|
||||
|
|
|
@ -30,7 +30,7 @@ fstatat \- get file status relative to a directory file descriptor
|
|||
.nf
|
||||
.B #include <sys/stat.h>
|
||||
.sp
|
||||
.BI "int fstatat(int " dirfd ", const char *" path ", struct stat *" \
|
||||
.BI "int fstatat(int " dirfd ", const char *" pathname ", struct stat *" \
|
||||
buf ", int " flags );
|
||||
.fi
|
||||
.SH DESCRIPTION
|
||||
|
@ -41,7 +41,7 @@ system call operates in exactly the same way as
|
|||
except for the differences described in this manual page.
|
||||
|
||||
If the pathname given in
|
||||
.I path
|
||||
.I pathname
|
||||
is relative, then it is interpreted relative to the directory
|
||||
referred to by the file descriptor
|
||||
.IR dirfd
|
||||
|
@ -50,20 +50,20 @@ the calling process, as is done by
|
|||
.BR stat (2)
|
||||
for a relative pathname).
|
||||
|
||||
If the pathname given in
|
||||
.I path
|
||||
If
|
||||
.I pathname
|
||||
is relative and
|
||||
.I dirfd
|
||||
is the special value
|
||||
.BR AT_FDCWD ,
|
||||
then
|
||||
.I path
|
||||
.I pathname
|
||||
is interpreted relative to the current working
|
||||
directory of the calling process (like
|
||||
.BR stat (2)).
|
||||
|
||||
If the pathname given in
|
||||
.IR path
|
||||
If
|
||||
.IR pathname
|
||||
is absolute, then
|
||||
.I dirfd
|
||||
is ignored.
|
||||
|
@ -73,7 +73,7 @@ can either be 0, or include the following flag:
|
|||
.TP
|
||||
.B AT_SYMLINK_NOFOLLOW
|
||||
If
|
||||
.I path
|
||||
.I pathname
|
||||
is a symbolic link, do not dereference it:
|
||||
instead return information about the link itself, like
|
||||
.BR lstat (2).
|
||||
|
@ -105,7 +105,7 @@ Invalid flag specified in
|
|||
.IR flags .
|
||||
.TP
|
||||
.B ENOTDIR
|
||||
.I path
|
||||
.I pathname
|
||||
is relative and
|
||||
.I dirfd
|
||||
is a file descriptor referring to a file other than a directory.
|
||||
|
|
|
@ -51,7 +51,7 @@ the calling process, as is done by
|
|||
.BR utimes (2)
|
||||
for a relative pathname).
|
||||
|
||||
If the pathname given in
|
||||
If
|
||||
.I pathname
|
||||
is relative and
|
||||
.I dirfd
|
||||
|
@ -63,7 +63,7 @@ is interpreted relative to the current working
|
|||
directory of the calling process (like
|
||||
.BR utimes (2)).
|
||||
|
||||
If the pathname given in
|
||||
If
|
||||
.IR pathname
|
||||
is absolute, then
|
||||
.I dirfd
|
||||
|
@ -97,9 +97,9 @@ This system call is non-standard but is proposed
|
|||
for inclusion in a future revision of POSIX.1.
|
||||
A similar system call exists on Solaris.
|
||||
.SH GLIBC NOTES
|
||||
If the
|
||||
.I path
|
||||
argument is NULL, then the glibc
|
||||
If
|
||||
.I pathname
|
||||
is NULL, then the glibc
|
||||
.BR futimes ()
|
||||
wrapper function updates the times for the file referred to by
|
||||
.IR dirfd .
|
||||
|
|
|
@ -50,7 +50,7 @@ the calling process, as is done by
|
|||
.BR link (2)
|
||||
for a relative pathname).
|
||||
|
||||
If the pathname given in
|
||||
If
|
||||
.I oldpath
|
||||
is relative and
|
||||
.I olddirfd
|
||||
|
@ -62,7 +62,7 @@ is interpreted relative to the current working
|
|||
directory of the calling process (like
|
||||
.BR link (2)).
|
||||
|
||||
If the pathname given in
|
||||
If
|
||||
.IR oldpath
|
||||
is absolute, then
|
||||
.I olddirfd
|
||||
|
|
|
@ -49,7 +49,7 @@ the calling process, as is done by
|
|||
.BR mkdir (2)
|
||||
for a relative pathname).
|
||||
|
||||
If the pathname given in
|
||||
If
|
||||
.I pathname
|
||||
is relative and
|
||||
.I dirfd
|
||||
|
@ -61,7 +61,7 @@ is interpreted relative to the current working
|
|||
directory of the calling process (like
|
||||
.BR mkdir (2)).
|
||||
|
||||
If the pathname given in
|
||||
If
|
||||
.IR pathname
|
||||
is absolute, then
|
||||
.I dirfd
|
||||
|
|
|
@ -50,7 +50,7 @@ the calling process, as is done by
|
|||
.BR mknod (2)
|
||||
for a relative pathname).
|
||||
|
||||
If the pathname given in
|
||||
If
|
||||
.I pathname
|
||||
is relative and
|
||||
.I dirfd
|
||||
|
@ -62,7 +62,7 @@ is interpreted relative to the current working
|
|||
directory of the calling process (like
|
||||
.BR mknod (2)).
|
||||
|
||||
If the pathname given in
|
||||
If
|
||||
.IR pathname
|
||||
is absolute, then
|
||||
.I dirfd
|
||||
|
|
|
@ -51,7 +51,7 @@ the calling process, as is done by
|
|||
.BR open (2)
|
||||
for a relative pathname).
|
||||
|
||||
If the pathname given in
|
||||
If
|
||||
.I pathname
|
||||
is relative and
|
||||
.I dirfd
|
||||
|
@ -63,7 +63,7 @@ is interpreted relative to the current working
|
|||
directory of the calling process (like
|
||||
.BR open (2)).
|
||||
|
||||
If the pathname given in
|
||||
If
|
||||
.IR pathname
|
||||
is absolute, then
|
||||
.I dirfd
|
||||
|
|
|
@ -30,7 +30,7 @@ readlinkat \- read value of a symbolic link relative to a directory file descrip
|
|||
.nf
|
||||
.B #include <unistd.h>
|
||||
.sp
|
||||
.BI "int readlinkat(int " dirfd ", const char *" path \
|
||||
.BI "int readlinkat(int " dirfd ", const char *" pathname \
|
||||
", char *" buf ", size_t " bufsiz );
|
||||
.fi
|
||||
.SH DESCRIPTION
|
||||
|
@ -41,7 +41,7 @@ system call operates in exactly the same way as
|
|||
except for the differences described in this manual page.
|
||||
|
||||
If the pathname given in
|
||||
.I path
|
||||
.I pathname
|
||||
is relative, then it is interpreted relative to the directory
|
||||
referred to by the file descriptor
|
||||
.IR dirfd
|
||||
|
@ -50,20 +50,20 @@ the calling process, as is done by
|
|||
.BR readlink (2)
|
||||
for a relative pathname).
|
||||
|
||||
If the pathname given in
|
||||
.I path
|
||||
If
|
||||
.I pathname
|
||||
is relative and
|
||||
.I dirfd
|
||||
is the special value
|
||||
.BR AT_FDCWD ,
|
||||
then
|
||||
.I path
|
||||
.I pathname
|
||||
is interpreted relative to the current working
|
||||
directory of the calling process (like
|
||||
.BR readlink (2)).
|
||||
|
||||
If the pathname given in
|
||||
.IR path
|
||||
If
|
||||
.IR pathname
|
||||
is absolute, then
|
||||
.I dirfd
|
||||
is ignored.
|
||||
|
@ -87,7 +87,7 @@ The following additional errors can occur for
|
|||
is not a valid file descriptor.
|
||||
.TP
|
||||
.B ENOTDIR
|
||||
.I path
|
||||
.I pathname
|
||||
is relative and
|
||||
.I dirfd
|
||||
is a file descriptor referring to a file other than a directory.
|
||||
|
|
|
@ -50,7 +50,7 @@ the calling process, as is done by
|
|||
.BR rename (2)
|
||||
for a relative pathname).
|
||||
|
||||
If the pathname given in
|
||||
If
|
||||
.I oldpath
|
||||
is relative and
|
||||
.I olddirfd
|
||||
|
@ -62,7 +62,7 @@ is interpreted relative to the current working
|
|||
directory of the calling process (like
|
||||
.BR rename (2)).
|
||||
|
||||
If the pathname given in
|
||||
If
|
||||
.IR oldpath
|
||||
is absolute, then
|
||||
.I olddirfd
|
||||
|
|
|
@ -50,7 +50,7 @@ the calling process, as is done by
|
|||
.BR symlink (2)
|
||||
for a relative pathname).
|
||||
|
||||
If the pathname given in
|
||||
If
|
||||
.I newpath
|
||||
is relative and
|
||||
.I newdirfd
|
||||
|
@ -62,7 +62,7 @@ is interpreted relative to the current working
|
|||
directory of the calling process (like
|
||||
.BR symlink (2)).
|
||||
|
||||
If the pathname given in
|
||||
If
|
||||
.IR newpath
|
||||
is absolute, then
|
||||
.I newdirfd
|
||||
|
|
Loading…
Reference in New Issue