sha2.h

All headers

The SHA-2 family of hash functions.

  1. SHA-224
  2. SHA224_CBLOCK
  3. SHA224_DIGEST_LENGTH
  4. SHA224_Init
  5. SHA224_Update
  6. SHA224_Final
  7. SHA224
  8. SHA-256
  9. SHA256_CBLOCK
  10. SHA256_DIGEST_LENGTH
  11. SHA256_Init
  12. SHA256_Update
  13. SHA256_Final
  14. SHA256
  15. SHA256_Transform
  16. SHA256_TransformBlocks
  17. sha256_state_st
  18. SHA-384
  19. SHA384_CBLOCK
  20. SHA384_DIGEST_LENGTH
  21. SHA384_Init
  22. SHA384_Update
  23. SHA384_Final
  24. SHA384
  25. SHA-512
  26. SHA512_CBLOCK
  27. SHA512_DIGEST_LENGTH
  28. SHA512_Init
  29. SHA512_Update
  30. SHA512_Final
  31. SHA512
  32. SHA512_Transform
  33. sha512_state_st
  34. SHA-512-256
  35. SHA512_256_DIGEST_LENGTH
  36. SHA512_256_Init
  37. SHA512_256_Update
  38. SHA512_256_Final
  39. SHA512_256

SHA-224.

SHA224_CBLOCK is the block size of SHA-224.

#define SHA224_CBLOCK 64

SHA224_DIGEST_LENGTH is the length of a SHA-224 digest.

#define SHA224_DIGEST_LENGTH 28

SHA224_Init initialises sha and returns 1.

OPENSSL_EXPORT int SHA224_Init(SHA256_CTX *sha);

SHA224_Update adds len bytes from data to sha and returns 1.

OPENSSL_EXPORT int SHA224_Update(SHA256_CTX *sha, const void *data, size_t len);

SHA224_Final adds the final padding to sha and writes the resulting digest to out, which must have at least SHA224_DIGEST_LENGTH bytes of space. It returns 1.

OPENSSL_EXPORT int SHA224_Final(uint8_t out[SHA224_DIGEST_LENGTH],
                                SHA256_CTX *sha);

SHA224 writes the digest of len bytes from data to out and returns out. There must be at least SHA224_DIGEST_LENGTH bytes of space in out.

OPENSSL_EXPORT uint8_t *SHA224(const uint8_t *data, size_t len,
                               uint8_t out[SHA224_DIGEST_LENGTH]);

SHA-256.

SHA256_CBLOCK is the block size of SHA-256.

#define SHA256_CBLOCK 64

SHA256_DIGEST_LENGTH is the length of a SHA-256 digest.

#define SHA256_DIGEST_LENGTH 32

SHA256_Init initialises sha and returns 1.

OPENSSL_EXPORT int SHA256_Init(SHA256_CTX *sha);

SHA256_Update adds len bytes from data to sha and returns 1.

OPENSSL_EXPORT int SHA256_Update(SHA256_CTX *sha, const void *data, size_t len);

SHA256_Final adds the final padding to sha and writes the resulting digest to out, which must have at least SHA256_DIGEST_LENGTH bytes of space. It returns one on success and zero on programmer error.

OPENSSL_EXPORT int SHA256_Final(uint8_t out[SHA256_DIGEST_LENGTH],
                                SHA256_CTX *sha);

SHA256 writes the digest of len bytes from data to out and returns out. There must be at least SHA256_DIGEST_LENGTH bytes of space in out.

OPENSSL_EXPORT uint8_t *SHA256(const uint8_t *data, size_t len,
                               uint8_t out[SHA256_DIGEST_LENGTH]);

SHA256_Transform is a low-level function that performs a single, SHA-256 block transformation using the state from sha and SHA256_CBLOCK bytes from block.

OPENSSL_EXPORT void SHA256_Transform(SHA256_CTX *sha,
                                     const uint8_t block[SHA256_CBLOCK]);

SHA256_TransformBlocks is a low-level function that takes num_blocks * SHA256_CBLOCK bytes of data and performs SHA-256 transforms on it to update state. You should not use this function unless you are implementing a derivative of SHA-256.

OPENSSL_EXPORT void SHA256_TransformBlocks(uint32_t state[8],
                                           const uint8_t *data,
                                           size_t num_blocks);
struct sha256_state_st {
  uint32_t h[8];
  uint32_t Nl, Nh;
  uint8_t data[SHA256_CBLOCK];
  unsigned num, md_len;
} /* SHA256_CTX */;

SHA-384.

SHA384_CBLOCK is the block size of SHA-384.

#define SHA384_CBLOCK 128

SHA384_DIGEST_LENGTH is the length of a SHA-384 digest.

#define SHA384_DIGEST_LENGTH 48

SHA384_Init initialises sha and returns 1.

OPENSSL_EXPORT int SHA384_Init(SHA512_CTX *sha);

SHA384_Update adds len bytes from data to sha and returns 1.

OPENSSL_EXPORT int SHA384_Update(SHA512_CTX *sha, const void *data, size_t len);

SHA384_Final adds the final padding to sha and writes the resulting digest to out, which must have at least SHA384_DIGEST_LENGTH bytes of space. It returns one on success and zero on programmer error.

OPENSSL_EXPORT int SHA384_Final(uint8_t out[SHA384_DIGEST_LENGTH],
                                SHA512_CTX *sha);

SHA384 writes the digest of len bytes from data to out and returns out. There must be at least SHA384_DIGEST_LENGTH bytes of space in out.

OPENSSL_EXPORT uint8_t *SHA384(const uint8_t *data, size_t len,
                               uint8_t out[SHA384_DIGEST_LENGTH]);

SHA-512.

SHA512_CBLOCK is the block size of SHA-512.

#define SHA512_CBLOCK 128

SHA512_DIGEST_LENGTH is the length of a SHA-512 digest.

#define SHA512_DIGEST_LENGTH 64

SHA512_Init initialises sha and returns 1.

OPENSSL_EXPORT int SHA512_Init(SHA512_CTX *sha);

SHA512_Update adds len bytes from data to sha and returns 1.

OPENSSL_EXPORT int SHA512_Update(SHA512_CTX *sha, const void *data, size_t len);

SHA512_Final adds the final padding to sha and writes the resulting digest to out, which must have at least SHA512_DIGEST_LENGTH bytes of space. It returns one on success and zero on programmer error.

OPENSSL_EXPORT int SHA512_Final(uint8_t out[SHA512_DIGEST_LENGTH],
                                SHA512_CTX *sha);

SHA512 writes the digest of len bytes from data to out and returns out. There must be at least SHA512_DIGEST_LENGTH bytes of space in out.

OPENSSL_EXPORT uint8_t *SHA512(const uint8_t *data, size_t len,
                               uint8_t out[SHA512_DIGEST_LENGTH]);

SHA512_Transform is a low-level function that performs a single, SHA-512 block transformation using the state from sha and SHA512_CBLOCK bytes from block.

OPENSSL_EXPORT void SHA512_Transform(SHA512_CTX *sha,
                                     const uint8_t block[SHA512_CBLOCK]);
struct sha512_state_st {
  uint64_t h[8];
  uint16_t num, md_len;
  uint32_t bytes_so_far_high;
  uint64_t bytes_so_far_low;
  uint8_t p[SHA512_CBLOCK];
} /* SHA512_CTX */;

SHA-512-256

See https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.180-4.pdf section 5.3.6

#define SHA512_256_DIGEST_LENGTH 32

SHA512_256_Init initialises sha and returns 1.

OPENSSL_EXPORT int SHA512_256_Init(SHA512_CTX *sha);

SHA512_256_Update adds len bytes from data to sha and returns 1.

OPENSSL_EXPORT int SHA512_256_Update(SHA512_CTX *sha, const void *data,
                                     size_t len);

SHA512_256_Final adds the final padding to sha and writes the resulting digest to out, which must have at least SHA512_256_DIGEST_LENGTH bytes of space. It returns one on success and zero on programmer error.

OPENSSL_EXPORT int SHA512_256_Final(uint8_t out[SHA512_256_DIGEST_LENGTH],
                                    SHA512_CTX *sha);

SHA512_256 writes the digest of len bytes from data to out and returns out. There must be at least SHA512_256_DIGEST_LENGTH bytes of space in out.

OPENSSL_EXPORT uint8_t *SHA512_256(const uint8_t *data, size_t len,
                                   uint8_t out[SHA512_256_DIGEST_LENGTH]);