2 * Copyright 2019-2021 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
12 #include <openssl/err.h>
13 #include <openssl/cryptoerr.h>
14 #include <openssl/params.h>
15 #include <openssl/types.h>
16 #include <openssl/safestack.h>
17 #include "internal/cryptlib.h"
18 #include "openssl/param_build.h"
21 * Special internal param type to indicate the end of an allocate OSSL_PARAM
24 #define OSSL_PARAM_ALLOCATED_END 127
36 * These fields are never directly addressed, but their sizes are
37 * imporant so that all native types can be copied here without overrun.
45 DEFINE_STACK_OF(OSSL_PARAM_BLD_DEF
)
47 struct ossl_param_bld_st
{
50 STACK_OF(OSSL_PARAM_BLD_DEF
) *params
;
55 } OSSL_PARAM_BLD_BLOCK
;
57 #define ALIGN_SIZE sizeof(OSSL_PARAM_BLD_BLOCK)
59 static size_t bytes_to_blocks(size_t bytes
)
61 return (bytes
+ ALIGN_SIZE
- 1) / ALIGN_SIZE
;
64 static OSSL_PARAM_BLD_DEF
*param_push(OSSL_PARAM_BLD
*bld
, const char *key
,
65 int size
, size_t alloc
, int type
,
68 OSSL_PARAM_BLD_DEF
*pd
= OPENSSL_zalloc(sizeof(*pd
));
71 ERR_raise(ERR_LIB_CRYPTO
, ERR_R_MALLOC_FAILURE
);
77 pd
->alloc_blocks
= bytes_to_blocks(alloc
);
78 if ((pd
->secure
= secure
) != 0)
79 bld
->secure_blocks
+= pd
->alloc_blocks
;
81 bld
->total_blocks
+= pd
->alloc_blocks
;
82 if (sk_OSSL_PARAM_BLD_DEF_push(bld
->params
, pd
) <= 0) {
89 static int param_push_num(OSSL_PARAM_BLD
*bld
, const char *key
,
90 void *num
, size_t size
, int type
)
92 OSSL_PARAM_BLD_DEF
*pd
= param_push(bld
, key
, size
, size
, type
, 0);
96 if (size
> sizeof(pd
->num
)) {
97 ERR_raise(ERR_LIB_CRYPTO
, CRYPTO_R_TOO_MANY_BYTES
);
100 memcpy(&pd
->num
, num
, size
);
104 OSSL_PARAM_BLD
*OSSL_PARAM_BLD_new(void)
106 OSSL_PARAM_BLD
*r
= OPENSSL_zalloc(sizeof(OSSL_PARAM_BLD
));
109 r
->params
= sk_OSSL_PARAM_BLD_DEF_new_null();
110 if (r
->params
== NULL
) {
118 static void free_all_params(OSSL_PARAM_BLD
*bld
)
120 int i
, n
= sk_OSSL_PARAM_BLD_DEF_num(bld
->params
);
122 for (i
= 0; i
< n
; i
++)
123 OPENSSL_free(sk_OSSL_PARAM_BLD_DEF_pop(bld
->params
));
126 void OSSL_PARAM_BLD_free(OSSL_PARAM_BLD
*bld
)
130 free_all_params(bld
);
131 sk_OSSL_PARAM_BLD_DEF_free(bld
->params
);
135 int OSSL_PARAM_BLD_push_int(OSSL_PARAM_BLD
*bld
, const char *key
, int num
)
137 return param_push_num(bld
, key
, &num
, sizeof(num
), OSSL_PARAM_INTEGER
);
140 int OSSL_PARAM_BLD_push_uint(OSSL_PARAM_BLD
*bld
, const char *key
,
143 return param_push_num(bld
, key
, &num
, sizeof(num
),
144 OSSL_PARAM_UNSIGNED_INTEGER
);
147 int OSSL_PARAM_BLD_push_long(OSSL_PARAM_BLD
*bld
, const char *key
,
150 return param_push_num(bld
, key
, &num
, sizeof(num
), OSSL_PARAM_INTEGER
);
153 int OSSL_PARAM_BLD_push_ulong(OSSL_PARAM_BLD
*bld
, const char *key
,
154 unsigned long int num
)
156 return param_push_num(bld
, key
, &num
, sizeof(num
),
157 OSSL_PARAM_UNSIGNED_INTEGER
);
160 int OSSL_PARAM_BLD_push_int32(OSSL_PARAM_BLD
*bld
, const char *key
,
163 return param_push_num(bld
, key
, &num
, sizeof(num
), OSSL_PARAM_INTEGER
);
166 int OSSL_PARAM_BLD_push_uint32(OSSL_PARAM_BLD
*bld
, const char *key
,
169 return param_push_num(bld
, key
, &num
, sizeof(num
),
170 OSSL_PARAM_UNSIGNED_INTEGER
);
173 int OSSL_PARAM_BLD_push_int64(OSSL_PARAM_BLD
*bld
, const char *key
,
176 return param_push_num(bld
, key
, &num
, sizeof(num
), OSSL_PARAM_INTEGER
);
179 int OSSL_PARAM_BLD_push_uint64(OSSL_PARAM_BLD
*bld
, const char *key
,
182 return param_push_num(bld
, key
, &num
, sizeof(num
),
183 OSSL_PARAM_UNSIGNED_INTEGER
);
186 int OSSL_PARAM_BLD_push_size_t(OSSL_PARAM_BLD
*bld
, const char *key
,
189 return param_push_num(bld
, key
, &num
, sizeof(num
),
190 OSSL_PARAM_UNSIGNED_INTEGER
);
193 int OSSL_PARAM_BLD_push_time_t(OSSL_PARAM_BLD
*bld
, const char *key
,
196 return param_push_num(bld
, key
, &num
, sizeof(num
),
200 int OSSL_PARAM_BLD_push_double(OSSL_PARAM_BLD
*bld
, const char *key
,
203 return param_push_num(bld
, key
, &num
, sizeof(num
), OSSL_PARAM_REAL
);
206 int OSSL_PARAM_BLD_push_BN(OSSL_PARAM_BLD
*bld
, const char *key
,
209 return OSSL_PARAM_BLD_push_BN_pad(bld
, key
, bn
,
210 bn
== NULL
? 0 : BN_num_bytes(bn
));
213 int OSSL_PARAM_BLD_push_BN_pad(OSSL_PARAM_BLD
*bld
, const char *key
,
214 const BIGNUM
*bn
, size_t sz
)
217 OSSL_PARAM_BLD_DEF
*pd
;
220 n
= BN_num_bytes(bn
);
222 ERR_raise(ERR_LIB_CRYPTO
, CRYPTO_R_ZERO_LENGTH_NUMBER
);
225 if (sz
< (size_t)n
) {
226 ERR_raise(ERR_LIB_CRYPTO
, CRYPTO_R_TOO_SMALL_BUFFER
);
229 if (BN_get_flags(bn
, BN_FLG_SECURE
) == BN_FLG_SECURE
)
232 pd
= param_push(bld
, key
, sz
, sz
, OSSL_PARAM_UNSIGNED_INTEGER
, secure
);
239 int OSSL_PARAM_BLD_push_utf8_string(OSSL_PARAM_BLD
*bld
, const char *key
,
240 const char *buf
, size_t bsize
)
242 OSSL_PARAM_BLD_DEF
*pd
;
246 } else if (bsize
> INT_MAX
) {
247 ERR_raise(ERR_LIB_CRYPTO
, CRYPTO_R_STRING_TOO_LONG
);
250 pd
= param_push(bld
, key
, bsize
, bsize
+ 1, OSSL_PARAM_UTF8_STRING
, 0);
257 int OSSL_PARAM_BLD_push_utf8_ptr(OSSL_PARAM_BLD
*bld
, const char *key
,
258 char *buf
, size_t bsize
)
260 OSSL_PARAM_BLD_DEF
*pd
;
264 } else if (bsize
> INT_MAX
) {
265 ERR_raise(ERR_LIB_CRYPTO
, CRYPTO_R_STRING_TOO_LONG
);
268 pd
= param_push(bld
, key
, bsize
, sizeof(buf
), OSSL_PARAM_UTF8_PTR
, 0);
275 int OSSL_PARAM_BLD_push_octet_string(OSSL_PARAM_BLD
*bld
, const char *key
,
276 const void *buf
, size_t bsize
)
278 OSSL_PARAM_BLD_DEF
*pd
;
280 if (bsize
> INT_MAX
) {
281 ERR_raise(ERR_LIB_CRYPTO
, CRYPTO_R_STRING_TOO_LONG
);
284 pd
= param_push(bld
, key
, bsize
, bsize
, OSSL_PARAM_OCTET_STRING
, 0);
291 int OSSL_PARAM_BLD_push_octet_ptr(OSSL_PARAM_BLD
*bld
, const char *key
,
292 void *buf
, size_t bsize
)
294 OSSL_PARAM_BLD_DEF
*pd
;
296 if (bsize
> INT_MAX
) {
297 ERR_raise(ERR_LIB_CRYPTO
, CRYPTO_R_STRING_TOO_LONG
);
300 pd
= param_push(bld
, key
, bsize
, sizeof(buf
), OSSL_PARAM_OCTET_PTR
, 0);
307 static OSSL_PARAM
*param_bld_convert(OSSL_PARAM_BLD
*bld
, OSSL_PARAM
*param
,
308 OSSL_PARAM_BLD_BLOCK
*blk
,
309 OSSL_PARAM_BLD_BLOCK
*secure
)
311 int i
, num
= sk_OSSL_PARAM_BLD_DEF_num(bld
->params
);
312 OSSL_PARAM_BLD_DEF
*pd
;
315 for (i
= 0; i
< num
; i
++) {
316 pd
= sk_OSSL_PARAM_BLD_DEF_value(bld
->params
, i
);
317 param
[i
].key
= pd
->key
;
318 param
[i
].data_type
= pd
->type
;
319 param
[i
].data_size
= pd
->size
;
320 param
[i
].return_size
= OSSL_PARAM_UNMODIFIED
;
324 secure
+= pd
->alloc_blocks
;
327 blk
+= pd
->alloc_blocks
;
330 if (pd
->bn
!= NULL
) {
332 BN_bn2nativepad(pd
->bn
, (unsigned char *)p
, pd
->size
);
333 } else if (pd
->type
== OSSL_PARAM_OCTET_PTR
334 || pd
->type
== OSSL_PARAM_UTF8_PTR
) {
336 *(const void **)p
= pd
->string
;
337 } else if (pd
->type
== OSSL_PARAM_OCTET_STRING
338 || pd
->type
== OSSL_PARAM_UTF8_STRING
) {
339 if (pd
->string
!= NULL
)
340 memcpy(p
, pd
->string
, pd
->size
);
342 memset(p
, 0, pd
->size
);
343 if (pd
->type
== OSSL_PARAM_UTF8_STRING
)
344 ((char *)p
)[pd
->size
] = '\0';
346 /* Number, but could also be a NULL BIGNUM */
347 if (pd
->size
> sizeof(pd
->num
))
348 memset(p
, 0, pd
->size
);
349 else if (pd
->size
> 0)
350 memcpy(p
, &pd
->num
, pd
->size
);
353 param
[i
] = OSSL_PARAM_construct_end();
357 OSSL_PARAM
*OSSL_PARAM_BLD_to_param(OSSL_PARAM_BLD
*bld
)
359 OSSL_PARAM_BLD_BLOCK
*blk
, *s
= NULL
;
360 OSSL_PARAM
*params
, *last
;
361 const int num
= sk_OSSL_PARAM_BLD_DEF_num(bld
->params
);
362 const size_t p_blks
= bytes_to_blocks((1 + num
) * sizeof(*params
));
363 const size_t total
= ALIGN_SIZE
* (p_blks
+ bld
->total_blocks
);
364 const size_t ss
= ALIGN_SIZE
* bld
->secure_blocks
;
367 s
= OPENSSL_secure_malloc(ss
);
369 ERR_raise(ERR_LIB_CRYPTO
, CRYPTO_R_SECURE_MALLOC_FAILURE
);
373 params
= OPENSSL_malloc(total
);
374 if (params
== NULL
) {
375 ERR_raise(ERR_LIB_CRYPTO
, ERR_R_MALLOC_FAILURE
);
376 OPENSSL_secure_free(s
);
379 blk
= p_blks
+ (OSSL_PARAM_BLD_BLOCK
*)(params
);
380 last
= param_bld_convert(bld
, params
, blk
, s
);
381 last
->data_size
= ss
;
383 last
->data_type
= OSSL_PARAM_ALLOCATED_END
;
385 /* Reset builder for reuse */
386 bld
->total_blocks
= 0;
387 bld
->secure_blocks
= 0;
388 free_all_params(bld
);
392 void OSSL_PARAM_BLD_free_params(OSSL_PARAM
*params
)
394 if (params
!= NULL
) {
397 for (p
= params
; p
->key
!= NULL
; p
++)
399 if (p
->data_type
== OSSL_PARAM_ALLOCATED_END
)
400 OPENSSL_secure_clear_free(p
->data
, p
->data_size
);
401 OPENSSL_free(params
);