SharkSSL C/C++ Reference
TLS, cryptography, certificates, and PSA integration

Detailed Description

SHA256 cryptographic hash.

Data Structures

struct  SharkSslSha256Ctx
 SHA256. More...
 

Typedefs

typedef struct SharkSslSha256Ctx SharkSslSha256Ctx
 SHA256. More...
 

Functions

SHARKSSL_API int SharkSslSha256Ctx_constructor (SharkSslSha256Ctx *ctx)
 Initialize. More...
 
SHARKSSL_API int SharkSslSha256Ctx_append (SharkSslSha256Ctx *, const U8 *data, U32 len)
 append More...
 
SHARKSSL_API int SharkSslSha256Ctx_finish (SharkSslSha256Ctx *, U8 digest[SHARKSSL_SHA256_HASH_LEN])
 finish More...
 
SHARKSSL_API int sharkssl_sha256 (const U8 *, U32, U8 *)
 sha256 More...
 

Typedef Documentation

◆ SharkSslSha256Ctx

SHA256.

Function Documentation

◆ sharkssl_sha256()

int sharkssl_sha256 ( const U8 *  data,
U32  len,
U8 *  digest 
)

sha256

Parameters
dataconst U8 *; bytes to hash, borrowed for this call. May be NULL when len is zero.
lenU32; input length in bytes.
digestU8 *; required caller-owned output buffer of at least 32 bytes.
Returns
int: 0 on success; -1 on temporary allocation failure in a heap-based native build, or on argument/provider failure in the PSA consumer. Discard the digest on failure.

◆ SharkSslSha256Ctx_append()

int SharkSslSha256Ctx_append ( SharkSslSha256Ctx *  ctx,
const U8 *  data,
U32  len 
)

append

Parameters
ctxSharkSslSha256Ctx *; required initialized, unfinished context; updated in place.
dataconst U8 *; input bytes, borrowed for this call. Supply a valid buffer when len is nonzero.
lenU32; input length in bytes, including zero.
Returns
int: 0 on success. The native implementation returns 0 for valid inputs; the PSA consumer returns -1 for invalid state/arguments or a provider failure.

◆ SharkSslSha256Ctx_constructor()

int SharkSslSha256Ctx_constructor ( SharkSslSha256Ctx *  ctx)

Initialize.

Use caller-owned, correctly aligned context storage.

Parameters
ctxUninitialized data of size sizeof(SharkSslSha256Ctx).

Finish or abort an active PSA hash before reinitializing that storage.

Returns
int: 0 on success. The native implementation returns 0 for valid inputs; the PSA consumer returns -1 for invalid state/arguments or a provider failure.

◆ SharkSslSha256Ctx_finish()

int SharkSslSha256Ctx_finish ( SharkSslSha256Ctx *  ctx,
U8  digest[SHARKSSL_SHA256_HASH_LEN] 
)

finish

Parameters
ctxSharkSslSha256Ctx *; required initialized context; finalized by this call. Reinitialize before hashing another message.
digestU8 *; required caller-owned output buffer of at least 32 bytes.
Returns
int: 0 on success. The native implementation returns 0 for valid inputs; the PSA consumer returns -1 for invalid state/arguments or a provider failure.