summaryrefslogtreecommitdiff
path: root/src/stlink-lib/md5.h
blob: a69d7fc6b0e504f417f07b73709f2fa9afdfa01b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
/*
 * WjCryptLib_Md5 (https://github.com/WaterJuice/WjCryptLib)
 * Implementation of MD5 hash function. Originally written by Alexander Peslyak.
 * Modified by WaterJuice retaining Public Domain license.
 * This is free and unencumbered software released into the public domain - June 2013 - waterjuice.org
 */

#pragma once

#include <stdint.h>
#include <stdio.h>

/* TYPES */

/* Md5Context
 * This must be initialised using Md5Initialised.
 * Do not modify the contents of this structure directly.
 */
typedef struct {
    uint32_t lo;
    uint32_t hi;
    uint32_t a;
    uint32_t b;
    uint32_t c;
    uint32_t d;
    uint8_t buffer[64];
    uint32_t block[16];
} Md5Context;

#define MD5_HASH_SIZE (128 / 8)

typedef struct {
    uint8_t bytes [MD5_HASH_SIZE];
} MD5_HASH;

/* PUBLIC FUNCTIONS */

/* Md5Initialise
 * Initialises an MD5 Context.
 * Use this to initialise/reset a context.
 */
void Md5Initialise(Md5Context* Context /* [out] */);

/* Md5Update
 * Adds data to the MD5 context.
 * This will process the data and update the internal state of the context.
 * Keep on calling this function until all the data has been added.
 * Then call Md5Finalise to calculate the hash.
 */
void Md5Update(Md5Context* Context /* [in out] */, void const* Buffer /* [in] */, uint32_t BufferSize /* [in] */);

/* Md5Finalise
 * Performs the final calculation of the hash and returns the digest
 * (16 byte buffer containing 128bit hash).
 * After calling this, Md5Initialised must be used to reuse the context.
 */
void Md5Finalise(Md5Context* Context /* [in out] */, MD5_HASH* Digest /* [in] */);

/* Md5Calculate
 * Combines Md5Initialise, Md5Update, and Md5Finalise into one function.
 * Calculates the MD5 hash of the buffer.
 */
void Md5Calculate(void const* Buffer /* [in] */, uint32_t BufferSize /* [in] */, MD5_HASH* Digest /* [in] */);