sd_bus_get_name_machine_id

systemd
sd_bus_get_name_machine_id 3
sd_bus_get_name_machine_id Retrieve a bus client's machine identity

    #include <systemd/sd-bus.h>

int `sd_bus_get_name_machine_id` sd_bus *bus const char *name sd_id128_t *machine

## Description

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

## Return Value

On success, this function returns a non-negative integer. On failure, it returns a negative errno-style error code.

### Errors

Returned errors may indicate the following problems:

`-EINVAL`

  An argument is invalid.

`-ENOPKG`

  The bus cannot be resolved.

`-ECHILD`

  The bus was created in a different process.

`-ENOMEM`

  Memory allocation failed.

## See Also

systemd 1, sd-bus 3