Branch data     Line data    Source code

       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                 :             :  * GTlsServerConnection:
      34                 :             :  *
      35                 :             :  * `GTlsServerConnection` is the server-side subclass of
      36                 :             :  * [class@Gio.TlsConnection], representing a server-side TLS connection.
      37                 :             :  *
      38                 :             :  * Since: 2.28
      39                 :             :  */
      40                 :             : 
      41                 :           4 : G_DEFINE_INTERFACE (GTlsServerConnection, g_tls_server_connection, G_TYPE_TLS_CONNECTION)
      42                 :             : 
      43                 :             : static void
      44                 :           3 : g_tls_server_connection_default_init (GTlsServerConnectionInterface *iface)
      45                 :             : {
      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                 :           3 :   g_object_interface_install_property (iface,
      56                 :             :                                        g_param_spec_enum ("authentication-mode", NULL, NULL,
      57                 :             :                                                           G_TYPE_TLS_AUTHENTICATION_MODE,
      58                 :             :                                                           G_TLS_AUTHENTICATION_NONE,
      59                 :             :                                                           G_PARAM_READWRITE |
      60                 :             :                                                           G_PARAM_STATIC_STRINGS));
      61                 :           3 : }
      62                 :             : 
      63                 :             : /**
      64                 :             :  * g_tls_server_connection_new:
      65                 :             :  * @base_io_stream: the #GIOStream to wrap
      66                 :             :  * @certificate: (nullable): the default server certificate, or %NULL
      67                 :             :  * @error: #GError for error reporting, or %NULL to ignore.
      68                 :             :  *
      69                 :             :  * Creates a new #GTlsServerConnection wrapping @base_io_stream (which
      70                 :             :  * must have pollable input and output streams).
      71                 :             :  *
      72                 :             :  * See the documentation for #GTlsConnection:base-io-stream for restrictions
      73                 :             :  * on when application code can run operations on the @base_io_stream after
      74                 :             :  * this function has returned.
      75                 :             :  *
      76                 :             :  * Returns: (transfer full) (type GTlsServerConnection): the new
      77                 :             :  * #GTlsServerConnection, or %NULL on error
      78                 :             :  *
      79                 :             :  * Since: 2.28
      80                 :             :  */
      81                 :             : GIOStream *
      82                 :           0 : g_tls_server_connection_new (GIOStream        *base_io_stream,
      83                 :             :                              GTlsCertificate  *certificate,
      84                 :             :                              GError          **error)
      85                 :             : {
      86                 :             :   GObject *conn;
      87                 :             :   GTlsBackend *backend;
      88                 :             : 
      89                 :           0 :   backend = g_tls_backend_get_default ();
      90                 :           0 :   conn = g_initable_new (g_tls_backend_get_server_connection_type (backend),
      91                 :             :                          NULL, error,
      92                 :             :                          "base-io-stream", base_io_stream,
      93                 :             :                          "certificate", certificate,
      94                 :             :                          NULL);
      95                 :           0 :   return G_IO_STREAM (conn);
      96                 :             : }