1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
/*
* OpenVPN -- An application to securely tunnel IP networks
* over a single TCP/UDP port, with support for SSL/TLS-based
* session authentication and key exchange,
* packet encryption, packet authentication, and
* packet compression.
*
* Copyright (C) 2002-2023 OpenVPN Inc <sales@openvpn.net>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License version 2
* as published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*/
/**
* @file SSL utility function. This file (and its .c file) is designed to
* to be included in units/etc without pulling in a lot of dependencies
*/
#ifndef SSL_UTIL_H_
#define SSL_UTIL_H_
#include "buffer.h"
/**
* Extracts a variable from peer info, the returned string will be allocated
* using the supplied gc_arena
*
* @param peer_info The peer's peer_info
* @param var The variable *including* =, e.g. IV_CIPHERS=
*
* @return The content of the variable as NULL terminated string or NULL if the
* variable cannot be found.
*/
char *extract_var_peer_info(const char *peer_info, const char *var,
struct gc_arena *gc);
/**
* Extracts the IV_PROTO variable and returns its value or 0
* if it cannot be extracted.
*
* @param peer_info peer info string to search for IV_PROTO
*/
unsigned int extract_iv_proto(const char *peer_info);
/**
* Takes a locally produced OCC string for TLS server mode and modifies as
* if the option comp-lzo was enabled. This is to send a client in
* comp-lzo migrate mode the expected OCC string.
*
* Note: This function expects the string to be in the locally generated
* format and does not accept arbitrary strings.
*
* @param options the locally generated OCC string
* @param gc gc_arena to allocate the returned string in
* @return the modified string or options on error
*/
const char *options_string_compat_lzo(const char *options, struct gc_arena *gc);
/**
* Get a tls_cipher_name_pair containing OpenSSL and IANA names for supplied TLS cipher name
*
* @param cipher_name Can be either OpenSSL or IANA cipher name
* @return tls_cipher_name_pair* if found, NULL otherwise
*/
typedef struct { const char *openssl_name; const char *iana_name; } tls_cipher_name_pair;
const tls_cipher_name_pair *tls_get_cipher_name_pair(const char *cipher_name, size_t len);
/**
* Returns the occurrences of 'delimiter' in a string +1
* This is typically used to find out the number elements in a
* cipher string or similar that is separated by : like
*
* X25519:secp256r1:X448:secp512r1:secp384r1:brainpoolP384r1
*
* @param string the string to work on
* @param delimiter the delimiter to count, typically ':'
* @return occrrences of delimiter + 1
*/
int
get_num_elements(const char *string, char delimiter);
#endif /* ifndef SSL_UTIL_H_ */
|