<?xml version='1.0'?> <!--*-nxml-*-->

<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"

"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [

<!ENTITY % entities SYSTEM "custom-entities.ent" >

%entities;

]>

<refentry id="systemd-machine-id-setup"

xmlns:xi="http://www.w3.org/2001/XInclude">

<refentryinfo>

<title>systemd-machine-id-setup</title>

<productname>systemd</productname>

<authorgroup>

<author>

<contrib>Developer</contrib>

<firstname>Lennart</firstname>

<surname>Poettering</surname>

<email>lennart@poettering.net</email>

</author>

</authorgroup>

</refentryinfo>

<refmeta>

<refentrytitle>systemd-machine-id-setup</refentrytitle>

<manvolnum>1</manvolnum>

</refmeta>

<refnamediv>

<refname>systemd-machine-id-setup</refname>

<refpurpose>Initialize the machine ID in /etc/machine-id</refpurpose>

</refnamediv>

<refsynopsisdiv>

<cmdsynopsis>

<command>systemd-machine-id-setup</command>

</cmdsynopsis>

</refsynopsisdiv>

<refsect1>

<title>Description</title>

<para><command>systemd-machine-id-setup</command> may be used by

system installer tools to initialize the machine ID stored in

<filename>/etc/machine-id</filename> at install time with a

randomly generated ID. See

<citerefentry><refentrytitle>machine-id</refentrytitle><manvolnum>5</manvolnum></citerefentry>

for more information about this file.</para>

<para>This tool will execute no operation if

<filename>/etc/machine-id</filename> is already

initialized.</para>

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

<para>If run inside a KVM virtual machine and a UUID is passed via

the <option>-uuid</option> 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.</para>

<para>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 <ulink

url="http://www.freedesktop.org/wiki/Software/systemd/ContainerInterface">Container

Interface</ulink>.</para>

<para>Use

<citerefentry><refentrytitle>systemd-firstboot</refentrytitle><manvolnum>1</manvolnum></citerefentry>

to initialize the machine ID on mounted (but not booted) system

images.</para>

</refsect1>

<refsect1>

<title>Options</title>

<para>The following options are understood:</para>

<variablelist>

<varlistentry>

<term><option>--root=<replaceable>root</replaceable></option></term>

<listitem><para>Takes a directory path as an argument. All

paths will be prefixed with the given alternate

<replaceable>root</replaceable> path, including config search

paths. </para></listitem>

</varlistentry>

<xi:include href="standard-options.xml" xpointer="help" />

<xi:include href="standard-options.xml" xpointer="version" />

</variablelist>

</refsect1>

<refsect1>

<title>Exit status</title>

<para>On success, 0 is returned, a non-zero failure code

otherwise.</para>

</refsect1>

<refsect1>

<title>See Also</title>

<para>

<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>machine-id</refentrytitle><manvolnum>5</manvolnum></citerefentry>,

<citerefentry project='dbus'><refentrytitle>dbus-uuidgen</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>systemd-firstboot</refentrytitle><manvolnum>1</manvolnum></citerefentry>

</para>

</refsect1>

</refentry>