git: dae40d1657ba - main - fchroot.2: document ENOTCAPABLE for O_RESOLVE_BENEATH

From: Konstantin Belousov <kib_at_FreeBSD.org>
Date: Fri, 20 Nov 2026 15:10:56 UTC
The branch main has been updated by kib:

URL: https://cgit.FreeBSD.org/src/commit/?id=dae40d1657bae47284b6b6cff56e88021752c337

commit dae40d1657bae47284b6b6cff56e88021752c337
Author:     Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2026-10-20 17:03:36 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2026-11-20 15:10:26 +0000

    fchroot.2: document ENOTCAPABLE for O_RESOLVE_BENEATH
    
    Reviewed by:    markj
    Sponsored by:   The FreeBSD Foundation
    MFC after:      1 week
    Differential revision:  https://reviews.freebsd.org/D60035
---
 lib/libsys/chroot.2 | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/lib/libsys/chroot.2 b/lib/libsys/chroot.2
index 024c22af7b8f..de6fdf50ccd9 100644
--- a/lib/libsys/chroot.2
+++ b/lib/libsys/chroot.2
@@ -264,6 +264,15 @@ The argument
 is not a valid file descriptor.
 .It Bq Er ENOTDIR
 The file descriptor does not reference a directory.
+.It Bq Er ENOTCAPABLE
+The
+.Fa fd
+file descriptor has the
+.Dv FD_RESOLVE_BENEATH
+flag set.
+In particular, it was opened with the
+.Dv O_RESOLVE_BENEATH
+flag.
 .El
 .Sh SEE ALSO
 .Xr cap_enter 2 ,