3
cj @ sJ d dl Z d dlZd dlZd dlZd dlZd dlZd dlmZmZm Z m
Z
m Z m Z d dl
mZ d dlmZmZ d dlmZmZ ejeZdZdZdd d
d gZd d
dddddddddg Zej dfddZ dd Z dd d Z dd d Z dd!d"Z!d#d$ Z"d%d& Z#d'd( Z$d)d* Z%d+d, Z&d-d. Z'd/d0 Z(d1d2 Z)ej*dd3e+d4d5d6Z,ej*dd3e-d4d7d8Z.e/e+d9d:d;Z0ddd? Z2d@dA Z3de+d4dBdCZ4ddDdEZ5ddFdGZ6dHdI Z7dJdK Z8dLdM Z9dNdO Z:dPdQ Z;G dRdS dSe<Z=dTdU Z>e
e/ d4dVdWZ?e e/ d4dXdYZ@e
e/ d4dZd[ZAe e/ d4d\d]ZBe
e/ d4d^d_ZCe e/ d4d`daZDe
e/ d4dbdcZEe e/ d4dddeZFddfdgZGdhdi ZHddkdlZIddndoZJddpdqZKdrds ZLdtdu ZMeNd4dvdwZOe/e e/ dxdydzZPeNd4d{d|ZQeNd4d}d~ZReNd4ddZSeNd4ddZTde+e+e+e+e+e+e+e-dddZUed e
e e/e/e/e/f ddddZVdd ZWe e/ef e+dddZXee/dddZYe/e+dddZZe/e+dddZ[e/e+dddZ\e/e+dddZ]e/e+dddZ^e/e+dddZ_e+d4ddZ`e/d4ddZaebd4ddZcebd4ddZde/e/e/dddZeG dd defZgdS ) N)AnyCallableDictListOptionalTuple)urlparse)subputil)UrlErrorreadurlz/sys/class/net/Zeth0dhcp6Z
ipv6_slaaczipv6_dhcpv6-statelesszipv6_dhcpv6-statefulz ovs-vsctlz--formatZcsvz
--no-headingsz --timeoutZ10z --columnsnamefind interfacez
type=internalz([0-9]+)c C s dd t j|| D S )aD Sorting for Humans: natural sort order. Can be use as the key to sort
functions.
This will sort ['eth0', 'ens3', 'ens10', 'ens12', 'ens8', 'ens0'] as
['ens0', 'ens3', 'ens8', 'ens10', 'ens12', 'eth0'] instead of the simple
python way which will produce ['ens0', 'ens10', 'ens12', 'ens3', 'ens8',
'eth0'].c S s$ g | ] }|j rt|n|j qS )isdigitintlower).0textr r /usr/lib/python3.6/__init__.py
4 s z$natural_sort_key..)resplit)sZ_nsrer r r natural_sort_key, s r c C s t S )z3Simple function to return the global SYS_CLASS_NET.)
SYS_CLASS_NETr r r r get_sys_class_path9 s r c C s t | d | S )N/)r )devnamepathr r r sys_dev_path> s r# c
C s t | |}ytj|}W np ttfk
r } zPt|dd } | tjtjfkrZ|d k rZ||S | tj fkrv|d k rv||S W Y d d }~X nX |j
}|d kr|S y|| S t k
r } z&|d k r||S t j
d|| W Y d d }~X nX d S )Nerrnoz5Found unexpected (not translatable) value '%s' in '%s)r# r
Z load_fileOSErrorIOErrorgetattrr$ ENOENTENOTDIRZEINVALstripKeyErrorLOGdebug)
r! r" translate on_enoent on_keyerror on_einvalZdev_pathcontentseZe_errnor r r read_sys_netB s2
r4 c C s dd }t | |||||dS )Nc S s dS )NFr )r3 r r r
on_excp_falseh s z(read_sys_net_safe..on_excp_false)r0 r/ r1 r. )r4 )ifacefieldr. r5 r r r read_sys_net_safeg s r8 c C s8 t | |}|dkrd S yt|S tk
r2 d S X d S )NF)r8 r
ValueError)r6 r7 valr r r read_sys_net_intu s
r; c C s dddd}t | d|dS )NTF)upunknowndown operstate)r. )r8 )r! r. r r r is_up s r@ c C s t jjt| dS )Nbridge)osr" existsr# )r! r r r is_bridge s rD c C s t jjt| dS )Nbonding)rB r" rC r# )r! r r r is_bond s rF c C s t | dd}tjj|r |S dS )z8Return the master path for devname, or None if no mastermaster)r" N)r# rB r" rC )r! r" r r r
get_master s rH c C sH t | }|dkrdS tjj|d}tjj|d}tjj|pFtjj|S )z@Return a bool indicating if devname's master is a bridge or bondNFrE rA )rH rB r" joinrC )r! master_pathZ bonding_pathZ bridge_pathr r r master_is_bridge_or_bond s rK c C s, t | }|dkrdS t| dd}tjj|S )z;Return a bool indicating if devname's master is openvswitchNFzupper_ovs-system)r" )rH r# rB r" rC )r! rJ Zovs_pathr r r master_is_openvswitch s
rL c C s t | ddkS )Ntype32)r8 )r! r r r is_ib_interface s rO )maxsize)returnc C s t tjd} | s tjd | S )zDReturn a bool indicating if Open vSwitch is installed in the system.z ovs-vsctlz t jk
rP } z d|jkr>tjd g S W Y dd}~X n
X | j S dS )zReturn a list of the names of OVS internal interfaces on the system.
These will all be strings, and are used to exclude OVS-specific interface
from cloud-init's network configuration handling.
zdatabase connection failedzJOpen vSwitch is not yet up; no interfaces will be detected as OVS-internalN)r !OVS_INTERNAL_INTERFACE_LOOKUP_CMDZProcessExecutionErrorstderrr, info
splitlines)out_errexcr r r get_ovs_internal_interfaces s
r\ )r! rQ c C s, t s
dS t }| |kr(tjd| dS dS )zReturns True if this is an OVS internal interface.
If OVS is not installed or not yet running, this will return False.
Fz Detected %s as an OVS interfaceT)rT r\ r, r- )r! Z ovs_bridgesr r r !is_openvswitch_internal_interface s r] c C s, |dkrt | }t| |s$t| |r(dS dS )znetfailover driver uses 3 nics, master, primary and standby.
this returns True if the device is either the primary or standby
as these devices are to be ignored.
NTF)
device_driveris_netfail_primaryis_netfail_standby)r! driverr r r is_netfailover s rb c C s, d}yt | d}W n tk
r& Y nX |S )zDReturns a str from reading /sys/class/net//device/features.r zdevice/features)r4 Exception)r! featuresr r r get_dev_features s re c C s* t | }| st|dk r dS |d dkS )z Return True if VIRTIO_NET_F_STANDBY bit (62) is set.
https://github.com/torvalds/linux/blob/ 089cf7f6ecb266b6a4164919a2e69bd2f938374a/ include/uapi/linux/virtio_net.h#L60
@ F> 1)re len)r! rd r r r has_netfail_standby_feature s rj c C s< t | dk rdS |dkr t| }|dkr,dS t| s8dS dS )zA device is a "netfail master" device if:
- The device does NOT have the 'master' sysfs attribute
- The device driver is 'virtio_net'
- The device has the standby feature bit set
Return True if all of the above is True.
NF
virtio_netT)rH r^ rj )r! ra r r r is_netfail_master s rl c C st t | dd}tjj|s dS |dkr,t| }|dkr8dS tjjtjj|}t|}|dkr`dS t|}|spdS dS )a7 A device is a "netfail primary" device if:
- the device has a 'master' sysfs file
- the device driver is not 'virtio_net'
- the 'master' sysfs file points to device with virtio_net driver
- the 'master' device has the 'standby' feature bit set
Return True if all of the above is True.
rG )r" FNrk T)r# rB r" rC r^ basenamerealpathrj )r! ra Zmaster_sysfs_pathZmaster_devnameZ
master_driverZmaster_has_standbyr r r r_ s r_ c C s< t | dkrdS |dkr t| }|dkr,dS t| s8dS dS )zA device is a "netfail standby" device if:
- The device has a 'master' sysfs attribute
- The device driver is 'virtio_net'
- The device has the standby feature bit set
Return True if all of the above is True.
NFrk T)rH r^ rj )r! ra r r r r` : s r` c C s t | d}|r|dkrdS dS )a
/* interface name assignment types (sysfs name_assign_type attribute) */
#define NET_NAME_UNKNOWN 0 /* unknown origin (not exposed to user) */
#define NET_NAME_ENUM 1 /* enumerated by kernel */
#define NET_NAME_PREDICTABLE 2 /* predictably named by the kernel */
#define NET_NAME_USER 3 /* provided by user-space */
#define NET_NAME_RENAMED 4 /* renamed by user-space */
name_assign_type34TF)rp rq )r8 )r! ro r r r
is_renamedR s
rr c C s t t| d}d|j kS )Nueventz DEVTYPE=vlan)strr8 rX )r! rs r r r is_vlana s ru c C s0 d}t | d}tjj|r,tjjtj|}|S )z8Return the device driver for net device named 'devname'.Nz
device/driver)r# rB r" islinkrm readlink)r! ra Z driver_pathr r r r^ f s
r^ c C s t | d}|dkrdS |S )z;Return the device id string for net device named 'devname'.z
device/deviceFN)r8 )r! Zdev_idr r r device_devidq s
rx c C sj t j st j r tt j S ytjt } W n6 t k
rd } z|j
t
j krRg } n W Y d d }~X nX | S )N) r
is_FreeBSDis_DragonFlyBSDlistget_interfaces_by_macvaluesrB listdirr r% r$ r( )devsr3 r r r get_devicelistz s r c @ s e Zd ZdZdS ) ParserErrorz6Raised when a parser has issue parsing a file/content.N)__name__
__module__ __qualname____doc__r r r r r s r c C s$ | st | t rdS | jddkS )NFconfigZdisabled)
isinstancedictget)cfgr r r is_disabled_cfg s r c C s6 t j st j rt S t j s&t j r,t S t S dS )zqGet the list of network interfaces viable for networking.
@return List of interfaces, sorted naturally.
N)r
ry rz find_candidate_nics_on_freebsd is_NetBSD
is_OpenBSD(find_candidate_nics_on_netbsd_or_openbsd find_candidate_nics_on_linuxr r r r find_candidate_nics s
r c C s6 t j st j rt S t j s&t j r,t S t S dS )z.Get the name of the 'fallback' network device.N)r
ry rz find_fallback_nic_on_freebsdr r &find_fallback_nic_on_netbsd_or_openbsdfind_fallback_nic_on_linuxr r r r find_fallback_nic s
r c C s t t j tdS )zmGet the names of the candidate network devices on NetBSD/OpenBSD.
@return list of sorted interfaces
)key)sortedr| r} r r r r r r s r c C s t } | r| d S dS )zfGet the 'fallback' network device name on NetBSD/OpenBSD.
@return default interface, or None
r N)r )namesr r r r s r c C s8 t j ddddg\} }| j }|r&|S tt j tdS )zgGet the names of the candidate network devices on FreeBSD.
@return List of sorted interfaces.
ifconfigz-lz-uether)r )r r r r| r} r )stdoutZ_stderrr} r r r r s
r c C s t } | r| d S dS )z_Get the 'fallback' network device name on FreeBSD.
@return List of sorted interfaces.
r N)r )r r r r r s r c C s` dt j krtjd n.z4Found unstable nic names: %s; calling udevadm settlez!Waiting for udev events to settle)funcFT)filter_openvswitch_internal2filter_slave_if_master_not_bridge_bond_openvswitch filter_vlanfilter_without_own_macfilter_zero_maclog_filtered_reasonsr ZvethzIgnoring veth interface: %scarrierz Interface has no carrier: %sdormantr? r> lowerlayerdownr= zInterface ignored: %s)r r )r r> r r= )r
Z get_cmdliner, r- r ri Zlog_timeZudevadm_settleget_interfaces
startswithr; appendr8 r r DEFAULT_PRIMARY_INTERFACEremoveinsert) ZunstablemsgZ connectedZpossibly_connectedr _r r r? Zsorted_interfaces
interfacesr r r r s\
r c C s t } | r| d S dS )z]Get the 'fallback' network device name on Linux.
@return List of sorted interfaces.
r N)r )r r r r r ! s r c C sv | sd} t }|sdS t|r(d|i}ndt|dj i}dd||d}| rdt|}|rd||d d < ||id
d }|S ) zBGenerate network cfg v2 for dhcp on the NIC most likely connected.FNr
macaddressaddressT)Zdhcp4r
zset-namematchr ra ) ethernetsversion)r rl r8 r r^ )Z
config_driverZ target_namer r ra Znconfr r r generate_fallback_config- s$
r c C sJ dd }dd }| j d}|dkr*|| S |dkr:|| S td| d S ) Nc S s g }x| j di D ]|}|j ddkr&q|j d}|s6q|j d}|j di j d}|j di j d}|spt|}|s|t|}|j||||g qW |S ) Nr rM ZphysicalZ mac_addressr paramsra device_id)r r^ rx r )netcfgphysdevsentmacr ra r r r r
_version_1M s
z$extract_physdevs.._version_1c S s g }x| j di j D ]z}|j d}|s*q|j di j d}|sBq|j di j d}|j di j d}|srt|}|s~t|}|j||||g qW |S )Nr zset-namer r ra r )r r} r^ rx r )r r r r r ra r r r r
_version_2_ s
z$extract_physdevs.._version_2r r z"Unknown network config version: %s)r RuntimeError)r r r r r r r extract_physdevsL s
r Fc C s* t | d}|dkr"|r tddS |dkS ) a return True if the provided interface has its own address.
Based on addr_assign_type in /sys. Return true for any interface
that does not have a 'stolen' address. Examples of such devices
are bonds or vlans that inherit their mac from another device.
Possible values are:
0: permanent address 2: stolen from another device
1: randomly generated 3: set using dev_set_mac_addressZaddr_assign_typeNz%s had no addr_assign_type.Tr r )r r r )r; r9 )ifnamestrictZ assign_typer r r interface_has_own_mac| s
r Tc
C s i }x4t D ]*\}}}}d|||j |t|d||< q W | rtjd}tjdddddd d
gd d \}}tjdd
ddgd d \} }t }
x || fD ]} |
j|j| qW x,|j D ] } | d dkp| d |
k| d< qW |S )a Collect information necessary for rename_interfaces.
returns a dictionary by mac address like:
{name:
{
'downable': None or boolean indicating that the
device has only automatically assigned ip addrs.
'device_id': Device id value (if it has one)
'driver': Device driver (if it has one)
'mac': mac address (in lower case)
'name': name
'up': boolean: is_up(name)
}}
N)downabler ra r r r< z[0-9]+:\s+(\w+)[@:]ipz-6ZaddrZshowZ permanentZscopeglobalT)capturez-4r< Fr r )
r r r@ r compiler setupdatefindallr} )
Zcheck_downablecur_infor r ra r ZnmatchZipv6rZ Zipv4Znics_with_addressesZ bytes_outdr r r _get_current_rename_info s(
r c s t | stjd d S |d kr$t }i xF|j D ]:\}}|j }|jdr\|d j |d< ||d< | |< q2W tjd fdd}dd }d d
} d d }
g } g } g }
| }d
}d"}dd fdd}x| D ]\}}}}|r|j }g }||||}|s"|r| jd||f q|jd}||kr8q|sV|r| jd||f q|d rd}|d s|r| j||||f qd|d< |jd|||ff |
jd|||ff ||kr|| }|d rd}|d s|r| j||||f qn|jd|||ff d }x*|d ks,||kr@|d7 }|| }qW |jd||||ff ||d< | }|d r|
jd|||ff |jd|||d |ff ||d< | }| |7 } qW || |
d}t | t |
d krt | rtjd | n tjd | n~tjd | | |
xj| |
D ]^\} }}} y|j| | W n< t k
rz } z | jd | | ||| f W Y d d } ~ X nX q W t | rt
d!j | d S )#Nzno interfaces to renamer r zDetected interfaces %sc s t dd j D S )Nc s s | ]}|d |fV qdS )r Nr )r datar r r s z<_rename_interfaces..update_byname..)r r} )Zbymac)r r r
update_byname s z)_rename_interfaces..update_bynamec S s t j ddd| d|gdd d S )Nr linkr r T)r )r )curnewr r r rename s z"_rename_interfaces..renamec S s t j ddd| dgdd d S )Nr r r r> T)r )r )r r r r r> s z _rename_interfaces..downc S s t j ddd| dgdd d S )Nr r r r< T)r )r )r r r r r< s z _rename_interfaces..upz
cirename%dr c S sd |r0|r0|r0| d |ko.| d |ko.| d |kS |rP|rP| d |koN| d |kS |r`| d |kS dS )zmatch if set and in datar ra r Fr )r r ra r r r r entry_match s z'_rename_interfaces..entry_matchc sT fddj D }t|rPt|dkrHd| f }t||d S d S )Nc s g | ]}| r|qS r r )r r )r ra r r r r r s z:_rename_interfaces..find_entry..r zjFailed to match a single device. Matched devices "%s" with search values "(mac:%s driver:%s device_id:%s)"r )r} ri r9 )r ra r r r )r r )r ra r r
find_entry s z&_rename_interfaces..find_entryz<[nic not present] Cannot rename mac=%s to %s, not available.r< z*[busy] Error renaming mac=%s from %s to %sr Fr> z2[busy-target] Error renaming mac=%s from %s to %s.r )r r> r< r z(unable to do any work for renaming of %sz$no work necessary for renaming of %sz$achieving renaming of %s with ops %sz.[unknown] Error performing %s%s for %s, %s: %s
) ri r, r- r itemscopyr r r rc r rI ) renamesZstrict_presentZ strict_busyZ current_infor r r r r r> r< ZopserrorsZupsZ
cur_bynameZ tmpname_fmtZtmpir r new_namera r Zcur_opsZcur_namer targetZtmp_nameZopmapopr r3 r )r r r _rename_interfaces s
*
r c C s$ d}t jjt| drd}t| |S )z6Returns the string value of an interface's MAC Addressr Z
bonding_slavezbonding_slave/perm_hwaddr)rB r" isdirr# r8 )r r" r r r get_interface_mac] s r c C s> t | ddkr:t| }|r6|r6|dd |dd }|S dS )zReturns the string value of an Infiniband interface's hardware
address. If ethernet_format is True, an Ethernet MAC-style 6 byte
representation of the address will be returned.
rM rN $ 3 Ni)r8 r )r Zethernet_formatr r r r get_ib_interface_hwaddrg s
r c C s< t j st j rt S t j r$t S t j r2t S t S d S )N) r
ry rz get_interfaces_by_mac_on_freebsdr get_interfaces_by_mac_on_netbsdr get_interfaces_by_mac_on_openbsd get_interfaces_by_mac_on_linuxr r r r r| u s r| )r rQ c C s0 x*t j D ] \}}| j |j kr |S q W d S )N)r| r r )r Z
interface_macZinterface_namer r r find_interface_name_from_mac s r c C s> t j dddg\} }dd }dd }dd ||| D }|S )
Nr z-ar c s sD d}x4| j dD ]&}|jdr(||7 }q|r2|V |}qW |V d S )Nr r )r r )rY Z
curr_blockliner r r flatten s
z1get_interfaces_by_mac_on_freebsd..flattenc s s8 x2| D ]*}t jd|}|r|jd|jdfV qW d S )Nz2^(?P\S*): .*ether\s(?P[\da-f:]{17}).*r r )r searchgroup)Z flat_listblockmr r r find_mac s
z2get_interfaces_by_mac_on_freebsd..find_macc S s i | ]\}}||qS r r )r r r r r r
s z4get_interfaces_by_mac_on_freebsd..)r )rY r r r resultsr r r r s
r c C sf i } d}t j ddg\}}tjdd|j }x4|D ],}tj||}|r2|j }|d | |d < q2W | S )NzE(?P\w+).*address:\s(?P([\da-f]{2}[:-]){5}([\da-f]{2})).*r z-az\n\s+ r r )r r subrX r groupdict)rS re_field_matchrY r if_linesr r fieldsr r r r s
r c C sf i } d}t j ddg\}}tjdd|j }x4|D ],}tj||}|r2|j }|d | |d < q2W | S )NzC(?P\w+).*lladdr\s(?P([\da-f]{2}[:-]){5}([\da-f]{2})).*r z-az\n\s+r r r )r r r rX r r )rS r rY r r r r r r r r r s
r c C s i } xt D ]\}}}}|| krX|dkr>tjd|| | | q d|| | |f }t||| |< t|d}|r || kr|| |< q tjd|| | | q W | S ) zmBuild a dictionary of tuples {mac: name}.
Bridges and any devices that have a 'stolen' mac are excluded. fsl_enetc
mscc_felixqmi_wwanz>Ignoring duplicate macs from '%s' and '%s' due to driver '%s'.z6duplicate mac found! both '%s' and '%s' have mac '%s'.Tz^Ethernet and InfiniBand interfaces have the same address both '%s' and '%s' have address '%s'.)r r r )r r, r- r r warning)rS r r ra Z_devidr ib_macr r r r s4
r ) filter_hyperv_vf_with_syntheticr r r r r r rQ c C s0 |r
t jndd }g }t } djd
}
x| D ]} |r@t| r@q,t| rT|d| q,|rbt| rbq,t| rv|d| q,|rt| dk rt | rt
| rq,t | r|d | q,t | } | s|d
| q,|r| d kr| |
dt
| krq,|ot| rq,t| }
|j| | |
t| f q,W | r,t|| |S )zReturn list of interface tuples (name, mac, driver, device_id)
Bridges and any devices that have a 'stolen' mac are excluded.c W s d S )Nr )argsr r r s z get_interfaces..:00 z Ignoring bridge interface: %szIgnoring bond interface: %sNz Ignoring failover interface: %sz"Ignoring interface without mac: %sr )r )r r r r r r r r r r r r r r r r )r, r- r rI r rD ru rF rH rK rL rb r ri r] r^ r rx )filter_hyperv_vf_with_synthetic_interface)r r r r r r r filtered_loggerrS r Zzero_macr r ra r r r r
sJ
r .)r r rQ c s\ dd |D fdd|D }x6|D ].}|\}}}}| d|| | | |j | q&W dS )a Filter Hyper-V SR-IOV/VFs when used with synthetic hv_netvsc.
Hyper-V's netvsc driver may register an SR-IOV/VF interface with a mac
that matches the synthetic (hv_netvsc) interface. This VF will be
enslaved to the synthetic interface, but cloud-init may be racing this
process. The [perhaps-yet-to-be-enslaved] VF should never be directly
configured, so we filter interfaces that duplicate any hv_netvsc mac
address, as this the most reliable indicator that it is meant to be
subordinate to the synthetic interface.
VF drivers will be mlx4_core, mlx5_core, or mana. However, given that
this list of drivers has changed over time and mana's dependency on
hv_netvsc is expected to be removed in the future, we no longer rely
on these names. Note that this will not affect mlx4/5 instances outside
of Hyper-V, as it only affects environments where hv_netvsc is present.
c S s& i | ] }|d dkr|d |d qS )r hv_netvscr r r )r ir r r r Z s z=filter_hyperv_vf_with_synthetic_interface..c s( g | ] }|d kr|d dkr|qS )r r r r )r r
)hv_netvsc_mac_to_namer r r ^ s z=filter_hyperv_vf_with_synthetic_interface..zdIgnoring %r VF interface with driver %r due to synthetic hv_netvsc interface %r with mac address %r.N)r )r r Zinterfaces_to_remover r r ra r r )r r r
F s
r
c C sT i } xJt D ]@\}}}}t|d}|r || krDtd|| | |f || |< q W | S )zTBuild a dictionary mapping Infiniband interface names to their hardware
address.Fz5duplicate mac found! both '%s' and '%s' have mac '%s')r r r )rS r r r r r r get_ib_hwaddrs_by_interfacep s
r )url_datarQ c C s d| krt jd| dS | d }y6t|}t|jdk|jdkgsTt jd|j dS W n, tk
r } zt jd| dS d}~X nX d | krd
| d < ytf | W n tk
r dS X d S ) aD Return true when the instance has access to the provided URL.
Logs a warning if url is not the expected format.
url_data is a dictionary of kwargs to send to readurl. E.g.:
has_url_connectivity({
"url": "http://example.invalid",
"headers": {"some": "header"},
"timeout": 10
})
urlz4Ignoring connectivity check. No 'url' to check in %sFZhttpZhttpsz2Ignoring connectivity check. Invalid URL scheme %sz+Ignoring connectivity check. Invalid URL %sNZtimeout T)r, r r anyschemer9 r r )r r resulterrr r r has_url_connectivity s,
r )convert_to_addressr c K s& y | |f|S t k
r dS X dS )a Use a function to return an address. If conversion throws a ValueError
exception return False.
:param check_cb:
Test function, must return a truthy value
:param address:
The string to test.
:return:
Address or False
FN)r9 )r r kwargsr r r maybe_get_address s
r )r rQ c C s t ttj| S )zReturns a bool indicating if ``s`` is an IP address.
:param address:
The string to test.
:return:
A bool indicating if the string is an IP address or not.
)rR r ipaddress
ip_address)r r r r
is_ip_address s r c C s t ttj| S )zReturns a bool indicating if ``s`` is an IPv4 address.
:param address:
The string to test.
:return:
A bool indicating if the string is an IPv4 address or not.
)rR r r Z IPv4Address)r r r r is_ipv4_address s r c C s t ttj| S )zReturns a bool indicating if ``s`` is an IPv6 address.
:param address:
The string to test.
:return:
A bool indicating if the string is an IPv4 address or not.
)rR r r Z IPv6Address)r r r r is_ipv6_address s r c C s t ttj| ddS )zReturns a bool indicating if ``s`` is an IPv4 or IPv6 network.
:param address:
The string to test.
:return:
A bool indicating if the string is an IPv4 address or not.
F)r )rR r r
ip_network)r r r r
is_ip_network s r! c C s t ttj| ddS )zReturns a bool indicating if ``s`` is an IPv4 network.
:param address:
The string to test.
:return:
A bool indicating if the string is an IPv4 address or not.
F)r )rR r r IPv4Network)r r r r is_ipv4_network s r# c C s t ttj| ddS )zReturns a bool indicating if ``s`` is an IPv6 network.
:param address:
The string to test.
:return:
A bool indicating if the string is an IPv4 address or not.
F)r )rR r r Z IPv6Network)r r r r is_ipv6_network s r$ c C s@ | d j ds| d tkr dS | d dkr "255.255.255.0"
Also supports input as a string.z0.0.0.0/)rt r r" netmask)prefixr r r net_prefix_to_ipv4_mask s r+ c C s t jd| jS )a Convert an ipv4 netmask into a network prefix length.
If the input is already an integer or a string representation of
an integer, then int(mask) will be returned.
"255.255.255.0" => 24
str(24) => 24
"24" => 24
z0.0.0.0/)r r prefixlen)maskr r r ipv4_mask_to_net_prefix s r. c
C s yt jd| j}|S tk
r* Y nX t j| }t|}|dkrJ|S tt j| |d @ j }||? }t j| }d|> d }||krtd| |S )zConvert an ipv6 netmask (very uncommon) or prefix (64) to prefix.
If the input is already an integer or a string representation of
an integer, then int(mask) will be returned.
"ffff:ffff:ffff::" => 48
"48" => 48
z::/r r zInvalid network mask '%s') r r r, r9 r r minZ
IPV6LENGTH
bit_length)r- r, r) Zmask_intZtrailing_zeroesZ leading_onesZall_onesr r r ipv6_mask_to_net_prefix) s"
r1 )r- r rQ c C s t tj| d| ddjS )zCGet string representation of broadcast address from an ip/mask pairr F)r )rt r r" Zbroadcast_address)r- r r r r mask_and_ipv4_to_bcast_addrL s r2 c @ s e Zd ZdS )RendererNotFoundErrorN)r r r r r r r r3 S s r3 )r )NNNN)N)N)N)N)N)N)F)T)TTN)TTTTTTF).N)hr$ functoolsr ZloggingrB r Ztypingr r r r r r Z urllib.parser Z cloudinitr r
Zcloudinit.url_helperr r Z getLoggerr r, r r r' rU r r r r# r4 r8 r; r@ rD rF rH rK rL rO lru_cacherR rT r{ r\ rt r] rb re rj rl r_ r` rr ru r^ rx r rc r r r r r r r r r r r r r r r r r r r| r r r r r r r
r r r r r r r! r# r$ r( r+ r r. r1 r2 r r3 r r r r s
!
I
0
/
H 5'' #