Mercurial > emacs
changeset 104590:8e031ee168ec
* dbus.texi (Bus names): Add optional parameter TIMEOUT to dbus-ping.
Describe autostart behaviour of dbus-ping.
(Synchronous Methods, Asynchronous Methods): Use English numeric format
for timeout values.
| author | Michael Albinus <michael.albinus@gmx.de> |
|---|---|
| date | Tue, 25 Aug 2009 08:42:13 +0000 |
| parents | 365612beef73 |
| children | ccbbe2522df6 |
| files | doc/misc/dbus.texi |
| diffstat | 1 files changed, 17 insertions(+), 8 deletions(-) [+] |
line wrap: on
line diff
--- a/doc/misc/dbus.texi Tue Aug 25 08:31:42 2009 +0000 +++ b/doc/misc/dbus.texi Tue Aug 25 08:42:13 2009 +0000 @@ -180,22 +180,31 @@ string. @end defun -@defun dbus-ping bus service +@defun dbus-ping bus service &optional timeout Check whether the service name @var{service} is registered at D-Bus -@var{bus}. @var{service} might not have been started yet. The result -is either @code{t} or @code{nil}. +@var{bus}. @var{service} might not have been started yet, it is +autostarted if possible. The result is either @code{t} or @code{nil}. @var{bus} must be either the symbol @code{:system} or the symbol -@code{:session}. @var{service} must be a string. Example: +@code{:session}. @var{service} must be a string. @var{timeout}, a +nonnegative integer, specifies the maximum number of milliseconds +@code{dbus-ping} must return. The default value is 25,000. Example: @lisp (message "%s screensaver on board." (cond - ((dbus-ping :session "org.gnome.ScreenSaver") "Gnome") - ((dbus-ping :session "org.freedesktop.ScreenSaver") "KDE") + ((dbus-ping :session "org.gnome.ScreenSaver" 100) "Gnome") + ((dbus-ping :session "org.freedesktop.ScreenSaver" 100) "KDE") (t "No"))) @end lisp + +If it shall be checked whether @var{service} is already running +without autostarting it, one shall apply + +@lisp +(member service (dbus-list-known-names bus)) +@end lisp @end defun @defun dbus-get-unique-name bus @@ -1078,7 +1087,7 @@ If the parameter @code{:timeout} is given, the following integer @var{timeout} specifies the maximum number of milliseconds the method -call must return. The default value is 25.000. If the method call +call must return. The default value is 25,000. If the method call doesn't return in time, a D-Bus error is raised (@pxref{Errors and Events}). @@ -1194,7 +1203,7 @@ If the parameter @code{:timeout} is given, the following integer @var{timeout} specifies the maximum number of milliseconds a reply -message must arrive. The default value is 25.000. If there is no +message must arrive. The default value is 25,000. If there is no reply message in time, a D-Bus error is raised (@pxref{Errors and Events}).