diff options
| author | Eugene Toder <eltoder@users.noreply.github.com> | 2023-11-27 23:42:37 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2023-11-27 23:42:37 (GMT) |
| commit | 562d7149c6944fb9e4c7be80664b2f2d5a12a3ea (patch) | |
| tree | 3429dada42a19d49e7d6e45ea5d2bc466e0b61f2 | |
| parent | b90a5cf11cdb69e60aed7be732e80113bca7bbe4 (diff) | |
| download | cpython-562d7149c6944fb9e4c7be80664b2f2d5a12a3ea.zip cpython-562d7149c6944fb9e4c7be80664b2f2d5a12a3ea.tar.gz cpython-562d7149c6944fb9e4c7be80664b2f2d5a12a3ea.tar.bz2 | |
Correct documentation for AF_PACKET (#112339)
Protocol in the address tuple should *not* be in the network-byte-order, because it is converted internally[1].
[1] https://github.com/python/cpython/blob/89ddea4886942b0c27a778a0ad3f0d5ac5f518f0/Modules/socketmodule.c#L2144
network byte order doesn't make sense for a python level int anyways. It's a fixed size C serialization concept.
| -rw-r--r-- | Doc/library/socket.rst | 3 |
1 files changed, 1 insertions, 2 deletions
diff --git a/Doc/library/socket.rst b/Doc/library/socket.rst index e36fc17..e0a7530 100644 --- a/Doc/library/socket.rst +++ b/Doc/library/socket.rst @@ -185,7 +185,7 @@ created. Socket addresses are represented as follows: .. versionadded:: 3.7 - :const:`AF_PACKET` is a low-level interface directly to network devices. - The packets are represented by the tuple + The addresses are represented by the tuple ``(ifname, proto[, pkttype[, hatype[, addr]]])`` where: - *ifname* - String specifying the device name. @@ -193,7 +193,6 @@ created. Socket addresses are represented as follows: May be :data:`ETH_P_ALL` to capture all protocols, one of the :ref:`ETHERTYPE_* constants <socket-ethernet-types>` or any other Ethernet protocol number. - Value must be in network-byte-order. - *pkttype* - Optional integer specifying the packet type: - ``PACKET_HOST`` (the default) - Packet addressed to the local host. |