sd_bus_message_new_signal systemd sd_bus_message_new_signal 3 sd_bus_message_new_signal sd_bus_message_new_signal_to Create a signal message #include <systemd/sd-bus.h> int sd_bus_message_new_signal sd_bus *bus sd_bus_message **m const char *path const char *interface const char *member int sd_bus_message_new_signal_to sd_bus *bus sd_bus_message **m const char *destination const char *path const char *interface const char *member Description The sd_bus_message_new_signal() function creates a new bus message object that encapsulates a D-Bus signal, and returns it in the m output parameter. The signal will be sent to path path, on the interface interface, member member. When this message is sent, no reply is expected. See sd_bus_message_new_method_call3 for a short description of the meaning of the path, interface, and member parameters. sd_bus_message_new_signal_to() is a shorthand for creating a new bus message to a specific destination. It's behavior is similar to calling sd_bus_message_new_signal() followed by calling sd_bus_message_set_destination3. Return Value This function returns 0 if the message object was successfully created, and a negative errno-style error code otherwise. Errors Returned errors may indicate the following problems: -EINVAL The output parameter m is NULL. The path parameter is not a valid D-Bus path (/an/object/path), the interface parameter is not a valid D-Bus interface name (an.interface.name), or the member parameter is not a valid D-Bus member (Name). -ENOTCONN The bus parameter bus is NULL or the bus is not connected. -ENOMEM Memory allocation failed. Examples Send a simple signal This function in systemd sources is used to emit the UnitFilesChanged signal when the unit files have been changed. See Also systemd1 sd-bus3 sd_bus_emit_signal3 sd_bus_message_set_destination3