Commit 61e269e3 authored by Simon McVittie's avatar Simon McVittie

spec: Document the design principle that new headers must be asked for

Bug: https://bugs.freedesktop.org/show_bug.cgi?id=100317Reviewed-by: Philip Withnall's avatarPhilip Withnall <withnall@endlessm.com>
Signed-off-by: Simon McVittie's avatarSimon McVittie <smcv@collabora.com>
parent 0fb9eaa3
......@@ -1624,6 +1624,25 @@
feature</link>.
</para>
<para>
New header fields controlled by the message bus
(similar to <literal>SENDER</literal>) might be added to this
specification in future. Such message fields should normally
only be added to messages that are going to be delivered to a
client that specifically requested them (for example by calling
some method), and the message bus should remove those header
fields from all other messages that it relays. This design
principle serves two main purposes. One is to avoid unnecessary
memory and throughput overhead when delivering messages to
clients that are not interested in the new header fields.
The other is to give clients a reason to call the method that
requests those messages (otherwise, the clients would not work).
This is desirable because looking at the reply to that method
call is a natural way to check that the message bus guarantees
to filter out faked header fields that might have been sent by
malicious peers.
</para>
<para>
Here are the currently-defined header fields:
<informaltable>
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment