## NAME

systemd-machine-id-setup - Initialize the machine ID in /etc/machine-id

## SYNOPSIS

systemd-machine-id-setup

## DESCRIPTION

systemd-machine-id-setup may be used by system installer tools to initialize the machine ID stored in /etc/machine-id at install time with a randomly generated ID. See machine-id(5) for more information about this file.

This tool will execute no operation if /etc/machine-id is already initialized.

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 /etc/machine-id.

If run inside a KVM virtual machine and a UUID is passed via the -uuid 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.

Similarly, 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 m[blue]Container Interfacem[]s-2u[1]ds+2.

## OPTIONS

The following options are understood:

--root=root

Takes a directory path as an argument. All paths will be prefixed with the given alternate root path, including config search paths.

-h, --help

Print a short help text and exit.

--version

Print a short version string and exit.

## EXIT STATUS

On success, 0 is returned, a non-zero failure code otherwise.

## SEE ALSO

systemd(1), machine-id(5), dbus-uuidgen(1)

## NOTES

1. 4

Container Interface

%http://www.freedesktop.org/wiki/Software/systemd/ContainerInterface