Merge branch 'dbus-1.4', rejecting all changes
[platform/upstream/dbus.git] / dbus / dbus-object-tree.c
1 /* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
2 /* dbus-object-tree.c  DBusObjectTree (internals of DBusConnection)
3  *
4  * Copyright (C) 2003, 2005  Red Hat Inc.
5  *
6  * Licensed under the Academic Free License version 2.1
7  *
8  * This program is free software; you can redistribute it and/or modify
9  * it under the terms of the GNU General Public License as published by
10  * the Free Software Foundation; either version 2 of the License, or
11  * (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the GNU General Public License
19  * along with this program; if not, write to the Free Software
20  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
21  *
22  */
23
24 #include <config.h>
25 #include "dbus-object-tree.h"
26 #include "dbus-connection-internal.h"
27 #include "dbus-internals.h"
28 #include "dbus-hash.h"
29 #include "dbus-protocol.h"
30 #include "dbus-string.h"
31 #include <string.h>
32 #include <stdlib.h>
33
34 /**
35  * @defgroup DBusObjectTree A hierarchy of objects with container-contained relationship
36  * @ingroup  DBusInternals
37  * @brief DBusObjectTree is used by DBusConnection to track the object tree
38  *
39  * Types and functions related to DBusObjectTree. These
40  * are all library-internal.
41  *
42  * @{
43  */
44
45 /** Subnode of the object hierarchy */
46 typedef struct DBusObjectSubtree DBusObjectSubtree;
47
48 static DBusObjectSubtree* _dbus_object_subtree_new   (const char                  *name,
49                                                       const DBusObjectPathVTable  *vtable,
50                                                       void                        *user_data);
51 static DBusObjectSubtree* _dbus_object_subtree_ref   (DBusObjectSubtree           *subtree);
52 static void               _dbus_object_subtree_unref (DBusObjectSubtree           *subtree);
53
54 /**
55  * Internals of DBusObjectTree
56  */
57 struct DBusObjectTree
58 {
59   int                 refcount;   /**< Reference count */
60   DBusConnection     *connection; /**< Connection this tree belongs to */
61
62   DBusObjectSubtree  *root;       /**< Root of the tree ("/" node) */
63 };
64
65 /**
66  * Struct representing a single registered subtree handler, or node
67  * that's a parent of a registered subtree handler. If
68  * message_function != NULL there's actually a handler at this node.
69  */
70 struct DBusObjectSubtree
71 {
72   DBusAtomic                         refcount;            /**< Reference count */
73   DBusObjectSubtree                 *parent;              /**< Parent node */
74   DBusObjectPathUnregisterFunction   unregister_function; /**< Function to call on unregister */
75   DBusObjectPathMessageFunction      message_function;    /**< Function to handle messages */
76   void                              *user_data;           /**< Data for functions */
77   DBusObjectSubtree                **subtrees;            /**< Child nodes */
78   int                                n_subtrees;          /**< Number of child nodes */
79   int                                max_subtrees;        /**< Number of allocated entries in subtrees */
80   unsigned int                       invoke_as_fallback : 1; /**< Whether to invoke message_function when child nodes don't handle the message */
81   char                               name[1]; /**< Allocated as large as necessary */
82 };
83
84 /**
85  * Creates a new object tree, representing a mapping from paths
86  * to handler vtables.
87  *
88  * @param connection the connection this tree belongs to
89  * @returns the new tree or #NULL if no memory
90  */
91 DBusObjectTree*
92 _dbus_object_tree_new (DBusConnection *connection)
93 {
94   DBusObjectTree *tree;
95
96   /* the connection passed in here isn't fully constructed,
97    * so don't do anything more than store a pointer to
98    * it
99    */
100
101   tree = dbus_new0 (DBusObjectTree, 1);
102   if (tree == NULL)
103     goto oom;
104
105   tree->refcount = 1;
106   tree->connection = connection;
107   tree->root = _dbus_object_subtree_new ("/", NULL, NULL);
108   if (tree->root == NULL)
109     goto oom;
110   tree->root->invoke_as_fallback = TRUE;
111   
112   return tree;
113
114  oom:
115   if (tree)
116     {
117       dbus_free (tree);
118     }
119
120   return NULL;
121 }
122
123 /**
124  * Increment the reference count
125  * @param tree the object tree
126  * @returns the object tree
127  */
128 DBusObjectTree *
129 _dbus_object_tree_ref (DBusObjectTree *tree)
130 {
131   _dbus_assert (tree->refcount > 0);
132
133   tree->refcount += 1;
134
135   return tree;
136 }
137
138 /**
139  * Decrement the reference count
140  * @param tree the object tree
141  */
142 void
143 _dbus_object_tree_unref (DBusObjectTree *tree)
144 {
145   _dbus_assert (tree->refcount > 0);
146
147   tree->refcount -= 1;
148
149   if (tree->refcount == 0)
150     {
151       _dbus_object_tree_free_all_unlocked (tree);
152
153       dbus_free (tree);
154     }
155 }
156
157 /** Set to 1 to get a bunch of debug spew about finding the
158  * subtree nodes
159  */
160 #define VERBOSE_FIND 0
161
162 static DBusObjectSubtree*
163 find_subtree_recurse (DBusObjectSubtree  *subtree,
164                       const char        **path,
165                       dbus_bool_t         create_if_not_found,
166                       int                *index_in_parent,
167                       dbus_bool_t        *exact_match)
168 {
169   int i, j;
170   dbus_bool_t return_deepest_match;
171
172   return_deepest_match = exact_match != NULL;
173
174   _dbus_assert (!(return_deepest_match && create_if_not_found));
175
176   if (path[0] == NULL)
177     {
178 #if VERBOSE_FIND
179       _dbus_verbose ("  path exhausted, returning %s\n",
180                      subtree->name);
181 #endif
182       if (exact_match != NULL)
183         *exact_match = TRUE;
184       return subtree;
185     }
186
187 #if VERBOSE_FIND
188   _dbus_verbose ("  searching children of %s for %s\n",
189                  subtree->name, path[0]);
190 #endif
191   
192   i = 0;
193   j = subtree->n_subtrees;
194   while (i < j)
195     {
196       int k, v;
197
198       k = (i + j) / 2;
199       v = strcmp (path[0], subtree->subtrees[k]->name);
200
201 #if VERBOSE_FIND
202       _dbus_verbose ("  %s cmp %s = %d\n",
203                      path[0], subtree->subtrees[k]->name,
204                      v);
205 #endif
206       
207       if (v == 0)
208         {
209           if (index_in_parent)
210             {
211 #if VERBOSE_FIND
212               _dbus_verbose ("  storing parent index %d\n", k);
213 #endif
214               *index_in_parent = k;
215             }
216
217           if (return_deepest_match)
218             {
219               DBusObjectSubtree *next;
220
221               next = find_subtree_recurse (subtree->subtrees[k],
222                                            &path[1], create_if_not_found, 
223                                            index_in_parent, exact_match);
224               if (next == NULL &&
225                   subtree->invoke_as_fallback)
226                 {
227 #if VERBOSE_FIND
228                   _dbus_verbose ("  no deeper match found, returning %s\n",
229                                  subtree->name);
230 #endif
231                   if (exact_match != NULL)
232                     *exact_match = FALSE;
233                   return subtree;
234                 }
235               else
236                 return next;
237             }
238           else
239             return find_subtree_recurse (subtree->subtrees[k],
240                                          &path[1], create_if_not_found, 
241                                          index_in_parent, exact_match);
242         }
243       else if (v < 0)
244         {
245           j = k;
246         }
247       else
248         {
249           i = k + 1;
250         }
251     }
252
253 #if VERBOSE_FIND
254   _dbus_verbose ("  no match found, current tree %s, create_if_not_found = %d\n",
255                  subtree->name, create_if_not_found);
256 #endif
257   
258   if (create_if_not_found)
259     {
260       DBusObjectSubtree* child;
261       int child_pos, new_n_subtrees;
262
263 #if VERBOSE_FIND
264       _dbus_verbose ("  creating subtree %s\n",
265                      path[0]);
266 #endif
267       
268       child = _dbus_object_subtree_new (path[0],
269                                         NULL, NULL);
270       if (child == NULL)
271         return NULL;
272
273       new_n_subtrees = subtree->n_subtrees + 1;
274       if (new_n_subtrees > subtree->max_subtrees)
275         {
276           int new_max_subtrees;
277           DBusObjectSubtree **new_subtrees;
278
279           new_max_subtrees = subtree->max_subtrees == 0 ? 1 : 2 * subtree->max_subtrees;
280           new_subtrees = dbus_realloc (subtree->subtrees,
281                                        new_max_subtrees * sizeof (DBusObjectSubtree*));
282           if (new_subtrees == NULL)
283             {
284               _dbus_object_subtree_unref (child);
285               return NULL;
286             }
287           subtree->subtrees = new_subtrees;
288           subtree->max_subtrees = new_max_subtrees;
289         }
290
291       /* The binary search failed, so i == j points to the 
292          place the child should be inserted. */
293       child_pos = i;
294       _dbus_assert (child_pos < new_n_subtrees &&
295                     new_n_subtrees <= subtree->max_subtrees);
296       if (child_pos + 1 < new_n_subtrees)
297         {
298           memmove (&subtree->subtrees[child_pos+1], 
299                    &subtree->subtrees[child_pos], 
300                    (new_n_subtrees - child_pos - 1) * 
301                    sizeof subtree->subtrees[0]);
302         }
303       subtree->subtrees[child_pos] = child;
304
305       if (index_in_parent)
306         *index_in_parent = child_pos;
307       subtree->n_subtrees = new_n_subtrees;
308       child->parent = subtree;
309
310       return find_subtree_recurse (child,
311                                    &path[1], create_if_not_found, 
312                                    index_in_parent, exact_match);
313     }
314   else
315     {
316       if (exact_match != NULL)
317         *exact_match = FALSE;
318       return (return_deepest_match && subtree->invoke_as_fallback) ? subtree : NULL;
319     }
320 }
321
322 static DBusObjectSubtree*
323 find_subtree (DBusObjectTree *tree,
324               const char    **path,
325               int            *index_in_parent)
326 {
327   DBusObjectSubtree *subtree;
328
329 #if VERBOSE_FIND
330   _dbus_verbose ("Looking for exact registered subtree\n");
331 #endif
332   
333   subtree = find_subtree_recurse (tree->root, path, FALSE, index_in_parent, NULL);
334
335   if (subtree && subtree->message_function == NULL)
336     return NULL;
337   else
338     return subtree;
339 }
340
341 static DBusObjectSubtree*
342 lookup_subtree (DBusObjectTree *tree,
343                 const char    **path)
344 {
345 #if VERBOSE_FIND
346   _dbus_verbose ("Looking for subtree\n");
347 #endif
348   return find_subtree_recurse (tree->root, path, FALSE, NULL, NULL);
349 }
350
351 static DBusObjectSubtree*
352 find_handler (DBusObjectTree *tree,
353               const char    **path,
354               dbus_bool_t    *exact_match)
355 {
356 #if VERBOSE_FIND
357   _dbus_verbose ("Looking for deepest handler\n");
358 #endif
359   _dbus_assert (exact_match != NULL);
360
361   *exact_match = FALSE; /* ensure always initialized */
362   
363   return find_subtree_recurse (tree->root, path, FALSE, NULL, exact_match);
364 }
365
366 static DBusObjectSubtree*
367 ensure_subtree (DBusObjectTree *tree,
368                 const char    **path)
369 {
370 #if VERBOSE_FIND
371   _dbus_verbose ("Ensuring subtree\n");
372 #endif
373   return find_subtree_recurse (tree->root, path, TRUE, NULL, NULL);
374 }
375
376 static char *flatten_path (const char **path);
377
378 /**
379  * Registers a new subtree in the global object tree.
380  *
381  * @param tree the global object tree
382  * @param fallback #TRUE to handle messages to children of this path
383  * @param path NULL-terminated array of path elements giving path to subtree
384  * @param vtable the vtable used to traverse this subtree
385  * @param user_data user data to pass to methods in the vtable
386  * @param error address where an error can be returned
387  * @returns #FALSE if an error (#DBUS_ERROR_NO_MEMORY or
388  *    #DBUS_ERROR_OBJECT_PATH_IN_USE) is reported
389  */
390 dbus_bool_t
391 _dbus_object_tree_register (DBusObjectTree              *tree,
392                             dbus_bool_t                  fallback,
393                             const char                 **path,
394                             const DBusObjectPathVTable  *vtable,
395                             void                        *user_data,
396                             DBusError                   *error)
397 {
398   DBusObjectSubtree  *subtree;
399
400   _dbus_assert (tree != NULL);
401   _dbus_assert (vtable->message_function != NULL);
402   _dbus_assert (path != NULL);
403
404   subtree = ensure_subtree (tree, path);
405   if (subtree == NULL)
406     {
407       _DBUS_SET_OOM (error);
408       return FALSE;
409     }
410
411   if (subtree->message_function != NULL)
412     {
413       if (error != NULL)
414         {
415           char *complete_path = flatten_path (path);
416
417           dbus_set_error (error, DBUS_ERROR_OBJECT_PATH_IN_USE,
418                           "A handler is already registered for %s",
419                           complete_path ? complete_path
420                                         : "(cannot represent path: out of memory!)");
421
422           dbus_free (complete_path);
423         }
424
425       return FALSE;
426     }
427
428   subtree->message_function = vtable->message_function;
429   subtree->unregister_function = vtable->unregister_function;
430   subtree->user_data = user_data;
431   subtree->invoke_as_fallback = fallback != FALSE;
432
433   return TRUE;
434 }
435
436 /**
437  * Unregisters an object subtree that was registered with the
438  * same path.
439  *
440  * @param tree the global object tree
441  * @param path path to the subtree (same as the one passed to _dbus_object_tree_register())
442  */
443 void
444 _dbus_object_tree_unregister_and_unlock (DBusObjectTree          *tree,
445                                          const char             **path)
446 {
447   int i;
448   DBusObjectSubtree *subtree;
449   DBusObjectPathUnregisterFunction unregister_function;
450   void *user_data;
451   DBusConnection *connection;
452
453   _dbus_assert (path != NULL);
454
455   unregister_function = NULL;
456   user_data = NULL;
457
458   subtree = find_subtree (tree, path, &i);
459
460 #ifndef DBUS_DISABLE_CHECKS
461   if (subtree == NULL)
462     {
463       _dbus_warn ("Attempted to unregister path (path[0] = %s path[1] = %s) which isn't registered\n",
464                   path[0] ? path[0] : "null",
465                   path[1] ? path[1] : "null");
466       goto unlock;    
467     }
468 #else
469   _dbus_assert (subtree != NULL);
470 #endif
471
472   _dbus_assert (subtree->parent == NULL ||
473                 (i >= 0 && subtree->parent->subtrees[i] == subtree));
474
475   subtree->message_function = NULL;
476
477   unregister_function = subtree->unregister_function;
478   user_data = subtree->user_data;
479
480   subtree->unregister_function = NULL;
481   subtree->user_data = NULL;
482
483   /* If we have no subtrees of our own, remove from
484    * our parent (FIXME could also be more aggressive
485    * and remove our parent if it becomes empty)
486    */
487   if (subtree->parent && subtree->n_subtrees == 0)
488     {
489       /* assumes a 0-byte memmove is OK */
490       memmove (&subtree->parent->subtrees[i],
491                &subtree->parent->subtrees[i+1],
492                (subtree->parent->n_subtrees - i - 1) *
493                sizeof (subtree->parent->subtrees[0]));
494       subtree->parent->n_subtrees -= 1;
495
496       subtree->parent = NULL;
497
498       _dbus_object_subtree_unref (subtree);
499     }
500   subtree = NULL;
501
502 unlock:
503   connection = tree->connection;
504
505   /* Unlock and call application code */
506 #ifdef DBUS_BUILD_TESTS
507   if (connection)
508 #endif
509     {
510       _dbus_connection_ref_unlocked (connection);
511       _dbus_verbose ("unlock\n");
512       _dbus_connection_unlock (connection);
513     }
514
515   if (unregister_function)
516     (* unregister_function) (connection, user_data);
517
518 #ifdef DBUS_BUILD_TESTS
519   if (connection)
520 #endif
521     dbus_connection_unref (connection);
522 }
523
524 static void
525 free_subtree_recurse (DBusConnection    *connection,
526                       DBusObjectSubtree *subtree)
527 {
528   /* Delete them from the end, for slightly
529    * more robustness against odd reentrancy.
530    */
531   while (subtree->n_subtrees > 0)
532     {
533       DBusObjectSubtree *child;
534
535       child = subtree->subtrees[subtree->n_subtrees - 1];
536       subtree->subtrees[subtree->n_subtrees - 1] = NULL;
537       subtree->n_subtrees -= 1;
538       child->parent = NULL;
539
540       free_subtree_recurse (connection, child);
541     }
542
543   /* Call application code */
544   if (subtree->unregister_function)
545     (* subtree->unregister_function) (connection,
546                                       subtree->user_data);
547
548   subtree->message_function = NULL;
549   subtree->unregister_function = NULL;
550   subtree->user_data = NULL;
551
552   /* Now free ourselves */
553   _dbus_object_subtree_unref (subtree);
554 }
555
556 /**
557  * Free all the handlers in the tree. Lock on tree's connection
558  * must not be held.
559  *
560  * @param tree the object tree
561  */
562 void
563 _dbus_object_tree_free_all_unlocked (DBusObjectTree *tree)
564 {
565   if (tree->root)
566     free_subtree_recurse (tree->connection,
567                           tree->root);
568   tree->root = NULL;
569 }
570
571 static dbus_bool_t
572 _dbus_object_tree_list_registered_unlocked (DBusObjectTree *tree,
573                                             const char    **parent_path,
574                                             char         ***child_entries)
575 {
576   DBusObjectSubtree *subtree;
577   char **retval;
578   
579   _dbus_assert (parent_path != NULL);
580   _dbus_assert (child_entries != NULL);
581
582   *child_entries = NULL;
583   
584   subtree = lookup_subtree (tree, parent_path);
585   if (subtree == NULL)
586     {
587       retval = dbus_new0 (char *, 1);
588     }
589   else
590     {
591       int i;
592       retval = dbus_new0 (char*, subtree->n_subtrees + 1);
593       if (retval == NULL)
594         goto out;
595       i = 0;
596       while (i < subtree->n_subtrees)
597         {
598           retval[i] = _dbus_strdup (subtree->subtrees[i]->name);
599           if (retval[i] == NULL)
600             {
601               dbus_free_string_array (retval);
602               retval = NULL;
603               goto out;
604             }
605           ++i;
606         }
607     }
608
609  out:
610     
611   *child_entries = retval;
612   return retval != NULL;
613 }
614
615 static DBusHandlerResult
616 handle_default_introspect_and_unlock (DBusObjectTree          *tree,
617                                       DBusMessage             *message,
618                                       const char             **path)
619 {
620   DBusString xml;
621   DBusHandlerResult result;
622   char **children;
623   int i;
624   DBusMessage *reply;
625   DBusMessageIter iter;
626   const char *v_STRING;
627   dbus_bool_t already_unlocked;
628
629   /* We have the connection lock here */
630
631   already_unlocked = FALSE;
632   
633   _dbus_verbose (" considering default Introspect() handler...\n");
634
635   reply = NULL;
636   
637   if (!dbus_message_is_method_call (message,
638                                     DBUS_INTERFACE_INTROSPECTABLE,
639                                     "Introspect"))
640     {
641 #ifdef DBUS_BUILD_TESTS
642       if (tree->connection)
643 #endif
644         {
645           _dbus_verbose ("unlock\n");
646           _dbus_connection_unlock (tree->connection);
647         }
648       
649       return DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
650     }
651
652   _dbus_verbose (" using default Introspect() handler!\n");
653   
654   if (!_dbus_string_init (&xml))
655     {
656 #ifdef DBUS_BUILD_TESTS
657       if (tree->connection)
658 #endif
659         {
660           _dbus_verbose ("unlock\n");
661           _dbus_connection_unlock (tree->connection);
662         }
663
664       return DBUS_HANDLER_RESULT_NEED_MEMORY;
665     }
666
667   result = DBUS_HANDLER_RESULT_NEED_MEMORY;
668
669   children = NULL;
670   if (!_dbus_object_tree_list_registered_unlocked (tree, path, &children))
671     goto out;
672
673   if (!_dbus_string_append (&xml, DBUS_INTROSPECT_1_0_XML_DOCTYPE_DECL_NODE))
674     goto out;
675   
676   if (!_dbus_string_append (&xml, "<node>\n"))
677     goto out;
678
679   i = 0;
680   while (children[i] != NULL)
681     {
682       if (!_dbus_string_append_printf (&xml, "  <node name=\"%s\"/>\n",
683                                        children[i]))
684         goto out;
685
686       ++i;
687     }
688
689   if (!_dbus_string_append (&xml, "</node>\n"))
690     goto out;
691
692   reply = dbus_message_new_method_return (message);
693   if (reply == NULL)
694     goto out;
695
696   dbus_message_iter_init_append (reply, &iter);
697   v_STRING = _dbus_string_get_const_data (&xml);
698   if (!dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &v_STRING))
699     goto out;
700   
701 #ifdef DBUS_BUILD_TESTS
702   if (tree->connection)
703 #endif
704     {
705       already_unlocked = TRUE;
706       
707       if (!_dbus_connection_send_and_unlock (tree->connection, reply, NULL))
708         goto out;
709     }
710   
711   result = DBUS_HANDLER_RESULT_HANDLED;
712   
713  out:
714 #ifdef DBUS_BUILD_TESTS
715   if (tree->connection)
716 #endif
717     {
718       if (!already_unlocked)
719         {
720           _dbus_verbose ("unlock\n");
721           _dbus_connection_unlock (tree->connection);
722         }
723     }
724   
725   _dbus_string_free (&xml);
726   dbus_free_string_array (children);
727   if (reply)
728     dbus_message_unref (reply);
729   
730   return result;
731 }
732
733 /**
734  * Tries to dispatch a message by directing it to handler for the
735  * object path listed in the message header, if any. Messages are
736  * dispatched first to the registered handler that matches the largest
737  * number of path elements; that is, message to /foo/bar/baz would go
738  * to the handler for /foo/bar before the one for /foo.
739  *
740  * @todo thread problems
741  *
742  * @param tree the global object tree
743  * @param message the message to dispatch
744  * @returns whether message was handled successfully
745  */
746 DBusHandlerResult
747 _dbus_object_tree_dispatch_and_unlock (DBusObjectTree          *tree,
748                                        DBusMessage             *message,
749                                        dbus_bool_t             *found_object)
750 {
751   char **path;
752   dbus_bool_t exact_match;
753   DBusList *list;
754   DBusList *link;
755   DBusHandlerResult result;
756   DBusObjectSubtree *subtree;
757   
758 #if 0
759   _dbus_verbose ("Dispatch of message by object path\n");
760 #endif
761   
762   path = NULL;
763   if (!dbus_message_get_path_decomposed (message, &path))
764     {
765 #ifdef DBUS_BUILD_TESTS
766       if (tree->connection)
767 #endif
768         {
769           _dbus_verbose ("unlock\n");
770           _dbus_connection_unlock (tree->connection);
771         }
772       
773       _dbus_verbose ("No memory to get decomposed path\n");
774
775       return DBUS_HANDLER_RESULT_NEED_MEMORY;
776     }
777
778   if (path == NULL)
779     {
780 #ifdef DBUS_BUILD_TESTS
781       if (tree->connection)
782 #endif
783         {
784           _dbus_verbose ("unlock\n");
785           _dbus_connection_unlock (tree->connection);
786         }
787       
788       _dbus_verbose ("No path field in message\n");
789       return DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
790     }
791   
792   /* Find the deepest path that covers the path in the message */
793   subtree = find_handler (tree, (const char**) path, &exact_match);
794   
795   if (found_object)
796     *found_object = !!subtree;
797
798   /* Build a list of all paths that cover the path in the message */
799
800   list = NULL;
801
802   while (subtree != NULL)
803     {
804       if (subtree->message_function != NULL && (exact_match || subtree->invoke_as_fallback))
805         {
806           _dbus_object_subtree_ref (subtree);
807
808           /* run deepest paths first */
809           if (!_dbus_list_append (&list, subtree))
810             {
811               result = DBUS_HANDLER_RESULT_NEED_MEMORY;
812               _dbus_object_subtree_unref (subtree);
813               goto free_and_return;
814             }
815         }
816
817       exact_match = FALSE;
818       subtree = subtree->parent;
819     }
820
821   _dbus_verbose ("%d handlers in the path tree for this message\n",
822                  _dbus_list_get_length (&list));
823
824   /* Invoke each handler in the list */
825
826   result = DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
827
828   link = _dbus_list_get_first_link (&list);
829   while (link != NULL)
830     {
831       DBusList *next = _dbus_list_get_next_link (&list, link);
832       subtree = link->data;
833
834       /* message_function is NULL if we're unregistered
835        * due to reentrancy
836        */
837       if (subtree->message_function)
838         {
839           DBusObjectPathMessageFunction message_function;
840           void *user_data;
841
842           message_function = subtree->message_function;
843           user_data = subtree->user_data;
844
845 #if 0
846           _dbus_verbose ("  (invoking a handler)\n");
847 #endif
848           
849 #ifdef DBUS_BUILD_TESTS
850           if (tree->connection)
851 #endif
852             {
853               _dbus_verbose ("unlock\n");
854               _dbus_connection_unlock (tree->connection);
855             }
856
857           /* FIXME you could unregister the subtree in another thread
858            * before we invoke the callback, and I can't figure out a
859            * good way to solve this.
860            */
861
862           result = (* message_function) (tree->connection,
863                                          message,
864                                          user_data);
865
866 #ifdef DBUS_BUILD_TESTS
867           if (tree->connection)
868 #endif
869             _dbus_connection_lock (tree->connection);
870
871           if (result != DBUS_HANDLER_RESULT_NOT_YET_HANDLED)
872             goto free_and_return;
873         }
874
875       link = next;
876     }
877
878  free_and_return:
879
880   if (result == DBUS_HANDLER_RESULT_NOT_YET_HANDLED)
881     {
882       /* This hardcoded default handler does a minimal Introspect()
883        */
884       result = handle_default_introspect_and_unlock (tree, message,
885                                                      (const char**) path);
886     }
887   else
888     {
889 #ifdef DBUS_BUILD_TESTS
890       if (tree->connection)
891 #endif
892         {
893           _dbus_verbose ("unlock\n");
894           _dbus_connection_unlock (tree->connection);
895         }
896     }
897   
898   while (list != NULL)
899     {
900       link = _dbus_list_get_first_link (&list);
901       _dbus_object_subtree_unref (link->data);
902       _dbus_list_remove_link (&list, link);
903     }
904   
905   dbus_free_string_array (path);
906
907   return result;
908 }
909
910 /**
911  * Looks up the data passed to _dbus_object_tree_register() for a
912  * handler at the given path.
913  *
914  * @param tree the global object tree
915  * @param path NULL-terminated array of path elements giving path to subtree
916  * @returns the object's user_data or #NULL if none found
917  */
918 void*
919 _dbus_object_tree_get_user_data_unlocked (DBusObjectTree *tree,
920                                           const char    **path)
921 {
922   dbus_bool_t exact_match;
923   DBusObjectSubtree *subtree;
924
925   _dbus_assert (tree != NULL);
926   _dbus_assert (path != NULL);
927   
928   /* Find the deepest path that covers the path in the message */
929   subtree = find_handler (tree, (const char**) path, &exact_match);
930
931   if ((subtree == NULL) || !exact_match)
932     {
933       _dbus_verbose ("No object at specified path found\n");
934       return NULL;
935     }
936
937   return subtree->user_data;
938 }
939
940 /**
941  * Allocates a subtree object.
942  *
943  * @param name name to duplicate.
944  * @returns newly-allocated subtree
945  */
946 static DBusObjectSubtree*
947 allocate_subtree_object (const char *name)
948 {
949   int len;
950   DBusObjectSubtree *subtree;
951   const size_t front_padding = _DBUS_STRUCT_OFFSET (DBusObjectSubtree, name);
952
953   _dbus_assert (name != NULL);
954
955   len = strlen (name);
956
957   subtree = dbus_malloc (MAX (front_padding + (len + 1), sizeof (DBusObjectSubtree)));
958
959   if (subtree == NULL)
960     return NULL;
961
962   memcpy (subtree->name, name, len + 1);
963
964   return subtree;
965 }
966
967 static DBusObjectSubtree*
968 _dbus_object_subtree_new (const char                  *name,
969                           const DBusObjectPathVTable  *vtable,
970                           void                        *user_data)
971 {
972   DBusObjectSubtree *subtree;
973
974   subtree = allocate_subtree_object (name);
975   if (subtree == NULL)
976     goto oom;
977
978   _dbus_assert (name != NULL);
979
980   subtree->parent = NULL;
981
982   if (vtable)
983     {
984       subtree->message_function = vtable->message_function;
985       subtree->unregister_function = vtable->unregister_function;
986     }
987   else
988     {
989       subtree->message_function = NULL;
990       subtree->unregister_function = NULL;
991     }
992
993   subtree->user_data = user_data;
994   subtree->refcount.value = 1;
995   subtree->subtrees = NULL;
996   subtree->n_subtrees = 0;
997   subtree->max_subtrees = 0;
998   subtree->invoke_as_fallback = FALSE;
999
1000   return subtree;
1001
1002  oom:
1003   return NULL;
1004 }
1005
1006 static DBusObjectSubtree *
1007 _dbus_object_subtree_ref (DBusObjectSubtree *subtree)
1008 {
1009   _dbus_assert (subtree->refcount.value > 0);
1010   _dbus_atomic_inc (&subtree->refcount);
1011
1012   return subtree;
1013 }
1014
1015 static void
1016 _dbus_object_subtree_unref (DBusObjectSubtree *subtree)
1017 {
1018   _dbus_assert (subtree->refcount.value > 0);
1019
1020   if (_dbus_atomic_dec (&subtree->refcount) == 1)
1021     {
1022       _dbus_assert (subtree->unregister_function == NULL);
1023       _dbus_assert (subtree->message_function == NULL);
1024
1025       dbus_free (subtree->subtrees);
1026       dbus_free (subtree);
1027     }
1028 }
1029
1030 /**
1031  * Lists the registered fallback handlers and object path handlers at
1032  * the given parent_path. The returned array should be freed with
1033  * dbus_free_string_array().
1034  *
1035  * @param tree the object tree
1036  * @param parent_path the path to list the child handlers of
1037  * @param child_entries returns #NULL-terminated array of children
1038  * @returns #FALSE if no memory to allocate the child entries
1039  */
1040 dbus_bool_t
1041 _dbus_object_tree_list_registered_and_unlock (DBusObjectTree *tree,
1042                                               const char    **parent_path,
1043                                               char         ***child_entries)
1044 {
1045   dbus_bool_t result;
1046
1047   result = _dbus_object_tree_list_registered_unlocked (tree,
1048                                                        parent_path,
1049                                                        child_entries);
1050   
1051 #ifdef DBUS_BUILD_TESTS
1052   if (tree->connection)
1053 #endif
1054     {
1055       _dbus_verbose ("unlock\n");
1056       _dbus_connection_unlock (tree->connection);
1057     }
1058
1059   return result;
1060 }
1061
1062
1063 /** Set to 1 to get a bunch of spew about disassembling the path string */
1064 #define VERBOSE_DECOMPOSE 0
1065
1066 /**
1067  * Decompose an object path.  A path of just "/" is
1068  * represented as an empty vector of strings.
1069  * The path need not be nul terminated.
1070  * 
1071  * @param data the path data
1072  * @param len  the length of the path string
1073  * @param path address to store new object path
1074  * @param path_len length of stored path
1075  */
1076 dbus_bool_t
1077 _dbus_decompose_path (const char*     data,
1078                       int             len,
1079                       char         ***path,
1080                       int            *path_len)
1081 {
1082   char **retval;
1083   int n_components;
1084   int i, j, comp;
1085
1086   _dbus_assert (data != NULL);
1087   _dbus_assert (path != NULL);
1088   
1089 #if VERBOSE_DECOMPOSE
1090   _dbus_verbose ("Decomposing path \"%s\"\n",
1091                  data);
1092 #endif
1093   
1094   n_components = 0;
1095   if (len > 1) /* if path is not just "/" */
1096     {
1097       i = 0;
1098       while (i < len)
1099         {
1100           _dbus_assert (data[i] != '\0');
1101           if (data[i] == '/')
1102             n_components += 1;
1103           ++i;
1104         }
1105     }
1106   
1107   retval = dbus_new0 (char*, n_components + 1);
1108
1109   if (retval == NULL)
1110     return FALSE;
1111
1112   comp = 0;
1113   if (n_components == 0)
1114     i = 1;
1115   else
1116     i = 0;
1117   while (comp < n_components)
1118     {
1119       _dbus_assert (i < len);
1120       
1121       if (data[i] == '/')
1122         ++i;
1123       j = i;
1124
1125       while (j < len && data[j] != '/')
1126         ++j;
1127
1128       /* Now [i, j) is the path component */
1129       _dbus_assert (i < j);
1130       _dbus_assert (data[i] != '/');
1131       _dbus_assert (j == len || data[j] == '/');
1132
1133 #if VERBOSE_DECOMPOSE
1134       _dbus_verbose ("  (component in [%d,%d))\n",
1135                      i, j);
1136 #endif
1137       
1138       retval[comp] = _dbus_memdup (&data[i], j - i + 1);
1139       if (retval[comp] == NULL)
1140         {
1141           dbus_free_string_array (retval);
1142           return FALSE;
1143         }
1144       retval[comp][j-i] = '\0';
1145 #if VERBOSE_DECOMPOSE
1146       _dbus_verbose ("  (component %d = \"%s\")\n",
1147                      comp, retval[comp]);
1148 #endif
1149
1150       ++comp;
1151       i = j;
1152     }
1153   _dbus_assert (i == len);
1154   
1155   *path = retval;
1156   if (path_len)
1157     *path_len = n_components;
1158   
1159   return TRUE;
1160 }
1161
1162 /** @} */
1163
1164 static char*
1165 flatten_path (const char **path)
1166 {
1167   DBusString str;
1168   char *s;
1169
1170   if (!_dbus_string_init (&str))
1171     return NULL;
1172
1173   if (path[0] == NULL)
1174     {
1175       if (!_dbus_string_append_byte (&str, '/'))
1176         goto nomem;
1177     }
1178   else
1179     {
1180       int i;
1181       
1182       i = 0;
1183       while (path[i])
1184         {
1185           if (!_dbus_string_append_byte (&str, '/'))
1186             goto nomem;
1187           
1188           if (!_dbus_string_append (&str, path[i]))
1189             goto nomem;
1190           
1191           ++i;
1192         }
1193     }
1194
1195   if (!_dbus_string_steal_data (&str, &s))
1196     goto nomem;
1197
1198   _dbus_string_free (&str);
1199
1200   return s;
1201
1202  nomem:
1203   _dbus_string_free (&str);
1204   return NULL;
1205 }
1206
1207
1208 #ifdef DBUS_BUILD_TESTS
1209
1210 #ifndef DOXYGEN_SHOULD_SKIP_THIS
1211
1212 #include "dbus-test.h"
1213 #include <stdio.h>
1214
1215 typedef enum 
1216 {
1217   STR_EQUAL,
1218   STR_PREFIX,
1219   STR_DIFFERENT
1220 } StrComparison;
1221
1222 /* Returns TRUE if container is a parent of child
1223  */
1224 static StrComparison
1225 path_contains (const char **container,
1226                const char **child)
1227 {
1228   int i;
1229
1230   i = 0;
1231   while (child[i] != NULL)
1232     {
1233       int v;
1234
1235       if (container[i] == NULL)
1236         return STR_PREFIX; /* container ran out, child continues;
1237                             * thus the container is a parent of the
1238                             * child.
1239                             */
1240
1241       _dbus_assert (container[i] != NULL);
1242       _dbus_assert (child[i] != NULL);
1243
1244       v = strcmp (container[i], child[i]);
1245
1246       if (v != 0)
1247         return STR_DIFFERENT; /* they overlap until here and then are different,
1248                                * not overlapping
1249                                */
1250
1251       ++i;
1252     }
1253
1254   /* Child ran out; if container also did, they are equal;
1255    * otherwise, the child is a parent of the container.
1256    */
1257   if (container[i] == NULL)
1258     return STR_EQUAL;
1259   else
1260     return STR_DIFFERENT;
1261 }
1262
1263 #if 0
1264 static void
1265 spew_subtree_recurse (DBusObjectSubtree *subtree,
1266                       int                indent)
1267 {
1268   int i;
1269
1270   i = 0;
1271   while (i < indent)
1272     {
1273       _dbus_verbose (" ");
1274       ++i;
1275     }
1276
1277   _dbus_verbose ("%s (%d children)\n",
1278                  subtree->name, subtree->n_subtrees);
1279
1280   i = 0;
1281   while (i < subtree->n_subtrees)
1282     {
1283       spew_subtree_recurse (subtree->subtrees[i], indent + 2);
1284
1285       ++i;
1286     }
1287 }
1288
1289 static void
1290 spew_tree (DBusObjectTree *tree)
1291 {
1292   spew_subtree_recurse (tree->root, 0);
1293 }
1294 #endif
1295
1296 /**
1297  * Callback data used in tests
1298  */
1299 typedef struct
1300 {
1301   const char **path; /**< Path */
1302   dbus_bool_t handler_fallback; /**< true if the handler may be called as fallback */
1303   dbus_bool_t message_handled; /**< Gets set to true if message handler called */
1304   dbus_bool_t handler_unregistered; /**< gets set to true if handler is unregistered */
1305 } TreeTestData;
1306
1307
1308 static void
1309 test_unregister_function (DBusConnection  *connection,
1310                           void            *user_data)
1311 {
1312   TreeTestData *ttd = user_data;
1313
1314   ttd->handler_unregistered = TRUE;
1315 }
1316
1317 static DBusHandlerResult
1318 test_message_function (DBusConnection  *connection,
1319                        DBusMessage     *message,
1320                        void            *user_data)
1321 {
1322   TreeTestData *ttd = user_data;
1323
1324   ttd->message_handled = TRUE;
1325
1326   return DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
1327 }
1328
1329 static dbus_bool_t
1330 do_register (DBusObjectTree *tree,
1331              const char    **path,
1332              dbus_bool_t     fallback,
1333              int             i,
1334              TreeTestData   *tree_test_data)
1335 {
1336   DBusObjectPathVTable vtable = { test_unregister_function,
1337                                   test_message_function, NULL };
1338
1339   tree_test_data[i].message_handled = FALSE;
1340   tree_test_data[i].handler_unregistered = FALSE;
1341   tree_test_data[i].handler_fallback = fallback;
1342   tree_test_data[i].path = path;
1343
1344   if (!_dbus_object_tree_register (tree, fallback, path,
1345                                    &vtable,
1346                                    &tree_test_data[i],
1347                                    NULL))
1348     return FALSE;
1349
1350   _dbus_assert (_dbus_object_tree_get_user_data_unlocked (tree, path) ==
1351                 &tree_test_data[i]);
1352   
1353   return TRUE;
1354 }
1355
1356 static dbus_bool_t
1357 do_test_dispatch (DBusObjectTree *tree,
1358                   const char    **path,
1359                   int             i,
1360                   TreeTestData   *tree_test_data,
1361                   int             n_test_data)
1362 {
1363   DBusMessage *message;
1364   int j;
1365   DBusHandlerResult result;
1366   char *flat;
1367
1368   message = NULL;
1369   
1370   flat = flatten_path (path);
1371   if (flat == NULL)
1372     goto oom;
1373
1374   message = dbus_message_new_method_call (NULL,
1375                                           flat,
1376                                           "org.freedesktop.TestInterface",
1377                                           "Foo");
1378   dbus_free (flat);
1379   if (message == NULL)
1380     goto oom;
1381
1382   j = 0;
1383   while (j < n_test_data)
1384     {
1385       tree_test_data[j].message_handled = FALSE;
1386       ++j;
1387     }
1388
1389   result = _dbus_object_tree_dispatch_and_unlock (tree, message, NULL);
1390   if (result == DBUS_HANDLER_RESULT_NEED_MEMORY)
1391     goto oom;
1392
1393   _dbus_assert (tree_test_data[i].message_handled);
1394
1395   j = 0;
1396   while (j < n_test_data)
1397     {
1398       if (tree_test_data[j].message_handled)
1399         {
1400           if (tree_test_data[j].handler_fallback)
1401             _dbus_assert (path_contains (tree_test_data[j].path,
1402                                          path) != STR_DIFFERENT);
1403           else
1404             _dbus_assert (path_contains (tree_test_data[j].path, path) == STR_EQUAL);
1405         }
1406       else
1407         {
1408           if (tree_test_data[j].handler_fallback)
1409             _dbus_assert (path_contains (tree_test_data[j].path,
1410                                          path) == STR_DIFFERENT);
1411           else
1412             _dbus_assert (path_contains (tree_test_data[j].path, path) != STR_EQUAL);
1413         }
1414
1415       ++j;
1416     }
1417
1418   dbus_message_unref (message);
1419
1420   return TRUE;
1421
1422  oom:
1423   if (message)
1424     dbus_message_unref (message);
1425   return FALSE;
1426 }
1427
1428 static size_t
1429 string_array_length (const char **array)
1430 {
1431   size_t i;
1432   for (i = 0; array[i]; i++) ;
1433   return i;
1434 }
1435
1436 typedef struct
1437 {
1438   const char *path;
1439   const char *result[20];
1440 } DecomposePathTest;
1441
1442 static DecomposePathTest decompose_tests[] = {
1443   { "/foo", { "foo", NULL } },
1444   { "/foo/bar", { "foo", "bar", NULL } },
1445   { "/", { NULL } },
1446   { "/a/b", { "a", "b", NULL } },
1447   { "/a/b/c", { "a", "b", "c", NULL } },
1448   { "/a/b/c/d", { "a", "b", "c", "d", NULL } },
1449   { "/foo/bar/q", { "foo", "bar", "q", NULL } },
1450   { "/foo/bar/this/is/longer", { "foo", "bar", "this", "is", "longer", NULL } }
1451 };
1452
1453 static dbus_bool_t
1454 run_decompose_tests (void)
1455 {
1456   int i;
1457
1458   i = 0;
1459   while (i < _DBUS_N_ELEMENTS (decompose_tests))
1460     {
1461       char **result;
1462       int    result_len;
1463       int    expected_len;
1464
1465       if (!_dbus_decompose_path (decompose_tests[i].path,
1466                                  strlen (decompose_tests[i].path),
1467                                  &result, &result_len))
1468         return FALSE;
1469
1470       expected_len = string_array_length (decompose_tests[i].result);
1471       
1472       if (result_len != (int) string_array_length ((const char**)result) ||
1473           expected_len != result_len ||
1474           path_contains (decompose_tests[i].result,
1475                          (const char**) result) != STR_EQUAL)
1476         {
1477           int real_len = string_array_length ((const char**)result);
1478           _dbus_warn ("Expected decompose of %s to have len %d, returned %d, appears to have %d\n",
1479                       decompose_tests[i].path, expected_len, result_len,
1480                       real_len);
1481           _dbus_warn ("Decompose resulted in elements: { ");
1482           i = 0;
1483           while (i < real_len)
1484             {
1485               _dbus_warn ("\"%s\"%s", result[i],
1486                           (i + 1) == real_len ? "" : ", ");
1487               ++i;
1488             }
1489           _dbus_warn ("}\n");
1490           _dbus_assert_not_reached ("path decompose failed\n");
1491         }
1492
1493       dbus_free_string_array (result);
1494
1495       ++i;
1496     }
1497   
1498   return TRUE;
1499 }
1500
1501 static dbus_bool_t
1502 object_tree_test_iteration (void *data)
1503 {
1504   const char *path0[] = { NULL };
1505   const char *path1[] = { "foo", NULL };
1506   const char *path2[] = { "foo", "bar", NULL };
1507   const char *path3[] = { "foo", "bar", "baz", NULL };
1508   const char *path4[] = { "foo", "bar", "boo", NULL };
1509   const char *path5[] = { "blah", NULL };
1510   const char *path6[] = { "blah", "boof", NULL };
1511   const char *path7[] = { "blah", "boof", "this", "is", "really", "long", NULL };
1512   const char *path8[] = { "childless", NULL };
1513   DBusObjectTree *tree;
1514   TreeTestData tree_test_data[9];
1515   int i;
1516   dbus_bool_t exact_match;
1517
1518   if (!run_decompose_tests ())
1519     return FALSE;
1520   
1521   tree = NULL;
1522
1523   tree = _dbus_object_tree_new (NULL);
1524   if (tree == NULL)
1525     goto out;
1526
1527   if (!do_register (tree, path0, TRUE, 0, tree_test_data))
1528     goto out;
1529
1530   _dbus_assert (find_subtree (tree, path0, NULL));
1531   _dbus_assert (!find_subtree (tree, path1, NULL));
1532   _dbus_assert (!find_subtree (tree, path2, NULL));
1533   _dbus_assert (!find_subtree (tree, path3, NULL));
1534   _dbus_assert (!find_subtree (tree, path4, NULL));
1535   _dbus_assert (!find_subtree (tree, path5, NULL));
1536   _dbus_assert (!find_subtree (tree, path6, NULL));
1537   _dbus_assert (!find_subtree (tree, path7, NULL));
1538   _dbus_assert (!find_subtree (tree, path8, NULL));
1539
1540   _dbus_assert (find_handler (tree, path0, &exact_match) && exact_match);
1541   _dbus_assert (find_handler (tree, path1, &exact_match) == tree->root && !exact_match);
1542   _dbus_assert (find_handler (tree, path2, &exact_match) == tree->root && !exact_match);
1543   _dbus_assert (find_handler (tree, path3, &exact_match) == tree->root && !exact_match);
1544   _dbus_assert (find_handler (tree, path4, &exact_match) == tree->root && !exact_match);
1545   _dbus_assert (find_handler (tree, path5, &exact_match) == tree->root && !exact_match);
1546   _dbus_assert (find_handler (tree, path6, &exact_match) == tree->root && !exact_match);
1547   _dbus_assert (find_handler (tree, path7, &exact_match) == tree->root && !exact_match);
1548   _dbus_assert (find_handler (tree, path8, &exact_match) == tree->root && !exact_match);
1549   
1550   if (!do_register (tree, path1, TRUE, 1, tree_test_data))
1551     goto out;
1552
1553   _dbus_assert (find_subtree (tree, path0, NULL));
1554   _dbus_assert (find_subtree (tree, path1, NULL));
1555   _dbus_assert (!find_subtree (tree, path2, NULL));
1556   _dbus_assert (!find_subtree (tree, path3, NULL));
1557   _dbus_assert (!find_subtree (tree, path4, NULL));
1558   _dbus_assert (!find_subtree (tree, path5, NULL));
1559   _dbus_assert (!find_subtree (tree, path6, NULL));
1560   _dbus_assert (!find_subtree (tree, path7, NULL));
1561   _dbus_assert (!find_subtree (tree, path8, NULL));
1562
1563   _dbus_assert (find_handler (tree, path0, &exact_match) &&  exact_match);
1564   _dbus_assert (find_handler (tree, path1, &exact_match) &&  exact_match);
1565   _dbus_assert (find_handler (tree, path2, &exact_match) && !exact_match);
1566   _dbus_assert (find_handler (tree, path3, &exact_match) && !exact_match);
1567   _dbus_assert (find_handler (tree, path4, &exact_match) && !exact_match);
1568   _dbus_assert (find_handler (tree, path5, &exact_match) == tree->root && !exact_match);
1569   _dbus_assert (find_handler (tree, path6, &exact_match) == tree->root && !exact_match);
1570   _dbus_assert (find_handler (tree, path7, &exact_match) == tree->root && !exact_match);
1571   _dbus_assert (find_handler (tree, path8, &exact_match) == tree->root && !exact_match);
1572
1573   if (!do_register (tree, path2, TRUE, 2, tree_test_data))
1574     goto out;
1575
1576   _dbus_assert (find_subtree (tree, path1, NULL));
1577   _dbus_assert (find_subtree (tree, path2, NULL));
1578   _dbus_assert (!find_subtree (tree, path3, NULL));
1579   _dbus_assert (!find_subtree (tree, path4, NULL));
1580   _dbus_assert (!find_subtree (tree, path5, NULL));
1581   _dbus_assert (!find_subtree (tree, path6, NULL));
1582   _dbus_assert (!find_subtree (tree, path7, NULL));
1583   _dbus_assert (!find_subtree (tree, path8, NULL));
1584
1585   if (!do_register (tree, path3, TRUE, 3, tree_test_data))
1586     goto out;
1587
1588   _dbus_assert (find_subtree (tree, path0, NULL));
1589   _dbus_assert (find_subtree (tree, path1, NULL));
1590   _dbus_assert (find_subtree (tree, path2, NULL));
1591   _dbus_assert (find_subtree (tree, path3, NULL));
1592   _dbus_assert (!find_subtree (tree, path4, NULL));
1593   _dbus_assert (!find_subtree (tree, path5, NULL));
1594   _dbus_assert (!find_subtree (tree, path6, NULL));
1595   _dbus_assert (!find_subtree (tree, path7, NULL));
1596   _dbus_assert (!find_subtree (tree, path8, NULL));
1597   
1598   if (!do_register (tree, path4, TRUE, 4, tree_test_data))
1599     goto out;
1600
1601   _dbus_assert (find_subtree (tree, path0, NULL));
1602   _dbus_assert (find_subtree (tree, path1, NULL));
1603   _dbus_assert (find_subtree (tree, path2, NULL));
1604   _dbus_assert (find_subtree (tree, path3, NULL));  
1605   _dbus_assert (find_subtree (tree, path4, NULL));
1606   _dbus_assert (!find_subtree (tree, path5, NULL));
1607   _dbus_assert (!find_subtree (tree, path6, NULL));
1608   _dbus_assert (!find_subtree (tree, path7, NULL));
1609   _dbus_assert (!find_subtree (tree, path8, NULL));
1610   
1611   if (!do_register (tree, path5, TRUE, 5, tree_test_data))
1612     goto out;
1613
1614   _dbus_assert (find_subtree (tree, path0, NULL));
1615   _dbus_assert (find_subtree (tree, path1, NULL));
1616   _dbus_assert (find_subtree (tree, path2, NULL));
1617   _dbus_assert (find_subtree (tree, path3, NULL));
1618   _dbus_assert (find_subtree (tree, path4, NULL));
1619   _dbus_assert (find_subtree (tree, path5, NULL));
1620   _dbus_assert (!find_subtree (tree, path6, NULL));
1621   _dbus_assert (!find_subtree (tree, path7, NULL));
1622   _dbus_assert (!find_subtree (tree, path8, NULL));
1623
1624   _dbus_assert (find_handler (tree, path0, &exact_match) == tree->root &&  exact_match);
1625   _dbus_assert (find_handler (tree, path1, &exact_match) != tree->root &&  exact_match);
1626   _dbus_assert (find_handler (tree, path2, &exact_match) != tree->root &&  exact_match);
1627   _dbus_assert (find_handler (tree, path3, &exact_match) != tree->root &&  exact_match);
1628   _dbus_assert (find_handler (tree, path4, &exact_match) != tree->root &&  exact_match);
1629   _dbus_assert (find_handler (tree, path5, &exact_match) != tree->root &&  exact_match);
1630   _dbus_assert (find_handler (tree, path6, &exact_match) != tree->root && !exact_match);
1631   _dbus_assert (find_handler (tree, path7, &exact_match) != tree->root && !exact_match);
1632   _dbus_assert (find_handler (tree, path8, &exact_match) == tree->root && !exact_match);
1633
1634   if (!do_register (tree, path6, TRUE, 6, tree_test_data))
1635     goto out;
1636
1637   _dbus_assert (find_subtree (tree, path0, NULL));
1638   _dbus_assert (find_subtree (tree, path1, NULL));
1639   _dbus_assert (find_subtree (tree, path2, NULL));
1640   _dbus_assert (find_subtree (tree, path3, NULL));
1641   _dbus_assert (find_subtree (tree, path4, NULL));
1642   _dbus_assert (find_subtree (tree, path5, NULL));
1643   _dbus_assert (find_subtree (tree, path6, NULL));
1644   _dbus_assert (!find_subtree (tree, path7, NULL));
1645   _dbus_assert (!find_subtree (tree, path8, NULL));
1646
1647   if (!do_register (tree, path7, TRUE, 7, tree_test_data))
1648     goto out;
1649
1650   _dbus_assert (find_subtree (tree, path0, NULL));
1651   _dbus_assert (find_subtree (tree, path1, NULL));
1652   _dbus_assert (find_subtree (tree, path2, NULL));
1653   _dbus_assert (find_subtree (tree, path3, NULL));
1654   _dbus_assert (find_subtree (tree, path4, NULL));
1655   _dbus_assert (find_subtree (tree, path5, NULL));
1656   _dbus_assert (find_subtree (tree, path6, NULL));
1657   _dbus_assert (find_subtree (tree, path7, NULL));
1658   _dbus_assert (!find_subtree (tree, path8, NULL));
1659
1660   if (!do_register (tree, path8, TRUE, 8, tree_test_data))
1661     goto out;
1662
1663   _dbus_assert (find_subtree (tree, path0, NULL));
1664   _dbus_assert (find_subtree (tree, path1, NULL));
1665   _dbus_assert (find_subtree (tree, path2, NULL));
1666   _dbus_assert (find_subtree (tree, path3, NULL));
1667   _dbus_assert (find_subtree (tree, path4, NULL));
1668   _dbus_assert (find_subtree (tree, path5, NULL));
1669   _dbus_assert (find_subtree (tree, path6, NULL));
1670   _dbus_assert (find_subtree (tree, path7, NULL));
1671   _dbus_assert (find_subtree (tree, path8, NULL));
1672
1673   _dbus_assert (find_handler (tree, path0, &exact_match) == tree->root &&  exact_match);
1674   _dbus_assert (find_handler (tree, path1, &exact_match) != tree->root && exact_match);
1675   _dbus_assert (find_handler (tree, path2, &exact_match) != tree->root && exact_match);
1676   _dbus_assert (find_handler (tree, path3, &exact_match) != tree->root && exact_match);
1677   _dbus_assert (find_handler (tree, path4, &exact_match) != tree->root && exact_match);
1678   _dbus_assert (find_handler (tree, path5, &exact_match) != tree->root && exact_match);
1679   _dbus_assert (find_handler (tree, path6, &exact_match) != tree->root && exact_match);
1680   _dbus_assert (find_handler (tree, path7, &exact_match) != tree->root && exact_match);
1681   _dbus_assert (find_handler (tree, path8, &exact_match) != tree->root && exact_match);
1682   
1683   /* test the list_registered function */
1684
1685   {
1686     const char *root[] = { NULL };
1687     char **child_entries;
1688     int nb;
1689
1690     _dbus_object_tree_list_registered_unlocked (tree, path1, &child_entries);
1691     if (child_entries != NULL)
1692       {
1693         nb = string_array_length ((const char**)child_entries);
1694         _dbus_assert (nb == 1);
1695         dbus_free_string_array (child_entries);
1696       }
1697
1698     _dbus_object_tree_list_registered_unlocked (tree, path2, &child_entries);
1699     if (child_entries != NULL)
1700       {
1701         nb = string_array_length ((const char**)child_entries);
1702         _dbus_assert (nb == 2);
1703         dbus_free_string_array (child_entries);
1704       }
1705
1706     _dbus_object_tree_list_registered_unlocked (tree, path8, &child_entries);
1707     if (child_entries != NULL)
1708       {
1709         nb = string_array_length ((const char**)child_entries);
1710         _dbus_assert (nb == 0);
1711         dbus_free_string_array (child_entries);
1712       }
1713
1714     _dbus_object_tree_list_registered_unlocked (tree, root, &child_entries);
1715     if (child_entries != NULL)
1716       {
1717         nb = string_array_length ((const char**)child_entries);
1718         _dbus_assert (nb == 3);
1719         dbus_free_string_array (child_entries);
1720       }
1721   }
1722
1723   /* Check that destroying tree calls unregister funcs */
1724   _dbus_object_tree_unref (tree);
1725
1726   i = 0;
1727   while (i < (int) _DBUS_N_ELEMENTS (tree_test_data))
1728     {
1729       _dbus_assert (tree_test_data[i].handler_unregistered);
1730       _dbus_assert (!tree_test_data[i].message_handled);
1731       ++i;
1732     }
1733
1734   /* Now start again and try the individual unregister function */
1735   tree = _dbus_object_tree_new (NULL);
1736   if (tree == NULL)
1737     goto out;
1738
1739   if (!do_register (tree, path0, TRUE, 0, tree_test_data))
1740     goto out;
1741   if (!do_register (tree, path1, TRUE, 1, tree_test_data))
1742     goto out;
1743   if (!do_register (tree, path2, TRUE, 2, tree_test_data))
1744     goto out;
1745   if (!do_register (tree, path3, TRUE, 3, tree_test_data))
1746     goto out;
1747   if (!do_register (tree, path4, TRUE, 4, tree_test_data))
1748     goto out;
1749   if (!do_register (tree, path5, TRUE, 5, tree_test_data))
1750     goto out;
1751   if (!do_register (tree, path6, TRUE, 6, tree_test_data))
1752     goto out;
1753   if (!do_register (tree, path7, TRUE, 7, tree_test_data))
1754     goto out;
1755   if (!do_register (tree, path8, TRUE, 8, tree_test_data))
1756     goto out;
1757
1758   _dbus_object_tree_unregister_and_unlock (tree, path0);
1759   _dbus_assert (_dbus_object_tree_get_user_data_unlocked (tree, path0) == NULL);
1760
1761   _dbus_assert (!find_subtree (tree, path0, NULL));
1762   _dbus_assert (find_subtree (tree, path1, NULL));
1763   _dbus_assert (find_subtree (tree, path2, NULL));
1764   _dbus_assert (find_subtree (tree, path3, NULL));
1765   _dbus_assert (find_subtree (tree, path4, NULL));
1766   _dbus_assert (find_subtree (tree, path5, NULL));
1767   _dbus_assert (find_subtree (tree, path6, NULL));
1768   _dbus_assert (find_subtree (tree, path7, NULL));
1769   _dbus_assert (find_subtree (tree, path8, NULL));
1770   
1771   _dbus_object_tree_unregister_and_unlock (tree, path1);
1772   _dbus_assert (_dbus_object_tree_get_user_data_unlocked (tree, path1) == NULL);
1773
1774   _dbus_assert (!find_subtree (tree, path0, NULL));
1775   _dbus_assert (!find_subtree (tree, path1, NULL));
1776   _dbus_assert (find_subtree (tree, path2, NULL));
1777   _dbus_assert (find_subtree (tree, path3, NULL));
1778   _dbus_assert (find_subtree (tree, path4, NULL));
1779   _dbus_assert (find_subtree (tree, path5, NULL));
1780   _dbus_assert (find_subtree (tree, path6, NULL));
1781   _dbus_assert (find_subtree (tree, path7, NULL));
1782   _dbus_assert (find_subtree (tree, path8, NULL));
1783
1784   _dbus_object_tree_unregister_and_unlock (tree, path2);
1785   _dbus_assert (_dbus_object_tree_get_user_data_unlocked (tree, path2) == NULL);
1786
1787   _dbus_assert (!find_subtree (tree, path0, NULL));
1788   _dbus_assert (!find_subtree (tree, path1, NULL));
1789   _dbus_assert (!find_subtree (tree, path2, NULL));
1790   _dbus_assert (find_subtree (tree, path3, NULL));
1791   _dbus_assert (find_subtree (tree, path4, NULL));
1792   _dbus_assert (find_subtree (tree, path5, NULL));
1793   _dbus_assert (find_subtree (tree, path6, NULL));
1794   _dbus_assert (find_subtree (tree, path7, NULL));
1795   _dbus_assert (find_subtree (tree, path8, NULL));
1796   
1797   _dbus_object_tree_unregister_and_unlock (tree, path3);
1798   _dbus_assert (_dbus_object_tree_get_user_data_unlocked (tree, path3) == NULL);
1799
1800   _dbus_assert (!find_subtree (tree, path0, NULL));
1801   _dbus_assert (!find_subtree (tree, path1, NULL));
1802   _dbus_assert (!find_subtree (tree, path2, NULL));
1803   _dbus_assert (!find_subtree (tree, path3, NULL));
1804   _dbus_assert (find_subtree (tree, path4, NULL));
1805   _dbus_assert (find_subtree (tree, path5, NULL));
1806   _dbus_assert (find_subtree (tree, path6, NULL));
1807   _dbus_assert (find_subtree (tree, path7, NULL));
1808   _dbus_assert (find_subtree (tree, path8, NULL));
1809   
1810   _dbus_object_tree_unregister_and_unlock (tree, path4);
1811   _dbus_assert (_dbus_object_tree_get_user_data_unlocked (tree, path4) == NULL);
1812
1813   _dbus_assert (!find_subtree (tree, path0, NULL));
1814   _dbus_assert (!find_subtree (tree, path1, NULL));
1815   _dbus_assert (!find_subtree (tree, path2, NULL));
1816   _dbus_assert (!find_subtree (tree, path3, NULL));
1817   _dbus_assert (!find_subtree (tree, path4, NULL));
1818   _dbus_assert (find_subtree (tree, path5, NULL));
1819   _dbus_assert (find_subtree (tree, path6, NULL));
1820   _dbus_assert (find_subtree (tree, path7, NULL));
1821   _dbus_assert (find_subtree (tree, path8, NULL));
1822   
1823   _dbus_object_tree_unregister_and_unlock (tree, path5);
1824   _dbus_assert (_dbus_object_tree_get_user_data_unlocked (tree, path5) == NULL);
1825
1826   _dbus_assert (!find_subtree (tree, path0, NULL));
1827   _dbus_assert (!find_subtree (tree, path1, NULL));
1828   _dbus_assert (!find_subtree (tree, path2, NULL));
1829   _dbus_assert (!find_subtree (tree, path3, NULL));
1830   _dbus_assert (!find_subtree (tree, path4, NULL));
1831   _dbus_assert (!find_subtree (tree, path5, NULL));
1832   _dbus_assert (find_subtree (tree, path6, NULL));
1833   _dbus_assert (find_subtree (tree, path7, NULL));
1834   _dbus_assert (find_subtree (tree, path8, NULL));
1835   
1836   _dbus_object_tree_unregister_and_unlock (tree, path6);
1837   _dbus_assert (_dbus_object_tree_get_user_data_unlocked (tree, path6) == NULL);
1838
1839   _dbus_assert (!find_subtree (tree, path0, NULL));
1840   _dbus_assert (!find_subtree (tree, path1, NULL));
1841   _dbus_assert (!find_subtree (tree, path2, NULL));
1842   _dbus_assert (!find_subtree (tree, path3, NULL));
1843   _dbus_assert (!find_subtree (tree, path4, NULL));
1844   _dbus_assert (!find_subtree (tree, path5, NULL));
1845   _dbus_assert (!find_subtree (tree, path6, NULL));
1846   _dbus_assert (find_subtree (tree, path7, NULL));
1847   _dbus_assert (find_subtree (tree, path8, NULL));
1848
1849   _dbus_object_tree_unregister_and_unlock (tree, path7);
1850   _dbus_assert (_dbus_object_tree_get_user_data_unlocked (tree, path7) == NULL);
1851
1852   _dbus_assert (!find_subtree (tree, path0, NULL));
1853   _dbus_assert (!find_subtree (tree, path1, NULL));
1854   _dbus_assert (!find_subtree (tree, path2, NULL));
1855   _dbus_assert (!find_subtree (tree, path3, NULL));
1856   _dbus_assert (!find_subtree (tree, path4, NULL));
1857   _dbus_assert (!find_subtree (tree, path5, NULL));
1858   _dbus_assert (!find_subtree (tree, path6, NULL));
1859   _dbus_assert (!find_subtree (tree, path7, NULL));
1860   _dbus_assert (find_subtree (tree, path8, NULL));
1861
1862   _dbus_object_tree_unregister_and_unlock (tree, path8);
1863   _dbus_assert (_dbus_object_tree_get_user_data_unlocked (tree, path8) == NULL);
1864
1865   _dbus_assert (!find_subtree (tree, path0, NULL));
1866   _dbus_assert (!find_subtree (tree, path1, NULL));
1867   _dbus_assert (!find_subtree (tree, path2, NULL));
1868   _dbus_assert (!find_subtree (tree, path3, NULL));
1869   _dbus_assert (!find_subtree (tree, path4, NULL));
1870   _dbus_assert (!find_subtree (tree, path5, NULL));
1871   _dbus_assert (!find_subtree (tree, path6, NULL));
1872   _dbus_assert (!find_subtree (tree, path7, NULL));
1873   _dbus_assert (!find_subtree (tree, path8, NULL));
1874   
1875   i = 0;
1876   while (i < (int) _DBUS_N_ELEMENTS (tree_test_data))
1877     {
1878       _dbus_assert (tree_test_data[i].handler_unregistered);
1879       _dbus_assert (!tree_test_data[i].message_handled);
1880       ++i;
1881     }
1882
1883   /* Register it all again, and test dispatch */
1884   
1885   if (!do_register (tree, path0, TRUE, 0, tree_test_data))
1886     goto out;
1887   if (!do_register (tree, path1, FALSE, 1, tree_test_data))
1888     goto out;
1889   if (!do_register (tree, path2, TRUE, 2, tree_test_data))
1890     goto out;
1891   if (!do_register (tree, path3, TRUE, 3, tree_test_data))
1892     goto out;
1893   if (!do_register (tree, path4, TRUE, 4, tree_test_data))
1894     goto out;
1895   if (!do_register (tree, path5, TRUE, 5, tree_test_data))
1896     goto out;
1897   if (!do_register (tree, path6, FALSE, 6, tree_test_data))
1898     goto out;
1899   if (!do_register (tree, path7, TRUE, 7, tree_test_data))
1900     goto out;
1901   if (!do_register (tree, path8, TRUE, 8, tree_test_data))
1902     goto out;
1903
1904 #if 0
1905   spew_tree (tree);
1906 #endif
1907
1908   if (!do_test_dispatch (tree, path0, 0, tree_test_data, _DBUS_N_ELEMENTS (tree_test_data)))
1909     goto out;
1910   if (!do_test_dispatch (tree, path1, 1, tree_test_data, _DBUS_N_ELEMENTS (tree_test_data)))
1911     goto out;
1912   if (!do_test_dispatch (tree, path2, 2, tree_test_data, _DBUS_N_ELEMENTS (tree_test_data)))
1913     goto out;
1914   if (!do_test_dispatch (tree, path3, 3, tree_test_data, _DBUS_N_ELEMENTS (tree_test_data)))
1915     goto out;
1916   if (!do_test_dispatch (tree, path4, 4, tree_test_data, _DBUS_N_ELEMENTS (tree_test_data)))
1917     goto out;
1918   if (!do_test_dispatch (tree, path5, 5, tree_test_data, _DBUS_N_ELEMENTS (tree_test_data)))
1919     goto out;
1920   if (!do_test_dispatch (tree, path6, 6, tree_test_data, _DBUS_N_ELEMENTS (tree_test_data)))
1921     goto out;
1922   if (!do_test_dispatch (tree, path7, 7, tree_test_data, _DBUS_N_ELEMENTS (tree_test_data)))
1923     goto out;
1924   if (!do_test_dispatch (tree, path8, 8, tree_test_data, _DBUS_N_ELEMENTS (tree_test_data)))
1925     goto out;
1926   
1927  out:
1928   if (tree)
1929     {
1930       /* test ref */
1931       _dbus_object_tree_ref (tree);
1932       _dbus_object_tree_unref (tree);
1933       _dbus_object_tree_unref (tree);
1934     }
1935
1936   return TRUE;
1937 }
1938
1939 /**
1940  * @ingroup DBusObjectTree
1941  * Unit test for DBusObjectTree
1942  * @returns #TRUE on success.
1943  */
1944 dbus_bool_t
1945 _dbus_object_tree_test (void)
1946 {
1947   _dbus_test_oom_handling ("object tree",
1948                            object_tree_test_iteration,
1949                            NULL);
1950
1951   return TRUE;
1952 }
1953
1954 #endif /* !DOXYGEN_SHOULD_SKIP_THIS */
1955
1956 #endif /* DBUS_BUILD_TESTS */