2006-08-01 17:27:08 +02:00
|
|
|
/*
|
|
|
|
|
2014-02-23 20:12:25 +01:00
|
|
|
Copyright (c) 2006-2014, Arvid Norberg
|
2006-08-01 17:27:08 +02:00
|
|
|
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 ROUTING_TABLE_HPP
|
|
|
|
#define ROUTING_TABLE_HPP
|
|
|
|
|
|
|
|
#include <vector>
|
|
|
|
#include <boost/cstdint.hpp>
|
|
|
|
|
|
|
|
#include <boost/utility.hpp>
|
|
|
|
#include <boost/tuple/tuple.hpp>
|
|
|
|
#include <boost/array.hpp>
|
2006-10-12 22:42:58 +02:00
|
|
|
#include <set>
|
2006-08-01 17:27:08 +02:00
|
|
|
|
|
|
|
#include <libtorrent/kademlia/logging.hpp>
|
|
|
|
|
|
|
|
#include <libtorrent/kademlia/node_id.hpp>
|
|
|
|
#include <libtorrent/kademlia/node_entry.hpp>
|
|
|
|
#include <libtorrent/session_settings.hpp>
|
2007-05-12 03:52:25 +02:00
|
|
|
#include <libtorrent/size_type.hpp>
|
2007-09-10 08:12:41 +02:00
|
|
|
#include <libtorrent/assert.hpp>
|
2014-07-06 21:18:00 +02:00
|
|
|
#include <libtorrent/time.hpp>
|
|
|
|
#include <boost/unordered_set.hpp>
|
2006-08-01 17:27:08 +02:00
|
|
|
|
2009-01-23 11:36:07 +01:00
|
|
|
namespace libtorrent
|
|
|
|
{
|
|
|
|
struct session_status;
|
|
|
|
}
|
|
|
|
|
2006-08-01 17:27:08 +02:00
|
|
|
namespace libtorrent { namespace dht
|
|
|
|
{
|
|
|
|
|
2008-05-10 07:51:58 +02:00
|
|
|
#ifdef TORRENT_DHT_VERBOSE_LOGGING
|
|
|
|
TORRENT_DECLARE_LOG(table);
|
|
|
|
#endif
|
|
|
|
|
2006-08-01 17:27:08 +02:00
|
|
|
|
2007-05-08 10:49:07 +02:00
|
|
|
typedef std::vector<node_entry> bucket_t;
|
2006-08-01 17:27:08 +02:00
|
|
|
|
2010-01-03 12:08:39 +01:00
|
|
|
struct routing_table_node
|
|
|
|
{
|
|
|
|
bucket_t replacements;
|
|
|
|
bucket_t live_nodes;
|
|
|
|
ptime last_active;
|
|
|
|
};
|
|
|
|
|
2006-08-01 17:27:08 +02:00
|
|
|
// differences in the implementation from the description in
|
|
|
|
// the paper:
|
|
|
|
//
|
|
|
|
// * Nodes are not marked as being stale, they keep a counter
|
|
|
|
// that tells how many times in a row they have failed. When
|
|
|
|
// a new node is to be inserted, the node that has failed
|
|
|
|
// the most times is replaced. If none of the nodes in the
|
|
|
|
// bucket has failed, then it is put in the replacement
|
|
|
|
// cache (just like in the paper).
|
|
|
|
|
2012-03-20 04:53:07 +01:00
|
|
|
class TORRENT_EXTRA_EXPORT routing_table
|
2006-08-01 17:27:08 +02:00
|
|
|
{
|
|
|
|
public:
|
2014-01-17 05:49:04 +01:00
|
|
|
typedef std::vector<routing_table_node> table_t;
|
|
|
|
|
2006-08-01 17:27:08 +02:00
|
|
|
routing_table(node_id const& id, int bucket_size
|
|
|
|
, dht_settings const& settings);
|
|
|
|
|
2009-01-23 11:36:07 +01:00
|
|
|
void status(session_status& s) const;
|
|
|
|
|
2011-01-17 08:49:44 +01:00
|
|
|
void node_failed(node_id const& id, udp::endpoint const& ep);
|
2006-09-27 19:20:18 +02:00
|
|
|
|
|
|
|
// adds an endpoint that will never be added to
|
|
|
|
// the routing table
|
|
|
|
void add_router_node(udp::endpoint router);
|
|
|
|
|
|
|
|
// iterates over the router nodes added
|
|
|
|
typedef std::set<udp::endpoint>::const_iterator router_iterator;
|
|
|
|
router_iterator router_begin() const { return m_router_nodes.begin(); }
|
|
|
|
router_iterator router_end() const { return m_router_nodes.end(); }
|
2006-08-01 17:27:08 +02:00
|
|
|
|
2012-09-22 20:15:29 +02:00
|
|
|
bool add_node(node_entry e);
|
2010-01-03 12:08:39 +01:00
|
|
|
|
2006-08-01 17:27:08 +02:00
|
|
|
// this function is called every time the node sees
|
|
|
|
// a sign of a node being alive. This node will either
|
|
|
|
// be inserted in the k-buckets or be moved to the top
|
|
|
|
// of its bucket.
|
2012-09-22 20:15:29 +02:00
|
|
|
bool node_seen(node_id const& id, udp::endpoint ep, int rtt);
|
2010-01-03 12:08:39 +01:00
|
|
|
|
|
|
|
// this may add a node to the routing table and mark it as
|
|
|
|
// not pinged. If the bucket the node falls into is full,
|
|
|
|
// the node will be ignored.
|
|
|
|
void heard_about(node_id const& id, udp::endpoint const& ep);
|
2006-08-01 17:27:08 +02:00
|
|
|
|
2010-01-03 12:08:39 +01:00
|
|
|
// if any bucket in the routing table needs to be refreshed
|
|
|
|
// this function will return true and set the target to an
|
|
|
|
// appropriate target inside that bucket
|
|
|
|
bool need_refresh(node_id& target) const;
|
2006-08-01 17:27:08 +02:00
|
|
|
|
2008-11-10 03:08:42 +01:00
|
|
|
enum
|
|
|
|
{
|
2010-01-03 12:08:39 +01:00
|
|
|
include_failed = 1
|
2008-11-10 03:08:42 +01:00
|
|
|
};
|
2006-08-01 17:27:08 +02:00
|
|
|
// fills the vector with the count nodes from our buckets that
|
|
|
|
// are nearest to the given id.
|
|
|
|
void find_node(node_id const& id, std::vector<node_entry>& l
|
2008-11-10 03:08:42 +01:00
|
|
|
, int options, int count = 0);
|
2014-01-17 05:49:04 +01:00
|
|
|
void remove_node(node_entry* n
|
|
|
|
, table_t::iterator bucket) ;
|
2006-08-01 17:27:08 +02:00
|
|
|
|
2012-09-22 23:40:16 +02:00
|
|
|
int bucket_size(int bucket) const
|
2006-08-01 17:27:08 +02:00
|
|
|
{
|
2010-01-03 12:08:39 +01:00
|
|
|
int num_buckets = m_buckets.size();
|
2011-01-17 08:49:44 +01:00
|
|
|
if (num_buckets == 0) return 0;
|
2010-01-03 12:08:39 +01:00
|
|
|
if (bucket < num_buckets) bucket = num_buckets - 1;
|
2012-09-22 23:40:16 +02:00
|
|
|
table_t::const_iterator i = m_buckets.begin();
|
2010-01-03 12:08:39 +01:00
|
|
|
std::advance(i, bucket);
|
|
|
|
return (int)i->live_nodes.size();
|
2006-08-01 17:27:08 +02:00
|
|
|
}
|
|
|
|
|
2010-01-03 12:08:39 +01:00
|
|
|
void for_each_node(void (*)(void*, node_entry const&)
|
|
|
|
, void (*)(void*, node_entry const&), void* userdata) const;
|
|
|
|
|
|
|
|
int bucket_size() const { return m_bucket_size; }
|
2006-08-01 17:27:08 +02:00
|
|
|
|
|
|
|
boost::tuple<int, int> size() const;
|
2007-05-12 03:52:25 +02:00
|
|
|
size_type num_global_nodes() const;
|
2013-10-27 00:59:55 +02:00
|
|
|
|
|
|
|
// the number of bits down we have full buckets
|
|
|
|
// i.e. essentially the number of full buckets
|
|
|
|
// we have
|
|
|
|
int depth() const;
|
2006-08-01 17:27:08 +02:00
|
|
|
|
|
|
|
// returns true if there are no working nodes
|
|
|
|
// in the routing table
|
|
|
|
bool need_bootstrap() const;
|
2010-01-03 12:08:39 +01:00
|
|
|
int num_active_buckets() const { return m_buckets.size(); }
|
2006-08-01 17:27:08 +02:00
|
|
|
|
|
|
|
void replacement_cache(bucket_t& nodes) const;
|
2010-01-03 12:08:39 +01:00
|
|
|
|
|
|
|
#if defined TORRENT_DHT_VERBOSE_LOGGING || defined TORRENT_DEBUG
|
2006-08-01 17:27:08 +02:00
|
|
|
// used for debug and monitoring purposes. This will print out
|
|
|
|
// the state of the routing table to the given stream
|
|
|
|
void print_state(std::ostream& os) const;
|
2007-05-12 03:52:25 +02:00
|
|
|
#endif
|
|
|
|
|
2010-02-20 17:37:50 +01:00
|
|
|
void touch_bucket(node_id const& target);
|
|
|
|
|
2012-09-22 23:40:16 +02:00
|
|
|
int bucket_limit(int bucket) const;
|
|
|
|
|
2014-01-21 20:26:09 +01:00
|
|
|
#if TORRENT_USE_INVARIANT_CHECKS
|
2013-12-20 05:54:52 +01:00
|
|
|
void check_invariant() const;
|
|
|
|
#endif
|
|
|
|
|
2006-08-01 17:27:08 +02:00
|
|
|
private:
|
|
|
|
|
2010-01-03 12:08:39 +01:00
|
|
|
table_t::iterator find_bucket(node_id const& id);
|
|
|
|
|
2013-01-18 07:17:30 +01:00
|
|
|
void split_bucket();
|
|
|
|
|
2011-01-17 08:49:44 +01:00
|
|
|
// return a pointer the node_entry with the given endpoint
|
|
|
|
// or 0 if we don't have such a node. Both the address and the
|
|
|
|
// port has to match
|
2013-12-20 05:54:52 +01:00
|
|
|
node_entry* find_node(udp::endpoint const& ep
|
|
|
|
, routing_table::table_t::iterator* bucket);
|
2011-01-17 08:49:44 +01:00
|
|
|
|
2013-11-26 03:23:33 +01:00
|
|
|
dht_settings const& m_settings;
|
|
|
|
|
2010-01-03 12:08:39 +01:00
|
|
|
// (k-bucket, replacement cache) pairs
|
|
|
|
// the first entry is the bucket the furthest
|
|
|
|
// away from our own ID. Each time the bucket
|
|
|
|
// closest to us (m_buckets.back()) has more than
|
|
|
|
// bucket size nodes in it, another bucket is
|
|
|
|
// added to the end and it's split up between them
|
2006-08-01 17:27:08 +02:00
|
|
|
table_t m_buckets;
|
2010-01-03 12:08:39 +01:00
|
|
|
|
2006-08-01 17:27:08 +02:00
|
|
|
node_id m_id; // our own node id
|
2010-02-20 17:37:50 +01:00
|
|
|
|
2013-11-13 03:17:33 +01:00
|
|
|
// the last seen depth (i.e. levels in the routing table)
|
|
|
|
// it's mutable because it's updated by depth(), which is const
|
|
|
|
mutable int m_depth;
|
|
|
|
|
2010-02-20 17:37:50 +01:00
|
|
|
// the last time need_bootstrap() returned true
|
|
|
|
mutable ptime m_last_bootstrap;
|
2010-12-12 04:17:08 +01:00
|
|
|
|
|
|
|
// the last time the routing table was refreshed.
|
|
|
|
// this is used to stagger buckets needing refresh
|
|
|
|
// to be at least 45 seconds apart.
|
|
|
|
mutable ptime m_last_refresh;
|
|
|
|
|
|
|
|
// the last time we refreshed our own bucket
|
|
|
|
// refreshed every 15 minutes
|
|
|
|
mutable ptime m_last_self_refresh;
|
2006-08-01 17:27:08 +02:00
|
|
|
|
2006-09-27 19:20:18 +02:00
|
|
|
// this is a set of all the endpoints that have
|
|
|
|
// been identified as router nodes. They will
|
|
|
|
// be used in searches, but they will never
|
|
|
|
// be added to the routing table.
|
|
|
|
std::set<udp::endpoint> m_router_nodes;
|
2011-01-08 09:54:51 +01:00
|
|
|
|
|
|
|
// these are all the IPs that are in the routing
|
|
|
|
// table. It's used to only allow a single entry
|
|
|
|
// per IP in the whole table. Currently only for
|
|
|
|
// IPv4
|
2014-07-06 21:18:00 +02:00
|
|
|
boost::unordered_multiset<address_v4::bytes_type> m_ips;
|
|
|
|
|
|
|
|
// constant called k in paper
|
|
|
|
int m_bucket_size;
|
|
|
|
|
2006-08-01 17:27:08 +02:00
|
|
|
};
|
|
|
|
|
|
|
|
} } // namespace libtorrent::dht
|
|
|
|
|
|
|
|
#endif // ROUTING_TABLE_HPP
|
|
|
|
|