git: 72a80a4733b2 - main - poll.2: document that poll is not restarted after signals

From: Enji Cooper <ngie_at_FreeBSD.org>
Date: Mon, 09 Nov 2026 05:30:18 UTC
The branch main has been updated by ngie:

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

commit 72a80a4733b2e2cf7a3e004e961f0fbba9aaa31f
Author:     _ov4 <ov4@ov4.org>
AuthorDate: 2026-11-06 06:16:28 +0000
Commit:     Enji Cooper <ngie@FreeBSD.org>
CommitDate: 2026-11-09 05:28:29 +0000

    poll.2: document that poll is not restarted after signals
    
    Signed-off-by: _ov4 <ov4@ov4.org>
    Reviewed-by: ngie
    Pull-Request: https://github.com/freebsd/freebsd-src/pull/2526
---
 lib/libsys/poll.2 | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/lib/libsys/poll.2 b/lib/libsys/poll.2
index 6e6ed33f7a6b..12ceb35d22ec 100644
--- a/lib/libsys/poll.2
+++ b/lib/libsys/poll.2
@@ -195,6 +195,18 @@ struct timespec {
 	long    tv_nsec;        /* and nanoseconds */
 };
 .Ed
+.Sh IMPLEMENTATION NOTES
+The
+.Fn poll
+and
+.Fn ppoll
+system calls are not restarted after a signal handler returns,
+regardless of the
+.Dv SA_RESTART
+flag on the interrupting signal;
+they fail with
+.Er EINTR
+instead.
 .Sh RETURN VALUES
 The
 .Fn poll