Data Structures | |
struct | DBusObjectTree |
Internals of DBusObjectTree. More... | |
struct | DBusObjectSubtree |
Struct representing a single registered subtree handler, or node that's a parent of a registered subtree handler. More... | |
Defines | |
#define | VERBOSE_FIND 0 |
Set to 1 to get a bunch of debug spew about finding the subtree nodes. | |
#define | VERBOSE_DECOMPOSE 0 |
Set to 1 to get a bunch of spew about disassembling the path string. | |
Typedefs | |
typedef DBusObjectSubtree | DBusObjectSubtree |
Subnode of the object hierarchy. | |
Functions | |
DBusObjectTree * | _dbus_object_tree_new (DBusConnection *connection) |
Creates a new object tree, representing a mapping from paths to handler vtables. | |
DBusObjectTree * | _dbus_object_tree_ref (DBusObjectTree *tree) |
Increment the reference count. | |
void | _dbus_object_tree_unref (DBusObjectTree *tree) |
Decrement the reference count. | |
dbus_bool_t | _dbus_object_tree_register (DBusObjectTree *tree, dbus_bool_t fallback, const char **path, const DBusObjectPathVTable *vtable, void *user_data) |
Registers a new subtree in the global object tree. | |
void | _dbus_object_tree_unregister_and_unlock (DBusObjectTree *tree, const char **path) |
Unregisters an object subtree that was registered with the same path. | |
void | _dbus_object_tree_free_all_unlocked (DBusObjectTree *tree) |
Free all the handlers in the tree. | |
DBusHandlerResult | _dbus_object_tree_dispatch_and_unlock (DBusObjectTree *tree, DBusMessage *message) |
Tries to dispatch a message by directing it to handler for the object path listed in the message header, if any. | |
void * | _dbus_object_tree_get_user_data_unlocked (DBusObjectTree *tree, const char **path) |
Looks up the data passed to _dbus_object_tree_register() for a handler at the given path. | |
dbus_bool_t | _dbus_object_tree_list_registered_and_unlock (DBusObjectTree *tree, const char **parent_path, char ***child_entries) |
Lists the registered fallback handlers and object path handlers at the given parent_path. | |
dbus_bool_t | _dbus_decompose_path (const char *data, int len, char ***path, int *path_len) |
Decompose an object path. |
Types and functions related to DBusObjectTree. These are all library-internal.
|
Decompose an object path. A path of just "/" is represented as an empty vector of strings. The path need not be nul terminated.
Definition at line 1058 of file dbus-object-tree.c. References _dbus_assert, _dbus_memdup(), dbus_free_string_array(), dbus_new0, FALSE, NULL, and TRUE. Referenced by dbus_connection_get_object_path_data(), dbus_connection_list_registered(), dbus_connection_register_fallback(), dbus_connection_register_object_path(), dbus_connection_unregister_object_path(), and dbus_message_get_path_decomposed(). |
|
Tries to dispatch a message by directing it to handler for the object path listed in the message header, if any. Messages are dispatched first to the registered handler that matches the largest number of path elements; that is, message to /foo/bar/baz would go to the handler for /foo/bar before the one for /foo.
Definition at line 731 of file dbus-object-tree.c. References _dbus_connection_lock(), _dbus_connection_unlock(), _dbus_list_append(), _dbus_list_get_first_link(), _dbus_list_get_length(), _dbus_list_get_next_link, _dbus_list_remove_link(), connection, DBusList::data, dbus_free_string_array(), DBUS_HANDLER_RESULT_NEED_MEMORY, DBUS_HANDLER_RESULT_NOT_YET_HANDLED, dbus_message_get_path_decomposed(), FALSE, DBusObjectSubtree::invoke_as_fallback, DBusObjectSubtree::message_function, NULL, DBusObjectSubtree::parent, and DBusObjectSubtree::user_data. Referenced by dbus_connection_dispatch(). |
|
Free all the handlers in the tree. Lock on tree's connection must not be held.
Definition at line 547 of file dbus-object-tree.c. References connection, NULL, and root. Referenced by _dbus_object_tree_unref(). |
|
Looks up the data passed to _dbus_object_tree_register() for a handler at the given path.
Definition at line 899 of file dbus-object-tree.c. References _dbus_assert, NULL, and DBusObjectSubtree::user_data. Referenced by dbus_connection_get_object_path_data(). |
|
Lists the registered fallback handlers and object path handlers at the given parent_path. The returned array should be freed with dbus_free_string_array().
Definition at line 1022 of file dbus-object-tree.c. References _dbus_connection_unlock(), and connection. Referenced by dbus_connection_list_registered(). |
|
Creates a new object tree, representing a mapping from paths to handler vtables.
Definition at line 90 of file dbus-object-tree.c. References connection, dbus_free(), dbus_new0, DBusObjectSubtree::invoke_as_fallback, NULL, refcount, root, and TRUE. Referenced by _dbus_connection_new_for_transport(). |
|
Increment the reference count.
Definition at line 127 of file dbus-object-tree.c. References _dbus_assert, and refcount. |
|
Registers a new subtree in the global object tree.
Definition at line 385 of file dbus-object-tree.c. References _dbus_assert, _dbus_warn(), FALSE, DBusObjectSubtree::invoke_as_fallback, DBusObjectPathVTable::message_function, DBusObjectSubtree::message_function, NULL, TRUE, DBusObjectSubtree::unregister_function, DBusObjectPathVTable::unregister_function, and DBusObjectSubtree::user_data. Referenced by dbus_connection_register_fallback(), and dbus_connection_register_object_path(). |
|
Decrement the reference count.
Definition at line 141 of file dbus-object-tree.c. References _dbus_assert, _dbus_object_tree_free_all_unlocked(), dbus_free(), and refcount. Referenced by _dbus_connection_new_for_transport(). |
|
Unregisters an object subtree that was registered with the same path.
Definition at line 428 of file dbus-object-tree.c. References _dbus_assert, _dbus_connection_ref_unlocked(), _dbus_connection_unlock(), _dbus_warn(), connection, dbus_connection_unref(), DBusObjectSubtree::message_function, DBusObjectSubtree::n_subtrees, NULL, DBusObjectSubtree::parent, DBusObjectSubtree::subtrees, DBusObjectSubtree::unregister_function, and DBusObjectSubtree::user_data. Referenced by dbus_connection_unregister_object_path(). |