From: Dr. David von Oheimb Date: Sun, 13 Apr 2025 19:58:35 +0000 (+0200) Subject: provider-signature.pod: fix doc of OSSL_SIGNATURE_PARAM_ALGORITHM_ID, describing... X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=23e3b3c0c5d8f29d95f518a1f0e40f3e1c63ead9;p=thirdparty%2Fopenssl.git 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) --- 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