X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd-firstboot.xml;h=67d38ba31ff8e8f8fda05752736562f6a81794e6;hp=42fd753f533d90a36d4a12f8c4fd48d5554bdee8;hb=1433efd219a6df414a1821b3d3d70d86201ed3e4;hpb=30f10abf42f9e4d251a0b45b07812aafdef6be7c diff --git a/man/systemd-firstboot.xml b/man/systemd-firstboot.xml index 42fd753f5..67d38ba31 100644 --- a/man/systemd-firstboot.xml +++ b/man/systemd-firstboot.xml @@ -1,6 +1,6 @@ + "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> - - - - systemd-firstboot - systemd - - - - Developer - Lennart - Poettering - lennart@poettering.net - - - - - - systemd-firstboot - 1 - - - - systemd-firstboot - systemd-firstboot.service - Initialize basic system settings on or before the first boot-up of a system - - - - - systemd-firstboot - OPTIONS - - - systemd-firstboot.service - - - - Description - - 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: - - - The system locale, more - specifically the two locale variables - LANG= and - LC_MESSAGES - - The system time zone - - The system host name - - The machine ID of the system - - The root user's password - - - Each of the fields may either be queried - interactively from the users, set non-interactively on - the tool's command line, or be copied from a host - system that is used to set up the system image. - - If a setting is already initialized it will not - be overwritten and the user will not be prompted for - the setting. - - Note that this tool operates directly on the - file system and does not involve any running system - services, unlike - localectl1, - timedatectl1 - or - hostnamectl1. This - allows systemd-firstboot to operate - on mounted but not booted disk images and in early - boot. It is not recommended to use - systemd-firsboot on the running - system while it is up. - - - - Options - - The following options are understood: - - - - - Takes a directory path - as an argument. All paths will be - prefixed with the given alternate - root path, - including config search paths. This is - useful to operate on a system image - mounted to the specified directory - instead of the host system itself. - - - - - - - - Sets the system - locale, more specifically the - LANG= and - LC_MESSAGES - settings. The argument should be a - valid locale identifier, such as - de_DE.UTF-8. This - controls the - locale.conf5 - configuration file. - - - - - - Sets the system time - zone. The argument should be a valid - time zone identifier, such as - Europe/Berlin. This - controls the - localtime5 - symlink. - - - - - - Sets the system - hostname. The argument should be a - host name, compatible with DNS. This - controls the - hostname5 - configuration file. - - - - - - Sets the system's machine ID. This - controls the - machine-id5 - file. - - - - - - - Sets the password of - the system's root user. This creates a - shadow5 - file. This setting exists in two - forms: - - accepts the password to set directly - on the command line, - - reads it from a file. Note that - it is not recommended specifying - passwords on the command line as other - users might be able to see them - simply by invoking - ps1. - - - - - - - - - Prompt the user interactively - for a specific basic setting. Note - that any explicit configuration - settings specified on the command line - take precedence, and the user is not - prompted for it. - - - - - - Query the user for locale, - timezone, hostname and root - password. This is equivalent to - specifiying - , - , - , - - in combination. - - - - - - - - Copy a specific basic setting - from the host. This only works in - combination with - (see - above). - - - - - - Copy locale, time zone and root - password from the host. This is - equivalent to specifiying - , - , - - in combination. - - - - - - Initialize the system's machine - ID to a random ID. This only works - combination with - . - - - - - - - - - - Exit status - - On success, 0 is returned, a non-zero failure - code otherwise. - - - - See Also - - systemd1, - locale.conf5, - localtime5, - hostname5, - machine-id5, - shadow5, - systemd-machine-id-setup1, - localectl1, - timedatectl1, - hostnamectl1 - - + + + + systemd-firstboot + systemd + + + + Developer + Lennart + Poettering + lennart@poettering.net + + + + + + systemd-firstboot + 1 + + + + systemd-firstboot + systemd-firstboot.service + Initialize basic system settings on or before the first boot-up of a system + + + + + systemd-firstboot + OPTIONS + + + systemd-firstboot.service + + + + Description + + 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: + + + The system locale, more specifically the two + locale variables LANG= and + LC_MESSAGES + + The system time zone + + The system host name + + The machine ID of the system + + The root user's password + + + Each of the fields may either be queried interactively from + the users, set non-interactively on the tool's command line, or be + copied from a host system that is used to set up the system + image. + + If a setting is already initialized it will not be + overwritten and the user will not be prompted for the + setting. + + Note that this tool operates directly on the file system and + does not involve any running system services, unlike + localectl1, + timedatectl1 + or + hostnamectl1. + This allows systemd-firstboot to operate on + mounted but not booted disk images and in early boot. It is not + recommended to use systemd-firstboot on the + running system while it is up. + + + + Options + + The following options are understood: + + + + + Takes a directory path as an argument. All + paths will be prefixed with the given alternate + root path, including config search + paths. This is useful to operate on a system image mounted to + the specified directory instead of the host system itself. + + + + + + + + Sets the system locale, more specifically the + LANG= and LC_MESSAGES + settings. The argument should be a valid locale identifier, + such as de_DE.UTF-8. This controls the + locale.conf5 + configuration file. + + + + + + Sets the system time zone. The argument should + be a valid time zone identifier, such as + Europe/Berlin. This controls the + localtime5 + symlink. + + + + + + Sets the system hostname. The argument should + be a host name, compatible with DNS. This controls the + hostname5 + configuration file. + + + + + + Sets the system's machine ID. This controls + the + machine-id5 + file. + + + + + + + Sets the password of the system's root user. + This creates a + shadow5 + file. This setting exists in two forms: + accepts the password to set + directly on the command line, + reads it from a file. + Note that it is not recommended specifying passwords on the + command line as other users might be able to see them simply + by invoking + ps1. + + + + + + + + + Prompt the user interactively for a specific + basic setting. Note that any explicit configuration settings + specified on the command line take precedence, and the user is + not prompted for it. + + + + + + Query the user for locale, timezone, hostname + and root password. This is equivalent to specifying + , + , + , + in combination. + + + + + + + + + Copy a specific basic setting from the host. + This only works in combination with + (see above). + + + + + + Copy locale, time zone and root password from + the host. This is equivalent to specifying + , + , + in combination. + + + + + + + Initialize the system's machine ID to a random + ID. This only works in combination with + . + + + + + + + + + + Exit status + + On success, 0 is returned, a non-zero failure code + otherwise. + + + + See Also + + systemd1, + locale.conf5, + localtime5, + hostname5, + machine-id5, + shadow5, + systemd-machine-id-setup1, + localectl1, + timedatectl1, + hostnamectl1 + +