atspi/atspi-misc.c

   1 /*
   2  * AT-SPI - Assistive Technology Service Provider Interface
   3  * (Gnome Accessibility Project; http://developer.gnome.org/projects/gap)
   4  *
   5  * Copyright 2001, 2002 Sun Microsystems Inc.,
   6  * Copyright 2001, 2002 Ximian, Inc.
   7  * Copyright 2010, 2011 Novell, Inc.
   8  *
   9  * This library is free software; you can redistribute it and/or
  10  * modify it under the terms of the GNU Library General Public
  11  * License as published by the Free Software Foundation; either
  12  * version 2 of the License, or (at your option) any later version.
  13  *
  14  * This library is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  17  * Library General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU Library General Public
  20  * License along with this library; if not, write to the
  21  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  22  * Boston, MA 02111-1307, USA.
  23  */
  24
  25 /*
  26  *
  27  * Basic SPI initialization and event loop function prototypes
  28  *
  29  */
  30
  31 #include "atspi-private.h"
  32 #include "X11/Xlib.h"
  33 #include "dbus/dbus-glib.h"
  34 #include <stdio.h>
  35 #include <string.h>
  36
  37 static void handle_get_items (DBusPendingCall *pending, void *user_data);
  38
  39 static DBusConnection *bus = NULL;
  40 static GHashTable *live_refs = NULL;
  41
  42 const char *atspi_path_dec = ATSPI_DBUS_PATH_DEC;
  43 const char *atspi_path_registry = ATSPI_DBUS_PATH_REGISTRY;
  44 const char *atspi_path_root = ATSPI_DBUS_PATH_ROOT;
  45 const char *atspi_bus_registry = ATSPI_DBUS_NAME_REGISTRY;
  46 const char *atspi_interface_accessible = ATSPI_DBUS_INTERFACE_ACCESSIBLE;
  47 const char *atspi_interface_action = ATSPI_DBUS_INTERFACE_ACTION;
  48 const char *atspi_interface_application = ATSPI_DBUS_INTERFACE_APPLICATION;
  49 const char *atspi_interface_collection = ATSPI_DBUS_INTERFACE_COLLECTION;
  50 const char *atspi_interface_component = ATSPI_DBUS_INTERFACE_COMPONENT;
  51 const char *atspi_interface_dec = ATSPI_DBUS_INTERFACE_DEC;
  52 const char *atspi_interface_device_event_listener = ATSPI_DBUS_INTERFACE_DEVICE_EVENT_LISTENER;
  53 const char *atspi_interface_document = ATSPI_DBUS_INTERFACE_DOCUMENT;
  54 const char *atspi_interface_editable_text = ATSPI_DBUS_INTERFACE_EDITABLE_TEXT;
  55 const char *atspi_interface_event_object = ATSPI_DBUS_INTERFACE_EVENT_OBJECT;
  56 const char *atspi_interface_hyperlink = ATSPI_DBUS_INTERFACE_HYPERLINK;
  57 const char *atspi_interface_hypertext = ATSPI_DBUS_INTERFACE_HYPERTEXT;
  58 const char *atspi_interface_image = ATSPI_DBUS_INTERFACE_IMAGE;
  59 const char *atspi_interface_registry = ATSPI_DBUS_INTERFACE_REGISTRY;
  60 const char *atspi_interface_selection = ATSPI_DBUS_INTERFACE_SELECTION;
  61 const char *atspi_interface_table = ATSPI_DBUS_INTERFACE_TABLE;
  62 const char *atspi_interface_text = ATSPI_DBUS_INTERFACE_TEXT;
  63 const char *atspi_interface_cache = ATSPI_DBUS_INTERFACE_CACHE;
  64 const char *atspi_interface_value = ATSPI_DBUS_INTERFACE_VALUE;
  65
  66 static const char *interfaces[] =
  67 {
  68   ATSPI_DBUS_INTERFACE_ACCESSIBLE,
  69   ATSPI_DBUS_INTERFACE_ACTION,
  70   ATSPI_DBUS_INTERFACE_APPLICATION,
  71   ATSPI_DBUS_INTERFACE_COLLECTION,
  72   ATSPI_DBUS_INTERFACE_COMPONENT,
  73   ATSPI_DBUS_INTERFACE_DOCUMENT,
  74   ATSPI_DBUS_INTERFACE_EDITABLE_TEXT,
  75   ATSPI_DBUS_INTERFACE_HYPERLINK,
  76   ATSPI_DBUS_INTERFACE_HYPERTEXT,
  77   ATSPI_DBUS_INTERFACE_IMAGE,
  78   "org.a11y.atspi.LoginHelper",
  79   ATSPI_DBUS_INTERFACE_SELECTION,
  80   ATSPI_DBUS_INTERFACE_TABLE,
  81   ATSPI_DBUS_INTERFACE_TEXT,
  82   ATSPI_DBUS_INTERFACE_VALUE,
  83   NULL
  84 };
  85
  86 gint
  87 _atspi_get_iface_num (const char *iface)
  88 {
  89   /* TODO: Use a binary search or hash to improve performance */
  90   int i;
  91
  92   for (i = 0; interfaces[i]; i++)
  93   {
  94     if (!strcmp(iface, interfaces[i])) return i;
  95   }
  96   return -1;
  97 }
  98
  99 static GHashTable *
 100 get_live_refs (void)
 101 {
 102   if (!live_refs)
 103     {
 104       live_refs = g_hash_table_new (g_direct_hash, g_direct_equal);
 105     }
 106   return live_refs;
 107 }
 108
 109 /* TODO: Add an application parameter */
 110 DBusConnection *
 111 _atspi_bus ()
 112 {
 113   if (!bus)
 114     atspi_init ();
 115   return bus;
 116 }
 117
 118 #define APP_IS_REGISTRY(app) (!strcmp (app->bus_name, atspi_bus_registry))
 119
 120 static void
 121 cleanup ()
 122 {
 123   GHashTable *refs;
 124
 125   refs = live_refs;
 126   live_refs = NULL;
 127   if (refs)
 128     {
 129       g_hash_table_destroy (refs);
 130     }
 131 }
 132
 133 static gboolean atspi_inited = FALSE;
 134
 135 static GHashTable *app_hash = NULL;
 136
 137 static void
 138 handle_get_bus_address (DBusPendingCall *pending, void *user_data)
 139 {
 140   AtspiApplication *app = user_data;
 141   DBusMessage *reply = dbus_pending_call_steal_reply (pending);
 142   DBusMessage *message;
 143   const char *address;
 144   DBusPendingCall *new_pending;
 145
 146   if (dbus_message_get_type (reply) == DBUS_MESSAGE_TYPE_METHOD_RETURN)
 147   {
 148     if (dbus_message_get_args (reply, NULL, DBUS_TYPE_STRING, &address,
 149                                DBUS_TYPE_INVALID))
 150     {
 151       DBusError error;
 152       dbus_error_init (&error);
 153       DBusConnection *bus = dbus_connection_open (address, &error);
 154       if (bus)
 155       {
 156         if (app->bus)
 157           dbus_connection_unref (app->bus);
 158         app->bus = bus;
 159       }
 160     }
 161   }
 162   dbus_message_unref (reply);
 163   dbus_pending_call_unref (pending);
 164
 165   message = dbus_message_new_method_call (app->bus_name,
 166                                           "/org/a11y/atspi/cache",
 167                                           atspi_interface_cache, "GetItems");
 168
 169    dbus_connection_send_with_reply (app->bus, message, &new_pending, 2000);
 170   dbus_pending_call_set_notify (new_pending, handle_get_items, app, NULL);
 171   dbus_message_unref (message);
 172 }
 173
 174 static AtspiApplication *
 175 get_application (const char *bus_name)
 176 {
 177   AtspiApplication *app = NULL;
 178   char *bus_name_dup;
 179   DBusMessage *message;
 180   DBusError error;
 181   DBusPendingCall *pending = NULL;
 182
 183   if (!app_hash)
 184   {
 185     app_hash = g_hash_table_new_full (g_str_hash, g_str_equal, g_free, (GDestroyNotify)g_object_unref);
 186     if (!app_hash) return NULL;
 187   }
 188   app = g_hash_table_lookup (app_hash, bus_name);
 189   if (app) return app;
 190   bus_name_dup = g_strdup (bus_name);
 191   if (!bus_name_dup) return NULL;
 192   // TODO: change below to something that will send state-change:defunct notification if necessary */
 193   app = _atspi_application_new (bus_name);
 194   if (!app) return NULL;
 195   app->hash = g_hash_table_new_full (g_str_hash, g_str_equal, g_free, g_object_unref);
 196   app->bus = dbus_connection_ref (_atspi_bus ());
 197   app->cache = ATSPI_CACHE_UNDEFINED;
 198   g_hash_table_insert (app_hash, bus_name_dup, app);
 199   dbus_error_init (&error);
 200   message = dbus_message_new_method_call (bus_name, atspi_path_root,
 201                                           atspi_interface_application, "GetApplicationBusAddress");
 202
 203    dbus_connection_send_with_reply (app->bus, message, &pending, 2000);
 204   dbus_pending_call_set_notify (pending, handle_get_bus_address, app, NULL);
 205   dbus_message_unref (message);
 206   return app;
 207 }
 208
 209 static AtspiAccessible *
 210 ref_accessible (const char *app_name, const char *path)
 211 {
 212   AtspiApplication *app;
 213   AtspiAccessible *a;
 214
 215   if (!strcmp (path, ATSPI_DBUS_PATH_NULL))
 216     return NULL;
 217
 218   app = get_application (app_name);
 219
 220   if (!strcmp (path, "/org/a11y/atspi/accessible/root"))
 221   {
 222     if (!app->root)
 223     {
 224       app->root = atspi_accessible_new (app, atspi_path_root);
 225       app->root->accessible_parent = atspi_get_desktop (0);
 226     }
 227     return g_object_ref (app->root);
 228   }
 229
 230   a = g_hash_table_lookup (app->hash, path);
 231   if (a)
 232   {
 233     return g_object_ref (a);
 234   }
 235   a = atspi_accessible_new (app, path);
 236   if (!a)
 237     return NULL;
 238   g_hash_table_insert (app->hash, g_strdup (a->parent.path), a);
 239   g_object_ref (a);     /* for the hash */
 240   return a;
 241 }
 242
 243 static AtspiHyperlink *
 244 ref_hyperlink (const char *app_name, const char *path)
 245 {
 246   AtspiApplication *app = get_application (app_name);
 247   AtspiHyperlink *hyperlink;
 248
 249   if (!strcmp (path, ATSPI_DBUS_PATH_NULL))
 250     return NULL;
 251
 252   hyperlink = g_hash_table_lookup (app->hash, path);
 253   if (hyperlink)
 254   {
 255     return g_object_ref (hyperlink);
 256   }
 257   hyperlink = atspi_hyperlink_new (app, path);
 258   if (!hyperlink)
 259     return NULL;
 260   g_hash_table_insert (app->hash, g_strdup (hyperlink->parent.path), hyperlink);
 261   /* TODO: This should be a weak ref */
 262   g_object_ref (hyperlink);     /* for the hash */
 263   return hyperlink;
 264 }
 265
 266 typedef struct
 267 {
 268   char *path;
 269   char *parent;
 270   GArray *children;
 271   GArray *interfaces;
 272   char *name;
 273   dbus_uint32_t role;
 274   char *description;
 275   GArray *state_bitflags;
 276 } CACHE_ADDITION;
 277
 278 static DBusHandlerResult
 279 handle_remove_accessible (DBusConnection *bus, DBusMessage *message, void *user_data)
 280 {
 281   const char *sender = dbus_message_get_sender (message);
 282   AtspiApplication *app;
 283   const char *path;
 284   DBusMessageIter iter, iter_struct;
 285   const char *signature = dbus_message_get_signature (message);
 286   AtspiAccessible *a;
 287
 288   if (strcmp (signature, "(so)") != 0)
 289   {
 290     g_warning (_("AT-SPI: Unknown signature %s for RemoveAccessible"), signature);
 291     return DBUS_HANDLER_RESULT_HANDLED;
 292   }
 293
 294   dbus_message_iter_init (message, &iter);
 295   dbus_message_iter_recurse (&iter, &iter_struct);
 296   dbus_message_iter_get_basic (&iter_struct, &sender);
 297   dbus_message_iter_next (&iter_struct);
 298   dbus_message_iter_get_basic (&iter_struct, &path);
 299   app = get_application (sender);
 300   a = ref_accessible (sender, path);
 301   if (!a)
 302     return DBUS_HANDLER_RESULT_HANDLED;
 303   g_object_run_dispose (G_OBJECT (a));
 304   g_hash_table_remove (app->hash, a->parent.path);
 305   g_object_unref (a);   /* unref our own ref */
 306   return DBUS_HANDLER_RESULT_HANDLED;
 307 }
 308
 309 static gboolean
 310 add_app_to_desktop (AtspiAccessible *a, const char *bus_name)
 311 {
 312   DBusError error;
 313
 314   dbus_error_init (&error);
 315   AtspiAccessible *obj = ref_accessible (bus_name, atspi_path_root);
 316   if (obj)
 317   {
 318     GList *new_list = g_list_append (a->children, obj);
 319     if (new_list)
 320     {
 321       a->children = new_list;
 322       return TRUE;
 323     }
 324   }
 325   else
 326   {
 327     g_warning (_("AT-SPI: Error calling getRoot for %s: %s"), bus_name, error.message);
 328   }
 329   return FALSE;
 330 }
 331
 332 static void
 333 send_children_changed (AtspiAccessible *parent, AtspiAccessible *child, gboolean add)
 334 {
 335   AtspiEvent e;
 336
 337   memset (&e, 0, sizeof (e));
 338   e.type = (add? "object:children-changed:add": "object:children-changed:remove");
 339   e.source = parent;
 340   e.detail1 = g_list_index (parent->children, child);
 341   e.detail2 = 0;
 342   _atspi_send_event (&e);
 343 }
 344
 345 static void
 346 unref_object_and_descendants (AtspiAccessible *obj)
 347 {
 348   GList *l;
 349
 350   for (l = obj->children; l; l = l->next)
 351   {
 352     unref_object_and_descendants (l->data);
 353   }
 354   g_object_unref (obj);
 355 }
 356
 357 static gboolean
 358 remove_app_from_desktop (AtspiAccessible *a, const char *bus_name)
 359 {
 360   GList *l;
 361   AtspiAccessible *child;
 362
 363   for (l = a->children; l; l = l->next)
 364   {
 365     child = l->data;
 366     if (!strcmp (bus_name, child->parent.app->bus_name)) break;
 367   }
 368   if (!l)
 369   {
 370     return FALSE;
 371   }
 372   send_children_changed (a, child, FALSE);
 373   a->children = g_list_remove (a->children, child);
 374   unref_object_and_descendants (child);
 375   return TRUE;
 376 }
 377
 378 static AtspiAccessible *desktop;
 379
 380 void
 381 get_reference_from_iter (DBusMessageIter *iter, const char **app_name, const char **path)
 382 {
 383   DBusMessageIter iter_struct;
 384
 385   dbus_message_iter_recurse (iter, &iter_struct);
 386   dbus_message_iter_get_basic (&iter_struct, app_name);
 387   dbus_message_iter_next (&iter_struct);
 388   dbus_message_iter_get_basic (&iter_struct, path);
 389   dbus_message_iter_next (iter);
 390 }
 391
 392 static void
 393 add_accessible_from_iter (DBusMessageIter *iter)
 394 {
 395   GList *new_list;
 396   DBusMessageIter iter_struct, iter_array;
 397   const char *app_name, *path;
 398   AtspiAccessible *accessible;
 399   const char *name, *description;
 400   dbus_uint32_t role;
 401
 402   dbus_message_iter_recurse (iter, &iter_struct);
 403
 404   /* get accessible */
 405   get_reference_from_iter (&iter_struct, &app_name, &path);
 406   accessible = ref_accessible (app_name, path);
 407   if (!accessible)
 408     return;
 409
 410   /* Get application: TODO */
 411   dbus_message_iter_next (&iter_struct);
 412
 413   /* get parent */
 414   get_reference_from_iter (&iter_struct, &app_name, &path);
 415   if (accessible->accessible_parent)
 416     g_object_unref (accessible->accessible_parent);
 417   accessible->accessible_parent = ref_accessible (app_name, path);
 418
 419   /* Get children */
 420   while (accessible->children)
 421   {
 422     g_object_unref (accessible->children->data);
 423     accessible->children = g_list_remove (accessible->children, accessible->children->data);
 424   }
 425   dbus_message_iter_recurse (&iter_struct, &iter_array);
 426   while (dbus_message_iter_get_arg_type (&iter_array) != DBUS_TYPE_INVALID)
 427   {
 428     AtspiAccessible *child;
 429     get_reference_from_iter (&iter_array, &app_name, &path);
 430     child = ref_accessible (app_name, path);
 431     new_list = g_list_append (accessible->children, child);
 432     if (new_list) accessible->children = new_list;
 433   }
 434
 435   /* interfaces */
 436   dbus_message_iter_next (&iter_struct);
 437   _atspi_dbus_set_interfaces (accessible, &iter_struct);
 438   dbus_message_iter_next (&iter_struct);
 439
 440   /* name */
 441   if (accessible->name)
 442     g_free (accessible->name);
 443   dbus_message_iter_get_basic (&iter_struct, &name);
 444   accessible->name = g_strdup (name);
 445   dbus_message_iter_next (&iter_struct);
 446
 447   /* role */
 448   dbus_message_iter_get_basic (&iter_struct, &role);
 449   accessible->role = role;
 450   dbus_message_iter_next (&iter_struct);
 451
 452   /* description */
 453   if (accessible->description)
 454     g_free (accessible->description);
 455   dbus_message_iter_get_basic (&iter_struct, &description);
 456   accessible->description = g_strdup (description);
 457   dbus_message_iter_next (&iter_struct);
 458
 459   _atspi_dbus_set_state (accessible, &iter_struct);
 460   dbus_message_iter_next (&iter_struct);
 461
 462   _atspi_accessible_add_cache (accessible, ATSPI_CACHE_NAME | ATSPI_CACHE_ROLE |
 463                                ATSPI_CACHE_PARENT | ATSPI_CACHE_DESCRIPTION);
 464   if (!atspi_state_set_contains (accessible->states,
 465                                        ATSPI_STATE_MANAGES_DESCENDANTS))
 466     _atspi_accessible_add_cache (accessible, ATSPI_CACHE_CHILDREN);
 467
 468   /* This is a bit of a hack since the cache holds a ref, so we don't need
 469    * the one provided for us anymore */
 470   g_object_unref (accessible);
 471 }
 472
 473 static void
 474 handle_get_items (DBusPendingCall *pending, void *user_data)
 475 {
 476   DBusMessage *reply = dbus_pending_call_steal_reply (pending);
 477   DBusMessageIter iter, iter_array;
 478
 479   if (dbus_message_get_type (reply) == DBUS_MESSAGE_TYPE_ERROR)
 480   {
 481     const char *sender = dbus_message_get_sender (reply);
 482     const char *error = NULL;
 483     dbus_message_get_args (reply, NULL, DBUS_TYPE_STRING, &error,
 484                            DBUS_TYPE_INVALID);
 485     g_warning (_("AT-SPI: Error in GetItems, sender=%s, error=%s"), sender, error);
 486     dbus_message_unref (reply);
 487     dbus_pending_call_unref (pending);
 488     return;
 489   }
 490
 491   dbus_message_iter_init (reply, &iter);
 492   dbus_message_iter_recurse (&iter, &iter_array);
 493   while (dbus_message_iter_get_arg_type (&iter_array) != DBUS_TYPE_INVALID)
 494   {
 495     add_accessible_from_iter (&iter_array);
 496     dbus_message_iter_next (&iter_array);
 497   }
 498   dbus_message_unref (reply);
 499   dbus_pending_call_unref (pending);
 500 }
 501
 502 /* TODO: Do we stil need this function? */
 503 static AtspiAccessible *
 504 ref_accessible_desktop (AtspiApplication *app)
 505 {
 506   DBusError error;
 507   DBusMessage *message, *reply;
 508   DBusMessageIter iter, iter_array;
 509   gchar *bus_name_dup;
 510
 511   if (desktop)
 512   {
 513     g_object_ref (desktop);
 514     return desktop;
 515   }
 516   desktop = atspi_accessible_new (app, atspi_path_root);
 517   if (!desktop)
 518   {
 519     return NULL;
 520   }
 521   g_hash_table_insert (app->hash, desktop->parent.path, desktop);
 522   g_object_ref (desktop);       /* for the hash */
 523   desktop->name = g_strdup ("main");
 524   dbus_error_init (&error);
 525   message = dbus_message_new_method_call (atspi_bus_registry,
 526         atspi_path_root,
 527         atspi_interface_accessible,
 528         "GetChildren");
 529   if (!message)
 530     return NULL;
 531   reply = _atspi_dbus_send_with_reply_and_block (message, NULL);
 532   if (!reply || strcmp (dbus_message_get_signature (reply), "a(so)") != 0)
 533   {
 534     g_warning ("Couldn't get application list: %s", error.message);
 535     if (reply)
 536       dbus_message_unref (reply);
 537     return NULL;
 538   }
 539   dbus_message_iter_init (reply, &iter);
 540   dbus_message_iter_recurse (&iter, &iter_array);
 541   while (dbus_message_iter_get_arg_type (&iter_array) != DBUS_TYPE_INVALID)
 542   {
 543     const char *app_name, *path;
 544     get_reference_from_iter (&iter_array, &app_name, &path);
 545     add_app_to_desktop (desktop, app_name);
 546   }
 547   dbus_message_unref (reply);
 548
 549   /* Record the alternate name as an alias for org.a11y.atspi.Registry */
 550   bus_name_dup = g_strdup (dbus_message_get_sender (reply));
 551   if (bus_name_dup)
 552     g_hash_table_insert (app_hash, bus_name_dup, app);
 553
 554   return desktop;
 555 }
 556
 557 AtspiAccessible *
 558 _atspi_ref_accessible (const char *app, const char *path)
 559 {
 560   AtspiApplication *a = get_application (app);
 561   if (!a) return NULL;
 562   if ( APP_IS_REGISTRY(a))
 563   {
 564     return a->root = ref_accessible_desktop (a);
 565   }
 566   return ref_accessible (app, path);
 567 }
 568
 569 AtspiAccessible *
 570 _atspi_dbus_return_accessible_from_message (DBusMessage *message)
 571 {
 572   DBusMessageIter iter;
 573   AtspiAccessible *retval = NULL;
 574   const char *signature;
 575
 576   if (!message)
 577     return NULL;
 578
 579   signature = dbus_message_get_signature (message);
 580   if (!strcmp (signature, "(so)"))
 581   {
 582     dbus_message_iter_init (message, &iter);
 583     retval =  _atspi_dbus_return_accessible_from_iter (&iter);
 584   }
 585   else
 586   {
 587     g_warning (_("AT-SPI: Called _atspi_dbus_return_accessible_from_message with strange signature %s"), signature);
 588   }
 589   dbus_message_unref (message);
 590   return retval;
 591 }
 592
 593 AtspiAccessible *
 594 _atspi_dbus_return_accessible_from_iter (DBusMessageIter *iter)
 595 {
 596   const char *app_name, *path;
 597
 598   get_reference_from_iter (iter, &app_name, &path);
 599   return ref_accessible (app_name, path);
 600 }
 601
 602 AtspiHyperlink *
 603 _atspi_dbus_return_hyperlink_from_message (DBusMessage *message)
 604 {
 605   DBusMessageIter iter;
 606   AtspiHyperlink *retval = NULL;
 607   const char *signature = dbus_message_get_signature (message);
 608
 609   if (!strcmp (signature, "(so)"))
 610   {
 611     dbus_message_iter_init (message, &iter);
 612     retval =  _atspi_dbus_return_hyperlink_from_iter (&iter);
 613   }
 614   else
 615   {
 616     g_warning (_("AT-SPI: Called _atspi_dbus_return_hyperlink_from_message with strange signature %s"), signature);
 617   }
 618   dbus_message_unref (message);
 619   return retval;
 620 }
 621
 622 AtspiHyperlink *
 623 _atspi_dbus_return_hyperlink_from_iter (DBusMessageIter *iter)
 624 {
 625   const char *app_name, *path;
 626
 627   get_reference_from_iter (iter, &app_name, &path);
 628   return ref_hyperlink (app_name, path);
 629 }
 630
 631 const char *cache_signal_type = "((so)(so)(so)a(so)assusau)";
 632
 633 static DBusHandlerResult
 634 handle_add_accessible (DBusConnection *bus, DBusMessage *message, void *user_data)
 635 {
 636   DBusMessageIter iter;
 637   const char *sender = dbus_message_get_sender (message);
 638
 639   if (strcmp (dbus_message_get_signature (message), cache_signal_type) != 0)
 640   {
 641     g_warning (_("AT-SPI: AddAccessible with unknown signature %s\n"),
 642                dbus_message_get_signature (message));
 643     return DBUS_HANDLER_RESULT_HANDLED;
 644   }
 645
 646   dbus_message_iter_init (message, &iter);
 647   add_accessible_from_iter (&iter);
 648   return DBUS_HANDLER_RESULT_HANDLED;
 649 }
 650
 651 typedef struct
 652 {
 653   DBusConnection *bus;
 654   DBusMessage *message;
 655   void *data;
 656 } BusDataClosure;
 657
 658 static guint process_deferred_messages_id = -1;
 659
 660 static void
 661 process_deferred_message (BusDataClosure *closure)
 662 {
 663   int type = dbus_message_get_type (closure->message);
 664   const char *interface = dbus_message_get_interface (closure->message);
 665
 666   if (type == DBUS_MESSAGE_TYPE_SIGNAL &&
 667       !strncmp (interface, "org.a11y.atspi.Event.", 21))
 668   {
 669     atspi_dbus_handle_event (closure->bus, closure->message, closure->data);
 670   }
 671   if (dbus_message_is_method_call (closure->message, atspi_interface_device_event_listener, "NotifyEvent"))
 672   {
 673     atspi_dbus_handle_DeviceEvent (closure->bus,
 674                                    closure->message, closure->data);
 675   }
 676   if (dbus_message_is_signal (closure->message, atspi_interface_cache, "AddAccessible"))
 677   {
 678     handle_add_accessible (closure->bus, closure->message, closure->data);
 679   }
 680   if (dbus_message_is_signal (closure->message, atspi_interface_cache, "RemoveAccessible"))
 681   {
 682     handle_remove_accessible (closure->bus, closure->message, closure->data);
 683   }
 684 }
 685
 686 static GList *deferred_messages = NULL;
 687
 688 gboolean
 689 _atspi_process_deferred_messages (gpointer data)
 690 {
 691   static int in_process_deferred_messages = 0;
 692
 693   if (in_process_deferred_messages)
 694     return TRUE;
 695   in_process_deferred_messages = 1;
 696   while (deferred_messages != NULL)
 697   {
 698     BusDataClosure *closure = deferred_messages->data;
 699     process_deferred_message (closure);
 700     deferred_messages = g_list_remove (deferred_messages, closure);
 701     dbus_message_unref (closure->message);
 702     dbus_connection_unref (closure->bus);
 703     g_free (closure);
 704   }
 705   /* If data is NULL, assume that we were called from GLib */
 706   if (!data)
 707     process_deferred_messages_id = -1;
 708   in_process_deferred_messages = 0;
 709   return FALSE;
 710 }
 711
 712 static DBusHandlerResult
 713 defer_message (DBusConnection *connection, DBusMessage *message, void *user_data)
 714 {
 715   BusDataClosure *closure = g_new (BusDataClosure, 1);
 716   GList *new_list;
 717
 718   if (!closure)
 719     return DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
 720   closure->bus = dbus_connection_ref (bus);
 721   closure->message = dbus_message_ref (message);
 722   closure->data = user_data;
 723
 724   new_list = g_list_append (deferred_messages, closure);
 725   if (new_list)
 726     deferred_messages = new_list;
 727
 728   if (process_deferred_messages_id == -1)
 729     process_deferred_messages_id = g_idle_add (_atspi_process_deferred_messages, NULL);
 730   return DBUS_HANDLER_RESULT_HANDLED;
 731 }
 732
 733 static DBusHandlerResult
 734 atspi_dbus_filter (DBusConnection *bus, DBusMessage *message, void *data)
 735 {
 736   int type = dbus_message_get_type (message);
 737   const char *interface = dbus_message_get_interface (message);
 738
 739   if (type == DBUS_MESSAGE_TYPE_SIGNAL &&
 740       !strncmp (interface, "org.a11y.atspi.Event.", 21))
 741   {
 742     return defer_message (bus, message, data);
 743   }
 744   if (dbus_message_is_method_call (message, atspi_interface_device_event_listener, "NotifyEvent"))
 745   {
 746     return defer_message (bus, message, data);
 747   }
 748   if (dbus_message_is_signal (message, atspi_interface_cache, "AddAccessible"))
 749   {
 750     return defer_message (bus, message, data);
 751   }
 752   if (dbus_message_is_signal (message, atspi_interface_cache, "RemoveAccessible"))
 753   {
 754     return defer_message (bus, message, data);
 755   }
 756   return DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
 757 }
 758
 759 static const char *signal_interfaces[] =
 760 {
 761   "org.a11y.atspi.Event.Object",
 762   "org.a11y.atspi.Event.Window",
 763   "org.a11y.atspi.Event.Mouse",
 764   "org.a11y.atspi.Event.Terminal",
 765   "org.a11y.atspi.Event.Document",
 766   "org.a11y.atspi.Event.Focus",
 767   NULL
 768 };
 769
 770 /*
 771  * Returns a 'canonicalized' value for DISPLAY,
 772  * with the screen number stripped off if present.
 773  *
 774  * TODO: Avoid having duplicate functions for this here and in at-spi2-atk
 775  */
 776 static const gchar *
 777 spi_display_name (void)
 778 {
 779   static const char *canonical_display_name = NULL;
 780   if (!canonical_display_name)
 781     {
 782       const gchar *display_env = g_getenv ("AT_SPI_DISPLAY");
 783       if (!display_env)
 784         {
 785           display_env = g_getenv ("DISPLAY");
 786           if (!display_env || !display_env[0])
 787             canonical_display_name = ":0";
 788           else
 789             {
 790               gchar *display_p, *screen_p;
 791               canonical_display_name = g_strdup (display_env);
 792               display_p = g_utf8_strrchr (canonical_display_name, -1, ':');
 793               screen_p = g_utf8_strrchr (canonical_display_name, -1, '.');
 794               if (screen_p && display_p && (screen_p > display_p))
 795                 {
 796                   *screen_p = '\0';
 797                 }
 798             }
 799         }
 800       else
 801         {
 802           canonical_display_name = display_env;
 803         }
 804     }
 805   return canonical_display_name;
 806 }
 807
 808 /**
 809  * atspi_init:
 810  *
 811  * Connects to the accessibility registry and initializes the SPI.
 812  *
 813  * Returns: 0 on success, otherwise an integer error code.
 814  **/
 815 int
 816 atspi_init (void)
 817 {
 818   DBusError error;
 819   char *match;
 820
 821   if (atspi_inited)
 822     {
 823       return 1;
 824     }
 825
 826   atspi_inited = TRUE;
 827
 828   g_type_init ();
 829
 830   get_live_refs();
 831
 832   dbus_error_init (&error);
 833   bus = atspi_get_a11y_bus ();
 834   if (!bus)
 835     return 2;
 836   dbus_bus_register (bus, &error);
 837   dbus_connection_setup_with_g_main(bus, g_main_context_default());
 838   dbus_connection_add_filter (bus, atspi_dbus_filter, NULL, NULL);
 839   dbind_set_timeout (1000);
 840   match = g_strdup_printf ("type='signal',interface='%s',member='AddAccessible'", atspi_interface_cache);
 841   dbus_error_init (&error);
 842   dbus_bus_add_match (bus, match, &error);
 843   g_free (match);
 844   match = g_strdup_printf ("type='signal',interface='%s',member='RemoveAccessible'", atspi_interface_cache);
 845   dbus_bus_add_match (bus, match, &error);
 846   g_free (match);
 847   match = g_strdup_printf ("type='signal',interface='%s',member='ChildrenChanged'", atspi_interface_event_object);
 848   dbus_bus_add_match (bus, match, &error);
 849   g_free (match);
 850   match = g_strdup_printf ("type='signal',interface='%s',member='PropertyChange'", atspi_interface_event_object);
 851   dbus_bus_add_match (bus, match, &error);
 852   g_free (match);
 853   match = g_strdup_printf ("type='signal',interface='%s',member='StateChanged'", atspi_interface_event_object);
 854   dbus_bus_add_match (bus, match, &error);
 855   g_free (match);
 856   return 0;
 857 }
 858
 859   static GMainLoop *mainloop;
 860
 861 /**
 862  * atspi_event_main:
 863  *
 864  * Starts/enters the main event loop for the AT-SPI services.
 865  *
 866  * (NOTE: This method does not return control, it is exited via a call to
 867  *  atspi_event_quit () from within an event handler).
 868  *
 869  **/
 870 void
 871 atspi_event_main (void)
 872 {
 873   mainloop = g_main_loop_new (NULL, FALSE);
 874   g_main_loop_run (mainloop);
 875 }
 876
 877 /**
 878  * atspi_event_quit:
 879  *
 880  * Quits the last main event loop for the SPI services,
 881  * see atspi_event_main
 882  **/
 883 void
 884 atspi_event_quit (void)
 885 {
 886   g_main_loop_quit (mainloop);
 887 }
 888
 889 /**
 890  * atspi_exit:
 891  *
 892  * Disconnects from the Accessibility Registry and releases
 893  * any floating resources. Call only once at exit.
 894  *
 895  * Returns: 0 if there were no leaks, otherwise non zero.
 896  **/
 897 int
 898 atspi_exit (void)
 899 {
 900   int leaked;
 901
 902   if (!atspi_inited)
 903     {
 904       return 0;
 905     }
 906
 907   atspi_inited = FALSE;
 908
 909   if (live_refs)
 910     {
 911       leaked = g_hash_table_size (live_refs);
 912     }
 913   else
 914     {
 915       leaked = 0;
 916     }
 917
 918   cleanup ();
 919
 920   return leaked;
 921 }
 922
 923 dbus_bool_t
 924 _atspi_dbus_call (gpointer obj, const char *interface, const char *method, GError **error, const char *type, ...)
 925 {
 926   va_list args;
 927   dbus_bool_t retval;
 928   DBusError err;
 929   AtspiObject *aobj = ATSPI_OBJECT (obj);
 930
 931   if (!aobj->app || !aobj->app->bus)
 932   {
 933     g_set_error_literal (error, ATSPI_ERROR, ATSPI_ERROR_APPLICATION_GONE,
 934                           _("The application no longer exists"));
 935     return FALSE;
 936   }
 937
 938   va_start (args, type);
 939   dbus_error_init (&err);
 940   retval = dbind_method_call_reentrant_va (aobj->app->bus, aobj->app->bus_name,
 941                                            aobj->path, interface, method, &err,
 942                                            type, args);
 943   va_end (args);
 944   _atspi_process_deferred_messages ((gpointer)TRUE);
 945   if (dbus_error_is_set (&err))
 946   {
 947     /* TODO: Set gerror */
 948     dbus_error_free (&err);
 949   }
 950   return retval;
 951 }
 952
 953 DBusMessage *
 954 _atspi_dbus_call_partial (gpointer obj,
 955                           const char *interface,
 956                           const char *method,
 957                           GError **error,
 958                           const char *type, ...)
 959 {
 960   va_list args;
 961
 962   va_start (args, type);
 963   return _atspi_dbus_call_partial_va (obj, interface, method, error, type, args);
 964 }
 965
 966 DBusMessage *
 967 _atspi_dbus_call_partial_va (gpointer obj,
 968                           const char *interface,
 969                           const char *method,
 970                           GError **error,
 971                           const char *type,
 972                           va_list args)
 973 {
 974   AtspiObject *aobj = ATSPI_OBJECT (obj);
 975   DBusError err;
 976     DBusMessage *msg = NULL, *reply = NULL;
 977     DBusMessageIter iter;
 978     const char *p;
 979
 980   dbus_error_init (&err);
 981
 982   if (!aobj->app || !aobj->app->bus)
 983   {
 984     g_set_error_literal (error, ATSPI_ERROR, ATSPI_ERROR_APPLICATION_GONE,
 985                           _("The application no longer exists"));
 986     goto out;
 987   }
 988
 989     msg = dbus_message_new_method_call (aobj->app->bus_name, aobj->path, interface, method);
 990     if (!msg)
 991         goto out;
 992
 993     p = type;
 994     dbus_message_iter_init_append (msg, &iter);
 995     dbind_any_marshal_va (&iter, &p, args);
 996
 997     reply = dbind_send_and_allow_reentry (aobj->app->bus, msg, &err);
 998 out:
 999   va_end (args);
1000   if (msg)
1001     dbus_message_unref (msg);
1002   _atspi_process_deferred_messages ((gpointer)TRUE);
1003   if (dbus_error_is_set (&err))
1004   {
1005     /* TODO: Set gerror */
1006     dbus_error_free (&err);
1007   }
1008   return reply;
1009 }
1010
1011 dbus_bool_t
1012 _atspi_dbus_get_property (gpointer obj, const char *interface, const char *name, GError **error, const char *type, void *data)
1013 {
1014   DBusMessage *message, *reply;
1015   DBusMessageIter iter, iter_variant;
1016   DBusError err;
1017   dbus_bool_t retval = FALSE;
1018   AtspiObject *aobj = ATSPI_OBJECT (obj);
1019
1020   if (!aobj)
1021     return FALSE;
1022
1023   if (!aobj->app || !aobj->app->bus)
1024   {
1025     g_set_error_literal (error, ATSPI_ERROR, ATSPI_ERROR_APPLICATION_GONE,
1026                           _("The application no longer exists"));
1027     return FALSE;
1028   }
1029
1030   message = dbus_message_new_method_call (aobj->app->bus_name,
1031                                           aobj->path,
1032                                           "org.freedesktop.DBus.Properties",
1033                                           "Get");
1034   if (!message)
1035   {
1036     // TODO: throw exception
1037     return FALSE;
1038   }
1039   dbus_message_append_args (message, DBUS_TYPE_STRING, &interface, DBUS_TYPE_STRING, &name, DBUS_TYPE_INVALID);
1040   dbus_error_init (&err);
1041   reply = dbind_send_and_allow_reentry (aobj->app->bus, message, &err);
1042   dbus_message_unref (message);
1043   _atspi_process_deferred_messages ((gpointer)TRUE);
1044   if (!reply)
1045   {
1046     // TODO: throw exception
1047     goto done;
1048   }
1049
1050   if (dbus_message_get_type (reply) == DBUS_MESSAGE_TYPE_ERROR)
1051   {
1052     const char *err;
1053     dbus_message_get_args (message, NULL, DBUS_TYPE_STRING, &err, DBUS_TYPE_INVALID);
1054     if (err)
1055       g_set_error_literal (error, ATSPI_ERROR, ATSPI_ERROR_IPC, err);
1056     goto done;
1057   }
1058
1059   dbus_message_iter_init (reply, &iter);
1060   if (dbus_message_iter_get_arg_type (&iter) != 'v')
1061   {
1062     g_warning (_("AT-SPI: expected a variant when fetching %s from interface %s; got %s\n"), name, interface, dbus_message_get_signature (reply));
1063     goto done;
1064   }
1065   dbus_message_iter_recurse (&iter, &iter_variant);
1066   if (dbus_message_iter_get_arg_type (&iter_variant) != type[0])
1067   {
1068     g_warning (_("atspi_dbus_get_property: Wrong type: expected %s, got %c\n"), type, dbus_message_iter_get_arg_type (&iter_variant));
1069     goto done;
1070   }
1071   if (!strcmp (type, "(so)"))
1072   {
1073     *((AtspiAccessible **)data) = _atspi_dbus_return_accessible_from_iter (&iter_variant);
1074   }
1075   else
1076   {
1077     dbus_message_iter_get_basic (&iter_variant, data);
1078     if (type [0] == 's')
1079       *(char **)data = g_strdup (*(char **)data);
1080   }
1081   retval = TRUE;
1082 done:
1083   if (reply)
1084     dbus_message_unref (reply);
1085   return retval;
1086 }
1087
1088 DBusMessage *
1089 _atspi_dbus_send_with_reply_and_block (DBusMessage *message, GError **error)
1090 {
1091   DBusMessage *reply;
1092   DBusError err;
1093   AtspiApplication *app;
1094   DBusConnection *bus;
1095
1096   app = get_application (dbus_message_get_destination (message));
1097
1098   if (app && !app->bus)
1099     return NULL;        /* will fail anyway; app has been disposed */
1100
1101   bus = (app ? app->bus : _atspi_bus());
1102   dbus_error_init (&err);
1103   reply = dbind_send_and_allow_reentry (bus, message, &err);
1104   _atspi_process_deferred_messages ((gpointer)TRUE);
1105   dbus_message_unref (message);
1106   if (err.message)
1107   {
1108     if (error)
1109       g_set_error_literal (error, ATSPI_ERROR, ATSPI_ERROR_IPC, err.message);
1110     dbus_error_free (&err);
1111   }
1112   return reply;
1113 }
1114
1115 GHashTable *
1116 _atspi_dbus_return_hash_from_message (DBusMessage *message)
1117 {
1118   DBusMessageIter iter;
1119   GHashTable *ret;
1120
1121   if (!message)
1122     return NULL;
1123
1124   _ATSPI_DBUS_CHECK_SIG (message, "a{ss}", NULL, NULL);
1125
1126   dbus_message_iter_init (message, &iter);
1127   ret = _atspi_dbus_hash_from_iter (&iter);
1128   dbus_message_unref (message);
1129   return ret;
1130 }
1131
1132 GHashTable *
1133 _atspi_dbus_hash_from_iter (DBusMessageIter *iter)
1134 {
1135   GHashTable *hash = g_hash_table_new (g_str_hash, g_str_equal);
1136   DBusMessageIter iter_array, iter_dict;
1137
1138   dbus_message_iter_recurse (iter, &iter_array);
1139   while (dbus_message_iter_get_arg_type (&iter_array) != DBUS_TYPE_INVALID)
1140   {
1141     const char *name, *value;
1142     dbus_message_iter_recurse (&iter_array, &iter_dict);
1143     dbus_message_iter_get_basic (&iter_dict, &name);
1144     dbus_message_iter_next (&iter_dict);
1145     dbus_message_iter_get_basic (&iter_dict, &value);
1146     g_hash_table_insert (hash, g_strdup (name), g_strdup (value));
1147     dbus_message_iter_next (&iter_array);
1148   }
1149   return hash;
1150 }
1151
1152 GArray *
1153 _atspi_dbus_return_attribute_array_from_message (DBusMessage *message)
1154 {
1155   DBusMessageIter iter;
1156   GArray *ret;
1157
1158   if (!message)
1159     return NULL;
1160
1161   _ATSPI_DBUS_CHECK_SIG (message, "a{ss}", NULL, NULL);
1162
1163   dbus_message_iter_init (message, &iter);
1164
1165   ret = _atspi_dbus_attribute_array_from_iter (&iter);
1166   dbus_message_unref (message);
1167   return ret;
1168 }
1169
1170 GArray *
1171 _atspi_dbus_attribute_array_from_iter (DBusMessageIter *iter)
1172 {
1173   DBusMessageIter iter_array, iter_dict;
1174   GArray *array = g_array_new (TRUE, TRUE, sizeof (gchar *));
1175
1176   dbus_message_iter_recurse (iter, &iter_array);
1177   while (dbus_message_iter_get_arg_type (&iter_array) != DBUS_TYPE_INVALID)
1178   {
1179     const char *name, *value;
1180     gchar *str;
1181     GArray *new_array;
1182     dbus_message_iter_recurse (&iter_array, &iter_dict);
1183     dbus_message_iter_get_basic (&iter_dict, &name);
1184     dbus_message_iter_next (&iter_dict);
1185     dbus_message_iter_get_basic (&iter_dict, &value);
1186     str = g_strdup_printf ("%s:%s", name, value);
1187     new_array = g_array_append_val (array, str);
1188     if (new_array)
1189       array = new_array;
1190     dbus_message_iter_next (&iter_array);;
1191   }
1192   return array;
1193 }
1194
1195 void
1196 _atspi_dbus_set_interfaces (AtspiAccessible *accessible, DBusMessageIter *iter)
1197 {
1198   DBusMessageIter iter_array;
1199
1200   accessible->interfaces = 0;
1201   dbus_message_iter_recurse (iter, &iter_array);
1202   while (dbus_message_iter_get_arg_type (&iter_array) != DBUS_TYPE_INVALID)
1203   {
1204     const char *iface;
1205     gint n;
1206     dbus_message_iter_get_basic (&iter_array, &iface);
1207     if (!strcmp (iface, "org.freedesktop.DBus.Introspectable")) continue;
1208     n = _atspi_get_iface_num (iface);
1209     if (n == -1)
1210     {
1211       g_warning (_("AT-SPI: Unknown interface %s"), iface);
1212     }
1213     else
1214       accessible->interfaces |= (1 << n);
1215     dbus_message_iter_next (&iter_array);
1216   }
1217   _atspi_accessible_add_cache (accessible, ATSPI_CACHE_INTERFACES);
1218 }
1219
1220 void
1221 _atspi_dbus_set_state (AtspiAccessible *accessible, DBusMessageIter *iter)
1222 {
1223   DBusMessageIter iter_array;
1224   gint count;
1225   dbus_uint32_t *states;
1226
1227   dbus_message_iter_recurse (iter, &iter_array);
1228   dbus_message_iter_get_fixed_array (&iter_array, &states, &count);
1229   if (count != 2)
1230   {
1231     g_warning (_("AT-SPI: expected 2 values in states array; got %d\n"), count);
1232     if (!accessible->states)
1233       accessible->states = _atspi_state_set_new_internal (accessible, 0);
1234   }
1235   else
1236   {
1237     guint64 val = ((guint64)states [1]) << 32;
1238     val += states [0];
1239     if (!accessible->states)
1240       accessible->states = _atspi_state_set_new_internal (accessible, val);
1241     else
1242       accessible->states->states = val;
1243   }
1244   _atspi_accessible_add_cache (accessible, ATSPI_CACHE_STATES);
1245 }
1246
1247 GQuark
1248 atspi_error_quark (void)
1249 {
1250   return g_quark_from_static_string ("atspi_error");
1251 }
1252
1253 /*
1254  * Gets the IOR from the XDisplay.
1255  */
1256 static char *
1257 get_accessibility_bus_address_x11 (void)
1258 {
1259   Atom AT_SPI_BUS;
1260   Atom actual_type;
1261   Display *bridge_display;
1262   int actual_format;
1263   unsigned char *data = NULL;
1264   unsigned long nitems;
1265   unsigned long leftover;
1266
1267   bridge_display = XOpenDisplay (spi_display_name ());
1268   if (!bridge_display)
1269     {
1270       g_warning ("Could not open X display");
1271       return NULL;
1272     }
1273
1274   AT_SPI_BUS = XInternAtom (bridge_display, "AT_SPI_BUS", False);
1275   XGetWindowProperty (bridge_display,
1276                       XDefaultRootWindow (bridge_display),
1277                       AT_SPI_BUS, 0L,
1278                       (long) BUFSIZ, False,
1279                       (Atom) 31, &actual_type, &actual_format,
1280                       &nitems, &leftover, &data);
1281   XCloseDisplay (bridge_display);
1282
1283   return g_strdup (data);
1284 }
1285
1286 static char *
1287 get_accessibility_bus_address_dbus (void)
1288 {
1289   DBusConnection *session_bus = NULL;
1290   DBusMessage *message;
1291   DBusMessage *reply;
1292   char *address = NULL;
1293
1294   session_bus = dbus_bus_get (DBUS_BUS_SESSION, NULL);
1295   if (!session_bus)
1296     return NULL;
1297
1298   message = dbus_message_new_method_call ("org.a11y.Bus",
1299                                           "/org/a11y/bus",
1300                                           "org.a11y.Bus",
1301                                           "GetAddress");
1302
1303   reply = dbus_connection_send_with_reply_and_block (session_bus,
1304                                                      message,
1305                                                      -1,
1306                                                      NULL);
1307   dbus_message_unref (message);
1308
1309   if (!reply)
1310     return NULL;
1311
1312   {
1313     const char *tmp_address;
1314     if (!dbus_message_get_args (reply,
1315                                 NULL,
1316                                 DBUS_TYPE_STRING,
1317                                 &tmp_address,
1318                                 DBUS_TYPE_INVALID))
1319       {
1320         dbus_message_unref (reply);
1321         return NULL;
1322       }
1323     address = g_strdup (tmp_address);
1324     dbus_message_unref (reply);
1325   }
1326
1327   return address;
1328 }
1329
1330 DBusConnection *
1331 atspi_get_a11y_bus (void)
1332 {
1333   DBusConnection *bus = NULL;
1334   DBusError error;
1335   char *address;
1336
1337   address = get_accessibility_bus_address_x11 ();
1338   if (!address)
1339     address = get_accessibility_bus_address_dbus ();
1340   if (!address)
1341     return NULL;
1342
1343   dbus_error_init (&error);
1344   bus = dbus_connection_open (address, &error);
1345   if (!bus)
1346     {
1347       g_warning ("Couldn't connect to accessibility bus: %s", error.message);
1348       return NULL;
1349     }
1350   else
1351     {
1352       if (!dbus_bus_register (bus, &error))
1353         {
1354           g_warning ("Couldn't register with accessibility bus: %s", error.message);
1355           return NULL;
1356         }
1357     }
1358
1359   return bus;
1360 }