#include <cast256.h>

Inheritance diagram for Botan::CAST_256:

Public Types
enum

Public Member Functions
size_t	block_size () const
	CAST_256 ()
void	clear ()
BlockCipher *	clone () const
void	decrypt (byte block[]) const
void	decrypt (const byte in[], byte out[]) const
void	decrypt_n (const byte in[], byte out[], size_t blocks) const
void	encrypt (byte block[]) const
void	encrypt (const byte in[], byte out[]) const
void	encrypt_n (const byte in[], byte out[], size_t blocks) const
Key_Length_Specification	key_spec () const
size_t	maximum_keylength () const
size_t	minimum_keylength () const
std::string	name () const
size_t	parallel_bytes () const
virtual size_t	parallelism () const
void	set_key (const byte key[], size_t length)
void	set_key (const SymmetricKey &key)
bool	valid_keylength (size_t length) const

Detailed Description

CAST-256

Definition at line 18 of file cast256.h.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

inherited

Definition at line 107 of file block_cipher.h.

107{ BLOCK_SIZE = BS };

Botan::Block_Cipher_Fixed_Params

Definition block_cipher.h:105

Constructor & Destructor Documentation

◆ CAST_256()

Botan::CAST_256::CAST_256 ( )

inline

Definition at line 28 of file cast256.h.

28: MK(48), RK(48) {}

Referenced by clone().

Member Function Documentation

◆ block_size()

size_t Botan::Block_Cipher_Fixed_Params< BS, KMIN, KMAX, KMOD >::block_size ( ) const

inlinevirtualinherited

Returns: block size of this algorithm

Implements Botan::BlockCipher.

Definition at line 108 of file block_cipher.h.

108{ return BS; }

◆ clear()

void Botan::CAST_256::clear ( )

inlinevirtual

Zeroize internal state

Implements Botan::Algorithm.

Definition at line 24 of file cast256.h.

24{ zeroise(MK); zeroise(RK); }

Botan::zeroise

void zeroise(MemoryRegion< T > &vec)

Definition secmem.h:428

References Botan::zeroise().

◆ clone()

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

inlinevirtual

Get a new object representing the same algorithm as *this

Implements Botan::BlockCipher.

Definition at line 26 of file cast256.h.

26{ return new CAST_256; }

Botan::CAST_256::CAST_256

CAST_256()

Definition cast256.h:28

References CAST_256().

◆ decrypt() [1/2]

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 74 of file block_cipher.h.

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

◆ decrypt() [2/2]

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

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

◆ decrypt_n()

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

virtual

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 95 of file cast256.cpp.

   {
   for(size_t i = 0; i != blocks; ++i)
      {
      u32bit A = load_be<u32bit>(in, 0);
      u32bit B = load_be<u32bit>(in, 1);
      u32bit C = load_be<u32bit>(in, 2);
      u32bit D = load_be<u32bit>(in, 3);
 
      round1(C, D, MK[44], RK[44]); round2(B, C, MK[45], RK[45]);
      round3(A, B, MK[46], RK[46]); round1(D, A, MK[47], RK[47]);
      round1(C, D, MK[40], RK[40]); round2(B, C, MK[41], RK[41]);
      round3(A, B, MK[42], RK[42]); round1(D, A, MK[43], RK[43]);
      round1(C, D, MK[36], RK[36]); round2(B, C, MK[37], RK[37]);
      round3(A, B, MK[38], RK[38]); round1(D, A, MK[39], RK[39]);
      round1(C, D, MK[32], RK[32]); round2(B, C, MK[33], RK[33]);
      round3(A, B, MK[34], RK[34]); round1(D, A, MK[35], RK[35]);
      round1(C, D, MK[28], RK[28]); round2(B, C, MK[29], RK[29]);
      round3(A, B, MK[30], RK[30]); round1(D, A, MK[31], RK[31]);
      round1(C, D, MK[24], RK[24]); round2(B, C, MK[25], RK[25]);
      round3(A, B, MK[26], RK[26]); round1(D, A, MK[27], RK[27]);
      round1(D, A, MK[23], RK[23]); round3(A, B, MK[22], RK[22]);
      round2(B, C, MK[21], RK[21]); round1(C, D, MK[20], RK[20]);
      round1(D, A, MK[19], RK[19]); round3(A, B, MK[18], RK[18]);
      round2(B, C, MK[17], RK[17]); round1(C, D, MK[16], RK[16]);
      round1(D, A, MK[15], RK[15]); round3(A, B, MK[14], RK[14]);
      round2(B, C, MK[13], RK[13]); round1(C, D, MK[12], RK[12]);
      round1(D, A, MK[11], RK[11]); round3(A, B, MK[10], RK[10]);
      round2(B, C, MK[ 9], RK[ 9]); round1(C, D, MK[ 8], RK[ 8]);
      round1(D, A, MK[ 7], RK[ 7]); round3(A, B, MK[ 6], RK[ 6]);
      round2(B, C, MK[ 5], RK[ 5]); round1(C, D, MK[ 4], RK[ 4]);
      round1(D, A, MK[ 3], RK[ 3]); round3(A, B, MK[ 2], RK[ 2]);
      round2(B, C, MK[ 1], RK[ 1]); round1(C, D, MK[ 0], RK[ 0]);
 
      store_be(out, A, B, C, D);
 
      in += BLOCK_SIZE;
      out += BLOCK_SIZE;
      }
   }

References Botan::Block_Cipher_Fixed_Params< 16, 4, 32, 4 >::BLOCK_SIZE, Botan::load_be(), and Botan::store_be().

◆ encrypt() [1/2]

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 66 of file block_cipher.h.

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

◆ encrypt() [2/2]

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 47 of file block_cipher.h.

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

◆ encrypt_n()

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

virtual

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 51 of file cast256.cpp.

   {
   for(size_t i = 0; i != blocks; ++i)
      {
      u32bit A = load_be<u32bit>(in, 0);
      u32bit B = load_be<u32bit>(in, 1);
      u32bit C = load_be<u32bit>(in, 2);
      u32bit D = load_be<u32bit>(in, 3);
 
      round1(C, D, MK[ 0], RK[ 0]); round2(B, C, MK[ 1], RK[ 1]);
      round3(A, B, MK[ 2], RK[ 2]); round1(D, A, MK[ 3], RK[ 3]);
      round1(C, D, MK[ 4], RK[ 4]); round2(B, C, MK[ 5], RK[ 5]);
      round3(A, B, MK[ 6], RK[ 6]); round1(D, A, MK[ 7], RK[ 7]);
      round1(C, D, MK[ 8], RK[ 8]); round2(B, C, MK[ 9], RK[ 9]);
      round3(A, B, MK[10], RK[10]); round1(D, A, MK[11], RK[11]);
      round1(C, D, MK[12], RK[12]); round2(B, C, MK[13], RK[13]);
      round3(A, B, MK[14], RK[14]); round1(D, A, MK[15], RK[15]);
      round1(C, D, MK[16], RK[16]); round2(B, C, MK[17], RK[17]);
      round3(A, B, MK[18], RK[18]); round1(D, A, MK[19], RK[19]);
      round1(C, D, MK[20], RK[20]); round2(B, C, MK[21], RK[21]);
      round3(A, B, MK[22], RK[22]); round1(D, A, MK[23], RK[23]);
      round1(D, A, MK[27], RK[27]); round3(A, B, MK[26], RK[26]);
      round2(B, C, MK[25], RK[25]); round1(C, D, MK[24], RK[24]);
      round1(D, A, MK[31], RK[31]); round3(A, B, MK[30], RK[30]);
      round2(B, C, MK[29], RK[29]); round1(C, D, MK[28], RK[28]);
      round1(D, A, MK[35], RK[35]); round3(A, B, MK[34], RK[34]);
      round2(B, C, MK[33], RK[33]); round1(C, D, MK[32], RK[32]);
      round1(D, A, MK[39], RK[39]); round3(A, B, MK[38], RK[38]);
      round2(B, C, MK[37], RK[37]); round1(C, D, MK[36], RK[36]);
      round1(D, A, MK[43], RK[43]); round3(A, B, MK[42], RK[42]);
      round2(B, C, MK[41], RK[41]); round1(C, D, MK[40], RK[40]);
      round1(D, A, MK[47], RK[47]); round3(A, B, MK[46], RK[46]);
      round2(B, C, MK[45], RK[45]); round1(C, D, MK[44], RK[44]);
 
      store_be(out, A, B, C, D);
 
      in += BLOCK_SIZE;
      out += BLOCK_SIZE;
      }
   }

References Botan::Block_Cipher_Fixed_Params< 16, 4, 32, 4 >::BLOCK_SIZE, Botan::load_be(), and Botan::store_be().

◆ key_spec()

Key_Length_Specification Botan::Block_Cipher_Fixed_Params< BS, KMIN, KMAX, KMOD >::key_spec ( ) const

inlinevirtualinherited

Returns: object describing limits on key size

Implements Botan::SymmetricAlgorithm.

Definition at line 110 of file block_cipher.h.

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

◆ maximum_keylength()

size_t Botan::SymmetricAlgorithm::maximum_keylength ( ) const

inlineinherited

Returns: minimum allowed key length

Definition at line 33 of file sym_algo.h.

         {
         return key_spec().maximum_keylength();
         }

◆ minimum_keylength()

size_t Botan::SymmetricAlgorithm::minimum_keylength ( ) const

inlineinherited

Returns: maxmium allowed key length

Definition at line 41 of file sym_algo.h.

         {
         return key_spec().minimum_keylength();
         }

◆ name()

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

inlinevirtual

Returns: name of this algorithm

Implements Botan::Algorithm.

Definition at line 25 of file cast256.h.

25{ return "CAST-256"; }

◆ parallel_bytes()

size_t Botan::BlockCipher::parallel_bytes ( ) const

inlineinherited

Returns: prefererred parallelism of this cipher in bytes

Definition at line 35 of file block_cipher.h.

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

◆ parallelism()

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

inlinevirtualinherited

Returns: native parallelism of this cipher in blocks

Definition at line 30 of file block_cipher.h.

30{ return 1; }

◆ set_key() [1/2]

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

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

◆ set_key() [2/2]

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

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

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

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

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

src/block/cast/cast256.h
src/block/cast/cast256.cpp
src/block/cast/cast_tab.cpp

Public Types

Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ anonymous enum

Constructor & Destructor Documentation

◆ CAST_256()

Member Function Documentation

◆ block_size()

◆ clear()

◆ clone()

◆ decrypt() [1/2]

◆ decrypt() [2/2]

◆ decrypt_n()

◆ encrypt() [1/2]

◆ encrypt() [2/2]

◆ encrypt_n()

◆ key_spec()

◆ maximum_keylength()

◆ minimum_keylength()

◆ name()

◆ parallel_bytes()

◆ parallelism()

◆ set_key() [1/2]

◆ set_key() [2/2]

◆ valid_keylength()