Botan::Key_Length_Specification Class Reference

#include <sym_algo.h>

Public Member Functions
	Key_Length_Specification (size_t keylen)
	Key_Length_Specification (size_t min_k, size_t max_k, size_t k_mod=1)
size_t	keylength_multiple () const
size_t	maximum_keylength () const
size_t	minimum_keylength () const
Key_Length_Specification	multiple (size_t n) const
bool	valid_keylength (size_t length) const

Detailed Description

Represents the length requirements on an algorithm key

Definition at line 22 of file sym_algo.h.

Constructor & Destructor Documentation

Key_Length_Specification() [1/2]

Botan::Key_Length_Specification::Key_Length_Specification ( size_t keylen )

inlineexplicit

Constructor for fixed length keys

Parameters

keylen

the supported key length

Definition at line 28 of file sym_algo.h.

: m_min_keylen(keylen), m_max_keylen(keylen), m_keylen_mod(1) {}

Referenced by Botan::commoncrypto_opts_from_algo_name(), Botan::ANSI_X919_MAC::key_spec(), Botan::Ascon_AEAD128_Mode::key_spec(), Botan::BLAKE2b::key_spec(), Botan::Block_Cipher_Fixed_Params< BS, KMIN, KMAX, KMOD, BaseClass >::key_spec(), Botan::Cascade_Cipher::key_spec(), Botan::ChaCha20Poly1305_Mode::key_spec(), Botan::ChaCha::key_spec(), Botan::GHASH::key_spec(), Botan::HMAC::key_spec(), Botan::KMAC::key_spec(), Botan::Lion::key_spec(), Botan::Poly1305::key_spec(), Botan::RC4::key_spec(), Botan::Salsa20::key_spec(), Botan::SHAKE_Cipher::key_spec(), Botan::SipHash::key_spec(), Botan::TLS::TLS_CBC_HMAC_AEAD_Mode::key_spec(), Botan::TLS::TLS_NULL_HMAC_AEAD_Mode::key_spec(), and multiple().

Key_Length_Specification() [2/2]

Botan::Key_Length_Specification::Key_Length_Specification ( size_t min_k, size_t max_k, size_t k_mod = 1 )

inline

Constructor for variable length keys

Parameters

min_k	the smallest supported key length
max_k	the largest supported key length
k_mod	the number of bytes the key must be a multiple of

Definition at line 36 of file sym_algo.h.

                                                                           :
            m_min_keylen(min_k), m_max_keylen(max_k > 0 ? max_k : min_k), m_keylen_mod(k_mod) {}

Member Function Documentation

keylength_multiple()

size_t Botan::Key_Length_Specification::keylength_multiple ( ) const

inline

Returns

key length multiple in bytes

Definition at line 60 of file sym_algo.h.

{ return m_keylen_mod; }

maximum_keylength()

size_t Botan::Key_Length_Specification::maximum_keylength ( ) const

inline

Returns

maximum key length in bytes

Definition at line 55 of file sym_algo.h.

{ return m_max_keylen; }

minimum_keylength()

size_t Botan::Key_Length_Specification::minimum_keylength ( ) const

inline

Returns

minimum key length in bytes

Definition at line 50 of file sym_algo.h.

{ return m_min_keylen; }

multiple()

Key_Length_Specification Botan::Key_Length_Specification::multiple ( size_t n ) const

inline

Definition at line 67 of file sym_algo.h.

                                                        {
         return Key_Length_Specification(n * m_min_keylen, n * m_max_keylen, n * m_keylen_mod);
      }

References Key_Length_Specification().

Referenced by Botan::SIV_Mode::key_spec(), and Botan::XTS_Mode::key_spec().

valid_keylength()

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

inline

Parameters

length

is a key length in bytes

Returns

true iff this length is a valid length for this algo

Definition at line 43 of file sym_algo.h.

                                                {
         return ((length >= m_min_keylen) && (length <= m_max_keylen) && (length % m_keylen_mod == 0));
      }

---

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

• src/lib/base/sym_algo.h