EVP_sha3_224.pod 1.6 KB

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