summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--Doc/library/asyncio-eventloop.rst8
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,