#include <symkey.h>

Public Member Functions
std::string	as_string () const
const byte *	begin () const
secure_vector< byte >	bits_of () const
const byte *	end () const
size_t	length () const
	OctetString (const std::string &str="")
	OctetString (class RandomNumberGenerator &rng, size_t len)
	OctetString (const byte in[], size_t len)
	OctetString (const secure_vector< byte > &in)
	OctetString (const std::vector< byte > &in)
OctetString &	operator^= (const OctetString &other)
void	set_odd_parity ()

Detailed Description

Octet String

Definition at line 19 of file symkey.h.

Constructor & Destructor Documentation

Botan::OctetString::OctetString ( const std::string & str = "" )

Create a new OctetString

Parameters:

str	is a hex encoded string

Definition at line 28 of file symkey.cpp.

References Botan::hex_decode().

   {
   bits.resize(1 + hex_string.length() / 2);
   bits.resize(hex_decode(&bits[0], hex_string));
   }

Botan::OctetString::OctetString	(	class RandomNumberGenerator &	rng,
		size_t	len
	)

Create a new random OctetString

Parameters:

rng	is a random number generator
len	is the desired length in bytes

Definition at line 19 of file symkey.cpp.

References Botan::RandomNumberGenerator::random_vec().

   {
   bits = rng.random_vec(length);
   }

Botan::OctetString::OctetString	(	const byte	in[],
		size_t	len
	)

Create a new OctetString

Parameters:

in	is an array
len	is the length of in in bytes

Definition at line 37 of file symkey.cpp.

   {
   bits.assign(in, in + n);
   }

Botan::OctetString::OctetString ( const secure_vector< byte > & in ) [inline]

Create a new OctetString

Parameters:

in	a bytestring

Definition at line 83 of file symkey.h.

: bits(in) {}

Botan::OctetString::OctetString ( const std::vector< byte > & in ) [inline]

Create a new OctetString

Parameters:

in	a bytestring

Definition at line 89 of file symkey.h.

: bits(in.begin(), in.end()) {}

Member Function Documentation

std::string Botan::OctetString::as_string ( ) const

Returns:: this encoded as hex

Definition at line 78 of file symkey.cpp.

References Botan::hex_encode().

   {
   return hex_encode(&bits[0], bits.size());
   }

const byte* Botan::OctetString::begin ( ) const [inline]

Returns:: start of this string

Definition at line 35 of file symkey.h.

Referenced by Botan::aont_package(), Botan::CryptoBox::decrypt(), Botan::CryptoBox::encrypt(), Botan::operator^(), operator^=(), Botan::StreamCipher_Filter::set_iv(), Botan::SymmetricAlgorithm::set_key(), and Botan::Keyed_Transform::set_key().

{ return &bits[0]; }

secure_vector<byte> Botan::OctetString::bits_of ( ) const [inline]

Returns:: this object as a secure_vector<byte>

Definition at line 30 of file symkey.h.

Referenced by botan_pk_op_key_agreement(), Botan::check_passhash9(), Botan::TLS::Client_Key_Exchange::Client_Key_Exchange(), Botan::TLS::Connection_Cipher_State::Connection_Cipher_State(), Botan::operator+(), and Botan::operator==().

{ return bits; }

const byte* Botan::OctetString::end ( ) const [inline]

Returns:: end of this string

Definition at line 40 of file symkey.h.

{ return begin() + bits.size(); }

size_t Botan::OctetString::length ( ) const [inline]

Returns:: size of this octet string in bytes

Definition at line 25 of file symkey.h.

Referenced by Botan::TLS::Client_Key_Exchange::Client_Key_Exchange(), Botan::TLS::Connection_Cipher_State::Connection_Cipher_State(), Botan::get_cipher(), Botan::operator^(), operator^=(), Botan::rfc3394_keyunwrap(), Botan::rfc3394_keywrap(), Botan::Keyed_Filter::set_iv(), Botan::StreamCipher_Filter::set_iv(), Botan::Transform_Filter::set_key(), Botan::SymmetricAlgorithm::set_key(), and Botan::Keyed_Transform::set_key().

{ return bits.size(); }

OctetString & Botan::OctetString::operator^= ( const OctetString & other )

XOR the contents of another octet string into this one

Parameters:

other octet string

Returns:: reference to this

Definition at line 86 of file symkey.cpp.

References begin(), length(), Botan::xor_buf(), and Botan::zeroise().

   {
   if(&k == this) { zeroise(bits); return (*this); }
   xor_buf(&bits[0], k.begin(), std::min(length(), k.length()));
   return (*this);
   }

void Botan::OctetString::set_odd_parity ( )

Force to have odd parity

Definition at line 45 of file symkey.cpp.

   {
   const byte ODD_PARITY[256] = {
      0x01, 0x01, 0x02, 0x02, 0x04, 0x04, 0x07, 0x07, 0x08, 0x08, 0x0B, 0x0B,
      0x0D, 0x0D, 0x0E, 0x0E, 0x10, 0x10, 0x13, 0x13, 0x15, 0x15, 0x16, 0x16,
      0x19, 0x19, 0x1A, 0x1A, 0x1C, 0x1C, 0x1F, 0x1F, 0x20, 0x20, 0x23, 0x23,
      0x25, 0x25, 0x26, 0x26, 0x29, 0x29, 0x2A, 0x2A, 0x2C, 0x2C, 0x2F, 0x2F,
      0x31, 0x31, 0x32, 0x32, 0x34, 0x34, 0x37, 0x37, 0x38, 0x38, 0x3B, 0x3B,
      0x3D, 0x3D, 0x3E, 0x3E, 0x40, 0x40, 0x43, 0x43, 0x45, 0x45, 0x46, 0x46,
      0x49, 0x49, 0x4A, 0x4A, 0x4C, 0x4C, 0x4F, 0x4F, 0x51, 0x51, 0x52, 0x52,
      0x54, 0x54, 0x57, 0x57, 0x58, 0x58, 0x5B, 0x5B, 0x5D, 0x5D, 0x5E, 0x5E,
      0x61, 0x61, 0x62, 0x62, 0x64, 0x64, 0x67, 0x67, 0x68, 0x68, 0x6B, 0x6B,
      0x6D, 0x6D, 0x6E, 0x6E, 0x70, 0x70, 0x73, 0x73, 0x75, 0x75, 0x76, 0x76,
      0x79, 0x79, 0x7A, 0x7A, 0x7C, 0x7C, 0x7F, 0x7F, 0x80, 0x80, 0x83, 0x83,
      0x85, 0x85, 0x86, 0x86, 0x89, 0x89, 0x8A, 0x8A, 0x8C, 0x8C, 0x8F, 0x8F,
      0x91, 0x91, 0x92, 0x92, 0x94, 0x94, 0x97, 0x97, 0x98, 0x98, 0x9B, 0x9B,
      0x9D, 0x9D, 0x9E, 0x9E, 0xA1, 0xA1, 0xA2, 0xA2, 0xA4, 0xA4, 0xA7, 0xA7,
      0xA8, 0xA8, 0xAB, 0xAB, 0xAD, 0xAD, 0xAE, 0xAE, 0xB0, 0xB0, 0xB3, 0xB3,
      0xB5, 0xB5, 0xB6, 0xB6, 0xB9, 0xB9, 0xBA, 0xBA, 0xBC, 0xBC, 0xBF, 0xBF,
      0xC1, 0xC1, 0xC2, 0xC2, 0xC4, 0xC4, 0xC7, 0xC7, 0xC8, 0xC8, 0xCB, 0xCB,
      0xCD, 0xCD, 0xCE, 0xCE, 0xD0, 0xD0, 0xD3, 0xD3, 0xD5, 0xD5, 0xD6, 0xD6,
      0xD9, 0xD9, 0xDA, 0xDA, 0xDC, 0xDC, 0xDF, 0xDF, 0xE0, 0xE0, 0xE3, 0xE3,
      0xE5, 0xE5, 0xE6, 0xE6, 0xE9, 0xE9, 0xEA, 0xEA, 0xEC, 0xEC, 0xEF, 0xEF,
      0xF1, 0xF1, 0xF2, 0xF2, 0xF4, 0xF4, 0xF7, 0xF7, 0xF8, 0xF8, 0xFB, 0xFB,
      0xFD, 0xFD, 0xFE, 0xFE };

   for(size_t j = 0; j != bits.size(); ++j)
      bits[j] = ODD_PARITY[bits[j]];
   }

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

src/lib/base/symkey.h
src/lib/base/symkey.cpp

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation