X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=man%2Fsystemd-firstboot.xml;h=0976394b662e2de92994745c0085bd0ea97c414b;hb=6b222c4b0227f9914446ac54754aea867f742be4;hp=b269e4811352b08fbbcbde35066ead30f245545e;hpb=70d54fca18f52e20c07f37a6c86133229521ee47;p=thirdparty%2Fsystemd.git diff --git a/man/systemd-firstboot.xml b/man/systemd-firstboot.xml index b269e481135..0976394b662 100644 --- a/man/systemd-firstboot.xml +++ b/man/systemd-firstboot.xml @@ -1,25 +1,7 @@ - - - + @@ -27,15 +9,6 @@ systemd-firstboot systemd - - - - Developer - Lennart - Poettering - lennart@poettering.net - - @@ -63,17 +36,25 @@ systemd-firstboot initializes the most basic system settings interactively on the first boot, or - optionally non-interactively when a system image is created. The - following settings may be set up: + optionally non-interactively when a system image is created. + The service is started if ConditionFirstBoot=yes + is satisfied. This essentially means that /etc + is empty, see + systemd.unit5 + for details. + + The following settings may be set up: The system locale, more specifically the two locale variables LANG= and LC_MESSAGES + The system keyboard map + The system time zone - The system host name + The system hostname The machine ID of the system @@ -117,6 +98,18 @@ + + + Takes a path to a disk image file or block device node. If specified all operations + are applied to file system in the indicated disk image. This is similar to + but operates on file systems stored in disk images or block devices. The disk image should either + contain just a file system or a set of file systems within a GPT partition table, following the + Discoverable Partitions + Specification. For further information on supported disk images, see + systemd-nspawn1's + switch of the same name. + + @@ -129,6 +122,15 @@ configuration file. + + + + Sets the system keyboard layout. The argument should be a valid keyboard map, + such as de-latin1. This controls the KEYMAP entry in the + vconsole.conf5 + configuration file. + + @@ -143,7 +145,7 @@ Sets the system hostname. The argument should - be a host name, compatible with DNS. This controls the + be a hostname, compatible with DNS. This controls the hostname5 configuration file. @@ -160,25 +162,45 @@ + - Sets the password of the system's root user. - This creates a + Sets the password of the system's root user. This creates/modifies the + passwd5 and + shadow5 + files. This setting exists in three forms: accepts the password to + set directly on the command line, reads it from a file and + accepts an already hashed password on the command line. See shadow5 - file. This setting exists in two forms: - accepts the password to set - directly on the command line, and - reads it from a file. - Note that it is not recommended to specify passwords on the - command line, as other users might be able to see them simply - by invoking - ps1. + for more information on the format of the hashed password. Note that it is not recommended to specify + plaintext passwords on the command line, as other users might be able to see them simply by invoking + ps1. + + + + + + + Sets the shell of the system's root user. This creates/modifies the + passwd5 + file. + + + + + + Sets the system's kernel command line. This controls the + /etc/kernel/cmdline file which is used by + kernel-install8. + + + Prompt the user interactively for a specific basic setting. Note that any explicit configuration settings @@ -189,19 +211,23 @@ - Query the user for locale, timezone, hostname + Query the user for locale, keymap, timezone, hostname and root password. This is equivalent to specifying , + , , , - in combination. + , + in combination. + + Copy a specific basic setting from the host. This only works in combination with @@ -211,11 +237,13 @@ - Copy locale, time zone and root password from + Copy locale, keymap, time zone and root password from the host. This is equivalent to specifying , + , , - in combination. + , + in combination. @@ -227,6 +255,31 @@ . + + + + systemd-firstboot doesn't modify existing files unless + is specified. For modifications to /etc/passwd and + /etc/shadow, systemd-firstboot only modifies the entry of the + root user instead of overwriting the entire file. + + + + + + Removes the password of the system's root user, enabling login as root without a + password unless the root account is locked. Note that this is extremely insecure and hence this + option should not be used lightly. + + + + + + Takes a boolean argument. By default when prompting the user for configuration + options a brief welcome text is shown before the first question is asked. Pass false to this option + to turn off the welcome text. + + @@ -240,11 +293,26 @@ otherwise. + + Kernel Command Line + + + + systemd.firstboot= + + Takes a boolean argument, defaults to on. If off, systemd-firstboot.service + won't interactively query the user for basic settings at first boot, even if those settings are not + initialized yet. + + + + See Also systemd1, locale.conf5, + vconsole.conf5, localtime5, hostname5, machine-id5,