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