Bug 621213 – GDBusProxy and well-known names
[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 #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
24 #error "Only <gio/gio.h> can be included directly."
25 #endif
26
27 #ifndef __G_DBUS_SERVER_H__
28 #define __G_DBUS_SERVER_H__
29
30 #include <gio/giotypes.h>
31
32 G_BEGIN_DECLS
33
34 #define G_TYPE_DBUS_SERVER         (g_dbus_server_get_type ())
35 #define G_DBUS_SERVER(o)           (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_DBUS_SERVER, GDBusServer))
36 #define G_DBUS_SERVER_CLASS(k)     (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_DBUS_SERVER, GDBusServerClass))
37 #define G_DBUS_SERVER_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_DBUS_SERVER, GDBusServerClass))
38 #define G_IS_DBUS_SERVER(o)        (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_DBUS_SERVER))
39 #define G_IS_DBUS_SERVER_CLASS(k)  (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_DBUS_SERVER))
40
41 typedef struct _GDBusServerClass   GDBusServerClass;
42 typedef struct _GDBusServerPrivate GDBusServerPrivate;
43
44 /**
45  * GDBusServer:
46  *
47  * The #GDBusServer structure contains only private data and
48  * should only be accessed using the provided API.
49  *
50  * Since: 2.26
51  */
52 struct _GDBusServer
53 {
54   /*< private >*/
55   GObject parent_instance;
56   GDBusServerPrivate *priv;
57 };
58
59 /**
60  * GDBusServerClass:
61  * @new_connection: Signal class handler for the #GDBusServer::new-connection signal.
62  *
63  * Class structure for #GDBusServer.
64  *
65  * Since: 2.26
66  */
67 struct _GDBusServerClass
68 {
69   /*< private >*/
70   GObjectClass parent_class;
71
72   /*< public >*/
73   /* Signals */
74   void (*new_connection) (GDBusServer      *server,
75                           GDBusConnection  *connection);
76
77   /*< private >*/
78   /* Padding for future expansion */
79   void (*_g_reserved1) (void);
80   void (*_g_reserved2) (void);
81   void (*_g_reserved3) (void);
82   void (*_g_reserved4) (void);
83   void (*_g_reserved5) (void);
84   void (*_g_reserved6) (void);
85   void (*_g_reserved7) (void);
86   void (*_g_reserved8) (void);
87 };
88
89 GType             g_dbus_server_get_type           (void) G_GNUC_CONST;
90 GDBusServer      *g_dbus_server_new_sync           (const gchar       *address,
91                                                     GDBusServerFlags   flags,
92                                                     const gchar       *guid,
93                                                     GDBusAuthObserver *observer,
94                                                     GCancellable      *cancellable,
95                                                     GError           **error);
96 const gchar      *g_dbus_server_get_client_address (GDBusServer       *server);
97 const gchar      *g_dbus_server_get_guid           (GDBusServer       *server);
98 GDBusServerFlags  g_dbus_server_get_flags          (GDBusServer       *server);
99 void              g_dbus_server_start              (GDBusServer       *server);
100 void              g_dbus_server_stop               (GDBusServer       *server);
101 gboolean          g_dbus_server_is_active          (GDBusServer       *server);
102
103 G_END_DECLS
104
105 #endif /* __G_DBUS_SERVER_H__ */