diff options
Diffstat (limited to 'src/include/openssl/sha.h')
-rw-r--r-- | src/include/openssl/sha.h | 142 |
1 files changed, 71 insertions, 71 deletions
diff --git a/src/include/openssl/sha.h b/src/include/openssl/sha.h index 7c310979..fc4644bf 100644 --- a/src/include/openssl/sha.h +++ b/src/include/openssl/sha.h @@ -64,42 +64,42 @@ extern "C" { #endif -/* The SHA family of hash functions (SHA-1 and SHA-2). */ +// The SHA family of hash functions (SHA-1 and SHA-2). -/* SHA_CBLOCK is the block size of SHA-1. */ +// SHA_CBLOCK is the block size of SHA-1. #define SHA_CBLOCK 64 -/* SHA_DIGEST_LENGTH is the length of a SHA-1 digest. */ +// SHA_DIGEST_LENGTH is the length of a SHA-1 digest. #define SHA_DIGEST_LENGTH 20 -/* SHA1_Init initialises |sha| and returns one. */ +// SHA1_Init initialises |sha| and returns one. OPENSSL_EXPORT int SHA1_Init(SHA_CTX *sha); -/* SHA1_Update adds |len| bytes from |data| to |sha| and returns one. */ +// SHA1_Update adds |len| bytes from |data| to |sha| and returns one. OPENSSL_EXPORT int SHA1_Update(SHA_CTX *sha, const void *data, size_t len); -/* SHA1_Final adds the final padding to |sha| and writes the resulting digest - * to |md|, which must have at least |SHA_DIGEST_LENGTH| bytes of space. It - * returns one. */ +// SHA1_Final adds the final padding to |sha| and writes the resulting digest +// to |md|, which must have at least |SHA_DIGEST_LENGTH| bytes of space. It +// returns one. OPENSSL_EXPORT int SHA1_Final(uint8_t *md, SHA_CTX *sha); -/* SHA1 writes the digest of |len| bytes from |data| to |out| and returns - * |out|. There must be at least |SHA_DIGEST_LENGTH| bytes of space in - * |out|. */ +// SHA1 writes the digest of |len| bytes from |data| to |out| and returns +// |out|. There must be at least |SHA_DIGEST_LENGTH| bytes of space in +// |out|. OPENSSL_EXPORT uint8_t *SHA1(const uint8_t *data, size_t len, uint8_t *out); -/* SHA1_Transform is a low-level function that performs a single, SHA-1 block - * transformation using the state from |sha| and |SHA_CBLOCK| bytes from - * |block|. */ +// SHA1_Transform is a low-level function that performs a single, SHA-1 block +// transformation using the state from |sha| and |SHA_CBLOCK| bytes from +// |block|. OPENSSL_EXPORT void SHA1_Transform(SHA_CTX *sha, const uint8_t *block); struct sha_state_st { #if defined(OPENSSL_WINDOWS) uint32_t h[5]; #else - /* wpa_supplicant accesses |h0|..|h4| so we must support those names - * for compatibility with it until it can be updated. */ + // wpa_supplicant accesses |h0|..|h4| so we must support those names + // for compatibility with it until it can be updated. union { uint32_t h[5]; struct { @@ -117,58 +117,58 @@ struct sha_state_st { }; -/* SHA-224. */ +// SHA-224. -/* SHA224_CBLOCK is the block size of 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. */ +// SHA224_DIGEST_LENGTH is the length of a SHA-224 digest. #define SHA224_DIGEST_LENGTH 28 -/* SHA224_Init initialises |sha| and returns 1. */ +// 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. */ +// 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 |md|, which must have at least |SHA224_DIGEST_LENGTH| bytes of space. It - * returns one on success and zero on programmer error. */ +// SHA224_Final adds the final padding to |sha| and writes the resulting digest +// to |md|, which must have at least |SHA224_DIGEST_LENGTH| bytes of space. It +// returns one on success and zero on programmer error. OPENSSL_EXPORT int SHA224_Final(uint8_t *md, 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|. */ +// 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); -/* SHA-256. */ +// SHA-256. -/* SHA256_CBLOCK is the block size of 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. */ +// SHA256_DIGEST_LENGTH is the length of a SHA-256 digest. #define SHA256_DIGEST_LENGTH 32 -/* SHA256_Init initialises |sha| and returns 1. */ +// 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. */ +// 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 |md|, which must have at least |SHA256_DIGEST_LENGTH| bytes of space. It - * returns one on success and zero on programmer error. */ +// SHA256_Final adds the final padding to |sha| and writes the resulting digest +// to |md|, 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 *md, 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|. */ +// 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_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|. */ +// 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); struct sha256_state_st { @@ -179,63 +179,63 @@ struct sha256_state_st { }; -/* SHA-384. */ +// SHA-384. -/* SHA384_CBLOCK is the block size of 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. */ +// SHA384_DIGEST_LENGTH is the length of a SHA-384 digest. #define SHA384_DIGEST_LENGTH 48 -/* SHA384_Init initialises |sha| and returns 1. */ +// 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. */ +// 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 |md|, which must have at least |SHA384_DIGEST_LENGTH| bytes of space. It - * returns one on success and zero on programmer error. */ +// SHA384_Final adds the final padding to |sha| and writes the resulting digest +// to |md|, 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 *md, 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|. */ +// 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_Transform is a low-level function that performs a single, SHA-384 - * block transformation using the state from |sha| and |SHA384_CBLOCK| bytes - * from |block|. */ +// SHA384_Transform is a low-level function that performs a single, SHA-384 +// block transformation using the state from |sha| and |SHA384_CBLOCK| bytes +// from |block|. OPENSSL_EXPORT void SHA384_Transform(SHA512_CTX *sha, const uint8_t *block); -/* SHA-512. */ +// SHA-512. -/* SHA512_CBLOCK is the block size of 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. */ +// SHA512_DIGEST_LENGTH is the length of a SHA-512 digest. #define SHA512_DIGEST_LENGTH 64 -/* SHA512_Init initialises |sha| and returns 1. */ +// 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. */ +// 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 |md|, which must have at least |SHA512_DIGEST_LENGTH| bytes of space. It - * returns one on success and zero on programmer error. */ +// SHA512_Final adds the final padding to |sha| and writes the resulting digest +// to |md|, 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 *md, 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|. */ +// 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_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|. */ +// 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); struct sha512_state_st { @@ -250,7 +250,7 @@ struct sha512_state_st { #if defined(__cplusplus) -} /* extern C */ +} // extern C #endif -#endif /* OPENSSL_HEADER_SHA_H */ +#endif // OPENSSL_HEADER_SHA_H |