On Tue, 2026-01-20 at 16:12 +0100, Alejandro Colomar wrote:

Hi Jeff,

On Tue, Jan 20, 2026 at 09:39:27AM -0500, Jeff Layton wrote:

quoted

On Sun, 2026-01-18 at 16:42 +0100, Alejandro Colomar wrote:

quoted

From: Jeff Layton <jlayton@kernel.org>

With Linux 6.19, userland will be able to request a delegation on a file
or directory.  These new objects act a lot like file leases, but are
based on NFSv4 file and directory delegations.

Add new F_GETDELEG and F_SETDELEG manpages to document them.

Signed-off-by: Jeff Layton <jlayton@kernel.org>
[alx: minor tweaks]
Signed-off-by: Alejandro Colomar <alx@kernel.org>
---
 man/man2/fcntl.2                |   5 +
 man/man2const/F_GETDELEG.2const | 265 ++++++++++++++++++++++++++++++++
 man/man2const/F_SETDELEG.2const |   1 +
 3 files changed, 271 insertions(+)
 create mode 100644 man/man2const/F_GETDELEG.2const
 create mode 100644 man/man2const/F_SETDELEG.2const

[...]

quoted

quoted

diff --git a/man/man2const/F_GETDELEG.2const b/man/man2const/F_GETDELEG.2const
new file mode 100644
index 000000000..e4d98feed
--- /dev/null
+++ b/man/man2const/F_GETDELEG.2const

@@ -0,0 +1,265 @@

[...]

quoted

quoted

+.SH NOTES
+Delegations were designed to implement NFSv4 delegations for the Linux NFS server.

Do we have a link to the NFSv4 specification of delegations?  It could
be useful, I think.  What do you think?

[...]

RFC8881 is the NFSv4.1 spec, and that's what defines them. The
description is spread out all over the document however. Section 10.2
probably has the best basic description. It's not exactly succinct
though.

quoted

This all looks great to me. Did you need me to make any other changes?

The only remaining doubt is the question above.

quoted

Thanks for doing the cleanup! FWIW:

Reviewed-by: Jeff Layton <jlayton@kernel.org>

You're welcome!  And thanks!  :-)


Have a lovely day!
Alex

-- 
Jeff Layton [off-list ref]