From 8cabcde8d66bfd8abc98b862c93c66946f8514a1 Mon Sep 17 00:00:00 2001 From: "Miss Islington (bot)" <31488909+miss-islington@users.noreply.github.com> Date: Wed, 24 Nov 2021 12:39:51 -0800 Subject: bpo-45693: Document `port` parameter to `loop.create_server` (GH-29760) (GH-29762) Document the `port` parameter to `loop.create_server` in `asyncio`. In particular, note that if `host` resolves to multiple network interfaces, passing in `port=0` will result in a different random unused port being used for each interface. Automerge-Triggered-By: GH:ericvsmith (cherry picked from commit d71c7bc7339eb82de493c66ebbbfa1cad250ac78) Co-authored-by: Jim Crist-Harif Co-authored-by: Jim Crist-Harif --- Doc/library/asyncio-eventloop.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/Doc/library/asyncio-eventloop.rst b/Doc/library/asyncio-eventloop.rst index eee8095..44798dc 100644 --- a/Doc/library/asyncio-eventloop.rst +++ b/Doc/library/asyncio-eventloop.rst @@ -631,6 +631,11 @@ Creating network servers assumed and a list of multiple sockets will be returned (most likely one for IPv4 and another one for IPv6). + * The *port* parameter can be set to specify which port the server should + listen on. If ``0`` or ``None`` (the default), a random unused port will + be selected (note that if *host* resolves to multiple network interfaces, + a different random port will be selected for each interface). + * *family* can be set to either :data:`socket.AF_INET` or :data:`~socket.AF_INET6` to force the socket to use IPv4 or IPv6. If not set, the *family* will be determined from host name -- cgit v0.12