summaryrefslogtreecommitdiffstats
path: root/upstream/fedora-rawhide/man1/systemd-firstboot.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/fedora-rawhide/man1/systemd-firstboot.1')
-rw-r--r--upstream/fedora-rawhide/man1/systemd-firstboot.135
1 files changed, 19 insertions, 16 deletions
diff --git a/upstream/fedora-rawhide/man1/systemd-firstboot.1 b/upstream/fedora-rawhide/man1/systemd-firstboot.1
index 2b65a8ad..38848a53 100644
--- a/upstream/fedora-rawhide/man1/systemd-firstboot.1
+++ b/upstream/fedora-rawhide/man1/systemd-firstboot.1
@@ -1,5 +1,5 @@
'\" t
-.TH "SYSTEMD\-FIRSTBOOT" "1" "" "systemd 255" "systemd-firstboot"
+.TH "SYSTEMD\-FIRSTBOOT" "1" "" "systemd 256~rc3" "systemd-firstboot"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -28,14 +28,27 @@ systemd-firstboot, systemd-firstboot.service \- Initialize basic system settings
systemd\-firstboot\&.service
.SH "DESCRIPTION"
.PP
-\fBsystemd\-firstboot\fR
-initializes basic system settings interactively during the first boot, or non\-interactively on an offline system image\&. The service is started during boot if
+The
+\fBsystemd\-firstboot\&.service\fR
+unit is one of the units which are used to initialize the machine configuration during "First Boot", i\&.e\&. when the system is freshly installed or after a factory reset\&. The
+\fBsystemd\fR(1)
+manager itself will initialize
+\fBmachine-id\fR(5)
+and preset all units, enabling or disabling them according to the
+\fBsystemd.preset\fR(5)
+settings\&.
+systemd\-firstboot\&.service
+is started later to interactively initialize basic system configuration\&. It is started only if
\fIConditionFirstBoot=yes\fR
is met, which essentially means that
/etc/
is unpopulated, see
\fBsystemd.unit\fR(5)
-for details\&.
+for details\&. System credentials may be used to inject configuration; those settings are not queried interactively\&.
+.PP
+The
+\fBsystemd\-firstboot\fR
+command can also be used to non\-interactively initialize an offline system image\&.
.PP
The following settings may be configured:
.sp
@@ -440,7 +453,7 @@ like this:
.RE
.\}
.PP
-Note that these credentials are only read and applied during the first boot process\&. Once they are applied they remain applied for subsequent boots, and the credentials are not considered anymore\&.
+Note that these credentials are only read and applied during the first boot\&. Once they are applied they remain applied for subsequent boots, and the credentials are not considered anymore\&.
.SH "EXIT STATUS"
.PP
On success, 0 is returned, a non\-zero failure code otherwise\&.
@@ -456,17 +469,7 @@ Added in version 233\&.
.RE
.SH "SEE ALSO"
.PP
-\fBsystemd\fR(1),
-\fBlocale.conf\fR(5),
-\fBvconsole.conf\fR(5),
-\fBlocaltime\fR(5),
-\fBhostname\fR(5),
-\fBmachine-id\fR(5),
-\fBshadow\fR(5),
-\fBsystemd-machine-id-setup\fR(1),
-\fBlocalectl\fR(1),
-\fBtimedatectl\fR(1),
-\fBhostnamectl\fR(1)
+\fBsystemd\fR(1), \fBlocale.conf\fR(5), \fBvconsole.conf\fR(5), \fBlocaltime\fR(5), \fBhostname\fR(5), \fBmachine-id\fR(5), \fBshadow\fR(5), \fBsystemd-machine-id-setup\fR(1), \fBlocalectl\fR(1), \fBtimedatectl\fR(1), \fBhostnamectl\fR(1)
.SH "NOTES"
.IP " 1." 4
Discoverable Partitions Specification