Botan  2.8.0
Crypto and TLS for C++11
Functions
ffi_hash.cpp File Reference
#include <botan/ffi.h>
#include <botan/internal/ffi_util.h>
#include <botan/hash.h>

Go to the source code of this file.

Functions

 BOTAN_FFI_DECLARE_STRUCT (botan_hash_struct, Botan::HashFunction, 0x1F0A4F84)
 
int botan_hash_block_size (botan_hash_t hash, size_t *out)
 
int botan_hash_clear (botan_hash_t hash)
 
int botan_hash_copy_state (botan_hash_t *dest, const botan_hash_t source)
 
int botan_hash_destroy (botan_hash_t hash)
 
int botan_hash_final (botan_hash_t hash, uint8_t out[])
 
int botan_hash_init (botan_hash_t *hash, const char *hash_name, uint32_t flags)
 
int botan_hash_name (botan_hash_t hash, char *name, size_t *name_len)
 
int botan_hash_output_length (botan_hash_t hash, size_t *out)
 
int botan_hash_update (botan_hash_t hash, const uint8_t *buf, size_t len)
 

Function Documentation

◆ BOTAN_FFI_DECLARE_STRUCT()

BOTAN_FFI_DECLARE_STRUCT ( botan_hash_struct  ,
Botan::HashFunction  ,
0x1F0A4F84   
)

◆ botan_hash_block_size()

int botan_hash_block_size ( botan_hash_t  hash,
size_t *  block_size 
)

Writes the block size of the hash function to *block_size

Parameters
hashhash object
block_sizeoutput buffer to hold the hash function output length
Returns
0 on success, a negative value on failure

Definition at line 46 of file ffi_hash.cpp.

References BOTAN_FFI_DO, BOTAN_FFI_ERROR_NULL_POINTER, and hash.

47  {
48  if(out == nullptr)
50  return BOTAN_FFI_DO(Botan::HashFunction, hash, h, { *out = h.hash_block_size(); });
51  }
#define BOTAN_FFI_DO(T, obj, param, block)
Definition: ffi_util.h:86
MechanismType hash

◆ botan_hash_clear()

int botan_hash_clear ( botan_hash_t  hash)

Reinitializes the state of the hash computation. A hash can be computed (with update/final) immediately.

Parameters
hashhash object
Returns
0 on success, a negative value on failure

Definition at line 53 of file ffi_hash.cpp.

References BOTAN_FFI_DO, and hash.

54  {
55  return BOTAN_FFI_DO(Botan::HashFunction, hash, h, { h.clear(); });
56  }
#define BOTAN_FFI_DO(T, obj, param, block)
Definition: ffi_util.h:86
MechanismType hash

◆ botan_hash_copy_state()

int botan_hash_copy_state ( botan_hash_t dest,
const botan_hash_t  source 
)

Copy the state of a hash function object

Parameters
destdestination hash object
sourcesource hash object
Returns
0 on success, a negative value on failure

Definition at line 76 of file ffi_hash.cpp.

References BOTAN_FFI_DO.

77  {
78  return BOTAN_FFI_DO(Botan::HashFunction, source, src, {
79  *dest = new botan_hash_struct(src.copy_state().release()); });
80  }
#define BOTAN_FFI_DO(T, obj, param, block)
Definition: ffi_util.h:86

◆ botan_hash_destroy()

int botan_hash_destroy ( botan_hash_t  hash)

Frees all resources of the hash object

Parameters
hashhash object
Returns
always returns 0

Definition at line 34 of file ffi_hash.cpp.

References BOTAN_FFI_CHECKED_DELETE, and hash.

35  {
37  }
#define BOTAN_FFI_CHECKED_DELETE(o)
Definition: ffi_util.h:114
MechanismType hash

◆ botan_hash_final()

int botan_hash_final ( botan_hash_t  hash,
uint8_t  out[] 
)

Finalizes the hash computation and writes the output to out[0:botan_hash_output_length()] then reinitializes for computing another digest as if botan_hash_clear had been called.

Parameters
hashhash object
outoutput buffer
Returns
0 on success, a negative value on failure

Definition at line 69 of file ffi_hash.cpp.

References BOTAN_FFI_DO, BOTAN_FFI_ERROR_NULL_POINTER, and hash.

70  {
71  if(out == nullptr)
73  return BOTAN_FFI_DO(Botan::HashFunction, hash, h, { h.final(out); });
74  }
#define BOTAN_FFI_DO(T, obj, param, block)
Definition: ffi_util.h:86
MechanismType hash

◆ botan_hash_init()

int botan_hash_init ( botan_hash_t hash,
const char *  hash_name,
uint32_t  flags 
)

Initialize a hash function object

Parameters
hashhash object
hash_namename of the hash function, e.g., "SHA-384"
flagsshould be 0 in current API revision, all other uses are reserved and return BOTAN_FFI_ERROR_BAD_FLAG

Definition at line 17 of file ffi_hash.cpp.

References BOTAN_CURRENT_FUNCTION, BOTAN_FFI_ERROR_BAD_FLAG, BOTAN_FFI_ERROR_NOT_IMPLEMENTED, BOTAN_FFI_ERROR_NULL_POINTER, BOTAN_FFI_SUCCESS, Botan::HashFunction::create(), Botan_FFI::ffi_guard_thunk(), Botan::PKCS11::flags(), and hash.

18  {
19  return ffi_guard_thunk(BOTAN_CURRENT_FUNCTION, [=]() -> int {
20  if(hash == nullptr || hash_name == nullptr || *hash_name == 0)
22  if(flags != 0)
24 
25  std::unique_ptr<Botan::HashFunction> h = Botan::HashFunction::create(hash_name);
26  if(h == nullptr)
28 
29  *hash = new botan_hash_struct(h.release());
30  return BOTAN_FFI_SUCCESS;
31  });
32  }
int ffi_guard_thunk(const char *func_name, std::function< int()> thunk)
Definition: ffi.cpp:28
Flags flags(Flag flags)
Definition: p11.h:858
static std::unique_ptr< HashFunction > create(const std::string &algo_spec, const std::string &provider="")
Definition: hash.cpp:110
#define BOTAN_CURRENT_FUNCTION
Definition: compiler.h:143
MechanismType hash

◆ botan_hash_name()

int botan_hash_name ( botan_hash_t  hash,
char *  name,
size_t *  name_len 
)

Get the name of this hash function

Parameters
hashthe object to read
nameoutput buffer
name_lenon input, the length of buffer, on success the number of bytes written

Definition at line 82 of file ffi_hash.cpp.

References BOTAN_FFI_DO, BOTAN_FFI_ERROR_NULL_POINTER, hash, name, and Botan_FFI::write_str_output().

83  {
84  if(name_len == nullptr)
86 
88  return write_str_output(name, name_len, h.name()); });
89  }
int write_str_output(uint8_t out[], size_t *out_len, const std::string &str)
Definition: ffi_util.h:145
std::string name
#define BOTAN_FFI_DO(T, obj, param, block)
Definition: ffi_util.h:86
MechanismType hash

◆ botan_hash_output_length()

int botan_hash_output_length ( botan_hash_t  hash,
size_t *  output_length 
)

Writes the output length of the hash function to *output_length

Parameters
hashhash object
output_lengthoutput buffer to hold the hash function output length
Returns
0 on success, a negative value on failure

Definition at line 39 of file ffi_hash.cpp.

References BOTAN_FFI_DO, BOTAN_FFI_ERROR_NULL_POINTER, and hash.

40  {
41  if(out == nullptr)
43  return BOTAN_FFI_DO(Botan::HashFunction, hash, h, { *out = h.output_length(); });
44  }
#define BOTAN_FFI_DO(T, obj, param, block)
Definition: ffi_util.h:86
MechanismType hash

◆ botan_hash_update()

int botan_hash_update ( botan_hash_t  hash,
const uint8_t *  in,
size_t  in_len 
)

Send more input to the hash function

Parameters
hashhash object
ininput buffer
in_lennumber of bytes to read from the input buffer
Returns
0 on success, a negative value on failure

Definition at line 58 of file ffi_hash.cpp.

References BOTAN_FFI_DO, BOTAN_FFI_ERROR_NULL_POINTER, and hash.

59  {
60  if(len == 0)
61  return 0;
62 
63  if(buf == nullptr)
65 
66  return BOTAN_FFI_DO(Botan::HashFunction, hash, h, { h.update(buf, len); });
67  }
#define BOTAN_FFI_DO(T, obj, param, block)
Definition: ffi_util.h:86
MechanismType hash