summaryrefslogtreecommitdiffstats
path: root/reserve.txt
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2009-02-03 00:38:41 +0100
committerLennart Poettering <lennart@poettering.net>2009-02-03 00:38:41 +0100
commit772778faa83569fbfad7dccb008ef220f2e87bf4 (patch)
tree94351be9ba8b8a27403b64e90d265be2f069addb /reserve.txt
parent28bc5df410419a42344bfc30611ae9fd67e7288a (diff)
get rid of show_ui to make things simpler
Diffstat (limited to 'reserve.txt')
-rw-r--r--reserve.txt17
1 files changed, 6 insertions, 11 deletions
diff --git a/reserve.txt b/reserve.txt
index d25989c..0006a6a 100644
--- a/reserve.txt
+++ b/reserve.txt
@@ -37,7 +37,7 @@ INTERFACE DEFINITION
org.freedesktop.ReserviceDevice1
Methods:
- BOOL RequestRelease(INT32 priority, BOOL show_ui) (mandatory)
+ BOOL RequestRelease(INT32 priority) (mandatory)
Ask the current owner of the device to release
the device for take-over. The application
@@ -51,16 +51,12 @@ INTERFACE DEFINITION
the service should return FALSE and do nothing
further.
- If show_ui is TRUE the current owner may
- release the device after some form of user
- interaction. If show_ui is FALSE the current
- owner must reply quickly and without user
- interaction.
-
The current owner doesn't need to base its
decision whether to return TRUE or FALSE
solely on the value of priority. It may take
- other facts into consideration.
+ other facts into consideration. However this
+ function is supposed to return quickly,
+ i.e. no user interaction shall be involved.
Properties:
INT32 Priority (optional)
@@ -130,10 +126,9 @@ LOGIC
further access to the device.
An application shall watch for
- org.freedesktop.DBus.NameOwnerChanged signals and give up
+ org.freedesktop.DBus.LostName signals and give up
device access in case its service name is forcibly taken
- away. This signal may also be used to monitor which
- application currently owns the audio device.
+ away.
While an application holds the service name it may exclusively
access the device. It doesn't need to always keep it open