From 3b3a141a83a1e9141cecfdc1d2ee661f253b030c Mon Sep 17 00:00:00 2001 From: Yury Selivanov Date: Mon, 7 Nov 2016 15:35:25 -0500 Subject: [PATCH] Issue #27392: Document loop.connect_accepted_socket() Patch by Jim Fulton. --- Doc/library/asyncio-eventloop.rst | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/Doc/library/asyncio-eventloop.rst b/Doc/library/asyncio-eventloop.rst index cf2f3d630c8..d7201601c59 100644 --- a/Doc/library/asyncio-eventloop.rst +++ b/Doc/library/asyncio-eventloop.rst @@ -461,6 +461,23 @@ Creating listening connections Availability: UNIX. +.. coroutinemethod:: BaseEventLoop.connect_accepted_socket(protocol_factory, sock, \*, ssl=None) + + Handle an accepted connection. + + This is used by servers that accept connections outside of + asyncio but that use asyncio to handle them. + + Parameters: + + * *sock* is a preexisting socket object returned from an ``accept`` + call. + + * *ssl* can be set to an :class:`~ssl.SSLContext` to enable SSL over the + accepted connections. + + This method is a :ref:`coroutine `. When completed, the + coroutine returns a ``(transport, protocol)`` pair. Watch file descriptors ----------------------