]> git.sesse.net Git - vlc/blob - include/vlc_tls.h
- Non blocking TLS handshaking
[vlc] / include / vlc_tls.h
1 /*****************************************************************************
2  * tls.c
3  *****************************************************************************
4  * Copyright (C) 2004 VideoLAN
5  * $Id: httpd.c 8263 2004-07-24 09:06:58Z courmisch $
6  *
7  * Authors: Remi Denis-Courmont <courmisch@via.ecp.fr>
8  *
9  * This program is free software; you can redistribute it and/or modify
10  * it under the terms of the GNU General Public License as published by
11  * the Free Software Foundation; either version 2 of the License, or
12  * (at your option) any later version.
13  *
14  * This program is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17  * GNU General Public License for more details.
18  *
19  * You should have received a copy of the GNU General Public License
20  * along with this program; if not, write to the Free Software
21  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111, USA.
22  *****************************************************************************/
23
24 #ifndef _VLC_TLS_H
25 # define _VLC_TLS_H
26
27 # include "network.h"
28
29 struct tls_t
30 {
31     VLC_COMMON_MEMBERS
32
33     /* Module properties */
34     module_t  *p_module;
35     void *p_sys;
36
37     tls_server_t * (*pf_server_create) ( tls_t *, const char *, const char * );
38     tls_session_t * (*pf_client_create) ( tls_t *, const char * );
39 };
40
41 struct tls_server_t
42 {
43     tls_t *p_tls;
44     void *p_sys;
45
46     void (*pf_delete) ( tls_server_t * );
47     
48     int (*pf_add_CA) ( tls_server_t *, const char * );
49     int (*pf_add_CRL) ( tls_server_t *, const char * );
50     
51     tls_session_t * (*pf_session_prepare) ( tls_server_t * );
52 };
53
54 struct tls_session_t
55 {
56     tls_t *p_tls;
57     tls_server_t *p_server;
58
59     void *p_sys;
60
61     struct virtual_socket_t sock;
62     int (*pf_handshake) ( tls_session_t *, int );
63     int (*pf_handshake2) ( tls_session_t * );
64     void (*pf_close) ( tls_session_t * );
65 };
66
67
68 /*****************************************************************************
69  * tls_ServerCreate:
70  *****************************************************************************
71  * Allocates a whole server's TLS credentials.
72  * Returns NULL on error.
73  *****************************************************************************/
74 # define __tls_ServerCreate( a, b, c ) (((tls_t *)a)->pf_server_create (a, b, c))
75 VLC_EXPORT( tls_server_t *, tls_ServerCreate, ( vlc_object_t *, const char *, const char * ) );
76
77 /*****************************************************************************
78  * tls_ServerAddCA:
79  *****************************************************************************
80  * Adds one or more certificate authorities.
81  * Returns -1 on error, 0 on success.
82  *****************************************************************************/
83 # define tls_ServerAddCA( a, b ) (((tls_server_t *)a)->pf_add_CA (a, b))
84
85
86 /*****************************************************************************
87  * tls_ServerAddCRL:
88  *****************************************************************************
89  * Adds a certificates revocation list to be sent to TLS clients.
90  * Returns -1 on error, 0 on success.
91  *****************************************************************************/
92 # define tls_ServerAddCRL( a, b ) (((tls_server_t *)a)->pf_add_CRL (a, b))
93
94
95 # define __tls_ServerDelete( a ) (((tls_server_t *)a)->pf_delete ( a ))
96 VLC_EXPORT( void, tls_ServerDelete, ( tls_server_t * ) );
97
98
99 # define tls_ServerSessionPrepare( a ) (((tls_server_t *)a)->pf_session_prepare (a))
100
101 # define __tls_ClientCreate( a, b ) (((tls_t *)a)->pf_client_create (a, b ))
102 VLC_EXPORT( tls_session_t *, tls_ClientCreate, ( vlc_object_t *, const char *, int ) );
103 VLC_EXPORT( void, tls_ClientDelete, ( tls_session_t * ) );
104
105 # define tls_SessionHandshake( a, b ) (((tls_session_t *)a)->pf_handshake (a, b))
106 # define tls_SessionContinueHandshake( a ) (((tls_session_t *)a)->pf_handshake2 (a))
107
108 # define tls_SessionClose( a ) (((tls_session_t *)a)->pf_close (a))
109
110 /* NOTE: It is assumed that a->sock.p_sys = a */
111 # define tls_Send( a, b, c ) (((tls_session_t *)a)->sock.pf_send (a, b, c ))
112
113 # define tls_Recv( a, b, c ) (((tls_session_t *)a)->sock.pf_recv (a, b, c ))
114
115 #endif