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   gpointer padding[16];
  80 };
  81
  82 GType             g_dbus_server_get_type           (void) G_GNUC_CONST;
  83 GDBusServer      *g_dbus_server_new_sync           (const gchar       *address,
  84                                                     GDBusServerFlags   flags,
  85                                                     const gchar       *guid,
  86                                                     GDBusAuthObserver *observer,
  87                                                     GCancellable      *cancellable,
  88                                                     GError           **error);
  89 const gchar      *g_dbus_server_get_client_address (GDBusServer       *server);
  90 const gchar      *g_dbus_server_get_guid           (GDBusServer       *server);
  91 GDBusServerFlags  g_dbus_server_get_flags          (GDBusServer       *server);
  92 void              g_dbus_server_start              (GDBusServer       *server);
  93 void              g_dbus_server_stop               (GDBusServer       *server);
  94 gboolean          g_dbus_server_is_active          (GDBusServer       *server);
  95
  96 G_END_DECLS
  97
  98 #endif /* __G_DBUS_SERVER_H__ */