Debian Codegraph @

upstream/debian-unstable/man8/systemd-machine-id-commit.service.8

raw
1 '\" t
2 .TH "SYSTEMD\-MACHINE\-ID\-COMMIT\&.SERVICE" "8" "" "systemd 261~rc3" "systemd-machine-id-commit.service"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 systemd-machine-id-commit.service \- Commit a transient machine ID to disk
24 .SH "SYNOPSIS"
25 .PP
26 systemd\-machine\-id\-commit\&.service
27 .SH "DESCRIPTION"
28 .PP
29 systemd\-machine\-id\-commit\&.service
30 is an early boot service responsible for committing transient
31 /etc/machine\-id
32 files to a writable disk file system\&. See
33 \fBmachine-id\fR(5)
34 for more information about machine IDs\&.
35 .PP
36 This service is started after
37 local\-fs\&.target
38 in case
39 /etc/machine\-id
40 is a mount point of its own (usually from a memory file system such as
41 "tmpfs") and /etc is writable\&. The service will invoke
42 \fBsystemd\-machine\-id\-setup \-\-commit\fR, which writes the current transient machine ID to disk and unmount the
43 /etc/machine\-id
44 file in a race\-free manner to ensure that file is always valid and accessible for other processes\&. See
45 \fBsystemd-machine-id-setup\fR(1)
46 for details\&.
47 .PP
48 The main use case of this service are systems where
49 /etc/machine\-id
50 is read\-only and initially not initialized\&. In this case, the system manager will generate a transient machine ID file on a memory file system, and mount it over
51 /etc/machine\-id, during the early boot phase\&. This service is then invoked in a later boot phase, as soon as
52 /etc/
53 has been remounted writable and the ID may thus be committed to disk to make it permanent\&.
54 .SH "SEE ALSO"
55 .PP
56 \fBsystemd\fR(1), \fBsystemd-machine-id-setup\fR(1), \fBmachine-id\fR(5), \fBsystemd-firstboot\fR(1)