xref: /freebsd/crypto/openssl/doc/man3/EVP_sha3_224.pod (revision ebacd8013fe5f7fdf9f6a5b286f6680dd2891036)
1=pod
2
3=head1 NAME
4
5EVP_sha3_224,
6EVP_sha3_256,
7EVP_sha3_384,
8EVP_sha3_512,
9EVP_shake128,
10EVP_shake256
11- SHA-3 For EVP
12
13=head1 SYNOPSIS
14
15 #include <openssl/evp.h>
16
17 const EVP_MD *EVP_sha3_224(void);
18 const EVP_MD *EVP_sha3_256(void);
19 const EVP_MD *EVP_sha3_384(void);
20 const EVP_MD *EVP_sha3_512(void);
21
22 const EVP_MD *EVP_shake128(void);
23 const EVP_MD *EVP_shake256(void);
24
25=head1 DESCRIPTION
26
27SHA-3 (Secure Hash Algorithm 3) is a family of cryptographic hash functions
28standardized in NIST FIPS 202, first published in 2015. It is based on the
29Keccak algorithm.
30
31=over 4
32
33=item EVP_sha3_224(),
34EVP_sha3_256(),
35EVP_sha3_384(),
36EVP_sha3_512()
37
38The SHA-3 SHA-3-224, SHA-3-256, SHA-3-384, and SHA-3-512 algorithms
39respectively. They produce 224, 256, 384 and 512 bits of output from a given
40input.
41
42=item EVP_shake128(),
43EVP_shake256()
44
45The SHAKE-128 and SHAKE-256 Extendable Output Functions (XOF) that can generate
46a variable hash length.
47
48Specifically, B<EVP_shake128> provides an overall security of 128 bits, while
49B<EVP_shake256> provides that of 256 bits.
50
51=back
52
53
54=head1 RETURN VALUES
55
56These functions return a B<EVP_MD> structure that contains the
57implementation of the symmetric cipher. See L<EVP_MD_meth_new(3)> for
58details of the B<EVP_MD> structure.
59
60=head1 CONFORMING TO
61
62NIST FIPS 202.
63
64=head1 SEE ALSO
65
66L<evp(7)>,
67L<EVP_DigestInit(3)>
68
69=head1 COPYRIGHT
70
71Copyright 2017 The OpenSSL Project Authors. All Rights Reserved.
72
73Licensed under the OpenSSL license (the "License").  You may not use
74this file except in compliance with the License.  You can obtain a copy
75in the file LICENSE in the source distribution or at
76L<https://www.openssl.org/source/license.html>.
77
78=cut
79
80