Botan::SHAKE_128_Cipher Class Reference

#include <shake_cipher.h>

Inheritance diagram for Botan::SHAKE_128_Cipher:

Public Member Functions
void	cipher (const uint8_t in[], uint8_t out[], size_t length) override
void	cipher1 (uint8_t buf[], size_t len)
void	clear () override
StreamCipher *	clone () const override
template<typename Alloc >
void	decrypt (std::vector< uint8_t, Alloc > &inout)
template<typename Alloc >
void	encipher (std::vector< uint8_t, Alloc > &inout)
template<typename Alloc >
void	encrypt (std::vector< uint8_t, Alloc > &inout)
Key_Length_Specification	key_spec () const override
size_t	maximum_keylength () const
size_t	minimum_keylength () const
std::string	name () const override
virtual std::string	provider () const
void	seek (uint64_t offset) override
void	set_iv (const uint8_t iv[], size_t iv_len) override
void	set_key (const SymmetricKey &key)
template<typename Alloc >
void	set_key (const std::vector< uint8_t, Alloc > &key)
void	set_key (const uint8_t key[], size_t length)
	SHAKE_128_Cipher ()
bool	valid_iv_length (size_t iv_len) const override
bool	valid_keylength (size_t length) const

Static Public Member Functions
static std::unique_ptr< StreamCipher >	create (const std::string &algo_spec, const std::string &provider="")
static std::unique_ptr< StreamCipher >	create_or_throw (const std::string &algo_spec, const std::string &provider="")
static std::vector< std::string >	providers (const std::string &algo_spec)

Protected Member Functions
void	verify_key_set (bool cond) const

Detailed Description

SHAKE-128 XOF presented as a stream cipher

Definition at line 19 of file shake_cipher.h.

Constructor & Destructor Documentation

SHAKE_128_Cipher()

Botan::SHAKE_128_Cipher::SHAKE_128_Cipher

(

)

Definition at line 14 of file shake_cipher.cpp.

                                   :
   m_buf_pos(0)
   {}

Member Function Documentation

cipher()

void Botan::SHAKE_128_Cipher::cipher ( const uint8_t  in[], uint8_t  out[], size_t  length  )

overridevirtual

Produce more XOF output

Implements Botan::StreamCipher.

Definition at line 18 of file shake_cipher.cpp.

References Botan::copy_out_le(), Botan::SHA_3::permute(), Botan::SymmetricAlgorithm::verify_key_set(), and Botan::xor_buf().

   {
   verify_key_set(m_state.empty() == false);

   while(length >= m_buffer.size() - m_buf_pos)
      {
      xor_buf(out, in, &m_buffer[m_buf_pos], m_buffer.size() - m_buf_pos);
      length -= (m_buffer.size() - m_buf_pos);
      in += (m_buffer.size() - m_buf_pos);
      out += (m_buffer.size() - m_buf_pos);

      SHA_3::permute(m_state.data());
      copy_out_le(m_buffer.data(), m_buffer.size(), m_state.data());

      m_buf_pos = 0;
      }
   xor_buf(out, in, &m_buffer[m_buf_pos], length);
   m_buf_pos += length;
   }

cipher1()

void Botan::StreamCipher::cipher1 ( uint8_t  buf[], size_t  len  )

inlineinherited

Encrypt or decrypt a message The message is encrypted/decrypted in place.

Parameters

buf	the plaintext / ciphertext
len	the length of buf in bytes

Definition at line 66 of file stream_cipher.h.

Referenced by Botan::SIV_Encryption::finish().

         { cipher(buf, buf, len); }

clear()

void Botan::SHAKE_128_Cipher::clear ( )

overridevirtual

Reset the state.

Implements Botan::SymmetricAlgorithm.

Definition at line 56 of file shake_cipher.cpp.

References Botan::zap().

   {
   zap(m_state);
   zap(m_buffer);
   m_buf_pos = 0;
   }

clone()

StreamCipher* Botan::SHAKE_128_Cipher::clone ( ) const

inlineoverridevirtual

Returns

a new object representing the same algorithm as *this

Implements Botan::StreamCipher.

Definition at line 52 of file shake_cipher.h.

{ return new SHAKE_128_Cipher; }

create()

std::unique_ptr< StreamCipher > Botan::StreamCipher::create ( const std::string &  algo_spec, const std::string &  provider = ""  )

staticinherited

Create an instance based on a name If provider is empty then best available is chosen.

Parameters

algo_spec	algorithm name
provider	provider implementation to use

Returns

a null pointer if the algo/provider combination cannot be found

Definition at line 41 of file stream_cipher.cpp.

References Botan::SCAN_Name::algo_name(), Botan::SCAN_Name::arg(), Botan::SCAN_Name::arg_as_integer(), Botan::SCAN_Name::arg_count(), Botan::SCAN_Name::arg_count_between(), BOTAN_UNUSED, Botan::StreamCipher::cipher(), Botan::BlockCipher::create(), and Botan::StreamCipher::provider().

Referenced by Botan::BlockCipher::create(), Botan::Cipher_Mode::create(), and Botan::StreamCipher::create_or_throw().

   {
   const SCAN_Name req(algo_spec);

#if defined(BOTAN_HAS_CTR_BE)
   if((req.algo_name() == "CTR-BE" || req.algo_name() == "CTR") && req.arg_count_between(1,2))
      {
      if(provider.empty() || provider == "base")
         {
         auto cipher = BlockCipher::create(req.arg(0));
         if(cipher)
            {
            size_t ctr_size = req.arg_as_integer(1, cipher->block_size());
            return std::unique_ptr<StreamCipher>(new CTR_BE(cipher.release(), ctr_size));
            }
         }
      }
#endif

#if defined(BOTAN_HAS_CHACHA)
   if(req.algo_name() == "ChaCha")
      {
      if(provider.empty() || provider == "base")
         return std::unique_ptr<StreamCipher>(new ChaCha(req.arg_as_integer(0, 20)));
      }

   if(req.algo_name() == "ChaCha20")
      {
      if(provider.empty() || provider == "base")
         return std::unique_ptr<StreamCipher>(new ChaCha(20));
      }
#endif

#if defined(BOTAN_HAS_SALSA20)
   if(req.algo_name() == "Salsa20")
      {
      if(provider.empty() || provider == "base")
         return std::unique_ptr<StreamCipher>(new Salsa20);
      }
#endif

#if defined(BOTAN_HAS_SHAKE_CIPHER)
   if(req.algo_name() == "SHAKE-128")
      {
      if(provider.empty() || provider == "base")
         return std::unique_ptr<StreamCipher>(new SHAKE_128_Cipher);
      }
#endif

#if defined(BOTAN_HAS_OFB)
   if(req.algo_name() == "OFB" && req.arg_count() == 1)
      {
      if(provider.empty() || provider == "base")
         {
         if(auto c = BlockCipher::create(req.arg(0)))
            return std::unique_ptr<StreamCipher>(new OFB(c.release()));
         }
      }
#endif

#if defined(BOTAN_HAS_RC4)

   if(req.algo_name() == "RC4" ||
      req.algo_name() == "ARC4" ||
      req.algo_name() == "MARK-4")
      {
      const size_t skip = (req.algo_name() == "MARK-4") ? 256 : req.arg_as_integer(0, 0);

#if defined(BOTAN_HAS_OPENSSL)
      if(provider.empty() || provider == "openssl")
         {
         return std::unique_ptr<StreamCipher>(make_openssl_rc4(skip));
         }
#endif

      if(provider.empty() || provider == "base")
         {
         return std::unique_ptr<StreamCipher>(new RC4(skip));
         }
      }

#endif

   BOTAN_UNUSED(req);
   BOTAN_UNUSED(provider);

   return nullptr;
   }

create_or_throw()

std::unique_ptr< StreamCipher > Botan::StreamCipher::create_or_throw ( const std::string &  algo_spec, const std::string &  provider = ""  )

staticinherited

Create an instance based on a name If provider is empty then best available is chosen.

Parameters

algo_spec	algorithm name
provider	provider implementation to use Throws a Lookup_Error if the algo/provider combination cannot be found

Definition at line 133 of file stream_cipher.cpp.

References Botan::StreamCipher::create(), and Botan::StreamCipher::provider().

Referenced by Botan::ChaCha_RNG::ChaCha_RNG().

   {
   if(auto sc = StreamCipher::create(algo, provider))
      {
      return sc;
      }
   throw Lookup_Error("Stream cipher", algo, provider);
   }

decrypt()

template<typename Alloc >

void Botan::StreamCipher::decrypt ( std::vector< uint8_t, Alloc > &  inout )

inlineinherited

Decrypt a message in place The message is decrypted in place.

Parameters

inout

the plaintext / ciphertext

Definition at line 93 of file stream_cipher.h.

         { cipher(inout.data(), inout.data(), inout.size()); }

encipher()

template<typename Alloc >

void Botan::StreamCipher::encipher ( std::vector< uint8_t, Alloc > &  inout )

inlineinherited

Encrypt a message The message is encrypted/decrypted in place.

Parameters

inout

the plaintext / ciphertext

Definition at line 75 of file stream_cipher.h.

         { cipher(inout.data(), inout.data(), inout.size()); }

encrypt()

template<typename Alloc >

void Botan::StreamCipher::encrypt ( std::vector< uint8_t, Alloc > &  inout )

inlineinherited

Encrypt a message The message is encrypted in place.

Parameters

inout

the plaintext / ciphertext

Definition at line 84 of file stream_cipher.h.

         { cipher(inout.data(), inout.data(), inout.size()); }

key_spec()

Key_Length_Specification Botan::SHAKE_128_Cipher::key_spec ( ) const

inlineoverridevirtual

In principle SHAKE can accept arbitrary length inputs, but this does not seem required for a stream cipher.

Implements Botan::SymmetricAlgorithm.

Definition at line 45 of file shake_cipher.h.

         {
         return Key_Length_Specification(16, 160, 8);
         }

maximum_keylength()

size_t Botan::SymmetricAlgorithm::maximum_keylength ( ) const

inlineinherited

Returns

minimum allowed key length

Definition at line 39 of file sym_algo.h.

         {
         return key_spec().maximum_keylength();
         }

minimum_keylength()

size_t Botan::SymmetricAlgorithm::minimum_keylength ( ) const

inlineinherited

Returns

maximum allowed key length

Definition at line 47 of file sym_algo.h.

         {
         return key_spec().minimum_keylength();
         }

name()

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

inlineoverridevirtual

Returns

the algorithm name

Implements Botan::SymmetricAlgorithm.

Definition at line 51 of file shake_cipher.h.

Referenced by set_iv().

{ return "SHAKE-128"; }

provider()

virtual std::string Botan::StreamCipher::provider ( ) const

inlinevirtualinherited

Returns

provider information about this implementation. Default is "base", might also return "sse2", "avx2", "openssl", or some other arbitrary string.

Reimplemented in Botan::ChaCha.

Definition at line 124 of file stream_cipher.h.

Referenced by Botan::StreamCipher::create(), and Botan::StreamCipher::create_or_throw().

{ return "base"; }

providers()

std::vector< std::string > Botan::StreamCipher::providers ( const std::string &  algo_spec )

staticinherited

Returns

list of available providers for this algorithm, empty if not available

Definition at line 143 of file stream_cipher.cpp.

   {
   return probe_providers_of<StreamCipher>(algo_spec, {"base", "openssl"});
   }

seek()

void Botan::SHAKE_128_Cipher::seek ( uint64_t  offset )

overridevirtual

Seeking is not supported, this function will throw

Implements Botan::StreamCipher.

Definition at line 73 of file shake_cipher.cpp.

   {
   throw Not_Implemented("SHAKE_128_Cipher::seek");
   }

set_iv()

void Botan::SHAKE_128_Cipher::set_iv ( const uint8_t  iv[], size_t  iv_len  )

overridevirtual

IV not supported, this function will throw unless iv_len == 0

Implements Botan::StreamCipher.

Definition at line 63 of file shake_cipher.cpp.

References name().

   {
   /*
   * This could be supported in some way (say, by treating iv as
   * a prefix or suffix of the key).
   */
   if(length != 0)
      throw Invalid_IV_Length(name(), length);
   }

set_key() [1/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 66 of file sym_algo.h.

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

Referenced by Botan::aont_package(), Botan::aont_unpackage(), botan_block_cipher_set_key(), botan_mac_set_key(), Botan::FPE::fe1_decrypt(), Botan::FPE::fe1_encrypt(), and Botan::pbkdf2().

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

set_key() [2/3]

template<typename Alloc >

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

inlineinherited

Definition at line 72 of file sym_algo.h.

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

set_key() [3/3]

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

inlineinherited

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 82 of file sym_algo.h.

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

valid_iv_length()

bool Botan::SHAKE_128_Cipher::valid_iv_length ( size_t  iv_len ) const

inlineoverridevirtual

Parameters

iv_len

the length of the IV in bytes

Returns

if the length is valid for this algorithm

Reimplemented from Botan::StreamCipher.

Definition at line 39 of file shake_cipher.h.

{ return (iv_len == 0); }

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 57 of file sym_algo.h.

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

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

verify_key_set()

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

inlineprotectedinherited

Definition at line 95 of file sym_algo.h.

Referenced by Botan::Salsa20::cipher(), Botan::CTR_BE::cipher(), Botan::RC4::cipher(), cipher(), Botan::ChaCha::cipher(), Botan::MISTY1::decrypt_n(), Botan::CAST_128::decrypt_n(), Botan::Twofish::decrypt_n(), Botan::CAST_256::decrypt_n(), Botan::XTEA::decrypt_n(), Botan::SEED::decrypt_n(), Botan::Noekeon::decrypt_n(), Botan::SHACAL2::decrypt_n(), Botan::SM4::decrypt_n(), Botan::Threefish_512::decrypt_n(), Botan::AES_128::decrypt_n(), Botan::Blowfish::decrypt_n(), Botan::DES::decrypt_n(), Botan::Camellia_128::decrypt_n(), Botan::DESX::decrypt_n(), Botan::IDEA::decrypt_n(), Botan::KASUMI::decrypt_n(), Botan::Serpent::decrypt_n(), Botan::Lion::decrypt_n(), Botan::TripleDES::decrypt_n(), Botan::Camellia_192::decrypt_n(), Botan::Camellia_256::decrypt_n(), Botan::GOST_28147_89::decrypt_n(), Botan::AES_192::decrypt_n(), Botan::AES_256::decrypt_n(), Botan::IDEA::encrypt_n(), Botan::DES::encrypt_n(), Botan::SEED::encrypt_n(), Botan::XTEA::encrypt_n(), Botan::CAST_128::encrypt_n(), Botan::AES_128::encrypt_n(), Botan::MISTY1::encrypt_n(), Botan::CAST_256::encrypt_n(), Botan::SHACAL2::encrypt_n(), Botan::Twofish::encrypt_n(), Botan::KASUMI::encrypt_n(), Botan::SM4::encrypt_n(), Botan::Noekeon::encrypt_n(), Botan::Blowfish::encrypt_n(), Botan::DESX::encrypt_n(), Botan::Threefish_512::encrypt_n(), Botan::Camellia_128::encrypt_n(), Botan::Serpent::encrypt_n(), Botan::Lion::encrypt_n(), Botan::Camellia_192::encrypt_n(), Botan::TripleDES::encrypt_n(), Botan::Camellia_256::encrypt_n(), Botan::GOST_28147_89::encrypt_n(), Botan::AES_192::encrypt_n(), Botan::AES_256::encrypt_n(), Botan::Salsa20::seek(), Botan::CTR_BE::seek(), Botan::ChaCha::seek(), and Botan::GHASH::update_associated_data().

         {
         if(cond == false)
            throw Key_Not_Set(name());
         }

---

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

• src/lib/stream/shake_cipher/shake_cipher.h
• src/lib/stream/shake_cipher/shake_cipher.cpp