[PATCH 1/3] statx.2: Document STATX_MNT_ID_UNIQUE
From: Josef Bacik <josef@toxicpanda.com>
Date: 2024-06-25 18:56:54
Also in:
linux-fsdevel
Subsystem:
the rest · Maintainer:
Linus Torvalds
Linux 6.8 adds STATX_MNT_ID_UNIQUE support https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=98d2b43081972 Add the text and explanation to the statx man page. Signed-off-by: Josef Bacik <josef@toxicpanda.com> --- man/man2/statx.2 | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-)
diff --git a/man/man2/statx.2 b/man/man2/statx.2
index 0dcf7e20b..3d5ecd651 100644
--- a/man/man2/statx.2
+++ b/man/man2/statx.2@@ -234,7 +234,7 @@ .SH DESCRIPTION .I mask is an ORed combination of the following constants: .P -.in +4n +.in +1n .TS lB l. STATX_TYPE Want stx_mode & S_IFMT
@@ -255,6 +255,7 @@ .SH DESCRIPTION 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) .TE .in .P
@@ -410,11 +411,18 @@ .SH DESCRIPTION .TP .I stx_mnt_id .\" commit fa2fcf4f1df1559a0a4ee0f46915b496cc2ebf60 -The mount ID of the mount containing the file. +If using STATX_MNT_ID, this is the mount ID of the mount containing the file. This is the same number reported by .BR name_to_handle_at (2) and corresponds to the number in the first field in one of the records in .IR /proc/self/mountinfo . +.IP +If using STATX_MNT_ID_UNIQUE, this is the unique mount ID of the mount +containing the file. This is the number reported by +.BR listmount (2) +and is the ID used to query the mount with +.BR statmount (2) . +It is guaranteed to not be reused while the system is running. .TP .I stx_dio_mem_align The alignment (in bytes) required for user memory buffers for direct I/O
--
2.43.0