mirror of https://github.com/mkerrisk/man-pages
statx.2: Clarify that the kernel does not reject invalid 'mask' values
And also explain why. Reported-by: Andreas Dilger <adilger@dilger.ca> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
f4572b658c
commit
393c5b58c3
13
man2/statx.2
13
man2/statx.2
|
@ -264,11 +264,22 @@ STATX_ALL [All currently available fields]
|
||||||
.TE
|
.TE
|
||||||
.in
|
.in
|
||||||
.PP
|
.PP
|
||||||
.B "Do not"
|
Note the kernel does
|
||||||
|
.I not
|
||||||
|
reject values in
|
||||||
|
.I mask
|
||||||
|
other than the above.
|
||||||
|
Instead, it simply informs the caller which values are supported
|
||||||
|
by this kernel and filesystem via the
|
||||||
|
.I statx.stx_mask
|
||||||
|
field.
|
||||||
|
Therefore,
|
||||||
|
.I "do not"
|
||||||
simply set
|
simply set
|
||||||
.I mask
|
.I mask
|
||||||
to
|
to
|
||||||
.B UINT_MAX
|
.B UINT_MAX
|
||||||
|
(all bits set),
|
||||||
as one or more bits may, in the future, be used to specify an
|
as one or more bits may, in the future, be used to specify an
|
||||||
extension to the buffer.
|
extension to the buffer.
|
||||||
.SS
|
.SS
|
||||||
|
|
Loading…
Reference in New Issue