]> git.ipfire.org Git - thirdparty/systemd.git/commitdiff
man: document --prompt-new-user which was added back in v256
authorLennart Poettering <lennart@poettering.net>
Fri, 26 Sep 2025 14:09:02 +0000 (16:09 +0200)
committerLennart Poettering <lennart@poettering.net>
Fri, 26 Sep 2025 14:19:43 +0000 (16:19 +0200)
man/homectl.xml

index 36b3bbfe9c85315903d8f0fd41c12c90ad4a210b..83e2286acb782056aefbdcac3e4b20a1b782bae3 100644 (file)
         <xi:include href="version-info.xml" xpointer="v258"/></listitem>
       </varlistentry>
 
+      <varlistentry>
+        <term><option>--prompt-new-user</option></term>
+
+        <listitem><para>If used in conjunction with <command>firstboot</command> and no regular user account
+        exists on the system so far the tool will interactively query for user information and create an
+        account.</para>
+
+        <xi:include href="version-info.xml" xpointer="v256"/></listitem>
+      </varlistentry>
+
       <varlistentry>
         <term><option>--match=</option></term>
         <term><option>-A</option></term>
@@ -1424,9 +1434,10 @@ $ ssh lennart@targetsystem</programlisting>
 
         <listitem><para>This command is supposed to be invoked during the initial boot of the system. It
         checks whether any regular home area exists so far, and if not queries the user interactively on the
-        console for user name and password and creates one. Alternatively, if one or more service credentials
-        whose name starts with <literal>home.create.</literal> are passed to the command (containing a user
-        record in JSON format) these users are automatically created at boot.</para>
+        console for user name and password and creates one (only if <option>--prompt-new-user</option> is
+        specified). Alternatively, if one or more service credentials whose name starts with
+        <literal>home.create.</literal> are passed to the command (containing a user record in JSON format)
+        these users are automatically created at boot.</para>
 
         <para>This command is invoked by the <filename>systemd-homed-firstboot.service</filename> service
         unit.</para>