xref: /aosp_15_r20/external/selinux/secilc/secil2tree.8.xml (revision 2d543d20722ada2425b5bdab9d0d1d29470e7bba) 
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3               "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4
5<refentry>
6   <refentryinfo>
7      <author>
8         <firstname>James</firstname><surname>Carter</surname><contrib></contrib>
9      </author>
10   </refentryinfo>
11
12   <refmeta>
13      <refentrytitle>SECIL2TREE</refentrytitle>
14      <manvolnum>8</manvolnum>
15      <refmiscinfo class="date">05 April 2021</refmiscinfo>
16      <refmiscinfo class="source">secil2tree</refmiscinfo>
17      <refmiscinfo class="manual">SELinux CIL AST Writer</refmiscinfo>
18   </refmeta>
19   <refnamediv id="name">
20      <refname>secil2tree</refname>
21      <refpurpose>invoke the SELinux Common Intermediate Language (CIL) AST Writer </refpurpose>
22   </refnamediv>
23
24   <refsynopsisdiv id="synopsis">
25      <cmdsynopsis>
26        <command>secil2tree</command>
27          <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg>
28          <arg choice="plain"><replaceable>file</replaceable></arg>
29      </cmdsynopsis>
30   </refsynopsisdiv>
31
32   <refsect1 id="description"><title>DESCRIPTION</title>
33      <para><emphasis role="italic">secil2tree</emphasis> invokes the CIL AST Writer with the specified <emphasis role="italic">argument</emphasis>s.</para>
34   </refsect1>
35
36   <refsect1 id="options"><title>OPTIONS</title>
37      <variablelist>
38         <varlistentry>
39            <term><option>-o, --output=&lt;file></option></term>
40            <listitem><para>Write AST to <emphasis role="italic">file</emphasis> (default: stdout)</para></listitem>
41         </varlistentry>
42
43         <varlistentry>
44            <term><option>-P, --preserve-tunables</option></term>
45            <listitem><para>Treat tunables as booleans.</para></listitem>
46         </varlistentry>
47
48         <varlistentry>
49            <term><option>-Q, --qualified-names</option></term>
50            <listitem><para>Allow names containing dots (qualified names). Blocks, blockinherits, blockabstracts, and in-statements will not be allowed.</para></listitem>
51         </varlistentry>
52
53         <varlistentry>
54            <term><option>-A, --ast-phase=&lt;phase></option></term>
55            <listitem><para>Write AST of phase <emphasis role="italic">phase</emphasis>. Must be <emphasis role="bold">parse</emphasis>, <emphasis role="bold">build</emphasis>, or <emphasis role="bold">resolve</emphasis>. (default: <emphasis role="bold">resolve</emphasis>)</para></listitem>
56         </varlistentry>
57
58         <varlistentry>
59            <term><option>-v, --verbose</option></term>
60            <listitem><para>Increment verbosity level.</para></listitem>
61         </varlistentry>
62
63         <varlistentry>
64            <term><option>-h, --help</option></term>
65            <listitem><para>Display usage information.</para></listitem>
66         </varlistentry>
67      </variablelist>
68   </refsect1>
69
70   <refsect1 id="see_also"><title>SEE ALSO</title>
71      <para>
72      <simplelist type="inline">
73         <member><citerefentry>
74            <refentrytitle>secilc</refentrytitle>
75            <manvolnum>8</manvolnum>
76         </citerefentry></member>
77         <member><citerefentry>
78            <refentrytitle>secil2conf</refentrytitle>
79            <manvolnum>8</manvolnum>
80         </citerefentry></member>
81      </simplelist>
82      </para>
83      <para>HTML documentation describing the CIL language statements is available starting with <emphasis role="italic">docs/html/index.html</emphasis>.</para>
84      <para>PDF documentation describing the CIL language statements is available at: <emphasis role="italic">docs/pdf/CIL_Reference_Guide.pdf</emphasis>.</para>
85   </refsect1>
86</refentry>
87