premiere
/
premiere-libtorrent
2
2
Fork 1
Code Issues Pull Requests Releases Wiki Activity

fix settings default value doc generation. Apply documentation fix from Sig7

This commit is contained in:
arvidn 2019-10-20 00:51:21 +02:00 committed by Arvid Norberg
parent 729102c280
commit 28a627a3a3
2 changed files with 76 additions and 91 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
docs/gen_settings_doc.py
View File

@ -61,8 +61,12 @@ for line in f2:
continue continue
line = line.split('(')[1].split(',') line = line.split('(')[1].split(',')
def_map[line[0]] = line[1].strip() if line[1].strip()[0] == '"':
print('%s = %s' % (line[0], line[1].strip())) default = ','.join(line[1:]).strip()[1:].split('"')[0].strip()
else:
default = line[1].strip()
def_map[line[0]] = default
print('%s = %s' % (line[0], default))
description = '' description = ''
names = [] names = []

159
include/libtorrent/settings_pack.hpp
View File

@ -188,7 +188,7 @@ namespace aux {
handshake_client_version, handshake_client_version,
// sets the network interface this session will use when it opens // sets the network interface this session will use when it opens
// outgoing connections. By default, it binds outgoing connections to // outgoing connections. An empty string binds outgoing connections to
// INADDR_ANY and port 0 (i.e. let the OS decide). Ths parameter must // INADDR_ANY and port 0 (i.e. let the OS decide). Ths parameter must
// be a string containing one or more, comma separated, adapter names. // be a string containing one or more, comma separated, adapter names.
// Adapter names on unix systems are of the form "eth0", "eth1", // Adapter names on unix systems are of the form "eth0", "eth1",
@ -204,8 +204,7 @@ namespace aux {
// the listen ports that will be opened for accepting incoming uTP and // the listen ports that will be opened for accepting incoming uTP and
// TCP connections. It is possible to listen on multiple interfaces and // TCP connections. It is possible to listen on multiple interfaces and
// multiple ports. Binding to port 0 will make the operating system // multiple ports. Binding to port 0 will make the operating system
// pick the port. The default is "0.0.0.0:6881,[::]:6881", which binds // pick the port.
// to all interfaces on port 6881.
// //
// a port that has an "s" suffix will accept SSL connections. (note // a port that has an "s" suffix will accept SSL connections. (note
// that SSL sockets are not enabled by default). // that SSL sockets are not enabled by default).
@ -224,6 +223,8 @@ namespace aux {
// ``[::]:0s`` - will accept SSL connections on a port chosen by the // ``[::]:0s`` - will accept SSL connections on a port chosen by the
// OS. And not accept non-SSL connections at all. // OS. And not accept non-SSL connections at all.
// //
// ``0.0.0.0:6881,[::]:6881`` - binds to all interfaces on port 6881
//
// Windows OS network adapter device name can be specified with GUID. // Windows OS network adapter device name can be specified with GUID.
// It can be obtained from "netsh lan show interfaces" command output. // It can be obtained from "netsh lan show interfaces" command output.
// GUID must be uppercased string embraced in curly brackets. // GUID must be uppercased string embraced in curly brackets.
@ -256,8 +257,7 @@ namespace aux {
// This is a comma-separated list of IP port-pairs. They will be added // This is a comma-separated list of IP port-pairs. They will be added
// to the DHT node (if it's enabled) as back-up nodes in case we don't // to the DHT node (if it's enabled) as back-up nodes in case we don't
// know of any. This setting will contain one or more bootstrap nodes // know of any.
// by default.
// //
// Changing these after the DHT has been started may not have any // Changing these after the DHT has been started may not have any
// effect until the DHT is restarted. // effect until the DHT is restarted.
@ -271,8 +271,8 @@ namespace aux {
enum bool_types enum bool_types
{ {
// determines if connections from the same IP address as existing // determines if connections from the same IP address as existing
// connections should be rejected or not. Multiple connections from // connections should be rejected or not. Rejecting multiple connections
// the same IP address is not allowed by default, to prevent abusive // from the same IP address will prevent abusive
// behavior by peers. It may be useful to allow such connections in // behavior by peers. It may be useful to allow such connections in
// cases where simulations are run on the same machine, and all peers // cases where simulations are run on the same machine, and all peers
// in a swarm has the same IP address. // in a swarm has the same IP address.
@ -305,8 +305,8 @@ namespace aux {
// ``use_dht_as_fallback`` determines how the DHT is used. If this is // ``use_dht_as_fallback`` determines how the DHT is used. If this is
// true, the DHT will only be used for torrents where all trackers in // true, the DHT will only be used for torrents where all trackers in
// its tracker list has failed. Either by an explicit error message or // its tracker list has failed. Either by an explicit error message or
// a time out. This is false by default, which means the DHT is used // a time out. If this is false, the DHT is used regardless of if the
// by default regardless of if the trackers fail or not. // trackers fail or not.
use_dht_as_fallback, use_dht_as_fallback,
// ``upnp_ignore_nonrouters`` indicates whether or not the UPnP // ``upnp_ignore_nonrouters`` indicates whether or not the UPnP
@ -346,9 +346,8 @@ namespace aux {
coalesce_reads, coalesce_reads,
coalesce_writes, coalesce_writes,
// prefer seeding torrents when determining which torrents to give // if true, prefer seeding torrents when determining which torrents to give
// active slots to, the default is false which gives preference to // active slots to. If false, give preference to downloading torrents
// downloading torrents
auto_manage_prefer_seeds, auto_manage_prefer_seeds,
// if ``dont_count_slow_torrents`` is true, torrents without any // if ``dont_count_slow_torrents`` is true, torrents without any
@ -378,18 +377,16 @@ namespace aux {
// are treated. If this is set to true, all trackers in the same tier // are treated. If this is set to true, all trackers in the same tier
// are announced to in parallel. If all trackers in tier 0 fails, all // are announced to in parallel. If all trackers in tier 0 fails, all
// trackers in tier 1 are announced as well. If it's set to false, the // trackers in tier 1 are announced as well. If it's set to false, the
// behavior is as defined by the multi tracker specification. It // behavior is as defined by the multi tracker specification.
// defaults to false, which is the same behavior previous versions of
// libtorrent has had as well.
// //
// ``announce_to_all_tiers`` also controls how multi tracker torrents // ``announce_to_all_tiers`` also controls how multi tracker torrents
// are treated. When this is set to true, one tracker from each tier // are treated. When this is set to true, one tracker from each tier
// is announced to. This is the uTorrent behavior. This is false by // is announced to. This is the uTorrent behavior. To be compliant
// default in order to comply with the multi-tracker specification. // with the Multi-tracker specification, set it to false.
announce_to_all_tiers, announce_to_all_tiers,
announce_to_all_trackers, announce_to_all_trackers,
// ``prefer_udp_trackers`` is true by default. It means that trackers // ``prefer_udp_trackers``: true means that trackers
// may be rearranged in a way that udp trackers are always tried // may be rearranged in a way that udp trackers are always tried
// before http trackers for the same hostname. Setting this to false // before http trackers for the same hostname. Setting this to false
// means that the trackers' tier is respected and there's no // means that the trackers' tier is respected and there's no
@ -426,7 +423,7 @@ namespace aux {
#if TORRENT_ABI_VERSION == 1 #if TORRENT_ABI_VERSION == 1
// ``low_prio_disk`` determines if the disk I/O should use a normal or // ``low_prio_disk`` determines if the disk I/O should use a normal or
// low priority policy. This defaults to true, which means that it's // low priority policy. True, means that it's
// low priority by default. Other processes doing disk I/O will // low priority by default. Other processes doing disk I/O will
// normally take priority in this mode. This is meant to improve the // normally take priority in this mode. This is meant to improve the
// overall responsiveness of the system while downloading in the // overall responsiveness of the system while downloading in the
@ -461,7 +458,7 @@ namespace aux {
// some disk performance improvements. // some disk performance improvements.
no_atime_storage, no_atime_storage,
// ``incoming_starts_queued_torrents`` defaults to false. If a torrent // ``incoming_starts_queued_torrents``. If a torrent
// has been paused by the auto managed feature in libtorrent, i.e. the // has been paused by the auto managed feature in libtorrent, i.e. the
// torrent is paused and auto managed, this feature affects whether or // torrent is paused and auto managed, this feature affects whether or
// not it is automatically started on an incoming connection. The main // not it is automatically started on an incoming connection. The main
@ -478,7 +475,7 @@ namespace aux {
// bytes // bytes
report_true_downloaded, report_true_downloaded,
// ``strict_end_game_mode`` defaults to true, and controls when a // ``strict_end_game_mode`` controls when a
// block may be requested twice. If this is ``true``, a block may only // block may be requested twice. If this is ``true``, a block may only
// be requested twice when there's ay least one request to every piece // be requested twice when there's ay least one request to every piece
// that's left to download in the torrent. This may slow down progress // that's left to download in the torrent. This may slow down progress
@ -508,8 +505,8 @@ namespace aux {
#if TORRENT_ABI_VERSION == 1 #if TORRENT_ABI_VERSION == 1
// ``ignore_resume_timestamps`` determines if the storage, when // ``ignore_resume_timestamps`` determines if the storage, when
// loading resume data files, should verify that the file modification // loading resume data files, should verify that the file modification
// time with the timestamps in the resume data. This defaults to // time with the timestamps in the resume data. False, means timestamps
// false, which means timestamps are taken into account, and resume // are taken into account, and resume
// data is less likely to accepted (torrents are more likely to be // data is less likely to accepted (torrents are more likely to be
// fully checked when loaded). It might be useful to set this to true // fully checked when loaded). It might be useful to set this to true
// if your network is faster than your disk, and it would be faster to // if your network is faster than your disk, and it would be faster to
@ -523,13 +520,13 @@ namespace aux {
// ``no_recheck_incomplete_resume`` determines if the storage should // ``no_recheck_incomplete_resume`` determines if the storage should
// check the whole files when resume data is incomplete or missing or // check the whole files when resume data is incomplete or missing or
// whether it should simply assume we don't have any of the data. By // whether it should simply assume we don't have any of the data. If
// default, this is determined by the existence of any of the files. // false, any existing files will be checked.
// By setting this setting to true, the files won't be checked, but // By setting this setting to true, the files won't be checked, but
// will go straight to download mode. // will go straight to download mode.
no_recheck_incomplete_resume, no_recheck_incomplete_resume,
// ``anonymous_mode`` defaults to false. When set to true, the client // ``anonymous_mode``: When set to true, the client
// tries to hide its identity to a certain degree. The user-agent will be // tries to hide its identity to a certain degree. The user-agent will be
// reset to an empty string (except for private torrents). Trackers // reset to an empty string (except for private torrents). Trackers
// will only be used if they are using a proxy server. // will only be used if they are using a proxy server.
@ -545,7 +542,7 @@ namespace aux {
anonymous_mode, anonymous_mode,
// specifies whether downloads from web seeds is reported to the // specifies whether downloads from web seeds is reported to the
// tracker or not. Defaults to on. Turning it off also excludes web // tracker or not. Turning it off also excludes web
// seed traffic from other stats and download rate reporting via the // seed traffic from other stats and download rate reporting via the
// libtorrent API. // libtorrent API.
report_web_seed_downloads, report_web_seed_downloads,
@ -570,7 +567,7 @@ namespace aux {
// ``seeding_outgoing_connections`` determines if seeding (and // ``seeding_outgoing_connections`` determines if seeding (and
// finished) torrents should attempt to make outgoing connections or // finished) torrents should attempt to make outgoing connections or
// not. By default this is true. It may be set to false in very // not. It may be set to false in very
// specific applications where the cost of making outgoing connections // specific applications where the cost of making outgoing connections
// is high, and there are no or small benefits of doing so. For // is high, and there are no or small benefits of doing so. For
// instance, if no nodes are behind a firewall or a NAT, seeds don't // instance, if no nodes are behind a firewall or a NAT, seeds don't
@ -582,7 +579,7 @@ namespace aux {
// precaution to avoid being part of a DDoS attack // precaution to avoid being part of a DDoS attack
no_connect_privileged_ports, no_connect_privileged_ports,
// ``smooth_connects`` is true by default, which means the number of // ``smooth_connects`` means the number of
// connection attempts per second may be limited to below the // connection attempts per second may be limited to below the
// ``connection_speed``, in case we're close to bump up against the // ``connection_speed``, in case we're close to bump up against the
// limit of number of connections. The intention of this setting is to // limit of number of connections. The intention of this setting is to
@ -595,14 +592,14 @@ namespace aux {
// the first request per http connection will include the user agent // the first request per http connection will include the user agent
always_send_user_agent, always_send_user_agent,
// ``apply_ip_filter_to_trackers`` defaults to true. It determines // ``apply_ip_filter_to_trackers`` determines
// whether the IP filter applies to trackers as well as peers. If this // whether the IP filter applies to trackers as well as peers. If this
// is set to false, trackers are exempt from the IP filter (if there // is set to false, trackers are exempt from the IP filter (if there
// is one). If no IP filter is set, this setting is irrelevant. // is one). If no IP filter is set, this setting is irrelevant.
apply_ip_filter_to_trackers, apply_ip_filter_to_trackers,
#if TORRENT_ABI_VERSION == 1 #if TORRENT_ABI_VERSION == 1
// ``use_disk_read_ahead`` defaults to true and will attempt to // ``use_disk_read_ahead`` if true will attempt to
// optimize disk reads by giving the operating system heads up of disk // optimize disk reads by giving the operating system heads up of disk
// read requests as they are queued in the disk job queue. // read requests as they are queued in the disk job queue.
use_disk_read_ahead TORRENT_DEPRECATED_ENUM, use_disk_read_ahead TORRENT_DEPRECATED_ENUM,
@ -838,8 +835,8 @@ namespace aux {
// ``peer_timeout`` is the number of seconds the peer connection // ``peer_timeout`` is the number of seconds the peer connection
// should wait (for any activity on the peer connection) before // should wait (for any activity on the peer connection) before
// closing it due to time out. This defaults to 120 seconds, since // closing it due to time out. 120 seconds is
// that's what's specified in the protocol specification. After half // specified in the protocol specification. After half
// the time out, a keep alive message is sent. // the time out, a keep alive message is sent.
peer_timeout, peer_timeout,
@ -891,7 +888,7 @@ namespace aux {
connection_speed, connection_speed,
// if a peer is uninteresting and uninterested for longer than this // if a peer is uninteresting and uninterested for longer than this
// number of seconds, it will be disconnected. default is 10 minutes // number of seconds, it will be disconnected.
inactivity_timeout, inactivity_timeout,
// ``unchoke_interval`` is the number of seconds between // ``unchoke_interval`` is the number of seconds between
@ -912,9 +909,9 @@ namespace aux {
num_want, num_want,
// ``initial_picker_threshold`` specifies the number of pieces we need // ``initial_picker_threshold`` specifies the number of pieces we need
// before we switch to rarest first picking. This defaults to 4, which // before we switch to rarest first picking. The first
// means the 4 first pieces in any torrent are picked at random, the // ``initial_picker_threshold`` pieces in any torrent are picked at random
// following pieces are picked in rarest first order. // , the following pieces are picked in rarest first order.
initial_picker_threshold, initial_picker_threshold,
// the number of allowed pieces to send to peers that supports the // the number of allowed pieces to send to peers that supports the
@ -925,8 +922,7 @@ namespace aux {
// suggest messages to create a bias of its peers to request certain // suggest messages to create a bias of its peers to request certain
// pieces. The modes are: // pieces. The modes are:
// //
// * ``no_piece_suggestions`` which is the default and will not send // * ``no_piece_suggestions`` which will not send out suggest messages.
// out suggest messages.
// * ``suggest_read_cache`` which will send out suggest messages for // * ``suggest_read_cache`` which will send out suggest messages for
// the most recent pieces that are in the read cache. // the most recent pieces that are in the read cache.
suggest_mode, suggest_mode,
@ -1023,7 +1019,7 @@ namespace aux {
// //
// ``cache_expiry`` is the number of seconds from the last cached write // ``cache_expiry`` is the number of seconds from the last cached write
// to a piece in the write cache, to when it's forcefully flushed to // to a piece in the write cache, to when it's forcefully flushed to
// disk. Default is 60 second. // disk.
// //
// On 32 bit builds, the effective cache size will be limited to 3/4 of // On 32 bit builds, the effective cache size will be limited to 3/4 of
// 2 GiB to avoid exceeding the virtual address space limit. // 2 GiB to avoid exceeding the virtual address space limit.
@ -1039,8 +1035,7 @@ namespace aux {
// versus read and write mode. The options are: // versus read and write mode. The options are:
// //
// enable_os_cache // enable_os_cache
// This is the default and files are opened normally, with the OS // Files are opened normally, with the OS caching reads and writes.
// caching reads and writes.
// disable_os_cache // disable_os_cache
// This opens all files in no-cache mode. This corresponds to the // This opens all files in no-cache mode. This corresponds to the
// OS not letting blocks for the files linger in the cache. This // OS not letting blocks for the files linger in the cache. This
@ -1073,9 +1068,8 @@ namespace aux {
num_outgoing_ports, num_outgoing_ports,
// ``peer_tos`` determines the TOS byte set in the IP header of every // ``peer_tos`` determines the TOS byte set in the IP header of every
// packet sent to peers (including web seeds). The default value for // packet sent to peers (including web seeds). ``0x0`` means no marking,
// this is ``0x0`` (no marking). One potentially useful TOS mark is // ``0x20`` represents the *QBone scavenger service*. For more
// ``0x20``, this represents the *QBone scavenger service*. For more
// details, see QBSS_. // details, see QBSS_.
// //
// .. _`QBSS`: http://qbone.internet2.edu/qbss/ // .. _`QBSS`: http://qbone.internet2.edu/qbss/
@ -1106,17 +1100,13 @@ namespace aux {
// managed) torrents. This limit also applies to slow torrents. // managed) torrents. This limit also applies to slow torrents.
// //
// ``active_dht_limit`` is the max number of torrents to announce to // ``active_dht_limit`` is the max number of torrents to announce to
// the DHT. By default this is set to 88, which is no more than one // the DHT.
// DHT announce every 10 seconds.
// //
// ``active_tracker_limit`` is the max number of torrents to announce // ``active_tracker_limit`` is the max number of torrents to announce
// to their trackers. By default this is 360, which is no more than // to their trackers.
// one announce every 5 seconds.
// //
// ``active_lsd_limit`` is the max number of torrents to announce to // ``active_lsd_limit`` is the max number of torrents to announce to
// the local network over the local service discovery protocol. By // the local network over the local service discovery protocol.
// default this is 80, which is no more than one announce every 5
// seconds (assuming the default announce interval of 5 minutes).
// //
// You can have more torrents *active*, even though they are not // You can have more torrents *active*, even though they are not
// announced to the DHT, lsd or their tracker. If some peer knows // announced to the DHT, lsd or their tracker. If some peer knows
@ -1176,8 +1166,7 @@ namespace aux {
// limit on how many peers we'll keep in the peer list. // limit on how many peers we'll keep in the peer list.
// //
// ``max_paused_peerlist_size`` is the max peer list size used for // ``max_paused_peerlist_size`` is the max peer list size used for
// torrents that are paused. This default to the same as // torrents that are paused. This can be used to save memory for paused
// ``max_peerlist_size``, but can be used to save memory for paused
// torrents, since it's not as important for them to keep a large peer // torrents, since it's not as important for them to keep a large peer
// list. // list.
max_peerlist_size, max_peerlist_size,
@ -1197,9 +1186,6 @@ namespace aux {
// ``seeding_piece_quota`` is the number of pieces to send to a peer, // ``seeding_piece_quota`` is the number of pieces to send to a peer,
// when seeding, before rotating in another peer to the unchoke set. // when seeding, before rotating in another peer to the unchoke set.
// It defaults to 3 pieces, which means that when seeding, any peer
// we've sent more than this number of pieces to will be unchoked in
// favour of a choked peer.
seeding_piece_quota, seeding_piece_quota,
// ``max_rejects`` is the number of piece requests we will reject in a // ``max_rejects`` is the number of piece requests we will reject in a
@ -1207,8 +1193,8 @@ namespace aux {
// and is disconnected. // and is disconnected.
max_rejects, max_rejects,
// specifies the buffer sizes set on peer sockets. 0 (which is the // specifies the buffer sizes set on peer sockets. 0 means the OS
// default) means the OS default (i.e. don't change the buffer sizes). // default (i.e. don't change the buffer sizes).
// The socket buffer sizes are changed using setsockopt() with // The socket buffer sizes are changed using setsockopt() with
// SOL_SOCKET/SO_RCVBUF and SO_SNDBUFFER. // SOL_SOCKET/SO_RCVBUF and SO_SNDBUFFER.
recv_socket_buffer_size, recv_socket_buffer_size,
@ -1220,8 +1206,8 @@ namespace aux {
#if TORRENT_ABI_VERSION == 1 #if TORRENT_ABI_VERSION == 1
// ``file_checks_delay_per_block`` is the number of milliseconds to // ``file_checks_delay_per_block`` is the number of milliseconds to
// sleep in between disk read operations when checking torrents. This // sleep in between disk read operations when checking torrents.
// defaults to 0, but can be set to higher numbers to slow down the // This can be set to higher numbers to slow down the
// rate at which data is read from the disk while checking. This may // rate at which data is read from the disk while checking. This may
// be useful for background tasks that doesn't matter if they take a // be useful for background tasks that doesn't matter if they take a
// bit longer, as long as they leave disk I/O time for other // bit longer, as long as they leave disk I/O time for other
@ -1257,12 +1243,10 @@ namespace aux {
// ``max_suggest_pieces`` is the max number of suggested piece indices // ``max_suggest_pieces`` is the max number of suggested piece indices
// received from a peer that's remembered. If a peer floods suggest // received from a peer that's remembered. If a peer floods suggest
// messages, this limit prevents libtorrent from using too much RAM. // messages, this limit prevents libtorrent from using too much RAM.
// It defaults to 10.
max_suggest_pieces, max_suggest_pieces,
// ``local_service_announce_interval`` is the time between local // ``local_service_announce_interval`` is the time between local
// network announces for a torrent. By default, when local service // network announces for a torrent.
// discovery is enabled a torrent announces itself every 5 minutes.
// This interval is specified in seconds. // This interval is specified in seconds.
local_service_announce_interval, local_service_announce_interval,
@ -1272,7 +1256,7 @@ namespace aux {
// ``udp_tracker_token_expiry`` is the number of seconds libtorrent // ``udp_tracker_token_expiry`` is the number of seconds libtorrent
// will keep UDP tracker connection tokens around for. This is // will keep UDP tracker connection tokens around for. This is
// specified to be 60 seconds, and defaults to that. The higher this // specified to be 60 seconds. The higher this
// value is, the fewer packets have to be sent to the UDP tracker. In // value is, the fewer packets have to be sent to the UDP tracker. In
// order for higher values to work, the tracker needs to be configured // order for higher values to work, the tracker needs to be configured
// to match the expiration time for tokens. // to match the expiration time for tokens.
@ -1280,7 +1264,7 @@ namespace aux {
#if TORRENT_ABI_VERSION == 1 #if TORRENT_ABI_VERSION == 1
// ``default_cache_min_age`` is the minimum number of seconds any read // ``default_cache_min_age`` is the minimum number of seconds any read
// cache line is kept in the cache. This defaults to one second but // cache line is kept in the cache. This
// may be greater if ``guided_read_cache`` is enabled. Having a lower // may be greater if ``guided_read_cache`` is enabled. Having a lower
// bound on the time a cache line stays in the cache is an attempt // bound on the time a cache line stays in the cache is an attempt
// to avoid swapping the same pieces in and out of the cache in case // to avoid swapping the same pieces in and out of the cache in case
@ -1291,28 +1275,28 @@ namespace aux {
#endif #endif
// ``num_optimistic_unchoke_slots`` is the number of optimistic // ``num_optimistic_unchoke_slots`` is the number of optimistic
// unchoke slots to use. It defaults to 0, which means automatic. // unchoke slots to use.
// Having a higher number of optimistic unchoke slots mean you will // Having a higher number of optimistic unchoke slots mean you will
// find the good peers faster but with the trade-off to use up more // find the good peers faster but with the trade-off to use up more
// bandwidth. When this is set to 0, libtorrent opens up 20% of your // bandwidth. 0 means automatic, where libtorrent opens up 20% of your
// allowed upload slots as optimistic unchoke slots. // allowed upload slots as optimistic unchoke slots.
num_optimistic_unchoke_slots, num_optimistic_unchoke_slots,
// ``default_est_reciprocation_rate`` is the assumed reciprocation // ``default_est_reciprocation_rate`` is the assumed reciprocation
// rate from peers when using the BitTyrant choker. This defaults to // rate from peers when using the BitTyrant choker. If set too high,
// 14 kiB/s. If set too high, you will over-estimate your peers and be // you will over-estimate your peers and be
// more altruistic while finding the true reciprocation rate, if it's // more altruistic while finding the true reciprocation rate, if it's
// set too low, you'll be too stingy and waste finding the true // set too low, you'll be too stingy and waste finding the true
// reciprocation rate. // reciprocation rate.
// //
// ``increase_est_reciprocation_rate`` specifies how many percent the // ``increase_est_reciprocation_rate`` specifies how many percent the
// estimated reciprocation rate should be increased by each unchoke // estimated reciprocation rate should be increased by each unchoke
// interval a peer is still choking us back. This defaults to 20%. // interval a peer is still choking us back.
// This only applies to the BitTyrant choker. // This only applies to the BitTyrant choker.
// //
// ``decrease_est_reciprocation_rate`` specifies how many percent the // ``decrease_est_reciprocation_rate`` specifies how many percent the
// estimated reciprocation rate should be decreased by each unchoke // estimated reciprocation rate should be decreased by each unchoke
// interval a peer unchokes us. This default to 3%. This only applies // interval a peer unchokes us. This only applies
// to the BitTyrant choker. // to the BitTyrant choker.
default_est_reciprocation_rate, default_est_reciprocation_rate,
increase_est_reciprocation_rate, increase_est_reciprocation_rate,
@ -1333,7 +1317,7 @@ namespace aux {
tick_interval, tick_interval,
// ``share_mode_target`` specifies the target share ratio for share // ``share_mode_target`` specifies the target share ratio for share
// mode torrents. This defaults to 3, meaning we'll try to upload 3 // mode torrents. If set to 3, we'll try to upload 3
// times as much as we download. Setting this very high, will make it // times as much as we download. Setting this very high, will make it
// very conservative and you might end up not downloading anything // very conservative and you might end up not downloading anything
// ever (and not affecting your share ratio). It does not make any // ever (and not affecting your share ratio). It does not make any
@ -1364,7 +1348,7 @@ namespace aux {
#if TORRENT_ABI_VERSION == 1 #if TORRENT_ABI_VERSION == 1
// ``dht_upload_rate_limit`` sets the rate limit on the DHT. This is // ``dht_upload_rate_limit`` sets the rate limit on the DHT. This is
// specified in bytes per second and defaults to 4000. For busy boxes // specified in bytes per second. For busy boxes
// with lots of torrents that requires more DHT traffic, this should // with lots of torrents that requires more DHT traffic, this should
// be raised. // be raised.
dht_upload_rate_limit TORRENT_DEPRECATED_ENUM, dht_upload_rate_limit TORRENT_DEPRECATED_ENUM,
@ -1410,15 +1394,15 @@ namespace aux {
// milliseconds. A high value will make uTP connections more // milliseconds. A high value will make uTP connections more
// aggressive and cause longer queues in the upload bottleneck. It // aggressive and cause longer queues in the upload bottleneck. It
// cannot be too low, since the noise in the measurements would cause // cannot be too low, since the noise in the measurements would cause
// it to send too slow. The default is 50 milliseconds. // it to send too slow.
// ``utp_gain_factor`` is the number of bytes the uTP congestion // ``utp_gain_factor`` is the number of bytes the uTP congestion
// window can increase at the most in one RTT. This defaults to 300 // window can increase at the most in one RTT.
// bytes. If this is set too high, the congestion controller reacts // If this is set too high, the congestion controller reacts
// too hard to noise and will not be stable, if it's set too low, it // too hard to noise and will not be stable, if it's set too low, it
// will react slow to congestion and not back off as fast. // will react slow to congestion and not back off as fast.
// //
// ``utp_min_timeout`` is the shortest allowed uTP socket timeout, // ``utp_min_timeout`` is the shortest allowed uTP socket timeout,
// specified in milliseconds. This defaults to 500 milliseconds. The // specified in milliseconds. The
// timeout depends on the RTT of the connection, but is never smaller // timeout depends on the RTT of the connection, but is never smaller
// than this value. A connection times out when every packet in a // than this value. A connection times out when every packet in a
// window is lost, or when a packet is lost twice in a row (i.e. the // window is lost, or when a packet is lost twice in a row (i.e. the
@ -1435,9 +1419,8 @@ namespace aux {
// packet (in a row), the timeout is doubled. ``utp_loss_multiplier`` // packet (in a row), the timeout is doubled. ``utp_loss_multiplier``
// controls how the congestion window is changed when a packet loss is // controls how the congestion window is changed when a packet loss is
// experienced. It's specified as a percentage multiplier for // experienced. It's specified as a percentage multiplier for
// ``cwnd``. By default it's set to 50 (i.e. cut in half). Do not // ``cwnd``. Do not change this value unless you know what you're doing.
// change this value unless you know what you're doing. Never set it // Never set it higher than 100.
// higher than 100.
utp_target_delay, utp_target_delay,
utp_gain_factor, utp_gain_factor,
utp_min_timeout, utp_min_timeout,
@ -1468,7 +1451,7 @@ namespace aux {
// ``listen_queue_size`` is the value passed in to listen() for the // ``listen_queue_size`` is the value passed in to listen() for the
// listen socket. It is the number of outstanding incoming connections // listen socket. It is the number of outstanding incoming connections
// to queue up while we're not actively waiting for a connection to be // to queue up while we're not actively waiting for a connection to be
// accepted. The default is 5 which should be sufficient for any // accepted. 5 should be sufficient for any
// normal client. If this is a high performance server which expects // normal client. If this is a high performance server which expects
// to receive a lot of connections, or used in a simulator or test, it // to receive a lot of connections, or used in a simulator or test, it
// might make sense to raise this number. It will not take affect // might make sense to raise this number. It will not take affect
@ -1501,7 +1484,7 @@ namespace aux {
// DEPRECATED: use aio_threads instead // DEPRECATED: use aio_threads instead
// ``hashing_threads`` is the number of threads to use for piece hash // ``hashing_threads`` is the number of threads to use for piece hash
// verification. It defaults to 1. For very high download rates, on // verification. For very high download rates, on
// machines with multiple cores, this could be incremented. Setting it // machines with multiple cores, this could be incremented. Setting it
// higher than the number of CPU cores would presumably not provide // higher than the number of CPU cores would presumably not provide
// any benefit of setting it to the number of cores. If it's set to 0, // any benefit of setting it to the number of cores. If it's set to 0,
@ -1649,7 +1632,7 @@ namespace aux {
inactive_down_rate, inactive_down_rate,
inactive_up_rate, inactive_up_rate,
// proxy to use, defaults to none. see proxy_type_t. // proxy to use. see proxy_type_t.
proxy_type, proxy_type,
// the port of the proxy server // the port of the proxy server
@ -1672,9 +1655,8 @@ namespace aux {
cache_size_volatile, cache_size_volatile,
// The maximum request range of an url seed in bytes. This value // The maximum request range of an url seed in bytes. This value
// defines the largest possible sequential web seed request. Default // defines the largest possible sequential web seed request. Lower values
// is 16 * 1024 * 1024. Lower values are possible but will be ignored // are possible but will be ignored if they are lower then piece size.
// if they are lower then piece size.
// This value should be related to your download speed to prevent // This value should be related to your download speed to prevent
// libtorrent from creating too many expensive http requests per // libtorrent from creating too many expensive http requests per
// second. You can select a value as high as you want but keep in mind // second. You can select a value as high as you want but keep in mind
@ -1792,8 +1774,7 @@ namespace aux {
enum proxy_type_t : std::uint8_t enum proxy_type_t : std::uint8_t
{ {
// This is the default, no proxy server is used, all other fields are // No proxy server is used and all other fields are ignored.
// ignored.
none, none,
// The server is assumed to be a `SOCKS4 server`_ that requires a // The server is assumed to be a `SOCKS4 server`_ that requires a