summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/signal.rst13
-rw-r--r--Doc/whatsnew/3.9.rst7
2 files changed, 20 insertions, 0 deletions
diff --git a/Doc/library/signal.rst b/Doc/library/signal.rst
index 8fecc2b..a79fc50 100644
--- a/Doc/library/signal.rst
+++ b/Doc/library/signal.rst
@@ -247,6 +247,19 @@ The :mod:`signal` module defines the following functions:
.. versionadded:: 3.8
+.. function:: pidfd_send_signal(pidfd, sig, siginfo=None, flags=0)
+
+ Send signal *sig* to the process referred to by file descriptor *pidfd*.
+ Python does not currently support the *siginfo* parameter; it must be
+ ``None``. The *flags* argument is provided for future extensions; no flag
+ values are currently defined.
+
+ See the :manpage:`pidfd_send_signal(2)` man page for more information.
+
+ .. availability:: Linux 5.1+
+ .. versionadded:: 3.9
+
+
.. function:: pthread_kill(thread_id, signalnum)
Send the signal *signalnum* to the thread *thread_id*, another thread in the
diff --git a/Doc/whatsnew/3.9.rst b/Doc/whatsnew/3.9.rst
index ddb295f..ce1d3e0 100644
--- a/Doc/whatsnew/3.9.rst
+++ b/Doc/whatsnew/3.9.rst
@@ -197,6 +197,13 @@ now raises :exc:`ImportError` instead of :exc:`ValueError` for invalid relative
import attempts.
(Contributed by Ngalim Siregar in :issue:`37444`.)
+signal
+------
+
+Exposed the Linux-specific :func:`signal.pidfd_send_signal` for sending to
+signals to a process using a file descriptor instead of a pid. (:issue:`38712`)
+
+
Optimizations
=============