gio/gdbusmessage.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_MESSAGE_H__
  28 #define __G_DBUS_MESSAGE_H__
  29
  30 #include <gio/giotypes.h>
  31
  32 G_BEGIN_DECLS
  33
  34 #define G_TYPE_DBUS_MESSAGE         (g_dbus_message_get_type ())
  35 #define G_DBUS_MESSAGE(o)           (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_DBUS_MESSAGE, GDBusMessage))
  36 #define G_DBUS_MESSAGE_CLASS(k)     (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_DBUS_MESSAGE, GDBusMessageClass))
  37 #define G_DBUS_MESSAGE_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_DBUS_MESSAGE, GDBusMessageClass))
  38 #define G_IS_DBUS_MESSAGE(o)        (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_DBUS_MESSAGE))
  39 #define G_IS_DBUS_MESSAGE_CLASS(k)  (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_DBUS_MESSAGE))
  40
  41 typedef struct _GDBusMessageClass   GDBusMessageClass;
  42 typedef struct _GDBusMessagePrivate GDBusMessagePrivate;
  43
  44 /**
  45  * GDBusMessageClass:
  46  *
  47  * Class structure for #GDBusMessage.
  48  *
  49  * Since: 2.26
  50  */
  51 struct _GDBusMessageClass
  52 {
  53   /*< private >*/
  54   GObjectClass parent_class;
  55
  56   /*< private >*/
  57   /* Padding for future expansion */
  58   gpointer padding[32];
  59 };
  60
  61 /**
  62  * GDBusMessage:
  63  *
  64  * The #GDBusMessage structure contains only private data and should
  65  * only be accessed using the provided API.
  66  *
  67  * Since: 2.26
  68  */
  69 struct _GDBusMessage
  70 {
  71   /*< private >*/
  72   GObject parent_instance;
  73   GDBusMessagePrivate *priv;
  74 };
  75
  76 GType                     g_dbus_message_get_type           (void) G_GNUC_CONST;
  77 GDBusMessage             *g_dbus_message_new                (void);
  78 GDBusMessage             *g_dbus_message_new_signal         (const gchar              *path,
  79                                                              const gchar              *interface_,
  80                                                              const gchar              *signal);
  81 GDBusMessage             *g_dbus_message_new_method_call    (const gchar              *name,
  82                                                              const gchar              *path,
  83                                                              const gchar              *interface_,
  84                                                              const gchar              *method);
  85 GDBusMessage             *g_dbus_message_new_method_reply   (GDBusMessage             *method_call_message);
  86 GDBusMessage             *g_dbus_message_new_method_error   (GDBusMessage             *method_call_message,
  87                                                              const gchar              *error_name,
  88                                                              const gchar              *error_message_format,
  89                                                              ...);
  90 GDBusMessage             *g_dbus_message_new_method_error_valist (GDBusMessage             *method_call_message,
  91                                                                   const gchar              *error_name,
  92                                                                   const gchar              *error_message_format,
  93                                                                   va_list                   var_args);
  94 GDBusMessage             *g_dbus_message_new_method_error_literal (GDBusMessage             *method_call_message,
  95                                                                    const gchar              *error_name,
  96                                                                    const gchar              *error_message);
  97 gchar                    *g_dbus_message_print              (GDBusMessage             *message,
  98                                                              guint                     indent);
  99
 100 GDBusMessageType          g_dbus_message_get_message_type   (GDBusMessage             *message);
 101 void                      g_dbus_message_set_message_type   (GDBusMessage             *message,
 102                                                              GDBusMessageType          type);
 103 GDBusMessageFlags         g_dbus_message_get_flags          (GDBusMessage             *message);
 104 void                      g_dbus_message_set_flags          (GDBusMessage             *message,
 105                                                              GDBusMessageFlags         flags);
 106 guint32                   g_dbus_message_get_serial         (GDBusMessage             *message);
 107 void                      g_dbus_message_set_serial         (GDBusMessage             *message,
 108                                                              guint32                   serial);
 109 GVariant                 *g_dbus_message_get_header         (GDBusMessage             *message,
 110                                                              GDBusMessageHeaderField   header_field);
 111 void                      g_dbus_message_set_header         (GDBusMessage             *message,
 112                                                              GDBusMessageHeaderField   header_field,
 113                                                              GVariant                 *value);
 114 guchar                   *g_dbus_message_get_header_fields  (GDBusMessage             *message);
 115 GVariant                 *g_dbus_message_get_body           (GDBusMessage             *message);
 116 void                      g_dbus_message_set_body           (GDBusMessage             *message,
 117                                                              GVariant                 *body);
 118 GUnixFDList              *g_dbus_message_get_unix_fd_list   (GDBusMessage             *message);
 119 void                      g_dbus_message_set_unix_fd_list   (GDBusMessage             *message,
 120                                                              GUnixFDList              *fd_list);
 121
 122 guint32                   g_dbus_message_get_reply_serial   (GDBusMessage             *message);
 123 void                      g_dbus_message_set_reply_serial   (GDBusMessage             *message,
 124                                                              guint32                   value);
 125
 126 const gchar              *g_dbus_message_get_interface      (GDBusMessage             *message);
 127 void                      g_dbus_message_set_interface      (GDBusMessage             *message,
 128                                                              const gchar              *value);
 129
 130 const gchar              *g_dbus_message_get_member         (GDBusMessage             *message);
 131 void                      g_dbus_message_set_member         (GDBusMessage             *message,
 132                                                              const gchar              *value);
 133
 134 const gchar              *g_dbus_message_get_path           (GDBusMessage             *message);
 135 void                      g_dbus_message_set_path           (GDBusMessage             *message,
 136                                                              const gchar              *value);
 137
 138 const gchar              *g_dbus_message_get_sender         (GDBusMessage             *message);
 139 void                      g_dbus_message_set_sender         (GDBusMessage             *message,
 140                                                              const gchar              *value);
 141
 142 const gchar              *g_dbus_message_get_destination    (GDBusMessage             *message);
 143 void                      g_dbus_message_set_destination    (GDBusMessage             *message,
 144                                                              const gchar              *value);
 145
 146 const gchar              *g_dbus_message_get_error_name     (GDBusMessage             *message);
 147 void                      g_dbus_message_set_error_name     (GDBusMessage             *message,
 148                                                              const gchar              *value);
 149
 150 const gchar              *g_dbus_message_get_signature      (GDBusMessage             *message);
 151 void                      g_dbus_message_set_signature      (GDBusMessage             *message,
 152                                                              const gchar              *value);
 153
 154 guint32                   g_dbus_message_get_num_unix_fds   (GDBusMessage             *message);
 155 void                      g_dbus_message_set_num_unix_fds   (GDBusMessage             *message,
 156                                                              guint32                   value);
 157
 158 const gchar              *g_dbus_message_get_arg0           (GDBusMessage             *message);
 159
 160
 161 GDBusMessage             *g_dbus_message_new_from_blob      (guchar                   *blob,
 162                                                              gsize                     blob_len,
 163                                                              GDBusCapabilityFlags      capabilities,
 164                                                              GError                  **error);
 165
 166 gssize                    g_dbus_message_bytes_needed       (guchar                   *blob,
 167                                                              gsize                     blob_len,
 168                                                              GError                  **error);
 169
 170 guchar                   *g_dbus_message_to_blob            (GDBusMessage             *message,
 171                                                              gsize                    *out_size,
 172                                                              GDBusCapabilityFlags      capabilities,
 173                                                              GError                  **error);
 174
 175 gboolean                  g_dbus_message_to_gerror          (GDBusMessage             *message,
 176                                                              GError                  **error);
 177
 178 G_END_DECLS
 179
 180 #endif /* __G_DBUS_MESSAGE_H__ */