gio/gtlsserverconnection.c

   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 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, write to the
  17  * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
  18  * Boston, MA 02111-1307, USA.
  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 {
  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   g_object_interface_install_property (iface,
  58                                        g_param_spec_enum ("authentication-mode",
  59                                                           P_("Authentication Mode"),
  60                                                           P_("The client authentication mode"),
  61                                                           G_TYPE_TLS_AUTHENTICATION_MODE,
  62                                                           G_TLS_AUTHENTICATION_NONE,
  63                                                           G_PARAM_READWRITE |
  64                                                           G_PARAM_STATIC_STRINGS));
  65 }
  66
  67 /**
  68  * g_tls_server_connection_new:
  69  * @base_io_stream: the #GIOStream to wrap
  70  * @certificate: (allow-none): 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  * Return value: (transfer full) (type GTlsServerConnection): the new
  77  * #GTlsServerConnection, or %NULL on error
  78  *
  79  * Since: 2.28
  80  */
  81 GIOStream *
  82 g_tls_server_connection_new (GIOStream        *base_io_stream,
  83                              GTlsCertificate  *certificate,
  84                              GError          **error)
  85 {
  86   GObject *conn;
  87   GTlsBackend *backend;
  88
  89   backend = g_tls_backend_get_default ();
  90   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   return G_IO_STREAM (conn);
  96 }