Botan::TLS::Stream_Handshake_IO Class Reference

#include <tls_handshake_io.h>

Inheritance diagram for Botan::TLS::Stream_Handshake_IO:

Public Types
typedef std::function< void(uint8_t, const std::vector< uint8_t > &)>	writer_fn

Public Member Functions
void	add_record (const uint8_t record[], size_t record_len, Record_Type type, uint64_t sequence_number) override
std::vector< uint8_t >	format (const std::vector< uint8_t > &handshake_msg, Handshake_Type handshake_type) const override
std::pair< Handshake_Type, std::vector< uint8_t > >	get_next_record (bool expecting_ccs) override
Protocol_Version	initial_record_version () const override
std::vector< uint8_t >	send (const Handshake_Message &msg) override
std::vector< uint8_t >	send_under_epoch (const Handshake_Message &msg, uint16_t epoch) override
	Stream_Handshake_IO (writer_fn writer)
bool	timeout_check () override

Detailed Description

Handshake IO for stream-based handshakes

Definition at line 67 of file tls_handshake_io.h.

Member Typedef Documentation

writer_fn

typedef std::function<void (uint8_t, const std::vector<uint8_t>&)> Botan::TLS::Stream_Handshake_IO::writer_fn

Definition at line 70 of file tls_handshake_io.h.

Constructor & Destructor Documentation

Stream_Handshake_IO()

Botan::TLS::Stream_Handshake_IO::Stream_Handshake_IO ( writer_fn  writer )

inlineexplicit

Definition at line 72 of file tls_handshake_io.h.

: m_send_hs(writer) {}

Member Function Documentation

add_record()

void Botan::TLS::Stream_Handshake_IO::add_record ( const uint8_t  record[], size_t  record_len, Record_Type  type, uint64_t  sequence_number  )

overridevirtual

Implements Botan::TLS::Handshake_IO.

Definition at line 50 of file tls_handshake_io.cpp.

   {
   if(record_type == HANDSHAKE)
      {
      m_queue.insert(m_queue.end(), record, record + record_len);
      }
   else if(record_type == CHANGE_CIPHER_SPEC)
      {
      if(record_len != 1 || record[0] != 1)
         throw Decoding_Error("Invalid ChangeCipherSpec");
 
      // Pretend it's a regular handshake message of zero length
      const uint8_t ccs_hs[] = { HANDSHAKE_CCS, 0, 0, 0 };
      m_queue.insert(m_queue.end(), ccs_hs, ccs_hs + sizeof(ccs_hs));
      }
   else
      throw Decoding_Error("Unknown message type " + std::to_string(record_type) + " in handshake processing");
   }

References Botan::TLS::CHANGE_CIPHER_SPEC, Botan::TLS::HANDSHAKE, Botan::TLS::HANDSHAKE_CCS, and Botan::ASN1::to_string().

format()

std::vector< uint8_t > Botan::TLS::Stream_Handshake_IO::format ( const std::vector< uint8_t > &  handshake_msg, Handshake_Type  handshake_type  ) const

overridevirtual

Implements Botan::TLS::Handshake_IO.

Definition at line 98 of file tls_handshake_io.cpp.

   {
   std::vector<uint8_t> send_buf(4 + msg.size());
 
   const size_t buf_size = msg.size();
 
   send_buf[0] = static_cast<uint8_t>(type);
 
   store_be24(&send_buf[1], buf_size);
 
   if (msg.size() > 0)
      {
      copy_mem(&send_buf[4], msg.data(), msg.size());
      }
 
   return send_buf;
   }

References Botan::copy_mem(), and type.

Referenced by send().

get_next_record()

std::pair< Handshake_Type, std::vector< uint8_t > > Botan::TLS::Stream_Handshake_IO::get_next_record ( bool  expecting_ccs )

overridevirtual

Returns (HANDSHAKE_NONE, std::vector<>()) if no message currently available

Implements Botan::TLS::Handshake_IO.

Definition at line 72 of file tls_handshake_io.cpp.

   {
   if(m_queue.size() >= 4)
      {
      const size_t length = 4 + make_uint32(0, m_queue[1], m_queue[2], m_queue[3]);
 
      if(m_queue.size() >= length)
         {
         Handshake_Type type = static_cast<Handshake_Type>(m_queue[0]);
 
         if(type == HANDSHAKE_NONE)
            throw Decoding_Error("Invalid handshake message type");
 
         std::vector<uint8_t> contents(m_queue.begin() + 4,
                                       m_queue.begin() + length);
 
         m_queue.erase(m_queue.begin(), m_queue.begin() + length);
 
         return std::make_pair(type, contents);
         }
      }
 
   return std::make_pair(HANDSHAKE_NONE, std::vector<uint8_t>());
   }

References Botan::TLS::HANDSHAKE_NONE, Botan::make_uint32(), and type.

initial_record_version()

Protocol_Version Botan::TLS::Stream_Handshake_IO::initial_record_version ( ) const

overridevirtual

Implements Botan::TLS::Handshake_IO.

Definition at line 45 of file tls_handshake_io.cpp.

   {
   return Protocol_Version::TLS_V10;
   }

References Botan::TLS::Protocol_Version::TLS_V10.

send()

std::vector< uint8_t > Botan::TLS::Stream_Handshake_IO::send ( const Handshake_Message &  msg )

overridevirtual

Implements Botan::TLS::Handshake_IO.

Definition at line 122 of file tls_handshake_io.cpp.

   {
   const std::vector<uint8_t> msg_bits = msg.serialize();
 
   if(msg.type() == HANDSHAKE_CCS)
      {
      m_send_hs(CHANGE_CIPHER_SPEC, msg_bits);
      return std::vector<uint8_t>(); // not included in handshake hashes
      }
 
   const std::vector<uint8_t> buf = format(msg_bits, msg.type());
   m_send_hs(HANDSHAKE, buf);
   return buf;
   }

References Botan::TLS::CHANGE_CIPHER_SPEC, format(), Botan::TLS::HANDSHAKE, Botan::TLS::HANDSHAKE_CCS, Botan::TLS::Handshake_Message::serialize(), and Botan::TLS::Handshake_Message::type().

send_under_epoch()

std::vector< uint8_t > Botan::TLS::Stream_Handshake_IO::send_under_epoch ( const Handshake_Message &  msg, uint16_t  epoch  )

overridevirtual

Implements Botan::TLS::Handshake_IO.

Definition at line 117 of file tls_handshake_io.cpp.

   {
   throw Invalid_State("Not possible to send under arbitrary epoch with stream based TLS");
   }

timeout_check()

bool Botan::TLS::Stream_Handshake_IO::timeout_check ( )

inlineoverridevirtual

Implements Botan::TLS::Handshake_IO.

Definition at line 76 of file tls_handshake_io.h.

{ return false; }

---

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

• src/lib/tls/tls_handshake_io.h
• src/lib/tls/tls_handshake_io.cpp