git: 65251c43415a - main - ntsync.4: be explicit about the effect of automatic vs manual event on waiters

From: Konstantin Belousov <kib_at_FreeBSD.org>
Date: Mon, 29 Jun 2026 06:11:45 UTC
The branch main has been updated by kib:

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

commit 65251c43415aa0993b7d43962cbb71d772870c83
Author:     Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2026-06-29 06:09:17 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2026-06-29 06:11:23 +0000

    ntsync.4: be explicit about the effect of automatic vs manual event on waiters
    
    Sponsored by:   The FreeBSD Foundation
    MFC after:      3 days
---
 share/man/man4/ntsync.4 | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/share/man/man4/ntsync.4 b/share/man/man4/ntsync.4
index 2776a4b0e691..c808dfdac3b4 100644
--- a/share/man/man4/ntsync.4
+++ b/share/man/man4/ntsync.4
@@ -183,9 +183,15 @@ Reset (dis-arms) the event.
 Takes a 32bit integer argument where the state of the event before
 the operation is returned.
 .It Dv NTSYNC_IOC_EVENT_PULSE
-Atomically sets and then resets the event.
+Atomically sets the event, wakes up eligible waiters,
+and then resets the event.
 Takes a 32bit integer argument where the state of the event before
 the operation is returned.
+.Pp
+If the manual event is pulsed, it wakes up all waiters,
+after which it is reset.
+On the other hand, the automatic event is reset after
+waking up at most a single waiter.
 .It Dv NTSYNC_IOC_EVENT_READ
 Returns the current state of the event.
 Takes the