https://github.com/python/cpython/commit/bdff88b9aad5d799e0e70755f42811e2fdf16994
commit: bdff88b9aad5d799e0e70755f42811e2fdf16994
branch: 3.13
author: Miss Islington (bot) <31488909+miss-isling...@users.noreply.github.com>
committer: vstinner <vstin...@python.org>
date: 2025-04-14T16:52:36Z
summary:
[3.13] gh-131803: Clarify that you must register signal handlers for
set_wakeup_fd (GH-131859) (#132522)
gh-131803: Clarify that you must register signal handlers for set_wakeup_fd
(GH-131859)
(cherry picked from commit 939476bbbb57ec3348c60df7c8f67c92038c8c89)
Co-authored-by: Jeremy Fleischman <jeremyfleisch...@gmail.com>
files:
M Doc/library/signal.rst
diff --git a/Doc/library/signal.rst b/Doc/library/signal.rst
index 17fcb2b3707978..c28841dbb8cfc8 100644
--- a/Doc/library/signal.rst
+++ b/Doc/library/signal.rst
@@ -510,10 +510,12 @@ The :mod:`signal` module defines the following functions:
.. function:: set_wakeup_fd(fd, *, warn_on_full_buffer=True)
- Set the wakeup file descriptor to *fd*. When a signal is received, the
- signal number is written as a single byte into the fd. This can be used by
- a library to wakeup a poll or select call, allowing the signal to be fully
- processed.
+ Set the wakeup file descriptor to *fd*. When a signal your program has
+ registered a signal handler for is received, the signal number is written as
+ a single byte into the fd. If you haven't registered a signal handler for
+ the signals you care about, then nothing will be written to the wakeup fd.
+ This can be used by a library to wakeup a poll or select call, allowing the
+ signal to be fully processed.
The old wakeup fd is returned (or -1 if file descriptor wakeup was not
enabled). If *fd* is -1, file descriptor wakeup is disabled.
_______________________________________________
Python-checkins mailing list -- python-checkins@python.org
To unsubscribe send an email to python-checkins-le...@python.org
https://mail.python.org/mailman3/lists/python-checkins.python.org/
Member address: arch...@mail-archive.com
