git: c2f66b661642 - main - libthr.3: document LIBPTHREAD_PSHARED_LOCK_DESTROY_IMMEDIATE_GC

From: Konstantin Belousov <kib_at_FreeBSD.org>
Date: Sun, 27 Sep 2026 23:51:13 UTC
The branch main has been updated by kib:

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

commit c2f66b6616425e0e8edab3e893bc4cb58869140d
Author:     Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2026-09-27 22:25:34 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2026-09-27 22:30:00 +0000

    libthr.3: document LIBPTHREAD_PSHARED_LOCK_DESTROY_IMMEDIATE_GC
    
    Sponsored by:   The FreeBSD Foundation
    MFC after:      1 week
---
 lib/libthr/libthr.3 | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/lib/libthr/libthr.3 b/lib/libthr/libthr.3
index 5d9c5ec6706b..4b1995a79414 100644
--- a/lib/libthr/libthr.3
+++ b/lib/libthr/libthr.3
@@ -206,8 +206,14 @@ for pthread operations specifying a timeout.
 If the operation requests a timeout less than the value provided,
 it is silently increased to the value.
 The value of zero means no minimum (default).
-.Pp
+.It Ev LIBPTHREAD_PSHARED_LOCK_DESTROY_IMMEDIATE_GC
+The implementation of the process shared lock scans
+the mapped shared off-pages to detect locks destroyed by other processes,
+when the current process destroys a shared lock.
+This is done not more often than 25msec.
+Setting the environment variable causes the scan to run on each destroy.
 .El
+.Pp
 The following
 .Dv sysctl
 MIBs affect the operation of the library: