From: Lennart Poettering <lennart@amutable.com>
Date: Wed, 1 Jul 2026 12:58:28 +0000 (+0200)
Subject: man: document the new systemd-sysupdate switches and verbs
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=b488ee3dcce0dff5e211a74dffaf750c5e6d4b86;p=thirdparty%2Fsystemd.git

man: document the new systemd-sysupdate switches and verbs
---

diff --git a/man/systemd-sysupdate.xml b/man/systemd-sysupdate.xml
index 0491b7118fb..28b6ac53c22 100644
--- a/man/systemd-sysupdate.xml
+++ b/man/systemd-sysupdate.xml
@@ -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>