diff options
| author | Berker Peksag <berker.peksag@gmail.com> | 2015-10-08 03:34:31 (GMT) |
|---|---|---|
| committer | Berker Peksag <berker.peksag@gmail.com> | 2015-10-08 03:34:31 (GMT) |
| commit | ce88d82ec26877e0fcd6c7ebe0a1b72dccd3a833 (patch) | |
| tree | 24f5ad10c9f8c048e10a963a67595a930bf08b73 /Doc | |
| parent | ec1aa5c2a1d0848351dd9d7d2758c553f18e56b2 (diff) | |
| parent | 24a610984da381008237de6c3165b4e0aa4ec10c (diff) | |
| download | cpython-ce88d82ec26877e0fcd6c7ebe0a1b72dccd3a833.zip cpython-ce88d82ec26877e0fcd6c7ebe0a1b72dccd3a833.tar.gz cpython-ce88d82ec26877e0fcd6c7ebe0a1b72dccd3a833.tar.bz2 | |
Issue #16802: Document fileno parameter of socket.socket()
Patch by Henrik Heimbuerger and Bar Harel.
Diffstat (limited to 'Doc')
| -rw-r--r-- | Doc/library/socket.rst | 6 |
1 files changed, 5 insertions, 1 deletions
diff --git a/Doc/library/socket.rst b/Doc/library/socket.rst index e583ebd..f7b7d3d 100644 --- a/Doc/library/socket.rst +++ b/Doc/library/socket.rst @@ -384,7 +384,11 @@ The following functions all create :ref:`socket objects <socket-objects>`. :const:`SOCK_DGRAM`, :const:`SOCK_RAW` or perhaps one of the other ``SOCK_`` constants. The protocol number is usually zero and may be omitted or in the case where the address family is :const:`AF_CAN` the protocol should be one - of :const:`CAN_RAW` or :const:`CAN_BCM`. + of :const:`CAN_RAW` or :const:`CAN_BCM`. If *fileno* is specified, the other + arguments are ignored, causing the socket with the specified file descriptor + to return. Unlike :func:`socket.fromfd`, *fileno* will return the same + socket and not a duplicate. This may help close a detached socket using + :meth:`socket.close()`. The newly created socket is :ref:`non-inheritable <fd_inheritance>`. |