/usr/lib/python3/dist-packages/twisted/internet/__pycache__
Edit: /usr/lib/python3/dist-packages/twisted/internet/__pycache__/unix.cpython-310.pyc (19531B)
o
bW @ s
d Z ddlZddlZddlZddlZddlmZmZmZm Z m
Z
m Z ddl m
Z
mZ ddlmZmZmZ ddlmZmZmZmZmZmZmZmZ ddl m Z ddl m Z m Z m!Z!m"Z" dd l#m$Z$ dd
l%m&Z& dd l'm(Z( zdd l m)Z* W n e+y dZ)Y nw e*Z)e,ed
se+ddd Z-G dd dZ.G dd dZ/e)re.Z.ne/Z.eej0G dd de.ej1Z1dd Z2G dd dZ3G dd d e3ej4Z4eej0G d d d e.ej5Z6G d d d ej7Z8eej9G d!d" d"e3ej4Z:eej;geej<R G d#d$ d$e:Z=dS )%z
UNIX socket support for Twisted.
End users shouldn't use this module directly - use the reactor APIs instead.
Maintainer: Itamar Shtull-Trauring
N)EAGAIN ECONNREFUSEDEINTREMSGSIZEENOBUFS EWOULDBLOCK)OptionalType)
implementedBy implementerimplementer_only)addressbaseerror
interfacesmainprotocoltcpudp)FileDescriptor)failurelockfilelogreflect)
lazyByteSlice)_coerceToFilesystemEncoding)untilConcludes)sendmsgAF_UNIXz+UNIX sockets not supported on this platformc C s t d| }tjtj|fgS )zh
Pack an integer into an ancillary data structure suitable for use with
L{sendmsg.sendmsg}.
i)structpacksocket
SOL_SOCKETr
SCM_RIGHTS)fdpacked r' 7/usr/lib/python3/dist-packages/twisted/internet/unix.py_ancillaryDescriptor) s r) c @ sZ e Zd ZU dZdZeee ed< dZ dd Z
dd Z d d
Z d d Z
d
d Zdd ZdS )
_SendmsgMixina
Mixin for stream-oriented UNIX transports which uses sendmsg and recvmsg to
offer additional functionality, such as copying file descriptors into other
processes.
@ivar _writeSomeDataBase: The class which provides the basic implementation
of C{writeSomeData}. Ultimately this should be a subclass of
L{twisted.internet.abstract.FileDescriptor}. Subclasses which mix in
L{_SendmsgMixin} must define this.
@ivar _sendmsgQueue: A C{list} of C{int} holding file descriptors which are
currently buffered before being sent.
@ivar _fileDescriptorBufferSize: An C{int} giving the maximum number of file
descriptors to accept and queue for sending before pausing the
registered producer, if there is one.
N_writeSomeDataBase@ c C s
g | _ d S N)
_sendmsgQueueselfr' r' r( __init__H
z_SendmsgMixin.__init__c C s t | j| jkp
| j| S )a
Determine whether the user-space send buffer for this transport is full
or not.
This extends the base determination by adding consideration of how many
file descriptors need to be sent using L{sendmsg.sendmsg}. When there
are more than C{self._fileDescriptorBufferSize}, the buffer is
considered full.
@return: C{True} if it is full, C{False} otherwise.
)lenr. _fileDescriptorBufferSizer+ _isSendBufferFullr/ r' r' r( r5 K s z _SendmsgMixin._isSendBufferFullc C s | j | | | dS )zY
Queue the given file descriptor to be sent and start trying to send it.
N)r. append_maybePauseProducer startWriting)r0 filenor' r' r( sendFileDescriptord s z _SendmsgMixin.sendFileDescriptorc
C s6 t | jt |kr
t S d}zg|t | jk ro| j| }zttj| j|||d t| W n4 tyc } z(|j d t
t fv rO|W Y d}~W | jd|= S t j
W Y d}~W | jd|= S d}~ww |d7 }|t | jk sW | jd|= n| jd|= w t||}| j| |}z|| W S ty | Y S w )zg
Send as much of C{data} as possible. Also send any pending file
descriptors.
r N)r3 r. r FileDescriptorOverrunr r r" r) OSErrorargsr r r CONNECTION_LOSTr r+
writeSomeData TypeError)r0 dataindexr% se limitedDataresultr' r' r( r@ l s@
z_SendmsgMixin.writeSomeDatac
C s zt tj| j| j\}}}W n# ty1 } z|jd tkr$W Y d}~dS tj W Y d}~S d}~ww |D ](\}}}|tj
krI|tj krI| | q4t
jd| | | | j||d q4| |S )a
Calls {IProtocol.dataReceived} with all available data and
L{IFileDescriptorReceiver.fileDescriptorReceived} once for each
received file descriptor in ancillary data.
This reads up to C{self.bufferSize} bytes of data from its socket, then
dispatches the data to protocol callbacks to be handled. If the
connection is not lost through an error in the underlying recvmsg(),
this function will return the result of the dataReceived call.
r Nz%(protocolName)s (on %(hostAddress)r) received unsupported ancillary data (level=%(cmsgLevel)r, type=%(cmsgType)r) from %(peerAddress)r.)format hostAddress peerAddress protocolName cmsgLevelcmsgType)r r recvmsgr"
bufferSizer= r> r r r? r# r$ %_ancillaryLevelSOLSOCKETTypeSCMRIGHTSr msggetHostgetPeer
_getLogPrefixr
_dataReceived)r0 rB ancillaryflagsrD rK rL cmsgDatar' r' r( doRead s,
z_SendmsgMixin.doReadc C s~ t |d }td| |}tj| jr"|D ]}| j| qdS tj d|
| | | jd |D ]}t
| q5dS )a
Processes ancillary data with level SOL_SOCKET and type SCM_RIGHTS,
indicating that the ancillary data payload holds file descriptors.
Calls L{IFileDescriptorReceiver.fileDescriptorReceived} once for each
received file descriptor or logs a message if the protocol does not
implement L{IFileDescriptorReceiver}.
@param cmsgData: Ancillary data payload.
@type cmsgData: L{bytes}
r z%(protocolName)s (on %(hostAddress)r) does not provide IFileDescriptorReceiver; closing file descriptor received (from %(peerAddress)r).)rG rH rI rJ N)r3 r unpackr IFileDescriptorReceiver
providedByr fileDescriptorReceivedr rP rQ rR rS osclose)r0 rW fdCountfdsr% r' r' r( rO s
z3_SendmsgMixin._ancillaryLevelSOLSOCKETTypeSCMRIGHTS)__name__
__module__ __qualname____doc__r+ r r r __annotations__r4 r1 r5 r: r@ rX rO r' r' r' r( r* 2 s
. )r* c @ s e Zd ZdZdS )_UnsupportedSendmsgMixinz
Behaviorless placeholder used when C{twisted.python.sendmsg} is not
available, preventing L{IUNIXTransport} from being supported.
N)rb rc rd re r' r' r' r( rg s rg c @ s6 e Zd ZejZdd Zedd Zdd Z dd Z
d S )
Serverc C s* t | tj| |||d f||| d S r- )r* r1 r rh )r0 sockr clientserver sessionnoreactorr' r' r( r1 s
zServer.__init__c C s t |t jt j}t| }||}|du r | dS d}| ||| d||}d
|j j j
|j| |_d
|j j 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.
@return: A new instance of C{cls} wrapping the socket given by
C{fileDescriptor}.
Nr z<{} #{} on {}>z{},{},{})r" fromfdr SOCK_STREAMr
UNIXAddress getsockname
buildProtocolr_ getpeernamerG r __class__rb rl repstrlogstrmakeConnection) clsfileDescriptorfactoryrm skt protocolAddrprotorl r0 r' r' r( _fromConnectedSocket s(
zServer._fromConnectedSocketc C t | j S r- r
rp r" rq r/ r' r' r( rQ $ zServer.getHostc C s t | jpd S r- )r
rp hostnamer/ r' r' r( rR ' r zServer.getPeerN) rb rc rd r rh r+ r1 classmethodr~ rQ rR r' r' r' r( rh s
' rh c C s | dd dvS )a
Determine whether the given unix socket path is in a filesystem namespace.
While most PF_UNIX sockets are entries in the filesystem, Linux 2.2 and
above support PF_UNIX sockets in an "abstract namespace" that does not
correspond to any path. This function returns C{True} if the given socket
path is stored in the filesystem and C{False} if the path is in this
abstract namespace.
Nr; ) r' )pathr' r' r( _inFilesystemNamespace+ s
r c @ s e Zd Zdd ZdS ) _UNIXPortc C r )zV
Returns a UNIXAddress.
This indicates the server's address.
r r/ r' r' r( rQ 9 s z_UNIXPort.getHostN)rb rc rd rQ r' r' r' r( r 8 s r c @ sf e Zd ZejZejZeZ dZ
dddZ e dd Z
d efd
d Zd d
Zdd Zdd Zdd ZdS )PortN2 r c C s4 t jj| | |j|||d || _|| _d | _d S )Nrm )r r r1
_buildAddrnamemodewantPID_preexistingSocket)r0 fileNamerz backlogr rm r r' r' r( r1 I s
z
Port.__init__c C s. t || j| j}| | ||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.
@return: A new instance of C{cls} wrapping the socket given by C{fd}.
r )r" rn
addressFamily
socketTyperq r )rx rm r% rz portr0 r' r' r( _fromListeningDescriptorS s z Port._fromListeningDescriptorreturnc C s8 t | jj}t| drd|td| jS d| dS )Nr" z <{} on {!r}> < (not listening)>)r qualrz rt hasattrrG r r )r0 factoryNamer' r' r( __repr__f s
z
Port.__repr__c C s
t |S r- r
rp )r0 r r' r' r( r p r2 zPort._buildAddrc
C sP t j td| | jtd| jf | j rOt
| jd | _ | j
s/td| jd| j jsOztt| jjrDt| j W n tyN Y nw | j z| jdura| j}d| _n
| }|| j W n ty } ztd| j|d}~ww t | jrt | j| j | | j d| _!|| _"| j"j#| _#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.
z%s starting on %rr .lockNzCannot acquire lockTd )&r _reservedFDreserver rP rS rz r r r r FilesystemLocklockFilelockr CannotListenErrorcleanstatS_ISSOCKr^ st_moderemove
BaseExceptiondoStartr createInternetSocketbindr= r chmodr listenr connectedr" r9
numberAccepts startReadingr0 r{ ler' r' r( startListenings sP
zPort.startListeningc C s t dtd| j dS )z0
Log message for closing socket
z(UNIX Port %s Closed)r N)r rP r r r/ r' r' r( _logConnectionLostMsg s zPort._logConnectionLostMsgc C s< t | jr t| j | jd ur| j tj| | d S r- ) r r r^ unlinkr unlockr r connectionLostr0 reasonr' r' r( r s
zPort.connectionLost)r r Nr )rb rc rd r" r r ro r rh transportr r1 r r strr r r r r r' r' r' r( r B s
6 r c @ s< e Zd ZdZejZejZe j
Z d
ddZ dd Z
dd ZdS ) ClientzA client for Unix sockets.Nr c C sj t | t|j}|| _| | _| _|r(t |d s(|
d d t || |
| j
| d | d S )Nr )r* r1 r
rp r connector realAddressaddrr isLocked _finishInitr BadFileError doConnectr )r0 filenamer rm checkPIDr' r' r( r1 s
zClient.__init__c C t | jS r- )r
rp r r/ r' r' r( rR zClient.getPeerc C s
t d S r- r r/ r' r' r( rQ r2 zClient.getHost)Nr )rb rc rd re r" r r ro r r
BaseClientr+ r1 rR rQ r' r' r' r( r s
r c @ s$ e Zd Zdd Zdd Zdd ZdS ) Connectorc C s" t j| ||| || _|| _d S r- )r
BaseConnectorr1 r
r )r0 r
rz timeoutrm r r' r' r( r1 s
zConnector.__init__c C s t | j| | j| jS r- )r r
rm r r/ r' r' r( _makeTransport s zConnector._makeTransportc C s t | j S r- r r/ r' r' r( getDestination r zConnector.getDestinationN)rb rc rd r1 r r r' r' r' r( r s r c @ sP e Zd ZdZejZdddZdefdd Z d
d Z
d d
Z dddZ dd Z
dS ) DatagramPortz4
Datagram UNIX port, listening for packets.
r Nc C s t jj| ||||d || _dS )z%Initialize with address to listen on.)
maxPacketSizerm N)r r r1 r )r0 r r} r r rm r' r' r( r1 s
zDatagramPort.__init__r c C s8 t | jj}t| drd| d| jdS d| dS )Nr" r z on >r )r r r rt r r )r0 rJ r' r' r( r s
zDatagramPort.__repr__c
C s t | jj dt| j z| }| jr || j W n ty2 } zt
d | j|d }~ww | jrCt | jrCt
| j| j d| _|| _| jj| _d S )Nz
starting on r; )r rP r rt reprr r r r= r r r r^ r r r r" r9 r r' r' r( _bindSocket s zDatagramPort._bindSocketc
C s z| j ||W S ty? } z+|jd }|tkr%| ||W Y d}~S |tkr.td|t kr3n W Y d}~dS d}~ww )zWrite a datagram.r Nmessage too long)
r" sendtor= r> r writer r MessageLengthErrorr )r0 datagramr
rD nor' r' r( r s
zDatagramPort.writec C sp t dt| j tj| | t| dr| j d| _
| j | ` | `
t| dr6| jd | `dS dS )zCleans up my socket.z(Port %s Closed)r r dN)r rP r r r BasePortr r r doStopr r" r_ r9 r callbackr r' r' r( r s
zDatagramPort.connectionLostc C s t | jjd | _d S )Nz (UDP))r r r rt rv r/ r' r' r( setLogStr. s zDatagramPort.setLogStr)r r Nr- )rb rc rd re r" r r r1 r r r r r r r' r' r' r( r s
r c @ sJ e Zd ZdZ dddZdd Zd d
Zd d Zd
d Zdd Z dS )ConnectedDatagramPortz+
A connected datagram UNIX socket.
r r Nc C s. t |tjsJ t| ||||| || _d S r- )
isinstancer ConnectedDatagramProtocolr r1
remoteaddr)r0 r r} r r bindAddressrm r' r' r( r1 : s
z ConnectedDatagramPort.__init__c C sH z| | j| j | W d S ty# | t Y d S w r- ) r r" connectr _connectToProtocolr connectionFailedr Failurer/ r' r' r( r G s z$ConnectedDatagramPort.startListeningc C s | | j| | `dS )z
Called when a connection fails. Stop listening on the socket.
@type reason: L{Failure}
@param reason: Why the connection failed.
N)
stopListeningr r r r' r' r( r O s z&ConnectedDatagramPort.connectionFailedc
C s d}|| j k rbz| j| j\}}|t|7 }| j| W n< tyN } z$|jd }|t t
t fv r9W Y d}~dS |t krC| j
n W Y d}~nd}~w tyZ t Y nw || j k sdS dS )z=
Called when my socket is ready for reading.
r N)
maxThroughputr" recvfromr r3 r datagramReceivedr= r> r r r r connectionRefusedr r deferr)r0 readrB r rD r r' r' r( rX Z s&
z ConnectedDatagramPort.doReadc
C s z| j |W S tyN } z;|jd }|tkr#| |W Y d}~S |tkr,td|t kr6| j
n|t kr;n W Y d}~dS W Y d}~dS d}~ww )z#
Write a datagram.
r Nr )
r" sendr= r> r r r r r r r r r )r0 rB rD r r' r' r( r o s"
zConnectedDatagramPort.writec C r r- )r
rp r r/ r' r' r( rR r z ConnectedDatagramPort.getPeer)r r NN)
rb rc rd re r1 r r rX r rR r' r' r' r( r 2 s
r )>re r^ r" r r errnor r r r r r typingr r zope.interfacer
r r twisted.internetr
r r r r r r r twisted.internet.abstractr twisted.pythonr r r r twisted.python.compatr twisted.python.filepathr twisted.python.utilr r _sendmsg ImportErrorr r) r* rg IUNIXTransportrh r r r r r r r IUNIXDatagramTransportr IUNIXDatagramConnectedTransportr r r' r' r' r(
sZ (
39
}
L