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:
Michael Kerrisk 2017-04-23 13:15:33 +02:00
parent f4572b658c
commit 393c5b58c3
1 changed files with 12 additions and 1 deletions

View File

@ -264,11 +264,22 @@ STATX_ALL [All currently available fields]
.TE
.in
.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
.I mask
to
.B UINT_MAX
(all bits set),
as one or more bits may, in the future, be used to specify an
extension to the buffer.
.SS