document the new proxy interface and deprecate it in the 0.15 branch

This commit is contained in:
Arvid Norberg 2010-10-07 06:02:35 +00:00
parent 606796841f
commit 8212d2f161
3 changed files with 20 additions and 56 deletions

View File

@ -44,6 +44,9 @@
incoming connection incoming connection
* added more detailed instrumentation of the disk I/O thread * added more detailed instrumentation of the disk I/O thread
* deprecate support for separate proxies for separate kinds of connections
0.15.4 release 0.15.4 release
* fixed piece picker issue triggered by hash failure and timed out requests to the piece * fixed piece picker issue triggered by hash failure and timed out requests to the piece

View File

@ -121,14 +121,11 @@ The ``session`` class has the following synopsis::
{ {
save_settings = 0x001, save_settings = 0x001,
save_dht_settings = 0x002, save_dht_settings = 0x002,
save_dht_proxy = 0x004, save_dht_state = 0x004,
save_dht_state = 0x008, save_proxy = 0x008,
save_i2p_proxy = 0x010, save_i2p_proxy = 0x010,
save_encryption_settings = 0x020, save_encryption_settings = 0x020,
save_peer_proxy = 0x040, save_as_map = 0x040,
save_web_proxy = 0x080,
save_tracker_proxy = 0x100,
save_as_map = 0x200,
}; };
void load_state(lazy_entry const& e); 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); void set_max_half_open_connections(int limit);
int max_half_open_connections() const; int max_half_open_connections() const;
void set_peer_proxy(proxy_settings const& s); void set_proxy(proxy_settings const& s);
void set_web_seed_proxy(proxy_settings const& s); proxy_settings proxy() const;
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;
int num_uploads() const; int num_uploads() const;
int num_connections() 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 enum save_state_flags_t
{ {
save_settings = 0x001, save_settings = 0x001,
save_dht_settings = 0x002, save_dht_settings = 0x002,
save_dht_proxy = 0x004, save_dht_state = 0x004,
save_dht_state = 0x008, save_proxy = 0x008,
save_i2p_proxy = 0x010, save_i2p_proxy = 0x010,
save_encryption_settings = 0x020, save_encryption_settings = 0x020,
save_peer_proxy = 0x040, save_as_map = 0x040,
save_web_proxy = 0x080,
save_tracker_proxy = 0x100,
save_as_map = 0x200,
}; };
@ -1109,48 +1098,20 @@ See session_settings_ and pe_settings_ for more information on available
options. 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_proxy(proxy_settings const& s);
void set_web_seed_proxy(proxy_settings const& s); proxy_setting proxy() const;
void set_tracker_proxy(proxy_settings const& s);
void set_dht_proxy(proxy_settings const& s);
The ``set_dht_proxy`` is not available when DHT is disabled. These functions These functions sets and queries the proxy settings to be used for the session.
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.
For more information on what settings are available for proxies, see For more information on what settings are available for proxies, see
`proxy_settings`_. `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() set_i2p_proxy() i2p_proxy()
--------------------------- ---------------------------

View File

@ -364,7 +364,7 @@ namespace libtorrent
proxy_settings proxy() const; proxy_settings proxy() const;
#ifndef TORRENT_NO_DEPRECATE #ifndef TORRENT_NO_DEPRECATE
// deprecated in 0.16 // deprecated in 0.15.
TORRENT_DEPRECATED_PREFIX TORRENT_DEPRECATED_PREFIX
void set_peer_proxy(proxy_settings const& s) TORRENT_DEPRECATED; void set_peer_proxy(proxy_settings const& s) TORRENT_DEPRECATED;
TORRENT_DEPRECATED_PREFIX TORRENT_DEPRECATED_PREFIX
@ -385,7 +385,7 @@ namespace libtorrent
TORRENT_DEPRECATED_PREFIX TORRENT_DEPRECATED_PREFIX
proxy_settings dht_proxy() const TORRENT_DEPRECATED; proxy_settings dht_proxy() const TORRENT_DEPRECATED;
#endif #endif
#endif #endif // TORRENT_NO_DEPRECATE
#if TORRENT_USE_I2P #if TORRENT_USE_I2P
void set_i2p_proxy(proxy_settings const& s); void set_i2p_proxy(proxy_settings const& s);