/I_sSrSSKrSSKrSSKJr \R "5r"SS5r"SS5r"SS 5r "S S 5r "S S 5r "SS5r "SS5r "SS5r"SS5r"SS5r"SS\R"5r"SS\R"5r"SS5r"SS5rg) zifupdown2 network interface object It is modeled based on the 'iface' section in /etc/network/interfaces file. But can be extended to include any other network interface format N) OrderedDictc$\rSrSrSrSrSrSrSrg)ifaceStatusUserStrszThis class declares strings user can see during an ifquery --check for example. These strings can be overridden by user defined strings from config file )success)errorunknownN) __name__ __module__ __qualname____firstlineno____doc__SUCCESSFAILUREUNKNOWN__static_attributes__r &/usr/share/ifupdown2/ifupdown/iface.pyrrsGGGrrc \rSrSrSrSrSrSrg) ifaceType rr N)r r r rrIFACE BRIDGE_VLANrr rrrr sGEKrrc$\rSrSrSrSrSrSrSrg) ifaceRole%zifaceRole is used to classify the ifaceobj.role of MASTER or SLAVE where there is a bond or bridge with bond-slaves or bridge-ports. A bond in a bridge is both a master and slave (0x3) rrrr N) r r r rrrSLAVEMASTERrr rrrr%s GEFrrcH\rSrSrSrSrSrSrSrSr Sr S r S r \ S 5rS rg ) ifaceLinkKind/zifaceLlinkKind is used to identify interfaces in the ifaceobj.link_kind attribute. Dependents of the bridge or bond have an ifaceobj.role attribute of SLAVE and the bridge or bond itself has ifaceobj.role of MASTER. rrrcXR:XagXR:XagXR:XagXR:XagXR:Xagg)NbridgebondvlanvxlanvrfOTHER)BRIDGEBONDVLANVXLANVRF)clskinds rto_strifaceLinkKind.to_str@sE ::  XX  XX  YY  WW_rr N)r r r rrrr0r1r2r3r4 BATMAN_ADVr/ classmethodr7rr rrr#r#/sE GFDDECJE  rr#c\\rSrSrSrSrSrSrSrSr Sr S r S r S r S rS rSrSr\S5rSrg)ifaceLinkPrivFlagsOzUThis corresponds to kernel netdev->priv_flags and can be BRIDGE_PORT, BOND_SLAVE etc rrrr%r&r'r(iill@lc/nXR-(aURS5 XR-(aURS5 XR-(aURS5 XR-(aURS5 XR -(aURS5 XR -(aURS5 XR-(aURS5 XR-(aURS5 XR-(aURS 5 XR-(aURS 5 S RU5$) Nz bridge portz bond slavez vrf slavezvlan aware bridgez vxlan bridgezaddress virtual slaveloopbackzkeep ling downzes bondzopenvswitch interfacez, ) BRIDGE_PORTappend BOND_SLAVE VRF_SLAVEBRIDGE_VLAN_AWARE BRIDGE_VXLANADDRESS_VIRTUAL_SLAVELOOPBACKKEEP_LINK_DOWNES_BOND OPENVSWITCHjoin)r5flag string_lists rget_strifaceLinkPrivFlags.get_stras // !   } - ..   | , --    { + '' '   2 3 "" "   ~ . ++ +   6 7 ,,    z * $$ $   / 0 ++    y ) // !   6 7yy%%rr N)r r r rrrr@rBrCrDrErFrGrH MGMT_INTF SINGLE_VXLANrIrJr:rNrr rrr<r<Os^3 GKJIL$HNILGK!&!&rr<c$\rSrSrSrSrSrSrSrg) ifaceLinkTyperrr N) r r r r LINK_UNKNOWN LINK_SLAVE LINK_MASTERLINK_NArr rrrSrSsLJKGrrSc(\rSrSrSSS.rSSS.rSrg ) VlanProtocols0x81000x88a8)802.1Q802.1ADr`ra)r^r_r N)r r r rETHERTYPES_TO_IDID_TO_ETHERTYPESrr rrr\r\s"%-$, %-$-rr\c$\rSrSrSrSrSrSrSrg)ifaceDependencyTypea>Indicates type of dependency. This class enumerates types of dependency relationships between interfaces. iface dependency relationships can be classified into: - link - master/slave In a 'link' dependency relationship, dependency can be shared between interfaces. example: swp1.100 and swp1.200 can both have 'link' swp1. swp1 is also a dependency of swp1.100 and swp1.200. As you can see dependency swp1 is shared between swp1.100 and swp1.200. In a master/slave relationship like bridge and its ports: eg: bridge br0 and its ports swp1 and swp2. dependency swp1 and swp2 cannot be shared with any other interface with the same dependency relationship. ie, swp1 and swp2 cannot be in a slave relationship with another interface. Understanding the dependency type is required for any semantic checks between dependencies. rrrUr N) r r r rrrLINK MASTER_SLAVErr rrreres2G DLrrecL\rSrSrSrSrSrSrSrSr \ S5r \ S 5r S r g ) ifaceStatuszEnumerates iface status rrUrVcXR:XagXR:XagXR:XagXR:Xagg)Nr rrnotfound)rrERRORNOTFOUNDr5states rr7ifaceStatus.to_strs; KK  kk ! ii  ll "#rcpUS:Xa UR$US:Xa UR$US:Xa UR$g)Nr rr)rrrpr5 state_strs rfrom_strifaceStatus.from_strs=  !;;  ) #;;  ' !99 "rr N)r r r rrrrWARNINGrprqr:r7rxrr rrrjrjsD"GGG EHrrjc`\rSrSrSrSrSrSrSrSr Sr S r S r S r S r\S 5r\S5rSrg) ifaceStatezEnumerates iface state rrUrVrlrm cDXR:XagXR:XagXR:XagXR:XagXR:XagXR :XagXR :XagXR:XagXR:Xag XR:Xag g Nr newzpre-upupzpost-upzpre-downdownz post-downzquery-checkcurrz query-running rNEWPRE_UPUPPOST_UPPRE_DOWNDOWN POST_DOWNQUERY_CHECKCURR QUERY_RUNNINGrrs rr7ifaceState.to_strs KK  gg  jj  ff_ kk ! ll " hh  mm # )) )$ '' '"(rclUS:Xa UR$US:Xa UR$US:Xa UR$US:Xa UR$US:Xa UR$US:Xa UR $US:Xa UR $US:Xa UR$US :Xa UR$US :Xa UR$grrrvs rrxifaceState.from_strs  !;;  % 77N ( "::  $ 66M ) #;;  * $<<  & 88O + %== + +&& & / )$$ $*rr N)r r r rrrrrrrrrrrrr:r7rxrr rrr|r|s_!G C F BGH DIOM##,%%rr|c\rSrSrSrSrg)ifaceJsonEncoderic(0n[/5nUR(a3[S[URR 5555nUR US'UR (a5SUR;aSUR ;aSUS'OUR US'UR(aG[UR5S:aURUS'OSRUR5US'URUS 'X#S 'U$) Nc3V# UHupU[U5S:XaUSOU4v M! g7f)rrN)len).0kvs r +ifaceJsonEncoder.default..s/@(> #a&A+!A$1>(>s')nameinetdhcp addr_methodr addr_family autoconfig) rrdictlistitemsrrrrrKr)selfo retconfig retifacedicts rdefaultifaceJsonEncoder.defaults "2 88@(,QXX^^-=(>@@I vv V ==&6Q]]+B.4 ]+./mm ]+ ==1==!A%./mm ]+.1hhq}}.E ]+ vv V!*Xrr Nr r r rrrr rrrrsrrc\rSrSrSrSrg)ifaceJsonEncoderWithStatusi(c0n0n[/5nUR(a[URR55HupVSn/nUHkn UR XW5n U S:Xa[ R n O'U S:Xa[ Rn O[ Rn URSU -5 US- nMm [U5S:XaUSOUX%'[U5S:XaUSOUX5'M UR[R:XdUR[R :Xa[ R n O[ Rn URUS'UR(aURUS'UR (aG[UR 5S:aUR US'OSR#UR 5US'UR$US'X$S 'X4S 'XS 'U$) Nrr%srrrrrr config_statusstatus)rrrrget_config_attr_statusrrprrrArrrjrqrrrrKr) rrrretconfig_statusrrridx vitem_statusvitems status_strrs rr"ifaceJsonEncoderWithStatus.default)s "2 88AHHNN,-! E008AAv%8%>%> a%8%@%@ %8%@%@  ''j(891HC(+1v{qt 9<\9Ja9Ol1oUa #. HH ,, ,K---)//F)11F vv V ==*+--L ' ==1==!A%./mm ]+.1hhq}}.E ]+ vv V!*X(8_%!'Xrr Nrr rrrr(s(rrc$\rSrSr\S5rSrg)ifaceJsonDecoderiSc [[URS[55R55VVs/sH/up#U[ U[5(aUOUR 5/4PM1 snn5US'[ US9$s snnf)Nr) attrsdict)rrgetr isinstancestripiface)r5 ifaceattrdictrrs rjson_to_ifaceobj!ifaceJsonDecoder.json_to_ifaceobjTs"-+/ 0A0A(,7M1;;@57,D/E,DCA12At9L9LA67ggi[0C,D/E#F h}-- /Es6B r N)r r r rr:rrr rrrrSs..rrc\rSrSrSrSrSrSrSrSr Sr S r 04S jr S r S rS rSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSr Sr!S-S jr"S-S!jr#S-S"jr$S#r%S$r&S%r'S&r(S'r)S(r*S.S)jr+S.S*jr,S+r-g,)/ri\aifupdown2 iface object class Attributes: **name** Name of the interface **addr_family** Address family eg, inet, inet6. Can be None to indicate both address families **addr_method** Address method eg, static, manual or None for static address method **config** dictionary of config lines for this interface **state** Configuration state of an interface as defined by ifaceState **status** Configuration status of an interface as defined by ifaceStatus **flags** Internal flags used by iface processing **priv_flags** private flags owned by module using this class **module_flags** module flags owned by module using this class **refcnt** reference count, indicating number of interfaces dependent on this iface **lowerifaces** list of interface names lower to this interface or this interface depends on **upperifaces** list of interface names upper to this interface or the interfaces that depend on this interface **auto** True if interface belongs to the auto class **classes** List of classes the interface belongs to **env** shell environment the interface needs during execution **raw_config** raw interface config from file rrr%r&r'r(z0.1ct/UlURU5 0Ul[RUl[ RUlSUl SUl SUl 0Ul SUl SUlSUl/UlSUl/UlSUl[(RUlSUl[.RUlSUl[4R6Ul[:RUl[>RUl [BRUl"SUl#gNrF)$r_set_attrs_from_dict_config_statusr|rrsrjrrrflags priv_flags module_flagsrefcnt lowerifaces upperifacesclassesenv raw_config linkstatertype priv_datarrolerealnamerSrW link_typer# link_kindr<link_privflagsredependency_type blacklisted)rrs r__init__iface.__init__s !!), 9^^ /!)) 1@ CK OII 6Jc(%% %%  &33&..088 3:: rc0URSS5UlURS5UlURS5UlURS[ 55UlURS5nU(aUR RU5 gg)NrFrrrr)rrrrrrrrA)rattrdictrs rriface._set_attrs_from_dictssLL/ LL( #<< 6ll8[]; ll=1     # #K 0 rc.U=RS- slg)zSincrement refcnt of the interface. Usually used to indicate that it has dependents rNrrs r inc_refcntiface.inc_refcnt q rc.U=RS-slg)z[decrement refcnt of the interface. Usually used to indicate that it has lost its dependent rNrrs r dec_refcntiface.dec_refcntrrc\URnU(aUS;agUR(dgg)zHreturns true if the interface has user provided config, false otherwise )rdhcp6r?TF)rr)rrs ris_config_presentiface.is_config_presents*&& ;*GG{{rc:URRU5 g)z+appends class to the interfaces class list N)rrA)r classnames r set_classiface.set_classs I&rc<XlX R:aX lgg)z&sets state and status of an interface N)rsr)rrsrs rset_state_n_statusiface.set_state_n_statuss KK  K rc0XR:aXlgg)zsets status of an interface N)r)rrs r set_statusiface.set_statuss KK  K rc.U=RU-slgNrrrLs rset_flagiface.set_flags d rc0U=RU)-slgrrrs r clear_flagiface.clear_flags te rcUR(a,XR;aURRU5 ggU/Ulg)add to the list of upperifaces N)rrA)rupperifacenames radd_to_upperifacesiface.add_to_upperifaces=   %5%55  ''76!//D rcUR(a,XR;aURRU5 ggU/Ulg)zadd to the list of lowerifaces N)rrA)rlowerifacenames radd_to_lowerifacesiface.add_to_lowerifacesr rc8URRU5$)rrrr attr_names rget_attr_valueiface.get_attr_values{{y))rcRURRU5nU(aUS$g)z+get first value of the specified attr name rNr)rrattr_value_lists rget_attr_value_firstiface.get_attr_value_first s%++//)4 "1% %rchUH,nURRU5nU(dM'USs $ g)zpget first value of the first attr in the list. Useful when you have multiple attrs representing the same thing. rNr)rattrsattrrs rget_attrs_value_firstiface.get_attrs_value_firsts5 D"kkood3O&q))rcrURRU5nU(aX2$g![a gf=f)z*get n'th value of the specified attr name N)rr Exception)rr attr_indexrs rget_attr_value_niface.get_attr_value_ns>++//)4  &22  s ) 66c\UR(dUR5 UR$)z>get shell environment variables the interface must execute in )r generate_envrs rget_env iface.get_env%sxx    xxrc0nURnURUS'[UR55H/up4SUR 5R SS5-nUSX'M1 Xlg)zugenerate shell environment variables dict interface must execute in. This is used to support legacy ifupdown scripts rzIF_%s-_rN)rrrrupperreplacer)rrrr attr_value attr_env_names rr&iface.generate_env+sgyyG $V\\^ 4 D#TZZ\%9%9#s%CCM!+AC !5rcZURRU/5RU5 gz5add attribute name and value to the interface config N)r setdefaultrArrr.s r update_configiface.update_config7s! y"-44Z@rc$U/URU'gr2rr4s rreplace_configiface.replace_config;s", Irc@URU g![a gf=fr2)rr!rs r delete_configiface.delete_config?s%  I&   s  c:URRU5 gr)rupdate)rrs rupdate_config_dictiface.update_config_dictFs 8$rcbU(dSnURRU/5RU5 URRU/5RU5 US:Xa[R UlgUR [R :wa[RUlgg)zadd attribute name and value to the interface config and also update the config_status dict with status of this attribute config rN)rr3rArrjrprr)rrr. attr_statuss rupdate_config_with_statusiface.update_config_with_statusIsJ y"-44Z@ &&y"5<<[I ! %++DK [[K-- -%--DK.rcUHqnURU5(dMURRU/5RS5 URRU/5RU5 Ms g)NrC)rrr3rAr)r ifaceobjorig attr_namesrDrs r&check_n_update_config_with_status_many,iface.check_n_update_config_with_status_manyWsb$I44Y?? KK " "9b 1 8 8 <    * *9b 9 @ @ M $rc@URRU/5U$)z[get status of a attribute config on this interface. Looks at the iface _config_status dict)rr)rrrs rriface.get_config_attr_statusas"""&&y"5c::rcf^URTR:wagURTR:wagURTR:wagURTR:wagURTR:wagUR TR :wag[ UR5[ TR5:wag[U4SjUR55(ag[U4Sj[URR5555(agg)zcompares iface object with iface object passed as argument Returns True if object self is same as dstiface and False otherwise Fc3J># UHoTR;dMSv M g7fTNr8)rrdstifaces rr iface.compare..tsE[X__,Dtt[s# #c3n># UH*upUTRRU5:wdM&Sv M, g7frPr)rrrrQs rrrRvs348HOO//22t8s%5 5T) rrrrrrrranyrr)rrQs `rcompare iface.comparegs 99 %e 99 %e   x33 3E   x33 3E 99 %e <<8++ +E t{{ s8??3 3 ET[[E E E 4tDKK$5$5$784 4 4(aURSU-5 URUS-5 UR@nU(aURX"-[U5-5 URS5 g)N z : {z family: %srz method: %sz flags: %xz state: %sz status: %sz refcnt: %dz lowerdevs: %szlowerdevs: Nonez upperdevs: %szupperdevs: Nonezrole: rr r!ztype: rrz link_kind: zlink_privflags: z%spriv_flags: BUILTINzconfig: })!inforrKrrrr|r7rsrjrrrstrrrrr r!rrrrrrr#rr<rNrrBUILTINr)rrkrldrs rdump iface.dumps DII&' F\CHHT5E5E,FFFG F\4+;+;;;< F[$**445 F[""4::.// 0 F\##DKK011 2 F\4;;667    KK#a&!88 9 KK!22 3    KK#a&!88 9 KK!22 3 F   y OOW   h-(),DII-78 9  F   y OOW  ! !=-236#dii.-AB C  1E1Ednn1UVW f6H6P6PQUQdQd6efg ??&& 3f<= FZ'(  KK#f+5 6 Crc TSnSnU(a!UR(aSUR-nOSUR-nUR(aUSU-- nSn UR[R :Xa U SU-- n OU SU-- n U(aU SU-- n U(aU SU-- n U(aSn UR [R:XdUR [R:Xa7UR(aU SUR-- n S [R-n O1UR [R:XaS [R-n U (aUS RX5S -- nOXyS -- nUR [R:Xa[US -5 gOXyS -- nURn U (aU(a[!U R#55HupS nU HnSn U(a^UR%X5nUS :XaS [R&-n O3US:XaS [R-n OUS :XaS [R-n U (a"XvSRU <SU<3U 5-S -- nOU(aXvU <SU<S 3-- nUS- nM M [U5 g)NrqrCrzauto %s zvlan %sziface %sz %sz (%s)z[%s]z {0:65} {1:>8} rrz{0:55} {1:>10}r)rrrrrrrrjrprqrrrformatrirrrrr)rfamilyfirstr with_status use_realnamerloutbufr ifacelinerrcname cvaluelistrcvrs r _dump_prettyiface._dump_prettysj DMM&D?D 99 k4' 'F 99 -- - D (I T) )I   'I  , ,I J {000KK;#7#77??$//!99I#%8%>%>>  3 33#%8%@%@@ /00G$NNd**{{k222ftm$3 $& &F e%)&,,.%9!$B!%J" 77C7)/1D1L1L)LJ!V)/1D1J1J)JJ!V)/1D1L1L)LJ!,<,C,C(-r2J-@$@CG#HH"E2/F&FFF1HC!%&:& f rc UR(dURSSURUUS9 gSnURH8nURnU(aUS:XaSU;aSnURXCUUUS9 SnM: g)NT)rrrr)rrrF)rrr)rrrr~r}rs r dump_prettyiface.dump_pretty)s   dD"..*5+7  9&E**".. 6V#3+8M"(K!!&.9.9/;"=+r)rrrrrrrrrrrrrrrrrrrrrrrrsrrrrN)r)FF).r r r rrre HAS_SIBLINGSIFACERANGE_ENTRYIFACERANGE_STARTOLDEST_SIBLINGYOUNGEST_SIBLINGversionrrrrrrrrrrr rrrrr#r'r&r5r9r<r@rErJrrUr\rbrfrnrwrrrr rrrr\s)Z"H!L!!!N#G!#,!\1  '! ! 00*  A.% .<=N; &",#,1-^9v!rr)rjsonlogging collectionsr getLoggerlogrrrr#r<rSr\rerjr| JSONEncoderrrrrr rrrs  #  @4&4&n  <:<%<%|t''.)!1!1)V..nnr