From 00bc31f372bd475e7946c592c1565e227659e6ee Mon Sep 17 00:00:00 2001 From: "Dr. David von Oheimb" Date: Sun, 13 Apr 2025 21:58:35 +0200 Subject: [PATCH] provider-signature.pod: fix doc of OSSL_SIGNATURE_PARAM_ALGORITHM_ID, describing its relevance This provides a fix for the documentation part of #22932. Reviewed-by: Tomas Mraz Reviewed-by: Tom Cosgrove (Merged from https://github.com/openssl/openssl/pull/27372) (cherry picked from commit 23e3b3c0c5d8f29d95f518a1f0e40f3e1c63ead9) --- doc/man7/provider-signature.pod | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/doc/man7/provider-signature.pod b/doc/man7/provider-signature.pod index 203223cd6bd..0abb08a0377 100644 --- a/doc/man7/provider-signature.pod +++ b/doc/man7/provider-signature.pod @@ -470,8 +470,13 @@ The length of the "digest-size" parameter should not exceed that of a B. =item "algorithm-id" (B) -Gets the DER encoded AlgorithmIdentifier that corresponds to the combination of -signature algorithm and digest algorithm for the signature operation. +Gets the DER-encoded AlgorithmIdentifier for the signature operation. +This typically corresponds to the combination of a digest algorithm +with a purely asymmetric signature algorithm, such as SHA256WithECDSA. + +The L relies on this operation and is used by +many other functions signing ASN.1 structures such as X.509 certificates, +certificate requests, and CRLs, as well as OCSP, CMP, and CMS messages. =item "nonce-type" (B) @@ -603,7 +608,8 @@ All other functions should return 1 for success or 0 on error. =head1 SEE ALSO -L +L, +L =head1 HISTORY -- 2.47.2