Beginnings of GSocket API, small fixes for InetAddress
[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              (void);
61
62 gboolean       g_socket_bind             (GSocket         *socket,
63                                           GSocketAddress  *address,
64                                           GError         **error);
65
66 void           g_socket_connect          (GSocket        *socket,
67                                           GSocketAddress *address,
68                                           GCancellable   *cancellable);
69
70 void           g_socket_connect_async    (GSocket             *socket,
71                                           GSocketAddress      *address,
72                                           GCancellable        *cancellable,
73                                           GAsyncReadyCallback *callback,
74                                           gpointer             user_data);
75
76 void           g_socket_connect_finish   (GSocket       *socket,
77                                           GAsyncResult  *result,
78                                           GError       **error);
79
80 GSocket *      g_socket_accept           (GSocket       *socket,
81                                           GCancellable  *cancellable,
82                                           GError       **error);
83
84 void           g_socket_accept_async     (GSocket             *socket,
85                                           GCancellable        *cancellable,
86                                           GAsyncReadyCallback *callback,
87                                           gpointer             user_data);
88
89 GSocket *      g_socket_accept_finish    (GSocket       *socket,
90                                           GAsyncResult  *result,
91                                           GError       **error);
92
93 void           g_socket_listen           (GSocket *socket,
94                                           int backlog);
95
96 gssize         g_socket_receive          (GSocket       *socket,
97                                           gchar         *buffer,
98                                           gsize          size,
99                                           GCancellable  *cancellable,
100                                           GError       **error);
101
102 void           g_socket_receive_async    (GSocket             *socket,
103                                           gchar               *buffer,
104                                           gsize                size,
105                                           GCancellable        *cancellable,
106                                           GAsyncReadyCallback *callback,
107                                           gpointer             user_data);
108
109 gssize         g_socket_receive_finish   (GSocket       *socket,
110                                           GAsyncResult  *result,
111                                           GError       **error);
112
113 gssize         g_socket_send             (GSocket       *socket,
114                                           gchar         *buffer,
115                                           gsize          size,
116                                           GCancellable  *cancellable,
117                                           GError       **error);
118
119 void           g_socket_send_async       (GSocket             *socket,
120                                           gchar               *buffer,
121                                           gsize                size,
122                                           GCancellable        *cancellable,
123                                           GAsyncReadyCallback *callback,
124                                           gpointer             user_data);
125
126 gssize         g_socket_send_finish      (GSocket       *socket,
127                                           GAsyncResult  *result,
128                                           GError       **error);
129
130 G_END_DECLS
131
132 #endif /* G_SOCKET_H */
133