mirror of https://github.com/mkerrisk/man-pages
stat.2: Use argument name 'pathname' throughout page
(Some APIs were using 'path' while others used 'pathname') Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
9f3c96d3e6
commit
66cbeaf41b
22
man2/stat.2
22
man2/stat.2
|
@ -48,11 +48,11 @@ stat, fstat, lstat, fstatat \- get file status
|
||||||
.br
|
.br
|
||||||
.B #include <unistd.h>
|
.B #include <unistd.h>
|
||||||
.sp
|
.sp
|
||||||
.BI "int stat(const char *" path ", struct stat *" buf );
|
.BI "int stat(const char *" pathname ", struct stat *" buf );
|
||||||
.br
|
.br
|
||||||
.BI "int fstat(int " fd ", struct stat *" buf );
|
.BI "int fstat(int " fd ", struct stat *" buf );
|
||||||
.br
|
.br
|
||||||
.BI "int lstat(const char *" path ", struct stat *" buf );
|
.BI "int lstat(const char *" pathname ", struct stat *" buf );
|
||||||
.sp
|
.sp
|
||||||
.BR "#include <fcntl.h> " "/* Definition of AT_* constants */"
|
.BR "#include <fcntl.h> " "/* Definition of AT_* constants */"
|
||||||
.B #include <sys/stat.h>
|
.B #include <sys/stat.h>
|
||||||
|
@ -99,14 +99,14 @@ No permissions are required on the file itself, but\(emin the case of
|
||||||
and
|
and
|
||||||
.BR lstat ()\(emexecute
|
.BR lstat ()\(emexecute
|
||||||
(search) permission is required on all of the directories in
|
(search) permission is required on all of the directories in
|
||||||
.I path
|
.I pathname
|
||||||
that lead to the file.
|
that lead to the file.
|
||||||
.PP
|
.PP
|
||||||
.BR stat ()
|
.BR stat ()
|
||||||
and
|
and
|
||||||
.BR fstatat ()
|
.BR fstatat ()
|
||||||
stat the file pointed to by
|
stat the file pointed to by
|
||||||
.I path
|
.I pathname
|
||||||
and fills in
|
and fills in
|
||||||
.IR buf ;
|
.IR buf ;
|
||||||
the differences for
|
the differences for
|
||||||
|
@ -117,7 +117,7 @@ are described below.
|
||||||
is identical to
|
is identical to
|
||||||
.BR stat (),
|
.BR stat (),
|
||||||
except that if
|
except that if
|
||||||
.I path
|
.I pathname
|
||||||
is a symbolic link, then the link itself is stat-ed,
|
is a symbolic link, then the link itself is stat-ed,
|
||||||
not the file that it refers to.
|
not the file that it refers to.
|
||||||
|
|
||||||
|
@ -431,7 +431,7 @@ is set appropriately.
|
||||||
.B EACCES
|
.B EACCES
|
||||||
Search permission is denied for one of the directories
|
Search permission is denied for one of the directories
|
||||||
in the path prefix of
|
in the path prefix of
|
||||||
.IR path .
|
.IR pathname .
|
||||||
(See also
|
(See also
|
||||||
.BR path_resolution (7).)
|
.BR path_resolution (7).)
|
||||||
.TP
|
.TP
|
||||||
|
@ -446,14 +446,14 @@ Bad address.
|
||||||
Too many symbolic links encountered while traversing the path.
|
Too many symbolic links encountered while traversing the path.
|
||||||
.TP
|
.TP
|
||||||
.B ENAMETOOLONG
|
.B ENAMETOOLONG
|
||||||
.I path
|
.I pathname
|
||||||
is too long.
|
is too long.
|
||||||
.TP
|
.TP
|
||||||
.B ENOENT
|
.B ENOENT
|
||||||
A component of
|
A component of
|
||||||
.I path
|
.I pathname
|
||||||
does not exist, or
|
does not exist, or
|
||||||
.I path
|
.I pathname
|
||||||
is an empty string.
|
is an empty string.
|
||||||
.TP
|
.TP
|
||||||
.B ENOMEM
|
.B ENOMEM
|
||||||
|
@ -461,11 +461,11 @@ Out of memory (i.e., kernel memory).
|
||||||
.TP
|
.TP
|
||||||
.B ENOTDIR
|
.B ENOTDIR
|
||||||
A component of the path prefix of
|
A component of the path prefix of
|
||||||
.I path
|
.I pathname
|
||||||
is not a directory.
|
is not a directory.
|
||||||
.TP
|
.TP
|
||||||
.B EOVERFLOW
|
.B EOVERFLOW
|
||||||
.I path
|
.I pathname
|
||||||
or
|
or
|
||||||
.I fd
|
.I fd
|
||||||
refers to a file whose size, inode number,
|
refers to a file whose size, inode number,
|
||||||
|
|
Loading…
Reference in New Issue