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

Detailed Description

SHA384 cryptographic hash.

Data Structures

struct  SharkSslSha384Ctx
 In PSA consumer builds, hash contexts own provider operations. More...
 

Typedefs

typedef struct SharkSslSha384Ctx SharkSslSha384Ctx
 In PSA consumer builds, hash contexts own provider operations. More...
 

Functions

SHARKSSL_API int SharkSslSha384Ctx_constructor (SharkSslSha384Ctx *ctx)
 Initialize. More...
 
SHARKSSL_API int SharkSslSha384Ctx_append (SharkSslSha384Ctx *, const U8 *data, U32 len)
 append More...
 
SHARKSSL_API int SharkSslSha384Ctx_finish (SharkSslSha384Ctx *, U8 digest[SHARKSSL_SHA384_HASH_LEN])
 finish More...
 
SHARKSSL_API int sharkssl_sha384 (const U8 *, U32, U8 *)
 sha384 More...
 

Typedef Documentation

◆ SharkSslSha384Ctx

In PSA consumer builds, hash contexts own provider operations.

Do not copy an active context with memcpy; use the corresponding clone function with an uninitialized target. Consumer methods return zero on success and -1 on error. Abort an unfinished context before reuse. SHA384

Function Documentation

◆ sharkssl_sha384()

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

sha384

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 48 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.

◆ SharkSslSha384Ctx_append()

int SharkSslSha384Ctx_append ( SharkSslSha384Ctx *  ctx,
const U8 *  data,
U32  len 
)

append

Parameters
ctxSharkSslSha384Ctx *; 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.

◆ SharkSslSha384Ctx_constructor()

int SharkSslSha384Ctx_constructor ( SharkSslSha384Ctx *  ctx)

Initialize.

Use caller-owned, correctly aligned context storage.

Parameters
ctxUninitialized data of size sizeof(SharkSslSha384Ctx).

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.

◆ SharkSslSha384Ctx_finish()

int SharkSslSha384Ctx_finish ( SharkSslSha384Ctx *  ctx,
U8  digest[SHARKSSL_SHA384_HASH_LEN] 
)

finish

Parameters
ctxSharkSslSha384Ctx *; required initialized context; finalized by this call. Reinitialize before hashing another message.
digestU8 *; required caller-owned output buffer of at least 48 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.