diff --git a/ChangeLog b/ChangeLog index 7a01d8959..e082d1c23 100644 --- a/ChangeLog +++ b/ChangeLog @@ -44,6 +44,9 @@ incoming connection * added more detailed instrumentation of the disk I/O thread + + * deprecate support for separate proxies for separate kinds of connections + 0.15.4 release * fixed piece picker issue triggered by hash failure and timed out requests to the piece diff --git a/docs/manual.rst b/docs/manual.rst index f59e11353..d84595570 100644 --- a/docs/manual.rst +++ b/docs/manual.rst @@ -121,14 +121,11 @@ The ``session`` class has the following synopsis:: { save_settings = 0x001, save_dht_settings = 0x002, - save_dht_proxy = 0x004, - save_dht_state = 0x008, + save_dht_state = 0x004, + save_proxy = 0x008, save_i2p_proxy = 0x010, save_encryption_settings = 0x020, - save_peer_proxy = 0x040, - save_web_proxy = 0x080, - save_tracker_proxy = 0x100, - save_as_map = 0x200, + save_as_map = 0x040, }; void load_state(lazy_entry const& e); @@ -182,13 +179,8 @@ The ``session`` class has the following synopsis:: void set_max_half_open_connections(int limit); int max_half_open_connections() const; - void set_peer_proxy(proxy_settings const& s); - void set_web_seed_proxy(proxy_settings const& s); - void set_tracker_proxy(proxy_settings const& s); - - proxy_settings const& peer_proxy() const; - proxy_settings const& web_seed_proxy() const; - proxy_settings const& tracker_proxy() const; + void set_proxy(proxy_settings const& s); + proxy_settings proxy() const; int num_uploads() const; int num_connections() const; @@ -310,16 +302,13 @@ torrents). These are the possible flags. A flag that's set, means those settings enum save_state_flags_t { - save_settings = 0x001, + save_settings = 0x001, save_dht_settings = 0x002, - save_dht_proxy = 0x004, - save_dht_state = 0x008, - save_i2p_proxy = 0x010, + save_dht_state = 0x004, + save_proxy = 0x008, + save_i2p_proxy = 0x010, save_encryption_settings = 0x020, - save_peer_proxy = 0x040, - save_web_proxy = 0x080, - save_tracker_proxy = 0x100, - save_as_map = 0x200, + save_as_map = 0x040, }; @@ -1109,48 +1098,20 @@ See session_settings_ and pe_settings_ for more information on available options. -set_peer_proxy() set_web_seed_proxy() set_tracker_proxy() set_dht_proxy() -------------------------------------------------------------------------- +set_proxy() proxy() +------------------- :: - void set_peer_proxy(proxy_settings const& s); - void set_web_seed_proxy(proxy_settings const& s); - void set_tracker_proxy(proxy_settings const& s); - void set_dht_proxy(proxy_settings const& s); + void set_proxy(proxy_settings const& s); + proxy_setting proxy() const; -The ``set_dht_proxy`` is not available when DHT is disabled. These functions -sets the proxy settings for different kinds of connections, bittorrent peers, -web seeds, trackers and the DHT traffic. - -``set_peer_proxy`` affects regular bittorrent peers. ``set_web_seed_proxy`` -affects only web seeds. see `HTTP seeding`_. - -``set_tracker_proxy`` only affects HTTP tracker connections (UDP tracker -connections are affected if the given proxy supports UDP, e.g. SOCKS5). - -``set_dht_proxy`` affects the DHT messages. Since they are sent over UDP, -it only has any effect if the proxy supports UDP. +These functions sets and queries the proxy settings to be used for the session. For more information on what settings are available for proxies, see `proxy_settings`_. -peer_proxy() web_seed_proxy() tracker_proxy() dht_proxy() ---------------------------------------------------------- - - :: - - proxy_settings peer_proxy() const; - proxy_settings web_seed_proxy() const; - proxy_settings tracker_proxy() const; - proxy_settings dht_proxy() const; - -These functions returns references to their respective current settings. - -The ``dht_proxy`` is not available when DHT is disabled. - - set_i2p_proxy() i2p_proxy() --------------------------- diff --git a/include/libtorrent/session.hpp b/include/libtorrent/session.hpp index 75ddac720..851df550d 100644 --- a/include/libtorrent/session.hpp +++ b/include/libtorrent/session.hpp @@ -364,7 +364,7 @@ namespace libtorrent proxy_settings proxy() const; #ifndef TORRENT_NO_DEPRECATE - // deprecated in 0.16 + // deprecated in 0.15. TORRENT_DEPRECATED_PREFIX void set_peer_proxy(proxy_settings const& s) TORRENT_DEPRECATED; TORRENT_DEPRECATED_PREFIX @@ -385,7 +385,7 @@ namespace libtorrent TORRENT_DEPRECATED_PREFIX proxy_settings dht_proxy() const TORRENT_DEPRECATED; #endif -#endif +#endif // TORRENT_NO_DEPRECATE #if TORRENT_USE_I2P void set_i2p_proxy(proxy_settings const& s);