fdo-mirrors/dbus
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/dbus/dbus.git synced 2026-04-21 13:30:56 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

Describe where machine ID comes from

Browse source
This commit is contained in:
Thomas Kluyver 2021-10-29 18:24:11 +00:00 • committed by Simon McVittie
parent aa42b1c91a
commit 3eba9d5d9b
1 changed files with 18 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

18
doc/dbus-specification.xml
View file

@ -4245,6 +4245,24 @@
It does not matter which object path a GetMachineId is sent to. The
reference implementation handles this method automatically.
</para>
<para>
On Unix, implementations should try to read the machine ID from
<literal>/var/lib/dbus/machine-id</literal> and
<literal>/etc/machine-id</literal>. The latter is
<ulink url='https://www.freedesktop.org/software/systemd/man/machine-id.html'>
defined by systemd</ulink>, but systems not using systemd may provide
an equivalent file.
If both exist, they are expected to have the same contents, and if they
differ, the spec does not define which takes precedence (the reference
implementation prefers <literal>/var/lib/dbus/machine-id</literal>,
but sd-bus does not).
</para>
<para>
On Windows, the hardware profile GUID is used as the machine ID,
with the punctuation removed. This can be obtained with the
<ulink url='https://docs.microsoft.com/en-us/windows/win32/api/winbase/nf-winbase-getcurrenthwprofilea'>
<function>GetCurrentHwProfile</function></ulink> function.
</para>
<para>
The UUID is intended to be per-instance-of-the-operating-system, so may represent
a virtual machine running on a hypervisor, rather than a physical machine.