HEX
Server: Apache
System: Linux scp1.abinfocom.com 5.4.0-216-generic #236-Ubuntu SMP Fri Apr 11 19:53:21 UTC 2025 x86_64
User: confeduphaar (1010)
PHP: 8.1.33
Disabled: exec,passthru,shell_exec,system
$ pwd: /usr/lib/python3/dist-packages/twisted/internet/__pycache__/
Upload Files
File: //usr/lib/python3/dist-packages/twisted/internet/__pycache__/posixbase.cpython-38.pyc
U

��W[�f�@s�dZddlmZmZddlZddlZddlZddlZddlm	Z	m
Z
ddlmZm
Z
mZddlmZmZddlmZmZddlmZmZmZmZmZmZmZmZmZmZdd	l m!Z!m"Z"m#Z#dd
l$m%Z%m&Z&e�'d�Z(e�'d�Z)zdd
l*m+Z+WnFe,k
�r6dZ+zddlm-Z-Wne,k
�r0dZ-YnXYnXe%dkZ.dZ/e.�rnddlm0Z0m1Z1ddlm2Z2m3Z3dZ/e&�4��r�zddl5Z5dZ/Wne,k
�r�dZ5YnXGdd�de!j6�Z7Gdd�de!j6e8�Z9Gdd�de9�Z:e%dk�r�e:Z;ne7Z;Gdd�de9�Z<Gdd�de8�Z=e	eee�Gdd�dee=e��Z>Gd d!�d!e8�Z?e	e�Gd"d#�d#e?e=��Z@e+dk	�sle-dk	�rve
e>e�e.�r�e
e>ee�e/�r�e
e>e�eAed$d�dk	�r�e
e>e�dgZBdS)%z
Posix reactor base class
�)�division�absolute_importN)�implementer�classImplements)�error�udp�tcp)�ReactorBase�_SignalReactorMixin)�CONNECTION_DONE�CONNECTION_LOST)
�IReactorUNIX�IReactorUNIXDatagram�IReactorTCP�IReactorUDP�IReactorSSL�IReactorSocket�IHalfCloseableDescriptor�IReactorProcess�IReactorMulticast�
IReactorFDSet)�log�failure�util)�platformType�platformzHandler has no fileno methodzFile descriptor lost)�tls)�ssl�posixF)�fdesc�unix)�process�_signalsTc@s4eZdZdZdZdd�Zdd�Zdd�Zd	d
�ZdS)�_SocketWakerz�
    The I{self-pipe trick<http://cr.yp.to/docs/selfpipe.html>}, implemented
    using a pair of sockets rather than pipes (due to the lack of support in
    select() on Windows for pipes), used to wake up the main loop from
    another thread.
    rcCs�||_t�tjtj�}t�tjtj�}|�tjtjd�|�d�|�d�|�	|�
��|��\}}|�d�|�d�||_
||_|j
j|_dS)�Initialize.
        �)z	127.0.0.1rrN)�reactor�socket�AF_INETZSOCK_STREAMZ
setsockoptZIPPROTO_TCPZTCP_NODELAYZbindZlisten�connectZgetsocknameZacceptZsetblocking�r�w�fileno)�selfr&ZserverZclient�readerZ
clientaddr�r/�</usr/lib/python3/dist-packages/twisted/internet/posixbase.py�__init__Es



z_SocketWaker.__init__c
CsPzt�|jjd�Wn6tjk
rJ}z|jdtjkr:�W5d}~XYnXdS)z&Send a byte to my connection.
        �xrN)	r�untilConcludesr+�sendr'r�args�errnoZWSAEWOULDBLOCK�r-�er/r/r0�wakeUpWs
z_SocketWaker.wakeUpcCs,z|j�d�Wntjk
r&YnXdS)z+Read some data from my connection.
        � N)r*Zrecvr'r�r-r/r/r0�doRead`sz_SocketWaker.doReadcCs|j��|j��dS�N)r*�closer+)r-�reasonr/r/r0�connectionLosths
z_SocketWaker.connectionLostN)	�__name__�
__module__�__qualname__�__doc__�disconnectedr1r9r<r@r/r/r/r0r#<s	r#c@s4eZdZdZdZdZdZdd�Zdd�Zdd	�Z	dS)
�_FDWakera�
    The I{self-pipe trick<http://cr.yp.to/docs/selfpipe.html>}, used to wake
    up the main loop from another thread or a signal handler.

    L{_FDWaker} is a base class for waker implementations based on
    writing to a pipe being monitored by the reactor.

    @ivar o: The file descriptor for the end of the pipe which can be
        written to wake up a reactor monitoring this waker.

    @ivar i: The file descriptor which should be monitored in order to
        be awoken by this waker.
    rNcsX|�_t��\�_�_t��j�t��j�t��j�t��j��fdd��_dS)r$cs�jSr=)�ir/r;r/r0�<lambda>��z#_FDWaker.__init__.<locals>.<lambda>N)	r&�os�piperG�orZsetNonBlockingZ_setCloseOnExecr,�r-r&r/r;r0r1�sz_FDWaker.__init__cCst�|��dd��dS)zA
        Read some bytes from the pipe and discard them.
        cSsdSr=r/)�datar/r/r0rH�rIz!_FDWaker.doRead.<locals>.<lambda>N)rZ
readFromFDr,r;r/r/r0r<�sz_FDWaker.doReadc	CsPt|d�sdS|j|jfD](}zt�|�Wqtk
r@YqXq|`|`dS)z$Close both ends of my pipe.
        rLN)�hasattrrGrLrJr>�IOError)r-r?�fdr/r/r0r@�s
z_FDWaker.connectionLost)
rArBrCrDrErGrLr1r<r@r/r/r/r0rFns
rFc@seZdZdZdd�ZdS)�
_UnixWakerz�
    This class provides a simple interface to wake up the event loop.

    This is used by threads or signals to wake up the event loop.
    c
CsV|jdk	rRzt�tj|jd�Wn0tk
rP}z|jtjkr@�W5d}~XYnXdS)z2Write one byte to the pipe, and flush it.
        Nr2)rLrr3rJ�write�OSErrorr6ZEAGAINr7r/r/r0r9�s
z_UnixWaker.wakeUpN)rArBrCrDr9r/r/r/r0rR�srRc@s0eZdZdZdd�Zdd�Zdd�Zdd	�Zd
S)�
_SIGCHLDWakerz}
    L{_SIGCHLDWaker} can wake up a reactor whenever C{SIGCHLD} is
    received.

    @see: L{twisted.internet._signals}
    cCst�||�dSr=)rFr1rMr/r/r0r1�sz_SIGCHLDWaker.__init__cCst�|j�dS)zJ
        Install the handler necessary to make this waker active.
        N)r"�installHandlerrLr;r/r/r0�install�sz_SIGCHLDWaker.installcCst�d�dS)zC
        Remove the handler which makes this waker active.
        ���N)r"rVr;r/r/r0�	uninstall�sz_SIGCHLDWaker.uninstallcCst�|�t��dS)a
        Having woken up the reactor in response to receipt of
        C{SIGCHLD}, reap the process which exited.

        This is called whenever the reactor notices the waker pipe is
        writeable, which happens soon after any call to the C{wakeUp}
        method.
        N)rFr<r!�reapAllProcessesr;r/r/r0r<�s	
z_SIGCHLDWaker.doReadN)rArBrCrDr1rWrYr<r/r/r/r0rU�s
rUc@s<eZdZdZeje�e���eje�e���ifdd�Z	dS)�_DisconnectSelectableMixinz>
    Mixin providing the C{_disconnectSelectable} method.
    cCst|�|�|�|j�}|rV|r@|jtjkr@t�|�r@|�|�qp|�|�|�	|�n|�|�|�	t
�|��dS)z�
        Utility function for disconnecting a selectable.

        Supports half-close notification, isRead should be boolean indicating
        whether error resulted from doRead().
        N)�removeReader�get�	__class__r�ConnectionDonerZ
providedByZreadConnectionLost�removeWriterr@r�Failure)r-�
selectable�whyZisReadZfaildict�fr/r/r0�_disconnectSelectable�s

�

z0_DisconnectSelectableMixin._disconnectSelectableN)
rArBrCrDrr_rraZConnectionLostrer/r/r/r0r[�s�r[c@s�eZdZdZeZdd�ZdZdd�Zdd�Z	d	idddd
dfdd�Z
d/dd�Zd0dd�Zd1dd�Z
d2dd�Zd3dd�Zd4dd�Zer�ejejejfZnejejfZdd �Zd!d"�Zd5d#d$�Zd6d%d&�Zd7d'd(�Zd8d)d*�Zd9d+d,�Zd-d.�ZdS):�PosixReactorBasez�
    A basis for reactors that use file descriptors.

    @ivar _childWaker: L{None} or a reference to the L{_SIGCHLDWaker}
        which is used to properly notice child process termination.
    cCs0|js,|�|�|_|j�|j�|�|j�dS)z�
        Install a `waker' to allow threads and signals to wake up the IO thread.

        We use the self-pipe trick (http://cr.yp.to/docs/selfpipe.html) to wake
        the reactor. On Windows we use a pair of sockets.
        N)Zwaker�
_wakerFactory�_internalReaders�add�	addReaderr;r/r/r0�installWakerszPosixReactorBase.installWakerNcCsVt�|�tdkrRtrR|js@t|�|_|j�|j�|�|j�|j�	�t
��dS)z�
        Extend the basic signal handling logic to also support
        handling SIGCHLD to know when to try to reap child processes.
        rN)r
�_handleSignalsr�processEnabled�_childWakerrUrhrirjrWr!rZr;r/r/r0rl"s


zPosixReactorBase._handleSignalscCs|jr|j��dS)a�
        If a child waker was created and installed, uninstall it now.

        Since this disables reactor functionality and is only called
        when the reactor is stopping, it doesn't provide any directly
        useful functionality, but the cleanup of reactor-related
        process-global state that it does helps in unit tests
        involving multiple reactors and is generally just a nice
        thing.
        N)rnrYr;r/r/r0�_uninstallHandler5sz"PosixReactorBase._uninstallHandlerr/rc
Cs�|�||�\}}tdkrb|rF|	dk	r,td��t�|||||||||�	St�|||||||||	�	Snttdkr�|dk	rztd��|dk	r�td��|r�td��|	r�td��tr�dd	lm}
|
||||||�Std
��ntd��dS)Nrz1Using childFDs is not supported with usePTY=True.Zwin32z,Setting UID is unsupported on this platform.z,Setting GID is unsupported on this platform.z1The usePTY parameter is not supported on Windows.z1Customizing childFDs is not supported on Windows.r)�Processz:spawnProcess not available since pywin32 is not installed.z0spawnProcess only available on Windows or POSIX.)	Z_checkProcessArgsr�
ValueErrorr!Z
PTYProcessrp�win32processZtwisted.internet._dumbwin32proc�NotImplementedError)r-ZprocessProtocol�
executabler5�env�pathZuid�gidZusePTYZchildFDsrpr/r/r0�spawnProcessHsF����zPosixReactorBase.spawnProcess�r:cCst�|||||�}|��|S)z�Connects a given L{DatagramProtocol} to the given numeric UDP port.

        @returns: object conforming to L{IListeningPort}.
        )r�Port�startListening)r-�port�protocol�	interface�
maxPacketSize�pr/r/r0�	listenUDPkszPosixReactorBase.listenUDPFcCs t�||||||�}|��|S)z�Connects a given DatagramProtocol to the given numeric UDP port.

        EXPERIMENTAL.

        @returns: object conforming to IListeningPort.
        )rZ
MulticastPortr{)r-r|r}r~rZlistenMultipler�r/r/r0�listenMulticastvsz PosixReactorBase.listenMulticast�cCs*tstd��t�|||||�}|��|S�N�UNIX support is not present)�unixEnabled�AssertionErrorr �	Connectorr))r-�address�factory�timeoutZcheckPID�cr/r/r0�connectUNIX�szPosixReactorBase.connectUNIX�2�cCs,tstd��t�||||||�}|��|Sr�)r�r�r rzr{)r-r�r��backlog�modeZwantPIDr�r/r/r0�
listenUNIX�szPosixReactorBase.listenUNIXcCs*tstd��t�|||||�}|��|S)z�
        Connects a given L{DatagramProtocol} to the given path.

        EXPERIMENTAL.

        @returns: object conforming to L{IListeningPort}.
        r�)r�r�r ZDatagramPortr{)r-r�r}rr�r�r/r/r0�listenUNIXDatagram�s	z#PosixReactorBase.listenUNIXDatagramcCs,tstd��t�||||||�}|��|S)zd
        Connects a L{ConnectedDatagramProtocol} instance to a path.

        EXPERIMENTAL.
        r�)r�r�r ZConnectedDatagramPortr{)r-r�r}rr��bindAddressr�r/r/r0�connectUNIXDatagram�sz$PosixReactorBase.connectUNIXDatagramcCsR||jkrt�|��tr4|tjkr4tj�|||�}nt	j�||||�}|�
�|S)a0
        Create a new L{IListeningPort} from an already-initialized socket.

        This just dispatches to a suitable port implementation (eg from
        L{IReactorTCP}, etc) based on the specified C{addressFamily}.

        @see: L{twisted.internet.interfaces.IReactorSocket.adoptStreamPort}
        )�_supportedAddressFamiliesr�UnsupportedAddressFamilyr�r'�AF_UNIXr rz�_fromListeningDescriptorrr{)r-�fileDescriptor�
addressFamilyr�r�r/r/r0�adoptStreamPort�s 	

��z PosixReactorBase.adoptStreamPortcCsH||jkrt�|��tr2|tjkr2tj�|||�St	j�||||�SdS)zg
        @see:
            L{twisted.internet.interfaces.IReactorSocket.adoptStreamConnection}
        N)
r�rr�r�r'r�r ZServerZ_fromConnectedSocketr)r-r�r�r�r/r/r0�adoptStreamConnection�s

��z&PosixReactorBase.adoptStreamConnectioncCs<|tjtjfkrt�|��tjj|||||d�}|��|S)N)r)	r'r(�AF_INET6rr�rrzr�r{)r-r�r�r}rr�r/r/r0�adoptDatagramPort�s
�z"PosixReactorBase.adoptDatagramPortcCst�|||||�}|��|Sr=)rrzr{)r-r|r�r�r~r�r/r/r0�	listenTCP�szPosixReactorBase.listenTCPcCs t�||||||�}|��|Sr=)rr�r))r-�hostr|r�r�r�r�r/r/r0�
connectTCP�szPosixReactorBase.connectTCPc		Csbtdk	r(t�|d|�}|�|||||�Stdk	rRt�|||||||�}|��|Sds^td��dS)NTF�SSL support is not present)r�TLSMemoryBIOFactoryr�rr�r)r�)	r-r�r|r��contextFactoryr�r��
tlsFactoryr�r/r/r0�
connectSSL�s �zPosixReactorBase.connectSSLcCshtdk	r0t�|d|�}|�||||�}d|_|Stdk	rXt�||||||�}|��|Sdsdtd��dS)NFZTLSr�)rr�r�Z_typerrzr{r�)r-r|r�r�r�r~r�r�r/r/r0�	listenSSLs"�zPosixReactorBase.listenSSLcCsJt|�|j}|D]}|�|�qt|�}|D]}|�|�q.t||B�S)ag
        Remove all readers and writers, and list of removed L{IReadDescriptor}s
        and L{IWriteDescriptor}s.

        Meant for calling from subclasses, to implement removeAll, like::

          def removeAll(self):
              return self._removeAll(self._reads, self._writes)

        where C{self._reads} and C{self._writes} are iterables.
        )�setrhr\r`�list)r-ZreadersZwritersZremovedReadersr.ZremovedWriters�writerr/r/r0�
_removeAllszPosixReactorBase._removeAll)ryr:)ryr:F)r�r)r�r�r)r:r�)r:r�N)r:)r�ry)r�N)r�N)r�ry)rArBrCrD�_Wakerrgrkrnrlrorxr�r�r�r�r�r�r�r'r(r�r�r�r�r�r�r�r�r�r�r�r/r/r/r0rfsT	
�
#



	�
�
���




rfc@seZdZdZdd�ZdS)�_PollLikeMixina�
    Mixin for poll-like reactors.

    Subclasses must define the following attributes::

      - _POLL_DISCONNECTED - Bitmask for events indicating a connection was
        lost.
      - _POLL_IN - Bitmask for events indicating there is input to read.
      - _POLL_OUT - Bitmask for events indicating output can be written.

    Must be mixed in to a subclass of PosixReactorBase (for
    _disconnectSelectable).
    cCs�d}d}||j@r6||j@s6||jkr0d}t}q�t}nhzF|��dkrJt}n0||j@r`|��}d}|sz||j@rz|�	�}d}Wn t
��d}t�
�YnX|r�|�|||�dS)zg
        fd is available for read or write, do the work and raise errors if
        necessary.
        NFTrXr%)�_POLL_DISCONNECTED�_POLL_INZ_readsrrr,�_NO_FILEDESCr<�	_POLL_OUTZdoWrite�sys�exc_infor�errre)r-rbrQZeventrcZinReadr/r/r0�_doReadOrWrite<s*

z_PollLikeMixin._doReadOrWriteN)rArBrCrDr�r/r/r/r0r�-sr�c@s|eZdZdZdZdZdZdd�Zdd�Zd	d
�Z	dd�Z
d
d�Zdd�Zdd�Z
dd�Zdd�Zdd�Zdd�Zdd�ZdS)�_ContinuousPollinga�
    Schedule reads and writes based on the passage of time, rather than
    notification.

    This is useful for supporting polling filesystem files, which C{epoll(7)}
    does not support.

    The implementation uses L{_PollLikeMixin}, which is a bit hacky, but
    re-implementing and testing the relevant code yet again is unappealing.

    @ivar _reactor: The L{EPollReactor} that is using this instance.

    @ivar _loop: A C{LoopingCall} that drives the polling, or L{None}.

    @ivar _readers: A C{set} of C{FileDescriptor} objects that should be read
        from.

    @ivar _writers: A C{set} of C{FileDescriptor} objects that should be
        written to.
    r%��cCs ||_d|_t�|_t�|_dSr=)�_reactor�_loopr��_readers�_writersrMr/r/r0r1�sz_ContinuousPolling.__init__cCsh|js|jrN|jdkrdddlm}m}||j�|_|j|j_|jj	|dd�n|jrd|j�
�d|_dS)zh
        Start or stop a C{LoopingCall} based on whether there are readers and
        writers.
        Nr)�LoopingCall�_EPSILONF)Znow)r�r�r�Ztwisted.internet.taskr�r��iterater�Zclock�start�stop)r-r�r�r/r/r0�
_checkLoop�s


z_ContinuousPolling._checkLoopcCsDt|j�D]}|�|||j�q
t|j�D]}|�|||j�q*dS)zX
        Call C{doRead} and C{doWrite} on all readers and writers respectively.
        N)r�r�r�r�r�r�)r-r.r�r/r/r0r��sz_ContinuousPolling.iteratecCs|j�|�|��dS)zU
        Add a C{FileDescriptor} for notification of data available to read.
        N)r�rir��r-r.r/r/r0rj�sz_ContinuousPolling.addReadercCs|j�|�|��dS)zV
        Add a C{FileDescriptor} for notification of data available to write.
        N)r�rir��r-r�r/r/r0�	addWriter�sz_ContinuousPolling.addWritercCs4z|j�|�Wntk
r&YdSX|��dS)zY
        Remove a C{FileDescriptor} from notification of data available to read.
        N)r��remove�KeyErrorr�r�r/r/r0r\�s
z_ContinuousPolling.removeReadercCs4z|j�|�Wntk
r&YdSX|��dS)zb
        Remove a C{FileDescriptor} from notification of data available to
        write.
        N)r�r�r�r�r�r/r/r0r`�s
z_ContinuousPolling.removeWritercCs(t|j|jB�}|j��|j��|S)z1
        Remove all readers and writers.
        )r�r�r��clear)r-�resultr/r/r0�	removeAll�s

z_ContinuousPolling.removeAllcCs
t|j�S)z/
        Return a list of the readers.
        )r�r�r;r/r/r0�
getReaders�sz_ContinuousPolling.getReaderscCs
t|j�S)z/
        Return a list of the writers.
        )r�r�r;r/r/r0�
getWriters�sz_ContinuousPolling.getWriterscCs
||jkS)aj
        Checks if the file descriptor is currently being observed for read
        readiness.

        @param fd: The file descriptor being checked.
        @type fd: L{twisted.internet.abstract.FileDescriptor}
        @return: C{True} if the file descriptor is being observed for read
            readiness, C{False} otherwise.
        @rtype: C{bool}
        )r��r-rQr/r/r0�	isReading�sz_ContinuousPolling.isReadingcCs
||jkS)al
        Checks if the file descriptor is currently being observed for write
        readiness.

        @param fd: The file descriptor being checked.
        @type fd: L{twisted.internet.abstract.FileDescriptor}
        @return: C{True} if the file descriptor is being observed for write
            readiness, C{False} otherwise.
        @rtype: C{bool}
        )r�r�r/r/r0�	isWritingsz_ContinuousPolling.isWritingN)rArBrCrDr�r�r�r1r�r�rjr�r\r`r�r�r�r�r�r/r/r/r0r�ws 
r�Zfromfd)CrDZ
__future__rrr'r6rJr�Zzope.interfacerrZtwisted.internetrrrZtwisted.internet.baser	r
Ztwisted.internet.mainrrZtwisted.internet.interfacesr
rrrrrrrrrZtwisted.pythonrrrZtwisted.python.runtimerrZConnectionFdescWentAwayZ
_NO_FILENOr�Ztwisted.protocolsr�ImportErrorrr�rmrr r!r"Z	isWindowsrrZLoggerr#�objectrFrRr�rUr[rfr�r��getattr�__all__r/r/r/r0�<module>sz0



24
(
�(J



@ Telegram