EVP_blake2b512.pod 1.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970
  1. =pod
  2. =head1 NAME
  3. EVP_blake2b512,
  4. EVP_blake2s256
  5. - BLAKE2 For EVP
  6. =head1 SYNOPSIS
  7. #include <openssl/evp.h>
  8. const EVP_MD *EVP_blake2b512(void);
  9. const EVP_MD *EVP_blake2s256(void);
  10. =head1 DESCRIPTION
  11. BLAKE2 is an improved version of BLAKE, which was submitted to the NIST SHA-3
  12. algorithm competition. The BLAKE2s and BLAKE2b algorithms are described in
  13. RFC 7693.
  14. =over 4
  15. =item EVP_blake2s256()
  16. The BLAKE2s algorithm that produces a 256-bit output from a given input.
  17. =item EVP_blake2b512()
  18. The BLAKE2b algorithm that produces a 512-bit output from a given input.
  19. =back
  20. =head1 NOTES
  21. Developers should be aware of the negative performance implications of
  22. calling these functions multiple times and should consider using
  23. L<EVP_MD_fetch(3)> with L<EVP_MD-BLAKE2(7)> instead.
  24. See L<crypto(7)/Performance> for further information.
  25. While the BLAKE2b and BLAKE2s algorithms supports a variable length digest,
  26. this implementation outputs a digest of a fixed length (the maximum length
  27. supported), which is 512-bits for BLAKE2b and 256-bits for BLAKE2s.
  28. =head1 RETURN VALUES
  29. These functions return a B<EVP_MD> structure that contains the
  30. implementation of the message digest. See L<EVP_MD_meth_new(3)> for
  31. details of the B<EVP_MD> structure.
  32. =head1 CONFORMING TO
  33. RFC 7693.
  34. =head1 SEE ALSO
  35. L<evp(7)>,
  36. L<EVP_DigestInit(3)>
  37. =head1 COPYRIGHT
  38. Copyright 2017-2023 The OpenSSL Project Authors. All Rights Reserved.
  39. Licensed under the Apache License 2.0 (the "License"). You may not use
  40. this file except in compliance with the License. You can obtain a copy
  41. in the file LICENSE in the source distribution or at
  42. L<https://www.openssl.org/source/license.html>.
  43. =cut