diff options
| -rw-r--r-- | Doc/library/socket.rst | 9 | ||||
| -rw-r--r-- | Doc/library/ssl.rst | 25 |
2 files changed, 23 insertions, 11 deletions
diff --git a/Doc/library/socket.rst b/Doc/library/socket.rst index 0af8db628d..bad4417b32 100644 --- a/Doc/library/socket.rst +++ b/Doc/library/socket.rst @@ -515,6 +515,9 @@ The module :mod:`socket` exports the following constants and functions: Module :mod:`SocketServer` Classes that simplify writing network servers. + Module :mod:`ssl` + A TLS/SSL wrapper for socket objects. + .. _socket-objects: @@ -551,6 +554,12 @@ correspond to Unix system calls applicable to sockets. remote end will receive no more data (after queued data is flushed). Sockets are automatically closed when they are garbage-collected. + .. note:: + :meth:`close()` releases the resource associated with a connection but + does not necessarily close the connection immediately. If you want + to close the connection in a timely fashion, call :meth:`shutdown()` + before :meth:`close()`. + .. method:: socket.connect(address) diff --git a/Doc/library/ssl.rst b/Doc/library/ssl.rst index e802381a01..e69492874b 100644 --- a/Doc/library/ssl.rst +++ b/Doc/library/ssl.rst @@ -1,8 +1,8 @@ -:mod:`ssl` --- SSL wrapper for socket objects -============================================= +:mod:`ssl` --- TLS/SSL wrapper for socket objects +================================================= .. module:: ssl - :synopsis: SSL wrapper for socket objects + :synopsis: TLS/SSL wrapper for socket objects .. moduleauthor:: Bill Janssen <bill.janssen@gmail.com> @@ -582,13 +582,17 @@ the other end, and use :func:`wrap_socket` to create a server-side SSL context for it:: while True: - newsocket, fromaddr = bindsocket.accept() - connstream = ssl.wrap_socket(newsocket, - server_side=True, - certfile="mycertfile", - keyfile="mykeyfile", - ssl_version=ssl.PROTOCOL_TLSv1) - deal_with_client(connstream) + newsocket, fromaddr = bindsocket.accept() + connstream = ssl.wrap_socket(newsocket, + server_side=True, + certfile="mycertfile", + keyfile="mykeyfile", + ssl_version=ssl.PROTOCOL_TLSv1) + try: + deal_with_client(connstream) + finally: + connstream.shutdown(socket.SHUT_RDWR) + connstream.close() Then you'd read data from the ``connstream`` and do something with it till you are finished with the client (or the client is finished with you):: @@ -604,7 +608,6 @@ are finished with the client (or the client is finished with you):: break data = connstream.read() # finished with client - connstream.close() And go back to listening for new client connections. |