xref: /freebsd/crypto/openssl/doc/man7/EVP_SIGNATURE-DSA.pod (revision 0d0c8621fd181e507f0fb50ffcca606faf66a8c2)
1b077aed3SPierre Pronchery=pod
2b077aed3SPierre Pronchery
3b077aed3SPierre Pronchery=head1 NAME
4b077aed3SPierre Pronchery
5b077aed3SPierre ProncheryEVP_SIGNATURE-DSA
6b077aed3SPierre Pronchery- The B<EVP_PKEY> DSA signature implementation
7b077aed3SPierre Pronchery
8b077aed3SPierre Pronchery=head1 DESCRIPTION
9b077aed3SPierre Pronchery
10*0d0c8621SEnji CooperSupport for computing DSA signatures. The signature produced with
11*0d0c8621SEnji CooperL<EVP_PKEY_sign(3)> is DER encoded ASN.1 in the form described in
12*0d0c8621SEnji CooperRFC 3279, section 2.2.2.
13b077aed3SPierre ProncherySee L<EVP_PKEY-DSA(7)> for information related to DSA keys.
14b077aed3SPierre Pronchery
15b077aed3SPierre Pronchery=head2 Signature Parameters
16b077aed3SPierre Pronchery
17b077aed3SPierre ProncheryThe following signature parameters can be set using EVP_PKEY_CTX_set_params().
18b077aed3SPierre ProncheryThis may be called after EVP_PKEY_sign_init() or EVP_PKEY_verify_init(),
19b077aed3SPierre Proncheryand before calling EVP_PKEY_sign() or EVP_PKEY_verify().
20b077aed3SPierre Pronchery
21b077aed3SPierre Pronchery=over 4
22b077aed3SPierre Pronchery
23b077aed3SPierre Pronchery=item "digest" (B<OSSL_SIGNATURE_PARAM_DIGEST>) <UTF8 string>
24b077aed3SPierre Pronchery
25b077aed3SPierre Pronchery=item "properties" (B<OSSL_SIGNATURE_PARAM_PROPERTIES>) <UTF8 string>
26b077aed3SPierre Pronchery
27b077aed3SPierre ProncheryThe settable parameters are described in L<provider-signature(7)>.
28b077aed3SPierre Pronchery
29b077aed3SPierre Pronchery=back
30b077aed3SPierre Pronchery
31b077aed3SPierre ProncheryThe following signature parameters can be retrieved using
32b077aed3SPierre ProncheryEVP_PKEY_CTX_get_params().
33b077aed3SPierre Pronchery
34b077aed3SPierre Pronchery=over 4
35b077aed3SPierre Pronchery
36b077aed3SPierre Pronchery=item "algorithm-id" (B<OSSL_SIGNATURE_PARAM_ALGORITHM_ID>) <octet string>
37b077aed3SPierre Pronchery
38b077aed3SPierre Pronchery=item "digest" (B<OSSL_SIGNATURE_PARAM_DIGEST>) <UTF8 string>
39b077aed3SPierre Pronchery
40b077aed3SPierre ProncheryThe gettable parameters are described in L<provider-signature(7)>.
41b077aed3SPierre Pronchery
42b077aed3SPierre Pronchery=back
43b077aed3SPierre Pronchery
44b077aed3SPierre Pronchery=head1 SEE ALSO
45b077aed3SPierre Pronchery
46b077aed3SPierre ProncheryL<EVP_PKEY_CTX_set_params(3)>,
47b077aed3SPierre ProncheryL<EVP_PKEY_sign(3)>,
48b077aed3SPierre ProncheryL<EVP_PKEY_verify(3)>,
49b077aed3SPierre ProncheryL<provider-signature(7)>,
50b077aed3SPierre Pronchery
51b077aed3SPierre Pronchery=head1 COPYRIGHT
52b077aed3SPierre Pronchery
53b077aed3SPierre ProncheryCopyright 2020-2021 The OpenSSL Project Authors. All Rights Reserved.
54b077aed3SPierre Pronchery
55b077aed3SPierre ProncheryLicensed under the Apache License 2.0 (the "License").  You may not use
56b077aed3SPierre Proncherythis file except in compliance with the License.  You can obtain a copy
57b077aed3SPierre Proncheryin the file LICENSE in the source distribution or at
58b077aed3SPierre ProncheryL<https://www.openssl.org/source/license.html>.
59b077aed3SPierre Pronchery
60b077aed3SPierre Pronchery=cut
61