]>
git.ipfire.org Git - thirdparty/openssl.git/blob - include/openssl/params.h
0e830dee0d84b49bc0ad18674abfb3a6d357ee1d
2 * Copyright 2019 The OpenSSL Project Authors. All Rights Reserved.
3 * Copyright (c) 2019, Oracle and/or its affiliates. All rights reserved.
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
11 #ifndef HEADER_PARAMS_H
12 # define HEADER_PARAMS_H
14 # include <openssl/core.h>
15 # include <openssl/bn.h>
21 # define OSSL_PARAM_END \
22 { NULL, 0, NULL, 0, 0 }
24 # define OSSL_PARAM_DEFN(key, type, addr, sz) \
25 { (key), (type), (addr), (sz), 0 }
27 /* Basic parameter types without return sizes */
28 # define OSSL_PARAM_int(key, addr) \
29 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), \
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 OSSL_PARAM_DEFN((key), OSSL_PARAM_UNSIGNED_INTEGER, (addr), \
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 OSSL_PARAM_DEFN((key), OSSL_PARAM_UNSIGNED_INTEGER, (addr), \
48 # define OSSL_PARAM_size_t(key, addr) \
49 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))
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 OSSL_PARAM_DEFN((key), OSSL_PARAM_UTF8_STRING, (addr), sz)
57 # define OSSL_PARAM_octet_string(key, addr, sz) \
58 OSSL_PARAM_DEFN((key), OSSL_PARAM_OCTET_STRING, (addr), sz)
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)
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
);
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
,
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
,
84 OSSL_PARAM
OSSL_PARAM_construct_utf8_ptr(const char *key
, char **buf
,
86 OSSL_PARAM
OSSL_PARAM_construct_octet_string(const char *key
, void *buf
,
88 OSSL_PARAM
OSSL_PARAM_construct_octet_ptr(const char *key
, void **buf
,
90 OSSL_PARAM
OSSL_PARAM_construct_end(void);
92 int OSSL_PARAM_get_int(const OSSL_PARAM
*p
, int *val
);
93 int OSSL_PARAM_get_uint(const OSSL_PARAM
*p
, unsigned int *val
);
94 int OSSL_PARAM_get_long(const OSSL_PARAM
*p
, long int *val
);
95 int OSSL_PARAM_get_ulong(const OSSL_PARAM
*p
, unsigned long int *val
);
96 int OSSL_PARAM_get_int32(const OSSL_PARAM
*p
, int32_t *val
);
97 int OSSL_PARAM_get_uint32(const OSSL_PARAM
*p
, uint32_t *val
);
98 int OSSL_PARAM_get_int64(const OSSL_PARAM
*p
, int64_t *val
);
99 int OSSL_PARAM_get_uint64(const OSSL_PARAM
*p
, uint64_t *val
);
100 int OSSL_PARAM_get_size_t(const OSSL_PARAM
*p
, size_t *val
);
102 int OSSL_PARAM_set_int(OSSL_PARAM
*p
, int val
);
103 int OSSL_PARAM_set_uint(OSSL_PARAM
*p
, unsigned int val
);
104 int OSSL_PARAM_set_long(OSSL_PARAM
*p
, long int val
);
105 int OSSL_PARAM_set_ulong(OSSL_PARAM
*p
, unsigned long int val
);
106 int OSSL_PARAM_set_int32(OSSL_PARAM
*p
, int32_t val
);
107 int OSSL_PARAM_set_uint32(OSSL_PARAM
*p
, uint32_t val
);
108 int OSSL_PARAM_set_int64(OSSL_PARAM
*p
, int64_t val
);
109 int OSSL_PARAM_set_uint64(OSSL_PARAM
*p
, uint64_t val
);
110 int OSSL_PARAM_set_size_t(OSSL_PARAM
*p
, size_t val
);
112 int OSSL_PARAM_get_double(const OSSL_PARAM
*p
, double *val
);
113 int OSSL_PARAM_set_double(OSSL_PARAM
*p
, double val
);
115 int OSSL_PARAM_get_BN(const OSSL_PARAM
*p
, BIGNUM
**val
);
116 int OSSL_PARAM_set_BN(OSSL_PARAM
*p
, const BIGNUM
*val
);
118 int OSSL_PARAM_get_utf8_string(const OSSL_PARAM
*p
, char **val
, size_t max_len
);
119 int OSSL_PARAM_set_utf8_string(OSSL_PARAM
*p
, const char *val
);
121 int OSSL_PARAM_get_octet_string(const OSSL_PARAM
*p
, void **val
, size_t max_len
,
123 int OSSL_PARAM_set_octet_string(OSSL_PARAM
*p
, const void *val
, size_t len
);
125 int OSSL_PARAM_get_utf8_ptr(const OSSL_PARAM
*p
, const char **val
);
126 int OSSL_PARAM_set_utf8_ptr(OSSL_PARAM
*p
, const char *val
);
128 int OSSL_PARAM_get_octet_ptr(const OSSL_PARAM
*p
, const void **val
,
130 int OSSL_PARAM_set_octet_ptr(OSSL_PARAM
*p
, const void *val
,