1/* GIO - GLib Input, Output and Streaming Library
2 *
3 * Copyright © 2008 Christian Kellner, Samuel Cormier-Iijima
4 * Copyright © 2009 Codethink Limited
5 * Copyright © 2009 Red Hat, Inc
6 *
7 * SPDX-License-Identifier: LGPL-2.1-or-later
8 *
9 * This library is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU Lesser General Public
11 * License as published by the Free Software Foundation; either
12 * version 2.1 of the License, or (at your option) any later version.
13 *
14 * This library is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * Lesser General Public License for more details.
18 *
19 * You should have received a copy of the GNU Lesser General
20 * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
21 *
22 * Authors: Christian Kellner <gicmo@gnome.org>
23 * Samuel Cormier-Iijima <sciyoshi@gmail.com>
24 * Ryan Lortie <desrt@desrt.ca>
25 * Alexander Larsson <alexl@redhat.com>
26 */
27
28#ifndef __G_SOCKET_LISTENER_H__
29#define __G_SOCKET_LISTENER_H__
30
31#if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
32#error "Only <gio/gio.h> can be included directly."
33#endif
34
35#include <gio/giotypes.h>
36
37G_BEGIN_DECLS
38
39#define G_TYPE_SOCKET_LISTENER (g_socket_listener_get_type ())
40#define G_SOCKET_LISTENER(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), \
41 G_TYPE_SOCKET_LISTENER, GSocketListener))
42#define G_SOCKET_LISTENER_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), \
43 G_TYPE_SOCKET_LISTENER, GSocketListenerClass))
44#define G_IS_SOCKET_LISTENER(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), \
45 G_TYPE_SOCKET_LISTENER))
46#define G_IS_SOCKET_LISTENER_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), \
47 G_TYPE_SOCKET_LISTENER))
48#define G_SOCKET_LISTENER_GET_CLASS(inst) (G_TYPE_INSTANCE_GET_CLASS ((inst), \
49 G_TYPE_SOCKET_LISTENER, GSocketListenerClass))
50
51typedef struct _GSocketListenerPrivate GSocketListenerPrivate;
52typedef struct _GSocketListenerClass GSocketListenerClass;
53
54/**
55 * GSocketListenerClass:
56 * @changed: virtual method called when the set of socket listened to changes
57 *
58 * Class structure for #GSocketListener.
59 **/
60struct _GSocketListenerClass
61{
62 GObjectClass parent_class;
63
64 void (* changed) (GSocketListener *listener);
65
66 void (* event) (GSocketListener *listener,
67 GSocketListenerEvent event,
68 GSocket *socket);
69
70 /* Padding for future expansion */
71 void (*_g_reserved2) (void);
72 void (*_g_reserved3) (void);
73 void (*_g_reserved4) (void);
74 void (*_g_reserved5) (void);
75 void (*_g_reserved6) (void);
76};
77
78struct _GSocketListener
79{
80 GObject parent_instance;
81 GSocketListenerPrivate *priv;
82};
83
84GIO_AVAILABLE_IN_ALL
85GType g_socket_listener_get_type (void) G_GNUC_CONST;
86
87GIO_AVAILABLE_IN_ALL
88GSocketListener * g_socket_listener_new (void);
89
90GIO_AVAILABLE_IN_ALL
91void g_socket_listener_set_backlog (GSocketListener *listener,
92 int listen_backlog);
93
94GIO_AVAILABLE_IN_ALL
95gboolean g_socket_listener_add_socket (GSocketListener *listener,
96 GSocket *socket,
97 GObject *source_object,
98 GError **error);
99GIO_AVAILABLE_IN_ALL
100gboolean g_socket_listener_add_address (GSocketListener *listener,
101 GSocketAddress *address,
102 GSocketType type,
103 GSocketProtocol protocol,
104 GObject *source_object,
105 GSocketAddress **effective_address,
106 GError **error);
107GIO_AVAILABLE_IN_ALL
108gboolean g_socket_listener_add_inet_port (GSocketListener *listener,
109 guint16 port,
110 GObject *source_object,
111 GError **error);
112GIO_AVAILABLE_IN_ALL
113guint16 g_socket_listener_add_any_inet_port (GSocketListener *listener,
114 GObject *source_object,
115 GError **error);
116
117GIO_AVAILABLE_IN_ALL
118GSocket * g_socket_listener_accept_socket (GSocketListener *listener,
119 GObject **source_object,
120 GCancellable *cancellable,
121 GError **error);
122GIO_AVAILABLE_IN_ALL
123void g_socket_listener_accept_socket_async (GSocketListener *listener,
124 GCancellable *cancellable,
125 GAsyncReadyCallback callback,
126 gpointer user_data);
127GIO_AVAILABLE_IN_ALL
128GSocket * g_socket_listener_accept_socket_finish (GSocketListener *listener,
129 GAsyncResult *result,
130 GObject **source_object,
131 GError **error);
132
133
134GIO_AVAILABLE_IN_ALL
135GSocketConnection * g_socket_listener_accept (GSocketListener *listener,
136 GObject **source_object,
137 GCancellable *cancellable,
138 GError **error);
139
140GIO_AVAILABLE_IN_ALL
141void g_socket_listener_accept_async (GSocketListener *listener,
142 GCancellable *cancellable,
143 GAsyncReadyCallback callback,
144 gpointer user_data);
145
146GIO_AVAILABLE_IN_ALL
147GSocketConnection * g_socket_listener_accept_finish (GSocketListener *listener,
148 GAsyncResult *result,
149 GObject **source_object,
150 GError **error);
151
152GIO_AVAILABLE_IN_ALL
153void g_socket_listener_close (GSocketListener *listener);
154
155G_END_DECLS
156
157#endif /* __G_SOCKET_LISTENER_H__ */
158