[Python-checkins] bpo-28724: Doc: Move socket.send_fds and socket.recv_fds docs to right section (GH-22608)
methane
webhook-mailer at python.org
Thu Apr 22 00:08:54 EDT 2021
https://github.com/python/cpython/commit/660592f67c0d825b06eb4a38ccc04b34a1f01f00
commit: 660592f67c0d825b06eb4a38ccc04b34a1f01f00
branch: master
author: Saiyang Gou <gousaiyang at 163.com>
committer: methane <songofacandy at gmail.com>
date: 2021-04-22T13:08:46+09:00
summary:
bpo-28724: Doc: Move socket.send_fds and socket.recv_fds docs to right section (GH-22608)
files:
M Doc/library/socket.rst
M Doc/whatsnew/3.9.rst
diff --git a/Doc/library/socket.rst b/Doc/library/socket.rst
index 30b3c5e24eefc..8a1fc96e0362e 100755
--- a/Doc/library/socket.rst
+++ b/Doc/library/socket.rst
@@ -1143,6 +1143,32 @@ The :mod:`socket` module also offers various network-related services:
"Interface name" is a name as documented in :func:`if_nameindex`.
+.. function:: send_fds(sock, buffers, fds[, flags[, address]])
+
+ Send the list of file descriptors *fds* over an :const:`AF_UNIX` socket *sock*.
+ The *fds* parameter is a sequence of file descriptors.
+ Consult :meth:`sendmsg` for the documentation of these parameters.
+
+ .. availability:: Unix supporting :meth:`~socket.sendmsg` and :const:`SCM_RIGHTS` mechanism.
+
+ .. versionadded:: 3.9
+
+
+.. function:: recv_fds(sock, bufsize, maxfds[, flags])
+
+ Receive up to *maxfds* file descriptors from an :const:`AF_UNIX` socket *sock*.
+ Return ``(msg, list(fds), flags, addr)``.
+ Consult :meth:`recvmsg` for the documentation of these parameters.
+
+ .. availability:: Unix supporting :meth:`~socket.recvmsg` and :const:`SCM_RIGHTS` mechanism.
+
+ .. versionadded:: 3.9
+
+ .. note::
+
+ Any truncated integers at the end of the list of file descriptors.
+
+
.. _socket-objects:
Socket Objects
@@ -1637,29 +1663,6 @@ to sockets.
.. versionadded:: 3.6
-.. method:: socket.send_fds(sock, buffers, fds[, flags[, address]])
-
- Send the list of file descriptors *fds* over an :const:`AF_UNIX` socket.
- The *fds* parameter is a sequence of file descriptors.
- Consult :meth:`sendmsg` for the documentation of these parameters.
-
- .. availability:: Unix supporting :meth:`~socket.sendmsg` and :const:`SCM_RIGHTS` mechanism.
-
- .. versionadded:: 3.9
-
-.. method:: socket.recv_fds(sock, bufsize, maxfds[, flags])
-
- Receive up to *maxfds* file descriptors. Return ``(msg, list(fds), flags, addr)``. Consult
- :meth:`recvmsg` for the documentation of these parameters.
-
- .. availability:: Unix supporting :meth:`~socket.recvmsg` and :const:`SCM_RIGHTS` mechanism.
-
- .. versionadded:: 3.9
-
- .. note::
-
- Any truncated integers at the end of the list of file descriptors.
-
.. method:: socket.sendfile(file, offset=0, count=None)
Send a file until EOF is reached by using high-performance
diff --git a/Doc/whatsnew/3.9.rst b/Doc/whatsnew/3.9.rst
index 174d9e24be319..602ed065858ec 100644
--- a/Doc/whatsnew/3.9.rst
+++ b/Doc/whatsnew/3.9.rst
@@ -658,7 +658,7 @@ The socket module now supports the :data:`~socket.CAN_J1939` protocol on
platforms that support it. (Contributed by Karl Ding in :issue:`40291`.)
The socket module now has the :func:`socket.send_fds` and
-:func:`socket.recv.fds` methods. (Contributed by Joannah Nanjekye, Shinya
+:func:`socket.recv_fds` functions. (Contributed by Joannah Nanjekye, Shinya
Okano and Victor Stinner in :issue:`28724`.)
More information about the Python-checkins
mailing list