1 /* GDBus - GLib D-Bus Library
2 *
3 * Copyright (C) 2008-2010 Red Hat, Inc.
4 *
5 * SPDX-License-Identifier: LGPL-2.1-or-later
6 *
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.
11 *
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.
16 *
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/>.
19 *
20 * Author: David Zeuthen <davidz@redhat.com>
21 */
22
23 #ifndef __G_DBUS_MESSAGE_H__
24 #define __G_DBUS_MESSAGE_H__
25
26 #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
27 #error "Only <gio/gio.h> can be included directly."
28 #endif
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_IS_DBUS_MESSAGE(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_DBUS_MESSAGE))
37
38 GIO_AVAILABLE_IN_ALL
39 GType g_dbus_message_get_type (void) G_GNUC_CONST;
40 GIO_AVAILABLE_IN_ALL
41 GDBusMessage *g_dbus_message_new (void);
42 GIO_AVAILABLE_IN_ALL
43 GDBusMessage *g_dbus_message_new_signal (const gchar *path,
44 const gchar *interface_,
45 const gchar *signal);
46 GIO_AVAILABLE_IN_ALL
47 GDBusMessage *g_dbus_message_new_method_call (const gchar *name,
48 const gchar *path,
49 const gchar *interface_,
50 const gchar *method);
51 GIO_AVAILABLE_IN_ALL
52 GDBusMessage *g_dbus_message_new_method_reply (GDBusMessage *method_call_message);
53 GIO_AVAILABLE_IN_ALL
54 GDBusMessage *g_dbus_message_new_method_error (GDBusMessage *method_call_message,
55 const gchar *error_name,
56 const gchar *error_message_format,
57 ...) G_GNUC_PRINTF(3, 4);
58 GIO_AVAILABLE_IN_ALL
59 GDBusMessage *g_dbus_message_new_method_error_valist (GDBusMessage *method_call_message,
60 const gchar *error_name,
61 const gchar *error_message_format,
62 va_list var_args);
63 GIO_AVAILABLE_IN_ALL
64 GDBusMessage *g_dbus_message_new_method_error_literal (GDBusMessage *method_call_message,
65 const gchar *error_name,
66 const gchar *error_message);
67 GIO_AVAILABLE_IN_ALL
68 gchar *g_dbus_message_print (GDBusMessage *message,
69 guint indent);
70 GIO_AVAILABLE_IN_ALL
71 gboolean g_dbus_message_get_locked (GDBusMessage *message);
72 GIO_AVAILABLE_IN_ALL
73 void g_dbus_message_lock (GDBusMessage *message);
74 GIO_AVAILABLE_IN_ALL
75 GDBusMessage *g_dbus_message_copy (GDBusMessage *message,
76 GError **error);
77 GIO_AVAILABLE_IN_ALL
78 GDBusMessageByteOrder g_dbus_message_get_byte_order (GDBusMessage *message);
79 GIO_AVAILABLE_IN_ALL
80 void g_dbus_message_set_byte_order (GDBusMessage *message,
81 GDBusMessageByteOrder byte_order);
82
83 GIO_AVAILABLE_IN_ALL
84 GDBusMessageType g_dbus_message_get_message_type (GDBusMessage *message);
85 GIO_AVAILABLE_IN_ALL
86 void g_dbus_message_set_message_type (GDBusMessage *message,
87 GDBusMessageType type);
88 GIO_AVAILABLE_IN_ALL
89 GDBusMessageFlags g_dbus_message_get_flags (GDBusMessage *message);
90 GIO_AVAILABLE_IN_ALL
91 void g_dbus_message_set_flags (GDBusMessage *message,
92 GDBusMessageFlags flags);
93 GIO_AVAILABLE_IN_ALL
94 guint32 g_dbus_message_get_serial (GDBusMessage *message);
95 GIO_AVAILABLE_IN_ALL
96 void g_dbus_message_set_serial (GDBusMessage *message,
97 guint32 serial);
98 GIO_AVAILABLE_IN_ALL
99 GVariant *g_dbus_message_get_header (GDBusMessage *message,
100 GDBusMessageHeaderField header_field);
101 GIO_AVAILABLE_IN_ALL
102 void g_dbus_message_set_header (GDBusMessage *message,
103 GDBusMessageHeaderField header_field,
104 GVariant *value);
105 GIO_AVAILABLE_IN_ALL
106 guchar *g_dbus_message_get_header_fields (GDBusMessage *message);
107 GIO_AVAILABLE_IN_ALL
108 GVariant *g_dbus_message_get_body (GDBusMessage *message);
109 GIO_AVAILABLE_IN_ALL
110 void g_dbus_message_set_body (GDBusMessage *message,
111 GVariant *body);
112
113 #ifdef G_OS_UNIX
114
115 GIO_AVAILABLE_IN_ALL
116 GUnixFDList *g_dbus_message_get_unix_fd_list (GDBusMessage *message);
117 GIO_AVAILABLE_IN_ALL
118 void g_dbus_message_set_unix_fd_list (GDBusMessage *message,
119 GUnixFDList *fd_list);
120
121 #endif /* G_OS_UNIX */
122
123 GIO_AVAILABLE_IN_ALL
124 guint32 g_dbus_message_get_reply_serial (GDBusMessage *message);
125 GIO_AVAILABLE_IN_ALL
126 void g_dbus_message_set_reply_serial (GDBusMessage *message,
127 guint32 value);
128
129 GIO_AVAILABLE_IN_ALL
130 const gchar *g_dbus_message_get_interface (GDBusMessage *message);
131 GIO_AVAILABLE_IN_ALL
132 void g_dbus_message_set_interface (GDBusMessage *message,
133 const gchar *value);
134
135 GIO_AVAILABLE_IN_ALL
136 const gchar *g_dbus_message_get_member (GDBusMessage *message);
137 GIO_AVAILABLE_IN_ALL
138 void g_dbus_message_set_member (GDBusMessage *message,
139 const gchar *value);
140
141 GIO_AVAILABLE_IN_ALL
142 const gchar *g_dbus_message_get_path (GDBusMessage *message);
143 GIO_AVAILABLE_IN_ALL
144 void g_dbus_message_set_path (GDBusMessage *message,
145 const gchar *value);
146
147 GIO_AVAILABLE_IN_ALL
148 const gchar *g_dbus_message_get_sender (GDBusMessage *message);
149 GIO_AVAILABLE_IN_ALL
150 void g_dbus_message_set_sender (GDBusMessage *message,
151 const gchar *value);
152
153 GIO_AVAILABLE_IN_ALL
154 const gchar *g_dbus_message_get_destination (GDBusMessage *message);
155 GIO_AVAILABLE_IN_ALL
156 void g_dbus_message_set_destination (GDBusMessage *message,
157 const gchar *value);
158
159 GIO_AVAILABLE_IN_ALL
160 const gchar *g_dbus_message_get_error_name (GDBusMessage *message);
161 GIO_AVAILABLE_IN_ALL
162 void g_dbus_message_set_error_name (GDBusMessage *message,
163 const gchar *value);
164
165 GIO_AVAILABLE_IN_ALL
166 const gchar *g_dbus_message_get_signature (GDBusMessage *message);
167 GIO_AVAILABLE_IN_ALL
168 void g_dbus_message_set_signature (GDBusMessage *message,
169 const gchar *value);
170
171 GIO_AVAILABLE_IN_ALL
172 guint32 g_dbus_message_get_num_unix_fds (GDBusMessage *message);
173 GIO_AVAILABLE_IN_ALL
174 void g_dbus_message_set_num_unix_fds (GDBusMessage *message,
175 guint32 value);
176
177 GIO_AVAILABLE_IN_ALL
178 const gchar *g_dbus_message_get_arg0 (GDBusMessage *message);
179 GIO_AVAILABLE_IN_2_80
180 const gchar *g_dbus_message_get_arg0_path (GDBusMessage *message);
181
182 GIO_AVAILABLE_IN_ALL
183 GDBusMessage *g_dbus_message_new_from_blob (guchar *blob,
184 gsize blob_len,
185 GDBusCapabilityFlags capabilities,
186 GError **error);
187
188 GIO_AVAILABLE_IN_ALL
189 gssize g_dbus_message_bytes_needed (guchar *blob,
190 gsize blob_len,
191 GError **error);
192
193 GIO_AVAILABLE_IN_ALL
194 guchar *g_dbus_message_to_blob (GDBusMessage *message,
195 gsize *out_size,
196 GDBusCapabilityFlags capabilities,
197 GError **error);
198
199 GIO_AVAILABLE_IN_ALL
200 gboolean g_dbus_message_to_gerror (GDBusMessage *message,
201 GError **error);
202
203 G_END_DECLS
204
205 #endif /* __G_DBUS_MESSAGE_H__ */