iqr_mac.h

Go to the documentation of this file.

 
#ifndef IQR_MAC_H
#define IQR_MAC_H
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include "iqr_api.h"
#include "iqr_context.h"
#include "iqr_hash.h"
#include "iqr_retval.h"
 
#include <stddef.h>
#include <stdint.h>
 
// ---------------------------------------------------------------------------------------------------------------------------------
// Constants.
// ---------------------------------------------------------------------------------------------------------------------------------
 
#define IQR_POLY1305_KEY_SIZE 32
 
#define IQR_POLY1305_TAG_SIZE 16
 
// ---------------------------------------------------------------------------------------------------------------------------------
// Opaque data type.
// ---------------------------------------------------------------------------------------------------------------------------------
 
typedef struct iqr_MAC_struct iqr_MAC;
 
// ---------------------------------------------------------------------------------------------------------------------------------
// MAC management.
// ---------------------------------------------------------------------------------------------------------------------------------
 
IQR_API
iqr_retval iqr_MACCreateHMAC(const iqr_Context *ctx, iqr_HashAlgorithmType hash_algo, iqr_MAC **mac);
 
IQR_API
iqr_retval iqr_MACCreatePoly1305(const iqr_Context *ctx, iqr_MAC **mac);
 
IQR_API_UNENFORCED_RETURN
iqr_retval iqr_MACDestroy(iqr_MAC **mac);
 
// ---------------------------------------------------------------------------------------------------------------------------------
// MAC usage.
// ---------------------------------------------------------------------------------------------------------------------------------
 
IQR_API
iqr_retval iqr_MACMessage(iqr_MAC *mac, const uint8_t *key, size_t key_size, const uint8_t *buf, size_t buf_size, uint8_t *tag,
    size_t tag_size);
 
IQR_API
iqr_retval iqr_MACBegin(iqr_MAC *mac, const uint8_t *key, size_t key_size);
 
IQR_API
iqr_retval iqr_MACUpdate(iqr_MAC *mac, const uint8_t *buf, size_t buf_size);
 
IQR_API
iqr_retval iqr_MACEnd(iqr_MAC *mac, uint8_t *tag, size_t tag_size);
 
IQR_API
iqr_retval iqr_MACGetKeySize(const iqr_MAC *mac, size_t *key_size);
 
IQR_API
iqr_retval iqr_MACGetTagSize(const iqr_MAC *mac, size_t *tag_size);
 
#ifdef __cplusplus
}
#endif
 
#endif /* IQR_MAC_H */