BTTRACK(1)

NAME
Bttrack - tracker for bittornado

SYNOPSIS
bttrack --dfile <file> <args>

DESCRIPTION
bttrack is a "tracker" for bittorrent clients. This program keeps track of the completion of each client, and communicates that information when requested to other clients.

OPTIONS
This program follows the usual GNU command-line syntax, with long options starting with two dashes ('-'). A summary of options is included below. --port portnum

    portnum to listen on. (defaults to 80)

--dfile filename

    filename to store recent downloader info in

--bind ip,ip,ip

    comma-separated list of ips/hostnames to bind to locally (defaults to '')

--ipv6_enabled 0 | 1

    allow the client to connect to peers via IPv6 (defaults to 0)

--ipv6_binds_v4 0 | 1

    set if an IPv6 server socket will also field IPv4 connections (defaults to 1)

--socket_timeout seconds

    seconds timeout for closing connections (defaults to 15)

--save_dfile_interval seconds

    seconds between saving dfile (defaults to 300)

--timeout_downloaders_interval seconds

    seconds between expiring downloaders (defaults to 2700)

--reannounce_interval seconds

    seconds downloaders should wait between reannouncements (defaults to 1800)

--response_size num

    num of peers to send in an info message (defaults to 50)

--timeout_check_interval seconds

    time in seconds to wait between checking if any connections have timed out (defaults to 5)

--nat_check num

    num times to check if a downloader is behind a NAT (0 = don't check) (defaults to 3)

--log_nat_checks 0 | 1

    whether to add entries to the log for nat-check results (defaults to 0)

--min_time_between_log_flushes seconds

    minimum time in seconds it must have been since the last flush to do another one (defaults to 3.0)

--min_time_between_cache_refreshes seconds

    minimum time in seconds before a cache is considered stale and is flushed (defaults to 600.0)

--allowed_dir directory

    only allow downloads for .torrents in this directory (defaults to '')

--allowed_controls 0 | 1

    allow special keys in torrents in the allowed_dir to affect tracker access (defaults to 0)

--multitracker_enabled 0 | 1

    whether to enable multitracker operation (defaults to 0)

--multitracker_allowed autodetect | none | all

    whether to allow incoming tracker announces (can be none, autodetect or all) (defaults to 'autodetect')

--multitracker_reannounce_interval seconds

    number of seconds between outgoing tracker announces (defaults to 120)

--multitracker_maxpeers num

    num of peers to get in a tracker announce (defaults to 20)

--aggregate_forward url[,<password>]

    if set, forwards all non-multitracker to this url with this optional password (defaults to '')

--aggregator 0 | 1 | <password>

    whether to act as a data aggregator rather than a tracker. If enabled, may be 1, or <password>; if password is set, then an incoming password is required for access (defaults to '0')

--hupmonitor 0 | 1

    whether to reopen the log file upon receipt of HUP signal (defaults to 0)

--http_timeout seconds

    number of seconds to wait before assuming that an http connection has timed out (defaults to 60)

--parse_dir_interval seconds

    seconds between reloading of allowed_dir (defaults to 60)

--show_infopage 0 | 1

    whether to display an info page when the tracker's root dir is loaded (defaults to 1)

--infopage_redirect URL

    a URL to redirect the info page to (defaults to '')

--show_names 0 | 1

    whether to display names from allowed dir (defaults to 1)

--favicon filename

    filename containing x-icon data to return when browser requests favicon.ico (defaults to '')

--allowed_ips file

    only allow connections from IPs specified in the given file; contains subnet data in the format: aa.bb.cc.dd/len (defaults to '')

--only_local_override_ip 0 | 1 | 2

    ignore the ip GET parameter from machines which aren't on local network IPs (0 = never, 1 = always, 2 = ignore if NAT checking is not enabled) (defaults to 2)

--logfile file

    file to write the tracker logs, use - for stdout (default) (defaults to '')

--allow_get 0 | 1

    use with allowed_dir; adds a /file?hash={hash} url that allows users to download the torrent file (defaults to 0)

--keep_dead 0 | 1

    keep dead torrents after they expire (so they still show up on your /scrape and web page) (defaults to 0)

--scrape_allowed full | specific | none

    scrape access allowed (can be none, specific or full) (defaults to 'full')

SEE ALSO
bittorrent-downloader(1), btmakemetafile(1).

AUTHOR
This manual page was written by Micah Anderson <micah@riseup.net>, for the Debian GNU/Linux system (but may be used by others).