FFmpeg
tls.h
Go to the documentation of this file.
1 /*
2  * TLS/SSL Protocol
3  * Copyright (c) 2011 Martin Storsjo
4  *
5  * This file is part of FFmpeg.
6  *
7  * FFmpeg 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  * FFmpeg 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 Public
18  * License along with FFmpeg; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20  */
21 
22 #ifndef AVFORMAT_TLS_H
23 #define AVFORMAT_TLS_H
24 
25 #include "libavutil/opt.h"
26 
27 #include "url.h"
28 
29 typedef struct TLSShared {
30  char *ca_file;
31  int verify;
32  char *cert_file;
33  char *key_file;
34  int listen;
35 
36  char *host;
37 
38  char underlying_host[200];
40 
42 } TLSShared;
43 
44 #define TLS_OPTFL (AV_OPT_FLAG_DECODING_PARAM | AV_OPT_FLAG_ENCODING_PARAM)
45 #define TLS_COMMON_OPTIONS(pstruct, options_field) \
46  {"ca_file", "Certificate Authority database file", offsetof(pstruct, options_field . ca_file), AV_OPT_TYPE_STRING, .flags = TLS_OPTFL }, \
47  {"cafile", "Certificate Authority database file", offsetof(pstruct, options_field . ca_file), AV_OPT_TYPE_STRING, .flags = TLS_OPTFL }, \
48  {"tls_verify", "Verify the peer certificate", offsetof(pstruct, options_field . verify), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, 1, .flags = TLS_OPTFL }, \
49  {"cert_file", "Certificate file", offsetof(pstruct, options_field . cert_file), AV_OPT_TYPE_STRING, .flags = TLS_OPTFL }, \
50  {"key_file", "Private key file", offsetof(pstruct, options_field . key_file), AV_OPT_TYPE_STRING, .flags = TLS_OPTFL }, \
51  {"listen", "Listen for incoming connections", offsetof(pstruct, options_field . listen), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, 1, .flags = TLS_OPTFL }, \
52  {"verifyhost", "Verify against a specific hostname", offsetof(pstruct, options_field . host), AV_OPT_TYPE_STRING, .flags = TLS_OPTFL }
53 
54 int ff_tls_open_underlying(TLSShared *c, URLContext *parent, const char *uri, AVDictionary **options);
55 
56 void ff_gnutls_init(void);
57 void ff_gnutls_deinit(void);
58 
59 int ff_openssl_init(void);
60 void ff_openssl_deinit(void);
61 
62 #endif /* AVFORMAT_TLS_H */
int verify
Definition: tls.h:31
int listen
Definition: tls.h:34
AVOptions.
Undefined Behavior In the C some operations are like signed integer dereferencing freed accessing outside allocated Undefined Behavior must not occur in a C it is not safe even if the output of undefined operations is unused The unsafety may seem nit picking but Optimizing compilers have in fact optimized code on the assumption that no undefined Behavior occurs Optimizing code based on wrong assumptions can and has in some cases lead to effects beyond the output of computations The signed integer overflow problem in speed critical code Code which is highly optimized and works with signed integers sometimes has the problem that often the output of the computation does not c
Definition: undefined.txt:32
int ff_openssl_init(void)
Definition: tls_openssl.c:69
void ff_gnutls_init(void)
Definition: tls_gnutls.c:56
Definition: tls.h:29
char underlying_host[200]
Definition: tls.h:38
char * host
Definition: tls.h:36
char * cert_file
Definition: tls.h:32
char * ca_file
Definition: tls.h:30
Definition: url.h:38
void ff_gnutls_deinit(void)
Definition: tls_gnutls.c:67
const OptionDef options[]
Definition: ffmpeg_opt.c:3372
URLContext * tcp
Definition: tls.h:41
int numerichost
Definition: tls.h:39
void ff_openssl_deinit(void)
Definition: tls_openssl.c:99
unbuffered private I/O API
int ff_tls_open_underlying(TLSShared *c, URLContext *parent, const char *uri, AVDictionary **options)
Definition: tls.c:56
char * key_file
Definition: tls.h:33