Fix documentation for provider-signature

Fixes #17909.

Reviewed-by: Tomas Mraz <tomas@openssl.org>
Reviewed-by: Richard Levitte <levitte@openssl.org>
Reviewed-by: Paul Dale <pauli@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/17914)
This commit is contained in:
Hugo Landau 2022-03-16 16:40:14 +00:00 committed by Pauli
parent a12a71fafb
commit a07a70c76f

View File

@ -43,7 +43,7 @@ provider-signature - The signature library E<lt>-E<gt> provider functions
/* Digest Sign */ /* Digest Sign */
int OSSL_FUNC_signature_digest_sign_init(void *ctx, const char *mdname, int OSSL_FUNC_signature_digest_sign_init(void *ctx, const char *mdname,
const char *props, void *provkey, void *provkey,
const OSSL_PARAM params[]); const OSSL_PARAM params[]);
int OSSL_FUNC_signature_digest_sign_update(void *ctx, const unsigned char *data, int OSSL_FUNC_signature_digest_sign_update(void *ctx, const unsigned char *data,
size_t datalen); size_t datalen);
@ -56,7 +56,7 @@ provider-signature - The signature library E<lt>-E<gt> provider functions
/* Digest Verify */ /* Digest Verify */
int OSSL_FUNC_signature_digest_verify_init(void *ctx, const char *mdname, int OSSL_FUNC_signature_digest_verify_init(void *ctx, const char *mdname,
const char *props, void *provkey, void *provkey,
const OSSL_PARAM params[]); const OSSL_PARAM params[]);
int OSSL_FUNC_signature_digest_verify_update(void *ctx, int OSSL_FUNC_signature_digest_verify_update(void *ctx,
const unsigned char *data, const unsigned char *data,
@ -266,9 +266,7 @@ OSSL_FUNC_signature_set_ctx_md_params().
The key object should have been The key object should have been
previously generated, loaded or imported into the provider using the previously generated, loaded or imported into the provider using the
key management (OSSL_OP_KEYMGMT) operation (see provider-keymgmt(7)>. key management (OSSL_OP_KEYMGMT) operation (see provider-keymgmt(7)>.
The name of the digest to be used will be in the I<mdname> parameter. There may The name of the digest to be used will be in the I<mdname> parameter.
also be properties to be used in fetching the digest in the I<props> parameter,
although this may be ignored by providers.
OSSL_FUNC_signature_digest_sign_update() provides data to be signed in the I<data> OSSL_FUNC_signature_digest_sign_update() provides data to be signed in the I<data>
parameter which should be of length I<datalen>. A previously initialised parameter which should be of length I<datalen>. A previously initialised
@ -305,9 +303,7 @@ OSSL_FUNC_signature_set_ctx_md_params().
The key object should have been The key object should have been
previously generated, loaded or imported into the provider using the previously generated, loaded or imported into the provider using the
key management (OSSL_OP_KEYMGMT) operation (see provider-keymgmt(7)>. key management (OSSL_OP_KEYMGMT) operation (see provider-keymgmt(7)>.
The name of the digest to be used will be in the I<mdname> parameter. There may The name of the digest to be used will be in the I<mdname> parameter.
also be properties to be used in fetching the digest in the I<props> parameter,
although this may be ignored by providers.
OSSL_FUNC_signature_digest_verify_update() provides data to be verified in the I<data> OSSL_FUNC_signature_digest_verify_update() provides data to be verified in the I<data>
parameter which should be of length I<datalen>. A previously initialised parameter which should be of length I<datalen>. A previously initialised