Attachment 49391 Details for Bug 39450 – [PATCH 1/5] spec: make the Match Rules section true again

[patch] [PATCH 1/5] spec: make the Match Rules section true again

0001-spec-make-the-Match-Rules-section-true-again.patch (text/plain), 2.25 KB, created by Simon McVittie on 2011-07-21 09:07:13 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Simon McVittie

Created: 2011-07-21 09:07:13 UTC

Size: 2.25 KB

patch

obsolete

>From ec5a4f3c6e5df73610c96c1d192b8cbf8328a896 Mon Sep 17 00:00:00 2001
>From: Simon McVittie <simon.mcvittie@collabora.co.uk>
>Date: Thu, 21 Jul 2011 16:14:02 +0100
>Subject: [PATCH 1/5] spec: make the Match Rules section true again
>
>The spec previously claimed that only messages matching the client's
>match rules would be received. This is not actually true: messages
>listing a client as their DESTINATION are always delivered (security
>policy permitting).
>---
> doc/dbus-specification.xml |   21 +++++++++++++--------
> 1 files changed, 13 insertions(+), 8 deletions(-)
>
>diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
>index 4bd0cb3..459f46a 100644
>--- a/doc/dbus-specification.xml
>+++ b/doc/dbus-specification.xml
>@@ -3846,14 +3846,19 @@
>       <sect3 id="message-bus-routing-match-rules">
>         <title>Match Rules</title>
>         <para>
>-	  An important part of the message bus routing protocol is match  
>-	  rules. Match rules describe what messages can be sent to a client
>-          based on the contents of the message.  When a message is routed
>-          through the bus it is compared to clients' match rules.  If any
>-          of the rules match, the message is dispatched to the client.
>-          If none of the rules match the message never leaves the bus.  This
>-          is an effective way to control traffic over the bus and to make sure
>-          only relevant message need to be processed by the client.
>+	  An important part of the message bus routing protocol is match
>+          rules. Match rules describe the messages that should be sent to a
>+          client, based on the contents of the message.  Broadcast signals
>+          are only sent to clients which have a suitable match rule: this
>+          avoids waking up client processes to deal with signals that are
>+          not relevant to that client.
>+        </para>
>+        <para>
>+          Messages that list a client as their <literal>DESTINATION</literal>
>+          do not need to match the client's match rules, and are sent to that
>+          client regardless. As a result, match rules are mainly used to
>+          receive a subset of broadcast signals.
>+        </para>
>         </para>
>         <para>
>           Match rules are added using the AddMatch bus method 
>-- 
>1.7.5.4
>

Actions: View | Splinter Review

Attachments on bug 39450: 49391 | 49392 | 49393 | 49394 | 49395

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.