diff options
| author | Christian Brauner <brauner@kernel.org> | 2024-11-15 11:35:16 +0100 |
|---|---|---|
| committer | Christian Brauner <brauner@kernel.org> | 2024-11-15 11:35:16 +0100 |
| commit | a312c10c0186b3fa6e6f9d4ca696913372804fae (patch) | |
| tree | 711948eb7e7ff56240671b86628c6db7acd9e565 /include/uapi/linux | |
| parent | 8e929cb546ee42c9a61d24fae60605e9e3192354 (diff) | |
| parent | a20853ab8296d4a8754482cb5e9adde8ab426a25 (diff) | |
Merge patch series "API for exporting connectable file handles to userspace"
Amir Goldstein <amir73il@gmail.com> says:
These patches bring the NFS connectable file handles feature to
userspace servers.
They rely on Christian's and Aleksa's changes recently merged to v6.12.
The API I chose for encoding conenctable file handles is pretty
conventional (AT_HANDLE_CONNECTABLE).
open_by_handle_at(2) does not have AT_ flags argument, but also, I find
it more useful API that encoding a connectable file handle can mandate
the resolving of a connected fd, without having to opt-in for a
connected fd independently.
I chose to implemnent this by using upper bits in the handle type field
It may be that out-of-tree filesystems return a handle type with upper
bits set, but AFAIK, no in-tree filesystem does that.
I added some warnings just in case we encouter that.
I have written an fstest [1] and a man page draft [2] for the feature.
[1] https://github.com/amir73il/xfstests/commits/connectable-fh/
[2] https://github.com/amir73il/man-pages/commits/connectable-fh/
* patches from https://lore.kernel.org/r/20241011090023.655623-1-amir73il@gmail.com:
fs: open_by_handle_at() support for decoding "explicit connectable" file handles
fs: name_to_handle_at() support for "explicit connectable" file handles
fs: prepare for "explicit connectable" file handles
Link: https://lore.kernel.org/r/20241011090023.655623-1-amir73il@gmail.com
Signed-off-by: Christian Brauner <brauner@kernel.org>
Diffstat (limited to 'include/uapi/linux')
| -rw-r--r-- | include/uapi/linux/fcntl.h | 1 |
1 files changed, 1 insertions, 0 deletions
diff --git a/include/uapi/linux/fcntl.h b/include/uapi/linux/fcntl.h index 87e2dec79fea..56ff2100e021 100644 --- a/include/uapi/linux/fcntl.h +++ b/include/uapi/linux/fcntl.h @@ -153,6 +153,7 @@ object identity and may not be usable with open_by_handle_at(2). */ #define AT_HANDLE_MNT_ID_UNIQUE 0x001 /* Return the u64 unique mount ID. */ +#define AT_HANDLE_CONNECTABLE 0x002 /* Request a connectable file handle */ #if defined(__KERNEL__) #define AT_GETATTR_NOSEC 0x80000000 |