.TH "bttrack.bittornado" "1" 
.SH "NAME" 
bttrack \(em bittorrent tracker 
.SH "SYNOPSIS" 
.PP 
\fBbttrack\fR [\fBoptions\fP \&...]  \fB\-\-dfile \fIfile\fR\fP 
.SH "DESCRIPTION" 
.PP 
This manual page documents briefly the 
\fBbttrack\fR command. 
.PP 
This manual page was written for the \fBDebian\fP distribution 
because the original program does not have a manual page. 
.PP 
\fBbttrack\fR 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. 
.PP 
There is one required option, \-\-dfile, which specifies what \fIfile\fR to store the recent downloader information. 
.SH "OPTIONS" 
.PP 
These programs follow the usual GNU command line syntax, 
with long options starting with two dashes (`\-\-').  A summary of 
options is included below. 
.IP "\fB\-\-dfile \fIfile\fR\fP" 10 
the \fIfile\fR to store the recent downloader information (required) 
.IP "\fB\-\-port \fIport\fR\fP" 10 
the \fIport\fR to listen on (defaults to 80) 
.IP "\fB\-\-bind \fIip\fR|\fIhostname\fR[,\fIip\fR|\fIhostname\fR ...]\fP" 10 
a comma-separated list of \fIips\fR and \fIhostnames\fR to bind to locally (defaults to '') 
.IP "\fB\-\-ipv6_enabled\fP 0|1" 10 
whether to allow the tracker to connect to peers via IPv6 (defaults to 0) 
.IP "\fB\-\-ipv6_binds_v4\fP 0|1" 10 
whether an IPv6 server socket will also field IPv4 connections (defaults to 0) 
.IP "\fB\-\-socket_timeout \fIseconds\fR\fP" 10 
then number of \fIseconds\fR to use as a timeout for closing connections (defaults to 15) 
.IP "\fB\-\-save_dfile_interval \fIseconds\fR\fP" 10 
the number of \fIseconds\fR between saving the dfile (defaults to 300) 
.IP "\fB\-\-timeout_downloaders_interval \fIseconds\fR\fP" 10 
the number of \fIseconds\fR between expiring downloaders (defaults to 2700) 
.IP "\fB\-\-reannounce_interval \fIseconds\fR\fP" 10 
the number of \fIseconds\fR downloaders should wait between reannouncements 
(defaults to 1800) 
.IP "\fB\-\-response_size \fInum\fR\fP" 10 
the \fInum\fR of peers to send in an info message (defaults to 50) 
.IP "\fB\-\-timeout_check_interval \fIseconds\fR\fP" 10 
the number of \fIseconds\fR to wait between checking if any connections have timed out 
(defaults to 5) 
.IP "\fB\-\-nat_check \fInum\fR\fP" 10 
check \fInum\fR times if a downloader is behind a NAT (0 = don't 
check) (defaults to 3) 
.IP "\fB\-\-log_nat_checks\fP 0|1" 10 
whether to add entries to the log for nat-check results (defaults to 0) 
.IP "\fB\-\-min_time_between_log_flushes \fIseconds\fR\fP" 10 
the minimum number of \fIseconds\fR it must have been since the last flush to do another one 
(defaults to 3.0) 
.IP "\fB\-\-min_time_between_cache_refreshes \fIseconds\fR\fP" 10 
the minimum number of \fIseconds\fR before a cache is considered stale and is 
flushed (defaults to 600.0) 
.IP "\fB\-\-allowed_dir \fIdirectory\fR\fP" 10 
only allow downloads for torrents in this \fIdirectory\fR (defaults to '') 
.IP "\fB\-\-allowed_list \fIfile\fR\fP" 10 
only allow downloads for hashes in this \fIfile\fR (hex format, one per 
line), cannot be used with allowed_dir (defaults to '') 
.IP "\fB\-\-allowed_controls\fP 0|1" 10 
whether to allow special keys in torrents in the allowed_dir to affect tracker 
access (defaults to 0) 
.IP "\fB\-\-multitracker_enabled\fP 0|1" 10 
whether to enable multitracker operation (defaults to 0) 
.IP "\fB\-\-multitracker_allowed\fP autodetect|none|all" 10 
whether to allow incoming tracker announces (can be none, autodetect 
or all) (defaults to 'autodetect') 
.IP "\fB\-\-multitracker_reannounce_interval \fIseconds\fR\fP" 10 
number of \fIseconds\fR between outgoing tracker announces (defaults to 120) 
.IP "\fB\-\-multitracker_maxpeers \fInum\fR\fP" 10 
the \fInum\fR of peers to get in a tracker announce (defaults to 20) 
.IP "\fB\-\-aggregate_forward \fIurl\fR[,\fIpassword\fR]\fP" 10 
if set, forwards all non-multitracker to 
this \fIurl\fR with this optional \fIpassword\fR (defaults to '') 
.IP "\fB\-\-aggregator\fP 0|1|\fIpassword\fR" 10 
whether to act as a data aggregator rather than a tracker. If 
enabled, may be 1, or \fIpassword\fR; if \fIpassword\fR is set, then an 
incoming password is required for access (defaults to '0') 
.IP "\fB\-\-hupmonitor\fP 0|1" 10 
whether to reopen the log file upon receipt of HUP signal (defaults to 0) 
.IP "\fB\-\-http_timeout \fIseconds\fR\fP" 10 
number of \fIseconds\fR to wait before assuming that an http connection has 
timed out (defaults to 60) 
.IP "\fB\-\-parse_dir_interval \fIseconds\fR\fP" 10 
number of \fIseconds\fR between reloading of allowed_dir (defaults to 60) 
.IP "\fB\-\-show_infopage\fP 0|1" 10 
whether to display an info page when the tracker's root dir is loaded 
(defaults to 1) 
.IP "\fB\-\-infopage_redirect \fIURL\fR\fP" 10 
redirect the info page to this \fIURL\fR (defaults to '') 
.IP "\fB\-\-show_names\fP 0|1" 10 
whether to display names from allowed dir (defaults to 1) 
.IP "\fB\-\-favicon \fIfilename\fR\fP" 10 
the \fIfilename\fR containing x-icon data to return when browser requests 
favicon.ico (defaults to '') 
.IP "\fB\-\-allowed_ips \fIfile\fR\fP" 10 
only allow connections from IPs specified in the given \fIfile\fR, which 
contains subnet data in the format: aa.bb.cc.dd/len (defaults to '') 
.IP "\fB\-\-banned_ips \fIfile\fR\fP" 10 
don't allow connections from IPs specified in the given \fIfile\fR, which 
contains IP range data in the format: xxx:xxx:ip1-ip2 (defaults to '') 
.IP "\fB\-\-only_local_override_ip\fP 0|1|2" 10 
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) 
.IP "\fB\-\-logfile \fIfile\fR\fP" 10 
write tracker logs to this \fIfile\fR, use '\-' for stdout (defaults to '\-') 
.IP "\fB\-\-allow_get\fP 0|1" 10 
use with allowed_dir; adds a /file?hash=\fIhash\fR URL that allows users 
to download the torrent file (defaults to 0) 
.IP "\fB\-\-keep_dead\fP 0|1" 10 
keep dead torrents after they expire (so they still show up on your 
/scrape and web page) (defaults to 0) 
.IP "\fB\-\-scrape_allowed\fP full|specific|none" 10 
scrape access allowed (can be none, specific or full) (defaults to full) 
.IP "\fB\-\-dedicated_seed_id \fIcode\fR\fP" 10 
the \fIcode\fR to require from clients to indicate that they are 
dedicated seeders. This allows the tracker to monitor dedicated seed(s) and flag torrents as 
seeded. (defaults to '') 
.SH "SEE ALSO" 
.PP 
\fBbittorrent-downloader\fP\fB(1)\fP, 
 
.SH "AUTHOR" 
.PP 
This manual page was written by Cameron Dale <camrdale@gmail.com> (based on the original man pages written by Micah Anderson <micah@debian.org>) for 
the \fBDebian\fP system (but may be used by others).  Permission is 
granted to copy, distribute and/or modify this document under 
the terms of the GNU General Public License, Version 2 or any 
later version published by the Free Software Foundation. 
 
.PP 
On Debian systems, the complete text of the GNU General Public 
License can be found in /usr/share/common-licenses/GPL. 
 
.\" created by instant / docbook-to-man