File: //usr/lib/python3/dist-packages/twisted/protocols/__pycache__/ident.cpython-310.pyc
o
�b� � @ s� d Z ddlZddlmZ ddlmZ ddlmZmZ dZ dZ
G dd � d e �Z G d
d � d e �Z
G d d
� d
e �ZG dd� de �ZG dd� dej�ZG dd� d�ZG dd� dej�Zg d�ZdS )z
Ident protocol implementation.
� N)�defer)�basic)�failure�log� i�� c @ s" e Zd ZdZdZdefdd�ZdS )�
IdentErrorz;
Can't determine connection owner; reason unknown.
z
UNKNOWN-ERROR�returnc C s | j S �N)�identDescription��self� r
�9/usr/lib/python3/dist-packages/twisted/protocols/ident.py�__str__ � zIdentError.__str__N)�__name__�
__module__� __qualname__�__doc__r
�strr r
r
r
r r s r c @ � e Zd ZdZdZdS )�NoUserz�
The connection specified by the port pair is not currently in use or
currently not owned by an identifiable entity.
zNO-USERN�r r r r r
r
r
r
r r � r c @ r )� InvalidPorta
Either the local or foreign port was improperly specified. This should
be returned if either or both of the port ids were out of range (TCP
port numbers are from 1-65535), negative integers, reals or in any
fashion not recognized as a non-negative integer.
z INVALID-PORTNr r
r
r
r r ' s r c @ r )�
HiddenUserz�
The server was able to identify the user of this port, but the
information was not returned at the request of the user.
z HIDDEN-USERNr r
r
r
r r 2 r r c @ s@ e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd d
� Z dS )� IdentServera�
The Identification Protocol (a.k.a., "ident", a.k.a., "the Ident
Protocol") provides a means to determine the identity of a user of a
particular TCP connection. Given a TCP port number pair, it returns a
character string which identifies the owner of that connection on the
server's system.
Server authors should subclass this class and override the lookup method.
The default implementation returns an UNKNOWN-ERROR response for every
query.
c C s� |� d�}t|�dkr| �� d S z tt|�\}}W n ty( | �� Y d S w t| kr3tkrIn nt| kr?tkrIn n| �||� d S | � t
� t � �||� d S )N�,� )
�split�len� invalidQuery�map�int�
ValueError� _MIN_PORT� _MAX_PORT�
validQuery� _ebLookupr �Failurer )r �line�parts� portOnServer� portOnClientr
r
r � lineReceivedH s
��zIdentServer.lineReceivedc C s | j �� d S r )� transport�loseConnectionr r
r
r r! \ s zIdentServer.invalidQueryc C sL | j �� j|f}| j �� j|f}t�| j||��| j||�� | j
||� dS )z�
Called when a valid query is received to look up and deliver the
response.
@param portOnServer: The server port from the query.
@param portOnClient: The client port from the query.
N) r/ �getHost�host�getPeerr �
maybeDeferred�lookup� addCallback� _cbLookup�
addErrbackr( )r r, r- �
serverAddr�
clientAddrr
r
r r' _ s �zIdentServer.validQueryc C s" |\}}| � d||||f � d S )Nz%d, %d : USERID : %s : %s)�sendLine)r �result�sport�cport�sysName�userIdr
r
r r7 m s zIdentServer._cbLookupc C sL |� t�r| �d|||jf � d S t�|� | �d||t|j�f � d S )Nz%d, %d : ERROR : %s)�checkr r; �valuer �err)r r r= r> r
r
r r( q s
�zIdentServer._ebLookupc C � t � �)aq
Lookup user information about the specified address pair.
Return value should be a two-tuple of system name and username.
Acceptable values for the system name may be found online at::
U{http://www.iana.org/assignments/operating-system-names}
This method may also raise any IdentError subclass (or IdentError
itself) to indicate user information will not be provided for the
given query.
A Deferred may also be returned.
@param serverAddress: A two-tuple representing the server endpoint
of the address being queried. The first element is a string holding
a dotted-quad IP address. The second element is an integer
representing the port.
@param clientAddress: Like I{serverAddress}, but represents the
client endpoint of the address being queried.
�r )r �
serverAddress�
clientAddressr
r
r r5 z s zIdentServer.lookupN)
r r r r r. r! r' r7 r( r5 r
r
r
r r ; s r c @ sx e Zd ZdZdZzddlmZ efdd�Z[W n ey% ddd�ZY nw d d
� Z d d � Z
d
d� Z dd� Z dd� Z
dS )�ProcServerMixinzDImplements lookup() to grab entries for responses from /proc/net/tcp�LINUXr )�getpwuidc C s ||�d S �Nr r
�r �uidrJ r
r
r � getUsername� s zProcServerMixin.getUsernameNc C rD r rE rL r
r
r rN � r c c sL � t d��}|�� |D ]}|�� V q W d � d S 1 s w Y d S )Nz
/proc/net/tcp)�open�readline�strip)r �f�Lr
r
r �entries� s �
�"�zProcServerMixin.entriesc
C s& d� ttt�dt�dt|d�����S )N�.�4Bz=L� )�joinr" r �struct�unpack�packr# )r �hexstrr
r
r �dottedQuadFromHexString� s �z'ProcServerMixin.dottedQuadFromHexStringc C s* |� d�\}}| �|�}t|d�}||fS )N�:rW )r r] r# )r �packed�addr�portr
r
r �
unpackAddress� s
z ProcServerMixin.unpackAddressc C sN |� � �� }| �|d �\}}| �|d �\}}t|d �}||f||f|fS )Nr r � )rQ r rb r# )r r* r+ � localAddr� localPort�
remoteAddr�
remotePortrM r
r
r � parseLine� s
zProcServerMixin.parseLinec C sP | � � D ] }| �|�\}}}||kr$|d |d kr$| j| �|�f S qt� �)Nr )rT rh � SYSTEM_NAMErN r )r rF rG �entrd rf rM r
r
r r5 � s �zProcServerMixin.lookupr )r r r r ri �pwdrJ rN � ImportErrorrT r] rb rh r5 r
r
r
r rH � s � rH c @ s@ e Zd ZeeeefZdd� Zdd� Z dd� Z
dd� Z d d
� Z d S ) � IdentClientc C s
g | _ d S r )�queriesr r
r
r �__init__� s
zIdentClient.__init__c C sR | j �t�� ||f� t| j �dkr| j d d S | �d||f � | j d d S )zK
Lookup user information about the specified address pair.
r ���r �%d, %d)rn �appendr �Deferredr r; )r r, r- r
r
r r5 � s
zIdentClient.lookupc C sl | j s
t�d|��� d S | j �d�\}}}| �||� | j r4| �d| j d d | j d d f � d S d S )Nz Unexpected server response: r rq r r )rn r �msg�pop�
parseResponser; )r r* �d�_r
r
r r. � s *�zIdentClient.lineReceivedc C s( | j D ] }|d �t|�� qg | _ d S rK )rn �errbackr )r �reason�qr
r
r �connectionLost� s
zIdentClient.connectionLostc C s� |� dd�}t|�dkr|�t|�� d S ttj|�\}}}|dkr@| jD ]}|j|kr6|�||�� d S q%|�t|�� d S |� ||f� d S )Nr^ r � �ERROR)
r r ry r r" r rQ �
errorTypesr
�callback)r �deferredr* r+ �ports�type�addInfo�etr
r
r rv � s
�zIdentClient.parseResponseN)
r r r r r r r r ro r5 r. r| rv r
r
r
r rm � s rm )r r r r r rm rH )r rY �twisted.internetr �twisted.protocolsr �twisted.pythonr r r% r& � Exceptionr r r r �LineOnlyReceiverr rH rm �__all__r
r
r
r �<module> s Y2 0