system/systemd
system/systemd
1
0
Fork 0
mirror of https://github.com/systemd/systemd synced 2024-10-06 16:21:34 +00:00
Code Issues Packages Projects Releases Wiki Activity

man/ukify: describe 'inspect'

Browse source 
Co-authored-by: Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
This commit is contained in:
Emanuele Giuseppe Esposito 2023-05-23 05:29:00 -04:00 committed by Zbigniew Jędrzejewski-Szmek
parent 805d41e279
commit 7d481546ac
1 changed files with 42 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

48
man/ukify.xml
View file

@ -118,6 +118,20 @@
<para>The output files must not exist.</para>
</refsect2>
<refsect2>
<title><command>inspect</command></title>
<para>Display information about the sections in a given binary or binaries.
If <option>--all</option> is given, all sections are shown.
Otherwise, if <option>--section=</option> option is specified at least once, only those sections are shown.
Otherwise, well-known sections that are typically included in an UKI are shown.
For each section, its name, size, and sha256-digest is printed.
For text sections, the contents are printed.</para>
<para>Also see the description of <option>-j</option>/<option>--json=</option> and
<option>--section=</option>.</para>
</refsect2>
</refsect1>
<refsect1>
@ -163,13 +177,23 @@
<varlistentry>
<term><option>--section=<replaceable>NAME</replaceable>:<replaceable>TEXT</replaceable>|<replaceable>@PATH</replaceable></option></term>
<term><option>--section=<replaceable>NAME</replaceable>:<arg choice="plain">text|binary</arg><optional>@<replaceable>PATH</replaceable></optional></option></term>
<listitem><para>Specify an arbitrary additional section
<literal><replaceable>NAME</replaceable></literal>. Note that the name is used as-is, and if the
section name should start with a dot, it must be included in <replaceable>NAME</replaceable>. The
argument may be a literal string, or <literal>@</literal> followed by a path name. This option may be
specified more than once. Any sections specified in this fashion will be inserted (in order) before
the <literal>.linux</literal> section which is always last.</para></listitem>
<listitem><para>For all verbs except <command>inspect</command>, the first syntax is used.
Specify an arbitrary additional section <literal><replaceable>NAME</replaceable></literal>.
The argument may be a literal string, or <literal>@</literal> followed by a path name.
This option may be specified more than once. Any sections specified in this fashion will be
inserted (in order) before the <literal>.linux</literal> section which is always last.</para>
<para>For the <command>inspect</command> verb, the second syntax is used.
The section <replaceable>NAME</replaceable> will be inspected (if found).
If the second argument is <literal>text</literal>, the contents will be printed.
If the third argument is given, the contents will be saved to file <replaceable>PATH</replaceable>.
</para>
<para>Note that the name is used as-is, and if the section name should start with a dot, it must be
included in <replaceable>NAME</replaceable>.</para>
</listitem>
</varlistentry>
<varlistentry>
@ -196,6 +220,18 @@
form the configuration file and the commandline are combined.</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--all</option></term>
<listitem><para>Print all sections (with <command>inspect</command> verb).</para></listitem>
</varlistentry>
<varlistentry>
<term><option>--json</option></term>
<listitem><para>Generate JSON output (with <command>inspect</command> verb).</para></listitem>
</varlistentry>
<xi:include href="standard-options.xml" xpointer="help" />
<xi:include href="standard-options.xml" xpointer="version" />
</variablelist>