Botan::GHASH Class Reference

#include <ghash.h>

Inheritance diagram for Botan::GHASH:

Public Member Functions
void	add_final_block (secure_vector< uint8_t > &x, size_t ad_len, size_t pt_len)
void	clear () override
secure_vector< uint8_t >	final ()
void	final (uint8_t out[], size_t out_len)
void	ghash_update (secure_vector< uint8_t > &x, const uint8_t input[], size_t input_len)
Key_Length_Specification	key_spec () const override
size_t	maximum_keylength () const
size_t	minimum_keylength () const
std::string	name () const override
secure_vector< uint8_t >	nonce_hash (const uint8_t nonce[], size_t nonce_len)
void	nonce_hash (secure_vector< uint8_t > &y0, const uint8_t nonce[], size_t len)
std::string	provider () const
void	reset ()
void	set_associated_data (const uint8_t ad[], size_t ad_len)
template<typename Alloc >
void	set_key (const std::vector< uint8_t, Alloc > &key)
void	set_key (const SymmetricKey &key)
void	set_key (const uint8_t key[], size_t length)
void	start (const uint8_t nonce[], size_t len)
void	update (const uint8_t in[], size_t len)
void	update_associated_data (const uint8_t ad[], size_t len)
bool	valid_keylength (size_t length) const

Protected Member Functions
void	verify_key_set (bool cond) const

Detailed Description

GCM's GHASH This is not intended for general use, but is exposed to allow shared code between GCM and GMAC

Definition at line 22 of file ghash.h.

Member Function Documentation

add_final_block()

void Botan::GHASH::add_final_block	(	secure_vector< uint8_t > &	x,
		size_t	ad_len,
		size_t	pt_len
	)

Definition at line 189 of file ghash.cpp.

   {
   /*
   * stack buffer is fine here since the text len is public
   * and the length of the AD is probably not sensitive either.
   */
   uint8_t final_block[GCM_BS];
   store_be<uint64_t>(final_block, 8*ad_len, 8*text_len);
   ghash_update(hash, final_block, GCM_BS);
   }

References ghash_update(), and hash.

Referenced by final(), and nonce_hash().

clear()

void Botan::GHASH::clear ( )

overridevirtual

Reset the state.

Implements Botan::SymmetricAlgorithm.

Definition at line 221 of file ghash.cpp.

   {
   zap(m_H);
   zap(m_HM);
   reset();
   }

References reset(), and Botan::zap().

final() [1/2]

secure_vector< uint8_t > Botan::GHASH::final ( )

inline

Definition at line 49 of file ghash.h.

         {
         secure_vector<uint8_t> mac(GCM_BS);
         final(mac.data(), mac.size());
         return mac;
         }

final() [2/2]

void Botan::GHASH::final	(	uint8_t	out[],
		size_t	out_len
	)

Definition at line 201 of file ghash.cpp.

   {
   BOTAN_ARG_CHECK(mac_len > 0 && mac_len <= 16, "GHASH output length");
   add_final_block(m_ghash, m_ad_len, m_text_len);
 
   for(size_t i = 0; i != mac_len; ++i)
      mac[i] = m_ghash[i] ^ m_nonce[i];
 
   m_ghash.clear();
   m_text_len = 0;
   }

References add_final_block(), and BOTAN_ARG_CHECK.

ghash_update()

void Botan::GHASH::ghash_update	(	secure_vector< uint8_t > &	x,
		const uint8_t	input[],
		size_t	input_len
	)

Definition at line 88 of file ghash.cpp.

   {
   verify_key_set(!m_HM.empty());
 
   /*
   This assumes if less than block size input then we're just on the
   final block and should pad with zeros
   */
 
   const size_t full_blocks = length / GCM_BS;
   const size_t final_bytes = length - (full_blocks * GCM_BS);
 
   if(full_blocks > 0)
      {
      ghash_multiply(ghash, input, full_blocks);
      }
 
   if(final_bytes)
      {
      uint8_t last_block[GCM_BS] = { 0 };
      copy_mem(last_block, input + full_blocks * GCM_BS, final_bytes);
      ghash_multiply(ghash, last_block, 1);
      secure_scrub_memory(last_block, final_bytes);
      }
   }

References Botan::copy_mem(), Botan::secure_scrub_memory(), and Botan::SymmetricAlgorithm::verify_key_set().

Referenced by add_final_block(), nonce_hash(), set_associated_data(), update(), and update_associated_data().

key_spec()

Key_Length_Specification Botan::GHASH::key_spec ( ) const

inlineoverridevirtual

Returns

object describing limits on key size

Implements Botan::SymmetricAlgorithm.

Definition at line 58 of file ghash.h.

         { return Key_Length_Specification(16); }

maximum_keylength()

size_t Botan::SymmetricAlgorithm::maximum_keylength ( ) const

inlineinherited

Returns

maximum allowed key length

Definition at line 120 of file sym_algo.h.

         {
         return key_spec().maximum_keylength();
         }

minimum_keylength()

size_t Botan::SymmetricAlgorithm::minimum_keylength ( ) const

inlineinherited

Returns

minimum allowed key length

Definition at line 128 of file sym_algo.h.

         {
         return key_spec().minimum_keylength();
         }

Referenced by botan_block_cipher_get_keyspec(), and botan_mac_get_keyspec().

name()

std::string Botan::GHASH::name ( ) const

inlineoverridevirtual

Returns

the algorithm name

Implements Botan::SymmetricAlgorithm.

Definition at line 65 of file ghash.h.

{ return "GHASH"; }

nonce_hash() [1/2]

secure_vector< uint8_t > Botan::GHASH::nonce_hash ( const uint8_t  nonce[], size_t  nonce_len  )

inline

Definition at line 28 of file ghash.h.

         {
         secure_vector<uint8_t> y0(GCM_BS);
         nonce_hash(y0, nonce, nonce_len);
         return y0;
         }

nonce_hash() [2/2]

void Botan::GHASH::nonce_hash	(	secure_vector< uint8_t > &	y0,
		const uint8_t	nonce[],
		size_t	len
	)

Definition at line 213 of file ghash.cpp.

   {
   BOTAN_ASSERT(m_ghash.size() == 0, "nonce_hash called during wrong time");
 
   ghash_update(y0, nonce, nonce_len);
   add_final_block(y0, 0, nonce_len);
   }

References add_final_block(), BOTAN_ASSERT, and ghash_update().

provider()

std::string Botan::GHASH::provider

(

)

const

Definition at line 17 of file ghash.cpp.

   {
#if defined(BOTAN_HAS_GHASH_CLMUL_CPU)
   if(CPUID::has_carryless_multiply())
      return "clmul";
#endif
 
#if defined(BOTAN_HAS_GHASH_CLMUL_VPERM)
   if(CPUID::has_vperm())
      return "vperm";
#endif
 
   return "base";
   }

References Botan::CPUID::has_carryless_multiply(), and Botan::CPUID::has_vperm().

reset()

void Botan::GHASH::reset

(

)

Definition at line 228 of file ghash.cpp.

   {
   zeroise(m_H_ad);
   m_ghash.clear();
   m_nonce.clear();
   m_text_len = m_ad_len = 0;
   }

References Botan::zeroise().

Referenced by clear().

set_associated_data()

void Botan::GHASH::set_associated_data	(	const uint8_t	ad[],
		size_t	ad_len
	)

Definition at line 164 of file ghash.cpp.

   {
   if(m_ghash.empty() == false)
      throw Invalid_State("Too late to set AD in GHASH");
 
   zeroise(m_H_ad);
 
   ghash_update(m_H_ad, input, length);
   m_ad_len = length;
   }

References ghash_update(), and Botan::zeroise().

set_key() [1/3]

template<typename Alloc >

void Botan::SymmetricAlgorithm::set_key ( const std::vector< uint8_t, Alloc > &  key )

inlineinherited

Definition at line 153 of file sym_algo.h.

         {
         set_key(key.data(), key.size());
         }

set_key() [2/3]

void Botan::SymmetricAlgorithm::set_key ( const SymmetricKey &  key )

inlineinherited

Set the symmetric key of this object.

Parameters

key	the SymmetricKey to be set.

Definition at line 147 of file sym_algo.h.

         {
         set_key(key.begin(), key.length());
         }

References Botan::OctetString::begin(), and Botan::OctetString::length().

Referenced by Botan::aont_package(), Botan::aont_unpackage(), botan_block_cipher_set_key(), botan_cipher_set_key(), botan_mac_set_key(), Botan::Sodium::crypto_stream_salsa20(), Botan::Sodium::crypto_stream_salsa20_xor_ic(), Botan::Sodium::crypto_stream_xsalsa20(), Botan::Sodium::crypto_stream_xsalsa20_xor_ic(), Botan::FPE::fe1_decrypt(), Botan::FPE::fe1_encrypt(), and Botan::Sodium::randombytes_buf_deterministic().

set_key() [3/3]

void Botan::SymmetricAlgorithm::set_key ( const uint8_t  key[], size_t  length  )

inherited

Set the symmetric key of this object.

Parameters

key	the to be set as a byte array.
length	in bytes of key param

Definition at line 17 of file sym_algo.cpp.

   {
   if(!valid_keylength(length))
      throw Invalid_Key_Length(name(), length);
   key_schedule(key, length);
   }

References Botan::SymmetricAlgorithm::name(), and Botan::SymmetricAlgorithm::valid_keylength().

start()

void Botan::GHASH::start	(	const uint8_t	nonce[],
		size_t	len
	)

Definition at line 157 of file ghash.cpp.

   {
   BOTAN_ARG_CHECK(len == 16, "GHASH requires a 128-bit nonce");
   m_nonce.assign(nonce, nonce + len);
   m_ghash = m_H_ad;
   }

References BOTAN_ARG_CHECK.

update()

void Botan::GHASH::update	(	const uint8_t	in[],
		size_t	len
	)

Definition at line 182 of file ghash.cpp.

   {
   verify_key_set(m_ghash.size() == GCM_BS);
   m_text_len += length;
   ghash_update(m_ghash, input, length);
   }

References ghash_update(), and Botan::SymmetricAlgorithm::verify_key_set().

update_associated_data()

void Botan::GHASH::update_associated_data	(	const uint8_t	ad[],
		size_t	len
	)

Definition at line 175 of file ghash.cpp.

   {
   verify_key_set(m_ghash.size() == GCM_BS);
   m_ad_len += length;
   ghash_update(m_ghash, ad, length);
   }

References ghash_update(), and Botan::SymmetricAlgorithm::verify_key_set().

valid_keylength()

bool Botan::SymmetricAlgorithm::valid_keylength ( size_t  length ) const

inlineinherited

Check whether a given key length is valid for this algorithm.

Parameters

length

the key length to be checked.

Returns

true if the key length is valid.

Definition at line 138 of file sym_algo.h.

         {
         return key_spec().valid_keylength(length);
         }

Referenced by Botan::aont_package(), Botan::aont_unpackage(), and Botan::SymmetricAlgorithm::set_key().

verify_key_set()

void Botan::SymmetricAlgorithm::verify_key_set ( bool  cond ) const

inlineprotectedinherited

Definition at line 171 of file sym_algo.h.

         {
         if(cond == false)
            throw_key_not_set_error();
         }

Referenced by Botan::ChaCha::cipher(), Botan::CTR_BE::cipher(), Botan::RC4::cipher(), Botan::Salsa20::cipher(), Botan::SHAKE_128_Cipher::cipher(), Botan::AES_128::decrypt_n(), Botan::AES_192::decrypt_n(), Botan::AES_256::decrypt_n(), Botan::ARIA_128::decrypt_n(), Botan::ARIA_192::decrypt_n(), Botan::ARIA_256::decrypt_n(), Botan::Blowfish::decrypt_n(), Botan::Camellia_128::decrypt_n(), Botan::Camellia_192::decrypt_n(), Botan::Camellia_256::decrypt_n(), Botan::CAST_128::decrypt_n(), Botan::CAST_256::decrypt_n(), Botan::DES::decrypt_n(), Botan::TripleDES::decrypt_n(), Botan::DESX::decrypt_n(), Botan::GOST_28147_89::decrypt_n(), Botan::IDEA::decrypt_n(), Botan::KASUMI::decrypt_n(), Botan::Lion::decrypt_n(), Botan::MISTY1::decrypt_n(), Botan::Noekeon::decrypt_n(), Botan::SEED::decrypt_n(), Botan::Serpent::decrypt_n(), Botan::SHACAL2::decrypt_n(), Botan::SM4::decrypt_n(), Botan::Threefish_512::decrypt_n(), Botan::Twofish::decrypt_n(), Botan::XTEA::decrypt_n(), Botan::AES_128::encrypt_n(), Botan::AES_192::encrypt_n(), Botan::AES_256::encrypt_n(), Botan::ARIA_128::encrypt_n(), Botan::ARIA_192::encrypt_n(), Botan::ARIA_256::encrypt_n(), Botan::Blowfish::encrypt_n(), Botan::Camellia_128::encrypt_n(), Botan::Camellia_192::encrypt_n(), Botan::Camellia_256::encrypt_n(), Botan::CAST_128::encrypt_n(), Botan::CAST_256::encrypt_n(), Botan::DES::encrypt_n(), Botan::TripleDES::encrypt_n(), Botan::DESX::encrypt_n(), Botan::GOST_28147_89::encrypt_n(), Botan::IDEA::encrypt_n(), Botan::KASUMI::encrypt_n(), Botan::Lion::encrypt_n(), Botan::MISTY1::encrypt_n(), Botan::Noekeon::encrypt_n(), Botan::SEED::encrypt_n(), Botan::Serpent::encrypt_n(), Botan::SHACAL2::encrypt_n(), Botan::SM4::encrypt_n(), Botan::Threefish_512::encrypt_n(), Botan::Twofish::encrypt_n(), Botan::XTEA::encrypt_n(), Botan::OCB_Encryption::finish(), Botan::OCB_Decryption::finish(), ghash_update(), Botan::CFB_Encryption::process(), Botan::CFB_Decryption::process(), Botan::ChaCha::seek(), Botan::CTR_BE::seek(), Botan::Salsa20::seek(), Botan::OCB_Mode::set_associated_data(), Botan::ChaCha::set_iv(), Botan::Salsa20::set_iv(), update(), update_associated_data(), and Botan::ChaCha::write_keystream().

---

The documentation for this class was generated from the following files:

• src/lib/utils/ghash/ghash.h
• src/lib/utils/ghash/ghash.cpp
• src/lib/utils/ghash/ghash_cpu/ghash_cpu.cpp
• src/lib/utils/ghash/ghash_vperm/ghash_vperm.cpp