]> git.ipfire.org Git - thirdparty/openssl.git/commitdiff
doc: add verify-digested param for EdDSA
authorPauli <ppzgs1@gmail.com>
Tue, 30 Jul 2024 01:29:32 +0000 (11:29 +1000)
committerPauli <ppzgs1@gmail.com>
Wed, 7 Aug 2024 07:12:58 +0000 (17:12 +1000)
Reviewed-by: Tomas Mraz <tomas@openssl.org>
Reviewed-by: Shane Lontis <shane.lontis@oracle.com>
(Merged from https://github.com/openssl/openssl/pull/25032)

doc/man7/EVP_SIGNATURE-ED25519.pod

index aba56f31824936d210b9e719fdbf0a7187a92440..a525147bcb95ca6fe2c8825d71c1cb50ff9c9d6a 100644 (file)
@@ -38,9 +38,9 @@ instance, a nonempty context-string is not permitted.
 
 =head2 ED25519 and ED448 Signature Parameters
 
-Two parameters can be set during signing or verification: the EdDSA
-B<instance name> and the B<context-string value>.  They can be set by
-passing an OSSL_PARAM array to EVP_DigestSignInit_ex().
+The following parameters can be set during signing or verification by
+passing an OSSL_PARAM array to EVP_DigestSignInit_ex() or
+EVP_PKEY_CTX_set_params():
 
 =over 4
 
@@ -56,9 +56,14 @@ One of the five strings "Ed25519", "Ed25519ctx", "Ed25519ph", "Ed448", "Ed448ph"
 
 A string of octets with length at most 255.
 
+=item * "verify-digested" (B<OSSL_SIGNATURE_PARAM_EDDSA_VERIFY_DIGESTED> <integer>
+
+If set to a nonzero value, EdDSA can be used to verify a hash of a message.
+If zero, EdDSA will digest the message internally.
+
 =back
 
-Both of these parameters are optional.
+All of these parameters are optional.
 
 If the instance name is not specified, then the default "Ed25519" or
 "Ed448" is used.
@@ -82,6 +87,8 @@ EVP_PKEY_CTX_get_params().
 
 =item * "context-string" (B<OSSL_SIGNATURE_PARAM_CONTEXT_STRING>) <octet string>
 
+=item * "fips-indicator" (B<OSSL_SIGNATURE_PARAM_FIPS_APPROVED_INDICATOR>) <integer>
+
 =back
 
 The parameters are described in L<provider-signature(7)>.