diff --git a/docs/reference-Session.html b/docs/reference-Session.html index ced28a883..e7847ffc7 100644 --- a/docs/reference-Session.html +++ b/docs/reference-Session.html @@ -47,13 +47,11 @@

Table of contents

@@ -527,8 +525,9 @@ class session: public boost::noncopyable void get_torrent_status (std::vector<torrent_status>* ret , boost::function<bool(torrent_status const&)> const& pred , boost::uint32_t flags = 0) const; - void post_torrent_updates (); + void post_torrent_updates (boost::uint32_t flags = 0xffffffff); void post_session_stats (); + void post_dht_stats (); torrent_handle find_torrent (sha1_hash const& info_hash) const; std::vector<torrent_handle> get_torrents () const; void async_add_torrent (add_torrent_params const& params); @@ -676,13 +675,15 @@ a valid torrent are ignored.

post_torrent_updates()

-void post_torrent_updates ();
+void post_torrent_updates (boost::uint32_t flags = 0xffffffff);
 

This functions instructs the session to post the state_update_alert, containing the status of all torrents whose state changed since the last time this function was called.

Only torrents who has the state subscription flag set will be -included. This flag is on by default. See add_torrent_params.

+included. This flag is on by default. See add_torrent_params. +the flags argument is the same as for torrent_handle::status(). +see torrent_handle::status_flags_t.

post_session_stats()

@@ -694,6 +695,13 @@ snapshot of the performance counters from the internals of libtorrent. To interpret these counters, query the session via session_stats_metrics().

For more information, see the session statistics section.

+
+
+

post_dht_stats()

+
+void post_dht_stats ();
+
+

This will cause a dht_stats_alert to be posted.

@@ -882,7 +890,7 @@ void dht_get_item (sha1_hash const& target);

query the DHT for an immutable item at the target hash. the result is posted as a dht_immutable_item_alert.

-
+

dht_get_item()

 void dht_get_item (boost::array<char, 32> key
@@ -904,7 +912,7 @@ the returned hash is the key that is to be used to look the item
 up agan. It's just the sha-1 hash of the bencoded form of the
 structure.

-
+

dht_put_item()

 void dht_put_item (boost::array<char, 32> key
@@ -1409,99 +1417,8 @@ and NAT-PMP.
 
 
 
-
-
-
-

dht_lookup

-

Declared in "libtorrent/session_status.hpp"

-

holds statistics about a current dht_lookup operation. -a DHT lookup is the travesal of nodes, looking up a -set of target nodes in the DHT for retrieving and possibly -storing information in the DHT

-
-struct dht_lookup
-{
-   char const* type;
-   int outstanding_requests;
-   int timeouts;
-   int responses;
-   int branch_factor;
-   int nodes_left;
-   int last_sent;
-   int first_timeout;
-};
-
-
-
type
-
string literal indicating which kind of lookup this is
-
-
-
outstanding_requests
-
the number of outstanding request to individual nodes -this lookup has right now
-
-
-
timeouts
-
the total number of requests that have timed out so far -for this lookup
-
-
-
responses
-
the total number of responses we have received for this -lookup so far for this lookup
-
-
-
branch_factor
-
the branch factor for this lookup. This is the number of -nodes we keep outstanding requests to in parallel by default. -when nodes time out we may increase this.
-
-
-
nodes_left
-
the number of nodes left that could be queries for this -lookup. Many of these are likely to be part of the trail -while performing the lookup and would never end up actually -being queried.
-
-
-
last_sent
-
the number of seconds ago the -last message was sent that's still -outstanding
-
-
-
first_timeout
-
the number of outstanding requests -that have exceeded the short timeout -and are considered timed out in the -sense that they increased the branch -factor
-
-
-
-

dht_routing_bucket

-

Declared in "libtorrent/session_status.hpp"

-

TODO: 3 add accessors to query the DHT state (post the result as an alert) -holds dht routing table stats

-
-struct dht_routing_bucket
-{
-   int num_nodes;
-   int num_replacements;
-   int last_active;
-};
-
- -
-
num_nodes num_replacements
-
the total number of nodes and replacement nodes -in the routing table
-
-
-
last_active
-
number of seconds since last activity
-
-
+
+

find_metric_idx()

Declared in "libtorrent/session.hpp"

diff --git a/docs/stats_counters.rst b/docs/stats_counters.rst
index 95b7bf4cb..e9eed43f9 100644
--- a/docs/stats_counters.rst
+++ b/docs/stats_counters.rst
@@ -1664,25 +1664,35 @@ the total number of bytes sent and received by the DHT
 the number of DHT messages we've sent and received
 by kind.
 
-.. _dht.sent_dht_bytes:
+.. _dht.dht_invalid_announce:
 
-.. _dht.recv_dht_bytes:
+.. _dht.dht_invalid_get_peers:
+
+.. _dht.dht_invalid_put:
+
+.. _dht.dht_invalid_get:
 
 .. raw:: html
 
-	
-	
+	
+	
+	
+	
 
-+--------------------+---------+
-| name               | type    |
-+====================+=========+
-| dht.sent_dht_bytes | counter |
-+--------------------+---------+
-| dht.recv_dht_bytes | counter |
-+--------------------+---------+
++---------------------------+---------+
+| name                      | type    |
++===========================+=========+
+| dht.dht_invalid_announce  | counter |
++---------------------------+---------+
+| dht.dht_invalid_get_peers | counter |
++---------------------------+---------+
+| dht.dht_invalid_put       | counter |
++---------------------------+---------+
+| dht.dht_invalid_get       | counter |
++---------------------------+---------+
 
 
-the number of bytes sent and received by the DHT
+the number of failed incoming DHT requests by kind of request
 
 .. _utp.utp_packet_loss:
 
diff --git a/docs/todo.html b/docs/todo.html
index 331143f71..ed988bd56 100644
--- a/docs/todo.html
+++ b/docs/todo.html
@@ -22,113 +22,996 @@
 
 

libtorrent todo-list

0 urgent -6 important -26 relevant +4 important +33 relevant 9 feasible -144 notes -
relevance 3../src/lsd.cpp:89instead if writing to a file, post alerts. Or call a log callback