~g*PSrSSKrSSKrSSKrSSKrSSKrSSKrSSKJrJr SSK r SSK r SSK r SSK r SSK J r SSKJrJrJrJrJrJrJrJrJrJrJrJrJrJrJrJr SSKJ r J!r! Sr"Sr#S r$\RJ"S \RL5r'S r("S S 5r)"SS5r*"SS5r+"SS5r,"SS5r-"SS\-5r."SS\-5r/"SS\-5r0"SS\-5r1"SS\-5r2"S S!\-5r3"S"S#\-5r4"S$S%\-5r5"S&S'\-5r6S)S(jr7g)*z:This exports methods available for use by plugins for sos N)timesleep)datetime)sos_get_command_output import_modulegrepfileobjtail is_executableTIMEOUT_DEFAULT path_exists path_isdir path_isfile path_islinklistdir path_joinboldfile_is_binaryrecursive_dict_values_by_key)P_FILEP_LINKc[U5n[R"XR5[R5sSSS5 $!,(df  g=f![ a /s$f=f)z=Return a list of all non overlapping matches in the string(s)N)r refindallread MULTILINEAttributeError)regexfnamefs =/usr/lib/python3/dist-packages/sos/report/plugins/__init__.py regex_findallr"&sE U^q::eVVXr||<^^  s. A3A  A AAA A*)A*c[R"SSU5n[R"SSU5n[R"SSU5RS5nUSUnU$) Nz^/(usr/|)(bin|sbin)/z [^\w\-\.\/]+_/.z ._-r)rsubstrip)commandname_max manglednames r!_mangle_commandr-/sV&&0"g>K&&#{;K&&sK066v>Ka)K c[RS4[RS4[RS4[RS4/nUH$nUS"UR 5(dMUSs $ g)zxreturn a string indicating the type of special node represented by the stat buffer st (block, character, fifo, socket). z block devicezcharacter devicez named pipesocketrr$)statS_ISBLKS_ISCHRS_ISFIFOS_ISSOCKst_mode)st_typests r! _node_typer;7si ~& )*  % ! F  Q4  Q4K r.z!----(?:-| )BEGIN.*?----(?:-| )ENDz -----SCRUBBEDc\rSrSrSrSrSr/r/r/r /r /r SSjr Sr SrSrS rS rS rS rS rSrSrSrSrSrSrS/////04SjrSrg) SoSPredicateKaeA class to implement collection predicates. A predicate gates the collection of data by an sos plugin. For any `add_cmd_output()`, `add_copy_spec()` or `add_journal()` call, the passed predicate will be evaulated and collection will proceed if the result is `True`, and not otherwise. Predicates may be used to control conditional data collection without the need for explicit conditional blocks in plugins. :param owner: The ``Plugin`` object creating the predicate :type owner: ``Plugin`` :param dry_run: Is sos running in dry_run mode? :type dry_run: ``bool`` :param kmods: Kernel module name(s) to check presence of :type kmods: ``list``, or ``str`` of single name :param services: Service name(s) to check if running :type services: ``list``, or ``str`` of single name :param packages: Package name(s) to check presence of :type packages: ``list``, or ``str`` of single name :param cmd_outputs: Command to run, with output string to check :type cmd_outputs: ``list`` of ``dict``s, or single ``dict`` taking form {'cmd': , 'output': } :param arch: Architecture(s) that the local system is matched against :type arch: ``list``, or ``str`` of single architecture :param required: For each parameter provided, should the checks require all items, no items, or any items provided :type required: ``dict``, with keys matching parameter names and values being either 'any', 'all', or 'none. Default 'any'. NFc SnSURS3nURnU(aUVs/sHotU-PM snOUnUSSRU5S3- nURnU(aUV s/sHoU -PM sn OUnUSSRU5S3- nURn U(aU V s/sHoU -PM sn OU n USSRU 5S3- nUR V s/sH"n S US -S XLS -SUS -S XLS -S 3 PM$ n n USSRU 5S3- nUR nU(aUVs/sHoU-PM snOUnUSSRU5S3- nX%-U-$s snfs sn fs sn fs sn fs snf)zdReturn a string representation of this SoSPredicate with optional prefix, suffix and value quoting. z"%s"zdry_run=, zkmods=[,z], z services=[z packages=[z{ cmd: outputz }z cmdoutputs=[zarches=[])dry_runkmodsjoinservicespackages cmd_outputsarch)selfquoteprefixsuffixquotespstrrGkrIspkgsp cmdoutput cmdoutputsarchesas r!__strSoSPredicate.__strs$,,r* /4U+U!U+% '#((5/*#..==5:11QJ1 *SXXh/044}}-2D)Dq D) *SXXd^,C00 "-- . &5.!Fu-=$=#>b !Fx-@$@#A F-  ,sxx 34C8816f-f1*f-F (388F+,A..}v%%-,2* .sE3,E8.E=')FFc"UR5$)zlReturn a string representation of this SoSPredicate. "dry_run=False, kmods=[], services=[], cmdoutputs=[]" _SoSPredicate__strrMs r!__str__SoSPredicate.__str__s zz|r.c$URSSSS9$)zReturn a machine readable string representation of this SoSPredicate. "SoSPredicate(dry_run=False, kmods=[], services=[], cmdoutputs=[])" Tz SoSPredicate())rNrOrPr^r`s r!__repr__SoSPredicate.__repr__s zz_SzIIr.cUS:Xa [U5$US:Xa [U5$US:Xa[U5(+$[SU35e)zHelper to simplify checking the state of the predicate's evaluations against the setting of the required state of that evaluation anyallnonez7predicate requires must be 'any', 'all', or 'none' not )rhri ValueError)rMitemsrequireds r!_check_required_state"SoSPredicate._check_required_statesX u u:  u u:  v 5z> !*   r.cURUnUS:waURURU5 gURURU5 g)zHelper to direct failed predicates to provide the proper messaging based on the required check type :param test: The type of check we're doing, e.g. kmods, arch :param item: The string of what failed rjN)rm_failedappend _forbidden)rMtestitem_reqs r!_failed_or_forbidden!SoSPredicate._failed_or_forbiddensG}}T" 6> LL  % %d + OOD ! ( ( .r.cZUR(a URRS5(ag/nURHJnURRU5nUR U5 U(aM8UR SU5 ML UR XRS5$)Nallow_system_changesTrG)rG_owner get_optionis_module_loadedrrrwrnrm)rM_kmodskmodress r! _eval_kmodsSoSPredicate._eval_kmodsszzT[[334JKKJJD++..t4C MM# 3))'48  ))&--2HIIr.cUR(dg/nURHJnURRU5nURU5 U(aM8UR SU5 ML UR XR S5$)NTrI)rIr{is_service_runningrrrwrnrm)rM_svcssvcrs r!_eval_servicesSoSPredicate._eval_servicessp}}==C++005C LL 3))*c: ! ))%z1JKKr.cUR(dg/nURHJnURRU5nURU5 U(aM8UR SU5 ML UR XR S5$)NTrJ)rJr{ is_installedrrrwrnrm)rM_pkgspkgrs r!_eval_packagesSoSPredicate._eval_packagessp}}==C++**3/C LL 3))*c: ! ))%z1JKKr.cSU;dSU;ag[US5nUSS:wagUSR5HnUSU;dM g g)z*Does 'cmd' output contain string 'output'?rBrDFstatusrT)r splitlines)rM cmd_outputresultlines r!_eval_cmd_outputSoSPredicate._eval_cmd_outputs`  "hj&@' 5(9: ( q 8$//1D(#t+2r.cUR(dg/nURHKnURU5nURU5 U(aM.URSUSSUS35 MM UR XR S5$)NTrKrBrCrD)rKrrrrwrnrm)rM_cmdsrBrs r!_eval_cmd_outputsSoSPredicate._eval_cmd_outputss##C'',C LL 3))!5zl"S]O4 $))%}1MNNr.cUR(dgURRR5nSSR UR5S3nUR SS:Xa;[ R"X!5(aURSRU5 gg[ R"X!5(agURSRU5 g) NT(?:|rdrLrj architectureF) rLr{policyget_archrHrmrmatchrsrrrq)rM_archrs r! _eval_archSoSPredicate._eval_archsyy  ""++-chhtyy)*!, == F *xx%%/66u= 88E ! ! ^$++E2r.cSnSnURR5H8up4U(dM[U5nXUSRSU554-- nM: U$)zLReturn a string informing user what caused the predicate to fail evaluation r$zrequired %s missing: %s.r@c3$# UHov M g7fN.0vs r! .SoSPredicate._report_failed..3,<1Q)rqrlsetrHrMmsg_substrkeyvals r!_report_failedSoSPredicate._report_failed)s^, **,HCc(C c499,<,<#<== =C -  r.cSnSnURR5H8up4U(dM[U5nXUSRSU554-- nM: U$)zhReturn a string informing the user that a forbidden condition exists which caused the predicate to fail r$zforbidden %s '%s' found.r@c3$# UHov M g7frrrs r!r1SoSPredicate._report_forbidden..@rr)rsrlrrHrs r!_report_forbiddenSoSPredicate._report_forbidden6s^,--/HCc(C c499,<,<#<== =C 0  r.cUR5UR5UR(aSOS/nSRU5R 5$)zmUsed by `Plugin()` to obtain the error string based on if the reason was a failed check or a forbidden check z (dry run)r$ )rrrFrHlstriprMrs r!report_failureSoSPredicate.report_failureCsG    !  " " $< UR5=(a' UR5=(a UR5=(a UR (+$)z#Predicate evaluation hook. T) rhrGrIrJrKrLrFrrrrrr`s r!__bool__SoSPredicate.__bool__Ns DJJ t}}d>N>NIIt||-..!!##(;(;(=#$$&#+/+A+A+C#"% $ &r.c $Xl[U5Ul[U5Ul[U5Ul[U5Ul[ U[5(dU/nX`lX RRSR-Ul SSSSSS.Ul URRUR5V V s0sHupXURU :wdMX_M sn n 5 /////S.Ul /////S.Ulgs sn n f)z-Initialise a new SoSPredicate object cmdlineoptsrh)rGrIrJrKrL)rGrIrJrKrN)r{listrGrIrJrL isinstancerKcommonsrFrmupdaterlrqrs) rMownerrFrGrIrJrKrLrmrSrs r!__init__SoSPredicate.__init__\s %[ X X J +t,,&-K&!4!4]!C!K!KK "'U(-u>  %^^- -TQ K4==+ + AD-  RR  RR  s D #D ) rqrsr{rLrKrFrGrJrmrI)Fr$r$)__name__ __module__ __qualname____firstlineno____doc__r{rFrGrIrJrKrLr_rarernrwrrrrrrrrrrr__static_attributes__rr.r!r=r=Ks&PFG EHHK D&@J   / J L L  O&   & &',2"2 r.r=c$\rSrSrSrSrSrSrg) SoSCommandizaA class to represent a command to be collected. A SoSCommand() object is instantiated for each command handed to an _add_cmd_output() call, so that we no longer need to pass around a very long tuple to handle the parameters. Any option supported by _add_cmd_output() is passed to the SoSCommand object and converted to an attribute. SoSCommand.__dict__ is then passed to _get_command_output_now() for each command to be collected. c :URRU5 gr)__dict__r)rMkwargss r!rSoSCommand.__init__s V$r.ctSRS[URR5555$)zIReturn a human readable string representation of this SoSCommand r@c34# UHupUSU3v M g7f)=Nr)rparamrs r!r%SoSCommand.__str__..s$86/;uE7!C5)6s)rHsortedrrlr`s r!raSoSCommand.__str__s4yy8 3 3 5688 8r.rN)rrrrrrrarrr.r!rrzs %8r.rcZ\rSrSrSrSrSrSrSrSr Sr S/r Sr S Sjr SrSrS rS rg) PluginOptiaThis is used to define options available to plugins. Plugins will need to define options alongside their distro-specific classes in order to add support for user-controlled changes in Plugin behavior. :param name: The name of the plugin option :type name: ``str`` :param default: The default value of the option :type default: Any :param desc: A short description of the effect of the option :type desc: ``str`` :param long_desc: A detailed description of the option. Will be used by `sos info` :type long_desc: ``str`` :param val_type: The type of object the option accepts for values. If not provided, auto-detect from the type of ``default`` :type val_type: A single type or a ``list`` of types r$NFcXlX lX0lX@lURUlUb[ U[ 5(dU/nO UR/nXPlgr) namedefaultdesc long_descvaluerr __class__val_type)rMrrrrrs r!rPluginOpt.__init__sO   "\\  h--$:))*H r.cSUR3SURS3SUR3SUR3/nSSR U5-S-$) Nzname=zdesc=''zvalue=zdefault=(r@rd)rrrrrH)rMrls r!raPluginOpt.__str__s^DII; dii[ #TZZL !t||n %   TYYu%%++r.c"UR5$r)rar`s r!rePluginOpt.__repr__s||~r.c P^[S5UR;a[T5Ulg[ U4SjUR55(d/nURHqnUcMUR S:XaUR S5 M+UR S:XaUR S5 MNUR S:XdM`UR S5 Ms [S URS URS S RU5S [T5R 35eTUlg)Nr$c3<># UHn[TU5v M g7fr)r)r_trs r!r&PluginOpt.set_value..s?2:c2&&sboolz boolean true/false (on/off, etc)strzstring (no spaces)intzinteger valueszPlugin option 'r'z' takes r@z, not ) typerrrrhrrr ExceptionpluginrrH)rMrvalidr:s ` r! set_valuePluginOpt.set_values 8t}} $SDJ ????E]]9::'LL!CDZZ5(LL!56ZZ5(LL!12#!$++a {(99U#$F49+=+=*>@  r.)rrrrrr) undefinedNr$r$N)rrrrrrrenabledrrrrrrrarerrrr.r!rrsM, DGG DI EvH FJL !,r.rc\rSrSrSrSrSrSrSrSr Sr Sr Sr Sr SrSr\r\rSr0r0r/rSrSrSrSrSrS rS rS rS rSS jr Sr!\"S5r#\"S5r$Sr%Sr&\'S5r(\'S5r)\'S5r*\'S5r+Sr,Sr-Sr.Sr/Sr0Sr1Sr2Sr3Sr4S r5S!r6S"r7S#r8S$r9S%r:S&r;S'rSS*jr?SS+jr@SS,jrAS-rBSS.jrCS/rDS0rES1rFS2rGS3rHS4rIS5rJS6rKS7rLS8rMS9rNSS:jrOS;rPS<rQSS=jrRS>rSS?rTS@rUSArVSSSBS/S4SCjrWSSSBSSSS///SDS4 SEjrXSSSBSSSS/SDS4 SFjrYSGrZSSSBSSSS/SSS4 SHjr[SSSSBSBSSSSSSSS/SDSSSSS4SIjr\SJr]SKr^SSLjr_SMr`SNraSSOjrbSPrcSS/4SQjrdSSSSBSBSSSSSSS/SDSSSSS4SRjreSSSSBSBSSSSSSSS/S4SSjrfSSTjrgSUrhSVriSSWjrjSXrkSSYjrlSZrmSS[jrnSS\jroSS]jrpSS^jrqSS_jrrS`rsSartSbruScrvSSdjrwSerxSfrySgrzShr{Sir|Sjr}Skr~Slr\GRS/4Smj5rSnrSorSprSqrSrrSsrStrSurSvrSwrSxrSyrSzrS{rS|rS}rS~rSrSrSrSSjrSSjrSrg)PluginiaThis is the base class for sos report plugins. Plugins should subclass this and set the class variables where applicable. :param commons: A set of information that is shared internally so that plugins may access the same dataset. This is provided automatically by sos :type commons: ``dict`` Each `Plugin()` subclass should also subclass at least one tagging class, e.g. ``RedHatPlugin``, to support that distribution. If different distributions require different collections, each distribution should have its own subclass of the Plugin that also subclasses the tagging class for their respective distributions. :cvar plugin_name: The name of the plugin, will be returned by `name()` :vartype plugin_name: ``str`` :cvar packages: Package name(s) that, if installed, enable this plugin :vartype packages: ``tuple`` :cvar files: File path(s) that, if present, enable this plugin :vartype files: ``tuple`` :cvar commands: Executables that, if present, enable this plugin :vartype commands: ``tuple`` :cvar kernel_mods: Kernel module(s) that, if loaded, enable this plugin :vartype kernel_mods: ``tuple`` :cvar services: Service name(s) that, if running, enable this plugin :vartype services: ``tuple`` :cvar architectures: Architecture(s) this plugin is enabled for. Defaults to 'none' to enable on all arches. :vartype architectures: ``tuple``, or ``None`` :cvar profiles: Name(s) of profile(s) this plugin belongs to :vartype profiles: ``tuple`` :cvar plugin_timeout: Timeout in seconds for this plugin as a whole :vartype plugin_timeout: ``int`` :cvar cmd_timeout: Timeout in seconds for individual commands :vartype cmd_timeout: ``int`` Nrr&Fc^/Tl/Tl[5Tl/TlSTlUTl/Tl[5Tl/Tl /Tl /Tl 0Tl USTl USTlUSTlSTlUSR"TlUSR$Tl0Tl/TlSTR ;aTR SO[*R,"S5TlTRR1TR355 TRH%nTR55TRUlM' TR8H1nTR55UlUTRUR4'M3 [;U4Sj[=TR>555Tl TRC[ET55 g) Nr$sysrootrdevicesrsoslogsosc3F># UHnTRU5v M g7fr)is_snap_installedrrrMs r!r"Plugin.__init__..Ks# 3FCD " "3 ' '3F!)# copied_filesexecuted_commandsr _env_varsalerts custom_textrforbidden_paths copy_pathscontainer_copy_paths copy_strings collect_cmdsoptionsrrrmanifest skip_files skip_commandsdefault_environment_tail_files_listlogging getLoggerrrget_default_plugin_optsrr option_listrhrrJis_snap set_predicater=)rMrpoptopts` r!rPlugin.__init__(s!#  !%$&! y) h' y)  !-0;;$]3AA#% "08DLL0Hdll8,""5)  D88:;LLD(, DLL  %!##CCJ%(DLL "$  37 3F   <-.r.c b[SS[SS9[SS[SS9[SS[S S9S .$) Ntimeoutz7Timeout in seconds for plugin to finish all collections)rrr cmd-timeoutz4Timeout in seconds for individual commands to finishpostprocTz(Enable post-processing of collected data)r)r+r,)rrrr`s r!r!Plugin.get_default_plugin_optsRsF 2N%rCK"D4?  r.cXlURRSS5 URRSS5 URRSS5 URRSS5 URRSS5 URRSS5 URRSS5 URRS S5 URRS S5 URRS UR5 URRS S 5 URRSUR5 URR S/5 URR S/5 URRS05 URRS05 URR S/5 g)zPass in a manifest object to the plugin to write to :param manifest: The manifest that the plugin will add metadata to :type manifest: ``SoSManifest`` start_timer$end_timerun_time setup_start setup_end setup_timepostproc_start postproc_end postproc_timer) timeout_hitFcommand_timeoutcommandsfilesstrings containers collectionsN)r add_fieldr) cmdtimeoutadd_list)rMrs r!set_plugin_manifestPlugin.set_plugin_manifestbsg !   b1  B/  B/  r2  R0  b1  0"5 3 4  4<<8  u5  14??C z2. w+  2.  b1 }b1r.c[U[5(d [S5eXlUR SUR35 g)z Specify a collection of environment variables that should always be passed to commands being executed by this plugin. :param env_vars: The environment variables and their values to set :type env_vars: ``dict{ENV_VAR_NAME: ENV_VAR_VALUE}`` z:Environment variables for Plugin must be specified by dictz0Default environment for all commands now set to N)rdict TypeErrorr _log_debugrMenv_varss r!set_default_cmd_environment"Plugin.set_default_cmd_environment|sI(D))L $,  J3346 7r.c[U[5(d [S5eURSUS35 URR U5 g)z Add or modify a specific environment variable in the set of default environment variables used by this Plugin. :param env_vars: The environment variables to add to the current set of env vars in use :type env_vars: ``dict`` z,Environment variables must be added via dictzAdding z to default environmentN)rrErFrGrrrHs r!add_default_cmd_environment"Plugin.add_default_cmd_environmentsG(D))JK K '(+BCD   ''1r.cUc UR$[U[5(d [S5eURR 5nUR U5 U$)z Get the merged set of environment variables for a command about to be executed by this plugin. :returns: The set of env vars to use for a command :rtype: ``dict`` z'Command env vars must be passed as dict)rrrErFcopyr)rMenv_envs r!_get_cmd_environmentPlugin._get_cmd_environmentsS ;++ +#t$$EF F'',,. C r.cSnURU5n[URU55nUcUnO/UbUS:XaU[:XaUnO[U5nO Ub US:aUnOgUbUS:aU$U$![a Us$f=f)a Get the timeout value for either the plugin or a command, as determined by either the value provided via the plugin.timeout or plugin.cmd-timeout option, the global timeout or cmd-timeout options, or the default value set by the plugin or the collection, in that order of precendence. :param optname: The name of the cmdline option being checked, either 'plugin_timeout' or 'timeout' :type optname: ``str`` :param plugoptname: The name of the plugin option name being checked, either 'timeout' or 'cmd-timeout' :type plugoptname: ``str`` :param default_timeout: The timeout to default to if determination is inconclusive or hits an error :type default_timeout: ``int`` :returns: The timeout value in seconds :rtype: ``int`` Nr*)r|rr rk)rMoptname plugoptnamedefault_timeout_timeout opt_timeout own_timeouts r!timeout_from_optionsPlugin.timeout_from_optionss. #//'2Kdook:;K"&([B->/1.H";/H([2-=&  HrMO  #" " #s"0A1A1 A1 A11 B?Bc@URSSUR5nU$)zReturns either the default plugin timeout value, the value as provided on the commandline via -k plugin.timeout=value, or the value of the global --plugin-timeout option. plugin_timeoutr))r\r_)rMrYs r!r)Plugin.timeouts( ,,-=y-1-@-@Br.c@URSSUR5nU$)zReturns either the default command timeout value, the value as provided on the commandline via -k plugin.cmd-timeout=value, or the value of the global --cmd-timeout option. cmd_timeoutr+)r\rb)rM _cmdtimeouts r!r@Plugin.cmdtimeouts( // }040@0@B r.cSUlURRS[R"55 URRSS5 g)NTr0r8) _timeout_hitrr?rnowr`s r!set_timeout_hitPlugin.set_timeout_hits8   HLLN;  t4r.cUR$)a  Checks to see if the plugin has hit its timeout. This is set when the sos.collect_plugin() method hits a timeout and terminates the thread. From there, a Popen() call can still continue to run, and we need to manually terminate it. Thus, check_timeout() should only be called in sos_get_command_output(). Since sos_get_command_output() is not plugin aware, this method is handed to that call to use as a polling method, to avoid passing the entire plugin object. :returns: ``True`` if timeout has been hit, else ``False`` :rtype: ``bool`` )rfr`s r! check_timeoutPlugin.check_timeouts"   r.cpUR(a UR$URR5$)z[Get the name of the plugin :returns: The name of the plugin, in lowercase :rtype: ``str`` ) plugin_namerlower)clss r!r Plugin.names( ???? "||!!##r.cdURcURU5 gURU5 gr)rndisplay_self_helpdisplay_plugin_help)rpsections r! display_helpPlugin.display_help s( ?? "  ! !' *  # #G ,r.c SSKJn URURR 5SUR 35 SnSnUR SnU[:waUR(a URnUR(aX@R- nURSU(aUOU35 [URURURURUR UR"/5(dURS5 OS HDn[%XS5(dMURS US S R'[%X553S S9 MF [%US5(a3URSS R'SUR"553S S9 UR((a3URSS R'SUR(553S S9 [+US5(a3URSS R'SUR,553S S9 UR.[R.LaURS5 UR0(dgUR3S5nURS[5SURS35S35 UR[5SSSS S!S"S#S$S!35S S9 S%nUR0Hn U R6n U bU S:XaS&n [9U R6[:5(aU R6(aS'n OS(n SSU R<S!U S#U R>S!3n UR[@RB"XUS)9S S9 U RD(dMUS*- n S+n UR[@RB"U RDU U U S,9S S9 M g![a SnGN9f=f)-Nr)TERMSIZEz Plugin Information - z8 Detailed information is not available for this plugin. r$r1z z)This plugin is always enabled by default.)rJr:r; kernel_modsrIz Enabled by rCr@Fnewliner=z+Enabled by containers with names matching: c3$# UHov M g7frr)rcs r!r-Plugin.display_plugin_help..7s ;NqNrz%Enabled with the following profiles: c3$# UHov M g7frr)rrVs r!rr>s5 1Q rverify_packagesz) Verfies packages (when using --verify): c3$# UHov M g7frr)rrs r!rrFs@,?SS,?rzThis plugin performs post-processing on potentially sensitive collections. Disabling post-processing may leave sensitive data in plaintext.zPlugin Optionsz/These options may be toggled or changed using 'z-k z.option_name=$valuer rz<4z Option Namez<20Default<30 Descriptionz6 z None/UnsetzTrue/Onz False/Off)widthsubsequent_indent z )rinitial_indentr)#sos.helpry set_titlerntitle short_desc__mro__rrradd_textrhrJr:r;rzrIr=getattrrHprofileshasattrrr,r" add_sectionrrrrrrtextwrapfillr)rprurymissing_doc_sctrigoptsec opt_indentr&_def_ln_sizespaces r!rtPlugin.display_plugin_helps%S__22455K ^^,. /N D++a.Cf}{{{{ # 6$$G!<=>CLL#,, 3??LL#..233   H I%3d++$$%dV2dii8J.K-LM %%%sL))  Ayy ;CNN ;;<>!! <<   7995 5568   3) * *   <99@C,?,?@@AC   <?@A D   Bs2h}S1)C"3') +   ??C;;D|trz##++t,,;;$D&DHSXXcN4*SXXcNCC OO c0:<   }}} 2 MM#--u1649;"  '#y D sAO OOcFURS5 URS[S5S35 URS5nURS5 URS[S5S [S 5S 35 URS [S 5S35 URS5nURS[S5S[S5S35 URS5nSSS.nURSSR SUR 555-SS9 g)NzSoS Plugin Detailed Helpz;Plugins are what define what collections occur for a given z sos reporta execution. Plugins are generally representative of a single system component (e.g. kernel), package (e.g. podman), or similar construct. Plugins will typically specify multiple files or directories to copy, as well as commands to execute and collect the output of for further analysis.zPlugin EnablementzPlugins will be automatically enabled based on one of several triggers - a certain package being installed, a command or file existing, a kernel module being loaded, etc...z:Plugins may also be enabled or disabled by name using the z-e $namez or z-n $namez options respectively.zCertain plugins may only be available for specific distributions or may behave differently on different distributions based on how the component for that plugin is installed or how it operates. When using zsos help report.plugins.$pluginzY, help will be displayed for the version of the plugin appropriate for your distribution.zUsing Plugin OptionszMany plugins support additional options to enable/disable or in some other way modify the collections it makes. Plugin options are set using the z#-k $plugin_name.$option_name=$valuez syntax. Options that are on/off toggles may exclude setting a value, which will be interpreted as enabling that option. See specific plugin help sections or z sos report -lz& for more information on these optionszSee AlsozHelp for a specific $pluginz$Information on distribution policies)zreport.plugins.$pluginpolicieszLAdditional relevant information may be available in these help sections: %src3<# UHupSSUSUS3v M g7f)rz>8rNr)rsecrs r!r+Plugin.display_self_help..s,/!.ICr(3s)D:.!.sFr{)rrrrrHrl)rprusubsecrseealso_alsos r!rsPlugin.display_self_helpzsh45 IL!"#  $$%89 =  HJ T*%5$66L N   ABCD  $$%;< !!%&K!L MN126o1F0GH0  0 %%j1&C>   #%)YY/!&/&   r.cjSUR5SURSS5R53$)Nz[plugin:z] utf-8replace)rencodedecoders r! _format_msgPlugin._format_msgs5499;-r::gy188:;= >r.cXURRURU55 gr)rerrorrrs r! _log_errorPlugin._log_error $**3/0r.cXURRURU55 gr)rwarningrrs r! _log_warnPlugin._log_warns D,,S12r.cXURRURU55 gr)rinforrs r! _log_infoPlugin._log_infos ))#./r.cXURRURU55 gr)rdebugrrs r!rGPlugin._log_debugrr.cUR5(dU$UR(a8URUR5(aU[UR5S$U$)zRemove the configured sysroot from a filesystem path :param path: The filesystem path to strip sysroot from :type path: ``str`` :returns: The stripped filesystem path :rtype: ``str`` N) use_sysrootr startswithlenrMpaths r! strip_sysrootPlugin.strip_sysrootsM!!K <URXS9nUb [U5$g)aqTest the current predicate and return its value. :param cmd: ``True`` if the predicate is gating a command or ``False`` otherwise. :param pred: An optional predicate to override the current ``Plugin`` or command predicate. :returns: ``True`` or ``False`` based on predicate evaluation, or ``False`` if no predicate :rtype: ``bool`` rBrF)rrrs r!test_predicatePlugin.test_predicateks*!!c!5  : r.cUc [U5nSUSUR53nU(aUS- nURU5 g)aLog that a command was skipped due to predicate evaluation. Emit a warning message indicating that a command was skipped due to predicate evaluation. If ``kmods`` or ``services`` are ``True`` then the list of expected kernel modules or services will be included in the log message. If ``allow_changes`` is ``True`` a message indicating that the missing data can be collected by using the "--allow-system-changes" command line option will be included. :param cmd: The command that was skipped :type cmd: ``str`` :param pred: The predicate that caused the command to be skipped :type pred: ``SoSPredicate`` :param changes: Is the `--allow-system-changes` enabled :type changes: ``bool`` Nzskipped command '': z3 Use '--allow-system-changes' to enable collection.)r=rr)rMrBrchangesrs r!log_skipped_cmdPlugin.log_skipped_cmd|sI& <%D!#c$*=*=*?)@A  H HC sr.cUR(dgURSU35 U(a [SU3O[nURU[U5$)aRemove certificate and key output archived by sos report. Any matching instances are replaced with: '-----SCRUBBED' and this function does not take a regexp or substituting string. :param cmd: The name of the binary to scrub certificate output from :type cmd: ``str`` :param desc: An identifier to add to the `SCRUBBED` header line :type desc: ``str`` :returns: Number of replacements made :rtype: ``int`` rz/Scrubbing certs and keys for commands matching r)rrG _cert_replacedo_cmd_output_sub _certmatch)rMrBrrs r!do_cmd_private_subPlugin.do_cmd_private_subsR%% =cU C E04]O1TF+%%c:w??r.c 2SU-S-n[US5(a UROUnURSUSUSUS35 UR(dgSnURHnUS cM US S :XaUR S US S35 M.[ R "USU5(dMO[ RRURSUS 5nURSUS35 URRU5n [R"X#U R55upU(dMURRX5 M U$![ a(n Sn UR#U WS U 4-5 SnSn A U$Sn A ff=f)aApply a regexp substitution to command output archived by sos This is used to obfuscate sensitive information captured by command output collection via plugins. :param cmd: The command name/binary name for collected output that needs to be obfuscated. Internally globbed with a leading and trailing `*` :type cmd: ``str`` :param regexp: A regex to match the contents of the command output against :type regexp: ``str`` or compile ``re`` object :param subst: The substitution string used to replace matches from `regexp` :type subst: ``str`` :returns: Number of replacements made :rtype: ``int`` *patternsubstituting 'z' for 'z' in commands matching 'rrNfilebinaryyesz3Cannot apply regex substitution to binary output: 'exerBcmddirzapplying substitution to '-regex substitution failed for '%s' with: '%s')rrrGrrfnmatchrrrHrr open_filersubnr add_stringrr) rMrBregexpsubstglobstrr replacementscalledrreadablerers r!rPlugin.do_cmd_output_subs,)c/$+FI$>$>&..F UG77)4y  %%  00&>)(#u,NN$006u a$AB??6%='::77<< X(>vODOO&@a$HI#||55d;H+-77x}},8(F#| //=1*  AC OOC6%=!"44 5L  s&AE$3B E$E$$ F.FFc\URSU35 [R"U5RnU(a [SU3O[nUR Vs/sHoS"US5(dMUPM nnUH(nUSnU(dMUR U[U5 M* gs snf)aqScrub certificate/key/etc information from files collected by sos. Files matching the provided pathregex are searched for content that resembles certificate, ssh keys, or similar information. Any matches are replaced with "-----SCRUBBED $desc" where `desc` is a description of the specific type of content being replaced, e.g. "-----SCRUBBED RSA PRIVATE KEY" so that support representatives can at least be informed of what type of content it was originally. :param pathregex: A string or regex of a filename to match against :type pathregex: ``str`` :param desc: A description of the replaced content :type desc: ``str`` z,Scrubbing certs and keys for paths matching rsrcpathdstpathN)rGrcompilerrr do_file_subr) rM pathregexrrrr file_listirs r!do_file_private_subPlugin.do_file_private_subs F$+' ( 9%++/3]O1TF+ $ 1 1I 11U1Y<5HQ 1 IAYG!!!#bffryy&8"9":; OO0 ; 'y+ ,G .  K&&*oog&>%?A B$$W- g/ ??7 # # OOfXJ.KL M    W-4-2.6"8 9  GGG  28*F7)1MN  '' 5/[[..    w  4 OOfXJ/(( )% ww"}& 2;!;< sJ.. K,8%K''K,cURU5HKnURSUSUS35 [RR X5nUR U5 MM g![ anUR[R:Xd[R(aSnURSUSU35 SnAgUR[R:XaSnURSUS US35 SnAgeSnAff=f) Nzrecursively adding 'z' from 'rzPermission deniedz _copy_dir: 'z' z)Too many levels of symbolic links copyingz _copy_dir: z ') rrGrrrHrXr7r8EPERMEACCESrELOOPr)rMr,rrr)rs r! _copy_dirPlugin._copy_dirs  W-"6tf=$$+9A!/0ww||G2""4( .  ww%++%)gYb>?ww%++%A+cU"WIQ ?@  s%A A## D-A C<>8C<;C<<DcUR5(aURU5nURHnXS:XdM USs $ g)Nr,r-)rrr)rMr,copieds r!r6Plugin._get_dest_for_srcpathsJ     nnW-G''F++i(((r.cB^[U4SjUR55$)Nc3R># UHn[R"UT5v M g7frrr)rforbidrs r!r,Plugin._is_forbidden_path..s# 1EvBHHVT " "1E$')rhrrs `r!_is_forbidden_pathPlugin._is_forbidden_paths# 151E1E   r.cV^[U4SjURR55$)Nc3R># UHn[R"TU5v M g7fr)r)rfprs r!r3Plugin._is_policy_forbidden_path..s# 0K"GOOD" % %0Krn)rhrrrs `r!_is_policy_forbidden_path Plugin._is_policy_forbidden_paths' 04 0K0K   r.cdURH n[R"X5(dM g g)zCheck if the given path matches a user-provided specification to ignore collection of via the ``--skip-files`` option :param path: The filepath being collected :type path: ``str`` :returns: ``True`` if file should be skipped, else ``False`` TF)rr)rMr _skip_paths r!rQPlugin._is_skipped_paths)//Jt00*r.c[R"UR5n[R"UR5nURnUR R X[R"X455 gr)rmajorst_rdevminorr7radd_nodemakedev)rMrr8dev_majdev_minmodes r! _copy_nodePlugin._copy_nodesL((2::&((2::&zz d"**W*FGr.cUR(agURU5(aURSUS35 gU(dUnUR5(aUR U5n[ R "U5n[R"UR5(aURU5 g[R"UR5(an[ R"U[ R5(aDUR!U5(dUR"R%U5 gUR'U5 g[R("UR5(dZ[R"UR5(d5[+U5nURSUSUS35 UR-X$5 gURSUSUS35 URS -(dUR"R/S U5 OUR"R1XUS 9 UR2R5UUS S .5 g![a URSUS35 gf=f)zCopy file or directory to the destination tree. If a directory, then everything below it is recursively copied. A list of copied files are saved for use later in preparing a report. Nskipping forbidden path 'rfailed to stat 'z creating z node at archive:'zcopying path 'z' to archive:'i$r$rLno)r,r-rI)rfrorGrrrlstatr7rr2S_ISLNKr7r^S_ISDIRaccessR_OKrradd_dirrdS_ISREGr;rr"add_filerrr)rMr,rZrMr8ntypes r!rXPlugin._do_copy_paths     " "7 + + OO7yB CD     %%d+D '"B << # #   w ' << # # '277(C(C<<(( $$T* NN7 # RZZ((DLL,D,DrNE OOiw.@aH I OOD % . vQGHzzE! LL # #B - LL ! !'u ! =   "  M  NN-gYa8 9 s/II32I3cR[U[5(aU/nUR5(a UVs/sHo RU5PM nnUHOnUR SUS35 SU;a[ R "U5nURRU5 MQ gs snf)zSpecify a path, or list of paths, to not copy, even if it's part of an ``add_copy_spec()`` call :param forbidden: A filepath to forbid collection from :type forbidden: ``str`` or a ``list`` of strings zadding forbidden path 'rrN) rrrrrr translaterrr)rM forbiddenr rls r!add_forbidden_pathPlugin.add_forbidden_paths i % %" I     4=>Iq*II>F NN4VHA> ?f}!**62  ' ' /  ?sB$cXR;a URURU5 gg![anURU5 eSnAff=f)a(Set the named option to value. Ensure the original type of the option value is preserved :param optioname: The name of the option to set :type optioname: ``str`` :param value: The value to set the option to :returns: ``True`` if the option is successfully set, else ``False`` :rtype: ``bool`` TNF)rrrr)rM optionnamererrs r! set_optionPlugin.set_optionsS  %  Z(2259 $ s1 AA  AcSnX;a[URSU5$XR;a1URUnU(a URb UR$U$U$)aRetrieve the value of the requested option, searching in order: parameters passed from the command line, set via `set_option()`, or the global_plugin_options dict. `optionname` may be iterable, in which case this function will return the first match. :param optionname: The name of the option to retrieve the value of :type optionname: ``str`` :param default: Optionally provide a default value to return if no option matching `optionname` is found. Default 0 :returns: The value of `optionname` if found, else `default` )all_logsrzrb journal_sizelog_sizer_sinceverifyr)rrrr)rMrrglobal_optionsr&s r!r|Plugin.get_option1s_"   '4<< 6 C C  %,,z*Ccii3yy Nr.c:URRU5 gr)rr)rMrs r!_add_copy_pathsPlugin._add_copy_pathsQs z*r.cUH#n[X[5(dMX/X'M% URRU5 g)aApply a tag to a file matching a given regex, for use when a file is copied by a more generic copyspec. :param tagdict: A dict containing the filepatterns to match and the tag(s) to apply to those files :type tagdict: ``dict`` `tagdict` takes the form `{file_pattern: tag}`, E.G. to match all bond devices from /proc/net/bonding with the tag `bond`, use `{'/proc/net/bonding/bond.*': ['bond']}` N)rrfiletagsr)rMtagdictrs r! add_file_tagsPlugin.add_file_tagsTs=E'.#..").!1 W%r.c/nURR5H3up4[R"X15(dM"UR U5 M5 U$)zGet the tags that should be associated with a file matching a given regex :param fname: A regex for filenames to be matched against :type fname: ``str`` :returns: The tag(s) associated with `fname` :rtype: ``list`` of strings )rrlrrextend)rMrtagsrrs r!get_tags_for_filePlugin.get_tags_for_fileesD ++-HCxx## C . r.cjURR5HupU/US.n/nURHFn[R"XS5(dM#UR USR S55 MH U(dMlXCS'URRR U5 M g)zAfter file collections have completed, retroactively generate manifest entries to apply tags to files copied by generic copyspecs  specification files_copiedrr,r-r&rN) rrlrrrrrrrr;)rM file_regextag manifest_data matched_filescfiles r!generate_copyspec_tagsPlugin.generate_copyspec_tagsus $}}224OJ!+ "M M**88Ji(899!((y)9)@)@)EF+}0=n- ##**=9 5r.Tc  ^^^^^SmURS5(aURS5m[R"S5m[R"SURS5S35mUR US9(d&UR SUS UR US9S 35 gUcURS 5nURS 5(aSnU(aUS -nU(dg[U[5(aU/n[U[5(aU/nSnSmUUUUU4Sjn UGH$n U (a[U 5(d gU(dIUR5(aURU 5n URU 5n [U 5S:XaMlOU /n /n [U 5S:XaFU"U S5n U (aU RU 5 U RURU S55 U RU5 [[!U 55n U(a[U[5(aU/nUHnUR#U5(dMSnU(aUSU 3nUR%UUS9nUSS:Xa['US5nUU:aSnOUR+SU SUSUS35 MyUR,RXX/U 45 UR SU SUS 35 M GMT(dT(a[[/X55n U R1TSS!9 SnSn/nU GHnUUR2;aUR+S"US 35 M+UR5U5(aUR+S#US 35 MXUR7U5(aUR+S$US 35 MUR9U5(aUR+S%US 35 MU(aUR S&US'35 M[:R<"U5[<R>nUU- nU(aUU:aSnU(a[EU5(aUR S*US+35 GM;UR S*US,35 UU-U- nURFRUU45 URURIS-55 GMGMURURIS-55 URKU/5 U=(a UU:HnGM U(aGMURL(dGMURLRNRU UU S..5 GM' g![(a UR SU SUS35 GMCf=f![@a5 URCU5(aSnGNUR S(US)35 GMf=f)/a)Add a file, directory, or globs matching filepaths to the archive :param copyspecs: Files, directories, or globs matching filepaths :type copyspecs: ``str`` or a ``list`` of strings :param sizelimit: Limit the total size of collections from `copyspecs` to this size in MB :type sizelimit: ``int`` :param maxage: Collect files with `mtime` not older than this many hours :type maxage: ``int`` :param tailit: Should a file that exceeds `sizelimit` be tail'ed to fit the remaining space to meet `sizelimit` :type tailit: ``bool`` :param pred: A predicate to gate if `copyspecs` should be collected :type pred: ``SoSPredicate`` :param tags: A tag or set of tags to add to the metadata information for this collection :type tags: ``str`` or a ``list`` of strings :param container: Container(s) from which this file should be copied :type container: ``str`` or a ``list`` of strings `copyspecs` will be expanded and/or globbed as appropriate. Specifying a directory here will cause the plugin to attempt to collect the entire directory, recursively. If `container` is specified, `copyspecs` may only be explicit paths, not globs as currently container runtimes do not support glob expansion as part of the copy operation. Note that `sizelimit` is applied to each `copyspec`, not each file individually. For example, a copyspec of ``['/etc/foo', '/etc/bar.conf']`` and a `sizelimit` of 25 means that sos will collect up to 25MB worth of files within `/etc/foo`, and will collect the last 25MB of `/etc/bar.conf`. Nrz".*((\.(zip|gz|bz2|xz))|[-.][\d]+)$^etcz/*rzskipped copy spec 'z' due to predicate (rdrriFcURS5(agURS5SnURSS5nURS5(aURSS5$g) zGenerate a tag to add for a single file copyspec This tag will be set to the filename, minus any extensions except for special extensions like .conf or .log, which will be mangled to _conf or similar. )z/procz/sysNr&r*-r%)z.confz.logz.txtr')rsplitrendswith)r_fnames r!get_filename_tag.Plugin.add_copy_spec..get_filename_tags` 122[[%b)F^^C-F899~~c3//r.cb[RRU5$![a gf=f)z{Files should be sorted in most-recently-modified order, so that we collect the newest data first before reaching the limit.r)rrgetmtimer7)rs r!r&Plugin.add_copy_spec..getmtimes. ww''--  s ! ..c>TRU5bTRU5bgT"U5n[R"U5nT(aUT:dT(a[5U- TS-:agg)z_When --since is passed, or maxage is coming from the plugin, we need to filter out older files TiF)searchr fromtimestampr)rfiletime filedatetimeconfigfile_patternrlogarchive_patternmaxagers r! time_filter)Plugin.add_copy_spec..time_filtersg $**408"))$/;~H#11(;L<%/DF8OfTk9r.rr1z stat -c %s  containerrrDTzunable to determine size of 'z' in container 'z'. Skipping collection.z stat of 'z' failed, skipping collection: zadded collection of '' from container 'r)rreversezskipping redundant file 'rz skipping policy forbidden path 'rGz skipping 'z' over size limitrz ', skippingzFile 'z8' is over size limit and is binary. Skipping collection.zI' is over size limit, will instead tail the file during collection phase.r&r)(r|rr.rrrrrrrr_expand_copy_specrrrrrrcontainer_existsexec_cmdrrkrGrfiltersortrrorurQrr2ST_SIZEr7rrrrrrr;)rM copyspecs sizelimitrtailitrrrrrcopyspecr; _spec_tags_speccon_tailrBretconsize current_size limit_reached_manifest_files_file file_sizeadd_sizerrrrs ` @@@@r! add_copy_specPlugin.add_copy_specsV ??7 # #OOG,EZZ(MNZZ1T^^E-B,C2(FG"""- NN0 < $ 2 2 2 =>aA B   3I ??: & &I   $I i % %" I dC 6D    "HX##%%#~~h7H..x8u:?#" J5zQ(q2%%e,!!$"8"8q"BC   d #c*o.Ji--!* I$C0055 !E !,H:6"mmC3m?x=A- )*-c(m*<#*Y#6,0E!OO"+H:5EcUK@#&x=/!34%--44 *ENN/z:5#=%JVK78 JJ8TJ 2L!M ODOO+OO&?wa$HI**511OO&?wa$HI11%88OO:5'CE((//OO&>ugQ$GH NNZw6G#HI ! "t|| "U;:U;>"V=#V=<V=rc2^/n[U [5(aU /n [U[5(aU/n[URU5nU (aG[U [5(aU /n UV^s/sH!m[ U4SjU 55(dMTPM# nnU (aG[U [5(aU /n UV^s/sH!m[ U4SjU 55(aMTPM# nnUR U 5 UR UUUXEUXxU XUS9 gs snfs snf)aRun a command or list of commands against devices discovered during sos initialization. Any commands specified by cmd will be iterated over the list of the specified devices. Commands passed to this should include a '%(dev)s' variable for substitution. :param cmds: The command(s) to run against the list of devices :type cmds: ``str`` or a ``list`` of strings :param devices: The device paths to run `cmd` against. This should be either a list of devices/device paths or a key in the devices dict discovered by sos during initialization. :type devices: ``str`` or a ``list`` of devices or device paths. :param timeout: Timeout in seconds to allow each `cmd` to run :type timeout: ``int`` :param sizelimit: Maximum amount of output to collect, in MB :type sizelimit: ``int`` :param chroot: Should sos chroot the command(s) being run :type chroot: ``bool`` :param runat: Set the filesystem location to execute the command from :type runat: ``str`` :param env: Set environment variables for the command(s) being run :type env: ``dict`` :param binary: Is the output collected going to be binary data :type binary: ``bool`` :param prepend_path: The leading path for block device names :type prepend_path: ``str`` or ``None`` :param whitelist: Limit the devices the `cmds` will be run against to devices matching these item(s) :type whitelist: ``list`` of ``str`` :param blacklist: Do not run `cmds` against devices matching these item(s) :type blacklist: ``list`` of ``str`` :param subdir: Write the command output to this subdir within the Plugin directory :type subdir: ``str`` c3X># UHn[R"SU3T5v M! g7fz(.*)?Nrk)rwlds r!r(Plugin.add_device_cmd..%GYrE",22Y'*c3X># UHn[R"SU3T5v M! g7frrk)rblrs r!rrrr) r)rchrootrunatrQr prepend_pathrprioritysubdirN)rrrrrhr_add_device_cmd)rMcmdsrr)rrrrQrr whitelist blacklistrrr _dev_tags_devsrs `r!add_device_cmdPlugin.add_device_cmdsj dC 6D gs # #iG,T\\7C )S))&K %I1GYGGEI )S))&K %I1GYGGEI  T5''0u!$,"+v  OIIs.DD<DDc L[U[5(aU/n[U[5(aU/nU=(d URS5nUHTn UHKnU/nURU 5 U (aUR X5nU SU0-nUR UUXEXgUXU S9 MM MV g)zCRun a command against all specified devices on the system. rdev) rBr)rrrrQrrrrN)rrr|rr_add_cmd_output)rMrrr)rrrrQrrrrrrBdevicer_cmds r!rPlugin._add_device_cmds dC 6D gs # #iG<!< C!#H   &!^^LAFeV_,$$w/8+0&*3,2 %4 "r.c ZSU;aURS5O [U5nSU;aSUS'SU;aSUS'[[S0UD6SS5(d)UR S5(d USS :Xa S US'S US 'SU;aURS5 [S0UD6nUR S [ U535 URHJn[R"URU5(dM+UR S URS35 g URS US9(a]URRU5 Sn[USS5bSURS3nURSURSU35 gURURX#R S9 g)z?Internal helper to add a single command to the collection list.rrrr Fsnap_cmdrrrTto_filezpacked command: zskipping excluded command 'rNrr$runas , as the  userzadded cmd output 'r r)popr=rrr|rGrrrrBrrrrrrr r )rMrrsoscmd _skip_cmdusers r!r Plugin._add_cmd_outputs&,v%5vzz&!<;M V #!#F:  F " %F9  ,V,j%@@ OOJ ' '6++>!+C"#F;  $F9    JJz "%f% *3v;-89++I vzz955"=fjj\ KL,   4d  3    $ $V ,Dvw-9"6<<.6 NN/ |1TFC D  T>> Jr.c [U[5(aU/nU (a)UV s/sHn URXS9(dMU PM nn O)UV s/sHoRU 5(dMU PM nn U(dSU(aSOS3nOSnUH(nUR U(aSOSSUS U3XEXgXXU S 9 M* g s sn fs sn f) a] Used as a way to standardize our collections of directory listings, either as an output of `ls` or `tree` depending on if the `tree` parameter is set to `True`. This is ultimately a wrapper around `add_cmd_output()` and supports several, but not all, of the options for that method. :param paths: The path(s) to collect a listing for :type paths: ``str`` or a ``list`` of ``str``s :param tree: Collect output with `tree` instead of `ls` :type tree: ``bool`` (default: False) :param recursive: Recursively list directory contents with `ls` :type recursive: ``bool`` (default: False) ralZRr$lptreelsz -r) rrQrrrrrrsuggest_filenameN)rrcontainer_path_existsr add_cmd_output)rMrr recursiverrQrrrrrrr rVrrs r!add_dir_listingPlugin.add_dir_listing s* eS ! !GE  %I1///GEIE!&=1)9)9!)sB9B9 B>*B>c[U[5(aU/n[U5S:aU(dU(aURS5 U cUR S5n U cUR SS9n UHcnSnU(a9UnUU4nUR UU5nU(dURSUSUS 35 MEURUUX4XVUXU XUXUUUUUUS 9 Me g) a& Run a program or a list of programs and collect the output Output will be limited to `sizelimit`, collecting the last X amount of command output matching `sizelimit`. Unless `suggest_filename` is set, the file that the output is saved to will match the command as it was executed, and will be saved under `sos_commands/$plugin` :param cmds: The command(s) to execute :type cmds: ``str`` or a ``list`` of strings :param suggest_filename: Override the name of the file output is saved to within the archive :type suggest_filename: ``str`` :param root_symlink: If set, create a symlink with this name in the archive root :type root_symlink: ``str`` :param timeout: Timeout in seconds to allow each `cmd` to run for :type timeout: ``int`` :param stderr: Should stderr output be collected :type stderr: ``bool`` :param chroot: Should sos chroot the `cmds` being run :type chroot: ``bool`` :param runat: Run the `cmds` from this location in the filesystem :type runat: ``str`` :param env: Set environment variables for the `cmds` being run :type env: ``dict`` :param binary: Is the command expected to produce binary output :type binary: ``bool`` :param sizelimit: Maximum amount of output in MB to save :type sizelimit: ``int`` :param pred: A predicate to gate if `cmds` should be collected or not :type pred: ``SoSPredicate`` :param subdir: Save output to this subdirectory, within the plugin's directory under sos_commands :type subdir: ``str`` :param changes: Do `cmds` have the potential to change system state :type changes: ``int`` :param foreground: Should the `cmds` be run in the foreground, with an attached TTY :type foreground: ``bool`` :param tags: A tag or set of tags to add to the metadata entries for the `cmds` being run :type tags: ``str`` or a ``list`` of strings :param priority: The priority with which this command should be run, lower values will run before higher values :type priority: ``int`` :param cmd_as_tag: Should the command string be automatically formatted to a tag? :type cmd_as_tag: ``bool`` :param container: Run the specified `cmds` inside a container with this ID or name :type container: ``str`` :param to_file: Should command output be written directly to a new file rather than stored in memory? :type to_file: ``bool`` :param runas: Run the `cmd` as the `runas` user :type runas: ``str`` :param snap_cmd: Are the commands being run from a snap? :type snap_cmd: ``bool`` r1z.ambiguous filename or symlink for command listNrT)rBzSkipping command 'z' as the requested container 'z' does not exist.)rBr  root_symlinkr)stderrrrrQrrrrrr  foregroundr cmd_as_tagr container_cmdrr) rrrrr|rfmt_container_cmdrGr )rMrr r'r)r(rrrQrrrrr r)rrr*rrrrrBr+ocmds r!r"Plugin.add_cmd_output6sl dC 6D t9q=., NNK L   3I <%%$%/DC M!%y 1 ,,Y<OO&8?<>"'',,t||'?'?'A'-6 7 7C||,,.HSEc%jV44!"DHSZ$7F $CEEww~~bggll4<<3K3K3M39'BCC!Eqww||F**r.c[U[5(dU/nUH<nURRX"R 5UR 5/5 M> g)a_Add an environment variable to the list of to-be-collected env vars. Collected environment variables will be saved to an `environment` file in the archive root, and any variable specified for collection will be collected in lowercase, uppercase, and the form provided :param name: The name of the environment variable to collect :type name: ``str`` N)rrrrupperro)rMrrQs r! add_env_varPlugin.add_env_var sG$%%6DC NN ! !3 SYY["A B r.czURSUS9(d#URSURUS9S35 gU(aSOSn[RR X`R 5U5n[U[5(aU/nURRXU45 URS US 35 g) asAdd a string to the archive as a file :param content: The string to write to the archive :type content: ``str`` :param filename: The name of the file to write `content` to :type filename: ``str`` :param pred: A predicate to gate if the string should be added to the archive or not :type pred: ``SoSPredicate`` :param plug_dir: Should the string be saved under the plugin's dir in sos_commands/? If false, save to sos_strings/ :type plug_dir: ``bool`` :param tags: A tag or set of tags to add to the manifest entry for this collection :type tags: ``str`` or a ``list`` of strings Frz!skipped string due to predicate (rrdNr7 sos_stringszadded string as 'r) rrrrrrHrrrrrrrG)rMcontentfilenamerplug_dirrsos_dirs r!add_string_as_filePlugin.add_string_as_file s.""u4"8 NN#11t1<=Q@ A $,.-77<<h? dC 6D   'T!:; +H:Q78r.c UR(agUc URn/n[U[5(aU/nUR U5 UR UR U55 U(a'UR [R"SSU55 [[U55nURU5nU(dURSRS:Xa URnOSnU(aURX+5nOURX5nU[!URS5S-SnU(anUR#SUS 35 UR$R'U[(5 [*R,R/UR$R15U5nOS n[35nUUUUXUR6U UUUS 9 n[35nUU- nUS S :Xa;SUSUS3nUR9U5 U(aSU3n UR#UU 35 UR;S5SUR;S5SSUU(aUOSUSUS UUUUUS. n!US S:Xd US S:XaU(asUS:wamURSRS:waPUR=SUR;5SSUS35 [5XS UXU UR6UUS9 n[35U- nUR#SUS35 US S;a8UR>(a'UR>R@R U!5 U$UR#SUR;5SS US!U S"35 US(azUR=SUR;5SS#35 Un"URCS$S%5S&-nU(a6UR$R'U[(S'S(9n#[*RD"UU#5 U(dFU (a UR$RGUS)U5 OUR$RIUS)U5 US(a[*R,R/UR$R15U5n$[*R,R/UR$R15W"5n%[*R,RKU$U%5n&U&RCS*S+S5n&UR$RMU&U"5 U(aUR$RMUU5 URNR UUU (aS,OS-S..5 U(a8[*R,R/UR$R15U5OS+US/'UR>(aVUU!S0'UU!S1'UR>R@R U!5 U(a URQU!RS5U5 U$)2abExecute a command and save the output to a file for inclusion in the report. Positional Arguments: :param cmd: The command to run Keyword Arguments: :param suggest_filename: Filename to use when writing to the archive :param root_symlink: Create a symlink in the archive root :param timeout: Time in seconds to allow a cmd to run :param stderr: Write stderr to stdout? :param chroot: Perform chroot before running cmd? :param runat: Run the command from this location, overriding chroot :param env: Dict of env vars to set for the cmd :param binary: Is the output in binary? :param sizelimit: Maximum size in MB of output to save :param subdir: Subdir in plugin directory to save to :param changes: Does this cmd potentially make a change on the system? :param foreground: Run the `cmd` in the foreground with a TTY :param tags: Add tags in the archive manifest :param cmd_as_tag: Format command string to tag :param to_file: Write output directly to file instead of saving in memory :param tac: Reverse log lines order :param runas: Run the `cmd` as the `runas` user :returns: dict containing status, output, and filename in the archive for the executed cmd Nz[^\w\.]+r%ralwaysrr1 collecting 'z' output directly to diskF) r)r(rchdirrQrrpollerr)rtacrr|z command 'z' timed out after rTz3 - output up until the timeout may be available at rr truncated) r* parametersexecfilepathr` return_coderr/r0r1r~r&z' not found in z - re-trying in host root) r)rr\rQrrr]rr^zcould not run 'z': command not found)rerfzcollected output of '' in z (changes=rdz' was truncatedr7rR.tailedTrLrDz../r$rr)rBrrrTrcr1)*rfr@rrrr4rrrr(rrrSrrrrKrrGr check_pathrrrrHget_archive_pathrrrkrrrrr:rrename add_binaryr"rTrVr_add_container_cmd_to_manifestrP)'rMrBr r'r)r(rrrQrrrr r)rrr*rr^r+r_tagsrRrootrH outfn_stripout_filerHrendr1warnr manifest_cmdlinkfnrZ _outfn_path _link_pathrpaths' r!_collect_cmd_outputPlugin._collect_cmd_outputC sTR    ?ooG dC 6D T T**3/0  LL S#6 7SZ ((- T\\-0778C<o&*V+D$FG3U%)#118F $v~H OOocU2FG Hh:-==MM**11,?!M / A/?uXJ$WIQ0 1 +  NN2399;q>2BC'' (FMM.-@9LE||..ufD.I (D) ''x(8%@ ''x(8%@ + '',,t||'D'D'FNKdll&C&C&EvNJGGOOKB2ODMM $ $Y /   +G4;;!#=  r.cLUup4X@RR;a//S.URRU'X1S'URS5SUS'URS5SSUS'S US UR53nS US 3nUR U5nUS U3nUR R U[5(a/[R"X`R RU55 XS 'URRUSRU5 g)aKAdds a command collection to the manifest for a particular container and creates a symlink to that collection from the relevant sos_containers/ location :param manifest: The manifest entry for the command :type manifest: ``dict`` :param contup: A tuple of (original_cmd, container_name) :type contup: ``tuple`` rrbrrr*r1Nrasos_containers/z/sos_commands/z ../../../../rcr&r:) rr=rrr-rrirrrI dest_pathrr) rMrcontuprBr_cdir_outloccmdfnconlnks r!rm%Plugin._add_container_cmd_to_manifest s  MM44 4<>B2ODMM $ $Y /!iinQ/!$3!3!)N499;-H *!5 67$$S)7!E7# << " "66 2 2 JJw 6 6v > ?%   +J7>>xHr.c8UcCSURRR5;aURRS$g[URRR55H#nX:XdM URRUs $ g)zZBased on policy and request by the plugin, return a usable ContainerRuntime if one exists Nr)rruntimeskeysr)rMruntime pol_runtimes r!rPlugin._get_container_runtime s ?DKK005577{{++I668  $DKK$8$8$=$=$?@ );;// << Ar.cUR5nUb+URU5=(d URU5SL$g)aIf a container runtime is present, check to see if a container with a given name is currently running :param name: The name or ID of the container to check presence of :type name: ``str`` :returns: ``True`` if `name` exists, else ``False`` :rtype: ``bool`` NF)rrget_container_by_namerMr_runtimes r!rPlugin.container_exists sH..0  --d3E2248D Fr.cUR5nUbBURUS9nUVs/sH%n[R"XS5(dM#UPM' sn$/$s snf)aLGet a list of all container names and ID matching a regex :param regex: The regular expression to match :type regex: ``str`` :param get_all: Return all containers found, even terminated ones :type get_all: ``bool`` :returns: All container IDs and names matching ``regex`` :rtype: ``list`` of ``tuples`` as (id, name) get_allr1)rget_containersrr)rMrrr _containersr~s r!get_all_containers_by_regex"Plugin.get_all_containers_by_regex sZ..0  "11'1BK*D{!bhhud.CA{D D Es "A AcLUR5nUbURU5$g)zGet the container ID for a specific container :param name: The name of the container :type name: ``str`` :returns: The ID of the container if it exists :rtype: ``str`` or ``None`` N)rrrs r!rPlugin.get_container_by_name s,..0  11$7 7r.cnURUS9nUb"U(aURSS9$UR$/$)aReturn a list of all container IDs from the ``Policy`` ``ContainerRuntime`` If `runtime` is not provided, use the ``Policy`` default :param runtime: The container runtime to use, if not the default runtime detected and loaded by the ``Policy`` :type runtime: ``str`` :param get_all: Return all containers known to the `runtime`, even those that have terminated :type get_all: ``bool`` :returns: All container IDs found by the ``ContainerRuntime`` :rtype: ``list`` rTr)rrr=)rMrrrs r!rPlugin.get_containers sE"..w.?  ..t.<<&& & r.cBURUS9nUb UR$/$)aReturn a list of all image names from the Policy's ContainerRuntime If `runtime` is not provided, use the Policy default. If the specified `runtime` is not loaded, return empty. :param runtime: The container runtime to use, if not using the default runtime detected by the ``Policy`` :type runtime: ``str`` :returns: A list of container images known to the `runtime` :rtype: ``list`` r)rimagesrMrrs r!get_container_imagesPlugin.get_container_images$ s,..w.?  ?? " r.cBURUS9nUb UR$/$)aReturn a list of all volume names from the Policy's ContainerRuntime If `runtime` is not provided, use the Policy default. If the specified `runtime` is not loaded, return empty. :param runtime: The container runtime to use, if not using the default runtime detected by the ``Policy`` :type runtime: ``str`` :returns: A list of container volumes known to the `runtime` :rtype: ``list`` r)rvolumesrs r!get_container_volumesPlugin.get_container_volumes7 s...w.?  ## # r.c UR5nUbc[U[5(aU/nUHDnURXR5nUH*nUR US5nUR "U40UD6 M, MF gg)a,Helper to get the ``logs`` output for a given container or list of container names and/or regexes. Supports passthru of add_cmd_output() options :param containers: The name of the container to retrieve logs from, may be a single name or a regex :type containers: ``str`` or ``list`` of strs :param get_all: Should non-running containers also be queried? Default: False :type get_all: ``bool`` :param kwargs: Any kwargs supported by ``add_cmd_output()`` are supported here Nr1)rrrrget_logs_commandr") rMr=rrrr_cons_conrBs r!add_container_logsPlugin.add_container_logsJ s|"..0  *c**(\ ' 88L!D"33DGT__Z88H CDOON$CH eS ! !GE dC 6DD x$.  htf-.  >J6 6K  ; &K  8 #K v~v~ 8d? *K11  9u, ,K  9u, ,K  9u, ,K  :. .K a<(M4KC .{m<= !$dU'/d&.  0r.c ^^UU4Sjm[R"U[R5(a>TRU5(a(TR U5(aTR US5n[ R "USS9n/nUHznTRU5(a`TR U5(aHURU5 URT"[RRUS555 MxMzM| URU5 [[U55$![a URU5 Mf=f)Nc >/n[R"U5nUHnTRU5(dTRU5(aURU5 MCTR U5(a?TR U5(a)UR T"TRUS555 MURU5 M [[U55$![a Mf=f)Nr) globrrrrrrrrPermissionErrorrr)r found_pathsr_Plugin__expandrMs r!__expand*Plugin._expand_copy_spec..__expand! sKIIe$E''--1A1A$1G1G#**40..4<<3E3E#**8DNN44M+NO#**40"K() )'s=CAC4C C+*C+rT)r#)rrrrrrrremoverrrHrrr)rMrexpandedrecursed_files_pathrs` @r!rPlugin._expand_copy_spec s *, IIh ( (T__X-F-F X&&~~h4H99X6E '??5))dll5.A.AOOE*"))(277<<s3K*LM /B) 'CM"" # '&  'sA2D..E  E c[URSS9H)nURSUS35 URU5 M+ UR 5 g)NT)rzcollecting path 'r)rrrrXrrs r!_collect_copy_specsPlugin._collect_copy_specsL sI4??D9D NN.tfA6 7   t $: ##%r.c UR(dgUR5nU(dURS5 gUR5(dURS5 gURHnUup4pVnURSUSUS35 SUSUR S53nUR R U[5 UR RU5n URX4X(aUOSS 9n URU S S 9n U S S :Xa:U(aUR RU SU5 URX4X5 MURSUSUSU S35 M g)aCopy any requested files from containers here. This is done separately from normal file collection as this requires the use of a container runtime. This method will iterate over self.container_copy_paths which is a set of 5-tuples as (container, path, sizelimit, stdout, tags). NzDCannot collect container based files - no runtime is present/active.zYLoaded runtime '%s' does not support copying files from containers. Skipping collections.r[rrrr&)rr)r)rrrDzerror copying 'r ) rrrcheck_can_copyrrrirrget_copy_commandrr"r) rMrtrrrrrrarcdestrZcpcmdcprets r!_collect_container_copy_specs$Plugin._collect_container_copy_specsR so((   ( ( * NN0 1   "" NNJ K //F17 .Cy$ NN\$/A#aH I'uAdkk#.>-?@G LL # #GV 4<<))'2D''49D(EMM%M4EX!#LL++E(OWE44SN7##&%s5?*; =>)0r.cRURRSS9 URH}nURS[U535 Sn[ USS5bSUR S3nUR SURS U35 UR"S 0URD6 M g) NcUR$r)r)xs r!&Plugin._collect_cmds..} sQZZr.)rzunpacked command: r$rrrzcollecting output of 'rr) rrrGrrrrrBryr)rMrrs r! _collect_cmdsPlugin._collect_cmds| s #78''F OO0V > ?Dvw-9"6<<.6 NN3FJJrrr) rMrrrrH_pfnamer rrrrunrs r!collection_filePlugin.collection_file s$ KFE11%1GG LL # #GV 4LL**73EeS73u"A% IJ 4&C+C NN0~cUK L$$$v MM % % , ,#. 43 K NN9%C5I J J KsHD*AC<#C+*, -r.c<UR$![a gf=f)z8This function will return the description for the pluginr)rrr`s r!get_descriptionPlugin.get_description s# 0?? " 0/ 0s  c 8[URURURURUR UR UR/5(Ga<[UR[5(aUR/Ul[UR[5(aUR/Ul[UR[5(aUR/Ul[UR[5(aUR/Ul[UR [5(aUR /UlURURURURUR UR 5$g)aIThis method will be used to verify that a plugin should execute given the condition of the underlying environment. The default implementation will return True if none of class.files, class.packages, nor class.commands is specified. If any of these is specified the plugin will check for the existence of any of the corresponding paths, packages or commands and return True if any are present. For plugins with more complex enablement checks this method may be overridden. :returns: ``True`` if the plugin should be run for this system, else ``False`` :rtype: ``bool`` T) rhr;rJr:rzrIr= architecturesrr_check_plugin_triggersr`s r! check_enabledPlugin.check_enabled s $  DMM4==$:J:J t0B0BD E E$**c**"jj\ $----!% $----!% $**C00$($4$4#5 $----!% ..tzz/3}}/3}}/3}}/3 @ @ r.c^[XX4U/5(dTR5$[U4SjU55=(d [U4SjU55=(ds [U4SjU55=(dW [U4SjTR55=(d1 [U4SjU55=(d [U4SjU55=(a TR5$)Nc3F># UHnTRU5v M g7fr)r )rrrMs r!r0Plugin._check_plugin_triggers..( s@%T%%e,,%rc3F># UHnTRU5v M g7fr)rr s r!rr*) s?hsD%%c**hrc3P># UHn[UTR5v M g7fr)r r)rrBrMs r!rr** sIM#t||44s#&c3F># UHnTRU5v M g7fr)r})rmodrMs r!rr*+ s!K:J3D))#..:Jrc3F># UHnTRU5v M g7fr)r)rrrMs r!rr*, s=HSDOOC((Hrc3F># UHnTRU5v M g7fr)r)rcntrrMs r!rr*- sGJDD))$//Jr)rhcheck_is_architecturerz)rMr;rJr:rIr=s` r!r%Plugin._check_plugin_triggers! sEXDEE--/ /@%@@H?h??HIIIHK$:J:JKKH=H== H GJGG - **,  .r.cURcgSSRUR5S3n[R"XRR 55$)aChecks whether or not the system is running on an architecture that the plugin allows. If not architecture is set, assume plugin can run on all arches. :returns: ``True`` if the host's architecture allows the plugin to run, else ``False`` :rtype: ``bool`` Trrrd)r$rHrrrrrs r!r2Plugin.check_is_architecture0 sM    %chht112315xx{{33566r.cg)zoThis decides whether a plugin should be automatically loaded or only if manually specified in the command line.Trr`s r!default_enabledPlugin.default_enabled> sr.cURH=nURU5(dMURU5 URU5 M? URH/nUR U5(dMUR SU35 M1 g)zBased on the class attrs defined for plugin enablement, add a standardized set of collections before we call the plugin's own setup() method. zmodinfo N)rIrrrrzr}r")rMrrs r!add_default_collectionsPlugin.add_default_collectionsC su}}Gw''''0  )%$$D$$T**##htf$56%r.cLUR[UR55 g)zCollect the list of files declared by the plugin. This method may be overridden to add further copy_specs, forbidden_paths, and external programs if required. N)rrr;r`s r!setup Plugin.setupR s 4 +,r.cT[US5(dH[US5(a6UR(a%URVs/sHoS-PM snUlOgURRnUR UR5nU(aUR U5 ggs snf)NrrJ$)rrJrrrbuild_verify_commandr")rMrVpm verify_cmds r! setup_verifyPlugin.setup_verifyY st.//tZ((T]]9='GAC'G$ [[ ( (,,T-A-AB     +  (HsB%c(URSU3US9$)axCheck if a path exists inside a container before collecting a dir listing :param path: The canonical path for a specific file/directory in a container :type path: ``str`` :param container: The container where to check for the path :type container: ``str`` :returns: True if the path exists in the container, else False :rtype: ``bool`` ztest -e r)r)rMrrs r!r!Plugin.container_path_existsf s}}xv.)}DDr.c,[XR5$)a,Helper to call the sos.utilities wrapper that allows the corresponding `os` call to account for sysroot :param path: The canonical path for a specific file/directory :type path: ``str`` :returns: True if the path exists in sysroot, else False :rtype: ``bool`` )r rrs r!r Plugin.path_existsv 4..r.c,[XR5$)a#Helper to call the sos.utilities wrapper that allows the corresponding `os` call to account for sysroot :param path: The canonical path for a specific file/directory :type path: ``str`` :returns: True if the path is a dir, else False :rtype: ``bool`` )rrrs r!rPlugin.path_isdir s$ --r.c,[XR5$)a$Helper to call the sos.utilities wrapper that allows the corresponding `os` call to account for sysroot :param path: The canonical path for a specific file/directory :type path: ``str`` :returns: True if the path is a file, else False :rtype: ``bool`` )rrrs r!rPlugin.path_isfile rJr.c,[XR5$)a$Helper to call the sos.utilities wrapper that allows the corresponding `os` call to account for sysroot :param path: The canonical path for a specific file/directory :type path: ``str`` :returns: True if the path is a link, else False :rtype: ``bool`` )rrrs r!rPlugin.path_islink rJr.c,[XR5$)a$Helper to call the sos.utilities wrapper that allows the corresponding `os` call to account for sysroot :param path: The canonical path for a specific file/directory :type path: ``str`` :returns: Contents of path, if it is a directory :rtype: ``list`` )rrrs r!rPlugin.listdir st\\**r.c4[U/UQ7SUR06$)a~Helper to call the sos.utilities wrapper that allows the corresponding `os` call to account for sysroot :param path: The leading path passed to os.path.join() :type path: ``str`` :param p: Following path section(s) to be joined with ``path``, an empty parameter will result in a path that ends with a separator :type p: ``str`` r)rr)rMrrVs r!rPlugin.path_join s884<<88r.cg)zLPerform any postprocessing. To be replaced by a plugin if required. Nrr`s r!r,Plugin.postproc rr.c"SnSn[R"U5nUHKn[URU5SSS9nUR5R 5nX;aSnSSS5 MM U$!,(df  M`=f![ a gf=f)zChecks if a named process is found in /proc/[0-9]*/cmdline. :param process: The name of the process :type process: ``str`` :returns: ``True`` if the process exists, else ``False`` :rtype: ``bool`` F/proc/[0-9]*/cmdlinerrrTN)rrrrr)IOError)rMprocessr cmd_line_globcmd_line_pathsrpfilecmd_lines r!check_process_by_namePlugin.check_process_by_name s.  !YY}5N&$...#*,/4$zz|113H*!% ,,' ,,   s(5B&A/! B/ A> 9B B Bcv/nSn[R"U5nUHun[USSS9nUR5RS5n[R "X5(a#UR URS5S5 SSS5 Mw U$!,(df  M=f![a Mf=f) zGet a list of all PIDs that match a specified name :param process: The name or regex of the process the get PIDs for :type process: ``str`` :returns: A list of PIDs :rtype: ``list`` rXrYrrr&N) rrrr)rrrrrrZ)rMr[pidsr\r]rr r_s r!get_process_pidsPlugin.get_process_pids s. =1"D $g6! vvx~~f5Hxx22 DJJsOA$6776# 76  s/ B*AB B* B' "B*'B** B87B8c ^/nURU5nUHCn[R"[U5[R 5 UR U5 ME [[[U5S55 U$![a%nURSUSUSU35 SnAMSnAff=f)a Send a SIGUSR1 to the pid(s) associated with the specified process name. Callers should be aware that a 1-second delay per signalled pid, up to 5 seconds at most, is expected as to allow sufficient time for the signalled process(es) to react to the received signal. :param process: The name or regex pattern of the process(es) to signal :type process: ``str`` :returns: A list of pids that were successfully signalled :rtype: ``list`` zFailed to signal pid z for 'r N) rfrkillrsignalSIGUSR1rrrrGrminr)rMr[ signalledrepidrs r!signal_process_usr1Plugin.signal_process_usr1 s $$W-C C&..1  % c#i.!$% +C5wis3%H s?A== B,B''B,cUc7URSR(aURSRnURURSSX5$)Nr namespacesnetwork)rrsfilter_namespaces)rM ns_patternns_maxs r!get_network_namespacesPlugin.get_network_namespacessR >dll=9DD\\-0;;F%%dll<&@&K&0: :r.cp/nSnU(a3SSRUR55RSS5S3nUHqnU(a&[[R "XV55(dM0UR U5 U(dMJ[U5U:XdM[URSUS35 U$ U$) zFilter a list of namespaces by regex pattern or max number of namespaces (options originally present in the networking plugin.) Nrz$|rz.*z$)z&Limiting namespace iteration to first z namespaces found) rHrrrrrrrrr)rMns_listrvrwout_nsrnss r!ruPlugin.filter_namespacess dii 0 0 23;;CFGrJ B$rxx'<"="= MM"  vv;&(NN$//5h6G$IJ  r.)rrrfrrrr:rrrrrrrrrr;rr#rzrrrJrrrIrrrrrr)FN)F)r$)NF)r)NT) NTTNNFNFFFN)NNNNNFNNNNNNNr)NN)rrrrrrnrJr;r:rzrIr=r$rrrr r_rbrfr0rr"r#rrrrr!rBrJrMrSr\propertyr)r@rhrk classmethodrrvrtrsrrrrrGrrrrr rrrrrrr$rrrr rrr3r/r>r<rDr^rdr6rorurQrrXrrr|rrrrrrrr r$r"r1r4r<r@r-rKrOrWryr|rrrmrrrrrrrrr,r}rrrrrrrrrr rr contextlibcontextmanagerrrr!r&r%r2r7r:r=rDr!r rrrrrr,r`rfrprxrurrr.r!rrs,\KH EHKHJMGHG$N!KLGHKGIM-J(/T 247 2 *X5 !&$$-- ccJ6 6 p> 1301 7 7   @ 8 8 9 8 J @","8@06p86#J J=*+A)F$  H:x0**@+&" :$26d!2yv59D"$D$(B"2 "4OOb6:T#4T%%)R4.KB+05 DtDtt)-)V59$($t"$D!%D$R "u$D5 qAf% . %.+8C$:> "#9J9=).#'Dd#(D$)e"%'E5 %U$ tl8<(-t"&t4T"'4d#(U4 "$ J X?C:>=BO3b 0IB  $ 0&&76, 6(!@.DH8<;?CEn0`*#X& (>T8 4 L G ,0r$K$KL -0)V . 7 7- ,E / . / / + 9 .,8: r.rc\rSrSrSrSrg)PluginDistroTagi5zThe base tagging class for distro-specific classes used to signify that a Plugin is written for that distro. Use IndependentPlugin for plugins that are distribution agnostic rNrrrrrrrr.r!rr5sr.rc\rSrSrSrSrg) RedHatPlugini=z/Tagging class for Red Hat's Linux distributionsrNrrr.r!rr=9r.rc\rSrSrSrSrg) UbuntuPluginiAzTagging class for Ubuntu LinuxrNrrr.r!rrA(r.rc\rSrSrSrSrg) DebianPluginiEzTagging class for Debian LinuxrNrrr.r!rrErr.rc\rSrSrSrSrg) SuSEPluginiIz*Tagging class for SuSE Linux distributionsrNrrr.r!rrIs4r.rc\rSrSrSrSrg)OpenEulerPluginiMz/Tagging class for openEuler linux distributionsrNrrr.r!rrMrr.rc\rSrSrSrSrg) CosPluginiQz(Tagging class for Container-Optimized OSrNrrr.r!rrQs2r.rc\rSrSrSrSrg)IndependentPluginiUz6Tagging class for plugins that can run on any platformrNrrr.r!rrUs@r.rc\rSrSrSrSrg)ExperimentalPluginiYz=Tagging class that indicates that this plugin is experimentalrNrrr.r!rrYsGr.rc\rSrSrSrSrg) AzurePlugini]zTagging class for Azure LinuxrNrrr.r!rr]s'r.rc>SU3nU(d[4n[X!5$)zImport name as a module and return a list of all classes defined in that module. superclasses should be a tuple of valid superclasses to import, this defaults to (Plugin,). zsos.report.plugins.)rr)r superclasses plugin_fqnames r! import_pluginras% *$0M y  55r.r)8rrrrrrkr2rrrrr8rr sos.utilitiesrrrr r r r r rrrrrrrr sos.archiverrr"r-r;r.DOTALLrrr=rrrrrrrrrrrrrrrr.r!rs)B  99999 '  ZZ;RYY G  l l ^ 88,NNbQ1Q1hb:?:)?))?)55:o:33AAHH(/(6r.