Data Structures | |
| struct | DBusWatch |
| Implementation of DBusWatch. More... | |
| struct | DBusWatchList |
| DBusWatchList implementation details. More... | |
Typedefs | |
| typedef DBusWatchList | DBusWatchList |
| Opaque data type representing a list of watches and a set of DBusAddWatchFunction/DBusRemoveWatchFunction. | |
| typedef dbus_bool_t(*) | DBusWatchHandler (DBusWatch *watch, unsigned int flags, void *data) |
| function to run when the watch is handled | |
Functions | |
| DBusWatch * | _dbus_watch_new (int fd, unsigned int flags, dbus_bool_t enabled, DBusWatchHandler handler, void *data, DBusFreeFunction free_data_function) |
| Creates a new DBusWatch. | |
| DBusWatch * | _dbus_watch_ref (DBusWatch *watch) |
| Increments the reference count of a DBusWatch object. | |
| void | _dbus_watch_unref (DBusWatch *watch) |
| Decrements the reference count of a DBusWatch object and finalizes the object if the count reaches zero. | |
| void | _dbus_watch_invalidate (DBusWatch *watch) |
| Clears the file descriptor from a now-invalid watch object so that no one tries to use it. | |
| void | _dbus_watch_sanitize_condition (DBusWatch *watch, unsigned int *condition) |
| Sanitizes the given condition so that it only contains flags that the DBusWatch requested. | |
| DBusWatchList * | _dbus_watch_list_new (void) |
| Creates a new watch list. | |
| void | _dbus_watch_list_free (DBusWatchList *watch_list) |
| Frees a DBusWatchList. | |
| dbus_bool_t | _dbus_watch_list_set_functions (DBusWatchList *watch_list, DBusAddWatchFunction add_function, DBusRemoveWatchFunction remove_function, DBusWatchToggledFunction toggled_function, void *data, DBusFreeFunction free_data_function) |
| Sets the watch functions. | |
| dbus_bool_t | _dbus_watch_list_add_watch (DBusWatchList *watch_list, DBusWatch *watch) |
| Adds a new watch to the watch list, invoking the application DBusAddWatchFunction if appropriate. | |
| void | _dbus_watch_list_remove_watch (DBusWatchList *watch_list, DBusWatch *watch) |
| Removes a watch from the watch list, invoking the application's DBusRemoveWatchFunction if appropriate. | |
| void | _dbus_watch_list_toggle_watch (DBusWatchList *watch_list, DBusWatch *watch, dbus_bool_t enabled) |
| Sets a watch to the given enabled state, invoking the application's DBusWatchToggledFunction if appropriate. | |
| void | _dbus_watch_set_handler (DBusWatch *watch, DBusWatchHandler handler, void *data, DBusFreeFunction free_data_function) |
| Sets the handler for the watch. | |
Opaque data type representing a list of watches and a set of DBusAddWatchFunction/DBusRemoveWatchFunction.
Automatically handles removing/re-adding watches when the DBusAddWatchFunction is updated or changed. Holds a reference count to each watch.
Used in the implementation of both DBusServer and DBusClient.
Definition at line 38 of file dbus-watch.h.
| void _dbus_watch_invalidate | ( | DBusWatch * | watch | ) |
Clears the file descriptor from a now-invalid watch object so that no one tries to use it.
This is because a watch may stay alive due to reference counts after the file descriptor is closed. Invalidation makes it easier to catch bugs. It also keeps people from doing dorky things like assuming file descriptors are unique (never recycled).
| watch | the watch object. |
Definition at line 145 of file dbus-watch.c.
References DBusWatch::fd, and DBusWatch::flags.
Referenced by _dbus_babysitter_unref().
| dbus_bool_t _dbus_watch_list_add_watch | ( | DBusWatchList * | watch_list, | |
| DBusWatch * | watch | |||
| ) |
Adds a new watch to the watch list, invoking the application DBusAddWatchFunction if appropriate.
| watch_list | the watch list. | |
| watch | the watch to add. |
Definition at line 351 of file dbus-watch.c.
References _dbus_list_append(), _dbus_list_remove_last(), _dbus_watch_ref(), _dbus_watch_unref(), DBusWatchList::add_watch_function, dbus_watch_get_socket(), FALSE, NULL, TRUE, DBusWatchList::watch_data, and DBusWatchList::watches.
Referenced by _dbus_connection_add_watch_unlocked(), _dbus_server_add_watch(), and _dbus_spawn_async_with_babysitter().
| void _dbus_watch_list_free | ( | DBusWatchList * | watch_list | ) |
Frees a DBusWatchList.
| watch_list | the watch list. |
Definition at line 225 of file dbus-watch.c.
References _dbus_list_clear(), _dbus_list_foreach(), _dbus_watch_list_set_functions(), _dbus_watch_unref(), dbus_free(), NULL, and DBusWatchList::watches.
Referenced by _dbus_babysitter_unref(), _dbus_connection_new_for_transport(), _dbus_server_finalize_base(), and _dbus_server_init_base().
| DBusWatchList * _dbus_watch_list_new | ( | void | ) |
Creates a new watch list.
Returns NULL if insufficient memory exists.
Definition at line 208 of file dbus-watch.c.
References dbus_new0, and NULL.
Referenced by _dbus_connection_new_for_transport(), and _dbus_server_init_base().
| void _dbus_watch_list_remove_watch | ( | DBusWatchList * | watch_list, | |
| DBusWatch * | watch | |||
| ) |
Removes a watch from the watch list, invoking the application's DBusRemoveWatchFunction if appropriate.
| watch_list | the watch list. | |
| watch | the watch to remove. |
Definition at line 384 of file dbus-watch.c.
References _dbus_assert_not_reached, _dbus_list_remove(), _dbus_watch_unref(), dbus_watch_get_socket(), NULL, DBusWatchList::remove_watch_function, DBusWatchList::watch_data, and DBusWatchList::watches.
Referenced by _dbus_connection_remove_watch_unlocked(), and _dbus_server_remove_watch().
| dbus_bool_t _dbus_watch_list_set_functions | ( | DBusWatchList * | watch_list, | |
| DBusAddWatchFunction | add_function, | |||
| DBusRemoveWatchFunction | remove_function, | |||
| DBusWatchToggledFunction | toggled_function, | |||
| void * | data, | |||
| DBusFreeFunction | free_data_function | |||
| ) |
Sets the watch functions.
This function is the "backend" for dbus_connection_set_watch_functions() and dbus_server_set_watch_functions().
| watch_list | the watch list. | |
| add_function | the add watch function. | |
| remove_function | the remove watch function. | |
| toggled_function | function on toggling enabled flag, or NULL | |
| data | the data for those functions. | |
| free_data_function | the function to free the data. |
Definition at line 253 of file dbus-watch.c.
References _dbus_list_foreach(), _dbus_list_get_first_link(), _dbus_list_get_next_link, DBusWatchList::add_watch_function, DBusList::data, dbus_watch_get_flags(), dbus_watch_get_socket(), DBUS_WATCH_READABLE, DBUS_WATCH_WRITABLE, FALSE, NULL, DBusWatchList::remove_watch_function, TRUE, DBusWatchList::watch_data, DBusWatchList::watch_free_data_function, DBusWatchList::watch_toggled_function, and DBusWatchList::watches.
Referenced by _dbus_babysitter_set_watch_functions(), _dbus_watch_list_free(), dbus_connection_set_watch_functions(), and dbus_server_set_watch_functions().
| void _dbus_watch_list_toggle_watch | ( | DBusWatchList * | watch_list, | |
| DBusWatch * | watch, | |||
| dbus_bool_t | enabled | |||
| ) |
Sets a watch to the given enabled state, invoking the application's DBusWatchToggledFunction if appropriate.
| watch_list | the watch list. | |
| watch | the watch to toggle. | |
| enabled | TRUE to enable |
Definition at line 411 of file dbus-watch.c.
References dbus_watch_get_socket(), DBusWatch::enabled, NULL, DBusWatchList::watch_data, and DBusWatchList::watch_toggled_function.
Referenced by _dbus_connection_toggle_watch_unlocked(), and _dbus_server_toggle_watch().
| DBusWatch * _dbus_watch_new | ( | int | fd, | |
| unsigned int | flags, | |||
| dbus_bool_t | enabled, | |||
| DBusWatchHandler | handler, | |||
| void * | data, | |||
| DBusFreeFunction | free_data_function | |||
| ) |
Creates a new DBusWatch.
Used to add a file descriptor to be polled by a main loop.
| fd | the file descriptor to be watched. | |
| flags | the conditions to watch for on the descriptor. | |
| enabled | the initial enabled state | |
| handler | the handler function | |
| data | data for handler function | |
| free_data_function | function to free the data |
Definition at line 67 of file dbus-watch.c.
References _dbus_assert, dbus_new0, DBusWatch::enabled, DBusWatch::fd, DBusWatch::flags, DBusWatch::free_handler_data_function, DBusWatch::handler, DBusWatch::handler_data, NULL, and DBusWatch::refcount.
Referenced by _dbus_server_new_for_socket(), _dbus_spawn_async_with_babysitter(), and _dbus_transport_new_for_socket().
Increments the reference count of a DBusWatch object.
| watch | the watch object. |
Definition at line 103 of file dbus-watch.c.
References DBusWatch::refcount.
Referenced by _dbus_transport_handle_watch(), and _dbus_watch_list_add_watch().
| void _dbus_watch_sanitize_condition | ( | DBusWatch * | watch, | |
| unsigned int * | condition | |||
| ) |
Sanitizes the given condition so that it only contains flags that the DBusWatch requested.
e.g. if the watch is a DBUS_WATCH_READABLE watch then DBUS_WATCH_WRITABLE will be stripped from the condition.
| watch | the watch object. | |
| condition | address of the condition to sanitize. |
Definition at line 161 of file dbus-watch.c.
References DBUS_WATCH_READABLE, DBUS_WATCH_WRITABLE, and DBusWatch::flags.
Referenced by _dbus_transport_handle_watch(), and dbus_watch_handle().
| void _dbus_watch_set_handler | ( | DBusWatch * | watch, | |
| DBusWatchHandler | handler, | |||
| void * | data, | |||
| DBusFreeFunction | free_data_function | |||
| ) |
Sets the handler for the watch.
| watch | the watch | |
| handler | the new handler | |
| data | the data | |
| free_data_function | free data with this |
Definition at line 445 of file dbus-watch.c.
References DBusWatch::free_handler_data_function, DBusWatch::handler, and DBusWatch::handler_data.
| void _dbus_watch_unref | ( | DBusWatch * | watch | ) |
Decrements the reference count of a DBusWatch object and finalizes the object if the count reaches zero.
| watch | the watch object. |
Definition at line 117 of file dbus-watch.c.
References _dbus_assert, dbus_free(), dbus_watch_set_data(), DBusWatch::free_handler_data_function, DBusWatch::handler_data, NULL, and DBusWatch::refcount.
Referenced by _dbus_babysitter_unref(), _dbus_transport_handle_watch(), _dbus_transport_new_for_socket(), _dbus_watch_list_add_watch(), _dbus_watch_list_free(), and _dbus_watch_list_remove_watch().
1.5.1