hi\RSrSSKrSSKrSSKrSSKrSSKJrJrJrJ r J r J r SSK J r Jr SSKJrJrJr SSKJrJrJrJrJrJrJrJr SSKJr SSKJrJ r J!r!J"r" SS K#J$r$ SS K%J&r& SS K'J(r( SS KJ)r* \*r)\,"\S 5(d\+"S5eSr-"SS5r."SS5r/\)(a\.r.O\/r.\"\R`5"SS\.\Rb55r1Sr2"SS5r3"SS\3\Rh5r4\"\R`5"SS\.\Rj55r6"SS\Rn5r8\"\Rr5"SS \3\Rh55r:\"\Rv/\"\Rx5Q76"S!S"\:55r=g!\+a Sr)GN/f=f)#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 platformct[R"SU5n[R[R U4/$)z\ Pack an integer into an ancillary data structure suitable for use with L{sendmsg.sendmsg}. i)structpacksocket SOL_SOCKETr SCM_RIGHTS)fdpackeds \/root/1688_scrapy/alibaba-scraper/venv/lib/python3.13/site-packages/twisted/internet/unix.py_ancillaryDescriptorr*)s0 [[b !F    2 2F ; <<c\\rSrSr%SrSr\\\\ S'Sr Sr Sr Sr S rS rS rS rg) _SendmsgMixin2a 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/UlgN _sendmsgQueueselfs r)__init___SendmsgMixin.__init__Hs r+c[UR5UR:=(d URR U5$)af 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. )lenr4_fileDescriptorBufferSizer/_isSendBufferFullr5s r)r<_SendmsgMixin._isSendBufferFullKsD&     * *+ .2.E.E.W.W /  r+czURRU5 UR5 UR5 g)zI Queue the given file descriptor to be sent and start trying to send it. N)r4append_maybePauseProducer startWriting)r6filenos r)sendFileDescriptor _SendmsgMixin.sendFileDescriptords0 !!&)   " r+c[UR5[U5:a[R"5$SnU[UR5:adURUn[ [ R UR XUS-[U55 US- nU[UR5:aMdURSU2 [X5nURR!X5nX&-$![a\nURS[[4;aUsSnAURSU2 $[RsSnAURSU2 $SnAff=f!URSU2 f=f!["a Us$f=f)zO Send as much of C{data} as possible. Also send any pending file descriptors. rN)r:r4rFileDescriptorOverrunrrr$r*OSErrorargsrrrCONNECTION_LOSTrr/ writeSomeData TypeError)r6dataindexr'se limitedDataresults r)rK_SendmsgMixin.writeSomeDatalsw t!! "SY ...0 0  +#d0011''. " UQY/,R0 QJE#d0011"""6E6*$D0 ((66tI > !4wwqzk7%;;$ ""6E6* $333""6E6*4""6E6* M s_(E$4C2E.E/2 E<EEE/E>E?EEEE,/ E>=E>c :[[RURUR5upnUHupVnU[R:Xa'U[R:XaURU5 MA[R"SUR5UR!5UR#UR$5UUS9 M UR'U5$![ a6nUR S[:XaSnAg[RsSnA$SnAff=f)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. rNz%(protocolName)s (on %(hostAddress)r) received unsupported ancillary data (level=%(cmsgLevel)r, type=%(cmsgType)r) from %(peerAddress)r.)format hostAddress peerAddress protocolName cmsgLevelcmsgType)rrrecvmsgr$ bufferSizerHrIrrrJr%r&%_ancillaryLevelSOLSOCKETTypeSCMRIGHTSrmsggetHostgetPeer _getLogPrefixr _dataReceived)r6rM ancillaryflagsrOrXrYcmsgDatas r)doRead_SendmsgMixin.doReads ,%3doo& "DU.7 )IF---(g>P>P2P::8D0 !%  $ !%!3!3DMM!B'%  .7$!!$''1 ,wwqz[(+++  ,s#2C D$DDDDc[U5S-n[R"SU-U5n[RR UR 5(a%UHnUR RU5 M g[R"SUR5UR5URUR 5S9 UHn[R"U5 M g)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).)rTrUrVrWN)r:r"unpackrIFileDescriptorReceiver providedByrfileDescriptorReceivedrr]r^r_r`osclose)r6rdfdCountfdsr's r)r\3_SendmsgMixin._ancillaryLevelSOLSOCKETTypeSCMRIGHTSsh-1$mmC'M84  - - 8 8 G G 44R8 GGB!LLN LLN!// >  r+r3)__name__ __module__ __qualname____firstlineno____doc__r/r r r__annotations__r;r7r<rCrKrer\__static_attributes__r+r)r-r-2sD$:>n!56= "  2,\'(Rr+r-c\rSrSrSrSrg)_UnsupportedSendmsgMixinz Behaviorless placeholder used when C{twisted.python.sendmsg} is not available, preventing L{IUNIXTransport} from being supported. ryN)rrrsrtrurvrxryr+r)r{r{sr+r{cZ\rSrSr\R rSr\S5r Sr Sr Sr Sr Srg ) Serverc v[RU5 [RRXX#S4XEU5 gr2)r-r7rr~)r6sockrclientserver sessionnoreactors r)r7Server.__init__s/t$  4.&W r+c[R"U[R[R5n[R "UR 55nURU5nUcUR5 gSnU"XFUR5SXs5nSRURRRURUR 55UlSRURRRURUR 55UlUR#U5 U$)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}. Nrz<{} #{} on {}>z{},{},{})r$fromfdr SOCK_STREAMr UNIXAddress getsockname buildProtocolrn getpeernamerTr __class__rrrrepstrlogstrmakeConnection) clsfileDescriptorfactoryrskt protocolAddrprotorr6s r)_fromConnectedSocketServer._fromConnectedSockets mmNFNNF:  r+r~cUSSS;$)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. NrF)ry)paths r)_inFilesystemNamespacer9s 8= ((r+c\rSrSrSrSrg) _UNIXPortiFc^[R"URR55$)z> Returns a UNIXAddress. This indicates the server's address. rr5s r)r^_UNIXPort.getHostGs" ""4;;#:#:#<==r+ryN)rrrsrtrur^rxryr+r)rrFs>r+rc\rSrSr\R r\Rr\ r Sr S Sjr \ S5rS\4SjrSrSrS rS rS rg) PortiPNc[RRXRU5RX#US9 X@lX`lSUlg)Nr)rrr7 _buildAddrnamemodewantPID_preexistingSocket)r6fileNamerbacklogrrrs r)r7 Port.__init__WsE  //(+00'G    "&r+c[R"X RUR5nU"UR 5X1S9nXElU$)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$r addressFamily socketTyperr)rrr'rportr6s r)_fromListeningDescriptorPort._fromListeningDescriptoras>}}R!2!2CNNC4##%w@"& r+returnc[R"URR5n[ US5(a&SR U[ SUR55$SUS3$)Nr$z <{} on {!r}>< (not listening)>)rqualrrhasattrrTrr)r6 factoryNames r)__repr__ Port.__repr__ts]ll4<<#9#9: 4 " "!((+B :  {m#45 5r+c.[R"U5$r2rr)r6rs r)rPort._buildAddr~""4((r+c\[RR5 [R"UR UR 5<S[SUR5<35 UR(a[R"URS-5Ul URR5(d"[R"SURS5eURR (dd["R$"[&R""UR5R(5(a [&R*"UR5 UR R/5 UR0bUR0nSUlO+UR35nUR5UR5 [7UR5(a+[&R8"URUR:5 UR=UR>5 SUl Xl!URBRDUl"SUl#URI5 g![,a GNf=f![Ja'n[R"SURU5eSnAff=f)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. starting on r.lockNzCannot acquire lockTd)&r _reservedFDreserverr]r`rrrrrFilesystemLocklockFilelockrCannotListenErrorcleanstatS_ISSOCKrmst_moderemove BaseExceptiondoStartrcreateInternetSocketbindrchmodrlistenr connectedr$rB numberAccepts startReadingrHr6rles r)startListeningPort.startListenings ! ""4<<0+B :   <<$33DII4HIDM==%%''--dDII?TUU}}**   ==);)C)CDDIIdii0  &&2--*.'//1#&dii00DII. JJt|| $!DNK++,,DK!$D     /) ?))$ 2> > ?s,?A#I)=A I:) I76I7: J+"J&&J+c^[R"S[SUR5-5 g)z Log message for closing socket z(UNIX Port %s Closed)rN)rr]rrr5s r)_logConnectionLostMsgPort._logConnectionLostMsgs*  #+II  r+c[UR5(a [R"UR5 URbURR 5 [ RRX5 gr2) rrrmunlinkrunlockrrconnectionLostr6reasons r)rPort.connectionLostsM !$)) , , IIdii == $ MM " -r+)rrrBrrrr$r)r.Nr)rrrsrtrur$rrrrr~ transportrr7rrstrrrrrrrxryr+r)rrPsaNNM##JIHPQ'$6#6)4 l  .r+rc\rSrSrSr\R r\Rr \ Rr S Sjr SrSrSrSrS rg) ClientizA client for Unix sockets.Nc[RU5 [R"U5RnX lU=UlUlU(aF[R"US-5(d(URSS[R"U5U5 URURUR5SU5 g)Nr)r-r7rrr connector realAddressaddrrisLocked _finishInitr BadFileError doConnectr)r6filenamerrcheckPIDs r)r7Client.__init__st$&&x055"'//49 H--h.ABB   T4););H)Ew O )B)B)DdGTr+cB[R"UR5$r2)rrrr5s r)r_Client.getPeers""499--r+c.[R"S5$r2rr5s r)r^Client.getHostrr+cg)aI FIXME:https://github.com/twisted/twisted/issues/12369 L{twisted.internet.unix.Client} inherits from L{twisted.internet.tcp.Client} which has this method implemented for TCP. For Unix socket, this is just a NOOP to avoid errors for the code that calls TCP specicific methods thinking that the Unix transport is a TCP transport. Fryr5s r)rClient.getTcpNoDelayrr+cgr2ryrs r)rClient.setTcpNoDelayrr+)rrr)Nr)rrrsrtrurvr$rrrrr BaseClientr/r7r_r^rrrxryr+r)rrs=$NNM##JU.)  r+rc&\rSrSrSrSrSrSrg) Connectoric\[RRXX45 XlXPlgr2)r BaseConnectorr7rr)r6rrtimeoutrrs r)r7Connector.__init__s" ##D7D  r+cX[URXRUR5$r2)rrrrr5s r)_makeTransportConnector._makeTransportsdllD,, FFr+cB[R"UR5$r2rr5s r)getDestinationConnector.getDestinations""4<<00r+)rrN)rrrsrtrur7rrrxryr+r)rrs! G1r+rcd\rSrSrSr\R rS SjrS\ 4Sjr Sr Sr S S jr S rS rg) DatagramPortiz, Datagram UNIX port, listening for packets. NcN[RRXX#US9 X@lg)z%Initialize with address to listen on.) maxPacketSizerN)rrr7r)r6rrr"rrs r)r7DatagramPort.__init__ s'  G   r+rc[R"URR5n[ US5(aSUSUR <S3$SUS3$)Nr$rz on >r)rrrrrr)r6rWs r)rDatagramPort.__repr__sU|| MM # #  4 " "|nD Q7 7|n$56 6r+cf[R"URRS[ UR 535 UR 5nUR (aURUR 5 UR (aE[UR 5(a+[R"UR UR5 SUlXlUR R"Ulg![a'n[R"SUR U5eSnAff=f)NrrF)rr]rrreprrrrrHrrrrmrrrr$rBrs r) _bindSocketDatagramPort._bindSockets 4==**+=dii8IJK ?++-Cyy# 99/ :: HHTYY * kk((  ?))$ 2> > ?sr>Os3  5 *,4r+r>)>rvrmr$rr"errnorrrrrrtypingr r zope.interfacer r r twisted.internetrrrrrrrrtwisted.internet.abstractrtwisted.pythonrrrrtwisted.python.compatrtwisted.python.filepathrtwisted.python.utilrr_sendmsg ImportErrorrr*r-r{IUNIXTransportr~rrrrrrrIUNIXDatagramTransportr IUNIXDatagramConnectedTransportr5r>ryr+r)ris  MM!GGWWW4::/?.2Gvy!! C DD=ood !M,M Z & &'D ]CJJD (D N )>>z.9chhz.z Z & &'$ ]CNN$ ($ N 1"" 1 Z . ./IG9chhIG0IGX..2? 2NQ4LQ4Q4eGs.FF&%F&