RIPEMD160_Init.pod 1.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071
  1. =pod
  2. =head1 NAME
  3. RIPEMD160, RIPEMD160_Init, RIPEMD160_Update, RIPEMD160_Final -
  4. RIPEMD-160 hash function
  5. =head1 SYNOPSIS
  6. #include <openssl/ripemd.h>
  7. unsigned char *RIPEMD160(const unsigned char *d, unsigned long n,
  8. unsigned char *md);
  9. int RIPEMD160_Init(RIPEMD160_CTX *c);
  10. int RIPEMD160_Update(RIPEMD_CTX *c, const void *data, unsigned long len);
  11. int RIPEMD160_Final(unsigned char *md, RIPEMD160_CTX *c);
  12. =head1 DESCRIPTION
  13. RIPEMD-160 is a cryptographic hash function with a
  14. 160 bit output.
  15. RIPEMD160() computes the RIPEMD-160 message digest of the B<n>
  16. bytes at B<d> and places it in B<md> (which must have space for
  17. RIPEMD160_DIGEST_LENGTH == 20 bytes of output). If B<md> is NULL, the digest
  18. is placed in a static array.
  19. The following functions may be used if the message is not completely
  20. stored in memory:
  21. RIPEMD160_Init() initializes a B<RIPEMD160_CTX> structure.
  22. RIPEMD160_Update() can be called repeatedly with chunks of the message to
  23. be hashed (B<len> bytes at B<data>).
  24. RIPEMD160_Final() places the message digest in B<md>, which must have
  25. space for RIPEMD160_DIGEST_LENGTH == 20 bytes of output, and erases
  26. the B<RIPEMD160_CTX>.
  27. =head1 RETURN VALUES
  28. RIPEMD160() returns a pointer to the hash value.
  29. RIPEMD160_Init(), RIPEMD160_Update() and RIPEMD160_Final() return 1 for
  30. success, 0 otherwise.
  31. =head1 NOTE
  32. Applications should use the higher level functions
  33. L<EVP_DigestInit(3)> etc. instead of calling these
  34. functions directly.
  35. =head1 CONFORMING TO
  36. ISO/IEC 10118-3:2016 Dedicated Hash-Function 1 (RIPEMD-160).
  37. =head1 SEE ALSO
  38. L<EVP_DigestInit(3)>
  39. =head1 COPYRIGHT
  40. Copyright 2000-2017 The OpenSSL Project Authors. All Rights Reserved.
  41. Licensed under the OpenSSL license (the "License"). You may not use
  42. this file except in compliance with the License. You can obtain a copy
  43. in the file LICENSE in the source distribution or at
  44. L<https://www.openssl.org/source/license.html>.
  45. =cut