[thirdparty/openssl.git] / doc / man7 / EVP_SIGNATURE-DSA.pod

=pod

=head1 NAME

EVP_SIGNATURE-DSA
- The B<EVP_PKEY> DSA signature implementation

=head1 DESCRIPTION

Support for computing DSA signatures.
See L<EVP_PKEY-DSA(7)> for information related to DSA keys.

=head2 Signature Parameters

The following signature parameters can be set using EVP_PKEY_CTX_set_params().
This may be called after EVP_PKEY_sign_init() or EVP_PKEY_verify_init(),
and before calling EVP_PKEY_sign() or EVP_PKEY_verify().

=over 4

=item "digest" (B<OSSL_SIGNATURE_PARAM_DIGEST>) <UTF8 string>

=item "properties" (B<OSSL_SIGNATURE_PARAM_PROPERTIES>) <UTF8 string>

=item "nonce-type" (B<OSSL_SIGNATURE_PARAM_NONCE_TYPE>) <unsigned integer>

The settable parameters are described in L<provider-signature(7)>.

=back

The following signature parameters can be retrieved using
EVP_PKEY_CTX_get_params().

=over 4

=item "algorithm-id" (B<OSSL_SIGNATURE_PARAM_ALGORITHM_ID>) <octet string>

=item "digest" (B<OSSL_SIGNATURE_PARAM_DIGEST>) <UTF8 string>

=item "nonce-type" (B<OSSL_SIGNATURE_PARAM_NONCE_TYPE>) <unsigned integer>

The gettable parameters are described in L<provider-signature(7)>.

=back

=head1 SEE ALSO

L<EVP_PKEY_CTX_set_params(3)>,
L<EVP_PKEY_sign(3)>,
L<EVP_PKEY_verify(3)>,
L<provider-signature(7)>,

=head1 COPYRIGHT

Copyright 2020-2023 The OpenSSL Project Authors. All Rights Reserved.

Licensed under the Apache License 2.0 (the "License").  You may not use
this file except in compliance with the License.  You can obtain a copy
in the file LICENSE in the source distribution or at
L<https://www.openssl.org/source/license.html>.

=cut
Commit	Line	Data
b8086652 SL	1	=pod
	2
	3	=head1 NAME
	4
	5	EVP_SIGNATURE-DSA
	6	- The B<EVP_PKEY> DSA signature implementation
	7
	8	=head1 DESCRIPTION
	9
	10	Support for computing DSA signatures.
	11	See L<EVP_PKEY-DSA(7)> for information related to DSA keys.
	12
	13	=head2 Signature Parameters
	14
	15	The following signature parameters can be set using EVP_PKEY_CTX_set_params().
	16	This may be called after EVP_PKEY_sign_init() or EVP_PKEY_verify_init(),
57cd10dd	17	and before calling EVP_PKEY_sign() or EVP_PKEY_verify().
b8086652 SL	18
	19	=over 4
	20
	21	=item "digest" (B<OSSL_SIGNATURE_PARAM_DIGEST>) <UTF8 string>
	22
	23	=item "properties" (B<OSSL_SIGNATURE_PARAM_PROPERTIES>) <UTF8 string>
	24
f3090fc7	25	=item "nonce-type" (B<OSSL_SIGNATURE_PARAM_NONCE_TYPE>) <unsigned integer>
f3090fc7	26
b8086652 SL	27	The settable parameters are described in L<provider-signature(7)>.
	28
	29	=back
	30
	31	The following signature parameters can be retrieved using
	32	EVP_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
1d857945 IF	40	=item "nonce-type" (B<OSSL_SIGNATURE_PARAM_NONCE_TYPE>) <unsigned integer>
1d857945 IF	41
b8086652 SL	42	The gettable parameters are described in L<provider-signature(7)>.
	43
	44	=back
	45
	46	=head1 SEE ALSO
	47
	48	L<EVP_PKEY_CTX_set_params(3)>,
	49	L<EVP_PKEY_sign(3)>,
	50	L<EVP_PKEY_verify(3)>,
	51	L<provider-signature(7)>,
	52
	53	=head1 COPYRIGHT
	54
da1c088f	55	Copyright 2020-2023 The OpenSSL Project Authors. All Rights Reserved.
b8086652 SL	56
	57	Licensed under the Apache License 2.0 (the "License"). You may not use
	58	this file except in compliance with the License. You can obtain a copy
	59	in the file LICENSE in the source distribution or at
	60	L<https://www.openssl.org/source/license.html>.
	61
	62	=cut