diff options
author | Richard Levitte <levitte@openssl.org> | 2019-12-18 13:20:55 +0100 |
---|---|---|
committer | Richard Levitte <levitte@openssl.org> | 2020-01-09 15:01:16 +0100 |
commit | e62a45b60e3166d995eb83840f437debf575c328 (patch) | |
tree | 593daef7330874e6f5d7f75257957b34aada905e /doc/man7 | |
parent | cc4ff1061efd95f1560289f1bb726975cb7b83fc (diff) |
CORE & EVP: Specify OP_query_operation_name() for KEYMGMT
This will allow keymgmt implementation for key types that need it to
specify the names of the diverse operation algorithms it can be used
with. Currently, only one name per key type and operation is allowed.
Reviewed-by: Shane Lontis <shane.lontis@oracle.com>
(Merged from https://github.com/openssl/openssl/pull/10647)
Diffstat (limited to 'doc/man7')
-rw-r--r-- | doc/man7/provider-keymgmt.pod | 13 |
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/man7/provider-keymgmt.pod b/doc/man7/provider-keymgmt.pod index 40f1ad6327..1c868c5630 100644 --- a/doc/man7/provider-keymgmt.pod +++ b/doc/man7/provider-keymgmt.pod @@ -40,6 +40,9 @@ provider-keymgmt - The KEYMGMT library E<lt>-E<gt> provider functions const OSSL_PARAM *OP_keymgmt_importkey_types(void); const OSSL_PARAM *OP_keymgmt_exportkey_types(void); + /* Discovery of supported operations */ + const char *OP_keymgmt_query_operation_name(int operation_id); + =head1 DESCRIPTION The KEYMGMT operation doesn't have much public visibility in OpenSSL @@ -158,6 +161,16 @@ OP_keymgmt_exportkey_types() should return a constant array of descriptor B<OSSL_PARAM>, for parameters that can be exported with OP_keymgmt_exportkeys(). +=head2 Supported operations + +OP_keymgmt_query_operation_name() should return the name of the +supported algorithm for the operation I<operation_id>. This is +similar to provider_query_operation() (see L<provider-base(7)>), +but only works as an advisory. If this function is not present, or +returns NULL, the caller is free to assume that there's an algorithm +from the same provider, of the same name as the one used to fetch the +keymgmt and try to use that. + =head1 SEE ALSO L<provider(7)> |