| Dir : /lib/python3.6/site-packages/netaddr/eui/__pycache__/ |
| Server: Linux premium155.web-hosting.com 4.18.0-553.89.1.lve.el8.x86_64 #1 SMP Wed Dec 10 13:58:50 UTC 2025 x86_64 IP: 162.0.235.198 |
| Dir : //lib/python3.6/site-packages/netaddr/eui/__pycache__/__init__.cpython-36.pyc |
3
��]�a � @ s� d Z ddlmZmZmZ ddlmZmZ ddl
m Z ddl m
Z
ddlmZ ddlmZmZ G dd � d e�ZG d
d � d e�ZG d d
� d
e�ZG dd� de�ZdS )z]
Classes and functions for dealing with MAC addresses, EUI-48, EUI-64, OUI, IAB
identifiers.
� )�NotRegisteredError�AddrFormatError�
DictDotLookup)�eui48�eui64)� mac_eui48)�
eui64_base)� IPAddress)�_is_int�_is_strc @ sD e Zd ZdZdZdd� Zdd� Zdd� Zd d
� Zd d � Z d
d� Z
dS )�BaseIdentifierz$Base class for all IEEE identifiers.�_valuec C s
d | _ d S )N)r
)�self� r � /usr/lib/python3.6/__init__.py�__init__ s zBaseIdentifier.__init__c C s | j S )z):return: integer value of this identifier)r
)r r r r �__int__ s zBaseIdentifier.__int__c C s | j S )z):return: integer value of this identifier)r
)r r r r �__long__ s zBaseIdentifier.__long__c C s | j dkrdS d| j S )z8:return: octal string representation of this identifier.r �0z0%o)r
)r r r r �__oct__" s
zBaseIdentifier.__oct__c C s
d| j S )z>:return: hexadecimal string representation of this identifier.z0x%x)r
)r r r r �__hex__) s zBaseIdentifier.__hex__c C s | j S )zx
:return: return the integer value of this identifier when passed to
hex(), oct() or bin().
)r
)r r r r � __index__. s zBaseIdentifier.__index__N)r
) �__name__�
__module__� __qualname__�__doc__� __slots__r r r r r r r r r r r s r c sr e Zd ZdZdZ� fdd�Zdd� Zdd� Zd d
� Zd d � Z d
d� Z
e dd� �Z ddd�Z
dd� Zdd� Z� ZS )�OUIz�
An individual IEEE OUI (Organisationally Unique Identifier).
For online details see - http://standards.ieee.org/regauth/oui/
�recordsc s� t t| �j� ddlm} g | _t|t�r@t|j dd�d�| _
nBt |�rvd| koZdkn rh|| _
q�t d| ��n t
d| ��| j
|jkr�t|jd �}x@|j| j
D ]0\}}|j|� |j|�jd
�}| j|||� q�W |j� n td | ��d S )
z�
Constructor
:param oui: an OUI string ``XX-XX-XX`` or an unsigned integer. Also accepts and parses full MAC/EUI-48 address strings (but not MAC/EUI-48 integers)!
r )�ieee�-� � i��� z"OUI int outside expected range: %rzunexpected OUI format: %r�rbzUTF-8zOUI %r not registered!N)�superr r � netaddr.euir r �
isinstance�str�int�replacer
r
�
ValueError� TypeErrorZ OUI_INDEX�openZOUI_REGISTRY_PATH�seek�read�decode� _parse_data�closer )r �ouir �fh�offset�size�data)� __class__r r r @ s$
z OUI.__init__c C s: t |t�s.y| j|�}W n tk
r, tS X | j|jkS )N)r& r r7 � Exception�NotImplementedr
)r �otherr r r �__eq__g s
z
OUI.__eq__c C s: t |t�s.y| j|�}W n tk
r, tS X | j|jkS )N)r& r r7 r8 r9 r
)r r: r r r �__ne__o s
z
OUI.__ne__c C s | j | jfS )z+:returns: Pickled state of an `OUI` object.)r
r )r r r r � __getstate__w s zOUI.__getstate__c C s |\| _ | _dS )z;:param state: data used to unpickle a pickled `OUI` object.N)r
r )r �stater r r � __setstate__{ s zOUI.__setstate__c C s� dddg ||d�}xn|j d�D ]`}|j� }|s0q d|krd| j|d< |j dd�d |d < t| �|d
< q d |krpq q |d j|� q W | jj|� dS )
z.Returns a dict record from raw OUI record datar r! )�idxr2 �org�addressr4 r5 �
z(hex)r@ N� rA r2 z (base 16)rB )�split�stripr
r' �appendr )r r6 r4 r5 �record�liner r r r0 s$
zOUI._parse_datac C s
t | j�S )z0Number of registered organisations with this OUI)�lenr )r r r r � reg_count� s z
OUI.reg_countr c C s t | j| �S )a
The IEEE registration details for this OUI.
:param index: the index of record (may contain multiple registrations)
(Default: 0 - first registration)
:return: Objectified Python data structure containing registration
details.
)r r )r �indexr r r � registration� s
zOUI.registrationc C s( | j }d|d? d@ |d? d@ |d@ f S )z*:return: string representation of this OUIz%02X-%02X-%02Xr" � � )r
)r �int_valr r r �__str__� s
z OUI.__str__c C s d| S )z@:return: executable Python string to recreate equivalent object.z OUI('%s')r )r r r r �__repr__� s z OUI.__repr__)r )r )r r r r r r r; r< r= r? r0 �propertyrK rM rQ rR �
__classcell__r r )r7 r r 7 s '
r c st e Zd ZdZdZeddd��Zd� fdd� Zdd � Zd
d � Z d d
� Z
dd� Z dd� Z dd� Z
dd� Zdd� Z� ZS )�IABz�
An individual IEEE IAB (Individual Address Block) identifier.
For online details see - http://standards.ieee.org/regauth/oui/
rH Fc C s� d| kodkn r | dfS d }d
|A }| d? }| |B | }d| koRdkn rv|r�|dkr�t dt|� ��nt d t| � ��||fS )z�
:param eui_int: a MAC IAB as an unsigned integer.
:param strict: If True, raises a ValueError if the last 12 bits of
IAB MAC/EUI-48 address are non-zero, ignores them otherwise.
(Default: False)
i i�/ r rD � � �0 z%r is not a strict IAB!z%r is not an IAB address!i i� l l ��� )r* �hex)Zeui_int�strictZ user_maskZiab_maskZiab_bitsZ user_bitsr r r �
split_iab_mac� s zIAB.split_iab_macc s t t| �j� ddlm} dddg ddd�| _t|t�rdt|j dd�d�}| j
||d�\}}|| _ n.t |�r�| j
||d�\}}|| _ n t
d| ��| j |jk�rt|jd �}|j| j d \}} || jd
< | | jd < |j|� |j| �jd �}
| j|
|| � |j� n td
| ��dS )a�
Constructor
:param iab: an IAB string ``00-50-C2-XX-X0-00`` or an unsigned integer. This address looks like an EUI-48 but it should not have any non-zero bits in the last 3 bytes.
:param strict: If True, raises a ValueError if the last 12 bits of IAB MAC/EUI-48 address are non-zero, ignores them otherwise. (Default: False)
r )r r! )r@ �iabrA rB r4 r5 r r" )rZ zunexpected IAB format: %r!r# r4 r5 zUTF-8zIAB %r not unregistered!N)r$ rU r r% r rH r& r' r( r) r[ r
r
r+ Z IAB_INDEXr, ZIAB_REGISTRY_PATHr- r. r/ r0 r1 r ) r r\ rZ r rP Ziab_intZuser_intr3 r4 r5 r6 )r7 r r r � s4
z IAB.__init__c C s: t |t�s.y| j|�}W n tk
r, tS X | j|jkS )N)r& rU r7 r8 r9 r
)r r: r r r r; s
z
IAB.__eq__c C s: t |t�s.y| j|�}W n tk
r, tS X | j|jkS )N)r& rU r7 r8 r9 r
)r r: r r r r< s
z
IAB.__ne__c C s | j | jfS )z+:returns: Pickled state of an `IAB` object.)r
rH )r r r r r= s zIAB.__getstate__c C s |\| _ | _dS )z;:param state: data used to unpickle a pickled `IAB` object.N)r
rH )r r> r r r r? " s zIAB.__setstate__c C s| xv|j d�D ]h}|j� }|s q d|krX| j| jd< |j dd�d | jd< t| �| jd< q d|krdq q | jd j|� q W dS )
z.Returns a dict record from raw IAB record datarC z(hex)r@ NrD rA r\ z (base 16)rB )rE rF r
rH r' rG )r r6 r4 r5 rI r r r r0 & s zIAB._parse_datac C s
t | j�S )z*The IEEE registration details for this IAB)r rH )r r r r rM 6 s zIAB.registrationc C s@ | j d> }d|d? d@ |d? d@ |d? d@ |d? d@ |d@ f S )z*:return: string representation of this IAB� z%02X-%02X-%02X-%02X-%02X-00� rN � r" rO )r
)r rP r r r rQ : s
z IAB.__str__c C s d| S )z@:return: executable Python string to recreate equivalent object.z IAB('%s')r )r r r r rR E s z IAB.__repr__)rH )F)F)r r r r r � staticmethodr[ r r; r< r= r? r0 rM rQ rR rT r r )r7 r rU � s 4 rU c s\ e Zd ZdZdGZdH� fdd� Zdd� Zd d
� Zd d � Zd
d� Z e
ee dd�Z dd� Z dd� Z
e
e e
dd�Ze
dd� �Ze
dd� �Zdd� Ze
dd � �Ze
d d � �Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd)d*� Zd+d,� Zd-d.� Zd/d0� Z dId1d2�Z e
d3d4� �Z e
d5d6� �Z e
d7d8� �Z d9d:� Z!d;d<� Z"d=d>� Z#d?d@� Z$e
dAdB� �Z%dCdD� Z&dEdF� Z'� Z(S )J�EUIz�
An IEEE EUI (Extended Unique Identifier).
Both EUI-48 (used for layer 2 MAC addresses) and EUI-64 are supported.
Input parsing for EUI-48 addresses is flexible, supporting many MAC
variants.
�_module�_dialectNc s� t t| �j� d| _t|t�rV|dk r:||jjkr:td��|j| _|j| _|j| _dS |dk r�|dkrnt | _q�|dkr~t
| _q�td| ��nFt |�r�d| ko�dkn r�t | _n d| k o�dkn r�t
| _|| _ || _dS ) a2
Constructor.
:param addr: an EUI-48 (MAC) or EUI-64 address in string format or an unsigned integer. May also be another EUI object (copy construction).
:param version: (optional) the explicit EUI address version, either 48 or 64. Mainly used to distinguish EUI-48 and EUI-64 identifiers specified as integers which may be numerically equivalent.
:param dialect: (optional) the mac_* dialect to be used to configure the formatting of EUI-48 (MAC) addresses.
Nz2cannot switch EUI versions using copy constructor!rX �@ zunsupported EUI version %rr l ��� l ���� )
r$ ra r rb r& �versionr* r
�dialect�_eui48�_eui64r
�value)r Zaddrre rf )r7 r r r V s,
z EUI.__init__c C s | j | jj| jfS )z+:returns: Pickled state of an `EUI` object.)r
rb re rf )r r r r r= � s zEUI.__getstate__c C sJ |\}}}|| _ |dkr t| _n |dkr0t| _ntdt|� ��|| _dS )zN
:param state: data used to unpickle a pickled `EUI` object.
rX rd z&unpickling failed for object state: %sN)r
rg rb rh r* r' rf )r r> ri re rf r r r r? � s
zEUI.__setstate__c C s | j S )N)r
)r r r r �
_get_value� s zEUI._get_valuec C s2 | j d kr�x�ttfD ]|}y|j|�| _|| _ P W q tk
r� y4dt|� koZ|jkn rrt|�| _|| _ P W n tk
r� Y nX Y qX qW | j d kr�td| ��n�t |�r�y| j j|�| _W n( tk
r� td|| j j
f ��Y nX n<dt|� k�o| j jkn �r"t|�| _n td| ��d S )Nr z failed to detect EUI version: %rzaddress %r is not an EUIv%dzbad address format: %r) rb rg rh Z
str_to_intr
r r( Zmax_intr* r re )r ri �moduler r r �
_set_value� s4
$ zEUI._set_valuezBa positive integer representing the value of this EUI indentifier.c C s | j S )N)rc )r r r r � _get_dialect� s zEUI._get_dialectc C sJ |d kr"| j tkrt| _qFt| _n$t|d�r>t|d�r>|| _ntd��d S )N� word_sizeZword_fmtz*custom dialects should subclass mac_eui48!)rb rh r rc r �hasattrr+ )r ri r r r � _set_dialect� s
zEUI._set_dialectzXa Python class providing support for the interpretation of various MAC
address formats.c C s4 | j tkrt| jd? �S | j tkr0t| jd? �S dS )z:The OUI (Organisationally Unique Identifier) for this EUI.r_ �( N)rb rg r ri rh )r r r r r2 � s
zEUI.ouic C s@ | j tkr dt| dd� � S | j tkr<dt| dd� � S dS )z*The EI (Extension Identifier) for this EUIz%02X-%02X-%02X� � z%02X-%02X-%02X-%02X-%02XrO N)rb rg �tuplerh )r r r r �ei� s
zEUI.eic C s d| j d? kodkS S )z<:return: True if this EUI is an IAB address, False otherwisei rV i�/ )r
)r r r r �is_iab� s z
EUI.is_iabc C s | j � rt| jd? �S dS )zr
If is_iab() is True, the IAB (Individual Address Block) is returned,
``None`` otherwise.
rV N)rv rU r
)r r r r r\ � s zEUI.iabc C s | j jS )z/The EUI version represented by this EUI object.)rb re )r r r r re � s z EUI.versionc s� t |�rL| jj}| | ko(|d kn s6td��| jj| j| j�| S t|t�r�| jj| j| j�� � fdd�t |j
t � ��� D �S t d| ��dS )z�
:return: The integer value of the word referenced by index (both positive and negative). Raises ``IndexError`` if index is out of bounds. Also supports Python list slices for accessing word groups.
rW z!index out range for address type!c s g | ] }� | �qS r r )�.0�i)�wordsr r �
<listcomp> s z#EUI.__getitem__.<locals>.<listcomp>zunsupported type %r!N)
r
rc � num_words�
IndexErrorrb � int_to_wordsr
r& �slice�range�indicesrJ r+ )r r@ r{ r )ry r � __getitem__� s
zEUI.__getitem__c C s� t |t�rtd��t|�s"td��d| ko<| jjd kn sNtd| ��t|�s^td��d| kot| jjkn s�td|| jj f ��t
| j j | j
| j��}|||< | j j|�| _
dS ) z=Set the value of the word referenced by index in this addressz"settable slices are not supported!zindex not an integer!r rW z'index %d outside address type boundary!zvalue not an integer!z.value %d outside word size maximum of %d bits!N)r& r~ �NotImplementedErrorr
r+ rc r{ r| Zmax_wordrn �listrb r} r
Z words_to_int)r r@ ri ry r r r � __setitem__ s
zEUI.__setitem__c C s t | j| jf�S )zA:return: hash of this EUI object suitable for dict keys, sets etc)�hashre r
)r r r r �__hash__& s z EUI.__hash__c C sF t |t�s.y| j|�}W n tk
r, tS X | j| jf|j|jfkS )zy
:return: ``True`` if this EUI object is numerically the same as other, ``False`` otherwise.
)r& ra r7 r8 r9 re r
)r r: r r r r; * s
z
EUI.__eq__c C sF t |t�s.y| j|�}W n tk
r, tS X | j| jf|j|jfkS )zy
:return: ``True`` if this EUI object is numerically the same as other, ``False`` otherwise.
)r& ra r7 r8 r9 re r
)r r: r r r r< 6 s
z
EUI.__ne__c C sF t |t�s.y| j|�}W n tk
r, tS X | j| jf|j|jfk S )z�
:return: ``True`` if this EUI object is numerically lower in value than other, ``False`` otherwise.
)r& ra r7 r8 r9 re r
)r r: r r r �__lt__B s
z
EUI.__lt__c C sF t |t�s.y| j|�}W n tk
r, tS X | j| jf|j|jfkS )z�
:return: ``True`` if this EUI object is numerically lower or equal in value to other, ``False`` otherwise.
)r& ra r7 r8 r9 re r
)r r: r r r �__le__N s
z
EUI.__le__c C sF t |t�s.y| j|�}W n tk
r, tS X | j| jf|j|jfkS )z�
:return: ``True`` if this EUI object is numerically greater in value than other, ``False`` otherwise.
)r& ra r7 r8 r9 re r
)r r: r r r �__gt__Z s
z
EUI.__gt__c C sF t |t�s.y| j|�}W n tk
r, tS X | j| jf|j|jfkS )z�
:return: ``True`` if this EUI object is numerically greater or equal in value to other, ``False`` otherwise.
)r& ra r7 r8 r9 re r
)r r: r r r �__ge__f s
z
EUI.__ge__c C s | j j| j|�S )z�
:param word_sep: (optional) the separator to insert between words. Default: None - use default separator for address type.
:return: human-readable binary digit string of this address.
)rb Z int_to_bitsr
)r Zword_sepr r r �bitsr s zEUI.bitsc C s | j j| j�S )z8The value of this EUI address as a packed binary string.)rb Z
int_to_packedr
)r r r r �packed{ s z
EUI.packedc C s | j j| j�S )z<A list of unsigned integer octets found in this EUI address.)rb r} r
)r r r r ry � s z EUI.wordsc C s | j j| j�S )z�
The value of this EUI adddress in standard Python binary
representational form (0bxxx). A back port of the format provided by
the builtin bin() function found in Python 2.6.x and higher.
)rb Z
int_to_binr
)r r r r �bin� s zEUI.binc C sD | j dkr0| jd? }| jd@ }|d> dB |B }n| j}| j|dd�S )a2
- If this object represents an EUI-48 it is converted to EUI-64 as per the standard.
- If this object is already an EUI-64, a new, numerically equivalent object is returned instead.
:return: The value of this EUI object as a new 64-bit EUI object.
rX r_ i��� rq l |�rd )re )re r
r7 )r Z first_threeZ
last_threeZ new_valuer r r r � s
z EUI.eui64c C s | j � }| jdN _|S )z�
- create a new EUI object with a modified EUI-64 as described in RFC 4291 section 2.5.1
:return: a new and modified 64-bit EUI object.
l )r r
)r r r r r �modified_eui64� s zEUI.modified_eui64c C s t |�t | j� � }t|dd�S )a5
.. note:: This poses security risks in certain scenarios. Please read RFC 4941 for details. Reference: RFCs 4291 and 4941.
:param prefix: ipv6 prefix
:return: new IPv6 `IPAddress` object based on this `EUI` using the technique described in RFC 4291.
rs )re )r( r� r )r �prefixrP r r r �ipv6� s
zEUI.ipv6c C s
| j d�S )a
.. note:: This poses security risks in certain scenarios. Please read RFC 4941 for details. Reference: RFCs 4291 and 4941.
:return: new link local IPv6 `IPAddress` object based on this `EUI` using the technique described in RFC 4291.
l @� )r� )r r r r �ipv6_link_local� s zEUI.ipv6_link_localc C s, d| j j� i}| j� r$| jj� |d< t|�S )z�
A record dict containing IEEE registration details for this EUI
(MAC-48) if available, None otherwise.
r rU )r2 rM rv r\ r )r r6 r r r �info� s zEUI.infoc C s | j j| j| j�S )z':return: EUI in representational format)rb Z
int_to_strr
rc )r r r r rQ � s z EUI.__str__c C s d| S )z@:return: executable Python string to recreate equivalent object.z EUI('%s')r )r r r r rR � s z EUI.__repr__)rb rc )NN)N))r r r r r r r= r? rj rl rS ri rm rp rf r2 ru rv r\ re r� r� r� r; r< r� r� r� r� r� r� ry r� r r� r� r� r� rQ rR rT r r )r7 r ra J sL 2"
ra N)r Z netaddr.corer r r Znetaddr.strategyr rg r rh Znetaddr.strategy.eui48r Znetaddr.strategy.eui64r Z
netaddr.ipr Znetaddr.compatr
r �objectr r rU ra r r r r �<module> s $