lc_aead.h

Go to the documentation of this file.

/*
 * Copyright (C) 2022 - 2025, Stephan Mueller <smueller@chronox.de>
 *
 * License: see LICENSE file in root directory
 *
 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
 * WHICH ARE HEREBY DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
 * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
 * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
 * USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
 * DAMAGE.
 */
 
#ifndef LC_AEAD_H
#define LC_AEAD_H
 
#include "lc_aes.h"
#include "lc_memory_support.h"
 
#ifdef __cplusplus
extern "C" {
#endif

struct lc_aead {
        int (*setkey)(void *state, const uint8_t *key, const size_t keylen,
                      const uint8_t *iv, size_t ivlen);
        void (*encrypt)(void *state, const uint8_t *plaintext,
                        uint8_t *ciphertext, size_t datalen, const uint8_t *aad,
                        size_t aadlen, uint8_t *tag, size_t taglen);
        void (*enc_init)(void *state, const uint8_t *aad, size_t aadlen);
        void (*enc_update)(void *state, const uint8_t *plaintext,
                           uint8_t *ciphertext, size_t datalen);
        void (*enc_final)(void *state, uint8_t *tag, size_t taglen);
        int (*decrypt)(void *state, const uint8_t *ciphertext,
                       uint8_t *plaintext, size_t datalen, const uint8_t *aad,
                       size_t aadlen, const uint8_t *tag, size_t taglen);
        void (*dec_init)(void *state, const uint8_t *aad, size_t aadlen);
        void (*dec_update)(void *state, const uint8_t *ciphertext,
                           uint8_t *plaintext, size_t datalen);
        int (*dec_final)(void *state, const uint8_t *tag, size_t taglen);
        void (*zero)(void *state);
        uint64_t algorithm_type;
};
 
struct lc_aead_ctx {
        const struct lc_aead *aead;
        void *aead_state;
};
 
#define LC_AEAD_CTX(name, cb)                                                  \
        name->aead = cb;                                                       \
        name->aead_state = (uint8_t *)(name) + sizeof(struct lc_aead_ctx)
 
#define LC_AEAD_HASH_ALIGN_CTX(name, cb)                                       \
        name->aead = cb;                                                       \
        name->aead_state = LC_ALIGN_HASH_MASK((uint8_t *)(name) +              \
                                              sizeof(struct lc_aead_ctx))


void lc_aead_zero(struct lc_aead_ctx *ctx);

void lc_aead_zero_free(struct lc_aead_ctx *ctx);

int lc_aead_setkey(struct lc_aead_ctx *ctx, const uint8_t *key,
                   const size_t keylen, const uint8_t *iv, size_t ivlen);

int lc_aead_encrypt(struct lc_aead_ctx *ctx, const uint8_t *plaintext,
                    uint8_t *ciphertext, size_t datalen, const uint8_t *aad,
                    size_t aadlen, uint8_t *tag, size_t taglen);

int lc_aead_enc_init(struct lc_aead_ctx *ctx, const uint8_t *aad,
                     size_t aadlen);

int lc_aead_enc_update(struct lc_aead_ctx *ctx, const uint8_t *plaintext,
                       uint8_t *ciphertext, size_t datalen);

int lc_aead_enc_final(struct lc_aead_ctx *ctx, uint8_t *tag, size_t taglen);

int lc_aead_decrypt(struct lc_aead_ctx *ctx, const uint8_t *ciphertext,
                    uint8_t *plaintext, size_t datalen, const uint8_t *aad,
                    size_t aadlen, const uint8_t *tag, size_t taglen);

int lc_aead_dec_init(struct lc_aead_ctx *ctx, const uint8_t *aad,
                     size_t aadlen);

int lc_aead_dec_update(struct lc_aead_ctx *ctx, const uint8_t *ciphertext,
                       uint8_t *plaintext, size_t datalen);

int lc_aead_dec_final(struct lc_aead_ctx *ctx, const uint8_t *tag,
                      size_t taglen);

uint64_t lc_aead_algorithm_type(const struct lc_aead *aead);

uint64_t lc_aead_ctx_algorithm_type(const struct lc_aead_ctx *ctx);
 
#ifdef __cplusplus
}
#endif
 
#endif /* LC_AEAD_H */