GSocket: Add possibility to join a multicast group only on a specific interface
[platform/upstream/glib.git] / gio / gsocket.h
1 /*
2  * Copyright © 2008 Christian Kellner, Samuel Cormier-Iijima
3  * Copyright © 2009 Codethink Limited
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  * Authors: Christian Kellner <gicmo@gnome.org>
21  *          Samuel Cormier-Iijima <sciyoshi@gmail.com>
22  *          Ryan Lortie <desrt@desrt.ca>
23  */
24
25 #if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
26 #error "Only <gio/gio.h> can be included directly."
27 #endif
28
29 #ifndef __G_SOCKET_H__
30 #define __G_SOCKET_H__
31
32 #include <gio/giotypes.h>
33
34 G_BEGIN_DECLS
35
36 #define G_TYPE_SOCKET                                       (g_socket_get_type ())
37 #define G_SOCKET(inst)                                      (G_TYPE_CHECK_INSTANCE_CAST ((inst),                     \
38                                                              G_TYPE_SOCKET, GSocket))
39 #define G_SOCKET_CLASS(class)                               (G_TYPE_CHECK_CLASS_CAST ((class),                       \
40                                                              G_TYPE_SOCKET, GSocketClass))
41 #define G_IS_SOCKET(inst)                                   (G_TYPE_CHECK_INSTANCE_TYPE ((inst),                     \
42                                                              G_TYPE_SOCKET))
43 #define G_IS_SOCKET_CLASS(class)                            (G_TYPE_CHECK_CLASS_TYPE ((class),                       \
44                                                              G_TYPE_SOCKET))
45 #define G_SOCKET_GET_CLASS(inst)                            (G_TYPE_INSTANCE_GET_CLASS ((inst),                      \
46                                                              G_TYPE_SOCKET, GSocketClass))
47
48 typedef struct _GSocketPrivate                              GSocketPrivate;
49 typedef struct _GSocketClass                                GSocketClass;
50
51 struct _GSocketClass
52 {
53   GObjectClass parent_class;
54
55   /*< private >*/
56
57   /* Padding for future expansion */
58   void (*_g_reserved1) (void);
59   void (*_g_reserved2) (void);
60   void (*_g_reserved3) (void);
61   void (*_g_reserved4) (void);
62   void (*_g_reserved5) (void);
63   void (*_g_reserved6) (void);
64   void (*_g_reserved7) (void);
65   void (*_g_reserved8) (void);
66   void (*_g_reserved9) (void);
67   void (*_g_reserved10) (void);
68 };
69
70 struct _GSocket
71 {
72   GObject parent_instance;
73   GSocketPrivate *priv;
74 };
75
76 GType                  g_socket_get_type                (void) G_GNUC_CONST;
77 GSocket *              g_socket_new                     (GSocketFamily            family,
78                                                          GSocketType              type,
79                                                          GSocketProtocol          protocol,
80                                                          GError                 **error);
81 GSocket *              g_socket_new_from_fd             (gint                     fd,
82                                                          GError                 **error);
83 int                    g_socket_get_fd                  (GSocket                 *socket);
84 GSocketFamily          g_socket_get_family              (GSocket                 *socket);
85 GSocketType            g_socket_get_socket_type         (GSocket                 *socket);
86 GSocketProtocol        g_socket_get_protocol            (GSocket                 *socket);
87 GSocketAddress *       g_socket_get_local_address       (GSocket                 *socket,
88                                                          GError                 **error);
89 GSocketAddress *       g_socket_get_remote_address      (GSocket                 *socket,
90                                                          GError                 **error);
91 void                   g_socket_set_blocking            (GSocket                 *socket,
92                                                          gboolean                 blocking);
93 gboolean               g_socket_get_blocking            (GSocket                 *socket);
94 void                   g_socket_set_keepalive           (GSocket                 *socket,
95                                                          gboolean                 keepalive);
96 gboolean               g_socket_get_keepalive           (GSocket                 *socket);
97 gint                   g_socket_get_listen_backlog      (GSocket                 *socket);
98 void                   g_socket_set_listen_backlog      (GSocket                 *socket,
99                                                          gint                     backlog);
100 guint                  g_socket_get_timeout             (GSocket                 *socket);
101 void                   g_socket_set_timeout             (GSocket                 *socket,
102                                                          guint                    timeout);
103 gboolean               g_socket_get_multicast_loopback  (GSocket                 *socket);
104 void                   g_socket_set_multicast_loopback  (GSocket                 *socket,
105                                                          gboolean                 loopback);
106 guint                  g_socket_get_multicast_ttl       (GSocket                 *socket);
107 void                   g_socket_set_multicast_ttl       (GSocket                 *socket,
108                                                          guint                    ttl);
109 gboolean               g_socket_is_connected            (GSocket                 *socket);
110 gboolean               g_socket_bind                    (GSocket                 *socket,
111                                                          GSocketAddress          *address,
112                                                          gboolean                 allow_reuse,
113                                                          GError                 **error);
114 gboolean               g_socket_join_multicast_group    (GSocket                 *socket,
115                                                          GInetAddress            *group,
116                                                          const gchar             *interface,
117                                                          GError                 **error);
118 gboolean               g_socket_leave_multicast_group   (GSocket                 *socket,
119                                                          GInetAddress            *group,
120                                                          const gchar             *interface,
121                                                          GError                 **error);
122 gboolean               g_socket_connect                 (GSocket                 *socket,
123                                                          GSocketAddress          *address,
124                                                          GCancellable            *cancellable,
125                                                          GError                 **error);
126 gboolean               g_socket_check_connect_result    (GSocket                 *socket,
127                                                          GError                 **error);
128
129 GIOCondition           g_socket_condition_check         (GSocket                 *socket,
130                                                          GIOCondition             condition);
131 gboolean               g_socket_condition_wait          (GSocket                 *socket,
132                                                          GIOCondition             condition,
133                                                          GCancellable            *cancellable,
134                                                          GError                 **error);
135 GSocket *              g_socket_accept                  (GSocket                 *socket,
136                                                          GCancellable            *cancellable,
137                                                          GError                 **error);
138 gboolean               g_socket_listen                  (GSocket                 *socket,
139                                                          GError                 **error);
140 gssize                 g_socket_receive                 (GSocket                 *socket,
141                                                          gchar                   *buffer,
142                                                          gsize                    size,
143                                                          GCancellable            *cancellable,
144                                                          GError                 **error);
145 gssize                 g_socket_receive_from            (GSocket                 *socket,
146                                                          GSocketAddress         **address,
147                                                          gchar                   *buffer,
148                                                          gsize                    size,
149                                                          GCancellable            *cancellable,
150                                                          GError                 **error);
151 gssize                 g_socket_send                    (GSocket                 *socket,
152                                                          const gchar             *buffer,
153                                                          gsize                    size,
154                                                          GCancellable            *cancellable,
155                                                          GError                 **error);
156 gssize                 g_socket_send_to                 (GSocket                 *socket,
157                                                          GSocketAddress          *address,
158                                                          const gchar             *buffer,
159                                                          gsize                    size,
160                                                          GCancellable            *cancellable,
161                                                          GError                 **error);
162 gssize                 g_socket_receive_message         (GSocket                 *socket,
163                                                          GSocketAddress         **address,
164                                                          GInputVector            *vectors,
165                                                          gint                     num_vectors,
166                                                          GSocketControlMessage ***messages,
167                                                          gint                    *num_messages,
168                                                          gint                    *flags,
169                                                          GCancellable            *cancellable,
170                                                          GError                 **error);
171 gssize                 g_socket_send_message            (GSocket                 *socket,
172                                                          GSocketAddress          *address,
173                                                          GOutputVector           *vectors,
174                                                          gint                     num_vectors,
175                                                          GSocketControlMessage  **messages,
176                                                          gint                     num_messages,
177                                                          gint                     flags,
178                                                          GCancellable            *cancellable,
179                                                          GError                 **error);
180 gboolean               g_socket_close                   (GSocket                 *socket,
181                                                          GError                 **error);
182 gboolean               g_socket_shutdown                (GSocket                 *socket,
183                                                          gboolean                 shutdown_read,
184                                                          gboolean                 shutdown_write,
185                                                          GError                 **error);
186 gboolean               g_socket_is_closed               (GSocket                 *socket);
187 GSource *              g_socket_create_source           (GSocket                 *socket,
188                                                          GIOCondition             condition,
189                                                          GCancellable            *cancellable);
190 gboolean               g_socket_speaks_ipv4             (GSocket                 *socket);
191 GCredentials          *g_socket_get_credentials         (GSocket                 *socket,
192                                                          GError                 **error);
193
194 gssize                 g_socket_receive_with_blocking   (GSocket                 *socket,
195                                                          gchar                   *buffer,
196                                                          gsize                    size,
197                                                          gboolean                 blocking,
198                                                          GCancellable            *cancellable,
199                                                          GError                 **error);
200 gssize                 g_socket_send_with_blocking      (GSocket                 *socket,
201                                                          const gchar             *buffer,
202                                                          gsize                    size,
203                                                          gboolean                 blocking,
204                                                          GCancellable            *cancellable,
205                                                          GError                 **error);
206
207 G_END_DECLS
208
209 #endif /* __G_SOCKET_H__ */