Botan::Salsa20 Class Reference

#include <salsa20.h>

Inheritance diagram for Botan::Salsa20:

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
	Salsa20 ()
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)
bool	valid_iv_length (size_t iv_len) const
bool	valid_keylength (size_t length) const

Detailed Description

DJB's Salsa20 (and XSalsa20)

Definition at line 18 of file salsa20.h.

Constructor & Destructor Documentation

Salsa20()

Botan::Salsa20::Salsa20 ( )

inline

Definition at line 37 of file salsa20.h.

: state(16), buffer(64), position(0) {}

Referenced by clone().

Member Function Documentation

cipher()

void Botan::Salsa20::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 104 of file salsa20.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);
      salsa20(&buffer[0], &state[0]);
 
      ++state[8];
      if(!state[8]) // if overflow in state[8]
         ++state[9]; // carry to state[9]
 
      position = 0;
      }
 
   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::Salsa20::clear ( )

virtual

Zeroize internal state

Implements Botan::Algorithm.

Definition at line 233 of file salsa20.cpp.

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

References Botan::zeroise().

clone()

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

inlinevirtual

Get a new object representing the same algorithm as *this

Implements Botan::StreamCipher.

Definition at line 35 of file salsa20.h.

{ return new Salsa20; }

References Salsa20().

key_spec()

Key_Length_Specification Botan::Salsa20::key_spec ( ) const

inlinevirtual

Returns

object describing limits on key size

Implements Botan::SymmetricAlgorithm.

Definition at line 28 of file salsa20.h.

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

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

virtual

Returns

name of this algorithm

Implements Botan::Algorithm.

Definition at line 225 of file salsa20.cpp.

   {
   return "Salsa20";
   }

Referenced by set_iv().

set_iv()

void Botan::Salsa20::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 177 of file salsa20.cpp.

   {
   if(!valid_iv_length(length))
      throw Invalid_IV_Length(name(), length);
 
   if(length == 8)
      {
      // Salsa20
      state[6] = load_le<u32bit>(iv, 0);
      state[7] = load_le<u32bit>(iv, 1);
      }
   else
      {
      // XSalsa20
      state[6] = load_le<u32bit>(iv, 0);
      state[7] = load_le<u32bit>(iv, 1);
      state[8] = load_le<u32bit>(iv, 2);
      state[9] = load_le<u32bit>(iv, 3);
 
      SecureVector<u32bit> hsalsa(8);
      hsalsa20(&hsalsa[0], &state[0]);
 
      state[ 1] = hsalsa[0];
      state[ 2] = hsalsa[1];
      state[ 3] = hsalsa[2];
      state[ 4] = hsalsa[3];
      state[ 6] = load_le<u32bit>(iv, 4);
      state[ 7] = load_le<u32bit>(iv, 5);
      state[11] = hsalsa[4];
      state[12] = hsalsa[5];
      state[13] = hsalsa[6];
      state[14] = hsalsa[7];
      }
 
   state[8] = 0;
   state[9] = 0;
 
   salsa20(&buffer[0], &state[0]);
   ++state[8];
   if(!state[8]) // if overflow in state[8]
      ++state[9]; // carry to state[9]
 
   position = 0;
   }

References Botan::Invalid_IV_Length::Invalid_IV_Length(), Botan::load_le(), name(), 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::Salsa20::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 25 of file salsa20.h.

         { return (iv_len == 8 || iv_len == 24); }

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