kdf.h

Go to the documentation of this file.

 
#pragma once
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define KDF_SALT_LEN 8
#define KDF_INITIAL_HASH_MAX 64

typedef enum {
    KDF_ALGO_NONE   = 0x00,
    KDF_ALGO_PBKDF2 = 0x03,  
} kdf_algo_t;

typedef enum {
    KDF_HASH_NONE   = 0x00,
    KDF_HASH_SHA256 = 0x08,
    KDF_HASH_SHA512 = 0x0A,
} kdf_hash_t;

typedef struct {
    kdf_algo_t algo;
    kdf_hash_t hash;
    uint32_t   iter_count;
 
    bool    has_pw1_salt;
    uint8_t pw1_salt[KDF_SALT_LEN];
    bool    has_rc_salt;
    uint8_t rc_salt[KDF_SALT_LEN];
    bool    has_pw3_salt;
    uint8_t pw3_salt[KDF_SALT_LEN];
 
    bool     has_pw1_initial;
    uint8_t  pw1_initial[KDF_INITIAL_HASH_MAX];
    uint8_t  pw1_initial_len;
    bool     has_pw3_initial;
    uint8_t  pw3_initial[KDF_INITIAL_HASH_MAX];
    uint8_t  pw3_initial_len;
} kdf_do_t;

typedef enum {
    KDF_OK = 0,
    KDF_ERR_NULL,
    KDF_ERR_BUF_TOO_SMALL,
    KDF_ERR_BAD_LENGTH,
    KDF_ERR_BAD_TAG,
    KDF_ERR_BAD_ALGO,
    KDF_ERR_BAD_HASH,
    KDF_ERR_BAD_HASH_LEN,
} kdf_status_t;

void kdf_do_clear(kdf_do_t *out);

kdf_status_t kdf_do_parse(const uint8_t *bytes, size_t len, kdf_do_t *out);

kdf_status_t kdf_do_build(const kdf_do_t *kdf, uint8_t *out, size_t out_cap,
                          size_t *out_len);

kdf_status_t kdf_do_build_disabled(uint8_t *out, size_t out_cap, size_t *out_len);
 
#ifdef __cplusplus
}
#endif