1SD_BUS_GET_NAME_MACHINE_ID(s3d)_bus_get_name_machine_SiDd_BUS_GET_NAME_MACHINE_ID(3)
2
3
4

NAME

6       sd_bus_get_name_machine_id - Retrieve a bus client's machine identity
7

SYNOPSIS

9       #include <systemd/sd-bus.h>
10
11       int sd_bus_get_name_machine_id(sd_bus *bus, const char *name,
12                                      sd_id128_t *machine);
13

DESCRIPTION

15       sd_bus_get_name_machine_id() retrieves the D-Bus machine identity of
16       the machine that the bus client identified by name is running on.
17       Internally, it calls the GetMachineId method of the
18       org.freedesktop.DBus.Peer interface. The D-Bus machine identity is a
19       128-bit UUID. On Linux systems running systemd, this corresponds to the
20       contents of /etc/machine-id. On success, the machine identity is stored
21       in machine.
22

RETURN VALUE

24       On success, this function returns a non-negative integer. On failure,
25       it returns a negative errno-style error code.
26
27   Errors
28       Returned errors may indicate the following problems:
29
30       -EINVAL
31           An argument is invalid.
32
33       -ENOPKG
34           The bus cannot be resolved.
35
36       -ECHILD
37           The bus was created in a different process.
38
39       -ENOMEM
40           Memory allocation failed.
41

NOTES

43       These APIs are implemented as a shared library, which can be compiled
44       and linked to with the libsystemd pkg-config(1) file.
45

SEE ALSO

47       systemd(1), sd-bus(3)
48
49
50
51systemd 248                                      SD_BUS_GET_NAME_MACHINE_ID(3)
Impressum