mirror of https://github.com/mkerrisk/man-pages
statx.2: Minor edits
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
108cd6a3d0
commit
835f429363
35
man2/statx.2
35
man2/statx.2
|
@ -30,17 +30,14 @@
|
|||
.\"
|
||||
.TH STATX 2 2017-03-07 "Linux" "Linux Programmer's Manual"
|
||||
.SH NAME
|
||||
statx \- Get file status (extended)
|
||||
statx \- get file status (extended)
|
||||
.SH SYNOPSIS
|
||||
.nf
|
||||
.B #include <sys/types.h>
|
||||
.br
|
||||
.B #include <sys/stat.h>
|
||||
.br
|
||||
.B #include <unistd.h>
|
||||
.br
|
||||
.BR "#include <fcntl.h> " "/* Definition of AT_* constants */"
|
||||
.sp
|
||||
|
||||
.BI "int statx(int " dirfd ", const char *" pathname ", int " flags ","
|
||||
.BI " unsigned int " mask ", struct statx *" buf );
|
||||
.fi
|
||||
|
@ -116,7 +113,7 @@ Invoking \fBstatx\fR():
|
|||
To access a file's status, no permissions are required on the file itself,
|
||||
but in the case of
|
||||
.BR statx ()
|
||||
with a path,
|
||||
with a pathname,
|
||||
execute (search) permission is required on all of the directories in
|
||||
.I pathname
|
||||
that lead to the file.
|
||||
|
@ -129,25 +126,25 @@ and
|
|||
.IR flags
|
||||
to locate the target file in one of a variety of ways:
|
||||
.TP
|
||||
[*] By absolute path.
|
||||
[*] By absolute pathname.
|
||||
.I pathname
|
||||
points to an absolute path and
|
||||
points to an absolute pathname and
|
||||
.I dirfd
|
||||
is ignored.
|
||||
The file is looked up by name, starting from the root of the
|
||||
filesystem as seen by the calling process.
|
||||
.TP
|
||||
[*] By cwd-relative path.
|
||||
[*] By cwd-relative pathname.
|
||||
.I pathname
|
||||
points to a relative path and
|
||||
points to a relative pathname and
|
||||
.IR dirfd
|
||||
is
|
||||
.BR AT_FDCWD .
|
||||
The file is looked up by name, starting from the current working directory.
|
||||
.TP
|
||||
[*] By dir-relative path.
|
||||
[*] By dir-relative pathname.
|
||||
.I pathname
|
||||
points to relative path and
|
||||
points to relative pathname and
|
||||
.I dirfd
|
||||
indicates a file descriptor pointing to a directory.
|
||||
The file is looked up by name, starting from the directory specified by
|
||||
|
@ -163,7 +160,7 @@ The file descriptor may point to any type of file, not just
|
|||
a directory.
|
||||
.PP
|
||||
.I flags
|
||||
can be used to influence a path-based lookup.
|
||||
can be used to influence a pathname-based lookup.
|
||||
A value for
|
||||
.I flags
|
||||
is constructed by OR'ing together zero or more of the following constants:
|
||||
|
@ -299,18 +296,18 @@ an unrepresentable value (for instance, a file with an exotic type),
|
|||
then the mask bit corresponding to that field will be cleared in
|
||||
.I stx_mask
|
||||
even if the user asked for it and a dummy value will be filled in for
|
||||
compatibility purposes if one is available (e.g. a dummy uid and gid may be
|
||||
compatibility purposes if one is available (e.g., a dummy UID and GID may be
|
||||
specified to mount under some circumstances).
|
||||
.PP
|
||||
A filesystem may also fill in fields that the caller didn't ask for if it has
|
||||
values for them available at no extra cost.
|
||||
values for them available and the information is available at no extra cost.
|
||||
If this happens, the corresponding bits will be set in
|
||||
.IR stx_mask .
|
||||
.PP
|
||||
.\" Background: inode attributes are modified with i_mutex held, but
|
||||
.\" read by stat() without taking the mutex.
|
||||
.I Note:
|
||||
For performance and simplicity reasons, different fields in the
|
||||
.IR Note :
|
||||
for performance and simplicity reasons, different fields in the
|
||||
.I statx
|
||||
structure may contain state information from different moments
|
||||
during the execution of the system call.
|
||||
|
@ -354,7 +351,7 @@ The number of blocks allocated to the file on the medium, in 512-byte units.
|
|||
when the file has holes.)
|
||||
.TP
|
||||
.I stx_blksize
|
||||
The "preferred" blocksize for efficient filesystem I/O.
|
||||
The "preferred" block size for efficient filesystem I/O.
|
||||
(Writing to a file in
|
||||
smaller chunks may cause an inefficient read-modify-rewrite.)
|
||||
.TP
|
||||
|
@ -654,7 +651,7 @@ is not a valid open file descriptor.
|
|||
Bad address.
|
||||
.TP
|
||||
.B ELOOP
|
||||
Too many symbolic links encountered while traversing the path.
|
||||
Too many symbolic links encountered while traversing the pathname.
|
||||
.TP
|
||||
.B ENAMETOOLONG
|
||||
.I pathname
|
||||
|
|
Loading…
Reference in New Issue