Coverage Report

Created: 2024-05-12 13:53

/src/openssl/include/openssl/params.h
Line
Count
Source (jump to first uncovered line)
1
/*
2
 * Copyright 2019 The OpenSSL Project Authors. All Rights Reserved.
3
 * Copyright (c) 2019, Oracle and/or its affiliates.  All rights reserved.
4
 *
5
 * Licensed under the Apache License 2.0 (the "License").  You may not use
6
 * this file except in compliance with the License.  You can obtain a copy
7
 * in the file LICENSE in the source distribution or at
8
 * https://www.openssl.org/source/license.html
9
 */
10
11
#ifndef OPENSSL_PARAMS_H
12
# define OPENSSL_PARAMS_H
13
14
# include <openssl/core.h>
15
# include <openssl/bn.h>
16
17
# ifdef  __cplusplus
18
extern "C" {
19
# endif
20
21
# define OSSL_PARAM_END \
22
0
    { NULL, 0, NULL, 0, 0 }
23
24
# define OSSL_PARAM_DEFN(key, type, addr, sz)    \
25
0
    { (key), (type), (addr), (sz), 0 }
26
27
/* Basic parameter types without return sizes */
28
# define OSSL_PARAM_int(key, addr) \
29
0
    OSSL_PARAM_DEFN((key), OSSL_PARAM_INTEGER, (addr), sizeof(int))
30
# define OSSL_PARAM_uint(key, addr) \
31
    OSSL_PARAM_DEFN((key), OSSL_PARAM_UNSIGNED_INTEGER, (addr), \
32
                    sizeof(unsigned int))
33
# define OSSL_PARAM_long(key, addr) \
34
    OSSL_PARAM_DEFN((key), OSSL_PARAM_INTEGER, (addr), sizeof(long int))
35
# define OSSL_PARAM_ulong(key, addr) \
36
    OSSL_PARAM_DEFN((key), OSSL_PARAM_UNSIGNED_INTEGER, (addr), \
37
                    sizeof(unsigned long int))
38
# define OSSL_PARAM_int32(key, addr) \
39
    OSSL_PARAM_DEFN((key), OSSL_PARAM_INTEGER, (addr), sizeof(int32_t))
40
# define OSSL_PARAM_uint32(key, addr) \
41
0
    OSSL_PARAM_DEFN((key), OSSL_PARAM_UNSIGNED_INTEGER, (addr), \
42
0
                    sizeof(uint32_t))
43
# define OSSL_PARAM_int64(key, addr) \
44
    OSSL_PARAM_DEFN((key), OSSL_PARAM_INTEGER, (addr), sizeof(int64_t))
45
# define OSSL_PARAM_uint64(key, addr) \
46
0
    OSSL_PARAM_DEFN((key), OSSL_PARAM_UNSIGNED_INTEGER, (addr), \
47
0
                    sizeof(uint64_t))
48
# define OSSL_PARAM_size_t(key, addr) \
49
0
    OSSL_PARAM_DEFN((key), OSSL_PARAM_UNSIGNED_INTEGER, (addr), sizeof(size_t))
50
# define OSSL_PARAM_double(key, addr) \
51
    OSSL_PARAM_DEFN((key), OSSL_PARAM_REAL, (addr), sizeof(double))
52
53
# define OSSL_PARAM_BN(key, bn, sz) \
54
    OSSL_PARAM_DEFN((key), OSSL_PARAM_UNSIGNED_INTEGER, (bn), (sz))
55
# define OSSL_PARAM_utf8_string(key, addr, sz) \
56
0
    OSSL_PARAM_DEFN((key), OSSL_PARAM_UTF8_STRING, (addr), sz)
57
# define OSSL_PARAM_octet_string(key, addr, sz) \
58
0
    OSSL_PARAM_DEFN((key), OSSL_PARAM_OCTET_STRING, (addr), sz)
59
60
# define OSSL_PARAM_utf8_ptr(key, addr, sz) \
61
    OSSL_PARAM_DEFN((key), OSSL_PARAM_UTF8_PTR, &(addr), sz)
62
# define OSSL_PARAM_octet_ptr(key, addr, sz) \
63
    OSSL_PARAM_DEFN((key), OSSL_PARAM_OCTET_PTR, &(addr), sz)
64
65
/* Search an OSSL_PARAM array for a matching name */
66
OSSL_PARAM *OSSL_PARAM_locate(OSSL_PARAM *p, const char *key);
67
const OSSL_PARAM *OSSL_PARAM_locate_const(const OSSL_PARAM *p, const char *key);
68
69
/* Basic parameter type run-time construction */
70
OSSL_PARAM OSSL_PARAM_construct_int(const char *key, int *buf);
71
OSSL_PARAM OSSL_PARAM_construct_uint(const char *key, unsigned int *buf);
72
OSSL_PARAM OSSL_PARAM_construct_long(const char *key, long int *buf);
73
OSSL_PARAM OSSL_PARAM_construct_ulong(const char *key, unsigned long int *buf);
74
OSSL_PARAM OSSL_PARAM_construct_int32(const char *key, int32_t *buf);
75
OSSL_PARAM OSSL_PARAM_construct_uint32(const char *key, uint32_t *buf);
76
OSSL_PARAM OSSL_PARAM_construct_int64(const char *key, int64_t *buf);
77
OSSL_PARAM OSSL_PARAM_construct_uint64(const char *key, uint64_t *buf);
78
OSSL_PARAM OSSL_PARAM_construct_size_t(const char *key, size_t *buf);
79
OSSL_PARAM OSSL_PARAM_construct_BN(const char *key, unsigned char *buf,
80
                                   size_t bsize);
81
OSSL_PARAM OSSL_PARAM_construct_double(const char *key, double *buf);
82
OSSL_PARAM OSSL_PARAM_construct_utf8_string(const char *key, char *buf,
83
                                            size_t bsize);
84
OSSL_PARAM OSSL_PARAM_construct_utf8_ptr(const char *key, char **buf,
85
                                         size_t bsize);
86
OSSL_PARAM OSSL_PARAM_construct_octet_string(const char *key, void *buf,
87
                                             size_t bsize);
88
OSSL_PARAM OSSL_PARAM_construct_octet_ptr(const char *key, void **buf,
89
                                          size_t bsize);
90
OSSL_PARAM OSSL_PARAM_construct_end(void);
91
92
int OSSL_PARAM_construct_from_text(OSSL_PARAM *to,
93
                                   const OSSL_PARAM *paramdefs,
94
                                   const char *key, const char *value,
95
                                   size_t value_n,
96
                                   void *buf, size_t *buf_n);
97
int OSSL_PARAM_allocate_from_text(OSSL_PARAM *to,
98
                                  const OSSL_PARAM *paramdefs,
99
                                  const char *key, const char *value,
100
                                  size_t value_n);
101
102
int OSSL_PARAM_get_int(const OSSL_PARAM *p, int *val);
103
int OSSL_PARAM_get_uint(const OSSL_PARAM *p, unsigned int *val);
104
int OSSL_PARAM_get_long(const OSSL_PARAM *p, long int *val);
105
int OSSL_PARAM_get_ulong(const OSSL_PARAM *p, unsigned long int *val);
106
int OSSL_PARAM_get_int32(const OSSL_PARAM *p, int32_t *val);
107
int OSSL_PARAM_get_uint32(const OSSL_PARAM *p, uint32_t *val);
108
int OSSL_PARAM_get_int64(const OSSL_PARAM *p, int64_t *val);
109
int OSSL_PARAM_get_uint64(const OSSL_PARAM *p, uint64_t *val);
110
int OSSL_PARAM_get_size_t(const OSSL_PARAM *p, size_t *val);
111
112
int OSSL_PARAM_set_int(OSSL_PARAM *p, int val);
113
int OSSL_PARAM_set_uint(OSSL_PARAM *p, unsigned int val);
114
int OSSL_PARAM_set_long(OSSL_PARAM *p, long int val);
115
int OSSL_PARAM_set_ulong(OSSL_PARAM *p, unsigned long int val);
116
int OSSL_PARAM_set_int32(OSSL_PARAM *p, int32_t val);
117
int OSSL_PARAM_set_uint32(OSSL_PARAM *p, uint32_t val);
118
int OSSL_PARAM_set_int64(OSSL_PARAM *p, int64_t val);
119
int OSSL_PARAM_set_uint64(OSSL_PARAM *p, uint64_t val);
120
int OSSL_PARAM_set_size_t(OSSL_PARAM *p, size_t val);
121
122
int OSSL_PARAM_get_double(const OSSL_PARAM *p, double *val);
123
int OSSL_PARAM_set_double(OSSL_PARAM *p, double val);
124
125
int OSSL_PARAM_get_BN(const OSSL_PARAM *p, BIGNUM **val);
126
int OSSL_PARAM_set_BN(OSSL_PARAM *p, const BIGNUM *val);
127
128
int OSSL_PARAM_get_utf8_string(const OSSL_PARAM *p, char **val, size_t max_len);
129
int OSSL_PARAM_set_utf8_string(OSSL_PARAM *p, const char *val);
130
131
int OSSL_PARAM_get_octet_string(const OSSL_PARAM *p, void **val, size_t max_len,
132
                                size_t *used_len);
133
int OSSL_PARAM_set_octet_string(OSSL_PARAM *p, const void *val, size_t len);
134
135
int OSSL_PARAM_get_utf8_ptr(const OSSL_PARAM *p, const char **val);
136
int OSSL_PARAM_set_utf8_ptr(OSSL_PARAM *p, const char *val);
137
138
int OSSL_PARAM_get_octet_ptr(const OSSL_PARAM *p, const void **val,
139
                             size_t *used_len);
140
int OSSL_PARAM_set_octet_ptr(OSSL_PARAM *p, const void *val,
141
                             size_t used_len);
142
143
# ifdef  __cplusplus
144
}
145
# endif
146
#endif