EVP_blake2b512.pod 1.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869
  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. Both algorithms support a variable-length digest,
  26. but this is only available through L<EVP_MD-BLAKE2(7)>.
  27. =head1 RETURN VALUES
  28. These functions return a B<EVP_MD> structure that contains the
  29. implementation of the message digest. See L<EVP_MD_meth_new(3)> for
  30. details of the B<EVP_MD> structure.
  31. =head1 CONFORMING TO
  32. RFC 7693.
  33. =head1 SEE ALSO
  34. L<evp(7)>,
  35. L<EVP_DigestInit(3)>
  36. =head1 COPYRIGHT
  37. Copyright 2017-2023 The OpenSSL Project Authors. All Rights Reserved.
  38. Licensed under the Apache License 2.0 (the "License"). You may not use
  39. this file except in compliance with the License. You can obtain a copy
  40. in the file LICENSE in the source distribution or at
  41. L<https://www.openssl.org/source/license.html>.
  42. =cut