fdo-mirrors/dbus
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/dbus/dbus.git synced 2026-05-01 04:28:01 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

spec: Clarify that Variant's value needs padding

Browse source
This commit is contained in:
Zeeshan Ali 2021-02-24 12:16:08 +01:00
parent efe805c849
commit fcc3455b89
1 changed files with 18 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

18
doc/dbus-specification.xml
View file

@ -1245,6 +1245,24 @@
(See <link linkend="message-protocol-marshaling-signature">Valid
Signatures</link>.)
</para>
<para>
It should be noted that while a variant itself does not require any
alignment padding, the contained value does need to be padded
according to the alignment rules of its type.
</para>
<para>
For instance, if the current position in the message is at a multiple of
8 bytes and the byte-order is big-endian, a variant containing a 64-bit
integer 5 would be marshalled as:
<screen>
0x01 0x74 0x00 <lineannotation>signature bytes (length = 1, signature = 't' and trailing nul)</lineannotation>
0x00 0x00 0x00 0x00 0x00 <lineannotation>padding to 8-byte boundary</lineannotation>
0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x05 <lineannotation>8 bytes of contained value</lineannotation>
</screen>
</para>
</sect2>
<sect2>