1SD_BUS_MESSAGE_SEAL(3)        sd_bus_message_seal       SD_BUS_MESSAGE_SEAL(3)
2
3
4

NAME

6       sd_bus_message_seal - Prepare a D-Bus message for transmission
7

SYNOPSIS

9       #include <systemd/sd-bus.h>
10
11       int sd_bus_message_seal(sd_bus_message *m, uint64_t cookie,
12                               uint64_t timeout_usec);
13

DESCRIPTION

15       sd_bus_message_seal() finishes the message m and prepares it for
16       transmission using sd_bus_send(3).  cookie specifies the identifier
17       used to match the message reply to its corresponding request.
18       timeout_usec specifies the maximum time in microseconds to wait for a
19       reply to arrive.
20
21       Note that in most scenarios, it's not necessary to call this function
22       directly.  sd_bus_call(3), sd_bus_call_async(3) and sd_bus_send(3) will
23       seal any given messages if they have not been sealed yet.
24

RETURN VALUE

26       On success, this function returns a non-negative integer. On failure,
27       it returns a negative errno-style error code.
28
29   Errors
30       Returned errors may indicate the following problems:
31
32       -EINVAL
33           The m parameter is NULL.
34
35       -EBADMSG
36           The D-Bus message m has open containers.
37
38       -ENOMSG
39           The D-Bus message m is a reply but its type signature does not
40           match the return type signature of its corresponding member in the
41           object vtable.
42

NOTES

44       These APIs are implemented as a shared library, which can be compiled
45       and linked to with the libsystemd pkg-config(1) file.
46

SEE ALSO

48       systemd(1), sd-bus(3), sd_bus_call(3), sd_bus_call_async(3),
49       sd_bus_send(3)
50
51
52
53systemd 248                                             SD_BUS_MESSAGE_SEAL(3)
Impressum