x[hddlZddlZddlZddlZddlZddlZddlmZmZm Z m Z m Z ddl m Z mZddlmZej"eZdZdZgdZgdZej0d fd Zd Zddd Z ded ZdfdZdZdZdZ dZ!dZ"dZ#dZ$dZ%ejLdde'fdZ(ejLdde)fdZ*de+de'fdZ,dfdZ-dZ.dZ/dfde'fd Z0dfd!Z1dfd"Z2d#Z3d$Z4d%Z5d&Z6d'Z7Gd(d)e8Z9d*Z:de e+fd+Z;de e+fd,Zde e+fd/Z?de e+fd0Z@de e+fd1ZAde e+fd2ZBdfde eCfd3ZDd4ZEdgd5ZFdhd6ZG did7ZHd8ZId9ZJdeCfd:ZKd;e+de e+fd<ZLdeCfd=ZMdeCfd>ZNdeCfd?ZOdeCfd@ZP djdAe'dBe'dCe'dDe'dEe'dFe'dGe'de)fdHZQdIedJdKe e e+e+e+e+fddfdLZRdMZSdNedOe+fdPZTdOe+de'fdQZUdOe+de'fdRZVdOe+de'fdSZWdOe+de'fdTZXdOe+de'fdUZYdOe+de'fdVZZdOe+dWe+de'fdXZ[dYe+dWe+de'fdZZ\de'fd[Z]de+fd\Z^de_fd]Z`de_fd^Zad_e+d`e+de+fdaZbGdbdcecZdy)kN)CallableDictListOptionalTuple)subputil)Iproute2z/sys/class/net/eth0)dhcp6 ipv6_slaaczipv6_dhcpv6-statelesszipv6_dhcpv6-stateful) ovs-vsctlz--formatcsvz --no-headingsz --timeout10z --columnsnamefind interfacez type=internalz([0-9]+)ctj||Dcgc]-}|jr t|n|j /c}Scc}w)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'].)resplitisdigitintlower)s_nsretexts 8/usr/lib/python3/dist-packages/cloudinit/net/__init__.pynatural_sort_keyr+sFHHUA&  \\^D 5  s2ActS)z3Simple function to return the global SYS_CLASS_NET.) SYS_CLASS_NETrget_sys_class_pathr#8s r"c(t|zdz|zS)N/)r#devnamepaths r sys_dev_pathr)=s  ' )C /$ 66r"ct||} tj|}|j}||S ||S#ttf$rf}t |dd} | t jt jfvr| ||cYd}~S| t jfvr| ||cYd}~Sd}~wwxYw#t$r,}| ||cYd}~Stjd||d}~wwxYw)Nerrnoz5Found unexpected (not translatable) value '%s' in '%s)r)r load_text_fileOSErrorIOErrorgetattrr+ENOENTENOTDIREINVALstripKeyErrorLOGdebug) r'r( translate on_enoent on_keyerror on_einvaldev_pathcontentsee_errnos r read_sys_netr?AsGT*H &&x0~~H "" W !Wd+ u||U]]3 3$ |# u||o %$ |#     "q> ! IIG   sP=B5B2 8B-B2 B-&B2,B--B25 C*> C%C* C%%C*c*d}t||||||S)NcyNFr!)r=s r on_excp_falsez(read_sys_net_safe..on_excp_falsegsr")r9r8r:r7)r?)ifacefieldr7rCs rread_sys_net_saferFfs(   !  r"cZt||}|dury t|S#t$rYywxYwrB)rFr ValueError)rDrEvals rread_sys_net_intrJts8 E5 )C e|3x s  **c*dddd}t|d|S)NTF)upunknowndown operstate)r7rF)r'r7s ris_uprQ~se>,w9 ::r"cTtjjt|dS)NbondingrTrWs ris_bondr[s 77>>,w : ;;r"c`t|d}tjj|r|Sy)z8Return the master path for devname, or None if no mastermasterr(N)r)rUr(rVr&s r get_masterr_s& h /D ww~~d r"ct|}|ytjj|d}tjj|d}tjj |xstjj |S)z@Return a bool indicating if devname's master is a bridge or bondFrZrS)r_rUr(joinrV)r' master_path bonding_path bridge_paths rmaster_is_bridge_or_bondresbW%K77<< Y7L'',,{H5K 77>>, ' F277>>++FFr"cvt|}|yt|d}tjj |S)z;Return a bool indicating if devname's master is openvswitchFzupper_ovs-systemr^)r_r)rUr(rV)r'rbovs_paths rmaster_is_openvswitchrhs5W%KG*<=H 77>>( ##r"c t|ddk(S)Ntype32rPrWs ris_ib_interfacerls Wf - 55r")maxsizereturncpttjd}|stj d|S)zDReturn a bool indicating if Open vSwitch is installed in the system.rz/device/features.zdevice/features)r? Exceptionr'featuress rget_dev_featuresrs9H ):; O   O s  cJt|}|rt|dkry|ddk(S)zReturn 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)rlenrs rhas_netfail_standby_featurers. (H s8}r) B<3 r"cZt|y| t|}|dk7ryt|syy)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. F virtio_netTr_rrrs ris_netfail_masterrs:'& ~w'  &w / r"c:t|d}tjj|sy| t |}|dk(rytjj tjj |}t |}|dk7ryt|}|syy)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. r]r^FrT)r)rUr(rVrbasenamerealpathr)r'rmaster_sysfs_pathmaster_devname master_drivermaster_has_standbys rrrs%W8< 77>>+ , ~w' WW%%bgg&6&67H&IJN!.1M $4^D  r"cZt|y| t|}|dk7ryt|syy)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. FrTrrs rrr9s:'" ~w'  &w / r"c*t|d}|r|dvryy)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)34TFrP)r'rs r is_renamedrQs#)2DE, : r"cPtt|d}d|jvS)Nueventz DEVTYPE=vlan)strrFrv)r'rs ris_vlanr`s( "7H5 6F V..0 00r"cd}t|d}tjj|r2tjj tj |}|S)z8Return the device driver for net device named 'devname'.Nz device/driver)r)rUr(islinkrreadlink)r'r driver_paths rrresE Fw8K ww~~k"!!"++k":; Mr"c(t|d}|dury|S)z;Return the device id string for net device named 'devname'.z device/deviceFNrP)r'dev_ids r device_devidrps w 8F  Mr"cDtjstjr!tt j S t jt}|S#t$r,}|jtjk(rg}nYd}~|Sd}~wwxYwN) r is_FreeBSDis_DragonFlyBSDlistget_interfaces_by_macvaluesrUlistdirr#r-r+r0)devsr=s rget_devicelistrys D002)+22455zz,./ K  77ell "D   K s A** B3!BBceZdZdZy) ParserErrorz6Raised when a parser has issue parsing a file/content.N)__name__ __module__ __qualname____doc__r!r"rrrs@r"rcP|rt|tsy|jddk(S)NFconfigdisabled) isinstancedictget)cfgs ris_disabled_cfgrs% jd+ 778  **r"ctjstjr tStjstj r t StS)zqGet the list of network interfaces viable for networking. @return List of interfaces, sorted naturally. )r rrfind_candidate_nics_on_freebsd is_NetBSD is_OpenBSD(find_candidate_nics_on_netbsd_or_openbsdfind_candidate_nics_on_linuxr!r"rfind_candidate_nicsrsG  D002-//  T__.799+--r"ctjstjr tStjstj r t StS)z.Get the name of the 'fallback' network device.)r rrfind_fallback_nic_on_freebsdrr&find_fallback_nic_on_netbsd_or_openbsdfind_fallback_nic_on_linuxr!r"rfind_fallback_nicrsE D002+--  T__.577)++r"cPttjtS)zmGet the names of the candidate network devices on NetBSD/OpenBSD. @return list of sorted interfaces key)sortedrrrr!r"rrrs ')0028H IIr"c&t}|r|dSy)zfGet the 'fallback' network device name on NetBSD/OpenBSD. @return default interface, or None rN)rnamess rrrs 5 6E Qx r"ctjgd\}}|j}|r|Sttj t S)zgGet the names of the candidate network devices on FreeBSD. @return List of sorted interfaces. )ifconfigz-lz-uetherr)rrrrrr)stdout_stderrrs rrrsG ii ABOFG \\^F   ')0028H IIr"c&t}|r|dSy)z_Get the 'fallback' network device name on FreeBSD. @return List of sorted interfaces. rN)rrs rrrs + ,E Qx r"c~dtjvrtjdn\t Dcgc]}|dk7r t |s|}}t |r*tjd|tjg}g}tddddddD]\}}}}|dk(r|jdrtjd |6t|d }|r|j|Vtjd |t|d }|r|j|t|d }|dvr|j|tjd|g} ||fD]K} t| t} t| vr+| j!t| j#dt| | z } M| Scc}w)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/cmdlineloz4Found unstable nic names: %s; calling udevadm settleFT)filter_openvswitch_internal2filter_slave_if_master_not_bridge_bond_openvswitch filter_vlanfilter_without_own_macfilter_zero_maclog_filtered_reasonsvethzIgnoring veth interface: %scarrierzInterface has no carrier: %sdormantrO)rrNlowerlayerdownrMzInterface ignored: %srr)r get_cmdliner5r6rrrudevadm_settleget_interfaces startswithrJappendrFrrDEFAULT_PRIMARY_INTERFACEremoveinsert) deviceunstable connectedpossibly_connectedr_rrrOsorted_interfaces interfacess rrrs $**,, MN)* ~j&8   x= IIF     !I,$);@$! 6 1a       ' II3Y ? "9i8    Y '  0)<#9i8   % %i 0 %i= H H  % %i 0  )95=6J "45( J,<= $ 2   7 8   a!: ;Z' ( { sF:c&t}|r|dSy)z]Get the 'fallback' network device name on Linux. @return List of sorted interfaces. rN)rrs rrrs ) *E Qx r"ct}|syt|rd|i}ndt|dji}|rt |}|r||d<dd||d}||idd }|S) zBGenerate network cfg v2 for dhcp on the NIC most likely connected.Nr macaddressaddressrT)dhcp4r set-namematch) ethernetsversion)rrrFrr) config_driver target_namerrrnconfs rgenerate_fallback_configr +s$%K %% +KCIIK {+ $E(O  C ', ;E Lr"cd}d}|jd}|dk(r||S|dk(r||Std|z)Ncg}|jdiD]}|jddk7r|jd}|s,|jd}|jdijd}|jdijd}|s t|}|s t|}|j||||g|S) Nrrjphysical mac_addressrparamsr device_id)rrrr)netcfgphysdevsentmacrrrs r _version_1z$extract_physdevs.._version_1Is::h+ I&t,(. OOS$ : ; <r"cg}|jdijD]}|jd}|s|jdijd}|s;|jdijd}|jdijd}|s t|}|s t|}|j ||||g|S)Nrrrrrr)rrrrr)rrrrrrrs r _version_2z$extract_physdevs.._version_2[s::k2.557 K :; ; ) ##r"c i}tD]*\}}}}d|||j|t|d||<,|rtjd}t j gdd\}}t j gdd\} }t } || fD]"} | j|j| $|jD]} | dd uxs| d | v| d <|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)downablerrrrrLz[0-9]+:\s+(\w+)[@:])ipz-6addrshow permanentscopeglobalT)capture)r#z-4r$r%rLFrr") rrrQrcompilersetupdatefindallr) check_downablecur_inforrrrnmatchipv6r{ipv4nics_with_addresses bytes_outds r_get_current_rename_infor6sH(6(8 $c69"99;+   23YY H dYY;TJ d!e BI  & &v~~i'@ A B" A$5 HAfI5H$H jM  Or"c t|stjdy| t}i|j D]F\}}|j }|j dr|dj|d<||d<||<Htjdd}g}g} g} |} d} d} dfd }|D]\}}}}|r|j}g}||||}|s|r| jd |d |d D|j d}||k(r[|s|r| jd |d |d x|d rRd}|ds|r| j||||fzd|d <|jd|||ff| jd |||ff|| vr| |}|d r7d}|ds|r| j||||fz|jd|||ffd}||| vr| dz } | | z}| || vr|jd||||ff||d<|} |d r| jd |||ff|jd|||d|ff||d<|} ||z }tjtjtjd}|s<| s:t| rtjd|| nItjd|n2tjd||| z|| zD]\}}}} |||t| rtdj!| y#t$r)}| jd||d|d|d| Yd}~fd}~wwxYw)Nzno interfaces to renamerrzDetected interfaces %scBtd|jDS)Nc3*K|] }|d|f yw)rNr!).0datas r z<_rename_interfaces..update_byname..sDTT&\4(Ds)rr)bymacs r update_bynamez)_rename_interfaces..update_bynamesDU\\^DDDr"z cirename%dc|r |r|r|d|k(xr|d|k(xr|d|k(S|r|r|d|k(xr|d|k(S|r|d|k(Sy)zmatch if set and in datarrrFr!)r;rrrs r entry_matchz'_rename_interfaces..entry_matchsv 6iU s"3Nf,3%2  V;#%B$x.F*B B ;#% %r"c jDcgc]}||||r|}}t|r-t|dkDrd|d|d|d|d }t||dSycc}w)Nrz2Failed to match a single device. Matched devices "z" with search values "(mac:z driver:z device_id:z)"r)rrrH)rrrr;rmsgr/rAs r find_entryz&_rename_interfaces..find_entrys}!) 4fi8   u:5zA~c696 !o%8O sA#z$[nic not present] Cannot rename mac=z to z, not available.rLz*[busy] Error renaming mac=%s from %s to %sr"FrNz2[busy-target] Error renaming mac=%s from %s to %s.rrename)rErNrLz1Unable to rename interfaces: %s due to errors: %sz$no work necessary for renaming of %szRenamed %s with ops %sznknown] Error performing z for z, z:  )rr5r6r6itemscopyrrrr link_rename link_downlink_upwarningrrra)renamesstrict_present strict_busy current_inforr;curr>opserrorsups cur_byname tmpname_fmttmpirDrnew_namerrcur_opscur_namerCtargettmp_nameopmapoprr=r/rAs @@r_rename_interfacesr_s w< +,/1 H"((* diik 775>U))+CJF  II&1E C F Cx(JK D $-4=(Xvy ))+Cfi0 *-x9 776? x   *-x9  t9>Cz?MM#h(A"ABCI NNFCH;? @ JJc8h[9 : z !)Fd|Jj)" cS(H,E&EFNNFCH;#GH&*H"h*&< &-"h*&< NNHc8h5IJ K%F6N&x0Jd| D#x(=>#x#f+x1HIJF "8,  w{=@&&"""E # v; KKC  II)@)F)F)H"% ~ 99;---/ /! !" r"ctjgd\}}d}d}|||Dcic]\}}|| }}}|Scc}}w)N)r-arc3Kd}|jdD]!}|jdr||z }|r||}#|yw)NrrF )rr)rz curr_blocklines rflattenz1get_interfaces_by_mac_on_freebsd..flattensN IIdO "Dt$d" $$!  "s=?c3K|D]?}tjd|}|s|jd|jdfAyw)Nz2^(?P\S*): .*ether\s(?P[\da-f:]{17}).*rr)rsearchgroup) flat_listblockms rfind_macz2get_interfaces_by_mac_on_freebsd..find_macsI :E EuAwwu~qwwx'899  :s A'A)r)rzrrxrrrresultss rrjrjsPyy45HS! :/7ws|.DE{sFsF{EGE NFs Aci}d}tjddg\}}tjdd|j}|D]6}tj||}|s|j }|d||d<8|S)NzE(?P\w+).*address:\s(?P([\da-f]{2}[:-]){5}([\da-f]{2})).*rrs\n\s+ rrrrsubrvr groupdictrrre_field_matchrzrif_linesrwr~fieldss rrkrk C 6yy*d+,HS!vvhS)446H2 HH^T * [[]F!'!1Cu  2 Jr"ci}d}tjddg\}}tjdd|j}|D]6}tj||}|s|j }|d||d<8|S)NzC(?P\w+).*lladdr\s(?P([\da-f]{2}[:-]){5}([\da-f]{2})).*rrsrrrrrrs rrlrlrr"c i}tD]~\}}}}||vr:|dvrtjd||||,d|d||d|d}t||||<t |d}|sZ||vr|||<dtj d|||||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'.duplicate mac found! both '' and ' ' have mac 'z'.Tz^Ethernet and InfiniBand interfaces have the same address both '%s' and '%s' have address '%s'.)rr5r6rrhrL)rrrrr_devidrCib_macs rrmrmsC%3%5=!c66 #:@@ #H ACC s# #C )t4 *S "F  =K o=| Jr"filter_hyperv_vf_with_syntheticrrrrrrc `|rtjnd}g}t} djd} | D]} |r t | st | r |d| &|r t | r4t| r |d| I|r"t| t| s t| smt| r |d| t| } | s |d| |r| d k7r| | dt| k(r|r t| rt| } |j!| | | t#| f|r t%|||S) zReturn list of interface tuples (name, mac, driver, device_id) Bridges and any devices that have a 'stolen' mac are excluded.cyrr!)argss rz get_interfaces..sr":)00rrrrrrrrrrrrrrrzIgnoring bridge interface: %szIgnoring bond interface: %sNzIgnoring failover interface: %sz"Ignoring interface without mac: %sr)r5r6rrar rXrr[r_rerhrrcrrrrr)filter_hyperv_vf_with_synthetic_interface)rrrrrrrfiltered_loggerrrrzero_macrrrs rrrs=$8cii=OO C  Dxx %H"< !*?*E  T? ;T B  74=  4= 94 @  >4 ,,T2)$/  $  =t D % @$ G  tt|x #c(7K0K  &+L ,  t$ D#v|D'9:;E" "255.255.255.0" Also supports input as a string.0.0.0.0/)rrrnetmask)prefixs rnet_prefix_to_ipv4_maskrs' y$$xx%89AA BBr"cFtjd|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)masks ripv4_mask_to_net_prefixrs"   (4& 1 2 < < 48 "48" => 48 z::/rrzInvalid network mask '%s') rrrrHrrmin IPV6LENGTH bit_length)rrrmask_inttrailing_zeroes leading_onesall_oness ripv6_mask_to_net_prefixr's ((3tf6@@     ""4(G7|H1}yHqL9EEGO.L$$6IY!#Hx4t;<< s #& 22rr#c`ttj|d|djS)zCGet string representation of broadcast address from an ip/mask pairr%Fr)rrrbroadcast_address)rr#s rmask_and_ipv4_to_bcast_addrrJs/ AdVnU;MM r"c eZdZy)RendererNotFoundErrorN)rrrr!r"rrrQsr"r)r)NNNNr)F)T)TTN)TTTTTTF)er+ functoolsrloggingrUrtypingrrrrr cloudinitrr cloudinit.net.netops.iproute2r getLoggerrr5r rrrur*rr#r)r?rFrJrQrXr[r_rerhrl lru_cacherprsrr}rrrrrrrrrrrrrrrrrrrrrrrrrr rr r6r_rcrhrrqrjrkrlrmrrrrrrrrrrrrrrrrrrrrr!r"rrsD  88 2g!! " %!)bjj4  7 "J H;<G$6T"$#T" T # ( s t   t0B0 1  A)A+ .T#Y .,8C=,J$s)J   JS J hsm Ed3iEP HSM HTN:-G`$(+^BF[.|+ 0t0chsm$8   $  DDP-1(,?C#' !&9%)9!%99=9 9 ! 9  99 9x'%i('%U3S#-./'% '%T  (S& B3 B4 B CS CT C CS CT C P3 P4 P S T  S T (S(#($("C2 d CsC =S = S Fcss L r"