Hash.h

/*
Copyright (c) 2015 Colum Paget <colums.projects@googlemail.com>
* SPDX-License-Identifier: GPL-3.0
*/

#ifndef LIBUSEFUL_HASH_H
#define LIBUSEFUL_HASH_H

/* Hashing functions. Mostly you'll use:

len=HashBytes(&Hashed, "md5", "string to hash", 14, ENCODE_HEX);

or

len=HashFile(&Hashed, "sha1", "/tmp/filetohash.txt", ENCODE_BASE64);

You can get a list of available hash types with HashAvailableTypes. This should be MD5, various SHA variants, whirlpool, and variants of the jh hash
from Dr Hongjun Wu. More hash algorithms will likely be added in future.


if you need more granulated control of hashing, then it's done like this

Hash=HashInit("md5");
S=STREAMOpen("/tmp/testfile.txt","r");
result=STREAMReadBytes(S, Buffer BUFSIZ);
while (result > 0)
{
HashUpdate(Hash, Buffer, result);
result=STREAMReadBytes(S, Buffer BUFSIZ);
}
len=HashFinish(Hash, ENCODE_BASE64, HashStr);

printf("Hash was: %s\n",HashStr);

*/



//if you load Hash.h you'll want Encodings.h too
#include "Encodings.h"
#include "Stream.h"
#include "includes.h"

#define HashUpdate(Hash, text, len) (Hash->Update(Hash, text, len))


#ifdef __cplusplus
extern "C" {
#endif

typedef struct t_hash HASH;

typedef int (*HASH_INIT_FUNC)(HASH *Hash, const char *Name, int Bits);
typedef void (*HASH_UPDATE_FUNC)(HASH *Hash, const char *Data, int DataLen);
typedef HASH *(*HASH_CLONE_FUNC)(HASH *Hash);
typedef int (*HASH_FINISH_FUNC)(HASH *Hash, char **RetStr);

struct t_hash
{
    char *Type;
//this is a placeholder used only by classlibraries for scripting langauges
    int Encoding;
    char *Key1;
    unsigned int Key1Len;
    char *Key2;
    unsigned int Key2Len;
    void *Ctx;
    HASH_INIT_FUNC Init;
    HASH_UPDATE_FUNC Update;
    HASH_FINISH_FUNC Finish;
    HASH_CLONE_FUNC Clone;
};


//this function is used internally to register a hash type
void HashRegister(const char *Name, int Len, HASH_INIT_FUNC Init);

//for backwards compatiblity provide this function. It just calls'EncodingParse'
int HashEncodingFromStr(const char *Str);

//produce a comma separated list of available hash types. This can include hash-names from external sources like openssl.
char *HashAvailableTypes(char *RetStr);


HASH *HashInit(const char *Type);
int HashFinish(HASH *Hash, int Encoding, char **Return);
void HashDestroy(HASH *Hash);
int HashBytes(char **Return, const char *Type, const char *text, int len, int Encoding);
int HashBytes2(const char *Type, int Encoding, const char *text, int len, char **RetStr);

//read from a stream (usually a file) and return the hash of it's contents
int HashSTREAM(char **Return, const char *Type, STREAM *S, int Encoding);

//hash a file at 'Path'
int HashFile(char **Return, const char *Type, const char *Path, int Encoding);
int PBK2DF2(char **Return, const char *Type, const char *Bytes, int Len, const char *Salt, int SaltLen, uint32_t Rounds, int Encoding);

#ifdef __cplusplus
}
#endif



#endif