+ ik+cs^RIt^RIt^RIt^RIt^RIHt^RIHt^RIH t ^RI H t ^RI H t ^RIHtHt]!]P$!4P&^x4t!RR ] 4t!R R 4tR# ]d^xtL"i;i) N) OrderedDict)fill) SoSComponent) import_policy)Plugin)boldImporterHelpercsaa]tRt^toRtRtRtRtRtRR/t V3Rlt ] R4t Rt R tR tR tR tR tRtRtRtVtV;t#) SoSHelperzProvide better, more in-depth help for specific parts of sos than is provided in either standard --help output or in manpages. zDetailed help infomationFtopiccs^<\SV`WV4VPPVnR#)N)Zsuper__init__optsr )selfparserZargsZcmdline __class__s&&&&6/usr/lib/python3.14/site-packages/sos/help/__init__.pyr ZSoSHelper.__init__+s! w/YY__ csdRVnVPRR4pVPRRRRRR7R #) zsos help TOPIC [options]zHelp Information OptionszVPPPWV,4VPnR#R#).cleancleanerZmaskcollect collectorN)r r splitreplace)r Z_comZ_replace& rsanitize_topic_componentZ"SoSHelper.sanitize_topic_component:sdyy$$S)!, Y I {   "iioo55dTNKDIIO rcsrVPP'g'VP4\P!^4VP 4VP 4pX'd/\4pVPV4VP4R#\RVPP R24R# \dFp\RTPP RT 24\P!^4Rp?LRp?ii;i \dp\RT 24Rp?R#Rp?ii;i)rzCould not load help for 'z': NzError loading help: zNo help section found for 'Z') r r display_self_helpsysZexitrget_obj_for_topic Exceptionprint HelpSectionZ display_helpdisplay)r ZklassZerrZhts& rexecuteZSoSHelper.executeDsyy  " " $ HHQK %%' **,E  4 ]""2&  / /@B C  -diioo->c#G H HHQKK  4,SE233 4s0B?-+D? D ;D  D D6D11D6c sRRRRRRRRR R R R R RRR/pRpVPPV9dZ\P!RVPP,4p\ W1VPP,4pV#RVP RVP RVPRVP/pVP4F:wrVVPPPV4'gK2V!4pV# V#)zBased on the help topic we're after, try to smartly decide which object we need to manipulate in order to get help information. reportZ SoSReportreport.pluginsrrZ SoSCleanerr SoSCollectorzcollector.transportsZRemoteTransportzcollector.clustersZClusterpoliciesZPolicyuploadZ SoSUploadNsos.zreport.plugins.z policies.zcollector.transports.zcollector.clusters.) r r importlib import_moduleZgetattr_get_plugin_variant_get_policy_by_name_get_collect_transport_get_collect_clusteritemsZ startswith)r Z static_maprmodZ_helpZ_secvalue& rr ZSoSHelper.get_obj_for_topic\s k h |  "$5 )  k   99??j ())&499??*BCC#$))//:;C "4#;#;T55')D)D%t'@'@ E %{{} 99??--d33'C - rcs^RIHpVPPP R4R,pW!9d W,#R#)r) TRANSPORTSrN)Zsos.collector.sosnoder6r r r)r r6Z _transportrrr0Z SoSHelper._get_collect_transport}s44YY__**3/3  #) )rcs^RIHp^RIpVPVPP R4pVFFpV^,VP PPR4R,8XgK=V^,u# R#)r)r(Nclustersrr7) Z sos.collectorr(Zsos.collector.clustersZ _load_modulesrr8r r r)r r(sosr8Zclusters& rr1ZSoSHelper._get_collect_clustersd.%--cmm.D.D.8:GqzTYY__2237;;qz! rcs\P!RVPP,4pVP 4\ P !V\ P4pVUu.uF+p\V^,\4'gK"V^,NK- ppVFFpVP4'gKVPPVP44pVu# R#uupi)r+N) r,r-r r Zload_local_policyinspectZ getmembersZisclassZ issubclassrZ__subclasses__policyZ match_plugin)r r3ZmemsZmZpluginsZpluginrr5rr.ZSoSHelper._get_plugin_variants%%ftyy&>?  !!#w7!%BAAaD&)A41Q44BF$$&&kk..v/D/D/FG  Cs +C, C,csbVPPPR4R,p^RIp\ VP P 4pVP4FKp\V4F9pVPP4PRR4pWa8XgK5Vuu# KM R#)rNr;r r7) r r rZsos.policies.distrosrr)ZdistrosZ get_modulesr__name__Zlowerr)r Z_topicr9Z_helperr3r;Z_pr5rr/ZSoSHelper._get_policy_by_names&&s+B/ $ !5!56&&(C',__**,44XrB<!M-) rc s\RR4pVPR\R4 R24VPR4p\R4pVPRV R 24\R 4pVPR V R 24VPR 4pVPR4RRRRRRRRRRRRRR/pVP 4F'wrxVPR\V4R V 2RR 7K) VP 4R!#)"zXDisplays the help information for this component directly, that is help for `sos help`. zDetailed help for sos helpzThe 'help' sub-command is used to provide more detailed information on different sub-commands available to sos as well as different components at play within those sub-commands.zSoS - officially pronounced "ess-oh-ess" - is a diagnostic and supportability utility used by several Linux distributions as an easy-to-use tool for standardized data collection. The most known component of which is z sos reportz (formerly sosreport) which is used to collect troubleshooting information into an archive for review by sysadmins or technical support teams.zHow to search using sos helpz$component.$topic.$subtopicz8To get more information on a given topic, use the form 'z'.zsos help report.plugins.kernelz For example 'zM' will provide more information on the kernel plugin for the report function.zAvailable Help SectionszThe following help sections are available. Additional help topics and subtopics may be displayed within their respective help section. r&z#Detailed help on the report commandr'z'Information on the plugin design of soszreport.plugins.$pluginz!Information on a specific $pluginrz"Detailed help on the clean commandrz$Detailed help on the collect commandr*z#Detailed help on the upload commandr)z+How sos operates on different distributionsZ z<36F)newlineN)r#add_textr add_sectionr2r$) r Z self_helpZsubsectrZrep_exZ avail_helpsectionsZsectr4s & rrZSoSHelper.display_self_helpsN (J  &'+<&8%9:J J ''(FG23 s  67=1%% &**+DE    = G $&I < > ; E $>>+KD   "T$Z$4UG ZHelpSection.add_texts+ <<<"BlG  rc sLVPWV4VPV,#)a Add a section of text to the help section that will be displayed when the HelpSection object is printed. Sections will be printed *in the order added*. This will return a subsection object with which block(s) of text may be added to the subsection associated with ``title``. :param title: The title of the subsection being added :type title: ``str`` :param content: The text the new section should contain :type content: ``str`` :returns: The newly created subsection for ``title`` :rtype: ``HelpSection`` ) _add_sectionr@rKrLrr?ZHelpSection.add_sections#$ %&1}}U##rc snWP9d \R4h\WV4VPV&R#)zInternal method used to add a new subsection to this help output :param title: The title of the subsection being added :type title: ``str` z(A section with that title already existsN)r@r!r#rKrLrrOZHelpSection._add_sections/ MM !FG G*56B erc  s\\\VP4\VP R74VP P4F(p\\V\VP R74K* VPF/p\R4VPV,P4K1 R#)zGPrint the HelpSection contents, including any subsections, to console. )ZwidthZinitial_indentr N) r"rrrHTERMSIZErJrIZ splitlinesr@r$)r rNZsectionrrr$ZHelpSection.display&s d  HT[[  ,,))+B $r$++F G,}}G "I MM' " * * ,%r)rIrJr@rHN)r r r )T)r r ) r<rArBrCrDr rMr>r?rOr$rErF)rGs@rr#r#s.&$  $*C - -rr#)r:r,rZosZ collectionsrZtextwraprZ sos.componentrZ sos.policiesrZsos.report.pluginsrZ sos.utilitiesrrZminZget_terminal_sizeZcolumnsrPr!rr#)rrrQsw #&&%.2'')1137H | |~U-U-GHs"A11 A=<A=