Botan::Buffered_Computation Class Reference

#include <buf_comp.h>

Inheritance diagram for Botan::Buffered_Computation:

Public Member Functions
SecureVector< byte >	final ()
void	final (byte out[])
virtual size_t	output_length () const =0
SecureVector< byte >	process (const byte in[], size_t length)
SecureVector< byte >	process (const MemoryRegion< byte > &in)
SecureVector< byte >	process (const std::string &in)
void	update (byte in)
void	update (const byte in[], size_t length)
void	update (const MemoryRegion< byte > &in)
void	update (const std::string &str)
template<typename T>
void	update_be (const T in)
virtual	~Buffered_Computation ()

Detailed Description

This class represents any kind of computation which uses an internal state, such as hash functions or MACs

Definition at line 20 of file buf_comp.h.

Constructor & Destructor Documentation

~Buffered_Computation()

virtual Botan::Buffered_Computation::~Buffered_Computation ( )

inlinevirtual

Definition at line 131 of file buf_comp.h.

{}

Member Function Documentation

final() [1/2]

SecureVector< byte > Botan::Buffered_Computation::final ( )

inline

Complete the computation and retrieve the final result.

Returns

SecureVector holding the result

Definition at line 87 of file buf_comp.h.

         {
         SecureVector<byte> output(output_length());
         final_result(&output[0]);
         return output;
         }

References output_length().

final() [2/2]

void Botan::Buffered_Computation::final ( byte out[] )

inline

Complete the computation and retrieve the final result.

Parameters

out	The byte array to be filled with the result. Must be of length output_length()

Definition at line 80 of file buf_comp.h.

{ final_result(out); }

Referenced by Botan::X942_PRF::derive(), Botan::HandshakeHash::final(), and Botan::HandshakeHash::final_ssl3().

output_length()

virtual size_t Botan::Buffered_Computation::output_length ( ) const

pure virtual

Returns

length of the output of this function in bytes

Implemented in Botan::Adler32, Botan::ANSI_X919_MAC, Botan::BMW_512, Botan::CBC_MAC, Botan::CMAC, Botan::Comb4P, Botan::CRC24, Botan::CRC32, Botan::GOST_34_11, Botan::HAS_160, Botan::HMAC, Botan::Keccak_1600, Botan::MD2, Botan::MD4, Botan::MD5, Botan::Parallel, Botan::RIPEMD_128, Botan::RIPEMD_160, Botan::SHA_160, Botan::SHA_224, Botan::SHA_256, Botan::SHA_384, Botan::SHA_512, Botan::Skein_512, Botan::SSL3_MAC, Botan::Tiger, and Botan::Whirlpool.

Referenced by Botan::choose_sig_format(), Botan::EAX_Base::EAX_Base(), final(), and Botan::MDx_HashFunction::write_count().

process() [1/3]

SecureVector< byte > Botan::Buffered_Computation::process ( const byte in[], size_t length )

inline

Update and finalize computation. Does the same as calling update() and final() consecutively.

Parameters

in	the input to process as a byte array
length	the length of the byte array

Returns

the result of the call to final()

Definition at line 101 of file buf_comp.h.

         {
         add_data(in, length);
         return final();
         }

Referenced by Botan::EME1::EME1(), Botan::RTSS_Share::split(), and Botan::Cert_Extension::Subject_Key_ID::Subject_Key_ID().

process() [2/3]

SecureVector< byte > Botan::Buffered_Computation::process ( const MemoryRegion< byte > & in )

inline

Update and finalize computation. Does the same as calling update() and final() consecutively.

Parameters

in	the input to process

Returns

the result of the call to final()

Definition at line 113 of file buf_comp.h.

         {
         add_data(&in[0], in.size());
         return final();
         }

References Botan::MemoryRegion< T >::size().

process() [3/3]

SecureVector< byte > Botan::Buffered_Computation::process ( const std::string & in )

inline

Update and finalize computation. Does the same as calling update() and final() consecutively.

Parameters

in	the input to process as a string

Returns

the result of the call to final()

Definition at line 125 of file buf_comp.h.

         {
         update(in);
         return final();
         }

References update().

update() [1/4]

void Botan::Buffered_Computation::update ( byte in )

inline

Process a single byte.

Parameters

in	the byte to process

Definition at line 72 of file buf_comp.h.

{ add_data(&in, 1); }

update() [2/4]

void Botan::Buffered_Computation::update ( const byte in[], size_t length )

inline

Add new input to process.

Parameters

in	the input to process as a byte array
length	of param in in bytes

Definition at line 33 of file buf_comp.h.

{ add_data(in, length); }

Referenced by Botan::X942_PRF::derive(), Botan::HandshakeHash::final(), Botan::HandshakeHash::final_ssl3(), process(), and Botan::EAX_Base::start_msg().

update() [3/4]

void Botan::Buffered_Computation::update ( const MemoryRegion< byte > & in )

inline

Add new input to process.

Parameters

in	the input to process as a MemoryRegion

Definition at line 39 of file buf_comp.h.

         {
         add_data(&in[0], in.size());
         }

References Botan::MemoryRegion< T >::size().

update() [4/4]

void Botan::Buffered_Computation::update ( const std::string & str )

inline

Add new input to process.

Parameters

str	the input to process as a std::string. Will be interpreted as a byte array based on the strings encoding.

Definition at line 63 of file buf_comp.h.

         {
         add_data(reinterpret_cast<const byte*>(str.data()), str.size());
         }

update_be()

template<typename T>

void Botan::Buffered_Computation::update_be ( const T in )

inline

Add an integer in big-endian order

Parameters

in

the value

Definition at line 48 of file buf_comp.h.

         {
         for(size_t i = 0; i != sizeof(T); ++i)
            {
            byte b = get_byte(i, in);
            add_data(&b, 1);
            }
         }

References Botan::get_byte().

---

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

• src/algo_base/buf_comp.h