1SYSTEMD-MACHINE-ID-SETUP(1)systemd-machine-id-setupSYSTEMD-MACHINE-ID-SETUP(1)
2
3
4
6 systemd-machine-id-setup - Initialize the machine ID in /etc/machine-id
7
9 systemd-machine-id-setup
10
12 systemd-machine-id-setup may be used by system installer tools to
13 initialize the machine ID stored in /etc/machine-id at install time
14 with a randomly generated ID. See machine-id(5) for more information
15 about this file.
16
17 This tool will execute no operation if /etc/machine-id is already
18 initialized.
19
20 If a valid D-Bus machine ID is already configured for the system, the
21 D-Bus machine ID is copied and used to initialize the machine ID in
22 /etc/machine-id.
23
24 If run inside a KVM virtual machine and a UUID is passed via the -uuid
25 option, this UUID is used to initialize the machine ID instead of a
26 randomly generated one. The caller must ensure that the UUID passed is
27 sufficiently unique and is different for every booted instanced of the
28 VM.
29
30 Similar, if run inside a Linux container environment and a UUID is set
31 for the container this is used to initialize the machine ID. For
32 details see the documentation of the Container Interface[1].
33
34 Use systemd-firstboot(1) to initialize the machine ID on mounted (but
35 not booted) system images.
36
38 The following options are understood:
39
40 --root=root
41 Takes a directory path as an argument. All paths will be prefixed
42 with the given alternate root path, including config search paths.
43
44 -h, --help
45 Print a short help text and exit.
46
47 --version
48 Print a short version string and exit.
49
51 On success, 0 is returned, a non-zero failure code otherwise.
52
54 systemd(1), machine-id(5), dbus-uuidgen(1), systemd-firstboot(1)
55
57 1. Container Interface
58 http://www.freedesktop.org/wiki/Software/systemd/ContainerInterface
59
60
61
62systemd 219 SYSTEMD-MACHINE-ID-SETUP(1)