diff options
| author | Kent Overstreet <kent.overstreet@linux.dev> | 2024-06-20 13:00:17 +0000 |
|---|---|---|
| committer | Alejandro Colomar <alx@kernel.org> | 2024-06-28 13:26:52 +0200 |
| commit | d0621648b4b5a356e86cea23e842f2591461f0cf (patch) | |
| tree | 6a85510431224cb71a421d37cbab9e65e5dce416 | |
| parent | 89bea2b79c19c041a9040d9d1d95779def79652f (diff) | |
| download | man-pages-d0621648b4b5a356e86cea23e842f2591461f0cf.tar.gz | |
statx.2: Document STATX_SUBVOL
Document the new statx.stx_subvol field.
This would be clearer if we had a proper API for walking subvolumes that
we could refer to, but that's still coming.
Link: https://lore.kernel.org/linux-fsdevel/20240308022914.196982-1-kent.overstreet@linux.dev/
Signed-off-by: Kent Overstreet <kent.overstreet@linux.dev>
[jpg: mention supported FSes and formatting improvements]
Signed-off-by: John Garry <john.g.garry@oracle.com>
Cc: Eric Biggers <ebiggers@kernel.org>
Cc: <linux-fsdevel@vger.kernel.org>
Message-ID: <20240620130017.2686511-1-john.g.garry@oracle.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
| -rw-r--r-- | man/man2/statx.2 | 12 |
1 files changed, 12 insertions, 0 deletions
diff --git a/man/man2/statx.2 b/man/man2/statx.2 index a91458c8f7..3d47319c6d 100644 --- a/man/man2/statx.2 +++ b/man/man2/statx.2 @@ -68,6 +68,8 @@ struct statx { /* Direct I/O alignment restrictions */ __u32 stx_dio_mem_align; __u32 stx_dio_offset_align; +\& + __u64 stx_subvol; /* Subvolume identifier */ }; .EE .in @@ -255,6 +257,8 @@ STATX_MNT_ID Want stx_mnt_id (since Linux 5.8) STATX_DIOALIGN Want stx_dio_mem_align and stx_dio_offset_align (since Linux 6.1; support varies by filesystem) STATX_MNT_ID_UNIQUE Want unique stx_mnt_id (since Linux 6.8) +STATX_SUBVOL Want stx_subvol + (since Linux 6.10; support varies by filesystem) .TE .in .P @@ -451,6 +455,14 @@ or 0 if direct I/O is not supported on this file. This will only be nonzero if .I stx_dio_mem_align is nonzero, and vice versa. +.TP +.I stx_subvol +Subvolume number of the current file. +.IP +Subvolumes are fancy directories, +i.e. they form a tree structure that may be walked recursively. +Support varies by filesystem; +it is supported by bcachefs and btrfs since Linux 6.10. .P For further information on the above fields, see .BR inode (7). |