1/* GIO - GLib Input, Output and Streaming Library
2 *
3 * Copyright © 2010 Red Hat, Inc.
4 * Copyright © 2015 Collabora, Ltd.
5 *
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General
17 * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
18 */
19
20#ifndef __G_DTLS_CONNECTION_H__
21#define __G_DTLS_CONNECTION_H__
22
23#if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
24#error "Only <gio/gio.h> can be included directly."
25#endif
26
27#include <gio/gdatagrambased.h>
28
29G_BEGIN_DECLS
30
31#define G_TYPE_DTLS_CONNECTION (g_dtls_connection_get_type ())
32#define G_DTLS_CONNECTION(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), G_TYPE_DTLS_CONNECTION, GDtlsConnection))
33#define G_IS_DTLS_CONNECTION(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), G_TYPE_DTLS_CONNECTION))
34#define G_DTLS_CONNECTION_GET_INTERFACE(inst) (G_TYPE_INSTANCE_GET_INTERFACE ((inst), G_TYPE_DTLS_CONNECTION, GDtlsConnectionInterface))
35
36typedef struct _GDtlsConnectionInterface GDtlsConnectionInterface;
37
38/**
39 * GDtlsConnectionInterface:
40 * @g_iface: The parent interface.
41 * @accept_certificate: Check whether to accept a certificate.
42 * @handshake: Perform a handshake operation.
43 * @handshake_async: Start an asynchronous handshake operation.
44 * @handshake_finish: Finish an asynchronous handshake operation.
45 * @shutdown: Shut down one or both directions of the connection.
46 * @shutdown_async: Start an asynchronous shutdown operation.
47 * @shutdown_finish: Finish an asynchronous shutdown operation.
48 *
49 * Virtual method table for a #GDtlsConnection implementation.
50 *
51 * Since: 2.48
52 */
53struct _GDtlsConnectionInterface
54{
55 GTypeInterface g_iface;
56
57 /* signals */
58 gboolean (*accept_certificate) (GDtlsConnection *connection,
59 GTlsCertificate *peer_cert,
60 GTlsCertificateFlags errors);
61
62 /* methods */
63 gboolean (*handshake) (GDtlsConnection *conn,
64 GCancellable *cancellable,
65 GError **error);
66
67 void (*handshake_async) (GDtlsConnection *conn,
68 int io_priority,
69 GCancellable *cancellable,
70 GAsyncReadyCallback callback,
71 gpointer user_data);
72 gboolean (*handshake_finish) (GDtlsConnection *conn,
73 GAsyncResult *result,
74 GError **error);
75
76 gboolean (*shutdown) (GDtlsConnection *conn,
77 gboolean shutdown_read,
78 gboolean shutdown_write,
79 GCancellable *cancellable,
80 GError **error);
81
82 void (*shutdown_async) (GDtlsConnection *conn,
83 gboolean shutdown_read,
84 gboolean shutdown_write,
85 int io_priority,
86 GCancellable *cancellable,
87 GAsyncReadyCallback callback,
88 gpointer user_data);
89 gboolean (*shutdown_finish) (GDtlsConnection *conn,
90 GAsyncResult *result,
91 GError **error);
92};
93
94GLIB_AVAILABLE_IN_2_48
95GType g_dtls_connection_get_type (void) G_GNUC_CONST;
96
97GLIB_AVAILABLE_IN_2_48
98void g_dtls_connection_set_database (GDtlsConnection *conn,
99 GTlsDatabase *database);
100GLIB_AVAILABLE_IN_2_48
101GTlsDatabase *g_dtls_connection_get_database (GDtlsConnection *conn);
102
103GLIB_AVAILABLE_IN_2_48
104void g_dtls_connection_set_certificate (GDtlsConnection *conn,
105 GTlsCertificate *certificate);
106GLIB_AVAILABLE_IN_2_48
107GTlsCertificate *g_dtls_connection_get_certificate (GDtlsConnection *conn);
108
109GLIB_AVAILABLE_IN_2_48
110void g_dtls_connection_set_interaction (GDtlsConnection *conn,
111 GTlsInteraction *interaction);
112GLIB_AVAILABLE_IN_2_48
113GTlsInteraction *g_dtls_connection_get_interaction (GDtlsConnection *conn);
114
115GLIB_AVAILABLE_IN_2_48
116GTlsCertificate *g_dtls_connection_get_peer_certificate (GDtlsConnection *conn);
117GLIB_AVAILABLE_IN_2_48
118GTlsCertificateFlags g_dtls_connection_get_peer_certificate_errors (GDtlsConnection *conn);
119
120GLIB_AVAILABLE_IN_2_48
121void g_dtls_connection_set_require_close_notify (GDtlsConnection *conn,
122 gboolean require_close_notify);
123GLIB_AVAILABLE_IN_2_48
124gboolean g_dtls_connection_get_require_close_notify (GDtlsConnection *conn);
125
126GLIB_AVAILABLE_IN_2_48
127void g_dtls_connection_set_rehandshake_mode (GDtlsConnection *conn,
128 GTlsRehandshakeMode mode);
129GLIB_AVAILABLE_IN_2_48
130GTlsRehandshakeMode g_dtls_connection_get_rehandshake_mode (GDtlsConnection *conn);
131
132GLIB_AVAILABLE_IN_2_48
133gboolean g_dtls_connection_handshake (GDtlsConnection *conn,
134 GCancellable *cancellable,
135 GError **error);
136
137GLIB_AVAILABLE_IN_2_48
138void g_dtls_connection_handshake_async (GDtlsConnection *conn,
139 int io_priority,
140 GCancellable *cancellable,
141 GAsyncReadyCallback callback,
142 gpointer user_data);
143GLIB_AVAILABLE_IN_2_48
144gboolean g_dtls_connection_handshake_finish (GDtlsConnection *conn,
145 GAsyncResult *result,
146 GError **error);
147
148GLIB_AVAILABLE_IN_2_48
149gboolean g_dtls_connection_shutdown (GDtlsConnection *conn,
150 gboolean shutdown_read,
151 gboolean shutdown_write,
152 GCancellable *cancellable,
153 GError **error);
154
155GLIB_AVAILABLE_IN_2_48
156void g_dtls_connection_shutdown_async (GDtlsConnection *conn,
157 gboolean shutdown_read,
158 gboolean shutdown_write,
159 int io_priority,
160 GCancellable *cancellable,
161 GAsyncReadyCallback callback,
162 gpointer user_data);
163GLIB_AVAILABLE_IN_2_48
164gboolean g_dtls_connection_shutdown_finish (GDtlsConnection *conn,
165 GAsyncResult *result,
166 GError **error);
167
168GLIB_AVAILABLE_IN_2_48
169gboolean g_dtls_connection_close (GDtlsConnection *conn,
170 GCancellable *cancellable,
171 GError **error);
172
173GLIB_AVAILABLE_IN_2_48
174void g_dtls_connection_close_async (GDtlsConnection *conn,
175 int io_priority,
176 GCancellable *cancellable,
177 GAsyncReadyCallback callback,
178 gpointer user_data);
179GLIB_AVAILABLE_IN_2_48
180gboolean g_dtls_connection_close_finish (GDtlsConnection *conn,
181 GAsyncResult *result,
182 GError **error);
183
184/*< protected >*/
185GLIB_AVAILABLE_IN_2_48
186gboolean g_dtls_connection_emit_accept_certificate (GDtlsConnection *conn,
187 GTlsCertificate *peer_cert,
188 GTlsCertificateFlags errors);
189G_END_DECLS
190
191#endif /* __G_DTLS_CONNECTION_H__ */
192