sd_bus_get_name_creds
systemd
sd_bus_get_name_creds
3
sd_bus_get_name_creds
sd_bus_get_owner_creds
Query bus client credentials
#include <systemd/sd-bus.h>
int sd_bus_get_name_creds
sd_bus *bus
const char *name
uint64_t mask
sd_bus_creds **creds
int sd_bus_get_owner_creds
sd_bus *bus
uint64_t mask
sd_bus_creds **creds
Description
sd_bus_get_name_creds() queries the credentials of the bus client
identified by name. The mask parameter is a combo of
SD_BUS_CREDS_* flags that indicate which credential info the caller is
interested in. See
sd_bus_creds_new_from_pid3
for a list of possible flags. On success, creds contains a new
sd_bus_creds instance with the requested information. Ownership of this instance
belongs to the caller and it should be freed once no longer needed by calling
sd_bus_creds_unref3.
sd_bus_get_owner_creds() queries the credentials of the creator of the given
bus. The mask and creds parameters behave the same as in
sd_bus_get_name_creds().
Return Value
On success, these functions return a non-negative integer. On failure, they return 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.
-EPERM
The bus has already been started.
-ECHILD
The bus was created in a different process, library or module instance.
-ENOMEM
Memory allocation failed.
History
sd_bus_get_name_creds() and
sd_bus_get_owner_creds() were added in version 246.
See Also
systemd1,
sd-bus3,
sd_bus_creds_unref3