Tc @ s d Z d d k Z d d k Z d d k Z d d k Z d d k Z e Z d Z d Z h Z
g Z g Z g Z
g Z d Z e i d Z e i d Z e i d Z d Z d
Z d Z d Z d
Z d Z d Z e Z e Z e Z e Z e e i d j o e e i d n y5 e i e i d d d d d d d g \ Z! Z" Wn* e i# j
o e e i d n Xx e! D] \ Z$ Z% e$ d% j o
e& Z qe$ d& j o e e i d qe$ d' j o e% Z Pqe$ d( j o e% Z Pqe$ d) j o e% Z Pqe e i d qWe o e i' i( e e n] e o e i' i( e e d# n9 e o e i' i( e e d$ n e e i d d S(* sY
This script generates XML documentation information for layers specified
by the user.
iNt metadatas third-partyt s! ^\s*(interface|template)\(`(\w*)'s8 ^\s*gen_(tunable|bool)\(\s*(\w*)\s*,\s*(true|false)\s*\)s ^##\s+(.*?)\s*$c C sR t i i | } t i i | } d | | f } d | | f } y) t | d } | i } | i Wn t d | g SXg } | i d t i i t i i
| d d | f g } d } t }
x' | o | d i
o | d } q Wd } x| D]} | d 7} |
oy t i | }
|
o! | i |
i d d q q| o7 t }
t i | } | p | | 7} g } q qqn | i
o q n t i | }
|
o! | i |
i d d q n | p t i | } n | o | i } | i d
| d | d | f | o | | 7} g } n t d | d | d f | i d | i d
| i d | i d | i d | i d | i d | i d | i d | i d d } q q q W|
o | | 7} n | o t d | n | t | d } | i d | S( sH
Returns the XML data for a module in a list, one line per list item.
s %s/%s.tes %s/%s.ift rs& cannot open file %s for read, skippings! <module name="%s" filename="%s">
ii i s
s <%s name="%s" lineno="%s">
s unable to find XML for %s %s()s
<summary>
s Summary is missing!
s </summary>
s <param name="?">
s$ Parameter descriptions are missing!
s </param>
s </%s>
s( orphan XML comments at bottom of file %st boths
</module>
N( t ost patht dirnamet basenamet opent readlinest closet warningt appendt splitextt splitt Nonet Truet isspacet XML_COMMENTt matcht groupt Falset INTERFACEt groupst
getTunableXML( t file_namet
module_dirt module_namet module_tet module_ift module_filet module_codet
module_buft temp_buft interfacet finding_headert line_numt linet commentR ( ( s4 /usr/share/selinux/devel/include/support/segenxml.pyt getModuleXMLF s .
"
c C s y) t | d } | i } | i Wn t d | g SXg } g } x | D] } t i | } | o! | i | i d d qU n t i | } | o | d j o; | i d | j o! t d | i d | f q n | i d | i
| | 7} g } | i d | i d qU qU Wt | o t d | n t t d
j oy t
i i | d d } yC t t d | d
}
x | D] } |
i | qW|
i Wqt d | qXn | S( sD
Return all the XML for the tunables/bools in the file specified.
R s& cannot open file %s for read, skippingi s
R s %s in a %s file.s <%s name="%s" dftval="%s">
s </%s>
s( orphan XML comments at bottom of file %si s .xmlt /t ws* cannot write to file %s, skipping creation( R R R
R R R R R t BOOLEANt errorR t lent
output_dirR R R t write( R t kindt tunable_filet tunable_codet tunable_bufR! R% R& t booleant xmlfilet xml_outfilet tunable_line( ( s4 /usr/share/selinux/devel/include/support/segenxml.pyR sJ
%
"
c C sO g } y- t | d } | | i 7} | i Wn t d | n X| S( s-
Return all the XML in the file specified.
R s. cannot open file %s for read, assuming no data( R R R
R ( R R2 t tunable_xml( ( s4 /usr/share/selinux/devel/include/support/segenxml.pyt getXMLFileContents s c C s g } | i d x+ t i D] } | t | t | 7} q Wx! t D] } | t | d 7} qH Wx t D] } | t | 7} ql Wx! t D] } | t | d 7} q Wx t D] } | t | 7} q W| i d | S( s_
Return the compelete reference policy XML documentation through a list,
one line per item.
s <policy>
t tunablet bools
</policy>
(
R t layerst keyst getLayerXMLt
tunable_filesR t xml_tunable_filesR8 t
bool_filest xml_bool_files( t
policy_buft layerR0 t bool_file( ( s4 /usr/share/selinux/devel/include/support/segenxml.pyt getPolicyXML s&
c C s t i i d t i d t i i d d d d t i i d t i i d t i d t i i d t i d d
S( sB
Displays a message describing the proper usage of this script.
s usage: %s [-w] [-mtb] <file>
i s -w --warn show warnings
s. -m --module <file> name of module to process
s< -t --tunable <file> name of global tunable file to process
s= -b --boolean <file> name of global boolean file to process
s
examples:
s! > %s -w -m policy/modules/apache
s > %s -t policy/global_tunables
N( t syst stdoutR. t argv( ( ( s4 /usr/share/selinux/devel/include/support/segenxml.pyt usage4 s c C sB t o7 t i i d t i d t i i d | d n d S( s+
Warns the user of a non-critical error.
s %s: i s warning: s
N( t warnRF t stderrR. RH ( t description( ( s4 /usr/share/selinux/devel/include/support/segenxml.pyR C s c C sQ t i i d t i d t i i d | d t i i t i d d S( s.
Describes an error and exists the program.
s %s: i s error: s
i N( RF RK R. RH t flusht exit( RL ( ( s4 /usr/share/selinux/devel/include/support/segenxml.pyR+ L s
i s whm:t:b:RJ t helps module=s tunable=s boolean=i s -ws --warns -hs --helpi s -ms --modules -ts --tunables -bs --booleanR9 R: ( s -ws --warn( s -hs --help( s -ms --module( s -ts --tunable( s -bs --boolean() t __doc__RF R t globt ret getoptR RJ t metat third_partyR; R> R@ R? RA R- t compileR R* R R' R R8 RE RI R R+ t moduleR9 R3 R, RH RN t optst argst GetoptErrort ot aR RG t
writelines( ( ( s4 /usr/share/selinux/devel/include/support/segenxml.pyt <module> s| { A ! 5
y~or5J ={Eeu磝Qk ᯘG{?+]ן?wM3X^歌>{7پK>on\jy R g/=fOroNVv~Y+ NGuÝHWyw[eQʨSb> >}Gmx[o[<{Ϯ_qF vM IENDB`
