fdo-mirrors/dbus
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/dbus/dbus.git synced 2026-03-12 18:10:37 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

Merge branch 'get-machine-id' into 'master'

Browse source 
Specify what ID GetMachineId actually returns

See merge request dbus/dbus!198
This commit is contained in:
Simon McVittie 2021-10-29 18:24:11 +00:00
commit 9b019a4e83
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.