pull in gasynchelper (won't need this once gnio is merged into gio)
[cascardo/gnio.git] / gnio / gsocket.h
1 /* GNIO - GLib Network Layer of GIO
2  *
3  * Copyright (C) 2008 Christian Kellner, Samuel Cormier-Iijima
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  */
23
24 #ifndef G_SOCKET_H
25 #define G_SOCKET_H
26
27 #include <glib-object.h>
28 #include <gio/gio.h>
29
30 #include "ginetaddress.h"
31 #include "gsocketaddress.h"
32
33 G_BEGIN_DECLS
34
35 #define G_TYPE_SOCKET         (g_socket_get_type ())
36 #define G_SOCKET(o)           (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_SOCKET, GSocket))
37 #define G_SOCKET_CLASS(k)     (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_SOCKET, GSocketClass))
38 #define G_IS_SOCKET(o)        (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_SOCKET))
39 #define G_IS_SOCKET_CLASS(k)  (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_SOCKET))
40 #define G_SOCKET_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_SOCKET, GSocket))
41
42 typedef struct _GSocket          GSocket;
43 typedef struct _GSocketClass     GSocketClass;
44 typedef struct _GSocketPrivate   GSocketPrivate;
45
46 struct _GSocket
47 {
48   GObject parent;
49
50   GSocketPrivate *priv;
51 };
52
53 struct _GSocketClass
54 {
55   GObjectClass parent_class;
56 };
57
58 GType            g_socket_get_type         (void) G_GNUC_CONST;
59
60 GSocket *        g_socket_new              (gint domain, gint type, gint protocol);
61
62 GSocket *        g_socket_new_from_fd      (gint fd);
63
64 GSocketAddress * g_socket_get_peer_address (GSocket *socket, GError **error);
65
66 void             g_socket_set_blocking     (GSocket  *socket,
67                                             gboolean  blocking);
68
69 gboolean         g_socket_get_blocking     (GSocket  *socket);
70
71 gboolean         g_socket_bind             (GSocket         *socket,
72                                             GSocketAddress  *address,
73                                             GError         **error);
74
75 gboolean         g_socket_connect          (GSocket         *socket,
76                                             GSocketAddress  *address,
77                                             GCancellable    *cancellable,
78                                             GError         **error);
79
80 void             g_socket_connect_async    (GSocket             *socket,
81                                             GSocketAddress      *address,
82                                             GCancellable        *cancellable,
83                                             GAsyncReadyCallback *callback,
84                                             gpointer             user_data);
85
86 gboolean         g_socket_connect_finish   (GSocket       *socket,
87                                             GAsyncResult  *result,
88                                             GError       **error);
89
90 GSocket *        g_socket_accept           (GSocket       *socket,
91                                             GCancellable  *cancellable,
92                                             GError       **error);
93
94 void             g_socket_accept_async     (GSocket             *socket,
95                                             GCancellable        *cancellable,
96                                             GAsyncReadyCallback  callback,
97                                             gpointer             user_data);
98
99 GSocket *        g_socket_accept_finish    (GSocket       *socket,
100                                             GAsyncResult  *result,
101                                             GError       **error);
102
103 void             g_socket_listen           (GSocket *socket,
104                                             gint backlog);
105
106 gssize           g_socket_receive          (GSocket       *socket,
107                                             gchar         *buffer,
108                                             gsize          size,
109                                             GCancellable  *cancellable,
110                                             GError       **error);
111
112 void             g_socket_receive_async    (GSocket             *socket,
113                                             gchar               *buffer,
114                                             gsize                size,
115                                             GCancellable        *cancellable,
116                                             GAsyncReadyCallback *callback,
117                                             gpointer             user_data);
118
119 gssize           g_socket_receive_finish   (GSocket       *socket,
120                                             GAsyncResult  *result,
121                                             GError       **error);
122
123 gssize           g_socket_send             (GSocket       *socket,
124                                             gchar         *buffer,
125                                             gsize          size,
126                                             GCancellable  *cancellable,
127                                             GError       **error);
128
129 void             g_socket_send_async       (GSocket             *socket,
130                                             gchar               *buffer,
131                                             gsize                size,
132                                             GCancellable        *cancellable,
133                                             GAsyncReadyCallback *callback,
134                                             gpointer             user_data);
135
136 gssize           g_socket_send_finish      (GSocket       *socket,
137                                             GAsyncResult  *result,
138                                             GError       **error);
139
140 G_END_DECLS
141
142 #endif /* G_SOCKET_H */
143