diff options
| author | Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> | 2024-06-24 08:55:28 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2024-06-24 08:55:28 (GMT) |
| commit | 206028dba986f982a940377ab1cb8b8276301b82 (patch) | |
| tree | 8b3862f5d7e6b22a99daa9b266c78d6c6a6fc189 /Doc | |
| parent | 544a47212b92f52ceffbd50275c6b0c57a446a98 (diff) | |
| download | cpython-206028dba986f982a940377ab1cb8b8276301b82.zip cpython-206028dba986f982a940377ab1cb8b8276301b82.tar.gz cpython-206028dba986f982a940377ab1cb8b8276301b82.tar.bz2 | |
[3.13] gh-112169: Documented getaddrinfo/getnameinfo default loop executor usage and implications. (GH-112191) (#120935)
gh-112169: Documented getaddrinfo/getnameinfo default loop executor usage and implications. (GH-112191)
(cherry picked from commit fc297b4ba4c61febeb2d8f5d718f2955c6bbea0a)
Co-authored-by: Alek Kowalczyk <alek.kowalczyk@gmail.com>
Co-authored-by: Guido van Rossum <gvanrossum@gmail.com>
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
Diffstat (limited to 'Doc')
| -rw-r--r-- | Doc/library/asyncio-eventloop.rst | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/Doc/library/asyncio-eventloop.rst b/Doc/library/asyncio-eventloop.rst index 374e789..1d79f78 100644 --- a/Doc/library/asyncio-eventloop.rst +++ b/Doc/library/asyncio-eventloop.rst @@ -1155,6 +1155,14 @@ DNS Asynchronous version of :meth:`socket.getnameinfo`. +.. note:: + Both *getaddrinfo* and *getnameinfo* internally utilize their synchronous + versions through the loop's default thread pool executor. + When this executor is saturated, these methods may experience delays, + which higher-level networking libraries may report as increased timeouts. + To mitigate this, consider using a custom executor for other user tasks, + or setting a default executor with a larger number of workers. + .. versionchanged:: 3.7 Both *getaddrinfo* and *getnameinfo* methods were always documented to return a coroutine, but prior to Python 3.7 they were, in fact, |