Ñò
î¡ßNc @ s' d Z d d k Z d d k Z d d k i Z d d k Z d d k
Z d d k Z
d d k l Z l Z l Z l Z l Z l Z d d k l Z l Z d d k l Z d d k l Z d d k l Z l Z d e! f d „ ƒ YZ" d
e" f d „ ƒ YZ# d e" f d
„ ƒ YZ$ d e" f d „ ƒ YZ% d S( s]
Classes and functions for dealing with MAC addresses, EUI-48, EUI-64, OUI, IAB
identifiers.
iÿÿÿÿN( t NotRegisteredErrort AddrFormatErrort AddrConversionErrort
Subscribert Publishert
DictDotLookup( t eui48t eui64( t mac_eui48( t IPAddress( t _is_intt _is_strt BaseIdentifierc B sJ e Z d Z d Z d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z RS( s$ Base class for all IEEE identifiers.t _valuec C s
d | _ d S( N( t NoneR
( t self( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt __init__ s c C s | i S( s) @return: integer value of this identifier( R
( R ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt __int__# s c C s | i S( s) @return: integer value of this identifier( R
( R ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt __long__' s c C s | i d j o d Sd | i S( s8 @return: octal string representation of this identifier.i t 0s 0%o( R
( R ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt __oct__+ s c C s d | i S( s> @return: hexadecimal string representation of this identifier.s 0x%x( R
( R ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt __hex__2 s c C s | i S( sx
@return: return the integer value of this identifier when passed to
hex(), oct() or bin().
( R
( R ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt __index__7 s ( s _value(
t __name__t
__module__t __doc__t __slots__R R R R R R ( ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyR s t OUIc B sS e Z d Z d Z d „ Z d „ Z e d „ ƒ Z d d „ Z d „ Z d „ Z
RS(
s
An individual IEEE OUI (Organisationally Unique Identifier).
For online details see - U{http://standards.ieee.org/regauth/oui/}
t recordsc C sN t t | ƒ i ƒ d d k l } g | _ t | t ƒ o" t | i d d ƒ d ƒ | _
n] t | ƒ o? d | j o
d j n o
| | _
qº t d | ƒ ‚ n t
d | ƒ ‚ | i
| i j om t | i ƒ } xM | i | i
D]; \ } } | i | ƒ | i | ƒ } | i | | | ƒ qí W| i ƒ n t d
| ƒ ‚ d S( sÓ
Constructor
@param oui: an OUI string C{XX-XX-XX} or an unsigned integer.
Also accepts and parses full MAC/EUI-48 address strings (but not
MAC/EUI-48 integers)!
iÿÿÿÿ( t ieeet -t i i iÿÿÿ s" OUI int outside expected range: %rs unexpected OUI format: %rs OUI %r not registered!N( t superR R t netaddr.euiR R t
isinstancet strt intt replaceR
R
t
ValueErrort TypeErrort OUI_INDEXt opent OUI_REGISTRYt seekt readt _parse_datat closeR ( R t ouiR t fht offsett sizet data( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyR I s& "
c C sè h d d 6d d 6d d 6g d 6| d 6| d 6} x¡ | i d ƒ D] } | i ƒ } | p q@ n d
| j o> | i | d } g } x9 t d ƒ D]+ } | d @} | i d | ƒ | d L} q Wd i t | ƒ ƒ i ƒ S( s* @return: string representation of this IABi i iÿ s %02xi R ( R
RB R; R: RC RD ( R RE RF RG RH ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyRI s
c C s d | S( s@ @return: executable Python string to recreate equivalent object.s IAB('%s')( ( R ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyRJ s ( s record( R R R R t staticmethodt FalseRT R R- RA RI RJ ( ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyRL « s 4
t EUIc B ss e Z d Z d! Z d" d" d „ Z d „ Z d „ Z e e e d" d ƒ Z d „ Z
d „ Z e e
e d" d ƒ Z e d
„ ƒ Z
e d „ ƒ Z d „ Z e d
„ ƒ Z e d „ ƒ Z d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z d „ Z d" d „ Z e d „ ƒ Z e d „ ƒ Z e d „ ƒ Z d „ Z d „ Z e d „ ƒ Z! d „ Z" d „ Z# RS(# s×
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.
t _modulet _dialectc C sW t t | ƒ i ƒ d | _ t | t ƒ oY | d j o# | | i i j o t d ƒ ‚ n | i | _ | i | _ | i | _ d S| d j oH | d j o
t
| _ qA| d j o
t | _ qAt d | ƒ ‚ nh t | ƒ oZ d | j o
d j n o
t
| _ qAd | j o
d j n o
t | _ qAn | | _
| | _ d S( s
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 explict EUI address version. Mainly
used to distinguish between 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.
s2 cannot switch EUI versions using copy constructor!Ni0 i@ s unsupported EUI version %ri l ÿÿÿ l ÿÿÿÿ ( R R\ R R R] R" t versionR& R
t dialectt _eui48t _eui64R
t value( R t addrR_ R` ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyR 0 s,
c C s | i S( N( R
( R ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt
_get_valuea s c C s“ | i d j oÓ x¨ t t f D]š } y | i | ƒ | _ | | _ PWq t j
oe yH d t | ƒ j o
| i j n o t | ƒ | _ | | _ Pn Wq· t j
o q· Xq Xq W| i d j o t d | ƒ ‚ qn t
| d ƒ oO y | i i | ƒ | _ Wqt j
o# t d | | i i f ƒ ‚ qXnN d t | ƒ j o | i i j n o t | ƒ | _ n t d | ƒ ‚ d S( Ni s failed to detect EUI version: %rRD s address %r is not an EUIv%ds bad address format: %r( R] R Ra Rb t
str_to_intR
R R$ t max_intR& t hasattrR_ ( R Rc t module( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt
_set_valued s6
' *sB a positive integer representing the value of this EUI indentifier.c C s | i S( N( R^ ( R ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt _get_dialect‰ s c C sW | d j o
t | _ n: t | d ƒ o t | d ƒ o
| | _ n
t d ƒ ‚ d S( Nt word_sizet word_fmts* custom dialects should subclass mac_eui48!( R R R^ Rh R' ( R Rc ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt _set_dialectŒ s
sX a Python class providing support for the interpretation of various MAC
address formats.c C sH | i t j o t | i d ?ƒ S| i t j o t | i d ?ƒ Sd S( s: The OUI (Organisationally Unique Identifier) for this EUI.i i( N( R] Ra R Rc Rb ( R ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyR/ ™ s c C s˜ | i t j o: d i g } | d d !D] } | d | q( ~ ƒ i ƒ S| i t j o: d i g } | d d !D] } | d | qr ~ ƒ i ƒ Sd S( s* The EI (Extension Identifier) for this EUIR i i s %02xi N( R] Ra R: RD Rb ( R t _[1]t it _[2]( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt ei¡ s :c C s d | i d ?j o d j SS( s< @return: True if this EUI is an IAB address, False otherwisei i iÿ/ ( R
( R ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt is_iab© s c C s# | i ƒ o t | i d ?ƒ Sd S( sq
If is_iab() is True, the IAB (Individual Address Block) is returned,
C{None} otherwise.
i N( Rs RL R
( R ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyRU s
c C s
| i i S( s/ The EUI version represented by this EUI object.( R] R_ ( R ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyR_ ¶ s c C sâ t | ƒ o] | i i } | | j o | d j n p t d ƒ ‚ n | i i | i | i ƒ | St | t ƒ oT | i i | i | i ƒ } g } t | i
t | ƒ ƒ Œ D] } | | | qµ ~ St d | ƒ ‚ d S( sú
@return: The integer value of the word referenced by index (both
positive and negative). Raises C{IndexError} if index is out
of bounds. Also supports Python list slices for accessing
word groups.
i s! index out range for address type!s unsupported type %r!N(
R
R^ t num_wordst
IndexErrorR] t int_to_wordsR
R" t sliceRB t indicesR> R' ( R R4 Rt RF Ro Rp ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt __getitem__» s
# 9c C s t | t ƒ o t d ƒ ‚ n t | ƒ p t d ƒ ‚ n d | j o | i i d j n p t d | ƒ ‚ n t | ƒ p t d ƒ ‚ n d | j o | i i j n p t d | | i i f ƒ ‚ n t
| i i | i
| i ƒ ƒ } | | | <| i i | ƒ | _
d S( s> Sets the value of the word referenced by index in this addresss" settable slices are not supported!s index not an integer!i i s' index %d outside address type boundary!s value not an integer!s. value %d outside word size maximum of %d bits!N( R" Rw t NotImplementedErrorR
R' R^ Rt Ru t max_wordRl t listR] Rv R
t words_to_int( R R4 Rc RF ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt __setitem__Î s
(
$!
c C s t | i | i f ƒ S( sA @return: hash of this EUI object suitable for dict keys, sets etc( t hashR_ R
( R ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt __hash__å s c C sA y& | i | i f | i | i f j SWn t j
o t SXd S( sw
@return: C{True} if this EUI object is numerically the same as other,
C{False} otherwise.
N( R_ R
t AttributeErrort NotImplemented( R t other( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt __eq__é s &c C sA y& | i | i f | i | i f j SWn t j
o t SXd S( s{
@return: C{False} if this EUI object is numerically the same as the
other, C{True} otherwise.
N( R_ R
R R‚ ( R Rƒ ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt __ne__ó s &c C sA y& | i | i f | i | i f j SWn t j
o t SXd S( s
@return: C{True} if this EUI object is numerically lower in value than
other, C{False} otherwise.
N( R_ R
R R‚ ( R Rƒ ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt __lt__ý s &c C sA y& | i | i f | i | i f j SWn t j
o t SXd S( s†
@return: C{True} if this EUI object is numerically lower or equal in
value to other, C{False} otherwise.
N( R_ R
R R‚ ( R Rƒ ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt __le__ s &c C sA y& | i | i f | i | i f j SWn t j
o t SXd S( s
@return: C{True} if this EUI object is numerically greater in value
than other, C{False} otherwise.
N( R_ R
R R‚ ( R Rƒ ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt __gt__ s &c C sA y& | i | i f | i | i f j SWn t j
o t SXd S( sˆ
@return: C{True} if this EUI object is numerically greater or equal in
value to other, C{False} otherwise.
N( R_ R
R R‚ ( R Rƒ ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt __ge__ s &c C s | i i | i | ƒ S( sÔ
@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( R] t int_to_bitsR
( R t word_sep( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt bits% s c C s | i i | i ƒ S( s8 The value of this EUI address as a packed binary string.( R] t
int_to_packedR
( R ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt packed- s c C s | i i | i ƒ S( s< A list of unsigned integer octets found in this EUI address.( R] Rv R
( R ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyRF 2 s c C s | i i | i ƒ S( sÜ
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.
( R] t
int_to_binR
( R ( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt bin7 s c
C s› | i d j ow g } | d d !D] } | d | q" ~ d d g g } | d d !D] } | d | qU ~ } | i d i | ƒ ƒ St t | ƒ ƒ Sd S(
sR
@return: The value of this EUI object as a new 64-bit EUI object.
- If this object represents an EUI-48 it is converted to EUI-64
as per the standard.
- If this object is already and EUI-64, it just returns a new,
numerically equivalent object is returned instead.
i0 i i s %02xt fft fei R N( R_ t __class__R: R\ R# ( R Ro Rp Rq t eui64_words( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyR @ s
3-c
C s° d } | i d j o€ g } | d d !D] } | d | q( ~ d d g g } | d d !D] } | d | q[ ~ } | t d i | ƒ d
ƒ 7} n | | i 7} t | d ƒ S( s'
@return: new link local IPv6 L{IPAddress} object based on this L{EUI}
using the technique described in RFC 4291. B{Please Note:} this
poses security risks in certain scenarios. Please read RFC 4941 for
details. Reference: RFCs 4291 and 4941.
l @þ i0 i i s %02xR‘ R’ i R i ( R_ R$ R: R
R ( R RE Ro Rp Rq t eui64_tokens( ( s8 /usr/lib/python2.6/site-packages/netaddr/eui/__init__.pyt ipv6_link_localP s 3-
c C sD h | i i ƒ d 6} | i ƒ o | i i ƒ | d s .$ky