1SD_BUS_MESSAGE_GET_SIGNATUsRdE_(b3u)s_message_get_signSaDt_uBrUeS_MESSAGE_GET_SIGNATURE(3)
2
3
4
6 sd_bus_message_get_signature, sd_bus_message_is_empty,
7 sd_bus_message_has_signature - Query bus message signature
8
10 #include <systemd/sd-bus.h>
11
12 const char* sd_bus_message_get_signature(sd_bus_message *message,
13 int complete);
14
15 int sd_bus_message_is_empty(sd_bus_message *message);
16
17 int sd_bus_message_has_signature(sd_bus_message *message,
18 const char *signature);
19
21 sd_bus_message_get_signature() returns the signature of message
22 message. If complete is true, the signature of the whole message is
23 returned, and just the signature of the currently open container
24 otherwise.
25
26 sd_bus_message_is_empty() returns true if the message is empty, i.e.
27 when its signature is empty.
28
29 sd_bus_message_has_signature() returns true if the signature of the
30 message message matches given signature. Parameter signature may be
31 NULL, this is treated the same as an empty string, which is equivalent
32 to calling sd_bus_message_is_empty().
33
35 On success, sd_bus_message_get_signature() returns the signature, and
36 NULL on error.
37
38 The other functions return 0 or a positive integer on success. On
39 failure, they return a negative errno-style error code.
40
41 Errors
42 Returned errors may indicate the following problems:
43
44 -EINVAL
45 The message parameter is NULL.
46
47 NULL
48 The message parameter is NULL.
49
51 These APIs are implemented as a shared library, which can be compiled
52 and linked to with the libsystemd pkg-config(1) file.
53
55 systemd(1), sd-bus(3), sd_bus_message_new(3)
56
57
58
59systemd 243 SD_BUS_MESSAGE_GET_SIGNATURE(3)