D7net
Home
Console
Upload
information
Create File
Create Folder
About
Tools
:
/
lib
/
python3.9
/
site-packages
/
netaddr
/
eui
/
__pycache__
/
Filename :
__init__.cpython-39.pyc
back
Copy
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 $