From f1b65d757d3d19d014635a3606cd84c770d3bc33 Mon Sep 17 00:00:00 2001 From: "Miss Islington (bot)" <31488909+miss-islington@users.noreply.github.com> Date: Sun, 30 Mar 2025 10:28:26 +0200 Subject: [PATCH] [3.12] gh-129994: update docs when using `dualstack_ipv6` in `socket.create_server` (GH-129996) (#131891) gh-129994: update docs when using `dualstack_ipv6` in `socket.create_server` (GH-129996) (cherry picked from commit 044a1e13d5cfc91b0a8774e936877e91cbac3a16) Co-authored-by: Alexander Ershov <150328014+AEErshov@users.noreply.github.com> --- Doc/library/socket.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Doc/library/socket.rst b/Doc/library/socket.rst index c0b88b8546df..d29e3c20e102 100644 --- a/Doc/library/socket.rst +++ b/Doc/library/socket.rst @@ -833,10 +833,10 @@ The following functions all create :ref:`socket objects `. , a default reasonable value is chosen. *reuse_port* dictates whether to set the :data:`SO_REUSEPORT` socket option. - If *dualstack_ipv6* is true and the platform supports it the socket will - be able to accept both IPv4 and IPv6 connections, else it will raise - :exc:`ValueError`. Most POSIX platforms and Windows are supposed to support - this functionality. + If *dualstack_ipv6* is true, *family* is :data:`AF_INET6` and the platform + supports it the socket will be able to accept both IPv4 and IPv6 connections, + else it will raise :exc:`ValueError`. Most POSIX platforms and Windows are + supposed to support this functionality. When this functionality is enabled the address returned by :meth:`socket.getpeername` when an IPv4 connection occurs will be an IPv6 address represented as an IPv4-mapped IPv6 address. -- 2.47.3