From 4155b8e751df60ddea33d8d589b08fbb59c9cde7 Mon Sep 17 00:00:00 2001 From: Amir Goldstein Date: Mon, 31 Mar 2025 10:16:41 +0200 Subject: [PATCH] man/man2/open_by_handle_at.2: name_to_handle_at(): Document the AT_HANDLE_MNT_ID_UNIQUE flag A flag since Linux 6.12 to indicate that the requested mount_id is a 64-bit unique id. Cc: Chuck Lever Cc: Jeff Layton Cc: Christian Brauner Cc: Jan Kara Cc: Aleksa Sarai Signed-off-by: Amir Goldstein Message-ID: <20250331081642.1423812-1-amir73il@gmail.com> Signed-off-by: Alejandro Colomar --- man/man2/open_by_handle_at.2 | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/man/man2/open_by_handle_at.2 b/man/man2/open_by_handle_at.2 index ab1e06903..34da2f355 100644 --- a/man/man2/open_by_handle_at.2 +++ b/man/man2/open_by_handle_at.2 @@ -127,6 +127,7 @@ The .I flags argument is a bit mask constructed by ORing together zero or more of .BR AT_HANDLE_FID , +.BR AT_HANDLE_MNT_ID_UNIQUE , .BR AT_EMPTY_PATH , and .BR AT_SYMLINK_FOLLOW , @@ -147,6 +148,21 @@ with the returned .I file_handle may fail. .P +When +.I flags +contain the +.BR AT_HANDLE_MNT_ID_UNIQUE " (since Linux 6.12)" +.\" commit 4356d575ef0f39a3e8e0ce0c40d84ce900ac3b61 +flag, the caller indicates that the width of the +.I mount_id +buffer is at least 64 bits, +and then the mount id returned in that buffer +is the unique mount id as the one returned by +.BR statx (2) +with the +.BR STATX_MNT_ID_UNIQUE +flag. +.P Together, the .I path and -- 2.47.2