diff options
Diffstat (limited to 'upstream/opensuse-tumbleweed/man1/systemd-firstboot.1')
| -rw-r--r-- | upstream/opensuse-tumbleweed/man1/systemd-firstboot.1 | 58 |
1 files changed, 54 insertions, 4 deletions
diff --git a/upstream/opensuse-tumbleweed/man1/systemd-firstboot.1 b/upstream/opensuse-tumbleweed/man1/systemd-firstboot.1 index fd64c003..2b65a8ad 100644 --- a/upstream/opensuse-tumbleweed/man1/systemd-firstboot.1 +++ b/upstream/opensuse-tumbleweed/man1/systemd-firstboot.1 @@ -1,5 +1,5 @@ '\" t -.TH "SYSTEMD\-FIRSTBOOT" "1" "" "systemd 254" "systemd-firstboot" +.TH "SYSTEMD\-FIRSTBOOT" "1" "" "systemd 255" "systemd-firstboot" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -33,7 +33,7 @@ initializes basic system settings interactively during the first boot, or non\-i \fIConditionFirstBoot=yes\fR is met, which essentially means that /etc/ -is empty, see +is unpopulated, see \fBsystemd.unit\fR(5) for details\&. .PP @@ -141,6 +141,8 @@ The following options are understood: Takes a directory path as an argument\&. All paths will be prefixed with the given alternate \fIroot\fR 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\&. +.sp +Added in version 216\&. .RE .PP \fB\-\-image=\fR\fB\fIpath\fR\fR @@ -150,6 +152,8 @@ Takes a path to a disk image file or block device node\&. If specified all opera 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 \m[blue]\fBDiscoverable Partitions Specification\fR\m[]\&\s-2\u[1]\d\s+2\&. For further information on supported disk images, see \fBsystemd-nspawn\fR(1)\*(Aqs switch of the same name\&. +.sp +Added in version 246\&. .RE .PP \fB\-\-locale=\fR\fB\fILOCALE\fR\fR, \fB\-\-locale\-messages=\fR\fB\fILOCALE\fR\fR @@ -162,6 +166,8 @@ settings\&. The argument should be a valid locale identifier, such as "de_DE\&.UTF\-8"\&. This controls the \fBlocale.conf\fR(5) configuration file\&. +.sp +Added in version 216\&. .RE .PP \fB\-\-keymap=\fR\fB\fIKEYMAP\fR\fR @@ -172,6 +178,8 @@ Sets the system keyboard layout\&. The argument should be a valid keyboard map, entry in the \fBvconsole.conf\fR(5) configuration file\&. +.sp +Added in version 236\&. .RE .PP \fB\-\-timezone=\fR\fB\fITIMEZONE\fR\fR @@ -180,6 +188,8 @@ Sets the system time zone\&. The argument should be a valid time zone identifier "Europe/Berlin"\&. This controls the \fBlocaltime\fR(5) symlink\&. +.sp +Added in version 216\&. .RE .PP \fB\-\-hostname=\fR\fB\fIHOSTNAME\fR\fR @@ -187,6 +197,8 @@ symlink\&. Sets the system hostname\&. The argument should be a hostname, compatible with DNS\&. This controls the \fBhostname\fR(5) configuration file\&. +.sp +Added in version 216\&. .RE .PP \fB\-\-setup\-machine\-id\fR @@ -202,12 +214,16 @@ or machine\-id is written by the manager with help from \fBsystemd-machine-id-commit.service\fR(8)\&. +.sp +Added in version 216\&. .RE .PP \fB\-\-machine\-id=\fR\fB\fIID\fR\fR .RS 4 Set the system\*(Aqs machine ID to the specified value\&. The same restrictions apply as to \fB\-\-setup\-machine\-id\fR\&. +.sp +Added in version 216\&. .RE .PP \fB\-\-root\-password=\fR\fB\fIPASSWORD\fR\fR, \fB\-\-root\-password\-file=\fR\fB\fIPATH\fR\fR, \fB\-\-root\-password\-hashed=\fR\fB\fIHASHED_PASSWORD\fR\fR @@ -226,6 +242,8 @@ accepts an already hashed password on the command line\&. See \fBshadow\fR(5) 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 \fBps\fR(1)\&. +.sp +Added in version 216\&. .RE .PP \fB\-\-root\-shell=\fR\fB\fISHELL\fR\fR @@ -233,6 +251,8 @@ for more information on the format of the hashed password\&. Note that it is not Sets the shell of the system\*(Aqs root user\&. This creates/modifies the \fBpasswd\fR(5) file\&. +.sp +Added in version 246\&. .RE .PP \fB\-\-kernel\-command\-line=\fR\fB\fICMDLINE\fR\fR @@ -241,11 +261,15 @@ Sets the system\*(Aqs kernel command line\&. This controls the /etc/kernel/cmdline file which is used by \fBkernel-install\fR(8)\&. +.sp +Added in version 246\&. .RE .PP \fB\-\-prompt\-locale\fR, \fB\-\-prompt\-keymap\fR, \fB\-\-prompt\-timezone\fR, \fB\-\-prompt\-hostname\fR, \fB\-\-prompt\-root\-password\fR, \fB\-\-prompt\-root\-shell\fR .RS 4 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\&. +.sp +Added in version 216\&. .RE .PP \fB\-\-prompt\fR @@ -258,6 +282,8 @@ Query the user for locale, keymap, timezone, hostname, root\*(Aqs password, and \fB\-\-prompt\-root\-password\fR, \fB\-\-prompt\-root\-shell\fR in combination\&. +.sp +Added in version 216\&. .RE .PP \fB\-\-copy\-locale\fR, \fB\-\-copy\-keymap\fR, \fB\-\-copy\-timezone\fR, \fB\-\-copy\-root\-password\fR, \fB\-\-copy\-root\-shell\fR @@ -266,6 +292,8 @@ Copy a specific basic setting from the host\&. This only works in combination wi \fB\-\-root=\fR or \fB\-\-image=\fR\&. +.sp +Added in version 216\&. .RE .PP \fB\-\-copy\fR @@ -277,14 +305,16 @@ Copy locale, keymap, time zone, root password and shell from the host\&. This is \fB\-\-copy\-root\-password\fR, \fB\-\-copy\-root\-shell\fR in combination\&. +.sp +Added in version 216\&. .RE .PP \fB\-\-force\fR .RS 4 Write configuration even if the relevant files already exist\&. Without this option, -systemd\-firstboot +\fBsystemd\-firstboot\fR doesn\*(Aqt modify or replace existing files\&. Note that when configuring the root account, even with this option, -systemd\-firstboot +\fBsystemd\-firstboot\fR only modifies the entry of the "root" user, leaving other entries in @@ -292,6 +322,8 @@ user, leaving other entries in and /etc/shadow intact\&. +.sp +Added in version 246\&. .RE .PP \fB\-\-reset\fR @@ -301,16 +333,22 @@ If specified, all existing files that are configured by are removed\&. Note that the files are removed regardless of whether they\*(Aqll be configured with a new value or not\&. This operation ensures that the next boot of the image will be considered a first boot, and \fBsystemd\-firstboot\fR will prompt again to configure each of the removed files\&. +.sp +Added in version 254\&. .RE .PP \fB\-\-delete\-root\-password\fR .RS 4 Removes the password of the system\*(Aqs 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\&. +.sp +Added in version 246\&. .RE .PP \fB\-\-welcome=\fR .RS 4 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\&. +.sp +Added in version 246\&. .RE .PP \fB\-h\fR, \fB\-\-help\fR @@ -336,6 +374,8 @@ for details)\&. The following credentials are used when passed in: A hashed or plaintext version of the root password to use, in place of prompting the user\&. These credentials are equivalent to the same ones defined for the \fBsystemd-sysusers.service\fR(8) service\&. +.sp +Added in version 249\&. .RE .PP \fIpasswd\&.shell\&.root\fR @@ -343,11 +383,15 @@ service\&. Specifies the shell binary to use for the specified account\&. Equivalent to the credential of the same name defined for the \fBsystemd-sysusers.service\fR(8) service\&. +.sp +Added in version 249\&. .RE .PP \fIfirstboot\&.locale\fR, \fIfirstboot\&.locale\-messages\fR .RS 4 These credentials specify the locale settings to set during first boot, in place of prompting the user\&. +.sp +Added in version 249\&. .RE .PP \fIfirstboot\&.keymap\fR @@ -367,11 +411,15 @@ on first boot (if not already configured), and then read from there by is read on every boot, and is not persisted to disk (but any configuration in vconsole\&.conf will take precedence if present)\&. +.sp +Added in version 249\&. .RE .PP \fIfirstboot\&.timezone\fR .RS 4 This credential specifies the system timezone setting to set during first boot, in place of prompting the user\&. +.sp +Added in version 249\&. .RE .PP Note that by default the @@ -403,6 +451,8 @@ On success, 0 is returned, a non\-zero failure code otherwise\&. Takes a boolean argument, defaults to on\&. If off, systemd\-firstboot\&.service won\*(Aqt interactively query the user for basic settings at first boot, even if those settings are not initialized yet\&. +.sp +Added in version 233\&. .RE .SH "SEE ALSO" .PP |