1SD_BUS_MESSAGE_SEAL(3) sd_bus_message_seal SD_BUS_MESSAGE_SEAL(3)
2
3
4
6 sd_bus_message_seal - Prepare a D-Bus message for transmission
7
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
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
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
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
48 systemd(1), sd-bus(3), sd_bus_call(3), sd_bus_call_async(3),
49 sd_bus_send(3)
50
51
52
53systemd 251 SD_BUS_MESSAGE_SEAL(3)