root
/
openssl
mirror of https://github.com/openssl/openssl.git
1
0
Fork 0
Code Issues Actions 7 Packages Projects Releases Wiki Activity
openssl/doc/man7/EVP_MD-SHA2.pod

82 lines
1.4 KiB
Plaintext
Raw Normal View History

DOCS: Move implementation specific docs away from provider-digest(7) 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)
2020-03-06 21:29:00 +08:00
=pod
=head1 NAME
EVP_MD-SHA2 - The SHA2 EVP_MD implementation
=head1 DESCRIPTION
Support for computing SHA2 digests through the B<EVP_MD> API.
=head2 Identities
This implementation includes the following varieties:
=over 4
=item *
Available with the FIPS provider as well as the default provider:
=over 4
=item SHA2-224
Known names are "SHA2-224", "SHA-224" and "SHA224".
=item SHA2-256
Known names are "SHA2-256", "SHA-256" and "SHA256".
=item SHA2-384
Known names are "SHA2-384", "SHA-384" and "SHA384".
=item SHA2-512
Known names are "SHA2-512", "SHA-512" and "SHA512".
=back
=item *
Available with the default provider:
=over 4
Add support for SHA256/192 This is defined in NIST SP 800-208 as the truncation to 192 bits of SHA256. Unlike other truncated hashes in the SHA2 suite, this variant doesn't have a different initial state, it is just a pure truncation of the output. Reviewed-by: Tomas Mraz <tomas@openssl.org> Reviewed-by: Paul Dale <pauli@openssl.org> (Merged from https://github.com/openssl/openssl/pull/21180)
2023-06-12 18:02:14 +08:00
=item SHA2-256/192
Known names are "SHA2-256/192", "SHA-256/192" and "SHA256-192".
DOCS: Move implementation specific docs away from provider-digest(7) 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)
2020-03-06 21:29:00 +08:00
=item SHA2-512/224
Known names are "SHA2-512/224", "SHA-512/224" and "SHA512-224".
=item SHA2-512/256
Known names are "SHA2-512/256", "SHA-512/256" and "SHA512-256".
=back
=back
=head2 Gettable Parameters
This implementation supports the common gettable parameters described
in L<EVP_MD-common(7)>.
=head1 SEE ALSO
L<provider-digest(7)>, L<OSSL_PROVIDER-FIPS(7)>, L<OSSL_PROVIDER-default(7)>
=head1 COPYRIGHT
Copyright year updates Reviewed-by: Richard Levitte <levitte@openssl.org> Release: yes
2023-09-07 16:59:15 +08:00
Copyright 2020-2023 The OpenSSL Project Authors. All Rights Reserved.
DOCS: Move implementation specific docs away from provider-digest(7) 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)
2020-03-06 21:29:00 +08:00
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