5822b9cf3276cd15e55d76d3fe5f92fcffe3c835
[platform/upstream/glib.git] / gio / gdbusserver.h
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 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, write to the
17  * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
18  * Boston, MA 02111-1307, USA.
19  *
20  * Author: David Zeuthen <davidz@redhat.com>
21  */
22
23 #ifndef __G_DBUS_SERVER_H__
24 #define __G_DBUS_SERVER_H__
25
26 #include <gio/giotypes.h>
27
28 G_BEGIN_DECLS
29
30 #define G_TYPE_DBUS_SERVER         (g_dbus_server_get_type ())
31 #define G_DBUS_SERVER(o)           (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_DBUS_SERVER, GDBusServer))
32 #define G_DBUS_SERVER_CLASS(k)     (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_DBUS_SERVER, GDBusServerClass))
33 #define G_DBUS_SERVER_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_DBUS_SERVER, GDBusServerClass))
34 #define G_IS_DBUS_SERVER(o)        (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_DBUS_SERVER))
35 #define G_IS_DBUS_SERVER_CLASS(k)  (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_DBUS_SERVER))
36
37 typedef struct _GDBusServerClass   GDBusServerClass;
38 typedef struct _GDBusServerPrivate GDBusServerPrivate;
39
40 /**
41  * GDBusServer:
42  *
43  * The #GDBusServer structure contains only private data and
44  * should only be accessed using the provided API.
45  *
46  * Since: 2.26
47  */
48 struct _GDBusServer
49 {
50   /*< private >*/
51   GObject parent_instance;
52   GDBusServerPrivate *priv;
53 };
54
55 /**
56  * GDBusServerClass:
57  * @new_connection: Signal class handler for the #GDBusServer::new-connection signal.
58  *
59  * Class structure for #GDBusServer.
60  *
61  * Since: 2.26
62  */
63 struct _GDBusServerClass
64 {
65   /*< private >*/
66   GObjectClass parent_class;
67
68   /*< public >*/
69   /* Signals */
70   void (*new_connection) (GDBusServer      *server,
71                           GDBusConnection  *connection);
72
73   /*< private >*/
74   /* Padding for future expansion */
75   void (*_g_reserved1) (void);
76   void (*_g_reserved2) (void);
77   void (*_g_reserved3) (void);
78   void (*_g_reserved4) (void);
79   void (*_g_reserved5) (void);
80   void (*_g_reserved6) (void);
81   void (*_g_reserved7) (void);
82   void (*_g_reserved8) (void);
83 };
84
85 GType             g_dbus_server_get_type           (void) G_GNUC_CONST;
86 GDBusServer      *g_dbus_server_new_sync           (const gchar       *address,
87                                                     GDBusServerFlags   flags,
88                                                     const gchar       *guid,
89                                                     GDBusAuthObserver *observer,
90                                                     GCancellable      *cancellable,
91                                                     GError           **error);
92 const gchar      *g_dbus_server_get_client_address (GDBusServer       *server);
93 const gchar      *g_dbus_server_get_guid           (GDBusServer       *server);
94 GDBusServerFlags  g_dbus_server_get_flags          (GDBusServer       *server);
95 void              g_dbus_server_start              (GDBusServer       *server);
96 void              g_dbus_server_stop               (GDBusServer       *server);
97 gboolean          g_dbus_server_is_active          (GDBusServer       *server);
98
99 G_END_DECLS
100
101 #endif /* __G_DBUS_SERVER_H__ */