git: 06ec6146b0a7 - main - pwd_altroot(9): expand herald comment

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

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

commit 06ec6146b0a7f24a3657b0d4c46eb5e87533bc91
Author:     Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2026-10-12 15:38:12 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2026-11-20 15:10:26 +0000

    pwd_altroot(9): expand herald comment
    
    Requested and reviewed by:      markj
    Sponsored by:   The FreeBSD Foundation
    MFC after:      1 week
    Differential revision:  https://reviews.freebsd.org/D60035
---
 sys/kern/kern_descrip.c | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/sys/kern/kern_descrip.c b/sys/kern/kern_descrip.c
index d7e16db12a05..c38b48cdc9cd 100644
--- a/sys/kern/kern_descrip.c
+++ b/sys/kern/kern_descrip.c
@@ -4409,7 +4409,11 @@ pwd_chdir(struct thread *td, struct vnode *vp)
 }
 
 /*
- * Process is transitioning to/from a non-native ABI.
+ * Set the alternative root directory for the process.
+ *
+ * A non-NULL altroot_vp enables the alternative root and uses
+ * altroot_vp for it.  NULL disables it by setting the alternative
+ * root to the process root directory.
  */
 int
 pwd_altroot(struct thread *td, struct vnode *altroot_vp)