#include <gost_28147.h>

Inheritance diagram for Botan::GOST_28147_89:

Public Types
enum

typedef SCAN_Name	Spec

Public Member Functions
size_t	block_size () const override

void	clear () override

BlockCipher *	clone () const override

void	decrypt (const byte in[], byte out[]) const

void	decrypt (byte block[]) const

template<typename Alloc >
void	decrypt (std::vector< byte, Alloc > &block) const

template<typename Alloc , typename Alloc2 >
void	decrypt (const std::vector< byte, Alloc > &in, std::vector< byte, Alloc2 > &out) const

void	decrypt_n (const byte in[], byte out[], size_t blocks) const override

void	encrypt (const byte in[], byte out[]) const

void	encrypt (byte block[]) const

template<typename Alloc >
void	encrypt (std::vector< byte, Alloc > &block) const

template<typename Alloc , typename Alloc2 >
void	encrypt (const std::vector< byte, Alloc > &in, std::vector< byte, Alloc2 > &out) const

void	encrypt_n (const byte in[], byte out[], size_t blocks) const override

	GOST_28147_89 (const GOST_28147_89_Params &params)

Key_Length_Specification	key_spec () const override

size_t	maximum_keylength () const

size_t	minimum_keylength () const

std::string	name () const override

size_t	parallel_bytes () const

virtual size_t	parallelism () const

void	set_key (const SymmetricKey &key)

template<typename Alloc >
void	set_key (const std::vector< byte, Alloc > &key)

void	set_key (const byte key[], size_t length)

bool	valid_keylength (size_t length) const

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

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

Detailed Description

GOST 28147-89

Definition at line 52 of file gost_28147.h.

Member Typedef Documentation

typedef SCAN_Name Botan::BlockCipher::Spec

inherited

Definition at line 22 of file block_cipher.h.

Member Enumeration Documentation

anonymous enum

inherited

Definition at line 168 of file block_cipher.h.

168 { BLOCK_SIZE = BS };

Botan::Block_Cipher_Fixed_Params< 8, 32 >::BLOCK_SIZE

Definition: block_cipher.h:168

Constructor & Destructor Documentation

Botan::GOST_28147_89::GOST_28147_89 ( const GOST_28147_89_Params & params )

explicit

Parameters

params the sbox parameters to use

Definition at line 53 of file gost_28147.cpp.

References Botan::rotate_left(), and Botan::GOST_28147_89_Params::sbox_entry().

                                                               : m_SBOX(1024)
    {
    // Convert the parallel 4x4 sboxes into larger word-based sboxes
    for(size_t i = 0; i != 4; ++i)
       for(size_t j = 0; j != 256; ++j)
          {
          const u32bit T = (param.sbox_entry(2*i  , j % 16)) |
                           (param.sbox_entry(2*i+1, j / 16) << 4);
          m_SBOX[256*i+j] = rotate_left(T, (11+8*i) % 32);
          }
    }

Member Function Documentation

size_t Botan::Block_Cipher_Fixed_Params< BS, KMIN, 0 , 1 >::block_size ( ) const

inlineoverridevirtualinherited

Returns: block size of this algorithm

Implements Botan::BlockCipher.

Definition at line 169 of file block_cipher.h.

169 { return BS; }

void Botan::GOST_28147_89::clear ( )

overridevirtual

Implements Botan::SymmetricAlgorithm.

Definition at line 171 of file gost_28147.cpp.

References Botan::zap().

Referenced by Botan::GOST_34_11::clear().

    {
    zap(m_EK);
    }

BlockCipher* Botan::GOST_28147_89::clone ( ) const

inlineoverridevirtual

Returns: new object representing the same algorithm as *this

Implements Botan::BlockCipher.

Definition at line 61 of file gost_28147.h.

61 { return new GOST_28147_89(m_SBOX); }

Botan::GOST_28147_89::GOST_28147_89

GOST_28147_89(const GOST_28147_89_Params &params)

Definition: gost_28147.cpp:53

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

staticinherited

Create an instance based on a name Will return a null pointer if the algo/provider combination cannot be found. If provider is empty then best available is chosen.

Definition at line 150 of file block_cipher.cpp.

Referenced by Botan::TLS::Connection_Cipher_State::Connection_Cipher_State(), Botan::get_block_cipher(), Botan::Cascade_Cipher::make(), Botan::CBC_MAC::make(), Botan::CTR_BE::make(), Botan::OFB::make(), Botan::CMAC::make(), Botan::make_block_cipher(), Botan::make_block_cipher_mode(), Botan::make_block_cipher_mode_len(), Botan::make_block_cipher_mode_len2(), Botan::rfc3394_keyunwrap(), and Botan::rfc3394_keywrap().

    {
    return std::unique_ptr<BlockCipher>(make_a<BlockCipher>(Botan::BlockCipher::Spec(algo_spec), provider));
    }

void Botan::BlockCipher::decrypt	(	const byte	in[],
		byte	out[]
	)		const

inlineinherited

Decrypt a block.

Parameters

in	The ciphertext block to be decypted as a byte array. Must be of length block_size().
out	The byte array designated to hold the decrypted block. Must be of length block_size().

Definition at line 72 of file block_cipher.h.

Referenced by Botan::DESX::decrypt_n(), Botan::XTS_Decryption::finish(), Botan::CTS_Decryption::finish(), and Botan::TLS::write_record().

73 { decrypt_n(in, out, 1); }

Botan::BlockCipher::decrypt_n

virtual void decrypt_n(const byte in[], byte out[], size_t blocks) const =0

void Botan::BlockCipher::decrypt ( byte block[] ) const

inlineinherited

Decrypt a block.

Parameters

block the ciphertext block to be decrypted Must be of length block_size(). Will hold the result when the function has finished.

Definition at line 89 of file block_cipher.h.

89 { decrypt_n(block, block, 1); }

Botan::BlockCipher::decrypt_n

virtual void decrypt_n(const byte in[], byte out[], size_t blocks) const =0

template<typename Alloc >

void Botan::BlockCipher::decrypt ( std::vector< byte, Alloc > & block ) const

inlineinherited

Decrypt one or more blocks

Parameters

block the input/output buffer (multiple of block_size())

Definition at line 106 of file block_cipher.h.

          {
          return decrypt_n(block.data(), block.data(), block.size() / block_size());
          }

template<typename Alloc , typename Alloc2 >

void Botan::BlockCipher::decrypt	(	const std::vector< byte, Alloc > &	in,
		std::vector< byte, Alloc2 > &	out
	)		const

inlineinherited

Decrypt one or more blocks

Parameters

in	the input buffer (multiple of block_size())
out	the output buffer (same size as in)

Definition at line 129 of file block_cipher.h.

          {
          return decrypt_n(in.data(), out.data(), in.size() / block_size());
          }

void Botan::GOST_28147_89::decrypt_n	(	const byte	in[],
		byte	out[],
		size_t	blocks
	)		const

overridevirtual

Decrypt one or more blocks

Parameters

in	the input buffer (multiple of block_size())
out	the output buffer (same size as in)
blocks	the number of blocks to process

Implements Botan::BlockCipher.

Definition at line 135 of file gost_28147.cpp.

References Botan::Block_Cipher_Fixed_Params< 8, 32 >::BLOCK_SIZE, GOST_2ROUND, Botan::load_le< u32bit >(), and Botan::store_le().

    {
    for(size_t i = 0; i != blocks; ++i)
       {
       u32bit N1 = load_le<u32bit>(in, 0);
       u32bit N2 = load_le<u32bit>(in, 1);
 
       GOST_2ROUND(N1, N2, 0, 1);
       GOST_2ROUND(N1, N2, 2, 3);
       GOST_2ROUND(N1, N2, 4, 5);
       GOST_2ROUND(N1, N2, 6, 7);
 
       for(size_t j = 0; j != 3; ++j)
          {
          GOST_2ROUND(N1, N2, 7, 6);
          GOST_2ROUND(N1, N2, 5, 4);
          GOST_2ROUND(N1, N2, 3, 2);
          GOST_2ROUND(N1, N2, 1, 0);
          }
 
       store_le(out, N2, N1);
       in += BLOCK_SIZE;
       out += BLOCK_SIZE;
       }
    }

void Botan::BlockCipher::encrypt	(	const byte	in[],
		byte	out[]
	)		const

inlineinherited

Encrypt a block.

Parameters

in	The plaintext block to be encrypted as a byte array. Must be of length block_size().
out	The byte array designated to hold the encrypted block. Must be of length block_size().

Definition at line 62 of file block_cipher.h.

Referenced by Botan::aont_package(), Botan::aont_unpackage(), Botan::GOST_34_11::clear(), Botan::DESX::encrypt_n(), Botan::XTS_Encryption::finish(), Botan::CTS_Encryption::finish(), Botan::CFB_Encryption::update(), Botan::CBC_Encryption::update(), Botan::CFB_Decryption::update(), and Botan::CFB_Mode::valid_nonce_length().

63 { encrypt_n(in, out, 1); }

Botan::BlockCipher::encrypt_n

virtual void encrypt_n(const byte in[], byte out[], size_t blocks) const =0

void Botan::BlockCipher::encrypt ( byte block[] ) const

inlineinherited

Encrypt a block.

Parameters

block the plaintext block to be encrypted Must be of length block_size(). Will hold the result when the function has finished.

Definition at line 81 of file block_cipher.h.

81 { encrypt_n(block, block, 1); }

Botan::BlockCipher::encrypt_n

virtual void encrypt_n(const byte in[], byte out[], size_t blocks) const =0

template<typename Alloc >

void Botan::BlockCipher::encrypt ( std::vector< byte, Alloc > & block ) const

inlineinherited

Encrypt one or more blocks

Parameters

block the input/output buffer (multiple of block_size())

Definition at line 96 of file block_cipher.h.

          {
          return encrypt_n(block.data(), block.data(), block.size() / block_size());
          }

template<typename Alloc , typename Alloc2 >

void Botan::BlockCipher::encrypt	(	const std::vector< byte, Alloc > &	in,
		std::vector< byte, Alloc2 > &	out
	)		const

inlineinherited

Encrypt one or more blocks

Parameters

in	the input buffer (multiple of block_size())
out	the output buffer (same size as in)

Definition at line 117 of file block_cipher.h.

          {
          return encrypt_n(in.data(), out.data(), in.size() / block_size());
          }

void Botan::GOST_28147_89::encrypt_n	(	const byte	in[],
		byte	out[],
		size_t	blocks
	)		const

overridevirtual

Encrypt one or more blocks

Parameters

in	the input buffer (multiple of block_size())
out	the output buffer (same size as in)
blocks	the number of blocks to process

Implements Botan::BlockCipher.

Definition at line 105 of file gost_28147.cpp.

References Botan::Block_Cipher_Fixed_Params< 8, 32 >::BLOCK_SIZE, GOST_2ROUND, Botan::load_le< u32bit >(), and Botan::store_le().

    {
    for(size_t i = 0; i != blocks; ++i)
       {
       u32bit N1 = load_le<u32bit>(in, 0);
       u32bit N2 = load_le<u32bit>(in, 1);
 
       for(size_t j = 0; j != 3; ++j)
          {
          GOST_2ROUND(N1, N2, 0, 1);
          GOST_2ROUND(N1, N2, 2, 3);
          GOST_2ROUND(N1, N2, 4, 5);
          GOST_2ROUND(N1, N2, 6, 7);
          }
 
       GOST_2ROUND(N1, N2, 7, 6);
       GOST_2ROUND(N1, N2, 5, 4);
       GOST_2ROUND(N1, N2, 3, 2);
       GOST_2ROUND(N1, N2, 1, 0);
 
       store_le(out, N2, N1);
 
       in += BLOCK_SIZE;
       out += BLOCK_SIZE;
       }
    }

Key_Length_Specification Botan::Block_Cipher_Fixed_Params< BS, KMIN, 0 , 1 >::key_spec ( ) const

inlineoverridevirtualinherited

Returns: object describing limits on key size

Implements Botan::SymmetricAlgorithm.

Definition at line 171 of file block_cipher.h.

          {
          return Key_Length_Specification(KMIN, KMAX, KMOD);
          }

size_t Botan::SymmetricAlgorithm::maximum_keylength ( ) const

inlineinherited

Returns: minimum allowed key length

Definition at line 36 of file sym_algo.h.

          {
          return key_spec().maximum_keylength();
          }

size_t Botan::SymmetricAlgorithm::minimum_keylength ( ) const

inlineinherited

Returns: maxmium allowed key length

Definition at line 44 of file sym_algo.h.

          {
          return key_spec().minimum_keylength();
          }

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

overridevirtual

Implements Botan::SymmetricAlgorithm.

Definition at line 65 of file gost_28147.cpp.

    {
    /*
    'Guess' the right name for the sbox on the basis of the values.
    This would need to be updated if support for other sbox parameters
    is added. Preferably, we would just store the string value in the
    constructor, but can't break binary compat.
    */
    std::string sbox_name = "";
    if(m_SBOX[0] == 0x00072000)
       sbox_name = "R3411_94_TestParam";
    else if(m_SBOX[0] == 0x0002D000)
       sbox_name = "R3411_CryptoPro";
    else
       throw Internal_Error("GOST-28147 unrecognized sbox value");
 
    return "GOST-28147-89(" + sbox_name + ")";
    }

size_t Botan::BlockCipher::parallel_bytes ( ) const

inlineinherited

Returns: prefererred parallelism of this cipher in bytes

Definition at line 50 of file block_cipher.h.

Referenced by Botan::XTS_Mode::update_granularity(), Botan::CBC_Mode::update_granularity(), and Botan::ECB_Mode::update_granularity().

          {
          return parallelism() * block_size() * BOTAN_BLOCK_CIPHER_PAR_MULT;
          }

virtual size_t Botan::BlockCipher::parallelism ( ) const

inlinevirtualinherited

Returns: native parallelism of this cipher in blocks

Reimplemented in Botan::AES_256_NI, Botan::AES_192_NI, Botan::AES_128_NI, Botan::IDEA_SSE2, Botan::Noekeon_SIMD, Botan::Serpent_SIMD, and Botan::XTEA_SIMD.

Definition at line 45 of file block_cipher.h.

45 { return 1; }

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

staticinherited

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

Definition at line 156 of file block_cipher.cpp.

Referenced by Botan::TLS::Ciphersuite::by_id(), and Botan::get_block_cipher_providers().

    {
    return providers_of<BlockCipher>(BlockCipher::Spec(algo_spec));
    }

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

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

Referenced by Botan::aont_package(), Botan::aont_unpackage(), botan_mac_set_key(), Botan::GOST_34_11::clear(), Botan::DESX::decrypt_n(), Botan::pbkdf2(), and Botan::TLS_PRF::TLS_PRF().

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

template<typename Alloc >

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

inlineinherited

Definition at line 69 of file sym_algo.h.

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

void Botan::SymmetricAlgorithm::set_key	(	const byte	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 79 of file sym_algo.h.

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

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

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

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

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

src/lib/block/gost_28147/gost_28147.h
src/lib/block/gost_28147/gost_28147.cpp

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Typedef Documentation

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation