diff options
author | Oliver Mihatsch <oliver.mihatsch@virtual-solution.com> | 2023-02-02 12:15:14 +0100 |
---|---|---|
committer | Todd Short <todd.short@me.com> | 2023-02-08 10:27:07 -0500 |
commit | a8aad913ecc632405096b2b61942b2c782cc74f4 (patch) | |
tree | 50d837c6a5166070c7012e619c0eece502f92231 /doc | |
parent | ee17148792943f7f6455213a3b9a86a4cc082c9a (diff) |
New function EC_GROUP_to_params to convert an EC_GROUP to an array of OSSL_PARAM.
Reviewed-by: Tomas Mraz <tomas@openssl.org>
Reviewed-by: Matt Caswell <matt@openssl.org>
Reviewed-by: Todd Short <todd.short@me.com>
(Merged from https://github.com/openssl/openssl/pull/20205)
Diffstat (limited to 'doc')
-rw-r--r-- | doc/man3/EC_GROUP_new.pod | 13 |
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/man3/EC_GROUP_new.pod b/doc/man3/EC_GROUP_new.pod index b6d67b6176..d7f8d001c2 100644 --- a/doc/man3/EC_GROUP_new.pod +++ b/doc/man3/EC_GROUP_new.pod @@ -5,6 +5,7 @@ EC_GROUP_get_ecparameters, EC_GROUP_get_ecpkparameters, EC_GROUP_new_from_params, +EC_GROUP_to_params, EC_GROUP_new_from_ecparameters, EC_GROUP_new_from_ecpkparameters, EC_GROUP_new, @@ -30,6 +31,8 @@ Functions for creating and destroying EC_GROUP objects EC_GROUP *EC_GROUP_new_from_params(const OSSL_PARAM params[], OSSL_LIB_CTX *libctx, const char *propq); + OSSL_PARAM *EC_GROUP_to_params(const EC_GROUP *group, OSSL_LIB_CTX *libctx, + const char *propq, BN_CTX *bnctx); EC_GROUP *EC_GROUP_new_from_ecparameters(const ECPARAMETERS *params); EC_GROUP *EC_GROUP_new_from_ecpkparameters(const ECPKPARAMETERS *params); void EC_GROUP_free(EC_GROUP *group); @@ -107,6 +110,16 @@ The values for I<ctx> and I<propq> may be NULL. The I<params> that can be used are described in L<B<EVP_PKEY-EC>(7)|EVP_PKEY-EC(7)/Common EC parameters>. +EC_GROUP_to_params creates an OSSL_PARAM array with the corresponding parameters +describing the given EC_GROUP. The resulting parameters may contain parameters +describing a named or explicit curve depending on the EC_GROUP. +The library context I<libctx> (see L<OSSL_LIB_CTX(3)>) and property query string +I<propq> are used to fetch algorithms from providers. +I<bnctx> is an optional preallocated BN_CTX (to save the overhead of allocating +and freeing the structure in a loop). +The values for I<libctx>, I<propq> and I<bnctx> may be NULL. +The caller is responsible for freeing the OSSL_PARAM pointer returned. + EC_GROUP_new_from_ecparameters() will create a group from the specified I<params> and EC_GROUP_new_from_ecpkparameters() will create a group from the specific PK |