.TH "debtorrent-tracker" "1" 
.SH "NAME" 
debtorrent-tracker \(em debtorrent tracker 
.SH "SYNOPSIS" 
.PP 
\fBdebtorrent-tracker\fR [\fBoptions\fP \&...]  \fB\-\-dfile \fIfile\fR\fP 
.SH "DESCRIPTION" 
.PP 
This manual page documents briefly the 
\fBdebtorrent-tracker\fR command. 
.PP 
\fBdebtorrent-tracker\fR is a "tracker" for debtorrent clients. This program keeps track 
of the completion of each client, and communicates that information when 
requested to other clients. 
.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. For more detail, see the configuration 
file in /etc/debtorrent. 
.SS "CONFIG FILES" 
.IP "\fB\-\-configfile \fIfilename\fR\fP" 10 
the \fIfilename\fR to use for the configuration file, if not specified then a file in 
/etc/debtorrent will be used, followed by a file in the .DebTorrent directory in the user's home directory 
.IP "\fB\-\-save_options\fP 0|1" 10 
whether to save the current options as the new default configuration 
for the current program (defaults to 0) 
.SS "LOCATIONS" 
.IP "\fB\-\-cache_dir \fIdirectory\fR\fP" 10 
the local \fIdirectory\fR to save cache data in, if left blank then a .DebTorrent directory in the user's home directory will be used 
.IP "\fB\-\-save_dfile_interval \fIseconds\fR\fP" 10 
the number of \fIseconds\fR between saving the dfile (defaults to 300) 
.IP "\fB\-\-log_dir \fIdirectory\fR\fP" 10 
the local \fIdirectory\fR to save log files in, if left blank then the cache directory will be used 
.IP "\fB\-\-log_level \fIlevel\fR\fP" 10 
log messages that are greater than or equal to \fIlevel\fR to log files,  
the basic log levels are 50 (critical), 40 (errors), 30 (warnings), 20 (info), and 10 (debug) 
(the default is 20) 
.SS "CONNECTIONS" 
.IP "\fB\-\-port \fIport\fR\fP" 10 
the \fIport\fR to listen on (defaults to 6969) 
.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 client to connect to peers via IPv6 (defaults to 0) 
.IP "\fB\-\-ipv6_binds_v4\fP 0|1" 10 
set if an IPv6 server socket won't also field IPv4 connections (defaults to 0) 
.IP "\fB\-\-socket_timeout \fIseconds\fR\fP" 10 
the number of \fIseconds\fR to wait between closing sockets which nothing has been received on 
(defaults to 15) 
.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) 
.SS "ALLOWED TORRENTS AND PEERS" 
.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\-\-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\-\-parse_dir_interval \fIseconds\fR\fP" 10 
number of \fIseconds\fR between reloading of allowed_dir (defaults to 60) 
.SS "PEER REQUESTS" 
.IP "\fB\-\-compact_reqd\fP 0|1" 10 
whether to only allow peers that accept a compact response (defaults to 1) 
.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\-\-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\-\-timeout_downloaders_interval \fIseconds\fR\fP" 10 
the number of \fIseconds\fR between expiring downloaders (defaults to 2700) 
.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\-\-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\-\-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 '') 
.SS "NON-PEER REQUESTS" 
.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\-\-favicon \fIfilename\fR\fP" 10 
the \fIfilename\fR containing x-icon data to return when browser requests 
favicon.ico (defaults to '') 
.IP "\fB\-\-show_names\fP 0|1" 10 
whether to display the name of the torrent on the infopage (defaults to 1) 
.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) 
.SS "REQUEST LOGGING" 
.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\-\-hupmonitor\fP 0|1" 10 
whether to reopen the log file upon receipt of HUP signal (defaults to 0) 
.IP "\fB\-\-log_nat_checks\fP 0|1" 10 
whether to add entries to the log for nat-check results (defaults to 1) 
.SS "MULTI-TRACKER" 
.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\-\-http_timeout \fIseconds\fR\fP" 10 
number of \fIseconds\fR to wait before assuming that an http connection has 
timed out (defaults to 60) 
.SH "SEE ALSO" 
.PP 
\fBdebtorrent-client\fP\fB(1)\fP      
.SH "AUTHOR" 
.PP 
This manual page was written by Cameron Dale <camrdale@gmail.com> 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, Sun 21 Mar 2010, 05:05