mirror of
https://github.com/openssl/openssl.git
synced 2024-12-21 06:09:35 +08:00
1e55cbc874
The provider- manuals are meant to describe the general interface for their respective operation. This is not the place to describe implementation specific details. This change creates a number of doc/man7/EVP_MD manuals, one for each algorithm or set of algorithms, as well as doc/man7/EVP_MD-common.pod to describe what's common to them all. While we're at it, correct the SHA3 settable context params array to match what's actually settable. Reviewed-by: Matt Caswell <matt@openssl.org> (Merged from https://github.com/openssl/openssl/pull/11270)
56 lines
1.6 KiB
Plaintext
56 lines
1.6 KiB
Plaintext
=pod
|
|
|
|
=head1 NAME
|
|
|
|
EVP_MD-SHA1 - The SHA1 EVP_MD implementation
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
Support for computing SHA1 digests through the B<EVP_MD> API.
|
|
|
|
=head2 Identities
|
|
|
|
This implementation is available with the FIPS provider as well as the
|
|
default provider, and is identified with the names "SHA1" and "SHA-1".
|
|
|
|
=head2 Gettable Parameters
|
|
|
|
This implementation supports the common gettable parameters described
|
|
in L<EVP_MD-common(7)>.
|
|
|
|
=head2 Settable Context Parameters
|
|
|
|
This implementation supports the following L<OSSL_PARAM(3)> entries,
|
|
settable for an B<EVP_MD_CTX> with L<EVP_MD_CTX_set_params(3)>:
|
|
|
|
=over 4
|
|
|
|
=item "ssl3-ms" (B<OSSL_DIGEST_PARAM_SSL3_MS>) <octet string>
|
|
|
|
This parameter is set by libssl in order to calculate a signature hash for an
|
|
SSLv3 CertificateVerify message as per RFC6101.
|
|
It is only set after all handshake messages have already been digested via
|
|
OP_digest_update() calls.
|
|
The parameter provides the master secret value to be added to the digest.
|
|
The digest implementation should calculate the complete digest as per RFC6101
|
|
section 5.6.8.
|
|
The next call after setting this parameter should be OP_digest_final().
|
|
|
|
=back
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<EVP_MD_CTX_set_params(3)>, L<provider-digest(7)>,
|
|
L<OSSL_PROVIDER-FIPS(7)>, L<OSSL_PROVIDER-default(7)>
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
Copyright 2020 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
|