sd_event_set

Name

sd_event_set_name, sd_event_get_name — Set human-readable names for event sources

Synopsis

#include <systemd/sd-bus.h>

`int sd_event_set_name(`	sd_event_source *`source`,
	const char *`name)`;

`int sd_event_get_name(`	sd_event_source *`source`,
	const char **`name)`;

Description¶

sd_event_set_name() can be used to set an arbitrary name for the event source source. This name will be used in error messages generated by sd-event(3) for this source. Specified name must point to a NUL-terminated string or be NULL. In the latter case, the name will be unset. The string is copied internally, so the name argument is not referenced after the function returns.

sd_event_set_name() can be used to query the current name assigned to source source. It returns a pointer to the current name (possibly NULL) in name.

Return Value¶

On success, sd_event_set_name() and sd_event_get_name() return a non-negative integer. On failure, they return a negative errno-style error code.

Errors¶

Returned errors may indicate the following problems:

-EINVAL¶: source is not a valid pointer to an sd_event_source structure or the name argument for sd_event_get_name() is NULL.
-ENOMEM¶: Not enough memory to copy the name.

Notes¶

Functions described here are available as a shared library, which can be compiled and linked to with the libsystemd pkg-config(1) file.