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_context.h"

#include <stddef.h>
#include <stdint.h>

#include "iqr_api.h"
#include "iqr_hash.h"
#include "iqr_retval.h"

// ---------------------------------------------------------------------------------------------------------------------------------
// 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 *msg, size_t msg_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 *data, size_t data_size);

IQR_API
iqr_retval iqr_MACEnd(iqr_MAC *mac, uint8_t *tag, size_t tag_size);

IQR_API
iqr_retval iqr_MACGetTagSize(const iqr_MAC *mac, size_t *tag_size);

#ifdef __cplusplus
}
#endif

#endif /* IQR_MAC_H */