Botan::Turing Class Reference

#include <turing.h>

Inheritance diagram for Botan::Turing:

Public Member Functions
void	cipher (const byte in[], byte out[], size_t length)
void	cipher1 (byte buf[], size_t len)
void	clear ()
StreamCipher *	clone () const
Key_Length_Specification	key_spec () const
size_t	maximum_keylength () const
size_t	minimum_keylength () const
std::string	name () const
void	set_iv (const byte iv[], size_t iv_length)
void	set_key (const byte key[], size_t length)
void	set_key (const SymmetricKey &key)
	Turing ()
bool	valid_iv_length (size_t iv_len) const
bool	valid_keylength (size_t length) const

Detailed Description

Turing

Definition at line 18 of file turing.h.

Constructor & Destructor Documentation

Turing()

Botan::Turing::Turing ( )

inline

Definition at line 36 of file turing.h.

               : S0(256), S1(256), S2(256), S3(256),
                 R(17), buffer(340), position(0) {}

Referenced by clone().

Member Function Documentation

cipher()

void Botan::Turing::cipher ( const byte in[], byte out[], size_t len )

virtual

Encrypt or decrypt a message

Parameters

in	the plaintext
out	the byte array to hold the output, i.e. the ciphertext
len	the length of both in and out in bytes

Implements Botan::StreamCipher.

Definition at line 38 of file turing.cpp.

   {
   while(length >= buffer.size() - position)
      {
      xor_buf(out, in, &buffer[position], buffer.size() - position);
      length -= (buffer.size() - position);
      in += (buffer.size() - position);
      out += (buffer.size() - position);
      generate();
      }
   xor_buf(out, in, &buffer[position], length);
   position += length;
   }

References Botan::xor_buf().

cipher1()

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

inlineinherited

Encrypt or decrypt a message

Parameters

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

Definition at line 34 of file stream_cipher.h.

         { cipher(buf, buf, len); }

References cipher().

clear()

void Botan::Turing::clear ( )

virtual

Zeroize internal state

Implements Botan::Algorithm.

Definition at line 314 of file turing.cpp.

   {
   zeroise(S0);
   zeroise(S1);
   zeroise(S2);
   zeroise(S3);
 
   zeroise(buffer);
   position = 0;
   }

References Botan::zeroise().

clone()

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

inlinevirtual

Get a new object representing the same algorithm as *this

Implements Botan::StreamCipher.

Definition at line 34 of file turing.h.

{ return new Turing; }

References Turing().

key_spec()

Key_Length_Specification Botan::Turing::key_spec ( ) const

inlinevirtual

Returns

object describing limits on key size

Implements Botan::SymmetricAlgorithm.

Definition at line 27 of file turing.h.

         {
         return Key_Length_Specification(4, 32, 4);
         }

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();
         }

References key_spec().

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();
         }

References key_spec().

name()

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

inlinevirtual

Returns

name of this algorithm

Implements Botan::Algorithm.

Definition at line 33 of file turing.h.

{ return "Turing"; }

Referenced by set_iv().

set_iv()

void Botan::Turing::set_iv ( const byte iv[], size_t iv_len )

virtual

Resync the cipher using the IV

Parameters

iv	the initialization vector
iv_len	the length of the IV in bytes

Reimplemented from Botan::StreamCipher.

Definition at line 282 of file turing.cpp.

   {
   if(!valid_iv_length(length))
      throw Invalid_IV_Length(name(), length);
 
   SecureVector<u32bit> IV(length / 4);
   for(size_t i = 0; i != length; ++i)
      IV[i/4] = (IV[i/4] << 8) + iv[i];
 
   for(size_t i = 0; i != IV.size(); ++i)
      R[i] = IV[i] = fixedS(IV[i]);
 
   for(size_t i = 0; i != K.size(); ++i)
      R[i+IV.size()] = K[i];
 
   R[K.size() + IV.size()] = (0x010203 << 8) | (K.size() << 4) | IV.size();
 
   for(size_t i = K.size() + IV.size() + 1; i != 17; ++i)
      {
      const u32bit W = R[i-K.size()-IV.size()-1] + R[i-1];
      R[i] = S0[get_byte(0, W)] ^ S1[get_byte(1, W)] ^
             S2[get_byte(2, W)] ^ S3[get_byte(3, W)];
      }
 
   PHT(R);
 
   generate();
   }

References Botan::get_byte(), Botan::Invalid_IV_Length::Invalid_IV_Length(), name(), Botan::MemoryRegion< T >::size(), and valid_iv_length().

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);
         }

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

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.

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

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

Referenced by Botan::aont_package(), Botan::aont_unpackage(), Botan::MAC_Filter::MAC_Filter(), Botan::MAC_Filter::MAC_Filter(), Botan::EAX_Base::set_key(), set_key(), Botan::Record_Reader::set_keys(), Botan::Record_Writer::set_keys(), Botan::StreamCipher_Filter::StreamCipher_Filter(), and Botan::StreamCipher_Filter::StreamCipher_Filter().

valid_iv_length()

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

inlinevirtual

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 24 of file turing.h.

         { return (iv_len % 4 == 0 && iv_len <= 16); }

Referenced by set_iv().

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);
         }

References key_spec().

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

---

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

• src/stream/turing/turing.h
• src/stream/turing/tur_tab.cpp
• src/stream/turing/turing.cpp