diff --git a/man/rules/meson.build b/man/rules/meson.build index 548499d749..99915c5e9f 100644 --- a/man/rules/meson.build +++ b/man/rules/meson.build @@ -213,6 +213,10 @@ manpages = [ '3', ['sd_bus_message_get_realtime_usec', 'sd_bus_message_get_seqnum'], ''], + ['sd_bus_message_get_signature', + '3', + ['sd_bus_message_has_signature', 'sd_bus_message_is_empty'], + ''], ['sd_bus_message_get_type', '3', ['sd_bus_message_is_method_call', diff --git a/man/sd-bus.xml b/man/sd-bus.xml index fbbd491ccb..bf2f37a86d 100644 --- a/man/sd-bus.xml +++ b/man/sd-bus.xml @@ -60,6 +60,7 @@ sd_bus_message_copy3, sd_bus_message_get_cookie3, sd_bus_message_get_monotonic_usec3, +sd_bus_message_get_signature3, sd_bus_message_get_type3, sd_bus_message_new3, sd_bus_message_new_method_call3, diff --git a/man/sd_bus_message_get_signature.xml b/man/sd_bus_message_get_signature.xml new file mode 100644 index 0000000000..bee6778190 --- /dev/null +++ b/man/sd_bus_message_get_signature.xml @@ -0,0 +1,111 @@ + + + + + + + sd_bus_message_get_signature + systemd + + + + sd_bus_message_get_signature + 3 + + + + sd_bus_message_get_signature + sd_bus_message_is_empty + sd_bus_message_has_signature + + Query bus message signature + + + + + #include <systemd/sd-bus.h> + + + const char* sd_bus_message_get_signature + sd_bus_message *message + int complete + + + + int sd_bus_message_is_empty + sd_bus_message *message + + + + int sd_bus_message_has_signature + sd_bus_message *message + const char *signature + + + + + + + Description + + sd_bus_message_get_signature() returns the signature of message + message. If complete is true, the signature of the + whole message is returned, and just the signature of the currently open container otherwise. + + + sd_bus_message_is_empty() returns true if the message is empty, + i.e. when its signature is empty. + + sd_bus_message_has_signature() returns true if the signature of the + message message matches given signature. Parameter + signature may be NULL, this is treated the same as + an empty string, which is equivalent to calling sd_bus_message_is_empty(). + + + + + Return Value + + On success, sd_bus_message_get_signature() returns + the signature, and NULL on error. + + The other functions return 0 or a positive integer on success. On failure, they return a + negative errno-style error code. + + + + Errors + + Returned errors may indicate the following problems: + + + + -EINVAL + + The message parameter is NULL. + + + + + NULL + + The message parameter is NULL. + + + + + + + + + See Also + + + systemd1, + sd-bus3, + sd_bus_message_new3 + + + +