src/libpttls/pt_tls_server.h

   1 /*
   2  * Copyright (C) 2012 Martin Willi
   3  * Copyright (C) 2012 revosec AG
   4  *
   5  * This program is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License as published by the
   7  * Free Software Foundation; either version 2 of the License, or (at your
   8  * option) any later version.  See <http://www.fsf.org/copyleft/gpl.txt>.
   9  *
  10  * This program is distributed in the hope that it will be useful, but
  11  * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  12  * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  13  * for more details.
  14  */
  15
  16 /**
  17  * @defgroup pt_tls_server pt_tls_server
  18  * @{ @ingroup pt_tls
  19  */
  20
  21 #ifndef PT_TLS_SERVER_H_
  22 #define PT_TLS_SERVER_H_
  23
  24 #include <utils/identification.h>
  25
  26 typedef struct pt_tls_server_t pt_tls_server_t;
  27
  28 /**
  29  * IF-T for TLS aka PT-TLS transport server.
  30  */
  31 struct pt_tls_server_t {
  32
  33         /**
  34          * Handle assessment data read from socket.
  35          *
  36          * @return
  37          *                                              - NEED_MORE if more exchanges required,
  38          *                                              - SUCCESS if assessment complete
  39          *                                              - FAILED if assessment failed
  40          */
  41         status_t (*handle)(pt_tls_server_t *this);
  42
  43         /**
  44          * Get the underlying client connection socket.
  45          *
  46          * @return                      socket fd, suitable to select()
  47          */
  48         int (*get_fd)(pt_tls_server_t *this);
  49
  50         /**
  51          * Destroy a pt_tls_server_t.
  52          */
  53         void (*destroy)(pt_tls_server_t *this);
  54 };
  55
  56 /**
  57  * Create a pt_tls_server connection instance.
  58  *
  59  * @param server        TLS server identity
  60  * @param fd            client connection socket
  61  * @return                      PT-TLS server
  62  */
  63 pt_tls_server_t *pt_tls_server_create(identification_t *server, int fd);
  64
  65 #endif /** PT_TLS_SERVER_H_ @}*/