picnoir/Systemd
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

man: explain that the timestamps on incoming kdbus messages are not necessarily monotonically increasing

Browse source
This commit is contained in:
Lennart Poettering 2014-04-13 17:42:11 -07:00
parent 11fb37f16e
commit 6e0369b0ff
1 changed files with 10 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

13
man/sd_bus_message_get_monotonic_usec.xml
View file

@ -92,9 +92,10 @@
<para><function>sd_bus_message_get_seqnum()</function> <para><function>sd_bus_message_get_seqnum()</function>
returns the kernel-assigned sequence number of the returns the kernel-assigned sequence number of the
message. The kernel assigns a global monotonically increasing message. The kernel assigns a global, monotonically
sequence number to all messages sent on the local increasing sequence number to all messages transmitted
system. This sequence number is useful for determining on the local system, at the time the message was
sent. This sequence number is useful for determining
message send order, even across different busses of message send order, even across different busses of
the local system. The sequence number combined with the local system. The sequence number combined with
the boot ID of the system (as returned by the boot ID of the system (as returned by
@ -102,6 +103,12 @@
is a suitable globally unique identifier for bus is a suitable globally unique identifier for bus
messages.</para> messages.</para>
<para>Note that the sending order and receiving order
of messages might differ, in particular for broadcast
messages. This means that the sequence number and the
timestamps of messages a client reads are not
necessarily monotonically increasing.</para>
<para>These timestamps and the sequence number are <para>These timestamps and the sequence number are
attached to each message by the kernel and cannot be attached to each message by the kernel and cannot be
manipulated by the sender.</para> manipulated by the sender.</para>