| Server IP : 198.38.94.13 / Your IP : 216.73.217.33 Web Server : Apache System : Linux d4744.dxb1.stableserver.net 5.14.0-611.49.1.el9_7.x86_64 #1 SMP PREEMPT_DYNAMIC Tue Apr 21 16:39:08 EDT 2026 x86_64 User : revivere ( 1140) PHP Version : 8.2.33 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : /lib/python3.9/site-packages/netaddr/eui/__pycache__/ |
Upload File : |
a
��g�d � @ s� d Z ddlmZmZmZ ddlmZmZ ddl
m Z ddl m
Z
ddlmZ ddlmZmZmZ 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)� _open_binary�_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.)�_value� __weakref__c C s
d | _ d S �N�r ��self� r �8/usr/lib/python3.9/site-packages/netaddr/eui/__init__.py�__init__ s zBaseIdentifier.__init__c C s | j S �z):return: integer value of this identifierr r r r r �__int__ s zBaseIdentifier.__int__c C s | j S r 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%or r r r r �__oct__" s
zBaseIdentifier.__oct__c C s
d| j S )z>:return: hexadecimal string representation of this identifier.z0x%xr 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) �__name__�
__module__� __qualname__�__doc__� __slots__r r r r r r r r r r r
s r
c sz e Zd ZdZdZ� fdd�Zdd� Zdd� Zd d
� Zd d � Z d
d� Z
dd� Z e dd� �Z
ddd�Zdd� 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| ��� ddlm} g | _t|t�r@t|� dd�d�| _
nFt |�rxd| kr\dkrhn n|| _
q�t d|f ��nt
d|f ��| j
|jv r�ttd �}|j| j
D ]0\}}|�|� |�|��d
�}| �|||� q�|�� ntd |f ��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�-� � �� z"OUI int outside expected range: %rzunexpected OUI format: %rzoui.txt�UTF-8zOUI %r not registered!N)�superr# r � netaddr.euir& r$ �
isinstance�str�int�replacer r �
ValueError� TypeErrorZ OUI_INDEXr
� __package__�seek�read�decode� _parse_data�closer )r �ouir& �fh�offset�size�data�� __class__r r r @ s$
z OUI.__init__c C s
t | j�S r )�hashr r r r r �__hash__g s z OUI.__hash__c C s< t |t�s0z| �|�}W n ty. t Y S 0 | j|jkS r �r. r# r@ � Exception�NotImplementedr �r �otherr r r �__eq__j s
z
OUI.__eq__c C s< t |t�s0z| �|�}W n ty. t Y S 0 | j|jkS r rC rF r r r �__ne__r s
z
OUI.__ne__c C s | j | jfS )z+:returns: Pickled state of an `OUI` object.�r r$ r r r r � __getstate__z s zOUI.__getstate__c C s |\| _ | _dS )z;:param state: data used to unpickle a pickled `OUI` object.NrJ �r �stater r r � __setstate__~ s zOUI.__setstate__c C s� dddg ||d�}|� d�D ]`}|�� }|s.q d|v rb| j|d< |� dd�d |d < t| �|d
< q d |v rnq q |d �|� q | j�|� dS )
z.Returns a dict record from raw OUI record datar r( )�idxr: �org�addressr< r= �
�(hex)rO N� rP r: � (base 16)rQ )�split�stripr r/ �appendr$ )r r> r< r= �record�liner r r r8 � 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 OUI�%02X-%02X-%02Xr) � � r �r �int_valr r r �__str__� s
�z OUI.__str__c C s d| S )�@: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 rB rH rI rK rN r8 �propertyr\ r^ rd rf �
__classcell__r r r? 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 )�IAB)i�P iU�@ )rY Fc C sz |d? | j v r|dfS d}d|A }|d? }||B | }|d? | j v rb|rr|dkrrtdt|� ��ntdt|� ��||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)
� r i� � ��� z%r is not a strict IAB!z%r is not an IAB address!)�IAB_EUI_VALUESr2 �hex)�clsZeui_int�strictZ user_maskZiab_maskZiab_bitsZ user_bitsr r r �
split_iab_mac� s zIAB.split_iab_macc s t t| ��� ddlm} dddg ddd�| _t|t�rdt|� dd�d�}| j
||d�\}}|| _ n0t |�r�| j
||d�\}}|| _ nt
d|f ��| j |jv �rttd �}|j| j d \}} || jd
< | | jd < |�|� |�| ��d �}
| �|
|| � |�� ntd
|f ��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( )rO �iabrP rQ r< r= r' r) )ro zunexpected IAB format: %r!ziab.txtr< r= r+ zIAB %r not unregistered!N)r, ri r r- r& rY r. r/ r0 r1 rp r r r3 Z IAB_INDEXr
r4 r5 r6 r7 r8 r9 r ) r rq ro r& rc Ziab_intZuser_intr; r< r= r> r? r r r � s6 �
z IAB.__init__c C s< t |t�s0z| �|�}W n ty. t Y S 0 | j|jkS r �r. ri r@ rD rE r rF r r r rH s
z
IAB.__eq__c C s< t |t�s0z| �|�}W n ty. t Y S 0 | j|jkS r rr rF r r r rI s
z
IAB.__ne__c C s | j | jfS )z+:returns: Pickled state of an `IAB` object.�r rY r r r r rK # s zIAB.__getstate__c C s |\| _ | _dS )z;:param state: data used to unpickle a pickled `IAB` object.Nrs rL r r r rN ' s zIAB.__setstate__c C sx |� d�D ]h}|�� }|s q
d|v rV| j| jd< |� dd�d | jd< t| �| jd< q
d|v rbq
q
| jd �|� q
dS )
z.Returns a dict record from raw IAB record datarR rS rO NrT rP rq rU rQ )rV rW r rY r/ rX )r r> r< r= rZ r r r r8 + s zIAB._parse_datac C s
t | j�S )z*The IEEE registration details for this IAB)r rY r r r r r^ ; 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� r` � r) ra r rb r r r rd ? s
�z IAB.__str__c C s d| S )re z IAB('%s')r r r r r rf J s z IAB.__repr__)F)F)r r r rl r" � classmethodrp r rH rI rK rN r8 r^ rd rf rh r r r? r ri � s 4 ri c sn e Zd ZdZdZdJ� fdd� Zdd� Zdd � Zd
d � Zd d
� Z e
ee dd�Z dd� Z dd� Z
dd� Ze
e edd�Ze
dd� �Ze
dd� �Zdd� Ze
d d � �Ze
d d � �Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Zd,d-� Zd.d/� Z d0d1� Z dKd2d3�Z e
d4d5� �Z e
d6d7� �Z e
d8d9� �Z!d:d;� Z"d<d=� Z#d>d?� Z$d@dA� Z%e
dBdC� �Z&dLdDdE�Z'dFdG� Z(dHdI� Z)� Z*S )M�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| ��� d| _t|t�rV|dur:||jjkr:td��|j| _|j| _|j| _dS |dur�|dkrnt | _q�|dkr~t
| _q�td| ��nFt |�r�d| kr�dkr�n nt | _n d| k r�dkr�n nt
| _|| _ || _dS ) aJ
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) one of the :ref:`mac_formatting_dialects` to
be used to configure the formatting of EUI-48 (MAC) addresses.
Nz2cannot switch EUI versions using copy constructor!�0 �@ zunsupported EUI version %rr rk l ���� )
r, rx r ry r. �versionr2 r �dialect�_eui48�_eui64r �value)r �addrr} r~ r? r r r [ s,
z EUI.__init__c C s | j | jj| jfS )z+:returns: Pickled state of an `EUI` object.)r ry r} r~ r r r r rK � s zEUI.__getstate__c C sH |\}}}|| _ |dkr t| _n |dkr0t| _ntd|f ��|| _dS )zN
:param state: data used to unpickle a pickled `EUI` object.
r{ r| z&unpickling failed for object state: %sN)r r ry r� r2 r~ )r rM r� r} r~ r r r rN � s
�zEUI.__setstate__c C s | j S r r r r r r �
_get_value� s zEUI._get_valuec C s6 | j d u r�ttfD ]�}z |�|�| _|| _ W q�W q ty� z:dt|� kr\|jkrxn nt|�| _|| _ W Y q�W n ty� Y n0 Y q0 q| j d u r�td|f ��n�t |�r�z| j �|�| _W n& ty� td|| j j
f ��Y n0 n>dt|� k�r| j jk�r$n n t|�| _ntd|f ��d S )Nr z failed to detect EUI version: %rzaddress %r is not an EUIv%dzbad address format: %r) ry r r� Z
str_to_intr r r0 Zmax_intr2 r r} )r r� �moduler r r �
_set_value� s8
�
�$ zEUI._set_valuezAa positive integer representing the value of this EUI identifier.c C s | j S r )rz r r r r � _get_dialect� s zEUI._get_dialectc C s@ |d u r | j tu rtS tS n t|d�r4t|d�r4|S td��d S )N� word_sizeZword_fmtz*custom dialects should subclass mac_eui48!)ry r� r r �hasattrr3 �r r� r r r �_validate_dialect� s
zEUI._validate_dialectc C s | � |�| _d S r )r� rz r� 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.rv �( N)ry r r# r� r� r r r r r: � s
zEUI.ouic C s@ | j tkr dt| dd� � S | j tkr<dt| dd� � S dS )z*The EI (Extension Identifier) for this EUIr_ � � z%02X-%02X-%02X-%02X-%02Xra N)ry r �tupler� r r r r �ei� s
zEUI.eic C s | j d? tjv S )z<:return: True if this EUI is an IAB address, False otherwiserv )r ri rl r r r r �is_iab� s z
EUI.is_iabc C s | � � rt| jd? �S dS )zr
If is_iab() is True, the IAB (Individual Address Block) is returned,
``None`` otherwise.
rj N)r� ri r r r r r rq � s zEUI.iabc C s | j jS )z/The EUI version represented by this EUI object.)ry r} r r r r r} � s z EUI.versionc s� t |�rJ| jj}| | kr*|d ks4n td��| j�| j| j�| S t|t�r�| j�| j| j�� � fdd�t |�
t � ��� D �S t d|f ��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.
� z!index out range for address type!c s g | ] }� | �qS r r )�.0�i��wordsr r �
<listcomp> � z#EUI.__getitem__.<locals>.<listcomp>zunsupported type %r!N)
r rz � num_words�
IndexErrorry � int_to_wordsr r. �slice�range�indicesr[ r3 )r rO r� r r� r � __getitem__ s
zEUI.__getitem__c C s� t |t�rtd��t|�s"td��d| kr>| jjd ksNn td|f ��t|�s^td��d| krv| jjks�n td|| jj f ��t
| 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 r� 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 r3 rz r� r� Zmax_wordr� �listry r� r Z words_to_int)r rO r� r� 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)rA r} r r r r r rB . s z EUI.__hash__c C sH t |t�s0z| �|�}W n ty. t Y S 0 | j| jf|j|jfkS �zy
:return: ``True`` if this EUI object is numerically the same as other, ``False`` otherwise.
�r. rx r@ rD rE r} r rF r r r rH 2 s
z
EUI.__eq__c C sH t |t�s0z| �|�}W n ty. t Y S 0 | j| jf|j|jfkS r� r� rF r r r rI > s
z
EUI.__ne__c C sH t |t�s0z| �|�}W n ty. t Y S 0 | j| jf|j|jfk S )z�
:return: ``True`` if this EUI object is numerically lower in value than other, ``False`` otherwise.
r� rF r r r �__lt__J s
z
EUI.__lt__c C sH t |t�s0z| �|�}W n ty. t Y S 0 | j| jf|j|jfkS )z�
:return: ``True`` if this EUI object is numerically lower or equal in value to other, ``False`` otherwise.
r� rF r r r �__le__V s
z
EUI.__le__c C sH t |t�s0z| �|�}W n ty. t Y S 0 | j| jf|j|jfkS )z�
:return: ``True`` if this EUI object is numerically greater in value than other, ``False`` otherwise.
r� rF r r r �__gt__b s
z
EUI.__gt__c C sH t |t�s0z| �|�}W n ty. t Y S 0 | j| jf|j|jfkS )z�
:return: ``True`` if this EUI object is numerically greater or equal in value to other, ``False`` otherwise.
r� rF r r r �__ge__n s
z
EUI.__ge__c C s | 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.
)ry Z int_to_bitsr )r Zword_sepr r r �bitsz s zEUI.bitsc C s | j �| j�S )z8The value of this EUI address as a packed binary string.)ry Z
int_to_packedr r r r r �packed� s z
EUI.packedc C s | j �| j�S )z<A list of unsigned integer octets found in this EUI address.)ry r� r r r r r r� � s z EUI.wordsc C s | j �| j�S )z�
The value of this EUI address 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.
)ry 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.
r{ rv r* r� l |�r| �r} )r} r r@ )r Z first_threeZ
last_threeZ new_valuer r r r � s
z EUI.eui64c C s | � � }| 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 | �� � }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.
r� r� )r0 r� r )r �prefixrc r r r �ipv6� s
zEUI.ipv6c C s
| � 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 �� i}| �� r$| j�� |d< t|�S )z�
A record dict containing IEEE registration details for this EUI
(MAC-48) if available, None otherwise.
r# ri )r: r^ r� rq r )r r> r r r �info� s zEUI.infoc C s | � |�}| j�| j|�S )a:
Format the EUI into the representational format according to the given
dialect
:param dialect: one of the :ref:`mac_formatting_dialects` defining the
formatting of EUI-48 (MAC) addresses.
:return: EUI in representational format according to the given dialect
)r� ry �
int_to_strr )r r~ Zvalidated_dialectr r r �format� s
z
EUI.formatc C s | j �| j| j�S )z':return: EUI in representational format)ry r� r rz r r r r rd � s z EUI.__str__c C s d| S )re z EUI('%s')r r r r r rf � s z EUI.__repr__)NN)N)N)+r r r r! r" r rK rN r� r� rg r� r� r� r� r~ r: r� r� rq r} r� r� rB rH rI r� r� r� r� r� r� r� r� r r� r� r� r� r� rd rf rh r r r? r rx O sd 2"� �
rx N)r! Z netaddr.corer r r Znetaddr.strategyr r r r� Znetaddr.strategy.eui48r Znetaddr.strategy.eui64r Z
netaddr.ipr Znetaddr.compatr
r r �objectr
r# ri rx r r r r �<module> s $