wolfCryptの初期化とクリーンアップ

Functions

	Name
int	wc_HashGetOID(enum wc_HashType hash_type) この関数は、提供されたwc_HashTypeのOIDを返します。
int	wc_HashGetDigestSize(enum wc_HashType hash_type) この関数は、hash_typeのダイジェスト(出力)のサイズを返します。返されるサイズは、wc_Hashに提供される出力バッファが十分な大きさであることを確認するために使用されます。
int	wc_Hash(enum wc_HashType hash_type, const byte * data, word32 data_len, byte * hash, word32 hash_len) この関数は、提供されたデータバッファに対してハッシュを実行し、提供されたハッシュバッファに結果を返します。
int	wolfCrypt_Init(void ) wolfCryptで使用されるリソースを初期化するために使用されます。
int	wolfCrypt_Cleanup(void ) wolfCryptで使用されるリソースをクリーンアップするために使用されます。

Functions Documentation

function wc_HashGetOID

int wc_HashGetOID(
    enum wc_HashType hash_type
)

この関数は、提供されたwc_HashTypeのOIDを返します。

Parameters:

hash_type "WC_HASH_TYPE_SHA256"などの"enum wc_HashType"からのハッシュタイプ。

See:

Return:

OID 0より大きい値を返します
HASH_TYPE_E ハッシュタイプがサポートされていません。
BAD_FUNC_ARG 提供された引数の1つが正しくありません。

Example

enum wc_HashType hash_type = WC_HASH_TYPE_SHA256;
int oid = wc_HashGetOID(hash_type);
if (oid > 0) {
    // 成功
}

function wc_HashGetDigestSize

int wc_HashGetDigestSize(
    enum wc_HashType hash_type
)

この関数は、hash_typeのダイジェスト(出力)のサイズを返します。返されるサイズは、wc_Hashに提供される出力バッファが十分な大きさであることを確認するために使用されます。

Parameters:

hash_type "WC_HASH_TYPE_SHA256"などの"enum wc_HashType"からのハッシュタイプ。

See: wc_Hash

Return:

Success 正の戻り値は、ハッシュのダイジェストサイズを示します。
Error hash_typeがサポートされていない場合、HASH_TYPE_Eを返します。
Failure 無効なhash_typeが使用された場合、BAD_FUNC_ARGを返します。

Example

int hash_len = wc_HashGetDigestSize(hash_type);
if (hash_len <= 0) {
WOLFSSL_MSG("Invalid hash type/len");
return BAD_FUNC_ARG;
}

function wc_Hash

int wc_Hash(
    enum wc_HashType hash_type,
    const byte * data,
    word32 data_len,
    byte * hash,
    word32 hash_len
)

この関数は、提供されたデータバッファに対してハッシュを実行し、提供されたハッシュバッファに結果を返します。

Parameters:

hash_type "WC_HASH_TYPE_SHA256"などの"enum wc_HashType"からのハッシュタイプ。
data ハッシュ化するデータを含むバッファへのポインタ。
data_len データバッファの長さ。
hash 最終ハッシュを出力するために使用されるバッファへのポインタ。
hash_len ハッシュバッファの長さ。

See: wc_HashGetDigestSize

Return: 0 成功、それ以外はエラー(BAD_FUNC_ARGやBUFFER_Eなど)。

Example

enum wc_HashType hash_type = WC_HASH_TYPE_SHA256;
int hash_len = wc_HashGetDigestSize(hash_type);
if (hash_len > 0) {
    int ret = wc_Hash(hash_type, data, data_len, hash_data, hash_len);
    if(ret == 0) {
        // 成功
    }
}

function wolfCrypt_Init

int wolfCrypt_Init(
    void 
)

wolfCryptで使用されるリソースを初期化するために使用されます。

Parameters:

none パラメータなし。

See: wolfCrypt_Cleanup

Return:

0 成功時。
<0 リソースの初期化に失敗した場合。

Example

...
if (wolfCrypt_Init() != 0) {
    WOLFSSL_MSG("Error with wolfCrypt_Init call");
}

function wolfCrypt_Cleanup

int wolfCrypt_Cleanup(
    void 
)

wolfCryptで使用されるリソースをクリーンアップするために使用されます。

Parameters:

none パラメータなし。

See: wolfCrypt_Init

Return:

0 成功時。
<0 リソースのクリーンアップに失敗した場合。

Example

...
if (wolfCrypt_Cleanup() != 0) {
    WOLFSSL_MSG("Error with wolfCrypt_Cleanup call");
}

Updated on 2025-12-12 at 03:08:16 +0000