kitetorrent/io.github.yuroyami.kitetorrent.settings/IntSetting

IntSetting

The integer-typed session settings: a port of settings_pack::int_types (settings_pack.hpp) together with the int_settings default-value table from settings_pack.cpp.

Each constant is a full 16-bit setting key (int_type_base | index). The index positions are kept byte-identical to libtorrent, including every deprecated slot (old disk-cache sizes, BitTyrant rates, half-open limit, …). Deprecated slots get no named constant but still occupy their index in IntSettingDefaults.

Two platform-conditional defaults are resolved to their non-Windows values (the portable default for KiteTorrent's multiplatform targets):

disk_io_write_mode ->IoBufferMode.ENABLE_OS_CACHE (Windows uses write_through)
close_file_interval -> 0 (Windows uses 240)

Properties

ACTIVE_CHECKING

const val ACTIVE_CHECKING: Int

Limit on simultaneously checking torrents.

ACTIVE_DHT_LIMIT

const val ACTIVE_DHT_LIMIT: Int

Max torrents announced to the DHT.

ACTIVE_DOWNLOADS

const val ACTIVE_DOWNLOADS: Int

Upper limit on active downloading torrents (auto-managed); -1 = unlimited.

ACTIVE_LIMIT

const val ACTIVE_LIMIT: Int

Hard limit on active (auto-managed) torrents.

ACTIVE_LSD_LIMIT

const val ACTIVE_LSD_LIMIT: Int

Max torrents announced over local service discovery.

ACTIVE_SEEDS

const val ACTIVE_SEEDS: Int

Upper limit on active seeding torrents (auto-managed); -1 = unlimited.

ACTIVE_TRACKER_LIMIT

const val ACTIVE_TRACKER_LIMIT: Int

Max torrents announced to their trackers.

AIO_THREADS

const val AIO_THREADS: Int

Number of aio (disk) I/O threads.

ALERT_MASK

const val ALERT_MASK: Int

Bitmask of alert_category_t flags selecting which alerts to receive.

ALERT_QUEUE_SIZE

const val ALERT_QUEUE_SIZE: Int

Max alerts queued internally before new alerts are dropped.

ALLOWED_ENC_LEVEL

const val ALLOWED_ENC_LEVEL: Int

Allowed encryption level; see EncLevel.

ALLOWED_FAST_SET_SIZE

const val ALLOWED_FAST_SET_SIZE: Int

Number of allowed-fast pieces offered to fast-extension peers.

ANNOUNCE_PORT

const val ANNOUNCE_PORT: Int

port parameter sent to remote trackers (0 = use the listening port).

AUTO_MANAGE_INTERVAL

const val AUTO_MANAGE_INTERVAL: Int

Seconds between auto-manage queue updates/rotations.

AUTO_MANAGE_STARTUP

const val AUTO_MANAGE_STARTUP: Int

Seconds a freshly-started torrent stays considered active regardless of rate.

AUTO_SCRAPE_INTERVAL

const val AUTO_SCRAPE_INTERVAL: Int

Seconds between scrapes of queued torrents.

AUTO_SCRAPE_MIN_INTERVAL

const val AUTO_SCRAPE_MIN_INTERVAL: Int

Minimum seconds between any automatic scrape.

CHECKING_MEM_USAGE

const val CHECKING_MEM_USAGE: Int

Outstanding 16 KiB blocks while checking torrents.

CHOKING_ALGORITHM

const val CHOKING_ALGORITHM: Int

Downloading-unchoke algorithm; see ChokingAlgorithm.

CLOSE_FILE_INTERVAL

const val CLOSE_FILE_INTERVAL: Int

Seconds between closing the longest-open file (0 = disabled; portable default).

CONNECT_SEED_EVERY_N_DOWNLOAD

const val CONNECT_SEED_EVERY_N_DOWNLOAD: Int

Every n:th connection attempt is given to a finished torrent.

CONNECTION_SPEED

const val CONNECTION_SPEED: Int

Connection attempts per second; 0 means no outgoing connections.

CONNECTIONS_LIMIT

const val CONNECTIONS_LIMIT: Int

Global limit on open connections (min 2 per torrent regardless).

CONNECTIONS_SLACK

const val CONNECTIONS_SLACK: Int

Incoming connections accepted above the limit to potentially replace existing ones.

DHT_ANNOUNCE_INTERVAL

const val DHT_ANNOUNCE_INTERVAL: Int

Seconds between DHT announces.

DHT_BLOCK_RATELIMIT

const val DHT_BLOCK_RATELIMIT: Int

Max packets/s a DHT node may send without being banned.

DHT_BLOCK_TIMEOUT

const val DHT_BLOCK_TIMEOUT: Int

Seconds a DHT node is banned after exceeding the rate limit.

DHT_ITEM_LIFETIME

const val DHT_ITEM_LIFETIME: Int

Seconds an (im)mutable DHT item lives (0 = never expires).

DHT_MAX_DHT_ITEMS

const val DHT_MAX_DHT_ITEMS: Int

Max items the DHT will store.

DHT_MAX_FAIL_COUNT

const val DHT_MAX_FAIL_COUNT: Int

Max failed contact attempts before a DHT node is removed.

DHT_MAX_INFOHASHES_SAMPLE_COUNT

const val DHT_MAX_INFOHASHES_SAMPLE_COUNT: Int

Max elements in the sampled info-hashes subset.

DHT_MAX_PEERS

const val DHT_MAX_PEERS: Int

Max peers stored per torrent in the DHT.

DHT_MAX_PEERS_REPLY

const val DHT_MAX_PEERS_REPLY: Int

Max peers returned in a DHT get_peers reply.

DHT_MAX_TORRENT_SEARCH_REPLY

const val DHT_MAX_TORRENT_SEARCH_REPLY: Int

Max torrents returned in a DHT torrent-search reply.

DHT_MAX_TORRENTS

const val DHT_MAX_TORRENTS: Int

Upper limit on torrents tracked from the DHT.

DHT_SAMPLE_INFOHASHES_INTERVAL

const val DHT_SAMPLE_INFOHASHES_INTERVAL: Int

Info-hashes sample recomputation interval, in seconds (0..21600).

DHT_SEARCH_BRANCHING

const val DHT_SEARCH_BRANCHING: Int

DHT search branching factor (alpha in the Kademlia paper).

DHT_UPLOAD_RATE_LIMIT

const val DHT_UPLOAD_RATE_LIMIT: Int

Average bytes/s the DHT may send.

DISK_IO_READ_MODE

const val DISK_IO_READ_MODE: Int

Read-mode file open behaviour; see IoBufferMode.

DISK_IO_WRITE_MODE

const val DISK_IO_WRITE_MODE: Int

How files are opened in read-only vs read/write mode; see IoBufferMode.

DISK_WRITE_MODE

const val DISK_WRITE_MODE: Int

mmap-vs-pwrite disk-write mode (mmap_disk_io only); see MmapWriteMode.

DOWNLOAD_RATE_LIMIT

const val DOWNLOAD_RATE_LIMIT: Int

Session-global download rate limit in bytes/s (0 = unlimited).

FILE_POOL_SIZE

const val FILE_POOL_SIZE: Int

Upper limit on simultaneously open files this session keeps.

HANDSHAKE_TIMEOUT

const val HANDSHAKE_TIMEOUT: Int

Seconds to wait for a handshake response.

HASHING_THREADS

const val HASHING_THREADS: Int

Disk I/O threads dedicated to piece-hash verification (full checks).

I2P_INBOUND_LENGTH

const val I2P_INBOUND_LENGTH: Int

i2p inbound tunnel hop count 0..7.

I2P_INBOUND_LENGTH_VARIANCE

const val I2P_INBOUND_LENGTH_VARIANCE: Int

Variance for i2p inbound tunnel length -7..7.

I2P_INBOUND_QUANTITY

const val I2P_INBOUND_QUANTITY: Int

i2p inbound tunnel quantity 1..16.

I2P_OUTBOUND_LENGTH

const val I2P_OUTBOUND_LENGTH: Int

i2p outbound tunnel hop count 0..7.

I2P_OUTBOUND_LENGTH_VARIANCE

const val I2P_OUTBOUND_LENGTH_VARIANCE: Int

Variance for i2p outbound tunnel length -7..7.

I2P_OUTBOUND_QUANTITY

const val I2P_OUTBOUND_QUANTITY: Int

i2p outbound tunnel quantity 1..16.

I2P_PORT

const val I2P_PORT: Int

i2p SAM bridge port.

IN_ENC_POLICY

const val IN_ENC_POLICY: Int

Incoming-connection encryption policy; see EncPolicy.

INACTIVE_DOWN_RATE

const val INACTIVE_DOWN_RATE: Int

Download-rate threshold (bytes/s) under which a torrent counts as inactive.

INACTIVE_UP_RATE

const val INACTIVE_UP_RATE: Int

Upload-rate threshold (bytes/s) under which a torrent counts as inactive.

INACTIVITY_TIMEOUT

const val INACTIVITY_TIMEOUT: Int

Seconds a mutually-uninterested peer stays before disconnect.

INITIAL_PICKER_THRESHOLD

const val INITIAL_PICKER_THRESHOLD: Int

Pieces picked at random before switching to rarest-first.

LISTEN_QUEUE_SIZE

const val LISTEN_QUEUE_SIZE: Int

Backlog passed to listen() for the listen socket.

LOCAL_SERVICE_ANNOUNCE_INTERVAL

const val LOCAL_SERVICE_ANNOUNCE_INTERVAL: Int

Seconds between local-network announces for a torrent.

MAX_ALLOWED_IN_REQUEST_QUEUE

const val MAX_ALLOWED_IN_REQUEST_QUEUE: Int

Max outstanding block requests a peer may queue in us.

MAX_CONCURRENT_HTTP_ANNOUNCES

const val MAX_CONCURRENT_HTTP_ANNOUNCES: Int

Max concurrent HTTP tracker announces.

MAX_FAILCOUNT

const val MAX_FAILCOUNT: Int

Max connection attempts to a peer before giving up.

MAX_HTTP_RECV_BUFFER_SIZE

const val MAX_HTTP_RECV_BUFFER_SIZE: Int

Max bytes for an HTTP response when announcing or fetching a .torrent.

MAX_METADATA_SIZE

const val MAX_METADATA_SIZE: Int

Max bytes accepted by the metadata (magnet) extension.

MAX_OUT_REQUEST_QUEUE

const val MAX_OUT_REQUEST_QUEUE: Int

Max outstanding requests we send to a peer (overrides REQUEST_QUEUE_TIME).

MAX_PAUSED_PEERLIST_SIZE

const val MAX_PAUSED_PEERLIST_SIZE: Int

Max peer-list size for paused torrents.

MAX_PEER_RECV_BUFFER_SIZE

const val MAX_PEER_RECV_BUFFER_SIZE: Int

Max bytes a single peer connection's receive buffer may grow to.

MAX_PEERLIST_SIZE

const val MAX_PEERLIST_SIZE: Int

Max known peers in the peer list (0 = unlimited).

MAX_PEX_PEERS

const val MAX_PEX_PEERS: Int

Max peers accepted from a single peer's PEX message.

MAX_PIECE_COUNT

const val MAX_PIECE_COUNT: Int

Max pieces in metadata received via magnet links.

MAX_QUEUED_DISK_BYTES

const val MAX_QUEUED_DISK_BYTES: Int

Max bytes queued for the disk-write thread before peers stop reading sockets.

MAX_REJECTS

const val MAX_REJECTS: Int

Consecutive rejected requests from a choked peer before it's deemed abusive.

MAX_RETRY_PORT_BIND

const val MAX_RETRY_PORT_BIND: Int

Times to retry a failed port bind (incrementing the port).

MAX_SUGGEST_PIECES

const val MAX_SUGGEST_PIECES: Int

Max remembered suggested piece indices from a peer.

MAX_WEB_SEED_CONNECTIONS

const val MAX_WEB_SEED_CONNECTIONS: Int

Max web seeds connected per torrent.

METADATA_TOKEN_LIMIT

const val METADATA_TOKEN_LIMIT: Int

Max bencoded tokens parsed when receiving metadata from peers.

MIN_ANNOUNCE_INTERVAL

const val MIN_ANNOUNCE_INTERVAL: Int

Minimum allowed tracker announce interval (sanity clamp), in seconds.

MIN_RECONNECT_TIME

const val MIN_RECONNECT_TIME: Int

Seconds to wait before reconnecting (multiplied by failcount).

MIXED_MODE_ALGORITHM

const val MIXED_MODE_ALGORITHM: Int

TCP-vs-uTP bandwidth balancing mode; see MixedModeAlgorithm.

MMAP_FILE_SIZE_CUTOFF

const val MMAP_FILE_SIZE_CUTOFF: Int

Files smaller than this many 16 KiB blocks are not memory-mapped.

NATPMP_LEASE_DURATION

const val NATPMP_LEASE_DURATION: Int

NAT-PMP / PCP port-mapping lease duration in seconds.

NUM_OPTIMISTIC_UNCHOKE_SLOTS

const val NUM_OPTIMISTIC_UNCHOKE_SLOTS: Int

Number of optimistic-unchoke slots (0 = automatic, 20% of upload slots).

NUM_OUTGOING_PORTS

const val NUM_OUTGOING_PORTS: Int

Size of the outgoing-port range starting at OUTGOING_PORT.

NUM_WANT

const val NUM_WANT: Int

Peers requested from each tracker (&num_want=).

OPTIMISTIC_DISK_RETRY

const val OPTIMISTIC_DISK_RETRY: Int

Seconds from a disk write error until upload-only mode is retried.

OPTIMISTIC_UNCHOKE_INTERVAL

const val OPTIMISTIC_UNCHOKE_INTERVAL: Int

Seconds between optimistic unchokes.

OUT_ENC_POLICY

const val OUT_ENC_POLICY: Int

Outgoing-connection encryption policy; see EncPolicy.

OUTGOING_PORT

const val OUTGOING_PORT: Int

First port for binding outgoing connections (0 = OS-chosen).

PEER_CONNECT_TIMEOUT

const val PEER_CONNECT_TIMEOUT: Int

Seconds after initiating a connection before it times out.

PEER_DSCP

const val PEER_DSCP: Int

DSCP field of the IP header for packets to peers (0x01 = Lower Effort).

PEER_TIMEOUT

const val PEER_TIMEOUT: Int

Seconds of peer-connection inactivity before timing it out (protocol: 120).

PEER_TURNOVER

const val PEER_TURNOVER: Int

Percentage of peers to disconnect on each turnover interval.

PEER_TURNOVER_CUTOFF

const val PEER_TURNOVER_CUTOFF: Int

Connection-fill percentage above which turnover disconnects kick in.

PEER_TURNOVER_INTERVAL

const val PEER_TURNOVER_INTERVAL: Int

Seconds between optimistic turnover disconnects.

PIECE_TIMEOUT

const val PIECE_TIMEOUT: Int

Seconds until a piece request times out with no response.

PREDICTIVE_PIECE_ANNOUNCE

const val PREDICTIVE_PIECE_ANNOUNCE: Int

Milliseconds in advance to announce pieces before completion (0 = off).

PROXY_PORT

const val PROXY_PORT: Int

Proxy server port.

PROXY_TYPE

const val PROXY_TYPE: Int

Proxy type; see ProxyType.

RATE_CHOKER_INITIAL_THRESHOLD

const val RATE_CHOKER_INITIAL_THRESHOLD: Int

Start threshold for the rate-based choker.

RECV_SOCKET_BUFFER_SIZE

const val RECV_SOCKET_BUFFER_SIZE: Int

Socket receive-buffer size (SO_RCVBUF); 0 = OS default.

REQUEST_QUEUE_TIME

const val REQUEST_QUEUE_TIME: Int

Target request-queue length expressed in seconds of transfer.

REQUEST_TIMEOUT

const val REQUEST_TIMEOUT: Int

Seconds one 16 KiB block is expected within before re-requesting elsewhere.

RESOLVER_CACHE_TIMEOUT

const val RESOLVER_CACHE_TIMEOUT: Int

Seconds before a host-name resolver cache entry is considered stale.

SEED_CHOKING_ALGORITHM

const val SEED_CHOKING_ALGORITHM: Int

Seeding-unchoke algorithm; see SeedChokingAlgorithm.

SEED_TIME_LIMIT

const val SEED_TIME_LIMIT: Int

Seconds of active seeding before the seed-time criterion is met.

SEED_TIME_RATIO_LIMIT

const val SEED_TIME_RATIO_LIMIT: Int

Seed-time-ratio (seed/leech seconds) percentage at which a seed is considered done.

SEEDING_PIECE_QUOTA

const val SEEDING_PIECE_QUOTA: Int

Pieces to send a peer while seeding before rotating the unchoke set.

SEND_BUFFER_LOW_WATERMARK

const val SEND_BUFFER_LOW_WATERMARK: Int

Minimum send-buffer target size in bytes (initial window).

SEND_BUFFER_WATERMARK

const val SEND_BUFFER_WATERMARK: Int

Upper bound on the send-buffer watermark in bytes.

SEND_BUFFER_WATERMARK_FACTOR

const val SEND_BUFFER_WATERMARK_FACTOR: Int

Percentage factor applied to upload rate to compute the send-buffer watermark.

SEND_NOT_SENT_LOW_WATERMARK

const val SEND_NOT_SENT_LOW_WATERMARK: Int

Not-sent low watermark for socket send buffers (TCP_NOTSENT_LOWAT).

SEND_SOCKET_BUFFER_SIZE

const val SEND_SOCKET_BUFFER_SIZE: Int

Socket send-buffer size (SO_SNDBUF); 0 = OS default.

SHARE_MODE_TARGET

const val SHARE_MODE_TARGET: Int

Target share ratio for share-mode torrents (e.g. 3 = upload 3x download).

SHARE_RATIO_LIMIT

const val SHARE_RATIO_LIMIT: Int

Share-ratio (up/down) percentage at which a seed is considered done.

STOP_TRACKER_TIMEOUT

const val STOP_TRACKER_TIMEOUT: Int

Seconds to wait for a stopped message; 0 suppresses stop announces.

SUGGEST_MODE

const val SUGGEST_MODE: Int

Suggest-message mode; see SuggestMode.

TICK_INTERVAL

const val TICK_INTERVAL: Int

Milliseconds between internal ticks (bandwidth-quota distribution).

TORRENT_CONNECT_BOOST

const val TORRENT_CONNECT_BOOST: Int

Peers connected immediately on the first tracker response (<= 255).

TRACKER_BACKOFF

const val TRACKER_BACKOFF: Int

Aggressiveness of tracker retry back-off (the x in the back-off formula).

TRACKER_COMPLETION_TIMEOUT

const val TRACKER_COMPLETION_TIMEOUT: Int

Seconds before a tracker request is considered timed out (from sending).

TRACKER_MAXIMUM_RESPONSE_LENGTH

const val TRACKER_MAXIMUM_RESPONSE_LENGTH: Int

Max bytes (uncompressed) accepted in a tracker response.

TRACKER_RECEIVE_TIMEOUT

const val TRACKER_RECEIVE_TIMEOUT: Int

Seconds with no data from a tracker before it times out.

UDP_TRACKER_TOKEN_EXPIRY

const val UDP_TRACKER_TOKEN_EXPIRY: Int

Seconds UDP-tracker connection tokens are kept (protocol: 60).

UNCHOKE_INTERVAL

const val UNCHOKE_INTERVAL: Int

Seconds between choke/unchoke re-evaluation (protocol: 30).

UNCHOKE_SLOTS_LIMIT

const val UNCHOKE_SLOTS_LIMIT: Int

Max unchoked peers in the session (-1 = unlimited).

UPLOAD_RATE_LIMIT

const val UPLOAD_RATE_LIMIT: Int

Session-global upload rate limit in bytes/s (0 = unlimited).

UPNP_LEASE_DURATION

const val UPNP_LEASE_DURATION: Int

UPnP port-mapping lease duration in seconds (0 = permanent).

URLSEED_MAX_REQUEST_BYTES

const val URLSEED_MAX_REQUEST_BYTES: Int

Largest sequential web-seed request in bytes.

URLSEED_PIPELINE_SIZE

const val URLSEED_PIPELINE_SIZE: Int

HTTP request pipelining depth for url/http seeds.

URLSEED_TIMEOUT

const val URLSEED_TIMEOUT: Int

Like PEER_TIMEOUT but for url-seeds (usually lower).

URLSEED_WAIT_RETRY

const val URLSEED_WAIT_RETRY: Int

Default seconds before retrying an http-seed lacking a retry-after header.

UTP_CONNECT_TIMEOUT

const val UTP_CONNECT_TIMEOUT: Int

Milliseconds timeout for the initial uTP SYN (doubles per timeout).

UTP_CWND_REDUCE_TIMER

const val UTP_CWND_REDUCE_TIMER: Int

Milliseconds to hold the uTP cwnd reduction after packet loss.

UTP_FIN_RESENDS

const val UTP_FIN_RESENDS: Int

FIN packets resent before giving up closing a uTP socket.

UTP_GAIN_FACTOR

const val UTP_GAIN_FACTOR: Int

Max bytes the uTP congestion window can grow per RTT.

UTP_LOSS_MULTIPLIER

const val UTP_LOSS_MULTIPLIER: Int

Percentage multiplier for cwnd on uTP packet loss (never > 100).

UTP_MIN_TIMEOUT

const val UTP_MIN_TIMEOUT: Int

Shortest allowed uTP socket timeout in milliseconds.

UTP_NUM_RESENDS

const val UTP_NUM_RESENDS: Int

Times a uTP packet is resent before closing the connection.

UTP_SYN_RESENDS

const val UTP_SYN_RESENDS: Int

SYN packets sent (and timed out) before giving up a uTP connect.

UTP_TARGET_DELAY

const val UTP_TARGET_DELAY: Int

Target uTP delay in milliseconds.

WEB_SEED_NAME_LOOKUP_RETRY

const val WEB_SEED_NAME_LOOKUP_RETRY: Int

Seconds before retrying a web-seed name lookup.

WHOLE_PIECES_THRESHOLD

const val WHOLE_PIECES_THRESHOLD: Int

If a whole piece downloads within this many seconds, prefer whole-piece requests.