1SD_BUS_MESSAGE_AT_END(3) sd_bus_message_at_end SD_BUS_MESSAGE_AT_END(3)
2
3
4
6 sd_bus_message_at_end - Check if a message has been fully read
7
9 #include <systemd/sd-bus.h>
10
11 int sd_bus_message_at_end(sd_bus_message *m, int complete);
12
14 sd_bus_message_at_end() returns whether all data from the currently
15 opened container in m or all data from all containers in m has been
16 read. If complete is zero, this function returns whether all data from
17 the currently opened container has been read. If complete is non-zero,
18 this function returns whether all data from all containers in m has
19 been read.
20
22 If all data from all containers or the current container (depending on
23 the value of complete) has been read, sd_bus_message_at_end() returns a
24 positive integer. If there is still data left to be read, it returns
25 zero. On failure, it returns a negative errno-style error code.
26
27 Errors
28 Returned errors may indicate the following problems:
29
30 -EINVAL
31 The m parameter is NULL.
32
33 -EPERM
34 The message is not sealed.
35
37 Functions described here are available as a shared library, which can
38 be compiled against and linked to with the libsystemd pkg-config(1)
39 file.
40
41 The code described here uses getenv(3), which is declared to be not
42 multi-thread-safe. This means that the code calling the functions
43 described here must not call setenv(3) from a parallel thread. It is
44 recommended to only do calls to setenv() from an early phase of the
45 program when no other threads have been started.
46
48 systemd(1), sd-bus(3), sd_bus_message_read(3)
49
50
51
52systemd 254 SD_BUS_MESSAGE_AT_END(3)