1 /* GDBus - GLib D-Bus Library 2 * 3 * Copyright (C) 2008-2010 Red Hat, Inc. 4 * 5 * This library is free software; you can redistribute it and/or 6 * modify it under the terms of the GNU Lesser General Public 7 * License as published by the Free Software Foundation; either 8 * version 2.1 of the License, or (at your option) any later version. 9 * 10 * This library is distributed in the hope that it will be useful, 11 * but WITHOUT ANY WARRANTY; without even the implied warranty of 12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 13 * Lesser General Public License for more details. 14 * 15 * You should have received a copy of the GNU Lesser General 16 * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. 17 * 18 * Author: David Zeuthen <davidz@redhat.com> 19 */ 20 21 #ifndef __G_DBUS_NAME_WATCHING_H__ 22 #define __G_DBUS_NAME_WATCHING_H__ 23 24 #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION) 25 #error "Only <gio/gio.h> can be included directly." 26 #endif 27 28 #include <gio/giotypes.h> 29 30 G_BEGIN_DECLS 31 32 /** 33 * GBusNameAppearedCallback: 34 * @connection: The #GDBusConnection the name is being watched on. 35 * @name: The name being watched. 36 * @name_owner: Unique name of the owner of the name being watched. 37 * @user_data: User data passed to g_bus_watch_name(). 38 * 39 * Invoked when the name being watched is known to have to have an owner. 40 * 41 * Since: 2.26 42 */ 43 typedef void (*GBusNameAppearedCallback) (GDBusConnection *connection, 44 const gchar *name, 45 const gchar *name_owner, 46 gpointer user_data); 47 48 /** 49 * GBusNameVanishedCallback: 50 * @connection: The #GDBusConnection the name is being watched on, or 51 * %NULL. 52 * @name: The name being watched. 53 * @user_data: User data passed to g_bus_watch_name(). 54 * 55 * Invoked when the name being watched is known not to have to have an owner. 56 * 57 * This is also invoked when the #GDBusConnection on which the watch was 58 * established has been closed. In that case, @connection will be 59 * %NULL. 60 * 61 * Since: 2.26 62 */ 63 typedef void (*GBusNameVanishedCallback) (GDBusConnection *connection, 64 const gchar *name, 65 gpointer user_data); 66 67 68 GLIB_AVAILABLE_IN_ALL 69 guint g_bus_watch_name (GBusType bus_type, 70 const gchar *name, 71 GBusNameWatcherFlags flags, 72 GBusNameAppearedCallback name_appeared_handler, 73 GBusNameVanishedCallback name_vanished_handler, 74 gpointer user_data, 75 GDestroyNotify user_data_free_func); 76 GLIB_AVAILABLE_IN_ALL 77 guint g_bus_watch_name_on_connection (GDBusConnection *connection, 78 const gchar *name, 79 GBusNameWatcherFlags flags, 80 GBusNameAppearedCallback name_appeared_handler, 81 GBusNameVanishedCallback name_vanished_handler, 82 gpointer user_data, 83 GDestroyNotify user_data_free_func); 84 GLIB_AVAILABLE_IN_ALL 85 guint g_bus_watch_name_with_closures (GBusType bus_type, 86 const gchar *name, 87 GBusNameWatcherFlags flags, 88 GClosure *name_appeared_closure, 89 GClosure *name_vanished_closure); 90 GLIB_AVAILABLE_IN_ALL 91 guint g_bus_watch_name_on_connection_with_closures ( 92 GDBusConnection *connection, 93 const gchar *name, 94 GBusNameWatcherFlags flags, 95 GClosure *name_appeared_closure, 96 GClosure *name_vanished_closure); 97 GLIB_AVAILABLE_IN_ALL 98 void g_bus_unwatch_name (guint watcher_id); 99 100 G_END_DECLS 101 102 #endif /* __G_DBUS_NAME_WATCHING_H__ */ 103