Main index | Section 3 | Options |
#include <sys/types.h>
#include <sha512.h>
#include <sha384.h>
#include <sha512t.h>
The SHA512_Init(), SHA512_Update(), and SHA512_Final() functions are the core functions. Allocate an SHA512_CTX, initialize it with SHA512_Init(), run over the data with SHA512_Update(), and finally extract the result using SHA512_Final(), which will also erase the SHA512_CTX.
SHA512_End() is a wrapper for SHA512_Final() which converts the return value to a 129-character (including the terminating '\0') ASCII string which represents the 512 bits in hexadecimal.
SHA512_File() calculates the digest of a file, and uses SHA512_End() to return the result. If the file cannot be opened, a null pointer is returned. SHA512_FileChunk() is similar to SHA512_File(), but it only calculates the digest over a byte-range of the file specified, starting at offset and spanning length bytes. If the length parameter is specified as 0, or more than the length of the remaining part of the file, SHA512_FileChunk() calculates the digest from offset to the end of file. SHA512_Data() calculates the digest of a chunk of data in memory, and uses SHA512_End() to return the result.
When using SHA512_End(), SHA512_File(), or SHA512_Data(), the buf argument can be a null pointer, in which case the returned string is allocated with malloc(3) and subsequently must be explicitly deallocated using free(3) after use. If the buf argument is non-null it must point to at least 129 characters of buffer space.
The SHA384_ and SHA512_256_ functions are identical to the SHA512_ functions except they use a different initial hash value and the output is truncated to 384 bits and 256 bits respectively.
SHA384_End() is a wrapper for SHA384_Final() which converts the return value to a 97-character (including the terminating '\0') ASCII string which represents the 384 bits in hexadecimal.
SHA512_256_End() is a wrapper for SHA512_Final() which converts the return value to a 65-character (including the terminating '\0') ASCII string which represents the 256 bits in hexadecimal.
SHA512 (3) | July 20, 2018 |
Main index | Section 3 | Options |
Please direct any comments about this manual page service to Ben Bullock. Privacy policy.
“ | Unix is a junk OS designed by a committee of PhDs. | ” |
— Dave Cutler |