U Ad; @stddlZddlZddlZddlZddlZddlZddlmZmZm Z m Z m Z ddl m Z ddlmZmZddlmZmZeeZdZdZdd d d gZd d dddddddddg ZedfddZddZdddZddd Zdd!d"Z d#d$Z!d%d&Z"d'd(Z#d)d*Z$d+d,Z%d-d.Z&d/d0Z'ej(dd1e)d2d3d4Z*ej(dd1e+d2d5d6Z,e-e)d7d8d9Z.dd:d;Z/dd?Z1de)d2d@dAZ2ddBdCZ3ddDdEZ4dFdGZ5dHdIZ6dJdKZ7dLdMZ8dNdOZ9GdPdQdQe:Z;dRdSZde e e-e e-dTdYdZZ?de e e-e e-dTd[d\Z@de e e-e e-dTd]d^ZAde e e-e e-dTd_d`ZBde e e-e e-dTdadbZCde e e-e e-dTdcddZDddedfZEdgdhZFddjdkZGddmdnZHddodpZIdqdrZJdsdtZKdeLd2dudvZMe-e e-dwdxdyZNdeLd2dzd{ZOdeLd2d|d}ZPdeLd2d~dZQdeLd2ddZRde+d2ddZSddZTe e-efe)dddZUee-dddZVe-e)dddZWe-e)dddZXe-e)dddZYe-e)dddZZe-e)dddZ[e-e)dddZ\e)d2ddZ]e-d2ddZ^e_d2ddZ`e_d2ddZae-e-e-dddZbGdddecZddS)N)AnyCallableDictListOptional)urlparse)subputil)UrlErrorreadurlz/sys/class/net/Zeth0Zdhcp6Z ipv6_slaaczipv6_dhcpv6-statelesszipv6_dhcpv6-stateful ovs-vsctlz--formatZcsvz --no-headingsz --timeoutZ10z --columnsnamefind interfacez type=internalz([0-9]+)cCsddt||DS)aDSorting 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'].cSs$g|]}|rt|n|qS)isdigitintlower).0textrr8/usr/lib/python3/dist-packages/cloudinit/net/__init__.py 3sz$natural_sort_key..)resplit)sZ_nsrerrrnatural_sort_key,s rcCstS)z3Simple function to return the global SYS_CLASS_NET.) SYS_CLASS_NETrrrrget_sys_class_path9srcCst|d|S)N/)rdevnamepathrrr sys_dev_path>sr#c Cs t||}zt|}Wnttfk r}z^t|dd} | tjtjfkrb|dk rb||WY,S| tj fkr|dk r||WYSW5d}~XYnX| }|dkr|Sz ||WSt k r}z,|dk r||WYSt d||W5d}~XYnXdS)Nerrnoz5Found unexpected (not translatable) value '%s' in '%s)r#r Z load_fileOSErrorIOErrorgetattrr$ENOENTZENOTDIRZEINVALstripKeyErrorLOGdebug) r!r" translate on_enoent on_keyerror on_einvalZdev_pathcontentseZe_errnorrr read_sys_netBs4    r3cCsdd}t||||||dS)NcSsdSNFr)r2rrr on_excp_falsehsz(read_sys_net_safe..on_excp_false)r/r.r0r-)r3)ifacefieldr-r5rrrread_sys_net_safegsr8cCs<t||}|dkrdSz t|WStk r6YdSXdSr4)r8r ValueError)r6r7valrrrread_sys_net_intus  r;cCsdddd}t|d|dS)NTF)upunknowndown operstate)r-r8)r!r-rrris_ups rAcCstjt|dS)Nbridgeosr"existsr#r!rrr is_bridgesrGcCstjt|dS)NbondingrCrFrrris_bondsrIcCs t|dd}tj|r|SdS)z8Return the master path for devname, or None if no mastermasterr"N)r#rDr"rEr rrr get_masters  rLcCsHt|}|dkrdStj|d}tj|d}tj|pFtj|S)z@Return a bool indicating if devname's master is a bridge or bondNFrHrB)rLrDr"joinrE)r! master_pathZ bonding_pathZ bridge_pathrrrmaster_is_bridge_or_bonds rOcCs,t|}|dkrdSt|dd}tj|S)z;Return a bool indicating if devname's master is openvswitchNFzupper_ovs-systemrK)rLr#rDr"rE)r!rNZovs_pathrrrmaster_is_openvswitchs  rP)maxsize)returncCs ttd}|std|S)zDReturn a bool indicating if Open vSwitch is installed in the system.r z/device/features.rzdevice/features)r3 Exceptionr!Zfeaturesrrrget_dev_featuress rgcCs(t|}|rt|dkrdS|ddkS)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)rglenrfrrrhas_netfail_standby_featuresrlcCs<t|dk rdS|dkr t|}|dkr,dSt|s8dSdS)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_netTrLr_rlrbrrris_netfail_masters rocCstt|dd}tj|sdS|dkr,t|}|dkr8dStjtj|}t|}|dkr`dSt|}|spdSdS)a7A 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. rJrKFNrmT)r#rDr"rEr_basenamerealpathrl)r!rcZmaster_sysfs_pathZmaster_devnameZ master_driverZmaster_has_standbyrrrr`s  r`cCs<t|dkrdS|dkr t|}|dkr,dSt|s8dSdS)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. NFrmTrnrbrrrra6s racCst|d}|r|dkrdSdS)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)34TFr@)r!rrrrr is_renamedNs  rucCstt|d}d|kS)Nueventz DEVTYPE=vlan)strr8rY)r!rvrrris_vlan]srxcCs0d}t|d}tj|r,tjt|}|S)z8Return the device driver for net device named 'devname'.Nz device/driver)r#rDr"islinkrpreadlink)r!rcZ driver_pathrrrr_bs   r_cCst|d}|dkrdS|S)z;Return the device id string for net device named 'devname'.z device/deviceFNr@)r!Zdev_idrrr device_devidms r{c CsjtstrttSztt}Wn6t k rd}z|j t j krRg}nW5d}~XYnX|SN) r is_FreeBSDis_DragonFlyBSDlistget_interfaces_by_macvaluesrDlistdirrr%r$r()devsr2rrrget_devicelistvs rc@seZdZdZdS) ParserErrorz6Raised when a parser has issue parsing a file/content.N)__name__ __module__ __qualname____doc__rrrrrsrcCs |rt|tsdS|ddkS)NFconfigZdisabled) isinstancedictget)cfgrrris_disabled_cfgsr)blacklist_driversrRcCs<tstrt|Sts(tr0t|St|SdS)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_openbsdfind_candidate_nics_on_linuxrrrrfind_candidate_nicss rcCs<tstrt|Sts(tr0t|St|SdS)z.Get the name of the 'fallback' network device.N)r r}r~find_fallback_nic_on_freebsdrr&find_fallback_nic_on_netbsd_or_openbsdfind_fallback_nic_on_linuxrrrrfind_fallback_nics rcCstttdS)zGet the names of the candidate network devices on NetBSD/OpenBSD. @param blacklist_drivers: currently ignored @return list of sorted interfaces key)sortedrrrrrrrrsrcCst|}|r|dSdS)zGet the 'fallback' network device name on NetBSD/OpenBSD. @param blacklist_drivers: currently ignored @return default interface, or None rN)rrnamesrrrrsrcCs8tddddg\}}|}|r&|StttdS)zGet the names of the candidate network devices on FreeBSD. @param blacklist_drivers: Currently ignored. @return List of sorted interfaces. ifconfigz-lz-uetherr)rrrrrr)rstdoutZ_stderrrrrrrs rcCst|}|r|dSdS)zGet the 'fallback' network device name on FreeBSD. @param blacklist_drivers: Currently ignored. @return List of sorted interfaces. rN)rrrrrrsrc Cs|sg}dtkr tdn.z4Found unstable nic names: %s; calling udevadm settlez!Waiting for udev events to settle)funcrz%Ignoring interface with %s driver: %saddressz"Ignoring interface without mac: %sZvethzIgnoring veth interface: %szIgnoring bridge interface: %szIgnoring bond interface: %szIgnoring failover interface: %scarrierzInterface has no carrier: %sdormantr?)rr>Zlowerlayerdownr=zInterface ignored: %srr)r Z get_cmdliner+r,rrkZlog_timeZudevadm_settler_r8 startswithrGrIrdr;appendrrDEFAULT_PRIMARY_INTERFACEremoveinsert) rZunstablemsgZ connectedZpossibly_connectedrrcrrr?Zsorted_interfacesZ interfacesrrrrs                         rcCst|}|r|dSdS)zGet the 'fallback' network device name on Linux. @param blacklist_drivers: Ignore devices with these drivers. @return List of sorted interfaces. rN)rrrrrr>srcCsx|sd}t|d}|sdSt|r,d|i}ndt|di}d||d}|rft|}|rf||d d <||id d }|S) zBGenerate network cfg v2 for dhcp on the NIC most likely connected.FrNr macaddressrT)Zdhcp4set-namematchrrc) ethernetsversion)rror8rr_)rZ config_driverZ target_namerrrcZnconfrrrgenerate_fallback_configMs"     rcCsJdd}dd}|d}|dkr*||S|dkr:||Std|dS) NcSsg}|diD]|}|ddkr$q|d}|s4q|d}|did}|did}|snt|}|szt|}|||||gq|S) NrtypeZphysicalZ mac_addressr paramsrc device_id)rr_r{r)netcfgphysdevsentmacr rcrrrr _version_1hs   z$extract_physdevs.._version_1cSsg}|diD]z}|d}|s(q|did}|s@q|did}|did}|spt|}|s|t|}|||||gq|S)Nrrrrrcr)rrr_r{r)rrrr rrcrrrr _version_2zs  z$extract_physdevs.._version_2rrz"Unknown network config version: %s)r RuntimeError)rrrrrrrextract_physdevsgs rFcCs*t|d}|dkr"|rtddS|dkS)areturn 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)rr)r;r9)ifnamestrictZ assign_typerrrinterface_has_own_macs rTc Csi}tD]*\}}}}d||||t|d||<q |rtd}tjdddddd d gd d \}}tjdd ddgd d \} }t} || fD]} | || q| D] } | ddkp| d| k| d<q|S)aCollect 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)downablerrcrr r<z[0-9]+:\s+(\w+)[@:]ipz-6ZaddrZshowZ permanentZscopeglobalTZcapturez-4r<Fr r) get_interfacesrrArcompilersetupdatefindallr) Zcheck_downablecur_infor rrcrZnmatchZipv6r[Zipv4Znics_with_addressesZ bytes_outdrrr_get_current_rename_infos.     rc st|stddS|dkr$t}i|D]:\}}|}|drZ|d|d<||d<||<q0tdfdd}dd}d d } d d } g} g} g} |}d }d}ddfdd}|D]\}}}}|r|}g}||||}|s|r| d||fq|d}||kr0q|sN|r| d||fq|drd}|ds|r| ||||fqd|d<|d|||ff| d|||ff||krz||}|dr d}|ds|r| ||||fqn|d|||ffd}|dks"||kr6|d7}||}q|d||||ff||d<|}|drz| d|||ff|d|||d|ff||d<|}| |7} q|| | d}t| t| dkrt| rtd|n td|nztd || | | | D]^\}}}}z|||Wn<t k rj}z| d!|||||fW5d}~XYnXqt| rt d" | dS)#Nzno interfaces to renamerr zDetected interfaces %scstddDS)Ncss|]}|d|fVqdS)r Nrrdatarrr sz<_rename_interfaces..update_byname..)rr)Zbymac)rrr update_bynamesz)_rename_interfaces..update_bynamecSstjddd|d|gdddS)Nrlinkrr Trr)curnewrrrrenamesz"_rename_interfaces..renamecSstjddd|dgdddS)Nrrrr>Trrr rrrr>sz _rename_interfaces..downcSstjddd|dgdddS)Nrrrr<Trrrrrrr<sz_rename_interfaces..upz cirename%dcSsd|r0|r0|r0|d|ko.|d|ko.|d|kS|rP|rP|d|koN|d|kS|r`|d|kSdS)zmatch if set and in datarrcrFr)rrrcrrrr entry_matchs     z'_rename_interfaces..entry_matchcsTfddD}t|rPt|dkrHd|f}t||dSdS)Ncsg|]}|r|qSrrr)rrcrrrrrsz:_rename_interfaces..find_entry..rzjFailed to match a single device. Matched devices "%s" with search values "(mac:%s driver:%s device_id:%s)"r)rrkr9)rrcrrrrr)rrcrr find_entrys  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 %srFr>z2[busy-target] Error renaming mac=%s from %s to %s.rr)rr>r<rz(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 ) rkr+r,ritemscopyrrrrerM)renamesZstrict_presentZ strict_busyZ current_infor rrrrr>r<ZopserrorsZupsZ cur_bynameZ tmpname_fmtZtmpirrnew_namercrZcur_opsZcur_namertargetZtmp_nameZopmapoprr2rrr_rename_interfacess                    rcCs$d}tjt|drd}t||S)z6Returns the string value of an interface's MAC AddressrZ bonding_slavezbonding_slave/perm_hwaddr)rDr"isdirr#r8)rr"rrrget_interface_macxsrcCs>t|ddkr:t|}|r6|r6|dd|dd}|SdS)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. rZ32$i3N)r8r)rZethernet_formatrrrrget_ib_interface_hwaddrs rcCsLtstrt|dStr,t|dStr>t|dSt|dSdS)Nr) r r}r~ get_interfaces_by_mac_on_freebsdrget_interfaces_by_mac_on_netbsdr get_interfaces_by_mac_on_openbsdget_interfaces_by_mac_on_linuxrrrrrsr)rrRcCs0tD] \}}||kr |Sq dSr|)rrr)rZ interface_macZinterface_namerrrfind_interface_name_from_macs rcCs>tdddg\}}dd}dd}dd |||D}|S) Nr-arcss@d}|dD]&}|dr&||7}q|r0|V|}q|VdS)Nrr )rr)rZZ curr_blocklinerrrflattens  z1get_interfaces_by_mac_on_freebsd..flattencss4|D]*}td|}|r|d|dfVqdS)Nz2^(?P\S*): .*ether\s(?P[\da-f:]{17}).*rr)rsearchgroup)Z flat_listblockmrrrfind_macsz2get_interfaces_by_mac_on_freebsd..find_maccSsi|]\}}||qSrr)rrrrrr sz4get_interfaces_by_mac_on_freebsd..r)rrZ_rrZresultsrrrrs  rc Csbi}d}tddg\}}tdd|}|D],}t||}|r0|}|d||d<q0|S)NzE(?P\w+).*address:\s(?P([\da-f]{2}[:-]){5}([\da-f]{2})).*rr\n\s+ rrrrsubrYr groupdict rrTZre_field_matchrZrZif_linesrrZfieldsrrrrs rc Csbi}d}tddg\}}tdd|}|D],}t||}|r0|}|d||d<q0|S)NzC(?P\w+).*lladdr\s(?P([\da-f]{2}[:-]){5}([\da-f]{2})).*rrrrrrrrrrrrs rc Csi}i}t|dD]\}}}}||krd}d||||f}|||kr||dkrtt|d||||fq|dkrd}t|d|||||f|dks|dkrtd ||||q|rt||||<|||<t|d} | r| |kr||| <qtd ||| | q|S) zmBuild a dictionary of tuples {mac: name}. Bridges and any devices that have a 'stolen' mac are excluded.rTz6duplicate mac found! both '%s' and '%s' have mac '%s'.Z hv_netvsczC Ignoring '%s' due to driver '%s' and '%s' having driver hv_netvsc.FZ mscc_felixZ fsl_enetcz>Ignoring duplicate macs from '%s' and '%s' due to driver '%s'.z^Ethernet and InfiniBand interfaces have the same address both '%s' and '%s' have address '%s'.)rr+warningr,rr) rrTZ driver_mapr rrcZ_devidZraise_duplicate_mac_errorrib_macrrrrsd       rcCsg}|dkrg}t}dd}|D]}t|s2q$t|r "255.255.255.0" Also supports input as a string.0.0.0.0/)rwrrnetmask)prefixrrrnet_prefix_to_ipv4_masksr&cCstd|jS)aConvert 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 r#)rr prefixlen)maskrrripv4_mask_to_net_prefixs r)cCsztd|j}|WStk r,YnXt|}t|}|dkrL|Sttj||d@}||?}tj|}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::/rrzInvalid network mask '%s') rrr'r9rrminZ IPV6LENGTH bit_length)r(r'r$Zmask_intZtrailing_zeroesZ leading_onesZall_onesrrripv6_mask_to_net_prefix+s&    r,)r(rrRcCsttj|d|ddjS)zCGet string representation of broadcast address from an ip/mask pairrFr)rwrrZbroadcast_address)r(rrrrmask_and_ipv4_to_bcast_addrNsr-c@s eZdZdS)RendererNotFoundErrorN)rrrrrrrr.Usr.)r)NNNN)N)N)N)N)N)N)N)N)N)N)N)N)N)NN)F)T)TTN)N)N)N)N)N)N)er$ functoolsrZloggingrDrtypingrrrrrZ urllib.parserZ cloudinitrr Zcloudinit.url_helperr r Z getLoggerrr+rrr!rVrrrr#r3r8r;rArGrIrLrOrP lru_cacherSrUrr]rwr^rdrgrlror`rarurxr_r{rrerrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr"r&rr)r,r-rr.rrrrs     %         !                 [   0  /   c+'       #