Merge branch 'opaque-ports'
[strongswan.git] / 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 #include <tnc/tnccs/tnccs.h>
27
28 typedef struct pt_tls_server_t pt_tls_server_t;
29
30 /**
31 * IF-T for TLS aka PT-TLS transport server.
32 */
33 struct pt_tls_server_t {
34
35 /**
36 * Handle assessment data read from socket.
37 *
38 * @return
39 * - NEED_MORE if more exchanges required,
40 * - SUCCESS if assessment complete
41 * - FAILED if assessment failed
42 */
43 status_t (*handle)(pt_tls_server_t *this);
44
45 /**
46 * Get the underlying client connection socket.
47 *
48 * @return socket fd, suitable to select()
49 */
50 int (*get_fd)(pt_tls_server_t *this);
51
52 /**
53 * Destroy a pt_tls_server_t.
54 */
55 void (*destroy)(pt_tls_server_t *this);
56 };
57
58 /**
59 * Create a pt_tls_server connection instance.
60 *
61 * @param server TLS server identity
62 * @param fd client connection socket
63 * @param tnccs inner TNCCS protocol handler to use for this connection
64 * @return PT-TLS server
65 */
66 pt_tls_server_t *pt_tls_server_create(identification_t *server, int fd,
67 tnccs_t *tnccs);
68
69 #endif /** PT_TLS_SERVER_H_ @}*/