Attachment 87276 Details for Bug 66608 – [PATCH v2] Spec: document multiple .service files own the same well known name

[patch] [PATCH v2] Spec: document multiple .service files own the same well known name

0001-Spec-document-multiple-.service-files-own-the-same-w.patch (text/plain), 2.24 KB, created by Chengwei Yang on 2013-10-08 13:03:19 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Chengwei Yang

Created: 2013-10-08 13:03:19 UTC

Size: 2.24 KB

patch

obsolete

>From 70505fdb06adf7dd7702223e44a31b48840b8d83 Mon Sep 17 00:00:00 2001
>From: Chengwei Yang <chengwei.yang@intel.com>
>Date: Tue, 8 Oct 2013 20:55:03 +0800
>Subject: [PATCH v2] Spec: document multiple .service files own the same well
> known name
>
>In current dbus-daemon(1) implement, system .serivce must named after
>its owned name, but this is not the case for session .service.
>
>For session service, the result of multiple .service files own the
>same well known name is undefined since readdir(3) doesn't return
>dirent in a defined sequence.
>
>Bug: https://bugs.freedesktop.org/show_bug.cgi?id=66608
>---
> doc/dbus-specification.xml |   20 +++++++++++++++++---
> 1 file changed, 17 insertions(+), 3 deletions(-)
>
>diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
>index 51d6cb6..e014ca7 100644
>--- a/doc/dbus-specification.xml
>+++ b/doc/dbus-specification.xml
>@@ -4689,9 +4689,23 @@
>         When an application asks to start a service by name, the bus daemon tries to
>         find a service that will own that name. It then tries to spawn the
>         executable associated with it. If this fails, it will report an
>-        error. [FIXME what happens if two .service files offer the same service;
>-        what kind of error is reported, should we have a way for the client to
>-        choose one?]
>+        error.
>+
>+        On the well-known system bus, it is not possible for two .service files
>+        in the same directory to offer the same service, because they are
>+        constrained to have names that match the service name.
>+
>+        On the well-known session bus, if two .service files in the same
>+        directory offer the same service name, the result is undefined.
>+        Distributors should avoid this situation, for instance by naming
>+        session services' .service files according to their service name.
>+
>+        If two .service files in different directories offer the same
>+        service name, the one in the higher-priority directory is used:
>+        for instance, on the system bus, .service files in
>+        /usr/local/share/dbus-1/system-services take precedence over those
>+        in /usr/share/dbus-1/system-services.
>+
>       </para>
>       <para>
>         The executable launched will have the environment variable
>-- 
>1.7.9.5
>

Actions: View | Splinter Review

Attachments on bug 66608: 82205 | 82206 | 82314 | 82315 | 85914 | 85915 | 85957 | 87276

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.