wolfssl/doc/dox_comments/header_files/blake2.h

/*!
    \ingroup BLAKE2

    \brief This function initializes a Blake2b structure for use with the
    Blake2 hash function.

    \return 0 Returned upon successfully initializing the Blake2b structure and
    setting the digest size.

    \param b2b pointer to the Blake2b structure to initialize
    \param digestSz length of the blake 2 digest to implement

    _Example_
    \code
    Blake2b b2b;
    // initialize Blake2b structure with 64 byte digest
    wc_InitBlake2b(&b2b, 64);
    \endcode

    \sa wc_Blake2bUpdate
*/
WOLFSSL_API int wc_InitBlake2b(Blake2b*, word32);

/*!
    \ingroup BLAKE2

    \brief This function updates the Blake2b hash with the given input data.
    This function should be called after wc_InitBlake2b, and repeated until
    one is ready for the final hash: wc_Blake2bFinal.

    \return 0 Returned upon successfully update the Blake2b structure with
    the given data
    \return -1 Returned if there is a failure while compressing the input data

    \param b2b pointer to the Blake2b structure to update
    \param data pointer to a buffer containing the data to append
    \param sz length of the input data to append

    _Example_
    \code
    int ret;
    Blake2b b2b;
    // initialize Blake2b structure with 64 byte digest
    wc_InitBlake2b(&b2b, 64);

    byte plain[] = { // initialize input };

    ret = wc_Blake2bUpdate(&b2b, plain, sizeof(plain));
    if( ret != 0) {
    	// error updating blake2b
    }
    \endcode

    \sa wc_InitBlake2b
    \sa wc_Blake2bFinal
*/
WOLFSSL_API int wc_Blake2bUpdate(Blake2b*, const byte*, word32);

/*!
    \ingroup BLAKE2

    \brief This function computes the Blake2b hash of the previously supplied
    input data. The output hash will be of length requestSz, or, if
    requestSz==0, the digestSz of the b2b structure. This function should be
    called after wc_InitBlake2b and wc_Blake2bUpdate has been processed for
    each piece of input data desired.

    \return 0 Returned upon successfully computing the Blake2b hash
    \return -1 Returned if there is a failure while parsing the Blake2b hash

    \param b2b pointer to the Blake2b structure to update
    \param final pointer to a buffer in which to store the blake2b hash.
    Should be of length requestSz
    \param requestSz length of the digest to compute. When this is zero,
    b2b->digestSz will be used instead

    _Example_
    \code
    int ret;
    Blake2b b2b;
    byte hash[64];
    // initialize Blake2b structure with 64 byte digest
    wc_InitBlake2b(&b2b, 64);
    ... // call wc_Blake2bUpdate to add data to hash

    ret = wc_Blake2bFinal(&b2b, hash, 64);
    if( ret != 0) {
    	// error generating blake2b hash
    }
    \endcode

    \sa wc_InitBlake2b
    \sa wc_Blake2bUpdate
*/
WOLFSSL_API int wc_Blake2bFinal(Blake2b*, byte*, word32);