diff options
Diffstat (limited to 'man')
| -rw-r--r-- | man/systemd-measure.xml | 6 | ||||
| -rw-r--r-- | man/systemd-stub.xml | 14 |
2 files changed, 18 insertions, 2 deletions
diff --git a/man/systemd-measure.xml b/man/systemd-measure.xml index 71983ffe00..69b9db59bb 100644 --- a/man/systemd-measure.xml +++ b/man/systemd-measure.xml @@ -77,7 +77,7 @@ <option>--osrel=</option>, <option>--cmdline=</option>, <option>--initrd=</option>, <option>--ucode=</option>, <option>--splash=</option>, <option>--dtb=</option>, <option>--uname=</option>, <option>--sbat=</option>, <option>--pcrpkey=</option>, - <option>--profile=</option>, see below. Only <option>--linux=</option> is mandatory. (Alternatively, + <option>--profile=</option>, <option>--dtbauto=</option>, <option>--hwids=</option>, see below. Only <option>--linux=</option> is mandatory. (Alternatively, specify <option>--current</option> to use the current values of PCR register 11 instead.)</para> <xi:include href="version-info.xml" xpointer="v252"/> @@ -125,6 +125,8 @@ <term><option>--sbat=<replaceable>PATH</replaceable></option></term> <term><option>--pcrpkey=<replaceable>PATH</replaceable></option></term> <term><option>--profile=<replaceable>PATH</replaceable></option></term> + <term><option>--dtbauto=<replaceable>PATH</replaceable></option></term> + <term><option>--hwids=<replaceable>PATH</replaceable></option></term> <listitem><para>When used with the <command>calculate</command> or <command>sign</command> verb, configures the files to read the unified kernel image components from. Each option corresponds with @@ -134,7 +136,7 @@ <xi:include href="version-info.xml" xpointer="v252"/> - <para id="v257">With the exception of <option>--profile=</option>, which has been added in version + <para id="v257">With the exception of <option>--profile=</option>, <option>--dtbauto=</option> and <option>--hwids=</option>, which have been added in version 257.</para></listitem> </varlistentry> diff --git a/man/systemd-stub.xml b/man/systemd-stub.xml index 439d999c64..6625fca91e 100644 --- a/man/systemd-stub.xml +++ b/man/systemd-stub.xml @@ -79,6 +79,20 @@ <listitem><para>A <literal>.dtb</literal> section with a compiled binary DeviceTree.</para></listitem> + <listitem><para>Zero or more <literal>.dtbauto</literal> sections. Stub will always try to find first matching one. + Matching process extracts first <varname>compatible</varname> string from <literal>.dtbauto</literal> + section and compares it with the first Devicetree's <varname>compatible</varname> string supplied by + the firmware in configuration tables. If firmware does not provide Devicetree, matching with + <varname>.hwids</varname> section will be used instead. Stub will use SMBIOS data to calculate hardware + IDs of the machine (as per <ulink url="https://learn.microsoft.com/en-us/windows-hardware/drivers/install/specifying-hardware-ids-for-a-computer">specification</ulink>), + then it will proceed to trying to find any of them in <literal>.hwids</literal> section and will use first + matching entry's <varname>compatible</varname> as a search key among the <literal>.dtbauto</literal> + entries, in a similar fashion as the use of <varname>compatible</varname> string read from the firmware + provided Devicetree was described before. First matching <literal>.dtbauto</literal> section will be + loaded and will override <varname>.dtb</varname> if present.</para></listitem> + + <listitem><para>A <literal>.hwids</literal> section with hardware IDs of the machines to match Devicetrees (refer to <literal>.dtbauto</literal> section description).</para></listitem> + <listitem><para>A <literal>.uname</literal> section with the kernel version information, i.e. the output of <command>uname -r</command> for the kernel included in the <literal>.linux</literal> section.</para></listitem> |