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 Functions described here are available as a shared library, which can
45 be compiled against and linked to with the libsystemd pkg-config(1)
46 file.
47
48 The code described here uses getenv(3), which is declared to be not
49 multi-thread-safe. This means that the code calling the functions
50 described here must not call setenv(3) from a parallel thread. It is
51 recommended to only do calls to setenv() from an early phase of the
52 program when no other threads have been started.
53
55 systemd(1), sd-bus(3), sd_bus_call(3), sd_bus_call_async(3),
56 sd_bus_send(3)
57
58
59
60systemd 254 SD_BUS_MESSAGE_SEAL(3)