include/beecrypt/beecrypt.h File Reference

BeeCrypt API, headers. More...

#include "beecrypt/api.h"
#include "beecrypt/memchunk.h"
#include "beecrypt/mpnumber.h"
Include dependency graph for beecrypt.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  entropySource
 This struct holds information and pointers to code specific to each source of entropy. More...
struct  randomGenerator
 This struct holds information and pointers to code specific to each pseudo-random number generator. More...
struct  randomGeneratorContext
struct  hashFunction
struct  hashFunctionContext
struct  keyedHashFunction
struct  keyedHashFunctionContext
struct  blockCipherRaw
struct  blockCipherMode
struct  blockCipher
 Holds information and pointers to code specific to each cipher. More...
struct  blockCipherContext
 Holds a pointer to a blockcipher as well as its parameters. More...

Typedefs

typedef int(* entropyNext )(byte *, size_t)
 Prototype definition for an entropy-generating function.
typedef void randomGeneratorParam
typedef int(* randomGeneratorSetup )(randomGeneratorParam *)
typedef int(* randomGeneratorSeed )(randomGeneratorParam *, const byte *, size_t)
typedef int(* randomGeneratorNext )(randomGeneratorParam *, byte *, size_t)
typedef int(* randomGeneratorCleanup )(randomGeneratorParam *)
typedef void hashFunctionParam
typedef int(* hashFunctionReset )(hashFunctionParam *)
typedef int(* hashFunctionUpdate )(hashFunctionParam *, const byte *, size_t)
typedef int(* hashFunctionDigest )(hashFunctionParam *, byte *)
typedef void keyedHashFunctionParam
typedef int(* keyedHashFunctionSetup )(keyedHashFunctionParam *, const byte *, size_t)
typedef int(* keyedHashFunctionReset )(keyedHashFunctionParam *)
typedef int(* keyedHashFunctionUpdate )(keyedHashFunctionParam *, const byte *, size_t)
typedef int(* keyedHashFunctionDigest )(keyedHashFunctionParam *, byte *)
typedef void blockCipherParam
 Placeholder type definition for blockcipher parameters.
typedef int(* blockCipherSetup )(blockCipherParam *, const byte *, size_t, cipherOperation)
 Prototype definition for a setup function.
typedef int(* blockCipherSetIV )(blockCipherParam *, const byte *)
 Prototype definition for an initialization vector setup function.
typedef int(* blockCipherSetCTR )(blockCipherParam *, const byte *, size_t)
 Prototype definition for an initialization vector setup function.
typedef int(* blockCipherRawcrypt )(blockCipherParam *, uint32_t *, const uint32_t *)
 Prototype for a raw encryption or decryption function.
typedef int(* blockCipherModcrypt )(blockCipherParam *, uint32_t *, const uint32_t *, unsigned int)
 Prototype for a encryption or decryption function which operates on multiple blocks in a certain mode.
typedef uint32_t *(* blockCipherFeedback )(blockCipherParam *)

Enumerations

enum  cipherOperation { NOCRYPT, ENCRYPT, DECRYPT }
 

Specifies whether to perform encryption or decryption.

More...

Functions

int entropySourceCount (void)
 This function returns the number of entropy sources implemented by the library.
const entropySourceentropySourceGet (int n)
 This function returns the n -th entropy source implemented by the library.
const entropySourceentropySourceFind (const char *name)
 This function returns the entropy source specified by the given name.
const entropySourceentropySourceDefault (void)
 This functions returns the default entropy source; the default value can be specified by setting environment variable BEECRYPT_ENTROPY.
int entropyGatherNext (byte *, size_t)
 This function gathers size bytes of entropy into data.
int randomGeneratorCount (void)
const randomGeneratorrandomGeneratorGet (int)
const randomGeneratorrandomGeneratorFind (const char *)
const randomGeneratorrandomGeneratorDefault (void)
int randomGeneratorContextInit (randomGeneratorContext *, const randomGenerator *)
int randomGeneratorContextFree (randomGeneratorContext *)
int randomGeneratorContextNext (randomGeneratorContext *, byte *, size_t)
int randomGeneratorContextSeed (randomGeneratorContext *, const byte *, size_t)
int hashFunctionCount (void)
const hashFunctionhashFunctionGet (int)
const hashFunctionhashFunctionFind (const char *)
const hashFunctionhashFunctionDefault (void)
int hashFunctionContextInit (hashFunctionContext *, const hashFunction *)
int hashFunctionContextFree (hashFunctionContext *)
int hashFunctionContextReset (hashFunctionContext *)
int hashFunctionContextUpdate (hashFunctionContext *, const byte *, size_t)
int hashFunctionContextUpdateMC (hashFunctionContext *, const memchunk *)
int hashFunctionContextUpdateMP (hashFunctionContext *, const mpnumber *)
int hashFunctionContextDigest (hashFunctionContext *, byte *)
int hashFunctionContextDigestMP (hashFunctionContext *, mpnumber *)
int hashFunctionContextDigestMatch (hashFunctionContext *, const mpnumber *)
int keyedHashFunctionCount (void)
const keyedHashFunctionkeyedHashFunctionGet (int)
const keyedHashFunctionkeyedHashFunctionFind (const char *)
const keyedHashFunctionkeyedHashFunctionDefault (void)
int keyedHashFunctionContextInit (keyedHashFunctionContext *, const keyedHashFunction *)
int keyedHashFunctionContextFree (keyedHashFunctionContext *)
int keyedHashFunctionContextSetup (keyedHashFunctionContext *, const byte *, size_t)
int keyedHashFunctionContextReset (keyedHashFunctionContext *)
int keyedHashFunctionContextUpdate (keyedHashFunctionContext *, const byte *, size_t)
int keyedHashFunctionContextUpdateMC (keyedHashFunctionContext *, const memchunk *)
int keyedHashFunctionContextUpdateMP (keyedHashFunctionContext *, const mpnumber *)
int keyedHashFunctionContextDigest (keyedHashFunctionContext *, byte *)
int keyedHashFunctionContextDigestMP (keyedHashFunctionContext *, mpnumber *)
int keyedHashFunctionContextDigestMatch (keyedHashFunctionContext *, const mpnumber *)
int blockCipherCount (void)
 This function returns the number of blockciphers implemented by the library.
const blockCipherblockCipherGet (int)
 This function returns the n -th blockcipher implemented by the library.
const blockCipherblockCipherFind (const char *)
 This function returns the blockcipher specified by the given name.
const blockCipherblockCipherDefault (void)
 This functions returns the default blockcipher; the default value can be specified by setting environment variable BEECRYPT_CIPHER.
int blockCipherContextInit (blockCipherContext *, const blockCipher *)
int blockCipherContextSetup (blockCipherContext *, const byte *, size_t, cipherOperation)
int blockCipherContextSetIV (blockCipherContext *, const byte *)
int blockCipherContextSetCTR (blockCipherContext *, const byte *, size_t)
int blockCipherContextFree (blockCipherContext *)
int blockCipherContextECB (blockCipherContext *, uint32_t *, const uint32_t *, int)
int blockCipherContextCBC (blockCipherContext *, uint32_t *, const uint32_t *, int)
int blockCipherContextCTR (blockCipherContext *, uint32_t *, const uint32_t *, int)
int blockCipherContextValidKeylen (blockCipherContext *, size_t)

Detailed Description

BeeCrypt API, headers.

These API functions provide an abstract way for using most of the various algorithms implemented by the library.

Author:
Bob Deblier <bob.deblier@telenet.be>

Typedef Documentation

typedef uint32_t*(* blockCipherFeedback)(blockCipherParam *)
typedef int(* hashFunctionUpdate)(hashFunctionParam *, const byte *, size_t)
typedef int(* keyedHashFunctionSetup)(keyedHashFunctionParam *, const byte *, size_t)
typedef int(* keyedHashFunctionUpdate)(keyedHashFunctionParam *, const byte *, size_t)
typedef int(* randomGeneratorNext)(randomGeneratorParam *, byte *, size_t)
typedef void randomGeneratorParam
typedef int(* randomGeneratorSeed)(randomGeneratorParam *, const byte *, size_t)

Function Documentation

int blockCipherContextCBC ( blockCipherContext ,
uint32_t *  ,
const uint32_t *  ,
int   
)
int blockCipherContextCTR ( blockCipherContext ,
uint32_t *  ,
const uint32_t *  ,
int   
)
int blockCipherContextECB ( blockCipherContext ,
uint32_t *  ,
const uint32_t *  ,
int   
)
int blockCipherContextFree ( blockCipherContext  ) 
int blockCipherContextInit ( blockCipherContext ,
const blockCipher  
)
int blockCipherContextSetCTR ( blockCipherContext ,
const byte ,
size_t   
)
int blockCipherContextSetIV ( blockCipherContext ,
const byte  
)
int blockCipherContextSetup ( blockCipherContext ,
const byte ,
size_t  ,
cipherOperation   
)
int blockCipherContextValidKeylen ( blockCipherContext ,
size_t   
)
int blockCipherCount ( void   ) 

This function returns the number of blockciphers implemented by the library.

Returns:
The number of implemented blockciphers.
const blockCipher * blockCipherDefault ( void   ) 

This functions returns the default blockcipher; the default value can be specified by setting environment variable BEECRYPT_CIPHER.

Returns:
A pointer to a blockcipher or null, in case an error occured.
const blockCipher * blockCipherFind ( const char *  name  ) 

This function returns the blockcipher specified by the given name.

Parameters:
name Name of the requested blockcipher.
Returns:
A pointer to a blockcipher or null, if the name wasn't found.
const blockCipher * blockCipherGet ( int  n  ) 

This function returns the n -th blockcipher implemented by the library.

Parameters:
n Index of the requested blockcipher; legal values are 0 through blockCipherCount() - 1.
Returns:
A pointer to a blockcipher or null, if the index was out of range.
int entropyGatherNext ( byte data,
size_t  size 
)

This function gathers size bytes of entropy into data.

Unless environment variable BEECRYPT_ENTROPY is set, this function will try each successive entropy source to gather up the requested amount.

Parameters:
data Points to where the entropy should be stored.
size Indicates how many bytes of entropy should be gathered.
Return values:
0 On success.
-1 On failure.
int entropySourceCount ( void   ) 

This function returns the number of entropy sources implemented by the library.

Returns:
The number of implemented entropy sources.
const entropySource * entropySourceDefault ( void   ) 

This functions returns the default entropy source; the default value can be specified by setting environment variable BEECRYPT_ENTROPY.

Returns:
A pointer to an entropy source or null, in case an error occured.
const entropySource * entropySourceFind ( const char *  name  ) 

This function returns the entropy source specified by the given name.

Parameters:
name Name of the requested entropy source.
Returns:
A pointer to an entropy source or null, if the name wasn't found.
const entropySource * entropySourceGet ( int  n  ) 

This function returns the n -th entropy source implemented by the library.

Parameters:
n Index of the requested entropy source; legal values are 0 through entropySourceCount() - 1.
Returns:
A pointer to an entropy source or null, if the index was out of range.
int hashFunctionContextDigest ( hashFunctionContext ,
byte  
)
int hashFunctionContextDigestMatch ( hashFunctionContext ,
const mpnumber  
)
int hashFunctionContextDigestMP ( hashFunctionContext ,
mpnumber  
)
int hashFunctionContextFree ( hashFunctionContext  ) 
int hashFunctionContextInit ( hashFunctionContext ,
const hashFunction  
)
int hashFunctionContextReset ( hashFunctionContext  ) 
int hashFunctionContextUpdate ( hashFunctionContext ,
const byte ,
size_t   
)
int hashFunctionContextUpdateMC ( hashFunctionContext ,
const memchunk  
)
int hashFunctionContextUpdateMP ( hashFunctionContext ,
const mpnumber  
)
int hashFunctionCount ( void   ) 
const hashFunction* hashFunctionDefault ( void   ) 
const hashFunction* hashFunctionFind ( const char *   ) 
const hashFunction* hashFunctionGet ( int   ) 
int keyedHashFunctionContextDigest ( keyedHashFunctionContext ,
byte  
)
int keyedHashFunctionContextDigestMatch ( keyedHashFunctionContext ,
const mpnumber  
)
int keyedHashFunctionContextDigestMP ( keyedHashFunctionContext ,
mpnumber  
)
int keyedHashFunctionContextFree ( keyedHashFunctionContext  ) 
int keyedHashFunctionContextInit ( keyedHashFunctionContext ,
const keyedHashFunction  
)
int keyedHashFunctionContextReset ( keyedHashFunctionContext  ) 
int keyedHashFunctionContextSetup ( keyedHashFunctionContext ,
const byte ,
size_t   
)
int keyedHashFunctionContextUpdate ( keyedHashFunctionContext ,
const byte ,
size_t   
)
int keyedHashFunctionContextUpdateMC ( keyedHashFunctionContext ,
const memchunk  
)
int keyedHashFunctionContextUpdateMP ( keyedHashFunctionContext ,
const mpnumber  
)
int keyedHashFunctionCount ( void   ) 
const keyedHashFunction* keyedHashFunctionDefault ( void   ) 
const keyedHashFunction* keyedHashFunctionFind ( const char *   ) 
const keyedHashFunction* keyedHashFunctionGet ( int   ) 
int randomGeneratorContextFree ( randomGeneratorContext  ) 
int randomGeneratorContextInit ( randomGeneratorContext ,
const randomGenerator  
)
int randomGeneratorContextNext ( randomGeneratorContext ,
byte ,
size_t   
)
int randomGeneratorContextSeed ( randomGeneratorContext ,
const byte ,
size_t   
)
int randomGeneratorCount ( void   ) 
const randomGenerator* randomGeneratorDefault ( void   ) 
const randomGenerator* randomGeneratorFind ( const char *   ) 
const randomGenerator* randomGeneratorGet ( int   ) 

Generated on 18 Feb 2018 for BeeCrypt by  doxygen 1.6.1