1 /*
2  * Copyright 2023 The OpenSSL Project Authors. All Rights Reserved.
3  *
4  * Licensed under the Apache License 2.0 (the "License").  You may not use
5  * this file except in compliance with the License.  You can obtain a copy
6  * in the file LICENSE in the source distribution or at
7  * https://www.openssl.org/source/license.html
8  */
9 
10 #include <stddef.h>
11 #include <openssl/params.h>
12 
13 /*
14  * Extract the parameter into an allocated buffer.
15  * Any existing allocation in *out is cleared and freed.
16  *
17  * Returns 1 on success, 0 on failure and -1  if there are no matching params.
18  *
19  * *out and *out_len are guaranteed to be untouched if this function
20  * doesn't return success.
21  */
22 int ossl_param_get1_octet_string_from_param(const OSSL_PARAM *p,
23                                             unsigned char **out,
24                                             size_t *out_len);
25 int ossl_param_get1_octet_string(const OSSL_PARAM *params, const char *name,
26                                  unsigned char **out, size_t *out_len);
27 
28 /*
29  * Concatenate all of the matching params together.
30  * *out will point to an allocated buffer on successful return.
31  * Any existing allocation in *out is cleared and freed.
32  *
33  * Passing 0 for maxsize means unlimited size output.
34  *
35  * Returns 1 on success and 0 on failure.
36  *
37  * *out and *out_len are guaranteed to be untouched if this function
38  * doesn't return success.
39  */
40 int ossl_param_get1_concat_octet_string(size_t n, OSSL_PARAM *params[],
41                                         unsigned char **out, size_t *out_len);
42