Coverage Report

Created: 2025-07-01 07:09

/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
 * 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.1 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, see <http://www.gnu.org/licenses/>.
17
 */
18
19
#include "config.h"
20
#include "glib.h"
21
22
#include "gtlsserverconnection.h"
23
#include "ginitable.h"
24
#include "gioenumtypes.h"
25
#include "gsocket.h"
26
#include "gtlsbackend.h"
27
#include "gtlscertificate.h"
28
#include "glibintl.h"
29
30
/**
31
 * SECTION:gtlsserverconnection
32
 * @short_description: TLS server-side connection
33
 * @include: gio/gio.h
34
 *
35
 * #GTlsServerConnection is the server-side subclass of #GTlsConnection,
36
 * representing a server-side TLS connection.
37
 *
38
 * Since: 2.28
39
 */
40
41
G_DEFINE_INTERFACE (GTlsServerConnection, g_tls_server_connection, G_TYPE_TLS_CONNECTION)
42
43
static void
44
g_tls_server_connection_default_init (GTlsServerConnectionInterface *iface)
45
0
{
46
  /**
47
   * GTlsServerConnection:authentication-mode:
48
   *
49
   * The #GTlsAuthenticationMode for the server. This can be changed
50
   * before calling g_tls_connection_handshake() if you want to
51
   * rehandshake with a different mode from the initial handshake.
52
   *
53
   * Since: 2.28
54
   */
55
0
  g_object_interface_install_property (iface,
56
0
               g_param_spec_enum ("authentication-mode",
57
0
                P_("Authentication Mode"),
58
0
                P_("The client authentication mode"),
59
0
                G_TYPE_TLS_AUTHENTICATION_MODE,
60
0
                G_TLS_AUTHENTICATION_NONE,
61
0
                G_PARAM_READWRITE |
62
0
                G_PARAM_STATIC_STRINGS));
63
0
}
64
65
/**
66
 * g_tls_server_connection_new:
67
 * @base_io_stream: the #GIOStream to wrap
68
 * @certificate: (nullable): the default server certificate, or %NULL
69
 * @error: #GError for error reporting, or %NULL to ignore.
70
 *
71
 * Creates a new #GTlsServerConnection wrapping @base_io_stream (which
72
 * must have pollable input and output streams).
73
 *
74
 * See the documentation for #GTlsConnection:base-io-stream for restrictions
75
 * on when application code can run operations on the @base_io_stream after
76
 * this function has returned.
77
 *
78
 * Returns: (transfer full) (type GTlsServerConnection): the new
79
 * #GTlsServerConnection, or %NULL on error
80
 *
81
 * Since: 2.28
82
 */
83
GIOStream *
84
g_tls_server_connection_new (GIOStream        *base_io_stream,
85
           GTlsCertificate  *certificate,
86
           GError          **error)
87
0
{
88
0
  GObject *conn;
89
0
  GTlsBackend *backend;
90
91
0
  backend = g_tls_backend_get_default ();
92
0
  conn = g_initable_new (g_tls_backend_get_server_connection_type (backend),
93
0
       NULL, error,
94
0
       "base-io-stream", base_io_stream,
95
0
       "certificate", certificate,
96
0
       NULL);
97
0
  return G_IO_STREAM (conn);
98
0
}