mirror of
https://gitlab.freedesktop.org/wayland/wayland.git
synced 2025-11-20 06:59:44 -05:00
doc: Improve Wire Format section
Fixed the wayland socket name and added documentation for fixed format. Signed-off-by: Tiago Vignatti <tiago.vignatti@intel.com>
This commit is contained in:
parent
5495bcd15a
commit
d3fe28384c
1 changed files with 17 additions and 5 deletions
|
|
@ -59,9 +59,10 @@
|
||||||
<section id="sect-Protocol-Wire-Format">
|
<section id="sect-Protocol-Wire-Format">
|
||||||
<title>Wire Format</title>
|
<title>Wire Format</title>
|
||||||
<para>
|
<para>
|
||||||
The protocol is sent over a UNIX domain stream socket. Currently, the
|
The protocol is sent over a UNIX domain stream socket, where the endpoint
|
||||||
endpoint is named <systemitem class="service">\wayland</systemitem>,
|
usually is named <systemitem class="service">wayland-0</systemitem>
|
||||||
but it is subject to change. The protocol is message-based. A
|
(although it can be changed via <emphasis>WAYLAND_DISPLAY</emphasis>
|
||||||
|
in the environment). The protocol is message-based. A
|
||||||
message sent by a client to the server is called request. A message
|
message sent by a client to the server is called request. A message
|
||||||
from the server to a client is called event. Every message is
|
from the server to a client is called event. Every message is
|
||||||
structured as 32-bit words, values are represented in the host's
|
structured as 32-bit words, values are represented in the host's
|
||||||
|
|
@ -101,13 +102,24 @@
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
<varlistentry>
|
||||||
|
<term>fixed</term>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
Signed 24.8 decimal numbers. It is a signed decimal type which
|
||||||
|
offers a sign bit, 23 bits of integer precision and 8 bits of
|
||||||
|
decimal precision. This is exposed as an opaque struct with
|
||||||
|
conversion helpers to and from double and int on the C API side.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</varlistentry>
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term>string</term>
|
<term>string</term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Starts with an unsigned 32-bit length, followed by the
|
Starts with an unsigned 32-bit length, followed by the
|
||||||
string contents, including terminating NUL byte, then padding to a
|
string contents, including terminating null byte, then padding
|
||||||
32-bit boundary.
|
to a 32-bit boundary.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue