mirror of https://github.com/mkerrisk/man-pages
statx.2: srcfix: rewrap source lines
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
709f7bb642
commit
ffe297ee2a
28
man2/statx.2
28
man2/statx.2
|
@ -229,8 +229,8 @@ This may require that
|
||||||
a network filesystem perform a data writeback to get the timestamps correct.
|
a network filesystem perform a data writeback to get the timestamps correct.
|
||||||
.TP
|
.TP
|
||||||
.B AT_STATX_DONT_SYNC
|
.B AT_STATX_DONT_SYNC
|
||||||
Don't synchronise anything, but rather just take whatever the system has cached
|
Don't synchronise anything, but rather just take whatever
|
||||||
if possible.
|
the system has cached if possible.
|
||||||
This may mean that the information returned is approximate, but,
|
This may mean that the information returned is approximate, but,
|
||||||
on a network filesystem, it may not involve a round trip to the server - even
|
on a network filesystem, it may not involve a round trip to the server - even
|
||||||
if no lease is held.
|
if no lease is held.
|
||||||
|
@ -284,17 +284,17 @@ which indicates what other information has been returned.
|
||||||
has the same format as the mask argument and bits are set in it to indicate
|
has the same format as the mask argument and bits are set in it to indicate
|
||||||
which fields have been filled in.
|
which fields have been filled in.
|
||||||
.PP
|
.PP
|
||||||
It should be noted that the kernel may return fields that weren't requested and
|
It should be noted that the kernel may return fields that weren't
|
||||||
may fail to return fields that were requested, depending on what the backing
|
requested and may fail to return fields that were requested,
|
||||||
filesystem supports.
|
depending on what the backing filesystem supports.
|
||||||
In either case,
|
In either case,
|
||||||
.I stx_mask
|
.I stx_mask
|
||||||
will not be equal
|
will not be equal
|
||||||
.IR mask .
|
.IR mask .
|
||||||
.PP
|
.PP
|
||||||
If a filesystem does not support a field or if it has an unrepresentable value
|
If a filesystem does not support a field or if it has
|
||||||
(for instance, a file with an exotic type), then the mask bit corresponding to
|
an unrepresentable value (for instance, a file with an exotic type),
|
||||||
that field will be cleared in
|
then the mask bit corresponding to that field will be cleared in
|
||||||
.I stx_mask
|
.I stx_mask
|
||||||
even if the user asked for it and a dummy value will be filled in for
|
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
|
||||||
|
@ -340,8 +340,8 @@ This is described in more detail below.
|
||||||
.TP
|
.TP
|
||||||
.I stx_size
|
.I stx_size
|
||||||
The size of the file (if it is a regular file or a symbolic link) in bytes.
|
The size of the file (if it is a regular file or a symbolic link) in bytes.
|
||||||
The size of a symbolic link is the length of the pathname it contains, without
|
The size of a symbolic link is the length of the pathname it contains,
|
||||||
a terminating null byte.
|
without a terminating null byte.
|
||||||
.TP
|
.TP
|
||||||
.I stx_blocks
|
.I stx_blocks
|
||||||
The number of blocks allocated to the file on the medium, in 512-byte units.
|
The number of blocks allocated to the file on the medium, in 512-byte units.
|
||||||
|
@ -437,15 +437,15 @@ see
|
||||||
.PP
|
.PP
|
||||||
The
|
The
|
||||||
.I stx_attributes
|
.I stx_attributes
|
||||||
field contains a set of OR'ed flags that indicate additional attributes of the
|
field contains a set of OR'ed flags that indicate additional attributes
|
||||||
file:
|
of the file:
|
||||||
.TP
|
.TP
|
||||||
STATX_ATTR_COMPRESSED
|
STATX_ATTR_COMPRESSED
|
||||||
The file is compressed by the fs and may take extra resources to access.
|
The file is compressed by the fs and may take extra resources to access.
|
||||||
.TP
|
.TP
|
||||||
STATX_ATTR_IMMUTABLE
|
STATX_ATTR_IMMUTABLE
|
||||||
The file cannot be modified: it cannot be deleted or renamed, no hard links can
|
The file cannot be modified: it cannot be deleted or renamed,
|
||||||
be created to this file and no data can be written to it.
|
no hard links can be created to this file and no data can be written to it.
|
||||||
See
|
See
|
||||||
.BR chattr (1).
|
.BR chattr (1).
|
||||||
.TP
|
.TP
|
||||||
|
|
Loading…
Reference in New Issue