관리-도구
편집 파일: __init__.cpython-39.pyc
a '�Dg�� � @ s6 d dl Z d dlZd dlZd dlZd dlZd dlZd dlmZmZm Z m Z m Z d dl m Z mZ d dlmZ e�e�ZdZdZg d�Zg d�Ze�d �fd d �Zd d � Zd�dd�Zd�dd�Z d�dd�Z dd� Z dd� Z dd� Z dd � Z!d d � Z"d d � Z#d!d"� Z$d#d$� Z%ej&dd%�e'd&�d'd(��Z(ej&dd%�e)d&�d)d*��Z*e+e'd+�d,d-�Z,d�d.d/�Z-d0d1� Z.d2d3� Z/d�e'd&�d4d5�Z0d�d6d7�Z1d�d8d9�Z2d:d;� Z3d<d=� Z4d>d?� Z5d@dA� Z6dBdC� Z7G dDdE� dEe8�Z9dFdG� Z:e e+ d&�dHdI�Z;e e+ d&�dJdK�Z<e e+ d&�dLdM�Z=e e+ d&�dNdO�Z>e e+ d&�dPdQ�Z?e e+ d&�dRdS�Z@e e+ d&�dTdU�ZAe e+ d&�dVdW�ZBd�e eC d&�dXdY�ZDdZd[� ZEd�d]d^�ZFd�d`da�ZGd�dbdc�ZHddde� ZIdfdg� ZJeCd&�dhdi�ZKe+e e+ dj�dkdl�ZLeCd&�dmdn�ZMeCd&�dodp�ZNeCd&�dqdr�ZOeCd&�dsdt�ZPd�e'e'e'e'e'e'e'e)du�dvdw�ZQedx e e e+e+e+e+f ddy�dzd{�ZRd|d}� ZSee+d~�dd��ZTe+e'd��d�d��ZUe+e'd��d�d��ZVe+e'd��d�d��ZWe+e'd��d�d��ZXe+e'd��d�d��ZYe+e'd��d�d��ZZe+e+e'd��d�d��Z[e+e+e'd��d�d��Z\e'd&�d�d��Z]e+d&�d�d��Z^e_d&�d�d��Z`e_d&�d�d��Zae+e+e+d��d�d��ZbG d�d�� d�ec�ZddS )�� N)�Callable�Dict�List�Optional�Tuple)�subp�util)�Iproute2z/sys/class/net/Zeth0)�dhcp6Z ipv6_slaaczipv6_dhcpv6-statelesszipv6_dhcpv6-stateful) � ovs-vsctlz--formatZcsvz --no-headingsz --timeoutZ10z --columns�name�find� interfacez type=internalz([0-9]+)c C s dd� t �|| �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 | ] }|� � rt|�n|�� �qS � )�isdigit�int�lower)�.0�textr r �:/usr/lib/python3.9/site-packages/cloudinit/net/__init__.py� <listcomp>2 s �z$natural_sort_key.<locals>.<listcomp>)�re�split)�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_path8 s r � c C s t � | d | S )N�/)r ��devname�pathr r r � sys_dev_path= s r" c C s t | |�}zt�|�}W n� ttfy� } znt|dd �} | tjtjfv rd|d urd||�W Y d }~S | tj fv r�|d ur�||�W Y d }~S � W Y d }~n d }~0 0 |� � }|d u r�|S z || W S t �y } z8|d ur�||�W Y d }~S t � d||� � W Y d }~n d }~0 0 d S )N�errnoz5Found unexpected (not translatable) value '%s' in '%s)r" r Zload_text_file�OSError�IOError�getattrr# �ENOENT�ENOTDIR�EINVAL�strip�KeyError�LOG�debug) r r! � translate� on_enoent� on_keyerror� on_einvalZdev_path�contents�eZe_errnor r r � read_sys_netA s4 �r4 c C s dd� }t | |||||d�S )Nc S s dS �NFr )r3 r r r � on_excp_falseg s z(read_sys_net_safe.<locals>.on_excp_false)r0 r/ r1 r. )r4 )�iface�fieldr. r6 r r r �read_sys_net_safef s �r9 c C s: t | |�}|du rd S z t|�W S ty4 Y d S 0 d S r5 )r9 r � ValueError)r7 r8 �valr r r �read_sys_net_intt s r< c C s dddd�}t | d|d�S )NTF)�up�unknown�down� operstate)r. �r9 )r r. r r r �is_up~ s rB c C s t j�t| d��S )N�bridge��osr! �existsr" �r r r r � is_bridge� s rH c C s t j�t| d��S )N�bondingrD rG r r r �is_bond� s rJ c C s t | dd�}tj�|�r |S dS )z8Return the master path for devname, or None if no master�master�r! N)r" rE r! rF r r r r � get_master� s rM c C sH t | �}|du rdS tj�|d�}tj�|d�}tj�|�pFtj�|�S )z@Return a bool indicating if devname's master is a bridge or bondNFrI rC )rM rE r! �joinrF )r � master_pathZ bonding_pathZ bridge_pathr r r �master_is_bridge_or_bond� s rP c C s, t | �}|du rdS t| dd�}tj�|�S )z;Return a bool indicating if devname's master is openvswitchNFzupper_ovs-systemrL )rM r" rE r! rF )r rO Zovs_pathr r r �master_is_openvswitch� s rQ c C s t | d�dkS )N�type�32rA rG r r r �is_ib_interface� s rT )�maxsize)�returnc C s t t�d��} | s t�d� | S )zDReturn a bool indicating if Open vSwitch is installed in the system.r z<ovs-vsctl not in PATH; not detecting Open vSwitch interfaces)�boolr �whichr, r- )�retr r r �openvswitch_is_installed� s �rZ c C sl zt � t�\} }W nL t jy^ } z2d|jv rHt�d� g W Y d}~S � W Y d}~nd}~0 0 | �� S dS )z�Return 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_CMDZProcessExecutionError�stderrr, �info� splitlines)�out�_err�excr r r �get_ovs_internal_interfaces� s �rb )r rV c C s, t � s dS t� }| |v r(t�d| � dS dS )z�Returns 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)rZ rb r, r- )r Z ovs_bridgesr r r �!is_openvswitch_internal_interface� s rc c C s, |du rt | �}t| |�s$t| |�r(dS dS )z�netfailover 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_driver�is_netfail_primary�is_netfail_standby�r �driverr r r �is_netfailover� s �ri c C s* d}zt | d�}W n ty$ Y n0 |S )zDReturns a str from reading /sys/class/net/<devname>/device/features.r zdevice/features)r4 � Exception�r Zfeaturesr r r �get_dev_features� s rl c C s( t | �}|rt|�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)rl �lenrk r r r �has_netfail_standby_feature� s rq c C s< t | �durdS |du r t| �}|dkr,dS t| �s8dS dS )z�A 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�rM rd rq rg r r r �is_netfail_master s rt c C st t | dd�}tj�|�s dS |du r,t| �}|dkr8dS tj�tj�|��}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. rK rL FNrr T)r" rE r! rF rd �basename�realpathrq )r rh Zmaster_sysfs_pathZmaster_devnameZ master_driverZmaster_has_standbyr r r re s re c C s< t | �du rdS |du r t| �}|dkr,dS t| �s8dS dS )z�A 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. NFrr Trs rg r r r rf 9 s rf c C s t | d�}|r|dv rdS 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_type)�3�4TFrA )r rw r r r � is_renamedQ s rz c C s t t| d��}d|�� v S )N�ueventz DEVTYPE=vlan)�strr9 r^ )r r{ r r r �is_vlan` s r} c C s0 d}t | d�}tj�|�r,tj�t�|��}|S )z8Return the device driver for net device named 'devname'.Nz device/driver)r" rE r! �islinkru �readlink)r rh Z driver_pathr r r rd e s rd c C s t | d�}|du rdS |S )z;Return the device id string for net device named 'devname'.z device/deviceFNrA )r Zdev_idr r r � device_devidp s r� c C sl t �� st �� r tt� �� �S zt�t� �} W n8 t yf } z |j t j krPg } n� W Y d }~n d }~0 0 | S �N) r � is_FreeBSD�is_DragonFlyBSD�list�get_interfaces_by_mac�valuesrE �listdirr r$ r# r' )�devsr3 r r r �get_devicelisty 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 | rt | t�sdS | �d�dkS )NF�configZdisabled)� isinstance�dict�get)�cfgr r r �is_disabled_cfg� s r� c C s6 t �� st �� rt� S t �� s&t �� r,t� S t� S dS )zqGet the list of network interfaces viable for networking. @return List of interfaces, sorted naturally. N)r r� r� � 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 �� st �� rt� S t �� s&t �� r,t� S t� S dS )z.Get the name of the 'fallback' network device.N)r r� r� � find_fallback_nic_on_freebsdr� r� �&find_fallback_nic_on_netbsd_or_openbsd�find_fallback_nic_on_linuxr r r r �find_fallback_nic� s r� c C s t t� �� td�S )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 s4 t � g d��\} }| �� }|r"|S tt� �� td�S )zgGet the names of the candidate network devices on FreeBSD. @return List of sorted interfaces. )�ifconfigz-lz-u�etherr� )r r r� r� r� r )�stdout�_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 sF dt �� v rt�d� n,dd� t� D �} t| �rDt�d| � t �� g }g }tddddddd�D ]�\}}}}|d krvq`|�d �r�t�d |� q`t |d �}|r�|� |� q`t�d |� t |d�}|r�|� |� q`t |d�}|dv r�|� |� q`t�d|� q`g }||fD ]:} t | t d�} t| v �r6| �t� | �dt� || 7 }�q|S )zeGet the names of the candidate network devices on Linux. @return List of sorted interfaces. z net.ifnames=0z9Stable ifnames disabled by net.ifnames=0 in /proc/cmdlinec S s g | ]}|d krt |�s|�qS )�lo)rz )r Zdevicer r r r � s �z0find_candidate_nics_on_linux.<locals>.<listcomp>z4Found unstable nic names: %s; calling udevadm settleFT)�filter_openvswitch_internal�2filter_slave_if_master_not_bridge_bond_openvswitch� filter_vlan�filter_without_own_mac�filter_zero_mac�log_filtered_reasonsr� ZvethzIgnoring veth interface: %s�carrierz Interface has no carrier: %s�dormantr@ )r� r? Zlowerlayerdownr> zInterface ignored: %sr� r )r Z get_cmdliner, r- r� rp Zudevadm_settle�get_interfaces� startswithr< �appendr9 r� r �DEFAULT_PRIMARY_INTERFACE�remove�insert) ZunstableZ 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 sj t � }|sdS t|�r d|i}ndt|d��� i}| rJt|�}|rJ||d< dd||d�}||idd �}|S ) zBGenerate network cfg v2 for dhcp on the NIC most likely connected.Nr � macaddress�addressrh T)Zdhcp4r �set-name�match� )� ethernets�version)r� rt r9 r rd )Z config_driverZ target_namer� rh r� Znconfr r r �generate_fallback_config+ s$ ��r� c C sJ dd� }dd� }| � d�}|dkr*|| �S |dkr:|| �S td| ��d S ) Nc S s� g }| � di �D ]|}|� d�dkr$q|� d�}|s4q|� d�}|� di �� d�}|� di �� d�}|snt|�}|szt|�}|�||||g� q|S ) Nr� rR ZphysicalZ mac_addressr �paramsrh � device_id)r� rd r� r� )�netcfg�physdevs�ent�macr rh r� r r r � _version_1I s z$extract_physdevs.<locals>._version_1c S s� g }| � di ��� D ]z}|� d�}|s(q|� di �� d�}|s@q|� di �� d�}|� di �� d�}|spt|�}|s|t|�}|�||||g� q|S )Nr� r� r� r� rh r� )r� r� rd r� r� )r� r� r� r r� rh r� r r r � _version_2[ s z$extract_physdevs.<locals>._version_2r� � r� z"Unknown network config version: %s)r� � RuntimeError)r� r� r� r� r r r �extract_physdevsH s r� Fc C s* t | d�}|du r"|r td��dS |dv S )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.T)r r� � )r< r: )�ifname�strictZ assign_typer r r �interface_has_own_macx s r� Tc C s� i }t � D ]*\}}}}d|||�� |t|�d�||< q | r�t�d�}tjg d�dd�\}}tjg d�dd�\} }t� } || fD ]} | �|�| �� q~|� � D ] } | d d u p�| d | v| d < q�|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� rh r� r r= z[0-9]+:\s+(\w+)[@:])�ipz-6�addr�showZ permanentZscope�globalT)Zcapture)r� z-4r� r� r= Fr r� ) r� r rB r �compiler �set�update�findallr� ) Zcheck_downable�cur_infor r� rh r� ZnmatchZipv6r` Zipv4Znics_with_addressesZ bytes_out�dr r r �_get_current_rename_info� s. � � �r� c sv t | �st�d� d S |d u r$t� }i � |�� D ]:\}}|�� }|�d�rZ|d �� |d< ||d< |� |< q0t�d� � dd� }g }g } g } |� �} d} d} d d � �� �fd d �}| D �]�\}}}}|r�|�� }g }||||�}|s�|r�| �d ||f � q�|�d�}||k�rq�|�s0|r�| �d ||f � q�|d �r�d}|d �sb|r�| �||||f � q�d|d< |�d|||ff� | �d|||ff� || v �r\| | }|d �r�d}|d �s�|r�| �||||f � q�n|�d|||ff� d }|d u �s|| v �r| d7 } | | }�q�|�d||||ff� ||d< |� �} |d �r\| �d|||ff� |�d|||d |ff� ||d< |� �} ||7 }q�t j t j t j d�}t |�t | � dk�r�t | ��r�t� d| | � n t�d| � nzt�d| || � || D ]^\}}}}z|| |� W n> t�yT } z$| �d|||||f � W Y d }~n d }~0 0 �q�t | ��rrtd �| ���d S ) Nzno interfaces to renamer� r zDetected interfaces %sc S s t dd� | �� D ��S )Nc s s | ]}|d |fV qdS )r Nr �r �datar r r � <genexpr>� � z<_rename_interfaces.<locals>.update_byname.<locals>.<genexpr>)r� r� )Zbymacr r r � update_byname� s z)_rename_interfaces.<locals>.update_bynamez cirename%d���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� rh r� Fr )r� r� rh r� r r r � entry_match� s � � z'_rename_interfaces.<locals>.entry_matchc sT � ���fdd��� � D �}t|�rPt|�dkrHd|��� f }t|��|d S d S )Nc s g | ]}�|��� �r|�qS r r r� )r� rh r� r� r r r � s �z:_rename_interfaces.<locals>.find_entry.<locals>.<listcomp>r� zjFailed to match a single device. Matched devices "%s" with search values "(mac:%s driver:%s device_id:%s)"r )r� rp r: )r� rh r� r� �msg�r� r� )r� rh r� r � find_entry� s � ��z&_rename_interfaces.<locals>.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� �rename)r� r? r= r z1Unable to rename interfaces: %s due to errors: %sz$no work necessary for renaming of %szRenamed %s with ops %sz.[unknown] Error performing %s%s for %s, %s: %s� )rp r, r- r� �items�copyr� r r� r Z link_renameZ link_downZlink_up�warningrj r� rN ) �renamesZstrict_presentZ strict_busyZ current_infor r� Zcurr� �ops�errorsZupsZ cur_bynameZ tmpname_fmtZtmpir� r� �new_namerh r� Zcur_opsZcur_namer� �targetZtmp_nameZopmap�opr� r3 r r� r �_rename_interfaces� s� �� �� � � �� r� c C s$ d}t j�t| d��rd}t| |�S )z6Returns the string value of an interface's MAC Addressr� Z bonding_slavezbonding_slave/perm_hwaddr)rE r! �isdirr" r9 )r� r! r r r �get_interface_macX s r� c C s> t | d�dkr:t| �}|r6|r6|dd� |dd� }|S dS )z�Returns 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. rR rS �$ i��3 N)r9 r� )r� Zethernet_formatr� r r r �get_ib_interface_hwaddrb s r� c C s< t �� st �� rt� S t �� r$t� S t �� r2t� S t� S d S r� ) r r� r� � 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� p s r� )r� rV c C s0 t � �� D ] \}}| �� |�� kr | S q d S r� )r� r� r )r� Z interface_macZinterface_namer r r � find_interface_name_from_mac{ s r� c C s< t � g d��\} }dd� }dd� }dd� ||| ��D �}|S )N)r� �-ar� c s s@ d}| � d�D ]&}|�d�r&||7 }q|r0|V |}q|V d S )Nr r� � )r r� )r_ Z curr_block�liner r r �flatten� s z1get_interfaces_by_mac_on_freebsd.<locals>.flattenc s s4 | D ]*}t �d|�}|r|�d�|�d�fV qd S )Nz2^(?P<ifname>\S*): .*ether\s(?P<mac>[\da-f:]{17}).*r� r� )r �search�group)Z flat_list�block�mr r r �find_mac� s �z2get_interfaces_by_mac_on_freebsd.<locals>.find_macc S s i | ]\}}||�qS r r )r r� r� r r r � <dictcomp>� r� z4get_interfaces_by_mac_on_freebsd.<locals>.<dictcomp>)r )r_ r� r� r �resultsr r r r� � s r� c C sb i } d}t � ddg�\}}t�dd|��� }|D ],}t�||�}|r0|�� }|d | |d < q0| S )NzE(?P<ifname>\w+).*address:\s(?P<mac>([\da-f]{2}[:-]){5}([\da-f]{2})).*r� r� �\n\s+� r� r� �r r �subr^ r� � groupdict�rY Zre_field_matchr_ r� Zif_linesr� r �fieldsr r r r� � s � r� c C sb i } d}t � ddg�\}}t�dd|��� }|D ],}t�||�}|r0|�� }|d | |d < q0| S )NzC(?P<ifname>\w+).*lladdr\s(?P<mac>([\da-f]{2}[:-]){5}([\da-f]{2})).*r� r� r r r� r� r r r r r r� � s � r� c C s� i } t � D ]�\}}}}|| v rV|dv r<t�d|| | |� q d|| | |f }t|��|| |< t|d�}|r || vr~|| |< q t�d|| | |� q | S )zmBuild a dictionary of tuples {mac: name}. Bridges and any devices that have a 'stolen' mac are excluded.)Z fsl_enetcZ mscc_felixZqmi_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� )rY r r� rh Z_devidr� �ib_macr r r r� � s: �� �r� )� filter_hyperv_vf_with_syntheticr� r� r� r� r� r� rV c C s$ |r t jndd� }g }t� } d�d�} | D ]�} |r<t| �s<q*t| �rP|d| � q*|r^t| �r^q*t| �rr|d| � q*|r�t| �dur�t | �s�t | �s�q*t | �r�|d| � q*t | �} | s�|d | � q*|r�| d kr�| | dt | �� kr�q*|r�t| �r�q*t| �} |�| | | t| �f� q*| �r t||� |S ) z�Return 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 r� r )�argsr r r �<lambda> r� z get_interfaces.<locals>.<lambda>�:)�00r r r r r r r r r r r r r r r z Ignoring bridge interface: %szIgnoring bond interface: %sNz Ignoring failover interface: %sz"Ignoring interface without mac: %sr� )r, r- r� rN r� rH r} rJ rM rP rQ ri r� rp rc rd r� r� �)filter_hyperv_vf_with_synthetic_interface)r r� r� r� r� r� r� �filtered_loggerrY r� Zzero_macr r� rh r r r r� sT � ��� � r� ).N)r r� rV c sX dd� |D �� � fdd�|D �}|D ].}|\}}}}| d||� | |� |� |� q$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 U s z=filter_hyperv_vf_with_synthetic_interface.<locals>.<dictcomp>c s( g | ] }|d � v r|d dkr|�qS )r� r� r r r �Zhv_netvsc_mac_to_namer r r X s �z=filter_hyperv_vf_with_synthetic_interface.<locals>.<listcomp>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� rh r� r r r r A s � � �r c C sP i } t � D ]@\}}}}t|d�}|r || v rBtd|| | |f ��|| |< q | 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� )rY r r� r r r r �get_ib_hwaddrs_by_interfacek s �� r )�convert_to_addressr� c K s, z| |fi |��W S t y& Y dS 0 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)r: )r r� �kwargsr r r �maybe_get_address{ s r )r� rV c C s t ttj| ��S )z�Returns 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. )rW r � ipaddress� ip_address�r� r r r � is_ip_address� s r! c C s t ttj| ��S )z�Returns 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. )rW r r � IPv4Addressr r r r �is_ipv4_address� s r# c C s t ttj| ��S )z�Returns 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. )rW r r � IPv6Addressr r r r �is_ipv6_address� s r% c C s t ttj| dd��S )z�Returns 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� )rW r r � ip_networkr r r r � is_ip_network� s r( c C s t ttj| dd��S )z�Returns 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. Fr& )rW r r � IPv4Networkr r r r �is_ipv4_network� s �r* c C s t ttj| dd��S )z�Returns 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. Fr& )rW r r � IPv6Networkr r r r �is_ipv6_network� s �r, )r� �subnetrV c C s t �| �}t j|dd�}||v S )z�Returns a bool indicating if ``s`` is in subnet. :param address: The string of IP address. :param subnet: The string of subnet. :return: A bool indicating if the string is in subnet. Fr& )r r r' )r� r- r Zsubnet_networkr r r �is_ip_in_subnet� s r. )�gatewayr- rV c C sJ zt | |� W S tyD } z t�d| ||� W Y d}~dS d}~0 0 dS )z�Returns a bool indicating if should add gateway onlink flag. :param gateway: The string of gateway address. :param subnet: The string of subnet. :return: A bool indicating if the string is in subnet. zDFailed to check whether gateway %s is contained within subnet %s: %sNF)r. r: r, r� )r/ r- r3 r r r � should_add_gateway_onlink_flag� s �r0 c C s@ | d � d�s| d tv r dS | d dkr<t| �d��r<dS dS )z:Common helper for checking network_state subnets for ipv6.rR �6TZstaticr� F)�endswith�IPV6_DYNAMIC_TYPESr% r� )r- r r r �subnet_is_ipv6 s r4 c C s t t�d| � ��j�S )z�Convert a network prefix to an ipv4 netmask. This is the inverse of ipv4_mask_to_net_prefix. 24 -> "255.255.255.0" Also supports input as a string.�0.0.0.0/)r| r r) �netmask)�prefixr r r �net_prefix_to_ipv4_mask s r8 c C s t �d| � ��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 r5 )r r' � prefixlen)�maskr r r �ipv4_mask_to_net_prefix s r; c C s� zt �d| � ��j}|W S ty* Y n0 t �| �}t|�}|dkrJ|S tt j| |d @ �� �}||? }t j| }d|> d }||kr�td| ��|S )z�Convert 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' r9 r: r r �min� IPV6LENGTH� bit_length)r: r9 r6 Zmask_int�trailing_zeroes� leading_ones�all_onesr r r �ipv6_mask_to_net_prefix' s$ � rB )r: r� rV c C s t tj|� d| � �dd�j�S )zCGet string representation of broadcast address from an ip/mask pairr Fr& )r| r r) �broadcast_address)r: r� r r r �mask_and_ipv4_to_bcast_addrJ s �rD c @ s e Zd ZdS )�RendererNotFoundErrorN)r� r� r� r r r r rE Q s rE )r )NNNN)N)N)N)N)N)N)F)T)TTN)TTTTTTF)er# � functoolsr ZloggingrE r �typingr r r r r Z cloudinitr r Z cloudinit.net.netops.iproute2r Z getLoggerr� r, r r� r3 r[ r� r r r" r4 r9 r< rB rH rJ rM rP rQ rT � lru_cacherW rZ r� rb r| rc ri rl rq rt re rf rz r} rd r� r� rj 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. r0 r4 r8 r r; rB rD r� rE r r r r �<module> s� � % ! H 0 / � H �� =� * #