git: 29691ecea350 - main - cap_enter.2: document clearing altroot

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

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

commit 29691ecea35062c154d3ae36bd486349dc82abae
Author:     Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2026-11-03 13:39:13 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2026-11-20 15:10:27 +0000

    cap_enter.2: document clearing altroot
    
    Sponsored by:   The FreeBSD Foundation
    MFC after:      1 week
    Differential revision:  https://reviews.freebsd.org/D60035
---
 lib/libsys/cap_enter.2 | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/lib/libsys/cap_enter.2 b/lib/libsys/cap_enter.2
index d1248d4d8b8f..d55ba5808662 100644
--- a/lib/libsys/cap_enter.2
+++ b/lib/libsys/cap_enter.2
@@ -64,6 +64,8 @@ When combined with
 may be used to create kernel-enforced sandboxes in which
 appropriately-crafted applications or application components may be run.
 .Pp
+Entering capability mode clears the alternative root set by
+.Xr chaltroot 2 .
 Other threads are stopped while the call runs, so some of their
 interrupted system calls may return
 .Er EINTR .