/src/glib/gio/gtlsserverconnection.c
Line | Count | Source (jump to first uncovered line) |
1 | | /* GIO - GLib Input, Output and Streaming Library |
2 | | * |
3 | | * Copyright © 2010 Red Hat, Inc |
4 | | * |
5 | | * SPDX-License-Identifier: LGPL-2.1-or-later |
6 | | * |
7 | | * This library is free software; you can redistribute it and/or |
8 | | * modify it under the terms of the GNU Lesser General Public |
9 | | * License as published by the Free Software Foundation; either |
10 | | * version 2.1 of the License, or (at your option) any later version. |
11 | | * |
12 | | * This library is distributed in the hope that it will be useful, |
13 | | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
14 | | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
15 | | * Lesser General Public License for more details. |
16 | | * |
17 | | * You should have received a copy of the GNU Lesser General |
18 | | * Public License along with this library; if not, see <http://www.gnu.org/licenses/>. |
19 | | */ |
20 | | |
21 | | #include "config.h" |
22 | | #include "glib.h" |
23 | | |
24 | | #include "gtlsserverconnection.h" |
25 | | #include "ginitable.h" |
26 | | #include "gioenumtypes.h" |
27 | | #include "gsocket.h" |
28 | | #include "gtlsbackend.h" |
29 | | #include "gtlscertificate.h" |
30 | | #include "glibintl.h" |
31 | | |
32 | | /** |
33 | | * SECTION:gtlsserverconnection |
34 | | * @short_description: TLS server-side connection |
35 | | * @include: gio/gio.h |
36 | | * |
37 | | * #GTlsServerConnection is the server-side subclass of #GTlsConnection, |
38 | | * representing a server-side TLS connection. |
39 | | * |
40 | | * Since: 2.28 |
41 | | */ |
42 | | |
43 | | G_DEFINE_INTERFACE (GTlsServerConnection, g_tls_server_connection, G_TYPE_TLS_CONNECTION) |
44 | | |
45 | | static void |
46 | | g_tls_server_connection_default_init (GTlsServerConnectionInterface *iface) |
47 | 0 | { |
48 | | /** |
49 | | * GTlsServerConnection:authentication-mode: |
50 | | * |
51 | | * The #GTlsAuthenticationMode for the server. This can be changed |
52 | | * before calling g_tls_connection_handshake() if you want to |
53 | | * rehandshake with a different mode from the initial handshake. |
54 | | * |
55 | | * Since: 2.28 |
56 | | */ |
57 | 0 | g_object_interface_install_property (iface, |
58 | 0 | g_param_spec_enum ("authentication-mode", |
59 | 0 | P_("Authentication Mode"), |
60 | 0 | P_("The client authentication mode"), |
61 | 0 | G_TYPE_TLS_AUTHENTICATION_MODE, |
62 | 0 | G_TLS_AUTHENTICATION_NONE, |
63 | 0 | G_PARAM_READWRITE | |
64 | 0 | G_PARAM_STATIC_STRINGS)); |
65 | 0 | } |
66 | | |
67 | | /** |
68 | | * g_tls_server_connection_new: |
69 | | * @base_io_stream: the #GIOStream to wrap |
70 | | * @certificate: (nullable): the default server certificate, or %NULL |
71 | | * @error: #GError for error reporting, or %NULL to ignore. |
72 | | * |
73 | | * Creates a new #GTlsServerConnection wrapping @base_io_stream (which |
74 | | * must have pollable input and output streams). |
75 | | * |
76 | | * See the documentation for #GTlsConnection:base-io-stream for restrictions |
77 | | * on when application code can run operations on the @base_io_stream after |
78 | | * this function has returned. |
79 | | * |
80 | | * Returns: (transfer full) (type GTlsServerConnection): the new |
81 | | * #GTlsServerConnection, or %NULL on error |
82 | | * |
83 | | * Since: 2.28 |
84 | | */ |
85 | | GIOStream * |
86 | | g_tls_server_connection_new (GIOStream *base_io_stream, |
87 | | GTlsCertificate *certificate, |
88 | | GError **error) |
89 | 0 | { |
90 | 0 | GObject *conn; |
91 | 0 | GTlsBackend *backend; |
92 | |
|
93 | 0 | backend = g_tls_backend_get_default (); |
94 | 0 | conn = g_initable_new (g_tls_backend_get_server_connection_type (backend), |
95 | 0 | NULL, error, |
96 | 0 | "base-io-stream", base_io_stream, |
97 | 0 | "certificate", certificate, |
98 | 0 | NULL); |
99 | 0 | return G_IO_STREAM (conn); |
100 | 0 | } |