statx.2: correctly document STATX_ALL

PATCH Superseded Eric Biggers 1 participant 1 message Jun 14, 2022

Subsystems (2)

VFS Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore

Share & tools

lore

Eric Biggers

author

2022-06-14 03:45 UTC #0 lore raw

PATCH 1/1 statx.2: correctly document STATX_ALL

From: Eric Biggers <[email protected]>

Since kernel commit 581701b7efd6 ("uapi: deprecate STATX_ALL"), STATX_ALL is deprecated. It doesn't include STATX_MNT_ID, and it won't include any future flags. Update the man page accordingly.

Signed-off-by Eric Biggers <[email protected]>

---
 man2/statx.2 | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

man2/statx.2 +2 -1

index a8620be6f..561e64f7b 100644
@@ -244,8 +244,9 @@ STATX_SIZE	Want stx_size
 STATX_BLOCKS	Want stx_blocks
 STATX_BASIC_STATS	[All of the above]
 STATX_BTIME	Want stx_btime
+STATX_ALL	The same as STATX_BASIC_STATS | STATX_BTIME.
+         	This is deprecated and should not be used.
 STATX_MNT_ID	Want stx_mnt_id (since Linux 5.8)
-STATX_ALL	[All currently available fields]
 .TE
 .in
 .PP

base-commit: 756761bf7f23e6fd679d708a1c2d1e94547f4fce

Signature · 1 line

2.36.1