2
.\" Title: systemd-machine-id-setup
3
.\" Author: Lennart Poettering <lennart@poettering.net>
4
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
6
.\" Manual: systemd-machine-id-setup
10
.TH "SYSTEMD\-MACHINE\-ID" "1" "03/16/2012" "systemd" "systemd-machine-id-setup"
11
.\" -----------------------------------------------------------------
12
.\" * Define some portability stuff
13
.\" -----------------------------------------------------------------
14
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15
.\" http://bugs.debian.org/507673
16
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20
.\" -----------------------------------------------------------------
21
.\" * set default formatting
22
.\" -----------------------------------------------------------------
23
.\" disable hyphenation
25
.\" disable justification (adjust text to left margin only)
27
.\" -----------------------------------------------------------------
28
.\" * MAIN CONTENT STARTS HERE *
29
.\" -----------------------------------------------------------------
31
systemd-machine-id-setup \- Initialize the machine ID in /etc/machine\-id
33
.HP \w'\fBsystemd\-machine\-id\-setup\fR\ 'u
34
\fBsystemd\-machine\-id\-setup\fR
37
\fBsystemd\-machine\-id\-setup\fR
38
may be used by system installer tools to initialize the machine ID stored in
40
at install time with a randomly generated ID\&. See
42
for more information about this file\&.
44
This tool will execute no operation if
46
is already initialized\&.
48
If a valid D\-Bus machine ID is already configured for the system the D\-Bus machine ID is copied and used to initialize the machine ID in
51
If run inside a KVM virtual machine and a UUID is passed via the
53
option this UUID is used to initialize the machine ID instead of a randomly generated one\&. The caller must ensure that the UUID passed is sufficiently unique and is different for every booted instanced of the VM\&.
55
Similar, if run inside a Linux container environment and a UUID is set for the container this is used to initialize the machine ID\&. For details see the documentation of the
56
\m[blue]\fBContainer Interface\fR\m[]\&\s-2\u[1]\d\s+2\&.
59
This tool does not take any options or arguments\&.
62
On success 0 is returned, a non\-zero failure code otherwise\&.
71
\fBLennart Poettering\fR <\&lennart@poettering\&.net\&>
79
\%http://www.freedesktop.org/wiki/Software/systemd/ContainerInterface