add internal doc files actually belonging to CMP contribution chunk 6
[openssl.git] / doc / man3 / EVP_sha224.pod
1 =pod
2
3 =head1 NAME
4
5 EVP_sha224,
6 EVP_sha256,
7 EVP_sha512_224,
8 EVP_sha512_256,
9 EVP_sha384,
10 EVP_sha512
11 - SHA-2 For EVP
12
13 =head1 SYNOPSIS
14
15  #include <openssl/evp.h>
16
17  const EVP_MD *EVP_sha224(void);
18  const EVP_MD *EVP_sha256(void);
19  const EVP_MD *EVP_sha512_224(void);
20  const EVP_MD *EVP_sha512_256(void);
21  const EVP_MD *EVP_sha384(void);
22  const EVP_MD *EVP_sha512(void);
23
24 =head1 DESCRIPTION
25
26 SHA-2 (Secure Hash Algorithm 2) is a family of cryptographic hash functions
27 standardized in NIST FIPS 180-4, first published in 2001.
28
29 =over 4
30
31 =item EVP_sha224(),
32 EVP_sha256(),
33 EVP_sha512_224,
34 EVP_sha512_256,
35 EVP_sha384(),
36 EVP_sha512()
37
38 The SHA-2 SHA-224, SHA-256, SHA-512/224, SHA512/256, SHA-384 and SHA-512
39 algorithms, which generate 224, 256, 224, 256, 384 and 512 bits
40 respectively of output from a given input.
41
42 The two algorithms: SHA-512/224 and SHA512/256 are truncated forms of the
43 SHA-512 algorithm. They are distinct from SHA-224 and SHA-256 even though
44 their outputs are of the same size.
45
46 =back
47
48
49 =head1 RETURN VALUES
50
51 These functions return a B<EVP_MD> structure that contains the
52 implementation of the symmetric cipher. See L<EVP_MD_meth_new(3)> for
53 details of the B<EVP_MD> structure.
54
55 =head1 CONFORMING TO
56
57 NIST FIPS 180-4.
58
59 =head1 SEE ALSO
60
61 L<evp(7)>,
62 L<EVP_DigestInit(3)>
63
64 =head1 COPYRIGHT
65
66 Copyright 2017-2018 The OpenSSL Project Authors. All Rights Reserved.
67
68 Licensed under the Apache License 2.0 (the "License").  You may not use
69 this file except in compliance with the License.  You can obtain a copy
70 in the file LICENSE in the source distribution or at
71 L<https://www.openssl.org/source/license.html>.
72
73 =cut
74