X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd-firstboot.xml;fp=man%2Fsystemd-firstboot.xml;h=42fd753f533d90a36d4a12f8c4fd48d5554bdee8;hb=30f10abf42f9e4d251a0b45b07812aafdef6be7c;hp=0000000000000000000000000000000000000000;hpb=ed3e4a3fd96891b5e7015723978e78cd21efd4fe;p=elogind.git diff --git a/man/systemd-firstboot.xml b/man/systemd-firstboot.xml new file mode 100644 index 000000000..42fd753f5 --- /dev/null +++ b/man/systemd-firstboot.xml @@ -0,0 +1,286 @@ + + + + + + + + + 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 + + + +