Files
Project_CTR/deps/libtoolchain/include/tc/crypto/HmacMd5Generator.h
T
2022-04-16 18:27:14 +08:00

46 lines
1.3 KiB
C++

/**
* @file HmacMd5Generator.h
* @brief Declarations for API resources for HMAC-MD5 calculations.
* @author Jack (jakcron)
* @version 0.1
* @date 2020/06/06
**/
#pragma once
#include <tc/types.h>
#include <tc/crypto/Md5Generator.h>
#include <tc/crypto/HmacGenerator.h>
namespace tc { namespace crypto {
/**
* @typedef HmacMd5Generator
* @brief Class for calculating HMAC-MD5.
*
* @details This class calcualtes MAC using MD5.
* For more information refer to @ref HmacGenerator.
*/
using HmacMd5Generator = HmacGenerator<Md5Generator>;
/**
* @brief Utility function for calculating HMAC-MD5.
*
* @param[out] mac Pointer to the buffer storing the MAC.
* @param[in] data Pointer to input data.
* @param[in] data_size Size in bytes of input data.
* @param[in] key Pointer to key data.
* @param[in] key_size Size in bytes of key data.
*
* @pre
* - Size of the MAC buffer must >= <tt>HmacMd5Generator::kMacSize</tt>.
*
* @post
* - The MAC is written to <tt><var>mac</var></tt>.
*
* @details
* This function calculates a MAC for the passed in data array.
* To calculate a MAC for data split into multiple arrays, use the @ref HmacMd5Generator class.
*/
void GenerateHmacMd5Mac(byte_t* mac, const byte_t* data, size_t data_size, const byte_t* key, size_t key_size);
}} // namespace tc::crypto