1 /* GDBus - GLib D-Bus Library
3 * Copyright (C) 2008-2010 Red Hat, Inc.
5 * SPDX-License-Identifier: LGPL-2.1-or-later
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General
18 * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
20 * Author: David Zeuthen <davidz@redhat.com>
23 #ifndef __G_DBUS_NAME_WATCHING_H__
24 #define __G_DBUS_NAME_WATCHING_H__
26 #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
27 #error "Only <gio/gio.h> can be included directly."
30 #include <gio/giotypes.h>
31 #include <gio/tizen_header_glib.h> /* for TIZEN_PUBLIC_DEPRECATED_API */
36 * GBusNameAppearedCallback:
37 * @connection: The #GDBusConnection the name is being watched on.
38 * @name: The name being watched.
39 * @name_owner: Unique name of the owner of the name being watched.
40 * @user_data: User data passed to g_bus_watch_name().
42 * Invoked when the name being watched is known to have to have an owner.
46 typedef void (*GBusNameAppearedCallback) (GDBusConnection *connection,
48 const gchar *name_owner,
52 * GBusNameVanishedCallback:
53 * @connection: The #GDBusConnection the name is being watched on, or
55 * @name: The name being watched.
56 * @user_data: User data passed to g_bus_watch_name().
58 * Invoked when the name being watched is known not to have to have an owner.
60 * This is also invoked when the #GDBusConnection on which the watch was
61 * established has been closed. In that case, @connection will be
66 typedef void (*GBusNameVanishedCallback) (GDBusConnection *connection,
72 guint g_bus_watch_name (GBusType bus_type,
74 GBusNameWatcherFlags flags,
75 GBusNameAppearedCallback name_appeared_handler,
76 GBusNameVanishedCallback name_vanished_handler,
78 GDestroyNotify user_data_free_func) TIZEN_PUBLIC_DEPRECATED_API;
80 guint g_bus_watch_name_on_connection (GDBusConnection *connection,
82 GBusNameWatcherFlags flags,
83 GBusNameAppearedCallback name_appeared_handler,
84 GBusNameVanishedCallback name_vanished_handler,
86 GDestroyNotify user_data_free_func) TIZEN_PUBLIC_DEPRECATED_API;
88 guint g_bus_watch_name_with_closures (GBusType bus_type,
90 GBusNameWatcherFlags flags,
91 GClosure *name_appeared_closure,
92 GClosure *name_vanished_closure) TIZEN_PUBLIC_DEPRECATED_API;
94 guint g_bus_watch_name_on_connection_with_closures (
95 GDBusConnection *connection,
97 GBusNameWatcherFlags flags,
98 GClosure *name_appeared_closure,
99 GClosure *name_vanished_closure) TIZEN_PUBLIC_DEPRECATED_API;
101 void g_bus_unwatch_name (guint watcher_id) TIZEN_PUBLIC_DEPRECATED_API;
105 #endif /* __G_DBUS_NAME_WATCHING_H__ */