HEX

File: //lib/python3/dist-packages/twisted/internet/__pycache__/tcp.cpython-38.pyc
U

^h�b���@s"dZddlZddlZddlZddlZddlmZmZmZm	Z	m
Z
ddlmZm
Z
ddlZddlmZmZmZmZddlmZmZmZddlmZmZddlmZdd	lmZz$dd
lm Z!m"Z#m$Z%ddlm&Z&WnDe'k
�reZ&Gdd
�d
�Z#Gdd�d�Z!Gdd�d�Z%YnXedk�rte(�Z)ddl*m+Z,m-Z.m/Z0m1Z2m3Z4m5Z6m7Z8e(�Z9e(�Z:e8Z;ddl*m<Z=ddl>m?Z@n�ddl*m)Z)ddl*m0Z0ddl*m8Z8ddl*m.Z.ddl*m,Z,ddl*m2Z2ddl*m6Z6ddl*m4Z4ddl*m9Z9ddl*m:Z:dd l*m;Z;dd!l*m=Z=dd"lm@Z@dd#l*mAZAdd$lBmCZCmDZDmEZEmFZFmGZGmHZHdd%lImJZJdd&lKm
Z
dd'lLmMZMdd(lmNZNmOZOmPZPdd)lQmRZReSed*d�ZTd+d,�ZUd-d.�ZVd/d0�ZWGd1d2�d2�ZXGd3d4�d4�ZYe
e&ee�Gd5d6�d6e#eCjZeXeY��Z[Gd7d8�d8�Z\Gd9d:�d:e\e!e[�Z]ej^eTBZ_d;d<�Z`Gd=d>�d>�ZaGd?d@�d@eae]�ZbGdAdB�dBe%e[�ZcGdCdD�dDe�ZdGdEdF�dFe
�Zee
ed�ejfdGdH�GdIdJ�dJ���Zge
ed�GdKdL�dL��Zhedk�r�eh�ZinegdMdN��Zie4e6e9e:e=fZjejfdGdH�GdOdP�dP��ZkdQdR�Zle
e�GdSdT�dTeEjmeX��ZnGdUdV�dVeEjo�ZpdS)Wzt
Various asynchronous TCP/IP classes.

End users shouldn't use this module directly - use the reactor APIs instead.
�N)�Callable�ClassVar�List�Optional�Protocol)�	Interface�implementer)�IHalfCloseableProtocol�IListeningPort�
ISystemHandle�
ITCPTransport)�ILogObserver�LogEvent�Logger)�	deprecate�versions)�
lazyByteSlice)�platformType)�ClientMixin�ConnectionMixin�ServerMixin)�
ITLSTransportc@seZdZdZdS)�_TLSConnectionMixinFN)�__name__�
__module__�__qualname__�TLS�rr�6/usr/lib/python3/dist-packages/twisted/internet/tcp.pyr/src@seZdZdS)�_TLSClientMixinN�rrrrrrrr2src@seZdZdS)�_TLSServerMixinNr rrrrr!5sr!�win32)�WSAEALREADY�WSAEINPROGRESS�	WSAEINVAL�
WSAEISCONN�	WSAEMFILE�
WSAENOBUFS�WSAEWOULDBLOCK)�
WSAECONNRESET)�formatError)�EPERM)�EINVAL)�EWOULDBLOCK)�EINPROGRESS)�EALREADY)�EISCONN)�ENOBUFS)�EMFILE)�ENFILE)�ENOMEM)�EAGAIN)�ECONNABORTED)�strerror)�	errorcode)�abstract�address�base�error�fdesc�main)�CannotListenError)r)�
deferLater)�failure�log�reflect)�untilConcludes�AI_NUMERICSERVcCsNt|�dkr>t�|tjtjB�d}t|gt|dd���S|dd�SdS)ai
    Return a 2-tuple of socket IP and port for IPv4 and a 4-tuple of
    socket IP, port, flowInfo, and scopeID for IPv6.  For IPv6, it
    returns the interface portion (the part after the %) as a part of
    the IPv6 address, which Python 3.7+ does not include.

    @param addr: A 2-tuple for IPv4 information or a 4-tuple for IPv6
        information.
    �r�N�)�len�socket�getnameinfo�NI_NUMERICHOST�NI_NUMERICSERV�tuple�list)�addr�hostrrr�_getrealnamems
�rScCst|���S�z
    See L{_getrealname}.
    )rS�getpeername��sktrrr�_getpeername�srXcCst|���SrT)rS�getsocknamerVrrr�_getsockname�srZc@seZdZdZdZdd�ZdS)�
_SocketCloserz�
    @ivar _shouldShutdown: Set to C{True} if C{shutdown} should be called
        before calling C{close} on the underlying socket.
    @type _shouldShutdown: C{bool}
    Tc	Csz|j}z8|r|jr<|�d�n|j�tjtjt�ddd��Wntk
rRYnXz|�	�Wntk
rtYnXdS)NrIZiirHr)
rK�_shouldShutdown�shutdown�
setsockopt�
SOL_SOCKET�	SO_LINGER�structZpack�OSError�close)�selfZorderlyrWrrr�_closeSocket�s �z_SocketCloser._closeSocketN)rrr�__doc__r\rerrrrr[�sr[c@seZdZdZdZdd�ZdS)�_AbortingMixinz�
    Common implementation of C{abortConnection}.

    @ivar _aborting: Set to C{True} when C{abortConnection} is called.
    @type _aborting: C{bool}
    FcCsZ|js|jrdSd|_|��|��dd�|_dd�|_|j�d|jt	�
t����dS)zf
        Aborts the connection immediately, dropping any buffered data.

        @since: 11.1
        NTc_sdS�Nr��args�kwargsrrr�<lambda>��z0_AbortingMixin.abortConnection.<locals>.<lambda>c_sdSrhrrirrrrl�rmr)
�disconnected�	_aborting�stopReading�stopWriting�doRead�doWrite�reactor�	callLater�connectionLostrB�Failurer=�ConnectionAborted�rdrrr�abortConnection�s

�z_AbortingMixin.abortConnectionN)rrrrfrorzrrrrrg�srgc@s~eZdZdZddd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZdZdd�Z
dd�Zdd�Zdd�Zdd�ZdS)�
Connectiona

    Superclass of all socket-based FileDescriptors.

    This is an abstract superclass of all objects which represent a TCP/IP
    connection based socket.

    @ivar logstr: prefix used when logging events related to this connection.
    @type logstr: C{str}
    NcCs4tjj||d�||_|j�d�|j|_||_dS)N�rtr)r:�FileDescriptor�__init__rK�setblocking�fileno�protocol)rdrWr�rtrrrr~�s
zConnection.__init__cCs|jS)z&Return the socket for this connection.)rKryrrr�	getHandle�szConnection.getHandlec
Csfz|j�|j�}WnHtk
rZ}z*|jdtkr<WY�dStjWY�SW5d}~XYnX|�|�S)a\Calls self.protocol.dataReceived with all available data.

        This reads up to self.bufferSize bytes of data from its socket, then
        calls self.dataReceived(data) to process it.  If the connection is not
        lost through an error in the physical recv(), this function will return
        the result of the dataReceived call.
        rN)	rK�recvZ
bufferSizerbrjr.r?�CONNECTION_LOST�
_dataReceived)rd�data�serrrrr�s
 zConnection.doReadcCsV|s
tjS|j�|�}|dk	rR|jj}d}tj|t�dddd�|d�}t�||�|S)NzPReturning a value other than None from %(fqpn)s is deprecated since %(version)s.�Twisted�r)�format)	r?�CONNECTION_DONEr�ZdataReceivedr�getDeprecationWarningStringr�Version�warnAboutFunction)rdr�Zrval�offenderZ
warningFormat�
warningStringrrrr��s��zConnection._dataReceivedc
Cspt|d|j�}zt|jj|�WStk
rj}z.|jdttfkrLWY�dSt	j
WY�SW5d}~XYnXdS)a
        Write as much as possible of the given data to this TCP connection.

        This sends up to C{self.SEND_LIMIT} bytes from C{data}.  If the
        connection is lost, an exception is returned.  Otherwise, the number
        of bytes successfully written is returned.
        rN)rZ
SEND_LIMITrErK�sendrbrjr.r2r?r�)rdr�ZlimitedDatar�rrr�
writeSomeData	s

zConnection.writeSomeDatacCsvz|j�d�Wntk
r$YnXt|jd�}|rrz|��Wn.tk
rpt��}t	�
�|�|�YnXdS�NrH)rKr]rbr	r�ZwriteConnectionLost�
BaseExceptionrBrwrC�errrv)rd�p�frrr�_closeWriteConnectionsz Connection._closeWriteConnectioncCsXt|jd�}|rJz|��WqTtk
rFt��|�t���YqTXn
|�|�dSrh)	r	r��readConnectionLostr�rCr�rvrBrw)rd�reasonr�rrrr�+szConnection.readConnectionLostcCsPt|d�sdStj�||�|�|�tj��|j}|`|`	|`
|�|�dS)z-See abstract.FileDescriptor.connectionLost().rKN)�hasattrr:r}rvreZcheckr=rxr�rKr�)rdr�r�rrrrv6s
zConnection.connectionLostZ
UninitializedcCs|jS)z<Return the prefix to log with when I own the logging thread.)�logstrryrrr�	logPrefixIszConnection.logPrefixcCst|j�tjtj��Srh)�boolrK�
getsockopt�IPPROTO_TCP�TCP_NODELAYryrrr�
getTcpNoDelayMszConnection.getTcpNoDelaycCs|j�tjtj|�dSrh)rKr^r�r��rdZenabledrrr�
setTcpNoDelayPszConnection.setTcpNoDelaycCst|j�tjtj��Srh)r�rKr�r_�SO_KEEPALIVEryrrr�getTcpKeepAliveSszConnection.getTcpKeepAlivecCs|j�tjtj|�dSrh)rKr^r_r�r�rrr�setTcpKeepAliveVszConnection.setTcpKeepAlive)N)rrrrfr~r�rrr�r�r�r�rvr�r�r�r�r�r�rrrrr{�s

r{c@sLeZdZdZejZejZdd�Z	dd�Z
dd�Zdd	�Zd
d�Z
dd
�ZdS)�_BaseBaseClienta�	
    Code shared with other (non-POSIX) reactors for management of general
    outgoing connections.

    Requirements upon subclasses are documented as instance variables rather
    than abstract methods, in order to avoid MRO confusion, since this base is
    mixed in to unfortunately weird and distinctive multiple-inheritance
    hierarchies and many of these attributes are provided by peer classes
    rather than descendant classes in those hierarchies.

    @ivar addressFamily: The address family constant (C{socket.AF_INET},
        C{socket.AF_INET6}, C{socket.AF_UNIX}) of the underlying socket of this
        client connection.
    @type addressFamily: C{int}

    @ivar socketType: The socket type constant (C{socket.SOCK_STREAM} or
        C{socket.SOCK_DGRAM}) of the underlying socket.
    @type socketType: C{int}

    @ivar _requiresResolution: A flag indicating whether the address of this
        client will require name resolution.  C{True} if the hostname of said
        address indicates a name that must be resolved by hostname lookup,
        C{False} if it indicates an IP address literal.
    @type _requiresResolution: C{bool}

    @cvar _commonConnection: Subclasses must provide this attribute, which
        indicates the L{Connection}-alike class to invoke C{__init__} and
        C{connectionLost} on.
    @type _commonConnection: C{type}

    @ivar _stopReadingAndWriting: Subclasses must implement in order to remove
        this transport from its reactor's notifications in response to a
        terminated connection attempt.
    @type _stopReadingAndWriting: 0-argument callable returning L{None}

    @ivar _closeSocket: Subclasses must implement in order to close the socket
        in response to a terminated connection attempt.
    @type _closeSocket: 1-argument callable; see L{_SocketCloser._closeSocket}

    @ivar _collectSocketDetails: Clean up references to the attached socket in
        its underlying OS resource (such as a file descriptor or file handle),
        as part of post connection-failure cleanup.
    @type _collectSocketDetails: 0-argument callable returning L{None}.

    @ivar reactor: The class pointed to by C{_commonConnection} should set this
        attribute in its constructor.
    @type reactor: L{twisted.internet.interfaces.IReactorTime},
        L{twisted.internet.interfaces.IReactorCore},
        L{twisted.internet.interfaces.IReactorFDSet}
    cCs8|r$|j�||d|�|�d|�n|�d|j|�dS)ax
        Called by subclasses to continue to the stage of initialization where
        the socket connect attempt is made.

        @param whenDone: A 0-argument callable to invoke once the connection is
            set up.  This is L{None} if the connection could not be prepared
            due to a previous error.

        @param skt: The socket object to use to perform the connection.
        @type skt: C{socket._socketobject}

        @param error: The error to fail the connection with.

        @param reactor: The reactor to use for this client.
        @type reactor: L{twisted.internet.interfaces.IReactorTime}
        Nr)�_commonConnectionr~ru�failIfNotConnected)rd�whenDonerWr=rtrrr�_finishInit�sz_BaseBaseClient._finishInitcsL�jr<�j��jd�}|��fdd��|��j�j�n���j�dS)a�
        Resolve the name that was passed to this L{_BaseBaseClient}, if
        necessary, and then move on to attempting the connection once an
        address has been determined.  (The connection will be attempted
        immediately within this function if either name resolution can be
        synchronous or the address was an IP address literal.)

        @note: You don't want to call this method from outside, as it won't do
            anything useful; it's just part of the connection bootstrapping
            process.  Also, although this method is on L{_BaseBaseClient} for
            historical reasons, it's not used anywhere except for L{Client}
            itself.

        @return: L{None}
        rcs|f�jdd�Sr�)rQ)�nryrrrl�rmz0_BaseBaseClient.resolveAddress.<locals>.<lambda>N)�_requiresResolutionrtZresolverQZaddCallbackZaddCallbacks�_setRealAddressr�)rd�drryr�resolveAddress�s
z_BaseBaseClient.resolveAddresscCsTt|�dkrBt�|tjtjB�d}t|gt|dd���|_n||_|��dS)a�
        Set the resolved address of this L{_BaseBaseClient} and initiate the
        connection attempt.

        @param address: Depending on whether this is an IPv4 or IPv6 connection
            attempt, a 2-tuple of C{(host, port)} or a 4-tuple of C{(host,
            port, flow, scope)}.  At this point it is a fully resolved address,
            and the 'host' portion will always be an IP address, not a DNS
            name.
        rGrrHN)	rJrKrLrMrNrOrP�realAddress�	doConnect)rdr;�hostnamerrrr��s
��z_BaseBaseClient._setRealAddresscCsh|js|jst|d�sdS|��z|�d�Wntk
rDYn
X|��|j�t	�
|��|`dS)z�
        Generic method called when the attempts to connect failed. It basically
        cleans everything it can: call connectionFailed, stop read and write,
        delete socket related members.
        �	connectorNT)�	connectedrnr��_stopReadingAndWritingre�AttributeError�_collectSocketDetailsr�ZconnectionFailedrBrw)rdr�rrrr��sz"_BaseBaseClient.failIfNotConnectedcCs|�t���dS)z�
        If a connection attempt is still outstanding (i.e.  no connection is
        yet established), immediately stop attempting to connect.
        N)r�r=�	UserErrorryrrr�stopConnecting�sz_BaseBaseClient.stopConnectingcCs8|js|�tj|d��n|j�||�|j�|�dS)a�
        Invoked by lower-level logic when it's time to clean the socket up.
        Depending on the state of the connection, either inform the attached
        L{Connector} that the connection attempt has failed, or inform the
        connected L{IProtocol} that the established connection has been lost.

        @param reason: the reason that the connection was terminated
        @type reason: L{Failure}
        ��stringN)r�r�r=�ConnectErrorr�rvr��rdr�rrrrv�s
z_BaseBaseClient.connectionLostN)rrrrfrK�AF_INET�
addressFamily�SOCK_STREAM�
socketTyper�r�r�r�r�rvrrrrr�Zs3r�c@s@eZdZdZeZeZdd�Zdd�Zdd�Z	dd	�Z
d
d�ZdS)
�
BaseClienta�
    A base class for client TCP (and similar) sockets.

    @ivar realAddress: The address object that will be used for socket.connect;
        this address is an address tuple (the number of elements dependent upon
        the address family) which does not contain any names which need to be
        resolved.
    @type realAddress: C{tuple}

    @ivar _base: L{Connection}, which is the base class of this class which has
        all of the useful file descriptor methods.  This is used by
        L{_TLSServerMixin} to call the right methods to directly manipulate the
        transport, as is necessary for writing TLS-encrypted bytes (whereas
        those methods on L{Server} will go through another layer of TLS if it
        has been enabled).
    cCst|d�r|��|��dS)z�
        Implement the POSIX-ish (i.e.
        L{twisted.internet.interfaces.IReactorFDSet}) method of detaching this
        socket from the reactor for L{_BaseBaseClient}.
        rtN)r�rprqryrrrr�s
z!BaseClient._stopReadingAndWritingcCs|`|`dS)zn
        Clean up references to the socket and its file descriptor.

        @see: L{_BaseBaseClient}
        N)rKr�ryrrrr�sz BaseClient._collectSocketDetailscCs,t�|j|j�}|�d�t�|���|S)zc(internal) Create a non-blocking socket using
        self.addressFamily, self.socketType.
        r)rKr�r�rr>�_setCloseOnExecr��rd�srrr�createInternetSocket's
zBaseClient.createInternetSocketc
Cs|j|_|j|_t|d�sdS|j�tjtj�}|rP|�t	�
|t|�f��dSz|j�|j
�}Wn,tk
r�}z|jd}W5d}~XYnX|r�|tkr�nN|tttfks�|tkr�tdkr�|��|��dS|�t	�
|t|�f��dS|`|`|��|��|��dS)z�
        Initiate the outgoing connection attempt.

        @note: Applications do not need to call this method; it will be invoked
            internally as part of L{IReactorTCP.connectTCP}.
        r�Nrr")r�rsrrr�rKr�r_�SO_ERRORr�r=�getConnectErrorr8�
connect_exr�rbrjr1r.r/r0r-r�startReadingZstartWritingrprq�_connectDone)rdr�Z
connectResultr�rrrr�0s@
	���zBaseClient.doConnectcCsb|j�|���|_d|_|�|j�}d||_|jdkrJt�|_|��n|�	�|j�
|�dS)a�
        This is a hook for when a connection attempt has succeeded.

        Here, we build the protocol from the
        L{twisted.internet.protocol.ClientFactory} that was passed in, compute
        a log string, begin reading so as to send traffic to the newly built
        protocol, and finally hook up the protocol itself.

        This hook is overridden by L{ssl.Client} to initiate the TLS protocol.
        rHz	%s,clientN)r��
buildProtocol�getPeerr�r��
_getLogPrefixr�r�loseConnectionr��makeConnection)rdr�rrrr�hs


zBaseClient._connectDoneN)rrrrfr{�_baser�r�r�r�r�r�rrrrr��s	8r�cCst�||dddt�ddS)av
    Resolve an IPv6 literal into an IPv6 address.

    This is necessary to resolve any embedded scope identifiers to the relevant
    C{sin6_scope_id} for use with C{socket.connect()}, C{socket.listen()}, or
    C{socket.bind()}; see U{RFC 3493 <https://tools.ietf.org/html/rfc3493>} for
    more information.

    @param ip: An IPv6 address literal.
    @type ip: C{str}

    @param port: A port number.
    @type port: C{int}

    @return: a 4-tuple of C{(host, port, flow, scope)}, suitable for use as an
        IPv6 address.

    @raise socket.gaierror: if either the IP or port is not numeric as it
        should be.
    rrG)rK�getaddrinfo�
_NUMERIC_ONLY)Zip�portrrr�_resolveIPv6�sr�c@s>eZdZdZejZddd�Zdd�Zdd�Z	e
d	�d
d�ZdS)
�_BaseTCPClienta�
    Code shared with other (non-POSIX) reactors for management of outgoing TCP
    connections (both TCPv4 and TCPv6).

    @note: In order to be functional, this class must be mixed into the same
        hierarchy as L{_BaseBaseClient}.  It would subclass L{_BaseBaseClient}
        directly, but the class hierarchy here is divided in strange ways out
        of the need to share code along multiple axes; specifically, with the
        IOCP reactor and also with UNIX clients in other reactors.

    @ivar _addressType: The Twisted _IPAddress implementation for this client
    @type _addressType: L{IPv4Address} or L{IPv6Address}

    @ivar connector: The L{Connector} which is driving this L{_BaseTCPClient}'s
        connection attempt.

    @ivar addr: The address that this socket will be connecting to.
    @type addr: If IPv4, a 2-C{tuple} of C{(str host, int port)}.  If IPv6, a
        4-C{tuple} of (C{str host, int port, int ignored, int scope}).

    @ivar createInternetSocket: Subclasses must implement this as a method to
        create a python socket object of the appropriate address family and
        socket type.
    @type createInternetSocket: 0-argument callable returning
        C{socket._socketobject}.
    Nc
Cs@||_||f|_|j}d}d}t�|�r0d|_n4t�|�r^d|_t||�|_tj	|_
tj|_
nd|_z|��}Wn>tk
r�}	z t�|	jd|	jd�}d}W5d}	~	XYnX|�r,|dk	�r,z*t�|d�r�t|�}
n|}
|�|
�Wn@tk
�r*}	z t�|	jd|	jd�}d}W5d}	~	XYnX|�||||�dS)NFTrrH)r�rQr�r:ZisIPAddressr��
isIPv6Addressr�rK�AF_INET6r�r;�IPv6Address�_addressTyper�rbr=�ConnectBindErrorrj�bindr�)rdrRr��bindAddressr�rtr�r�rWr�Zbindinforrrr~�s8




z_BaseTCPClient.__init__cCs|jdt|j���S)z~
        Returns an L{IPv4Address} or L{IPv6Address}.

        This indicates the address from which I am connecting.
        �TCP)r�)r�rZrKryrrr�getHost�sz_BaseTCPClient.getHostcCs|jd|j��S)zz
        Returns an L{IPv4Address} or L{IPv6Address}.

        This indicates the address that I am connected to.
        r�)r�)r�r�ryrrrr��sz_BaseTCPClient.getPeer��returncCs&d|j�d|j�dt|�d�d�}|S)N�<z to z at �x�>)�	__class__rQ�idr�rrr�__repr__�s"z_BaseTCPClient.__repr__)N)rrrrfr;�IPv4Addressr�r~r�r��strr�rrrrr��s
#r�c@seZdZdZdS)�Clientz�
    A transport for a TCP protocol; either TCPv4 or TCPv6.

    Do not create these directly; use L{IReactorTCP.connectTCP}.
    N)rrrrfrrrrr��sr�c@sLeZdZdZeZejZdd�Z	e
d�dd�Zedd��Z
d	d
�Zdd�Zd
S)�Servera<
    Serverside socket-stream connection class.

    This is a serverside network connection transport; a socket which came from
    an accept() on a server.

    @ivar _base: L{Connection}, which is the base class of this class which has
        all of the useful file descriptor methods.  This is used by
        L{_TLSServerMixin} to call the right methods to directly manipulate the
        transport, as is necessary for writing TLS-encrypted bytes (whereas
        those methods on L{Server} will go through another layer of TLS if it
        has been enabled).
    cCs�t�||||�t|�dkr$tj|_||_||_||_|d|_	|�
|j�}|�d|�d|j	��|_|jdk	r�d�
|jjj|j|jj�|_|��d|_dS)a

        Server(sock, protocol, client, server, sessionno)

        Initialize it with a socket, a protocol, a descriptor for my peer (a
        tuple of host, port describing the other end of the connection), an
        instance of Port, and a session number.
        rIr�,N�<{} #{} on {}>rH)r{r~rJr;r�r��server�client�	sessionnor�r�r�r�r�r�r�_realPortNumber�repstrr�r�)rd�sockr�r�r�r�rtr�rrrr~s"

�zServer.__init__r�cCs|jS)z=
        A string representation of this connection.
        )r�ryrrrr�,szServer.__repr__cCs�tj}|tjkrtj}t�||tj�}t|�}|d|��}|��d}	|�	|�}
|
dkrd|�
�dS|||
|d|d|�}d�|jj
j|j|	�|_|
�|�|S)a�
        Create a new L{Server} based on an existing connected I{SOCK_STREAM}
        socket.

        Arguments are the same as to L{Server.__init__}, except where noted.

        @param fileDescriptor: An integer file descriptor associated with a
            connected socket.  The socket must be in non-blocking mode.  Any
            additional attributes desired, such as I{FD_CLOEXEC}, must also be
            set already.

        @param addressFamily: The address family (sometimes called I{domain})
            of the existing socket.  For example, L{socket.AF_INET}.

        @return: A new instance of C{cls} wrapping the socket given by
            C{fileDescriptor}.
        r�rHNr�)r�)r;r�rKr�r��fromfdr�rXrYr�rcr�r�r�rr�r�r�)�cls�fileDescriptorr��factoryrtZaddressTyperWrQZprotocolAddrZ	localPortr�rdrrr�_fromConnectedSocket2s&

�
zServer._fromConnectedSocketcCst|j�}|jd|��S)zl
        Returns an L{IPv4Address} or L{IPv6Address}.

        This indicates the server's address.
        r�)r��rZrKr��rdrQrrrr�[s
zServer.getHostcCs|jd|j��S)zl
        Returns an L{IPv4Address} or L{IPv6Address}.

        This indicates the client's address.
        r�)r�)r�r�ryrrrr�dszServer.getPeerN)rrrrfr{r�r;r�r�r~r�r��classmethodr�r�r�rrrrr��s
(	r�c@s0eZdZdZdd�Zdd�Zdd�Zdd	�Zd
S)�_IFileDescriptorReservationaT
    An open file that represents an emergency reservation in the
    process' file descriptor table.  If L{Port} encounters C{EMFILE}
    on C{accept(2)}, it can close this file descriptor, retry the
    C{accept} so that the incoming connection occupies this file
    descriptor's space, and then close that connection and reopen this
    one.

    Calling L{_IFileDescriptorReservation.reserve} attempts to open
    the reserve file descriptor if it is not already open.
    L{_IFileDescriptorReservation.available} returns L{True} if the
    underlying file is open and its descriptor claimed.

    L{_IFileDescriptorReservation} instances are context managers;
    entering them releases the underlying file descriptor, while
    exiting them attempts to reacquire it.  The block can take
    advantage of the free slot in the process' file descriptor table
    accept and close a client connection.

    Because another thread might open a file descriptor between the
    time the context manager is entered and the time C{accept} is
    called, opening the reserve descriptor is best-effort only.
    cCsdS)z�
        Is the reservation available?

        @return: L{True} if the reserved file descriptor is open and
            can thus be closed to allow a new file to be opened in its
            place; L{False} if it is not open.
        Nrrrrr�	available�sz%_IFileDescriptorReservation.availablecCsdS)a!
        Attempt to open the reserved file descriptor; if this fails
        because of C{EMFILE}, internal state is reset so that another
        reservation attempt can be made.

        @raises Exception: Any exception except an L{OSError} whose
            errno is L{EMFILE}.
        Nrrrrr�reserve�sz#_IFileDescriptorReservation.reservecCsdS)z}
        Release the underlying file descriptor so that code within the
        context manager can open a new file.
        Nrrrrr�	__enter__�sz%_IFileDescriptorReservation.__enter__cCsdS)z�
        Attempt to re-open the reserved file descriptor.  See
        L{reserve} for caveats.

        @param excType: See L{object.__exit__}
        @param excValue: See L{object.__exit__}
        @param traceback: See L{object.__exit__}
        Nr)�excType�excValue�	tracebackrrr�__exit__�sz$_IFileDescriptorReservation.__exit__N�rrrrfr�rrrrrrrr�ms
	
r�c@seZdZed�dd�ZdS)�	_HasCloser�cCsdSrhrryrrrrc�sz_HasClose.closeN)rrr�objectrcrrrrr�srT)Zauto_attribsc@sneZdZUdZe�Zeeed<ege	fed<e
jddd�Ze
e	ed<dd	�Zd
d�Zdd
�Zdd�ZdS)�_FileDescriptorReservationa	
    L{_IFileDescriptorReservation} implementation.

    @ivar fileFactory: A factory that will be called to reserve a
        file descriptor.
    @type fileFactory: A L{callable} that accepts no arguments and
        returns an object with a C{close} method.
    �_log�_fileFactoryFN)�init�default�_fileDescriptorcCs
|jdk	S)z�
        See L{_IFileDescriptorReservation.available}.

        @return: L{True} if the reserved file descriptor is open and
            can thus be closed to allow a new file to be opened in its
            place; L{False} if it is not open.
        N)rryrrrr��sz$_FileDescriptorReservation.availablec
Cs^|jdkrZz|��}Wn<tk
rR}z|jtkr@|j�d�n�W5d}~XYnX||_dS)z=
        See L{_IFileDescriptorReservation.reserve}.
        Nz2Could not reserve EMFILE recovery file descriptor.)rrrb�errnor3r
rB)rdr��errrr�s

�z"_FileDescriptorReservation.reservecCs&|jdkrtd��|j��d|_dS)z?
        See L{_IFileDescriptorReservation.__enter__}.
        Nz5No file reserved.  Have you called my reserve method?)r�RuntimeErrorrcryrrrr�s

z$_FileDescriptorReservation.__enter__cCs2z|��Wn tk
r,|j�d�YnXdS)z>
        See L{_IFileDescriptorReservation.__exit__}.
        z5Could not re-reserve EMFILE recovery file descriptor.N)r�	Exceptionr
rB�rdrrrrrrr�sz#_FileDescriptorReservation.__exit__)rrrrfrr
r�__annotations__rr�attr�ibrrr�rrrrrrrr	�s
	
	r	c@s0eZdZdZdd�Zdd�Zdd�Zdd	�Zd
S)�_NullFileDescriptorReservationzB
    A null implementation of L{_IFileDescriptorReservation}.
    cCsdS)z�
        The reserved file is never available.  See
        L{_IFileDescriptorReservation.available}.

        @return: L{False}
        Frryrrrr��sz(_NullFileDescriptorReservation.availablecCsdS)zJ
        Do nothing.  See L{_IFileDescriptorReservation.reserve}.
        Nrryrrrr�sz&_NullFileDescriptorReservation.reservecCsdS)ze
        Do nothing. See L{_IFileDescriptorReservation.__enter__}

        @return: L{False}
        Nrryrrrrsz(_NullFileDescriptorReservation.__enter__cCsdS)z�
        Do nothing.  See L{_IFileDescriptorReservation.__exit__}.

        @param excType: See L{object.__exit__}
        @param excValue: See L{object.__exit__}
        @param traceback: See L{object.__exit__}
        Nrrrrrr	sz'_NullFileDescriptorReservation.__exit__Nrrrrrr�s
	rcCs
ttj�Srh)�open�os�devnullrrrrrl1rmrlc@sPeZdZUdZeed<eed<eje�	e
�d�Zee
ed<dd�Zdd	�Zd
S)�_BuffersLogsa@
    A context manager that buffers any log events until after its
    block exits.

    @ivar _namespace: The namespace of the buffered events.
    @type _namespace: L{str}.

    @ivar _observer: The observer to which buffered log events will be
        written
    @type _observer: L{twisted.logger.ILogObserver}.
    �
_namespace�	_observer)r
�_logscCst|j|jjd�S)z
        Enter a log buffering context.

        @return: A logger that buffers log events.
        @rtype: L{Logger}.
        )�	namespace�observer)rrr�appendryrrrrXsz_BuffersLogs.__enter__cCs|jD]}|�|�qdS)z�
        Exit a log buffering context and log all buffered events to
        the provided observer.

        @param excType: See L{object.__exit__}
        @param excValue: See L{object.__exit__}
        @param traceback: See L{object.__exit__}
        N)rr)rdrrr�eventrrrras	
z_BuffersLogs.__exit__N)rrrrfr�rr
rrZFactoryrPrrrrrrrrrrFs
	rc
cs6|D�]*}z|��\}}W�ntk
�r$}z�|jdttfkrNWY��dS|jdtkrfWY��qn�|jdtkr�|��r�|�d�|�Bt	||||�}|D]\}	}
|	�
�|jd|
d�q�|�d�W5QRXWY�@dS|jdtk�r|jdt|jdd�WY�dS�W5d}~XYqX||fVqdS)	a�
    Return a generator that yields client sockets from the provided
    listening socket until there are none left or an unrecoverable
    error occurs.

    @param logger: A logger to which C{accept}-related events will be
        logged.  This should not log to arbitrary observers that might
        open a file descriptor to avoid claiming the C{EMFILE} file
        descriptor on UNIX-like systems.
    @type logger: L{Logger}

    @param accepts: An iterable iterated over to limit the number
        consecutive C{accept}s.
    @type accepts: An iterable.

    @param listener: The listening socket.
    @type listener: L{socket.socket}

    @param reservedFD: A reserved file descriptor that can be used to
        recover from C{EMFILE} on UNIX-like systems.
    @type reservedFD: L{_IFileDescriptorReservation}

    @return: A generator that yields C{(socket, addr)} tuples from
        L{socket.socket.accept}
    rNz7EMFILE encountered; releasing reserved file descriptor.z-EMFILE recovery: Closed socket from {address})r;z-Re-reserving EMFILE recovery file descriptor.z/Could not accept new connection ({acceptError}))ZacceptError)
�acceptrbrjr.r6r,r3r��info�_acceptrc�_ACCEPT_ERRORSr9)ZloggerZacceptsZlistenerZ
reservedFD�_r�r;rZclientsToCloseZ
clientToCloseZ
closedAddressrrrr%ns<

���r%c@s�eZdZUdZejZeZdZ	dZ
dZdZdZ
eeed<dZejZejZe�Zd!dd	�Zed
d��Zed�d
d�Zdd�Zdd�Zdd�Z dd�Z!e"�#e$j%�fdd�Z&e&Z'dd�Z(dd�Z)dd�Z*dd �Z+dS)"�Porta.
    A TCP server port, listening for connections.

    When a connection is accepted, this will call a factory's buildProtocol
    with the incoming address as an argument, according to the specification
    described in L{twisted.internet.interfaces.IProtocolFactory}.

    If you wish to change the sort of transport that will be used, the
    C{transport} attribute will be called with the signature expected for
    C{Server.__init__}, so it can be replaced.

    @ivar deferred: a deferred created when L{stopListening} is called, and
        that will fire when connection is lost. This is not to be used it
        directly: prefer the deferred returned by L{stopListening} instead.
    @type deferred: L{defer.Deferred}

    @ivar disconnecting: flag indicating that the L{stopListening} method has
        been called and that no connections should be accepted anymore.
    @type disconnecting: C{bool}

    @ivar connected: flag set once the listen has successfully been called on
        the socket.
    @type connected: C{bool}

    @ivar _type: A string describing the connections which will be created by
        this port.  Normally this is C{"TCP"}, since this is a TCP port, but
        when the TLS implementation re-uses this class it overrides the value
        with C{"TLS"}.  Only used for logging.

    @ivar _preexistingSocket: If not L{None}, a L{socket.socket} instance which
        was created and initialized outside of the reactor and will be used to
        listen for connections (instead of a new socket being created by this
        L{Port}).
    r��2r�Nr�cCsFtjj||d�||_||_||_t�|�r<tj	|_
tj|_
||_dS)z,Initialize with a numeric port to listen on.r|N)r<�BasePortr~r�r��backlogr:r�rKr�r�r;r�r��	interface)rdr�r�r,r-rtrrrr~�s
z
Port.__init__cCs6t�|||j�}t|�d}|d|d||�}||_|S)a}
        Create a new L{Port} based on an existing listening I{SOCK_STREAM}
        socket.

        Arguments are the same as to L{Port.__init__}, except where noted.

        @param fd: An integer file descriptor associated with a listening
            socket.  The socket must be in non-blocking mode.  Any additional
            attributes desired, such as I{FD_CLOEXEC}, must also be set already.

        @param addressFamily: The address family (sometimes called I{domain}) of
            the existing socket.  For example, L{socket.AF_INET}.

        @return: A new instance of C{cls} wrapping the socket given by C{fd}.
        rN)rKr�r�rZ�_preexistingSocket)r�rt�fdr�r�r�r-rdrrr�_fromListeningDescriptor�s
zPort._fromListeningDescriptorr�cCs6|jdk	r d�|j|jj|j�Sd�|j|jj�SdS)Nz<{} of {} on {}>z<{} of {} (not listening)>)r�r�r�r�ryrrrr�s
��z
Port.__repr__cCs4tj�|�}tdkr0tjdkr0|�tjtj	d�|S)N�posix�cygwinrH)
r<r+r�r�sys�platformr^rKr_�SO_REUSEADDRr�rrrr� szPort.createInternetSocketc
Cst��|jdkr�z>|��}|jtjkr8t|j|j	�}n|j|j	f}|�
|�Wn2tk
r�}zt|j|j	|��W5d}~XYnX|�
|j�n|j}d|_d|_|��d|_t�d|�|j�|jf�|j��d|_||_|jj|_d|_|��dS)z�Create and bind my socket, and begin listening on it.

        This is called on unserialization, and must be called after creating a
        server to begin listening on the specified port.
        NFrHz%s starting on %sT�d)�_reservedFDrr.r�r�rKr�r�r-r�r�rbr@�listenr,r\rYr�rC�msgr�r�ZdoStartr�r��
numberAcceptsr�)rdrWrQ�lerrr�startListening&s4
"��

zPort.startListeningcCs|jd|��S)Nr�)r�)r�)rdr;rrr�
_buildAddrSszPort._buildAddrc
CsT�z.tdkr|j}nd}t|jj|jj���}d}t|t|�|jt	�}t
|d�D]�\}\}}t�|�
��t|�dkr�t�|tjtjB�}t|dgt|dd���}|j�|�|��}|dkr�|��qN|j}	|	d|_|�|||||	|j�}
|�|
�qNW5QRX||jk�r"|jd7_ntd|�|_Wntk
�rNt��YnXdS)z�
        Called when my socket is ready for reading.

        This accepts a connection and calls self.protocol() to handle the
        wire-level protocol.
        r1rHrrGN�) rr:r�_loggerrr r%�rangerKr7�	enumerater>r�r�rJrLrMrNrOrPr�r�r=rcr��	transportrtr��maxr�rCZdeferr)rdZ
numAcceptsZbufferingLoggerZacceptedZclientsrWrQrRr�r�rBrrrrrVsX��
�
�zPort.doReadcCs2d|_|��|jr.t|jd|j|�|_|jSdS)a
        Stop accepting connections on this port.

        This will shut down the socket and call self.connectionLost().  It
        returns a deferred which will fire successfully when the port is
        actually closed, or with a failure if an error occurs shutting down.
        TrN)�
disconnectingrpr�rArtrvZdeferred)rdZconnDonerrrr��s
zPort.loseConnectioncCs t�d|j�d|j�d��dS)z.
        Log message for closing port
        �(z Port z Closed)N)rCr9�_typer�ryrrr�_logConnectionLostMsg�szPort._logConnectionLostMsgcCsP|��d|_tj�||�d|_|�d�|`|`z|j
��W5d|_	XdS)z'
        Cleans up the socket.
        NFT)rGr�r<r+rvr�rerKr�rDr�ZdoStopr�rrrrv�s
zPort.connectionLostcCst�|jj�S)z9Returns the name of my class, to prefix log entries with.)rDZqualr�r�ryrrrr��szPort.logPrefixcCst|j�}|jd|��S)zs
        Return an L{IPv4Address} or L{IPv6Address} indicating the listening
        address of this port.
        r�)r�r�r�rrrr��s
zPort.getHost)r*r)N),rrrrfrKr�r�r�rBr�r-r,rFr�r�intrr.r�r�r;r�r�rr?r~r�r0r�r�r�r<r=rrrBrwr?r�r�Z
stopListeningrGrvr�r�rrrrr(�s4
#


-Ar(c@s0eZdZdZejZd	dd�Zdd�Zdd�Z	dS)
�	Connectora6
    A L{Connector} provides of L{twisted.internet.interfaces.IConnector} for
    all POSIX-style reactors.

    @ivar _addressType: the type returned by L{Connector.getDestination}.
        Either L{IPv4Address} or L{IPv6Address}, depending on the type of
        address.
    @type _addressType: C{type}
    Nc
Cs�t|t�rVzt�|d�}Wn:tk
rT}ztj|�d|�d�d��W5d}~XYnX|||_|_t	�
|�rvtj|_
||_tj�||||�dS)N�tcpz (�)r�)�
isinstancer�rK�
getservbynamerbr=�ServiceNameUnknownErrorrRr�r:r�r;r�r�r�r<�
BaseConnectorr~)rdrRr�r��timeoutr�rtrrrrr~�s
*
zConnector.__init__cCst|j|j|j||j�S)z|
        Create a L{Client} bound to this L{Connector}.

        @return: a new L{Client}
        @rtype: L{Client}
        )r�rRr�r�rtryrrr�_makeTransport�szConnector._makeTransportcCs|�d|j|j�S)zQ
        @see: L{twisted.internet.interfaces.IConnector.getDestination}.
        r�)r�rRr�ryrrr�getDestination�szConnector.getDestination)N)
rrrrfr;r�r�r~rQrRrrrrrI�s


	rI)qrfrrKrar3�typingrrrrr�zope.interfacerrr�twisted.internet.interfacesr	r
rrZtwisted.loggerr
rr�twisted.pythonrrZtwisted.python.compatr�twisted.python.runtimerZtwisted.internet._newtlsrrrrrr!r�ImportErrorrr,rr#r0r$r/r%r-r&r1r'r3r(r2r)r.r4r5r6r*r7Ztwisted.python.win32r+r8r9�twisted.internetr:r;r<r=r>r?Ztwisted.internet.errorr@Ztwisted.internet.protocol�twisted.internet.taskrArBrCrDZtwisted.python.utilrE�getattrZ_AI_NUMERICSERVrSrXrZr[rgr}r{r�r��AI_NUMERICHOSTr�r�r�r�r�r�rr�r	rr7r&rr%r+r(rOrIrrrr�<module>s�
$ #

�&
Vo=
=?

'I