Botan::ARC4 Class Reference

#include <arc4.h>

Inheritance diagram for Botan::ARC4:

Public Member Functions
	ARC4 (size_t skip=0)
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
virtual void	set_iv (const byte iv[], size_t iv_len)
void	set_key (const byte key[], size_t length)
void	set_key (const SymmetricKey &key)
virtual bool	valid_iv_length (size_t iv_len) const
bool	valid_keylength (size_t length) const
	~ARC4 ()

Detailed Description

Alleged RC4

Definition at line 19 of file arc4.h.

Constructor & Destructor Documentation

ARC4()

Botan::ARC4::ARC4

(

size_t

skip = 0

)

Parameters

skip	skip this many initial bytes in the keystream

Definition at line 104 of file arc4.cpp.

                   : SKIP(s),
                       state(256),
                       buffer(DEFAULT_BUFFERSIZE)
   {
   clear();
   }

References clear().

Referenced by clone(), and Botan::Core_Engine::find_stream_cipher().

~ARC4()

Botan::ARC4::~ARC4 ( )

inline

Definition at line 39 of file arc4.h.

{ clear(); }

References clear().

Member Function Documentation

cipher()

void Botan::ARC4::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 17 of file arc4.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::ARC4::clear ( )

virtual

Zeroize internal state

Implements Botan::Algorithm.

Definition at line 94 of file arc4.cpp.

   {
   zeroise(state);
   zeroise(buffer);
   position = X = Y = 0;
   }

References Botan::zeroise().

Referenced by ARC4(), and ~ARC4().

clone()

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

inlinevirtual

Get a new object representing the same algorithm as *this

Implements Botan::StreamCipher.

Definition at line 27 of file arc4.h.

{ return new ARC4(SKIP); }

References ARC4().

key_spec()

Key_Length_Specification Botan::ARC4::key_spec ( ) const

inlinevirtual

Returns

object describing limits on key size

Implements Botan::SymmetricAlgorithm.

Definition at line 29 of file arc4.h.

         {
         return Key_Length_Specification(1, 256);
         }

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::ARC4::name ( ) const

virtual

Returns

name of this algorithm

Implements Botan::Algorithm.

Definition at line 84 of file arc4.cpp.

   {
   if(SKIP == 0)   return "ARC4";
   if(SKIP == 256) return "MARK-4";
   else            return "RC4_skip(" + to_string(SKIP) + ")";
   }

References Botan::to_string().

set_iv()

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

virtualinherited

Resync the cipher using the IV

Parameters

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

Reimplemented in Botan::CTR_BE, Botan::OFB, Botan::Salsa20, Botan::Turing, and Botan::WiderWake_41_BE.

Definition at line 12 of file stream_cipher.cpp.

   {
   if(iv_len)
      throw Invalid_Argument("The stream cipher " + name() +
                             " does not support resyncronization");
   }

References Botan::Algorithm::name().

Referenced by Botan::EAX_Base::set_iv().

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::StreamCipher::valid_iv_length ( size_t iv_len ) const

virtualinherited

Parameters

iv_len

the length of the IV in bytes

Returns

if the length is valid for this algorithm

Reimplemented in Botan::CTR_BE, Botan::OFB, Botan::Salsa20, Botan::Turing, and Botan::WiderWake_41_BE.

Definition at line 19 of file stream_cipher.cpp.

   {
   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 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/arc4/arc4.h
• src/stream/arc4/arc4.cpp