text: /*
  
  Copyright (c) 2003-2014, Arvid Norberg
  Copyright (c) 2007-2014, Arvid Norberg, Un Shyam
  All rights reserved.
  
  Redistribution and use in source and binary forms, with or without
  modification, are permitted provided that the following conditions
  are met:
  
      * Redistributions of source code must retain the above copyright
        notice, this list of conditions and the following disclaimer.
      * Redistributions in binary form must reproduce the above copyright
        notice, this list of conditions and the following disclaimer in
        the documentation and/or other materials provided with the distribution.
      * Neither the name of the author nor the names of its
        contributors may be used to endorse or promote products derived
        from this software without specific prior written permission.
  
  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  POSSIBILITY OF SUCH DAMAGE.
  
  */
  
  #ifndef TORRENT_BT_PEER_CONNECTION_HPP_INCLUDED
  #define TORRENT_BT_PEER_CONNECTION_HPP_INCLUDED
  
  #include <ctime>
  #include <algorithm>
  #include <vector>
  #include <string>
  
  #include "libtorrent/debug.hpp"
  
  #ifdef _MSC_VER
  #pragma warning(push, 1)
  #endif
  
  #include <boost/smart_ptr.hpp>
  #include <boost/noncopyable.hpp>
  #include <boost/array.hpp>
  #include <boost/optional.hpp>
  #include <boost/cstdint.hpp>
  
  #ifdef _MSC_VER
  #pragma warning(pop)
  #endif
  
  #include "libtorrent/buffer.hpp"
  #include "libtorrent/peer_connection.hpp"
  #include "libtorrent/socket.hpp"
  #include "libtorrent/peer_id.hpp"
  #include "libtorrent/stat.hpp"
  #include "libtorrent/alert.hpp"
  #include "libtorrent/torrent.hpp"
  #include "libtorrent/peer_request.hpp"
  #include "libtorrent/piece_block_progress.hpp"
  #include "libtorrent/config.hpp"
  #include "libtorrent/pe_crypto.hpp"
  
  namespace libtorrent
  {
  	class torrent;
  
  	namespace detail
  	{
  		struct session_impl;
  	}
  
  	class TORRENT_EXTRA_EXPORT bt_peer_connection
  		: public peer_connection
  	{
  	friend class invariant_access;
  	public:
  
  		// this is the constructor where the we are the active part.
  		// The peer_conenction should handshake and verify that the
  		// other end has the correct id
  		bt_peer_connection(
  			aux::session_impl& ses
  			, boost::shared_ptr<socket_type> s
  			, tcp::endpoint const& remote
  			, policy::peer* peerinfo
  			, peer_id const& pid
  			, boost::weak_ptr<torrent> t = boost::weak_ptr<torrent>()
  			, bool outgoing = false);
  
  		void start();
  
  		enum
  		{
  			// pex_msg = 1,
  			// metadata_msg = 2,
  			upload_only_msg = 3,
  			holepunch_msg = 4,
  			// recommend_msg = 5,
  			// comment_msg = 6,
  			dont_have_msg = 7,
  			share_mode_msg = 8,
  		};
  
  		~bt_peer_connection();
  		
  #ifndef TORRENT_DISABLE_ENCRYPTION
  		bool supports_encryption() const
  		{ return m_encrypted; }
  		bool rc4_encrypted() const
  		{ return m_rc4_encrypted; }
  #endif
  
  		virtual int type() const { return peer_connection::bittorrent_connection; }
  
  		enum message_type
  		{
  	// standard messages
  			msg_choke = 0,
  			msg_unchoke,
  			msg_interested,
  			msg_not_interested,
  			msg_have,
  			msg_bitfield,
  			msg_request,
  			msg_piece,
  			msg_cancel,
  			// DHT extension
  			msg_dht_port,
  			// FAST extension
  			msg_suggest_piece = 0xd,
  			msg_have_all,
  			msg_have_none,
  			msg_reject_request,
  			msg_allowed_fast,
  
  			// extension protocol message
  			msg_extended = 20,
  
  			num_supported_messages
  		};
  
  		enum hp_message_t
  		{
  			// msg_types
  			hp_rendezvous = 0,
  			hp_connect = 1,
  			hp_failed = 2,
  
  			// error codes
  			hp_no_such_peer = 1,
  			hp_not_connected = 2,
  			hp_no_support = 3,
  			hp_no_self = 4
  		};
  
  		// called from the main loop when this connection has any
  		// work to do.
  
  		void on_sent(error_code const& error
  			, std::size_t bytes_transferred);
  		void on_receive(error_code const& error
  			, std::size_t bytes_transferred);
  		
  		virtual void get_specific_peer_info(peer_info& p) const;
  		virtual bool in_handshake() const;
  
  #ifndef TORRENT_DISABLE_EXTENSIONS
  		bool supports_holepunch() const { return m_holepunch_id != 0; }
  #endif
  
  		bool support_extensions() const { return m_supports_extensions; }
  
  		// the message handlers are called
  		// each time a recv() returns some new
  		// data, the last time it will be called
  		// is when the entire packet has been
  		// received, then it will no longer
  		// be called. i.e. most handlers need
  		// to check how much of the packet they
  		// have received before any processing
  		void on_keepalive();
  		void on_choke(int received);
  		void on_unchoke(int received);
  		void on_interested(int received);
  		void on_not_interested(int received);
  		void on_have(int received);
  		void on_bitfield(int received);
  		void on_request(int received);
  		void on_piece(int received);
  		void on_cancel(int received);
  
  		// DHT extension
  		void on_dht_port(int received);
  
  		// FAST extension
  		void on_suggest_piece(int received);
  		void on_have_all(int received);
  		void on_have_none(int received);
  		void on_reject_request(int received);
  		void on_allowed_fast(int received);
  #ifndef TORRENT_DISABLE_EXTENSIONS
  		void on_holepunch();
  
  		void on_extended(int received);
  
  		void on_extended_handshake();
  #endif
  
  		typedef void (bt_peer_connection::*message_handler)(int received);
  
  		// the following functions appends messages
  		// to the send buffer
  		void write_choke();
  		void write_unchoke();
  		void write_interested();
  		void write_not_interested();
  		void write_request(peer_request const& r);
  		void write_cancel(peer_request const& r);
  		void write_bitfield();
  		void write_have(int index);
  		void write_piece(peer_request const& r, disk_buffer_holder& buffer);
  		void write_handshake();
  #ifndef TORRENT_DISABLE_EXTENSIONS
  		void write_extensions();
  		void write_upload_only();
  		void write_share_mode();
  		void write_holepunch_msg(int type, tcp::endpoint const& ep, int error);
  #endif
  		void write_metadata(std::pair<int, int> req);
  		void write_metadata_request(std::pair<int, int> req);
  		void write_keepalive();
  
  		// DHT extension
  		void write_dht_port(int listen_port);
  
  		// FAST extension
  		void write_have_all();
  		void write_have_none();
  		void write_reject_request(peer_request const&);
  		void write_allow_fast(int piece);
  		void write_suggest(int piece);
  		
  		void on_connected();
  		void on_metadata();
  
  #if TORRENT_USE_INVARIANT_CHECKS
  		void check_invariant() const;
  		ptime m_last_choke;
  #endif
  
  	private:
  
  		bool dispatch_message(int received);
  		// returns the block currently being
  		// downloaded. And the progress of that
  		// block. If the peer isn't downloading
  		// a piece for the moment, the boost::optional
  		// will be invalid.
  		boost::optional<piece_block_progress> downloading_piece_progress() const;
  
  #ifndef TORRENT_DISABLE_ENCRYPTION
  
  		// if (is_local()), we are 'a' otherwise 'b'
  		//
  		// 1. a -> b dhkey, pad
  		// 2. b -> a dhkey, pad
  		// 3. a -> b sync, payload
  		// 4. b -> a sync, payload
  		// 5. a -> b payload
  
  		void write_pe1_2_dhkey();
  		void write_pe3_sync();
  		void write_pe4_sync(int crypto_select);
  
  		void write_pe_vc_cryptofield(char* write_buf, int len
  			, int crypto_field, int pad_size);
  
  		// stream key (info hash of attached torrent)
  		// secret is the DH shared secret
  		// initializes m_enc_handler
  		void init_pe_rc4_handler(char const* secret, sha1_hash const& stream_key);
  
  		// Returns offset at which bytestream (src, src + src_size)
  		// matches bytestream(target, target + target_size).
  		// If no sync found, return -1
  		int get_syncoffset(char const* src, int src_size
  			, char const* target, int target_size) const;
  #endif
  
  public:
  
  		// these functions encrypt the send buffer if m_rc4_encrypted
  		// is true, otherwise it passes the call to the
  		// peer_connection functions of the same names
  		virtual void append_const_send_buffer(char const* buffer, int size);
  		virtual void send_buffer(char const* begin, int size, int flags = 0
  			, void (*fun)(char*, int, void*) = 0, void* userdata = 0);
  		template <class Destructor>
  		void bt_append_send_buffer(char* buffer, int size, Destructor const& destructor)
  		{
  #ifndef TORRENT_DISABLE_ENCRYPTION
  			if (m_rc4_encrypted)
  				m_enc_handler->encrypt(buffer, size);
  #endif
  			peer_connection::append_send_buffer(buffer, size, destructor, true);
  		}
  
  private:
  
  		enum state
  		{
  #ifndef TORRENT_DISABLE_ENCRYPTION
  			read_pe_dhkey = 0,
  			read_pe_syncvc,
  			read_pe_synchash,
  			read_pe_skey_vc,
  			read_pe_cryptofield,
  			read_pe_pad,
  			read_pe_ia,
  			init_bt_handshake,
  			read_protocol_identifier,
  #else
  			read_protocol_identifier = 0,
  #endif
  			read_info_hash,
  			read_peer_id,
  
  			// handshake complete
  			read_packet_size,
  			read_packet
  		};
  		
  #ifndef TORRENT_DISABLE_ENCRYPTION
  		enum
  		{
  			handshake_len = 68,
  			dh_key_len = 96
  		};
  #endif
  
  		// state of on_receive
  		boost::uint8_t m_state;
  
  		// this is set to true if the handshake from
  		// the peer indicated that it supports the
  		// extension protocol
  		bool m_supports_extensions:1;
  		bool m_supports_dht_port:1;
  		bool m_supports_fast:1;
  
  #if TORRENT_USE_ASSERTS
  		// this is set to true when the client's
  		// bitfield is sent to this peer
  		bool m_sent_bitfield:1;
  
  		bool m_in_constructor:1;
  		
  		bool m_sent_handshake:1;
  #endif
  
  #ifndef TORRENT_DISABLE_ENCRYPTION
  		// this is set to true after the encryption method has been
  		// succesfully negotiated (either plaintext or rc4), to signal
  		// automatic encryption/decryption.
  		bool m_encrypted:1;
  
  		// true if rc4, false if plaintext
  		bool m_rc4_encrypted:1;
  #endif
  
  #ifndef TORRENT_DISABLE_EXTENSIONS
  		// the message ID for upload only message
  		// 0 if not supported
  		boost::uint8_t m_upload_only_id;
  
  		// the message ID for holepunch messages
  		boost::uint8_t m_holepunch_id;
  #endif
  
  		std::string m_client_version;
  
  		static const message_handler m_message_handler[num_supported_messages];
  
  		// the peer ID we advertise for ourself
  		peer_id m_our_peer_id;
  
  		// this is a queue of ranges that describes
  		// where in the send buffer actual payload
  		// data is located. This is currently
  		// only used to be able to gather statistics
  		// seperately on payload and protocol data.
  		struct range
  		{
  			range(int s, int l)
  				: start(s)
  				, length(l)
  			{
  				TORRENT_ASSERT(s >= 0);
  				TORRENT_ASSERT(l > 0);
  			}
  			int start;
  			int length;
  		};
  		static bool range_below_zero(const range& r)
  		{ return r.start < 0; }
  		std::vector<range> m_payloads;
  
  		// we have suggested these pieces to the peer
  		// don't suggest it again
  		bitfield m_sent_suggested_pieces;
  
  #ifndef TORRENT_DISABLE_ENCRYPTION
  		// initialized during write_pe1_2_dhkey, and destroyed on
  		// creation of m_enc_handler. Cannot reinitialize once
  		// initialized.
  		boost::scoped_ptr<dh_key_exchange> m_dh_key_exchange;
  		
  		// if encryption is negotiated, this is used for
  		// encryption/decryption during the entire session. Destroyed
  		// if plaintext is selected
  		boost::scoped_ptr<encryption_handler> m_enc_handler;
  		
  		// (outgoing only) synchronize verification constant with
  		// remote peer, this will hold rc4_decrypt(vc). Destroyed
  		// after the sync step.
  		boost::scoped_array<char> m_sync_vc;
  
  		// (incoming only) synchronize hash with remote peer, holds
  		// the sync hash (hash("req1",secret)). Destroyed after the
  		// sync step.
  		boost::scoped_ptr<sha1_hash> m_sync_hash;
  
  		// used to disconnect peer if sync points are not found within
  		// the maximum number of bytes
  		int m_sync_bytes_read;
  #endif // #ifndef TORRENT_DISABLE_ENCRYPTION
  
  #ifndef TORRENT_DISABLE_EXTENSIONS
  		// the message ID for don't-have message
  		boost::uint8_t m_dont_have_id;
  
  		// the message ID for share mode message
  		// 0 if not supported
  		boost::uint8_t m_share_mode_id;
  
  		// the reserved bits received from the other peer
  		// in the bittorrent handshake
  		char m_reserved_bits[8];
  #endif
  	};
  }
  
  #endif // TORRENT_BT_PEER_CONNECTION_HPP_INCLUDED
  
  