Make naming of 'pathname' argument consistent; various minor rewordings.

This commit is contained in:
Michael Kerrisk 2006-08-09 09:08:01 +00:00
parent 237aa7c5b7
commit 1343b6043b
12 changed files with 61 additions and 61 deletions

View File

@ -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.

View File

@ -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.

View File

@ -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.

View File

@ -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.

View File

@ -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 .

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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.

View File

@ -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

View File

@ -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