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.

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 Container Interface.

Options

This tool does not take any options or arguments.

Exit status

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

See Also

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