SymbX/systemd
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

man: document the new systemd-sysupdate switches and verbs

Browse Source
This commit is contained in:
Lennart Poettering
2026-07-15 13:27:48 +02:00
parent 559f52ee3f
commit b488ee3dcc
1 changed files with 72 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files
man/systemd-sysupdate.xml
+72 -3
View File
@@ -128,6 +128,21 @@
<xi:include href="version-info.xml" xpointer="v257"/></listitem>
</varlistentry>
<varlistentry>
<term><option>enable-feature</option> <replaceable>FEATURE</replaceable>…</term>
<term><option>disable-feature</option> <replaceable>FEATURE</replaceable>…</term>
<listitem><para>Enables or disables the specified optional features. This writes an
<varname>Enabled=</varname> setting into a drop-in next to the feature definition, see
<citerefentry><refentrytitle>sysupdate.features</refentrytitle><manvolnum>5</manvolnum></citerefentry>
for details. The features may be specified either as arguments or selected via the
<option>--feature-all</option> or <option>--feature-suggested</option> switches. Note that this only
changes the configuration: to actually download the newly enabled transfers, or remove the disabled
ones, invoke <option>update</option> or <option>vacuum</option> afterwards.</para>
<xi:include href="version-info.xml" xpointer="v262"/></listitem>
</varlistentry>
<varlistentry>
<term><option>check-new</option></term>
@@ -216,6 +231,18 @@
<xi:include href="version-info.xml" xpointer="v251"/></listitem>
</varlistentry>
<varlistentry>
<term><option>enable-component</option> <replaceable>COMPONENT</replaceable>…</term>
<term><option>disable-component</option> <replaceable>COMPONENT</replaceable>…</term>
<listitem><para>Enables or disables the specified components. This writes an
<varname>Enabled=</varname> setting into a drop-in next to the component definition. The components
may be specified either as arguments or selected via the <option>--component=</option>,
<option>--component-all</option> or <option>--component-suggested</option> switches.</para>
<xi:include href="version-info.xml" xpointer="v262"/></listitem>
</varlistentry>
<varlistentry>
<term><option>cleanup</option></term>
@@ -287,15 +314,57 @@
<term><option>--component-all</option></term>
<term><option>-A</option></term>
<listitem><para>Instead of operating on a single component, operate on all known components (as well as
the default, component-less installation). This is currently only supported for the
<command>cleanup</command> command; all other commands will fail if this switch is used.</para>
<listitem><para>Instead of operating on a single component, operate on all known components (as well
as the default, component-less installation). This is supported for the <command>update</command>,
<command>acquire</command>, <command>cleanup</command>, <command>enable-feature</command>,
<command>disable-feature</command>, <command>enable-component</command> and
<command>disable-component</command> commands; all other commands will fail if this switch is
used.</para>
<para>This option may not be combined with <option>--component=</option>.</para>
<xi:include href="version-info.xml" xpointer="v262"/></listitem>
</varlistentry>
<varlistentry>
<term><option>--component-suggested</option></term>
<term><option>-S</option></term>
<listitem><para>Similar to <option>--component-all</option>, but operates only on the components that
are currently <emphasis>suggested</emphasis> for this system, as determined by the
<varname>Suggest=</varname> and <varname>SuggestOn…=</varname> settings in the component definition
files. This is supported for the <command>enable-component</command> and
<command>disable-component</command> commands.</para>
<para>This option may not be combined with <option>--component=</option>.</para>
<xi:include href="version-info.xml" xpointer="v262"/></listitem>
</varlistentry>
<varlistentry>
<term><option>--feature-all</option></term>
<term><option>-a</option></term>
<listitem><para>Instead of operating on features specified on the command line, operate on all
optional features known to the selected component(s). This is supported for the
<command>enable-feature</command> and <command>disable-feature</command> commands.</para>
<xi:include href="version-info.xml" xpointer="v262"/></listitem>
</varlistentry>
<varlistentry>
<term><option>--feature-suggested</option></term>
<term><option>-s</option></term>
<listitem><para>Similar to <option>--feature-all</option>, but operates only on the optional features
that are currently <emphasis>suggested</emphasis> for this system, as determined by the
<varname>Suggest=</varname> and <varname>SuggestOn…=</varname> settings in the feature definition
files. This is supported for the <command>enable-feature</command> and
<command>disable-feature</command> commands.</para>
<xi:include href="version-info.xml" xpointer="v262"/></listitem>
</varlistentry>
<varlistentry>
<term><option>--definitions=</option></term>