md4.h

Go to the documentation of this file.

#pragma once
/** Structures and prototypes for our local MD4 implementation
 *
 * @note license is LGPL, but largely derived from a public domain source.
 *
 * @file src/lib/util/md4.h
 * @brief Structures and declarations for md4.
 */
RCSIDH(md4_h, "$Id: 94ed5698a6d67176048b24235829f1bc8f6221ea $")
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <freeradius-devel/build.h>
#include <freeradius-devel/missing.h>
 
#include <inttypes.h>
#include <sys/types.h>
#include <stdint.h>
#include <stdbool.h>
#include <string.h>
 
#ifndef MD4_DIGEST_LENGTH
#  define MD4_DIGEST_LENGTH 16
#endif
 
typedef void fr_md4_ctx_t;
 
/* md4.c */
 
typedef         void (*fr_md4_ctx_reset_t)(fr_md4_ctx_t *ctx);
typedef         void (*fr_md4_ctx_copy_t)(fr_md4_ctx_t *dst, fr_md4_ctx_t const *src);
typedef         fr_md4_ctx_t *(*fr_md4_ctx_alloc_t)(void);
typedef         void (*fr_md4_ctx_free_t)(fr_md4_ctx_t **ctx);
typedef         void (*fr_md4_update_t)(fr_md4_ctx_t *ctx, uint8_t const *in, size_t inlen);
typedef         void (*fr_md4_final_t)(uint8_t out[static MD4_DIGEST_LENGTH], fr_md4_ctx_t *ctx);
 
typedef struct {
        fr_md4_ctx_reset_t      reset;
        fr_md4_ctx_copy_t       copy;
        fr_md4_ctx_alloc_t      alloc;
        fr_md4_ctx_free_t       free;
        fr_md4_update_t         update;
        fr_md4_final_t          final;
} fr_md4_funcs_t;
 
/** Swap a single pointer, so all functions get swapped as an atomic operation
 */
extern fr_md4_funcs_t const *fr_md4_funcs;
 
/** Reset the ctx to allow reuse
 *
 * @param[in] ctx       To reuse.
 */
#define fr_md4_ctx_reset(_ctx)                  fr_md4_funcs->reset(_ctx)
 
/** Copy the contents of a ctx
 *
 * @param[in] dst       Where to copy the context to.
 * @param[in] src       Where to copy the context from.
 */
#define fr_md4_ctx_copy(_dst, _src)             fr_md4_funcs->copy(_dst, _src)
 
/** Allocation function for MD4 digest context
 *
 * @return
 *      - An MD4 ctx.
 *      - NULL if out of memory.
 */
#define fr_md4_ctx_alloc()                      fr_md4_funcs->alloc()
 
/** Free function for MD4 digest ctx
 *
 * @param[in] ctx       MD4 ctx to free.  If the shared ctx is passed in
 *                      then the ctx is reset but not freed.
 */
#define fr_md4_ctx_free(_ctx)                   fr_md4_funcs->free(_ctx)
 
/** Ingest plaintext into the digest
 *
 * @param[in] ctx       To ingest data into.
 * @param[in] in        Data to ingest.
 * @param[in] inlen     Length of data to ingest.
 */
#define fr_md4_update(_ctx, _in, _inlen)        fr_md4_funcs->update(_ctx, _in, _inlen)
 
/** Finalise the ctx, producing the digest
 *
 * @param[out] out      The MD4 digest.
 * @param[in] ctx       To finalise.
 */
#define fr_md4_final(_out, _ctx)                fr_md4_funcs->final(_out, _ctx)
 
/** Perform a single digest operation on a single input buffer
 *
 */
void            fr_md4_calc(uint8_t out[static MD4_DIGEST_LENGTH], uint8_t const *in, size_t inlen);
 
/** Allocate an md4 context from a free list
 *
 */
fr_md4_ctx_t    *fr_md4_ctx_alloc_from_list(void);
 
/** Release an md4 context back to a free list
 *
 */
void            fr_md4_ctx_free_from_list(fr_md4_ctx_t **ctx);
#ifdef __cplusplus
}
#endif