systemd-machine-id-setup(1)

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 provisioned or randomly generated ID. See machine-id(5) for more information about this file.

If the tool is invoked without the --commit switch, /etc/machine-id is initialized with a valid, new machine ID if it is missing or empty. The new machine ID will be acquired in the following fashion:

The --commit switch may be used to commit a transient machined ID to disk, making it persistent. For details, see below.

Use systemd-firstboot(1) to initialize the machine ID on mounted (but not booted) system images.

OPTIONS#

The following options are understood:

--root=path

Added in version 212.

--image=path

Added in version 249.

--image-policy=policy

--commit

This command will execute no operation if /etc/machine-id is not mounted from a memory file system, or if /etc/ is read-only. The command will write the current transient machine ID to disk and unmount the /etc/machine-id mount point in a race-free manner to ensure that this file is always valid and accessible for other processes.

This command is primarily used by the systemd-machine-id-commit.service(8) early boot service.

Added in version 227.

--print

Added in version 231.

-h, --help

--version

EXIT STATUS#

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

SEE ALSO#

systemd(1), machine-id(5), systemd-machine-id-commit.service(8), dbus-uuidgen(1), systemd-firstboot(1)

NOTES#

1.

Container Interface