1 /* Elisp bindings for D-Bus.
2 Copyright (C) 2007, 2008, 2009 Free Software Foundation, Inc.
4 This file is part of GNU Emacs.
6 GNU Emacs is free software: you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation, either version 3 of the License, or
9 (at your option) any later version.
11 GNU Emacs is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
24 #include <dbus/dbus.h>
27 #include "termhooks.h"
32 Lisp_Object Qdbus_init_bus
;
33 Lisp_Object Qdbus_get_unique_name
;
34 Lisp_Object Qdbus_call_method
;
35 Lisp_Object Qdbus_call_method_asynchronously
;
36 Lisp_Object Qdbus_method_return_internal
;
37 Lisp_Object Qdbus_method_error_internal
;
38 Lisp_Object Qdbus_send_signal
;
39 Lisp_Object Qdbus_register_signal
;
40 Lisp_Object Qdbus_register_method
;
42 /* D-Bus error symbol. */
43 Lisp_Object Qdbus_error
;
45 /* Lisp symbols of the system and session buses. */
46 Lisp_Object QCdbus_system_bus
, QCdbus_session_bus
;
48 /* Lisp symbol for method call timeout. */
49 Lisp_Object QCdbus_timeout
;
51 /* Lisp symbols of D-Bus types. */
52 Lisp_Object QCdbus_type_byte
, QCdbus_type_boolean
;
53 Lisp_Object QCdbus_type_int16
, QCdbus_type_uint16
;
54 Lisp_Object QCdbus_type_int32
, QCdbus_type_uint32
;
55 Lisp_Object QCdbus_type_int64
, QCdbus_type_uint64
;
56 Lisp_Object QCdbus_type_double
, QCdbus_type_string
;
57 Lisp_Object QCdbus_type_object_path
, QCdbus_type_signature
;
58 Lisp_Object QCdbus_type_array
, QCdbus_type_variant
;
59 Lisp_Object QCdbus_type_struct
, QCdbus_type_dict_entry
;
61 /* Hash table which keeps function definitions. */
62 Lisp_Object Vdbus_registered_functions_table
;
64 /* Whether to debug D-Bus. */
65 Lisp_Object Vdbus_debug
;
67 /* Whether we are reading a D-Bus event. */
68 int xd_in_read_queued_messages
= 0;
71 /* We use "xd_" and "XD_" as prefix for all internal symbols, because
72 we don't want to poison other namespaces with "dbus_". */
74 /* Raise a signal. If we are reading events, we cannot signal; we
75 throw to xd_read_queued_messages then. */
76 #define XD_SIGNAL1(arg) \
78 if (xd_in_read_queued_messages) \
79 Fthrow (Qdbus_error, Qnil); \
81 xsignal1 (Qdbus_error, arg); \
84 #define XD_SIGNAL2(arg1, arg2) \
86 if (xd_in_read_queued_messages) \
87 Fthrow (Qdbus_error, Qnil); \
89 xsignal2 (Qdbus_error, arg1, arg2); \
92 #define XD_SIGNAL3(arg1, arg2, arg3) \
94 if (xd_in_read_queued_messages) \
95 Fthrow (Qdbus_error, Qnil); \
97 xsignal3 (Qdbus_error, arg1, arg2, arg3); \
100 /* Raise a Lisp error from a D-Bus ERROR. */
101 #define XD_ERROR(error) \
104 strncpy (s, error.message, 1023); \
105 dbus_error_free (&error); \
106 /* Remove the trailing newline. */ \
107 if (strchr (s, '\n') != NULL) \
108 s[strlen (s) - 1] = '\0'; \
109 XD_SIGNAL1 (build_string (s)); \
112 /* Macros for debugging. In order to enable them, build with
113 "make MYCPPFLAGS='-DDBUS_DEBUG -Wall'". */
115 #define XD_DEBUG_MESSAGE(...) \
118 snprintf (s, 1023, __VA_ARGS__); \
119 printf ("%s: %s\n", __func__, s); \
120 message ("%s: %s", __func__, s); \
122 #define XD_DEBUG_VALID_LISP_OBJECT_P(object) \
124 if (!valid_lisp_object_p (object)) \
126 XD_DEBUG_MESSAGE ("%d Assertion failure", __LINE__); \
127 XD_SIGNAL1 (build_string ("Assertion failure")); \
131 #else /* !DBUS_DEBUG */
132 #define XD_DEBUG_MESSAGE(...) \
134 if (!NILP (Vdbus_debug)) \
137 snprintf (s, 1023, __VA_ARGS__); \
138 message ("%s: %s", __func__, s); \
141 #define XD_DEBUG_VALID_LISP_OBJECT_P(object)
144 /* Check whether TYPE is a basic DBusType. */
145 #define XD_BASIC_DBUS_TYPE(type) \
146 ((type == DBUS_TYPE_BYTE) \
147 || (type == DBUS_TYPE_BOOLEAN) \
148 || (type == DBUS_TYPE_INT16) \
149 || (type == DBUS_TYPE_UINT16) \
150 || (type == DBUS_TYPE_INT32) \
151 || (type == DBUS_TYPE_UINT32) \
152 || (type == DBUS_TYPE_INT64) \
153 || (type == DBUS_TYPE_UINT64) \
154 || (type == DBUS_TYPE_DOUBLE) \
155 || (type == DBUS_TYPE_STRING) \
156 || (type == DBUS_TYPE_OBJECT_PATH) \
157 || (type == DBUS_TYPE_SIGNATURE))
159 /* This was a macro. On Solaris 2.11 it was said to compile for
160 hours, when optimzation is enabled. So we have transferred it into
162 /* Determine the DBusType of a given Lisp symbol. OBJECT must be one
163 of the predefined D-Bus type symbols. */
165 xd_symbol_to_dbus_type (object
)
169 ((EQ (object
, QCdbus_type_byte
)) ? DBUS_TYPE_BYTE
170 : (EQ (object
, QCdbus_type_boolean
)) ? DBUS_TYPE_BOOLEAN
171 : (EQ (object
, QCdbus_type_int16
)) ? DBUS_TYPE_INT16
172 : (EQ (object
, QCdbus_type_uint16
)) ? DBUS_TYPE_UINT16
173 : (EQ (object
, QCdbus_type_int32
)) ? DBUS_TYPE_INT32
174 : (EQ (object
, QCdbus_type_uint32
)) ? DBUS_TYPE_UINT32
175 : (EQ (object
, QCdbus_type_int64
)) ? DBUS_TYPE_INT64
176 : (EQ (object
, QCdbus_type_uint64
)) ? DBUS_TYPE_UINT64
177 : (EQ (object
, QCdbus_type_double
)) ? DBUS_TYPE_DOUBLE
178 : (EQ (object
, QCdbus_type_string
)) ? DBUS_TYPE_STRING
179 : (EQ (object
, QCdbus_type_object_path
)) ? DBUS_TYPE_OBJECT_PATH
180 : (EQ (object
, QCdbus_type_signature
)) ? DBUS_TYPE_SIGNATURE
181 : (EQ (object
, QCdbus_type_array
)) ? DBUS_TYPE_ARRAY
182 : (EQ (object
, QCdbus_type_variant
)) ? DBUS_TYPE_VARIANT
183 : (EQ (object
, QCdbus_type_struct
)) ? DBUS_TYPE_STRUCT
184 : (EQ (object
, QCdbus_type_dict_entry
)) ? DBUS_TYPE_DICT_ENTRY
185 : DBUS_TYPE_INVALID
);
188 /* Check whether a Lisp symbol is a predefined D-Bus type symbol. */
189 #define XD_DBUS_TYPE_P(object) \
190 (SYMBOLP (object) && ((xd_symbol_to_dbus_type (object) != DBUS_TYPE_INVALID)))
192 /* Determine the DBusType of a given Lisp OBJECT. It is used to
193 convert Lisp objects, being arguments of `dbus-call-method' or
194 `dbus-send-signal', into corresponding C values appended as
195 arguments to a D-Bus message. */
196 #define XD_OBJECT_TO_DBUS_TYPE(object) \
197 ((EQ (object, Qt) || EQ (object, Qnil)) ? DBUS_TYPE_BOOLEAN \
198 : (NATNUMP (object)) ? DBUS_TYPE_UINT32 \
199 : (INTEGERP (object)) ? DBUS_TYPE_INT32 \
200 : (FLOATP (object)) ? DBUS_TYPE_DOUBLE \
201 : (STRINGP (object)) ? DBUS_TYPE_STRING \
202 : (XD_DBUS_TYPE_P (object)) ? xd_symbol_to_dbus_type (object) \
204 ? ((XD_DBUS_TYPE_P (CAR_SAFE (object))) \
205 ? ((XD_BASIC_DBUS_TYPE (xd_symbol_to_dbus_type (CAR_SAFE (object)))) \
207 : xd_symbol_to_dbus_type (CAR_SAFE (object))) \
211 /* Return a list pointer which does not have a Lisp symbol as car. */
212 #define XD_NEXT_VALUE(object) \
213 ((XD_DBUS_TYPE_P (CAR_SAFE (object))) ? CDR_SAFE (object) : object)
215 /* Compute SIGNATURE of OBJECT. It must have a form that it can be
216 used in dbus_message_iter_open_container. DTYPE is the DBusType
217 the object is related to. It is passed as argument, because it
218 cannot be detected in basic type objects, when they are preceded by
219 a type symbol. PARENT_TYPE is the DBusType of a container this
220 signature is embedded, or DBUS_TYPE_INVALID. It is needed for the
221 check that DBUS_TYPE_DICT_ENTRY occurs only as array element. */
223 xd_signature (signature
, dtype
, parent_type
, object
)
225 unsigned int dtype
, parent_type
;
228 unsigned int subtype
;
230 char x
[DBUS_MAXIMUM_SIGNATURE_LENGTH
];
237 case DBUS_TYPE_UINT16
:
238 case DBUS_TYPE_UINT32
:
239 case DBUS_TYPE_UINT64
:
240 CHECK_NATNUM (object
);
241 sprintf (signature
, "%c", dtype
);
244 case DBUS_TYPE_BOOLEAN
:
245 if (!EQ (object
, Qt
) && !EQ (object
, Qnil
))
246 wrong_type_argument (intern ("booleanp"), object
);
247 sprintf (signature
, "%c", dtype
);
250 case DBUS_TYPE_INT16
:
251 case DBUS_TYPE_INT32
:
252 case DBUS_TYPE_INT64
:
253 CHECK_NUMBER (object
);
254 sprintf (signature
, "%c", dtype
);
257 case DBUS_TYPE_DOUBLE
:
258 CHECK_FLOAT (object
);
259 sprintf (signature
, "%c", dtype
);
262 case DBUS_TYPE_STRING
:
263 case DBUS_TYPE_OBJECT_PATH
:
264 case DBUS_TYPE_SIGNATURE
:
265 CHECK_STRING (object
);
266 sprintf (signature
, "%c", dtype
);
269 case DBUS_TYPE_ARRAY
:
270 /* Check that all list elements have the same D-Bus type. For
271 complex element types, we just check the container type, not
272 the whole element's signature. */
275 /* Type symbol is optional. */
276 if (EQ (QCdbus_type_array
, CAR_SAFE (elt
)))
277 elt
= XD_NEXT_VALUE (elt
);
279 /* If the array is empty, DBUS_TYPE_STRING is the default
283 subtype
= DBUS_TYPE_STRING
;
284 strcpy (x
, DBUS_TYPE_STRING_AS_STRING
);
288 subtype
= XD_OBJECT_TO_DBUS_TYPE (CAR_SAFE (elt
));
289 xd_signature (x
, subtype
, dtype
, CAR_SAFE (XD_NEXT_VALUE (elt
)));
292 /* If the element type is DBUS_TYPE_SIGNATURE, and this is the
293 only element, the value of this element is used as he array's
294 element signature. */
295 if ((subtype
== DBUS_TYPE_SIGNATURE
)
296 && STRINGP (CAR_SAFE (XD_NEXT_VALUE (elt
)))
297 && NILP (CDR_SAFE (XD_NEXT_VALUE (elt
))))
298 strcpy (x
, SDATA (CAR_SAFE (XD_NEXT_VALUE (elt
))));
302 if (subtype
!= XD_OBJECT_TO_DBUS_TYPE (CAR_SAFE (elt
)))
303 wrong_type_argument (intern ("D-Bus"), CAR_SAFE (elt
));
304 elt
= CDR_SAFE (XD_NEXT_VALUE (elt
));
307 sprintf (signature
, "%c%s", dtype
, x
);
310 case DBUS_TYPE_VARIANT
:
311 /* Check that there is exactly one list element. */
314 elt
= XD_NEXT_VALUE (elt
);
315 subtype
= XD_OBJECT_TO_DBUS_TYPE (CAR_SAFE (elt
));
316 xd_signature (x
, subtype
, dtype
, CAR_SAFE (XD_NEXT_VALUE (elt
)));
318 if (!NILP (CDR_SAFE (XD_NEXT_VALUE (elt
))))
319 wrong_type_argument (intern ("D-Bus"),
320 CAR_SAFE (CDR_SAFE (XD_NEXT_VALUE (elt
))));
322 sprintf (signature
, "%c", dtype
);
325 case DBUS_TYPE_STRUCT
:
326 /* A struct list might contain any number of elements with
327 different types. No further check needed. */
330 elt
= XD_NEXT_VALUE (elt
);
332 /* Compose the signature from the elements. It is enclosed by
334 sprintf (signature
, "%c", DBUS_STRUCT_BEGIN_CHAR
);
337 subtype
= XD_OBJECT_TO_DBUS_TYPE (CAR_SAFE (elt
));
338 xd_signature (x
, subtype
, dtype
, CAR_SAFE (XD_NEXT_VALUE (elt
)));
339 strcat (signature
, x
);
340 elt
= CDR_SAFE (XD_NEXT_VALUE (elt
));
342 strcat (signature
, DBUS_STRUCT_END_CHAR_AS_STRING
);
345 case DBUS_TYPE_DICT_ENTRY
:
346 /* Check that there are exactly two list elements, and the first
347 one is of basic type. The dictionary entry itself must be an
348 element of an array. */
351 /* Check the parent object type. */
352 if (parent_type
!= DBUS_TYPE_ARRAY
)
353 wrong_type_argument (intern ("D-Bus"), object
);
355 /* Compose the signature from the elements. It is enclosed by
357 sprintf (signature
, "%c", DBUS_DICT_ENTRY_BEGIN_CHAR
);
360 elt
= XD_NEXT_VALUE (elt
);
361 subtype
= XD_OBJECT_TO_DBUS_TYPE (CAR_SAFE (elt
));
362 xd_signature (x
, subtype
, dtype
, CAR_SAFE (XD_NEXT_VALUE (elt
)));
363 strcat (signature
, x
);
365 if (!XD_BASIC_DBUS_TYPE (subtype
))
366 wrong_type_argument (intern ("D-Bus"), CAR_SAFE (XD_NEXT_VALUE (elt
)));
368 /* Second element. */
369 elt
= CDR_SAFE (XD_NEXT_VALUE (elt
));
370 subtype
= XD_OBJECT_TO_DBUS_TYPE (CAR_SAFE (elt
));
371 xd_signature (x
, subtype
, dtype
, CAR_SAFE (XD_NEXT_VALUE (elt
)));
372 strcat (signature
, x
);
374 if (!NILP (CDR_SAFE (XD_NEXT_VALUE (elt
))))
375 wrong_type_argument (intern ("D-Bus"),
376 CAR_SAFE (CDR_SAFE (XD_NEXT_VALUE (elt
))));
378 /* Closing signature. */
379 strcat (signature
, DBUS_DICT_ENTRY_END_CHAR_AS_STRING
);
383 wrong_type_argument (intern ("D-Bus"), object
);
386 XD_DEBUG_MESSAGE ("%s", signature
);
389 /* Append C value, extracted from Lisp OBJECT, to iteration ITER.
390 DTYPE must be a valid DBusType. It is used to convert Lisp
391 objects, being arguments of `dbus-call-method' or
392 `dbus-send-signal', into corresponding C values appended as
393 arguments to a D-Bus message. */
395 xd_append_arg (dtype
, object
, iter
)
398 DBusMessageIter
*iter
;
400 char signature
[DBUS_MAXIMUM_SIGNATURE_LENGTH
];
401 DBusMessageIter subiter
;
403 if (XD_BASIC_DBUS_TYPE (dtype
))
408 unsigned char val
= XUINT (object
) & 0xFF;
409 XD_DEBUG_MESSAGE ("%c %d", dtype
, val
);
410 if (!dbus_message_iter_append_basic (iter
, dtype
, &val
))
411 XD_SIGNAL2 (build_string ("Unable to append argument"), object
);
415 case DBUS_TYPE_BOOLEAN
:
417 dbus_bool_t val
= (NILP (object
)) ? FALSE
: TRUE
;
418 XD_DEBUG_MESSAGE ("%c %s", dtype
, (val
== FALSE
) ? "false" : "true");
419 if (!dbus_message_iter_append_basic (iter
, dtype
, &val
))
420 XD_SIGNAL2 (build_string ("Unable to append argument"), object
);
424 case DBUS_TYPE_INT16
:
426 dbus_int16_t val
= XINT (object
);
427 XD_DEBUG_MESSAGE ("%c %d", dtype
, (int) val
);
428 if (!dbus_message_iter_append_basic (iter
, dtype
, &val
))
429 XD_SIGNAL2 (build_string ("Unable to append argument"), object
);
433 case DBUS_TYPE_UINT16
:
435 dbus_uint16_t val
= XUINT (object
);
436 XD_DEBUG_MESSAGE ("%c %u", dtype
, (unsigned int) val
);
437 if (!dbus_message_iter_append_basic (iter
, dtype
, &val
))
438 XD_SIGNAL2 (build_string ("Unable to append argument"), object
);
442 case DBUS_TYPE_INT32
:
444 dbus_int32_t val
= XINT (object
);
445 XD_DEBUG_MESSAGE ("%c %d", dtype
, val
);
446 if (!dbus_message_iter_append_basic (iter
, dtype
, &val
))
447 XD_SIGNAL2 (build_string ("Unable to append argument"), object
);
451 case DBUS_TYPE_UINT32
:
453 dbus_uint32_t val
= XUINT (object
);
454 XD_DEBUG_MESSAGE ("%c %u", dtype
, val
);
455 if (!dbus_message_iter_append_basic (iter
, dtype
, &val
))
456 XD_SIGNAL2 (build_string ("Unable to append argument"), object
);
460 case DBUS_TYPE_INT64
:
462 dbus_int64_t val
= XINT (object
);
463 XD_DEBUG_MESSAGE ("%c %d", dtype
, (int) val
);
464 if (!dbus_message_iter_append_basic (iter
, dtype
, &val
))
465 XD_SIGNAL2 (build_string ("Unable to append argument"), object
);
469 case DBUS_TYPE_UINT64
:
471 dbus_uint64_t val
= XUINT (object
);
472 XD_DEBUG_MESSAGE ("%c %u", dtype
, (unsigned int) val
);
473 if (!dbus_message_iter_append_basic (iter
, dtype
, &val
))
474 XD_SIGNAL2 (build_string ("Unable to append argument"), object
);
478 case DBUS_TYPE_DOUBLE
:
480 double val
= XFLOAT_DATA (object
);
481 XD_DEBUG_MESSAGE ("%c %f", dtype
, val
);
482 if (!dbus_message_iter_append_basic (iter
, dtype
, &val
))
483 XD_SIGNAL2 (build_string ("Unable to append argument"), object
);
487 case DBUS_TYPE_STRING
:
488 case DBUS_TYPE_OBJECT_PATH
:
489 case DBUS_TYPE_SIGNATURE
:
491 char *val
= SDATA (Fstring_make_unibyte (object
));
492 XD_DEBUG_MESSAGE ("%c %s", dtype
, val
);
493 if (!dbus_message_iter_append_basic (iter
, dtype
, &val
))
494 XD_SIGNAL2 (build_string ("Unable to append argument"), object
);
499 else /* Compound types. */
502 /* All compound types except array have a type symbol. For
503 array, it is optional. Skip it. */
504 if (!XD_BASIC_DBUS_TYPE (XD_OBJECT_TO_DBUS_TYPE (CAR_SAFE (object
))))
505 object
= XD_NEXT_VALUE (object
);
507 /* Open new subiteration. */
510 case DBUS_TYPE_ARRAY
:
511 /* An array has only elements of the same type. So it is
512 sufficient to check the first element's signature
516 /* If the array is empty, DBUS_TYPE_STRING is the default
518 strcpy (signature
, DBUS_TYPE_STRING_AS_STRING
);
521 /* If the element type is DBUS_TYPE_SIGNATURE, and this is
522 the only element, the value of this element is used as
523 the array's element signature. */
524 if ((XD_OBJECT_TO_DBUS_TYPE (CAR_SAFE (object
))
525 == DBUS_TYPE_SIGNATURE
)
526 && STRINGP (CAR_SAFE (XD_NEXT_VALUE (object
)))
527 && NILP (CDR_SAFE (XD_NEXT_VALUE (object
))))
529 strcpy (signature
, SDATA (CAR_SAFE (XD_NEXT_VALUE (object
))));
530 object
= CDR_SAFE (XD_NEXT_VALUE (object
));
534 xd_signature (signature
,
535 XD_OBJECT_TO_DBUS_TYPE (CAR_SAFE (object
)),
536 dtype
, CAR_SAFE (XD_NEXT_VALUE (object
)));
538 XD_DEBUG_MESSAGE ("%c %s %s", dtype
, signature
,
539 SDATA (format2 ("%s", object
, Qnil
)));
540 if (!dbus_message_iter_open_container (iter
, dtype
,
541 signature
, &subiter
))
542 XD_SIGNAL3 (build_string ("Cannot open container"),
543 make_number (dtype
), build_string (signature
));
546 case DBUS_TYPE_VARIANT
:
547 /* A variant has just one element. */
548 xd_signature (signature
, XD_OBJECT_TO_DBUS_TYPE (CAR_SAFE (object
)),
549 dtype
, CAR_SAFE (XD_NEXT_VALUE (object
)));
551 XD_DEBUG_MESSAGE ("%c %s %s", dtype
, signature
,
552 SDATA (format2 ("%s", object
, Qnil
)));
553 if (!dbus_message_iter_open_container (iter
, dtype
,
554 signature
, &subiter
))
555 XD_SIGNAL3 (build_string ("Cannot open container"),
556 make_number (dtype
), build_string (signature
));
559 case DBUS_TYPE_STRUCT
:
560 case DBUS_TYPE_DICT_ENTRY
:
561 /* These containers do not require a signature. */
562 XD_DEBUG_MESSAGE ("%c %s", dtype
,
563 SDATA (format2 ("%s", object
, Qnil
)));
564 if (!dbus_message_iter_open_container (iter
, dtype
, NULL
, &subiter
))
565 XD_SIGNAL2 (build_string ("Cannot open container"),
566 make_number (dtype
));
570 /* Loop over list elements. */
571 while (!NILP (object
))
573 dtype
= XD_OBJECT_TO_DBUS_TYPE (CAR_SAFE (object
));
574 object
= XD_NEXT_VALUE (object
);
576 xd_append_arg (dtype
, CAR_SAFE (object
), &subiter
);
578 object
= CDR_SAFE (object
);
581 /* Close the subiteration. */
582 if (!dbus_message_iter_close_container (iter
, &subiter
))
583 XD_SIGNAL2 (build_string ("Cannot close container"),
584 make_number (dtype
));
588 /* Retrieve C value from a DBusMessageIter structure ITER, and return
589 a converted Lisp object. The type DTYPE of the argument of the
590 D-Bus message must be a valid DBusType. Compound D-Bus types
591 result always in a Lisp list. */
593 xd_retrieve_arg (dtype
, iter
)
595 DBusMessageIter
*iter
;
603 dbus_message_iter_get_basic (iter
, &val
);
605 XD_DEBUG_MESSAGE ("%c %d", dtype
, val
);
606 return make_number (val
);
609 case DBUS_TYPE_BOOLEAN
:
612 dbus_message_iter_get_basic (iter
, &val
);
613 XD_DEBUG_MESSAGE ("%c %s", dtype
, (val
== FALSE
) ? "false" : "true");
614 return (val
== FALSE
) ? Qnil
: Qt
;
617 case DBUS_TYPE_INT16
:
618 case DBUS_TYPE_UINT16
:
621 dbus_message_iter_get_basic (iter
, &val
);
622 XD_DEBUG_MESSAGE ("%c %d", dtype
, val
);
623 return make_number (val
);
626 case DBUS_TYPE_INT32
:
627 case DBUS_TYPE_UINT32
:
629 /* Assignment to EMACS_INT stops GCC whining about limited
630 range of data type. */
633 dbus_message_iter_get_basic (iter
, &val
);
634 XD_DEBUG_MESSAGE ("%c %d", dtype
, val
);
636 return make_fixnum_or_float (val1
);
639 case DBUS_TYPE_INT64
:
640 case DBUS_TYPE_UINT64
:
643 dbus_message_iter_get_basic (iter
, &val
);
644 XD_DEBUG_MESSAGE ("%c %d", dtype
, (int) val
);
645 return make_fixnum_or_float (val
);
648 case DBUS_TYPE_DOUBLE
:
651 dbus_message_iter_get_basic (iter
, &val
);
652 XD_DEBUG_MESSAGE ("%c %f", dtype
, val
);
653 return make_float (val
);
656 case DBUS_TYPE_STRING
:
657 case DBUS_TYPE_OBJECT_PATH
:
658 case DBUS_TYPE_SIGNATURE
:
661 dbus_message_iter_get_basic (iter
, &val
);
662 XD_DEBUG_MESSAGE ("%c %s", dtype
, val
);
663 return build_string (val
);
666 case DBUS_TYPE_ARRAY
:
667 case DBUS_TYPE_VARIANT
:
668 case DBUS_TYPE_STRUCT
:
669 case DBUS_TYPE_DICT_ENTRY
:
675 DBusMessageIter subiter
;
677 dbus_message_iter_recurse (iter
, &subiter
);
678 while ((subtype
= dbus_message_iter_get_arg_type (&subiter
))
679 != DBUS_TYPE_INVALID
)
681 result
= Fcons (xd_retrieve_arg (subtype
, &subiter
), result
);
682 dbus_message_iter_next (&subiter
);
684 XD_DEBUG_MESSAGE ("%c %s", dtype
, SDATA (format2 ("%s", result
, Qnil
)));
685 RETURN_UNGCPRO (Fnreverse (result
));
689 XD_DEBUG_MESSAGE ("DBusType '%c' not supported", dtype
);
694 /* Initialize D-Bus connection. BUS is a Lisp symbol, either :system
695 or :session. It tells which D-Bus to be initialized. */
696 static DBusConnection
*
700 DBusConnection
*connection
;
703 /* Parameter check. */
705 if (!(EQ (bus
, QCdbus_system_bus
) || EQ (bus
, QCdbus_session_bus
)))
706 XD_SIGNAL2 (build_string ("Wrong bus name"), bus
);
708 /* We do not want to have an autolaunch for the session bus. */
709 if (EQ (bus
, QCdbus_session_bus
)
710 && getenv ("DBUS_SESSION_BUS_ADDRESS") == NULL
)
711 XD_SIGNAL2 (build_string ("No connection to bus"), bus
);
713 /* Open a connection to the bus. */
714 dbus_error_init (&derror
);
716 if (EQ (bus
, QCdbus_system_bus
))
717 connection
= dbus_bus_get (DBUS_BUS_SYSTEM
, &derror
);
719 connection
= dbus_bus_get (DBUS_BUS_SESSION
, &derror
);
721 if (dbus_error_is_set (&derror
))
724 if (connection
== NULL
)
725 XD_SIGNAL2 (build_string ("No connection to bus"), bus
);
728 dbus_error_free (&derror
);
730 /* Return the result. */
735 /* Add connection file descriptor to input_wait_mask, in order to
736 let select() detect, whether a new message has been arrived. */
738 xd_add_watch (watch
, data
)
742 /* We check only for incoming data. */
743 if (dbus_watch_get_flags (watch
) & DBUS_WATCH_READABLE
)
745 #if HAVE_DBUS_WATCH_GET_UNIX_FD
746 /* TODO: Reverse these on Win32, which prefers the opposite. */
747 int fd
= dbus_watch_get_unix_fd(watch
);
749 fd
= dbus_watch_get_socket(watch
);
751 int fd
= dbus_watch_get_fd(watch
);
753 XD_DEBUG_MESSAGE ("%d", fd
);
758 /* Add the file descriptor to input_wait_mask. */
759 add_keyboard_wait_descriptor (fd
);
766 /* Remove connection file descriptor from input_wait_mask. */
768 xd_remove_watch (watch
, data
)
772 /* We check only for incoming data. */
773 if (dbus_watch_get_flags (watch
) & DBUS_WATCH_READABLE
)
775 #if HAVE_DBUS_WATCH_GET_UNIX_FD
776 /* TODO: Reverse these on Win32, which prefers the opposite. */
777 int fd
= dbus_watch_get_unix_fd(watch
);
779 fd
= dbus_watch_get_socket(watch
);
781 int fd
= dbus_watch_get_fd(watch
);
783 XD_DEBUG_MESSAGE ("%d", fd
);
788 /* Remove the file descriptor from input_wait_mask. */
789 delete_keyboard_wait_descriptor (fd
);
796 DEFUN ("dbus-init-bus", Fdbus_init_bus
, Sdbus_init_bus
, 1, 1, 0,
797 doc
: /* Initialize connection to D-Bus BUS.
798 This is an internal function, it shall not be used outside dbus.el. */)
802 DBusConnection
*connection
;
804 /* Check parameters. */
807 /* Open a connection to the bus. */
808 connection
= xd_initialize (bus
);
810 /* Add the watch functions. */
811 if (!dbus_connection_set_watch_functions (connection
,
815 XD_SIGNAL1 (build_string ("Cannot add watch functions"));
821 DEFUN ("dbus-get-unique-name", Fdbus_get_unique_name
, Sdbus_get_unique_name
,
823 doc
: /* Return the unique name of Emacs registered at D-Bus BUS. */)
827 DBusConnection
*connection
;
830 /* Check parameters. */
833 /* Open a connection to the bus. */
834 connection
= xd_initialize (bus
);
836 /* Request the name. */
837 name
= dbus_bus_get_unique_name (connection
);
839 XD_SIGNAL1 (build_string ("No unique name available"));
842 return build_string (name
);
845 DEFUN ("dbus-call-method", Fdbus_call_method
, Sdbus_call_method
, 5, MANY
, 0,
846 doc
: /* Call METHOD on the D-Bus BUS.
848 BUS is either the symbol `:system' or the symbol `:session'.
850 SERVICE is the D-Bus service name to be used. PATH is the D-Bus
851 object path SERVICE is registered at. INTERFACE is an interface
852 offered by SERVICE. It must provide METHOD.
854 If the parameter `:timeout' is given, the following integer TIMEOUT
855 specifies the maximun number of milliseconds the method call must
856 return. The default value is 25,000. If the method call doesn't
857 return in time, a D-Bus error is raised.
859 All other arguments ARGS are passed to METHOD as arguments. They are
860 converted into D-Bus types via the following rules:
862 t and nil => DBUS_TYPE_BOOLEAN
863 number => DBUS_TYPE_UINT32
864 integer => DBUS_TYPE_INT32
865 float => DBUS_TYPE_DOUBLE
866 string => DBUS_TYPE_STRING
867 list => DBUS_TYPE_ARRAY
869 All arguments can be preceded by a type symbol. For details about
870 type symbols, see Info node `(dbus)Type Conversion'.
872 `dbus-call-method' returns the resulting values of METHOD as a list of
873 Lisp objects. The type conversion happens the other direction as for
874 input arguments. It follows the mapping rules:
876 DBUS_TYPE_BOOLEAN => t or nil
877 DBUS_TYPE_BYTE => number
878 DBUS_TYPE_UINT16 => number
879 DBUS_TYPE_INT16 => integer
880 DBUS_TYPE_UINT32 => number or float
881 DBUS_TYPE_INT32 => integer or float
882 DBUS_TYPE_UINT64 => number or float
883 DBUS_TYPE_INT64 => integer or float
884 DBUS_TYPE_DOUBLE => float
885 DBUS_TYPE_STRING => string
886 DBUS_TYPE_OBJECT_PATH => string
887 DBUS_TYPE_SIGNATURE => string
888 DBUS_TYPE_ARRAY => list
889 DBUS_TYPE_VARIANT => list
890 DBUS_TYPE_STRUCT => list
891 DBUS_TYPE_DICT_ENTRY => list
896 :session "org.gnome.seahorse" "/org/gnome/seahorse/keys/openpgp"
897 "org.gnome.seahorse.Keys" "GetKeyField"
898 "openpgp:657984B8C7A966DD" "simple-name")
900 => (t ("Philip R. Zimmermann"))
902 If the result of the METHOD call is just one value, the converted Lisp
903 object is returned instead of a list containing this single Lisp object.
906 :system "org.freedesktop.Hal" "/org/freedesktop/Hal/devices/computer"
907 "org.freedesktop.Hal.Device" "GetPropertyString"
908 "system.kernel.machine")
912 usage: (dbus-call-method BUS SERVICE PATH INTERFACE METHOD &optional :timeout TIMEOUT &rest ARGS) */)
915 register Lisp_Object
*args
;
917 Lisp_Object bus
, service
, path
, interface
, method
;
919 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
, gcpro5
;
920 DBusConnection
*connection
;
921 DBusMessage
*dmessage
;
923 DBusMessageIter iter
;
928 char signature
[DBUS_MAXIMUM_SIGNATURE_LENGTH
];
930 /* Check parameters. */
938 CHECK_STRING (service
);
940 CHECK_STRING (interface
);
941 CHECK_STRING (method
);
942 GCPRO5 (bus
, service
, path
, interface
, method
);
944 XD_DEBUG_MESSAGE ("%s %s %s %s",
950 /* Open a connection to the bus. */
951 connection
= xd_initialize (bus
);
953 /* Create the message. */
954 dmessage
= dbus_message_new_method_call (SDATA (service
),
959 if (dmessage
== NULL
)
960 XD_SIGNAL1 (build_string ("Unable to create a new message"));
962 /* Check for timeout parameter. */
963 if ((i
+2 <= nargs
) && (EQ ((args
[i
]), QCdbus_timeout
)))
965 CHECK_NATNUM (args
[i
+1]);
966 timeout
= XUINT (args
[i
+1]);
970 /* Initialize parameter list of message. */
971 dbus_message_iter_init_append (dmessage
, &iter
);
973 /* Append parameters to the message. */
974 for (; i
< nargs
; ++i
)
976 dtype
= XD_OBJECT_TO_DBUS_TYPE (args
[i
]);
977 if (XD_DBUS_TYPE_P (args
[i
]))
979 XD_DEBUG_VALID_LISP_OBJECT_P (args
[i
]);
980 XD_DEBUG_VALID_LISP_OBJECT_P (args
[i
+1]);
981 XD_DEBUG_MESSAGE ("Parameter%d %s %s", i
-4,
982 SDATA (format2 ("%s", args
[i
], Qnil
)),
983 SDATA (format2 ("%s", args
[i
+1], Qnil
)));
988 XD_DEBUG_VALID_LISP_OBJECT_P (args
[i
]);
989 XD_DEBUG_MESSAGE ("Parameter%d %s", i
-4,
990 SDATA (format2 ("%s", args
[i
], Qnil
)));
993 /* Check for valid signature. We use DBUS_TYPE_INVALID as
994 indication that there is no parent type. */
995 xd_signature (signature
, dtype
, DBUS_TYPE_INVALID
, args
[i
]);
997 xd_append_arg (dtype
, args
[i
], &iter
);
1000 /* Send the message. */
1001 dbus_error_init (&derror
);
1002 reply
= dbus_connection_send_with_reply_and_block (connection
,
1007 if (dbus_error_is_set (&derror
))
1011 XD_SIGNAL1 (build_string ("No reply"));
1013 XD_DEBUG_MESSAGE ("Message sent");
1015 /* Collect the results. */
1019 if (dbus_message_iter_init (reply
, &iter
))
1021 /* Loop over the parameters of the D-Bus reply message. Construct a
1022 Lisp list, which is returned by `dbus-call-method'. */
1023 while ((dtype
= dbus_message_iter_get_arg_type (&iter
))
1024 != DBUS_TYPE_INVALID
)
1026 result
= Fcons (xd_retrieve_arg (dtype
, &iter
), result
);
1027 dbus_message_iter_next (&iter
);
1032 /* No arguments: just return nil. */
1036 dbus_error_free (&derror
);
1037 dbus_message_unref (dmessage
);
1038 dbus_message_unref (reply
);
1040 /* Return the result. If there is only one single Lisp object,
1041 return it as-it-is, otherwise return the reversed list. */
1042 if (XUINT (Flength (result
)) == 1)
1043 RETURN_UNGCPRO (CAR_SAFE (result
));
1045 RETURN_UNGCPRO (Fnreverse (result
));
1048 DEFUN ("dbus-call-method-asynchronously", Fdbus_call_method_asynchronously
,
1049 Sdbus_call_method_asynchronously
, 6, MANY
, 0,
1050 doc
: /* Call METHOD on the D-Bus BUS asynchronously.
1052 BUS is either the symbol `:system' or the symbol `:session'.
1054 SERVICE is the D-Bus service name to be used. PATH is the D-Bus
1055 object path SERVICE is registered at. INTERFACE is an interface
1056 offered by SERVICE. It must provide METHOD.
1058 HANDLER is a Lisp function, which is called when the corresponding
1059 return message has arrived. If HANDLER is nil, no return message will
1062 If the parameter `:timeout' is given, the following integer TIMEOUT
1063 specifies the maximun number of milliseconds the method call must
1064 return. The default value is 25,000. If the method call doesn't
1065 return in time, a D-Bus error is raised.
1067 All other arguments ARGS are passed to METHOD as arguments. They are
1068 converted into D-Bus types via the following rules:
1070 t and nil => DBUS_TYPE_BOOLEAN
1071 number => DBUS_TYPE_UINT32
1072 integer => DBUS_TYPE_INT32
1073 float => DBUS_TYPE_DOUBLE
1074 string => DBUS_TYPE_STRING
1075 list => DBUS_TYPE_ARRAY
1077 All arguments can be preceded by a type symbol. For details about
1078 type symbols, see Info node `(dbus)Type Conversion'.
1080 Unless HANDLER is nil, the function returns a key into the hash table
1081 `dbus-registered-functions-table'. The corresponding entry in the
1082 hash table is removed, when the return message has been arrived, and
1087 \(dbus-call-method-asynchronously
1088 :system "org.freedesktop.Hal" "/org/freedesktop/Hal/devices/computer"
1089 "org.freedesktop.Hal.Device" "GetPropertyString" 'message
1090 "system.kernel.machine")
1096 usage: (dbus-call-method-asynchronously BUS SERVICE PATH INTERFACE METHOD HANDLER &optional :timeout TIMEOUT &rest ARGS) */)
1099 register Lisp_Object
*args
;
1101 Lisp_Object bus
, service
, path
, interface
, method
, handler
;
1103 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
, gcpro5
, gcpro6
;
1104 DBusConnection
*connection
;
1105 DBusMessage
*dmessage
;
1106 DBusMessageIter iter
;
1110 char signature
[DBUS_MAXIMUM_SIGNATURE_LENGTH
];
1112 /* Check parameters. */
1116 interface
= args
[3];
1121 CHECK_STRING (service
);
1122 CHECK_STRING (path
);
1123 CHECK_STRING (interface
);
1124 CHECK_STRING (method
);
1125 if (!NILP (handler
) && !FUNCTIONP (handler
))
1126 wrong_type_argument (intern ("functionp"), handler
);
1127 GCPRO6 (bus
, service
, path
, interface
, method
, handler
);
1129 XD_DEBUG_MESSAGE ("%s %s %s %s",
1135 /* Open a connection to the bus. */
1136 connection
= xd_initialize (bus
);
1138 /* Create the message. */
1139 dmessage
= dbus_message_new_method_call (SDATA (service
),
1143 if (dmessage
== NULL
)
1144 XD_SIGNAL1 (build_string ("Unable to create a new message"));
1146 /* Check for timeout parameter. */
1147 if ((i
+2 <= nargs
) && (EQ ((args
[i
]), QCdbus_timeout
)))
1149 CHECK_NATNUM (args
[i
+1]);
1150 timeout
= XUINT (args
[i
+1]);
1154 /* Initialize parameter list of message. */
1155 dbus_message_iter_init_append (dmessage
, &iter
);
1157 /* Append parameters to the message. */
1158 for (; i
< nargs
; ++i
)
1160 dtype
= XD_OBJECT_TO_DBUS_TYPE (args
[i
]);
1161 if (XD_DBUS_TYPE_P (args
[i
]))
1163 XD_DEBUG_VALID_LISP_OBJECT_P (args
[i
]);
1164 XD_DEBUG_VALID_LISP_OBJECT_P (args
[i
+1]);
1165 XD_DEBUG_MESSAGE ("Parameter%d %s %s", i
-4,
1166 SDATA (format2 ("%s", args
[i
], Qnil
)),
1167 SDATA (format2 ("%s", args
[i
+1], Qnil
)));
1172 XD_DEBUG_VALID_LISP_OBJECT_P (args
[i
]);
1173 XD_DEBUG_MESSAGE ("Parameter%d %s", i
-4,
1174 SDATA (format2 ("%s", args
[i
], Qnil
)));
1177 /* Check for valid signature. We use DBUS_TYPE_INVALID as
1178 indication that there is no parent type. */
1179 xd_signature (signature
, dtype
, DBUS_TYPE_INVALID
, args
[i
]);
1181 xd_append_arg (dtype
, args
[i
], &iter
);
1184 if (!NILP (handler
))
1186 /* Send the message. The message is just added to the outgoing
1188 if (!dbus_connection_send_with_reply (connection
, dmessage
,
1190 XD_SIGNAL1 (build_string ("Cannot send message"));
1192 /* The result is the key in Vdbus_registered_functions_table. */
1193 result
= (list2 (bus
, make_number (dbus_message_get_serial (dmessage
))));
1195 /* Create a hash table entry. */
1196 Fputhash (result
, handler
, Vdbus_registered_functions_table
);
1200 /* Send the message. The message is just added to the outgoing
1202 if (!dbus_connection_send (connection
, dmessage
, NULL
))
1203 XD_SIGNAL1 (build_string ("Cannot send message"));
1208 /* Flush connection to ensure the message is handled. */
1209 dbus_connection_flush (connection
);
1211 XD_DEBUG_MESSAGE ("Message sent");
1214 dbus_message_unref (dmessage
);
1216 /* Return the result. */
1217 RETURN_UNGCPRO (result
);
1220 DEFUN ("dbus-method-return-internal", Fdbus_method_return_internal
,
1221 Sdbus_method_return_internal
,
1223 doc
: /* Return for message SERIAL on the D-Bus BUS.
1224 This is an internal function, it shall not be used outside dbus.el.
1226 usage: (dbus-method-return-internal BUS SERIAL SERVICE &rest ARGS) */)
1229 register Lisp_Object
*args
;
1231 Lisp_Object bus
, serial
, service
;
1232 struct gcpro gcpro1
, gcpro2
, gcpro3
;
1233 DBusConnection
*connection
;
1234 DBusMessage
*dmessage
;
1235 DBusMessageIter iter
;
1238 char signature
[DBUS_MAXIMUM_SIGNATURE_LENGTH
];
1240 /* Check parameters. */
1246 CHECK_NUMBER (serial
);
1247 CHECK_STRING (service
);
1248 GCPRO3 (bus
, serial
, service
);
1250 XD_DEBUG_MESSAGE ("%d %s ", XUINT (serial
), SDATA (service
));
1252 /* Open a connection to the bus. */
1253 connection
= xd_initialize (bus
);
1255 /* Create the message. */
1256 dmessage
= dbus_message_new (DBUS_MESSAGE_TYPE_METHOD_RETURN
);
1257 if ((dmessage
== NULL
)
1258 || (!dbus_message_set_reply_serial (dmessage
, XUINT (serial
)))
1259 || (!dbus_message_set_destination (dmessage
, SDATA (service
))))
1262 XD_SIGNAL1 (build_string ("Unable to create a return message"));
1267 /* Initialize parameter list of message. */
1268 dbus_message_iter_init_append (dmessage
, &iter
);
1270 /* Append parameters to the message. */
1271 for (i
= 3; i
< nargs
; ++i
)
1273 dtype
= XD_OBJECT_TO_DBUS_TYPE (args
[i
]);
1274 if (XD_DBUS_TYPE_P (args
[i
]))
1276 XD_DEBUG_VALID_LISP_OBJECT_P (args
[i
]);
1277 XD_DEBUG_VALID_LISP_OBJECT_P (args
[i
+1]);
1278 XD_DEBUG_MESSAGE ("Parameter%d %s %s", i
-2,
1279 SDATA (format2 ("%s", args
[i
], Qnil
)),
1280 SDATA (format2 ("%s", args
[i
+1], Qnil
)));
1285 XD_DEBUG_VALID_LISP_OBJECT_P (args
[i
]);
1286 XD_DEBUG_MESSAGE ("Parameter%d %s", i
-2,
1287 SDATA (format2 ("%s", args
[i
], Qnil
)));
1290 /* Check for valid signature. We use DBUS_TYPE_INVALID as
1291 indication that there is no parent type. */
1292 xd_signature (signature
, dtype
, DBUS_TYPE_INVALID
, args
[i
]);
1294 xd_append_arg (dtype
, args
[i
], &iter
);
1297 /* Send the message. The message is just added to the outgoing
1299 if (!dbus_connection_send (connection
, dmessage
, NULL
))
1300 XD_SIGNAL1 (build_string ("Cannot send message"));
1302 /* Flush connection to ensure the message is handled. */
1303 dbus_connection_flush (connection
);
1305 XD_DEBUG_MESSAGE ("Message sent");
1308 dbus_message_unref (dmessage
);
1314 DEFUN ("dbus-method-error-internal", Fdbus_method_error_internal
,
1315 Sdbus_method_error_internal
,
1317 doc
: /* Return error message for message SERIAL on the D-Bus BUS.
1318 This is an internal function, it shall not be used outside dbus.el.
1320 usage: (dbus-method-error-internal BUS SERIAL SERVICE &rest ARGS) */)
1323 register Lisp_Object
*args
;
1325 Lisp_Object bus
, serial
, service
;
1326 struct gcpro gcpro1
, gcpro2
, gcpro3
;
1327 DBusConnection
*connection
;
1328 DBusMessage
*dmessage
;
1329 DBusMessageIter iter
;
1332 char signature
[DBUS_MAXIMUM_SIGNATURE_LENGTH
];
1334 /* Check parameters. */
1340 CHECK_NUMBER (serial
);
1341 CHECK_STRING (service
);
1342 GCPRO3 (bus
, serial
, service
);
1344 XD_DEBUG_MESSAGE ("%d %s ", XUINT (serial
), SDATA (service
));
1346 /* Open a connection to the bus. */
1347 connection
= xd_initialize (bus
);
1349 /* Create the message. */
1350 dmessage
= dbus_message_new (DBUS_MESSAGE_TYPE_ERROR
);
1351 if ((dmessage
== NULL
)
1352 || (!dbus_message_set_error_name (dmessage
, DBUS_ERROR_FAILED
))
1353 || (!dbus_message_set_reply_serial (dmessage
, XUINT (serial
)))
1354 || (!dbus_message_set_destination (dmessage
, SDATA (service
))))
1357 XD_SIGNAL1 (build_string ("Unable to create a error message"));
1362 /* Initialize parameter list of message. */
1363 dbus_message_iter_init_append (dmessage
, &iter
);
1365 /* Append parameters to the message. */
1366 for (i
= 3; i
< nargs
; ++i
)
1368 dtype
= XD_OBJECT_TO_DBUS_TYPE (args
[i
]);
1369 if (XD_DBUS_TYPE_P (args
[i
]))
1371 XD_DEBUG_VALID_LISP_OBJECT_P (args
[i
]);
1372 XD_DEBUG_VALID_LISP_OBJECT_P (args
[i
+1]);
1373 XD_DEBUG_MESSAGE ("Parameter%d %s %s", i
-2,
1374 SDATA (format2 ("%s", args
[i
], Qnil
)),
1375 SDATA (format2 ("%s", args
[i
+1], Qnil
)));
1380 XD_DEBUG_VALID_LISP_OBJECT_P (args
[i
]);
1381 XD_DEBUG_MESSAGE ("Parameter%d %s", i
-2,
1382 SDATA (format2 ("%s", args
[i
], Qnil
)));
1385 /* Check for valid signature. We use DBUS_TYPE_INVALID as
1386 indication that there is no parent type. */
1387 xd_signature (signature
, dtype
, DBUS_TYPE_INVALID
, args
[i
]);
1389 xd_append_arg (dtype
, args
[i
], &iter
);
1392 /* Send the message. The message is just added to the outgoing
1394 if (!dbus_connection_send (connection
, dmessage
, NULL
))
1395 XD_SIGNAL1 (build_string ("Cannot send message"));
1397 /* Flush connection to ensure the message is handled. */
1398 dbus_connection_flush (connection
);
1400 XD_DEBUG_MESSAGE ("Message sent");
1403 dbus_message_unref (dmessage
);
1409 DEFUN ("dbus-send-signal", Fdbus_send_signal
, Sdbus_send_signal
, 5, MANY
, 0,
1410 doc
: /* Send signal SIGNAL on the D-Bus BUS.
1412 BUS is either the symbol `:system' or the symbol `:session'.
1414 SERVICE is the D-Bus service name SIGNAL is sent from. PATH is the
1415 D-Bus object path SERVICE is registered at. INTERFACE is an interface
1416 offered by SERVICE. It must provide signal SIGNAL.
1418 All other arguments ARGS are passed to SIGNAL as arguments. They are
1419 converted into D-Bus types via the following rules:
1421 t and nil => DBUS_TYPE_BOOLEAN
1422 number => DBUS_TYPE_UINT32
1423 integer => DBUS_TYPE_INT32
1424 float => DBUS_TYPE_DOUBLE
1425 string => DBUS_TYPE_STRING
1426 list => DBUS_TYPE_ARRAY
1428 All arguments can be preceded by a type symbol. For details about
1429 type symbols, see Info node `(dbus)Type Conversion'.
1434 :session "org.gnu.Emacs" "/org/gnu/Emacs"
1435 "org.gnu.Emacs.FileManager" "FileModified" "/home/albinus/.emacs")
1437 usage: (dbus-send-signal BUS SERVICE PATH INTERFACE SIGNAL &rest ARGS) */)
1440 register Lisp_Object
*args
;
1442 Lisp_Object bus
, service
, path
, interface
, signal
;
1443 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
, gcpro5
;
1444 DBusConnection
*connection
;
1445 DBusMessage
*dmessage
;
1446 DBusMessageIter iter
;
1449 char signature
[DBUS_MAXIMUM_SIGNATURE_LENGTH
];
1451 /* Check parameters. */
1455 interface
= args
[3];
1459 CHECK_STRING (service
);
1460 CHECK_STRING (path
);
1461 CHECK_STRING (interface
);
1462 CHECK_STRING (signal
);
1463 GCPRO5 (bus
, service
, path
, interface
, signal
);
1465 XD_DEBUG_MESSAGE ("%s %s %s %s",
1471 /* Open a connection to the bus. */
1472 connection
= xd_initialize (bus
);
1474 /* Create the message. */
1475 dmessage
= dbus_message_new_signal (SDATA (path
),
1479 if (dmessage
== NULL
)
1480 XD_SIGNAL1 (build_string ("Unable to create a new message"));
1482 /* Initialize parameter list of message. */
1483 dbus_message_iter_init_append (dmessage
, &iter
);
1485 /* Append parameters to the message. */
1486 for (i
= 5; i
< nargs
; ++i
)
1488 dtype
= XD_OBJECT_TO_DBUS_TYPE (args
[i
]);
1489 if (XD_DBUS_TYPE_P (args
[i
]))
1491 XD_DEBUG_VALID_LISP_OBJECT_P (args
[i
]);
1492 XD_DEBUG_VALID_LISP_OBJECT_P (args
[i
+1]);
1493 XD_DEBUG_MESSAGE ("Parameter%d %s %s", i
-4,
1494 SDATA (format2 ("%s", args
[i
], Qnil
)),
1495 SDATA (format2 ("%s", args
[i
+1], Qnil
)));
1500 XD_DEBUG_VALID_LISP_OBJECT_P (args
[i
]);
1501 XD_DEBUG_MESSAGE ("Parameter%d %s", i
-4,
1502 SDATA (format2 ("%s", args
[i
], Qnil
)));
1505 /* Check for valid signature. We use DBUS_TYPE_INVALID as
1506 indication that there is no parent type. */
1507 xd_signature (signature
, dtype
, DBUS_TYPE_INVALID
, args
[i
]);
1509 xd_append_arg (dtype
, args
[i
], &iter
);
1512 /* Send the message. The message is just added to the outgoing
1514 if (!dbus_connection_send (connection
, dmessage
, NULL
))
1515 XD_SIGNAL1 (build_string ("Cannot send message"));
1517 /* Flush connection to ensure the message is handled. */
1518 dbus_connection_flush (connection
);
1520 XD_DEBUG_MESSAGE ("Signal sent");
1523 dbus_message_unref (dmessage
);
1529 /* Check, whether there is pending input in the message queue of the
1530 D-Bus BUS. BUS is a Lisp symbol, either :system or :session. */
1532 xd_get_dispatch_status (bus
)
1535 DBusConnection
*connection
;
1537 /* Open a connection to the bus. */
1538 connection
= xd_initialize (bus
);
1540 /* Non blocking read of the next available message. */
1541 dbus_connection_read_write (connection
, 0);
1545 (dbus_connection_get_dispatch_status (connection
)
1546 == DBUS_DISPATCH_DATA_REMAINS
)
1550 /* Check for queued incoming messages from the system and session buses. */
1552 xd_pending_messages ()
1555 /* Vdbus_registered_functions_table will be initialized as hash
1556 table in dbus.el. When this package isn't loaded yet, it doesn't
1557 make sense to handle D-Bus messages. */
1558 return (HASH_TABLE_P (Vdbus_registered_functions_table
)
1559 ? (xd_get_dispatch_status (QCdbus_system_bus
)
1560 || ((getenv ("DBUS_SESSION_BUS_ADDRESS") != NULL
)
1561 ? xd_get_dispatch_status (QCdbus_session_bus
)
1566 /* Read queued incoming message of the D-Bus BUS. BUS is a Lisp
1567 symbol, either :system or :session. */
1569 xd_read_message (bus
)
1572 Lisp_Object args
, key
, value
;
1573 struct gcpro gcpro1
;
1574 struct input_event event
;
1575 DBusConnection
*connection
;
1576 DBusMessage
*dmessage
;
1577 DBusMessageIter iter
;
1580 const char *uname
, *path
, *interface
, *member
;
1582 /* Open a connection to the bus. */
1583 connection
= xd_initialize (bus
);
1585 /* Non blocking read of the next available message. */
1586 dbus_connection_read_write (connection
, 0);
1587 dmessage
= dbus_connection_pop_message (connection
);
1589 /* Return if there is no queued message. */
1590 if (dmessage
== NULL
)
1593 /* Collect the parameters. */
1597 /* Loop over the resulting parameters. Construct a list. */
1598 if (dbus_message_iter_init (dmessage
, &iter
))
1600 while ((dtype
= dbus_message_iter_get_arg_type (&iter
))
1601 != DBUS_TYPE_INVALID
)
1603 args
= Fcons (xd_retrieve_arg (dtype
, &iter
), args
);
1604 dbus_message_iter_next (&iter
);
1606 /* The arguments are stored in reverse order. Reorder them. */
1607 args
= Fnreverse (args
);
1610 /* Read message type, message serial, unique name, object path,
1611 interface and member from the message. */
1612 mtype
= dbus_message_get_type (dmessage
);
1614 ((mtype
== DBUS_MESSAGE_TYPE_METHOD_RETURN
)
1615 || (mtype
== DBUS_MESSAGE_TYPE_ERROR
))
1616 ? dbus_message_get_reply_serial (dmessage
)
1617 : dbus_message_get_serial (dmessage
);
1618 uname
= dbus_message_get_sender (dmessage
);
1619 path
= dbus_message_get_path (dmessage
);
1620 interface
= dbus_message_get_interface (dmessage
);
1621 member
= dbus_message_get_member (dmessage
);
1623 XD_DEBUG_MESSAGE ("Event received: %s %d %s %s %s %s %s",
1624 (mtype
== DBUS_MESSAGE_TYPE_INVALID
)
1625 ? "DBUS_MESSAGE_TYPE_INVALID"
1626 : (mtype
== DBUS_MESSAGE_TYPE_METHOD_CALL
)
1627 ? "DBUS_MESSAGE_TYPE_METHOD_CALL"
1628 : (mtype
== DBUS_MESSAGE_TYPE_METHOD_RETURN
)
1629 ? "DBUS_MESSAGE_TYPE_METHOD_RETURN"
1630 : (mtype
== DBUS_MESSAGE_TYPE_ERROR
)
1631 ? "DBUS_MESSAGE_TYPE_ERROR"
1632 : "DBUS_MESSAGE_TYPE_SIGNAL",
1633 serial
, uname
, path
, interface
, member
,
1634 SDATA (format2 ("%s", args
, Qnil
)));
1636 if ((mtype
== DBUS_MESSAGE_TYPE_METHOD_RETURN
)
1637 || (mtype
== DBUS_MESSAGE_TYPE_ERROR
))
1639 /* Search for a registered function of the message. */
1640 key
= list2 (bus
, make_number (serial
));
1641 value
= Fgethash (key
, Vdbus_registered_functions_table
, Qnil
);
1643 /* There shall be exactly one entry. Construct an event. */
1647 /* Remove the entry. */
1648 Fremhash (key
, Vdbus_registered_functions_table
);
1650 /* Construct an event. */
1652 event
.kind
= DBUS_EVENT
;
1653 event
.frame_or_window
= Qnil
;
1654 event
.arg
= Fcons (value
, args
);
1657 else /* (mtype != DBUS_MESSAGE_TYPE_METHOD_RETURN) */
1659 /* Vdbus_registered_functions_table requires non-nil interface
1661 if ((interface
== NULL
) || (member
== NULL
))
1664 /* Search for a registered function of the message. */
1665 key
= list3 (bus
, build_string (interface
), build_string (member
));
1666 value
= Fgethash (key
, Vdbus_registered_functions_table
, Qnil
);
1668 /* Loop over the registered functions. Construct an event. */
1669 while (!NILP (value
))
1671 key
= CAR_SAFE (value
);
1672 /* key has the structure (UNAME SERVICE PATH HANDLER). */
1673 if (((uname
== NULL
)
1674 || (NILP (CAR_SAFE (key
)))
1675 || (strcmp (uname
, SDATA (CAR_SAFE (key
))) == 0))
1677 || (NILP (CAR_SAFE (CDR_SAFE (CDR_SAFE (key
)))))
1679 SDATA (CAR_SAFE (CDR_SAFE (CDR_SAFE (key
)))))
1681 && (!NILP (CAR_SAFE (CDR_SAFE (CDR_SAFE (CDR_SAFE (key
)))))))
1684 event
.kind
= DBUS_EVENT
;
1685 event
.frame_or_window
= Qnil
;
1686 event
.arg
= Fcons (CAR_SAFE (CDR_SAFE (CDR_SAFE (CDR_SAFE (key
)))),
1690 value
= CDR_SAFE (value
);
1697 /* Add type, serial, uname, path, interface and member to the event. */
1698 event
.arg
= Fcons ((member
== NULL
? Qnil
: build_string (member
)),
1700 event
.arg
= Fcons ((interface
== NULL
? Qnil
: build_string (interface
)),
1702 event
.arg
= Fcons ((path
== NULL
? Qnil
: build_string (path
)),
1704 event
.arg
= Fcons ((uname
== NULL
? Qnil
: build_string (uname
)),
1706 event
.arg
= Fcons (make_number (serial
), event
.arg
);
1707 event
.arg
= Fcons (make_number (mtype
), event
.arg
);
1709 /* Add the bus symbol to the event. */
1710 event
.arg
= Fcons (bus
, event
.arg
);
1712 /* Store it into the input event queue. */
1713 kbd_buffer_store_event (&event
);
1715 XD_DEBUG_MESSAGE ("Event stored: %s",
1716 SDATA (format2 ("%s", event
.arg
, Qnil
)));
1720 dbus_message_unref (dmessage
);
1722 RETURN_UNGCPRO (Qnil
);
1725 /* Read queued incoming messages from the system and session buses. */
1727 xd_read_queued_messages ()
1730 /* Vdbus_registered_functions_table will be initialized as hash
1731 table in dbus.el. When this package isn't loaded yet, it doesn't
1732 make sense to handle D-Bus messages. Furthermore, we ignore all
1733 Lisp errors during the call. */
1734 if (HASH_TABLE_P (Vdbus_registered_functions_table
))
1736 xd_in_read_queued_messages
= 1;
1737 internal_catch (Qdbus_error
, xd_read_message
, QCdbus_system_bus
);
1738 internal_catch (Qdbus_error
, xd_read_message
, QCdbus_session_bus
);
1739 xd_in_read_queued_messages
= 0;
1743 DEFUN ("dbus-register-signal", Fdbus_register_signal
, Sdbus_register_signal
,
1745 doc
: /* Register for signal SIGNAL on the D-Bus BUS.
1747 BUS is either the symbol `:system' or the symbol `:session'.
1749 SERVICE is the D-Bus service name used by the sending D-Bus object.
1750 It can be either a known name or the unique name of the D-Bus object
1751 sending the signal. When SERVICE is nil, related signals from all
1752 D-Bus objects shall be accepted.
1754 PATH is the D-Bus object path SERVICE is registered. It can also be
1755 nil if the path name of incoming signals shall not be checked.
1757 INTERFACE is an interface offered by SERVICE. It must provide SIGNAL.
1758 HANDLER is a Lisp function to be called when the signal is received.
1759 It must accept as arguments the values SIGNAL is sending.
1761 All other arguments ARGS, if specified, must be strings. They stand
1762 for the respective arguments of the signal in their order, and are
1763 used for filtering as well. A nil argument might be used to preserve
1766 INTERFACE, SIGNAL and HANDLER must not be nil. Example:
1768 \(defun my-signal-handler (device)
1769 (message "Device %s added" device))
1771 \(dbus-register-signal
1772 :system "org.freedesktop.Hal" "/org/freedesktop/Hal/Manager"
1773 "org.freedesktop.Hal.Manager" "DeviceAdded" 'my-signal-handler)
1775 => ((:system "org.freedesktop.Hal.Manager" "DeviceAdded")
1776 ("org.freedesktop.Hal" "/org/freedesktop/Hal/Manager" my-signal-handler))
1778 `dbus-register-signal' returns an object, which can be used in
1779 `dbus-unregister-object' for removing the registration.
1781 usage: (dbus-register-signal BUS SERVICE PATH INTERFACE SIGNAL HANDLER &rest ARGS) */)
1784 register Lisp_Object
*args
;
1786 Lisp_Object bus
, service
, path
, interface
, signal
, handler
;
1787 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
, gcpro5
, gcpro6
;
1788 Lisp_Object uname
, key
, key1
, value
;
1789 DBusConnection
*connection
;
1791 char rule
[DBUS_MAXIMUM_MATCH_RULE_LENGTH
];
1792 char x
[DBUS_MAXIMUM_MATCH_RULE_LENGTH
];
1795 /* Check parameters. */
1799 interface
= args
[3];
1804 if (!NILP (service
)) CHECK_STRING (service
);
1805 if (!NILP (path
)) CHECK_STRING (path
);
1806 CHECK_STRING (interface
);
1807 CHECK_STRING (signal
);
1808 if (!FUNCTIONP (handler
))
1809 wrong_type_argument (intern ("functionp"), handler
);
1810 GCPRO6 (bus
, service
, path
, interface
, signal
, handler
);
1812 /* Retrieve unique name of service. If service is a known name, we
1813 will register for the corresponding unique name, if any. Signals
1814 are sent always with the unique name as sender. Note: the unique
1815 name of "org.freedesktop.DBus" is that string itself. */
1816 if ((STRINGP (service
))
1817 && (SBYTES (service
) > 0)
1818 && (strcmp (SDATA (service
), DBUS_SERVICE_DBUS
) != 0)
1819 && (strncmp (SDATA (service
), ":", 1) != 0))
1821 uname
= call2 (intern ("dbus-get-name-owner"), bus
, service
);
1822 /* When there is no unique name, we mark it with an empty
1825 uname
= empty_unibyte_string
;
1830 /* Create a matching rule if the unique name exists (when no
1832 if (NILP (uname
) || (SBYTES (uname
) > 0))
1834 /* Open a connection to the bus. */
1835 connection
= xd_initialize (bus
);
1837 /* Create a rule to receive related signals. */
1839 "type='signal',interface='%s',member='%s'",
1843 /* Add unique name and path to the rule if they are non-nil. */
1846 sprintf (x
, ",sender='%s'", SDATA (uname
));
1852 sprintf (x
, ",path='%s'", SDATA (path
));
1856 /* Add arguments to the rule if they are non-nil. */
1857 for (i
= 6; i
< nargs
; ++i
)
1858 if (!NILP (args
[i
]))
1860 CHECK_STRING (args
[i
]);
1861 sprintf (x
, ",arg%d='%s'", i
-6, SDATA (args
[i
]));
1865 /* Add the rule to the bus. */
1866 dbus_error_init (&derror
);
1867 dbus_bus_add_match (connection
, rule
, &derror
);
1868 if (dbus_error_is_set (&derror
))
1875 dbus_error_free (&derror
);
1877 XD_DEBUG_MESSAGE ("Matching rule \"%s\" created", rule
);
1880 /* Create a hash table entry. */
1881 key
= list3 (bus
, interface
, signal
);
1882 key1
= list4 (uname
, service
, path
, handler
);
1883 value
= Fgethash (key
, Vdbus_registered_functions_table
, Qnil
);
1885 if (NILP (Fmember (key1
, value
)))
1886 Fputhash (key
, Fcons (key1
, value
), Vdbus_registered_functions_table
);
1888 /* Return object. */
1889 RETURN_UNGCPRO (list2 (key
, list3 (service
, path
, handler
)));
1892 DEFUN ("dbus-register-method", Fdbus_register_method
, Sdbus_register_method
,
1894 doc
: /* Register for method METHOD on the D-Bus BUS.
1896 BUS is either the symbol `:system' or the symbol `:session'.
1898 SERVICE is the D-Bus service name of the D-Bus object METHOD is
1899 registered for. It must be a known name.
1901 PATH is the D-Bus object path SERVICE is registered. INTERFACE is the
1902 interface offered by SERVICE. It must provide METHOD. HANDLER is a
1903 Lisp function to be called when a method call is received. It must
1904 accept the input arguments of METHOD. The return value of HANDLER is
1905 used for composing the returning D-Bus message. */)
1906 (bus
, service
, path
, interface
, method
, handler
)
1907 Lisp_Object bus
, service
, path
, interface
, method
, handler
;
1909 Lisp_Object key
, key1
, value
;
1910 DBusConnection
*connection
;
1914 /* Check parameters. */
1916 CHECK_STRING (service
);
1917 CHECK_STRING (path
);
1918 CHECK_STRING (interface
);
1919 CHECK_STRING (method
);
1920 if (!FUNCTIONP (handler
))
1921 wrong_type_argument (intern ("functionp"), handler
);
1922 /* TODO: We must check for a valid service name, otherwise there is
1923 a segmentation fault. */
1925 /* Open a connection to the bus. */
1926 connection
= xd_initialize (bus
);
1928 /* Request the known name from the bus. We can ignore the result,
1929 it is set to -1 if there is an error - kind of redundancy. */
1930 dbus_error_init (&derror
);
1931 result
= dbus_bus_request_name (connection
, SDATA (service
), 0, &derror
);
1932 if (dbus_error_is_set (&derror
))
1935 /* Create a hash table entry. */
1936 key
= list3 (bus
, interface
, method
);
1937 key1
= list4 (Qnil
, service
, path
, handler
);
1938 value
= Fgethash (key
, Vdbus_registered_functions_table
, Qnil
);
1940 /* We use nil for the unique name, because the method might be
1941 called from everybody. */
1942 if (NILP (Fmember (key1
, value
)))
1943 Fputhash (key
, Fcons (key1
, value
), Vdbus_registered_functions_table
);
1946 dbus_error_free (&derror
);
1948 /* Return object. */
1949 return list2 (key
, list3 (service
, path
, handler
));
1957 Qdbus_init_bus
= intern ("dbus-init-bus");
1958 staticpro (&Qdbus_init_bus
);
1959 defsubr (&Sdbus_init_bus
);
1961 Qdbus_get_unique_name
= intern ("dbus-get-unique-name");
1962 staticpro (&Qdbus_get_unique_name
);
1963 defsubr (&Sdbus_get_unique_name
);
1965 Qdbus_call_method
= intern ("dbus-call-method");
1966 staticpro (&Qdbus_call_method
);
1967 defsubr (&Sdbus_call_method
);
1969 Qdbus_call_method_asynchronously
= intern ("dbus-call-method-asynchronously");
1970 staticpro (&Qdbus_call_method_asynchronously
);
1971 defsubr (&Sdbus_call_method_asynchronously
);
1973 Qdbus_method_return_internal
= intern ("dbus-method-return-internal");
1974 staticpro (&Qdbus_method_return_internal
);
1975 defsubr (&Sdbus_method_return_internal
);
1977 Qdbus_method_error_internal
= intern ("dbus-method-error-internal");
1978 staticpro (&Qdbus_method_error_internal
);
1979 defsubr (&Sdbus_method_error_internal
);
1981 Qdbus_send_signal
= intern ("dbus-send-signal");
1982 staticpro (&Qdbus_send_signal
);
1983 defsubr (&Sdbus_send_signal
);
1985 Qdbus_register_signal
= intern ("dbus-register-signal");
1986 staticpro (&Qdbus_register_signal
);
1987 defsubr (&Sdbus_register_signal
);
1989 Qdbus_register_method
= intern ("dbus-register-method");
1990 staticpro (&Qdbus_register_method
);
1991 defsubr (&Sdbus_register_method
);
1993 Qdbus_error
= intern ("dbus-error");
1994 staticpro (&Qdbus_error
);
1995 Fput (Qdbus_error
, Qerror_conditions
,
1996 list2 (Qdbus_error
, Qerror
));
1997 Fput (Qdbus_error
, Qerror_message
,
1998 build_string ("D-Bus error"));
2000 QCdbus_system_bus
= intern (":system");
2001 staticpro (&QCdbus_system_bus
);
2003 QCdbus_session_bus
= intern (":session");
2004 staticpro (&QCdbus_session_bus
);
2006 QCdbus_timeout
= intern (":timeout");
2007 staticpro (&QCdbus_timeout
);
2009 QCdbus_type_byte
= intern (":byte");
2010 staticpro (&QCdbus_type_byte
);
2012 QCdbus_type_boolean
= intern (":boolean");
2013 staticpro (&QCdbus_type_boolean
);
2015 QCdbus_type_int16
= intern (":int16");
2016 staticpro (&QCdbus_type_int16
);
2018 QCdbus_type_uint16
= intern (":uint16");
2019 staticpro (&QCdbus_type_uint16
);
2021 QCdbus_type_int32
= intern (":int32");
2022 staticpro (&QCdbus_type_int32
);
2024 QCdbus_type_uint32
= intern (":uint32");
2025 staticpro (&QCdbus_type_uint32
);
2027 QCdbus_type_int64
= intern (":int64");
2028 staticpro (&QCdbus_type_int64
);
2030 QCdbus_type_uint64
= intern (":uint64");
2031 staticpro (&QCdbus_type_uint64
);
2033 QCdbus_type_double
= intern (":double");
2034 staticpro (&QCdbus_type_double
);
2036 QCdbus_type_string
= intern (":string");
2037 staticpro (&QCdbus_type_string
);
2039 QCdbus_type_object_path
= intern (":object-path");
2040 staticpro (&QCdbus_type_object_path
);
2042 QCdbus_type_signature
= intern (":signature");
2043 staticpro (&QCdbus_type_signature
);
2045 QCdbus_type_array
= intern (":array");
2046 staticpro (&QCdbus_type_array
);
2048 QCdbus_type_variant
= intern (":variant");
2049 staticpro (&QCdbus_type_variant
);
2051 QCdbus_type_struct
= intern (":struct");
2052 staticpro (&QCdbus_type_struct
);
2054 QCdbus_type_dict_entry
= intern (":dict-entry");
2055 staticpro (&QCdbus_type_dict_entry
);
2057 DEFVAR_LISP ("dbus-registered-functions-table",
2058 &Vdbus_registered_functions_table
,
2059 doc
: /* Hash table of registered functions for D-Bus.
2060 There are two different uses of the hash table: for calling registered
2061 functions, targeted by signals or method calls, and for calling
2062 handlers in case of non-blocking method call returns.
2064 In the first case, the key in the hash table is the list (BUS
2065 INTERFACE MEMBER). BUS is either the symbol `:system' or the symbol
2066 `:session'. INTERFACE is a string which denotes a D-Bus interface,
2067 and MEMBER, also a string, is either a method or a signal INTERFACE is
2068 offering. All arguments but BUS must not be nil.
2070 The value in the hash table is a list of quadruple lists
2071 \((UNAME SERVICE PATH HANDLER) (UNAME SERVICE PATH HANDLER) ...).
2072 SERVICE is the service name as registered, UNAME is the corresponding
2073 unique name. PATH is the object path of the sending object. All of
2074 them can be nil, which means a wildcard then. HANDLER is the function
2075 to be called when a D-Bus message, which matches the key criteria,
2078 In the second case, the key in the hash table is the list (BUS SERIAL).
2079 BUS is either the symbol `:system' or the symbol `:session'. SERIAL
2080 is the serial number of the non-blocking method call, a reply is
2081 expected. Both arguments must not be nil. The value in the hash
2082 table is HANDLER, the function to be called when the D-Bus reply
2083 message arrives. */);
2084 /* We initialize Vdbus_registered_functions_table in dbus.el,
2085 because we need to define a hash table function first. */
2086 Vdbus_registered_functions_table
= Qnil
;
2088 DEFVAR_LISP ("dbus-debug", &Vdbus_debug
,
2089 doc
: /* If non-nil, debug messages of D-Bus bindings are raised. */);
2096 Fprovide (intern ("dbusbind"), Qnil
);
2100 #endif /* HAVE_DBUS */
2102 /* arch-tag: 0e828477-b571-4fe4-b559-5c9211bc14b8
2103 (do not change this comment) */