1.Dd July 21, 2008 2.Dt TRANSMISSION-DAEMON 1 3.Sh NAME 4.Nm transmission-daemon 5.Nd a bittorrent client 6.Sh SYNOPSIS 7.Bk -words 8.Nm transmission-daemon 9.Fl h 10.Nm 11.Op Fl a Ar x.x.x.x,... 12.Op Fl b | B 13.Op Fl c Ar directory 14.Op Fl C 15.Op Fl f 16.Op Fl g Ar directory 17.Op Fl h 18.Op Fl p Ar port 19.Op Fl t | T 20.Op Fl u Ar username 21.Op Fl v Ar password 22.Op Fl P Ar port 23.Op Fl m | M 24.Op Fl l Ar limit 25.Op Fl L Ar limit 26.Op Fl er | ep | et 27.Op Fl utp | no-utp 28.Op Fl V 29.Op Fl w Ar download-dir 30.Op Fl e Ar logfile 31.Op Fl log-error | log-info | log-debug 32.Ek 33.Sh DESCRIPTION 34.Nm 35is a daemon-based Transmission session that can be controlled 36via RPC commands from transmission's web interface or 37.Xr transmission-remote 1 . 38.Sh OPTIONS 39.Bl -tag -width Ds 40.It Fl a Fl -allowed Ar x.x.x.x,... 41Allow RPC access to a comma-delimited whitelist of IP addresses. 42Wildcards can be specified in an address by using '*'. 43Default: "127.0.0.1" 44Example: "127.0.0.*,192.168.1.*" 45.It Fl b Fl -blocklist 46Enable peer blocklists. Transmission understands the bluetack blocklist file format. 47New blocklists can be added by copying them into the config-dir's "blocklists" subdirectory. 48.It Fl c Ar directory 49Directory to watch for new .torrent files to be added. As they are added to this directory, 50the daemon will load them into Transmission. 51.It Fl C 52Do not watch for new .torrent files. 53.It Fl B Fl -no-blocklist 54Disble blocklists. 55.It Fl f Fl -foreground 56Run in the foreground and print errors to stderr. 57.It Fl g Fl -config-dir Ar directory 58Where to look for configuration files. This can be used to swap between using the cli, daemon, gtk, and qt clients. 59See http://trac.transmissionbt.com/wiki/ConfigFiles for more information. 60.It Fl er Fl -encryption-required 61Encrypt all peer connections. 62.It Fl ep Fl -encryption-preferred 63Prefer encrypted peer connections. 64.It Fl et Fl -encryption-tolerated 65Prefer unencrypted peer connections. 66.It Fl gsr Fl -global-seedratio Ar ratio 67All torrents, unless overridden by a per-torrent setting, should seed until a specific 68.Ar ratio 69.It Fl GSR Fl -no-global-seedratio 70All torrents, unless overridden by a per-torrent setting, should seed regardless of ratio 71.It Fl h Fl -help 72Print command-line option descriptions. 73.It Fl -incomplete-dir Ar dir 74When adding new torrents, store their contents in 75.Ar directory 76until the torrent is done. 77.It Fl -no-incomplete-dir 78Don't store incomplete torrents in a different directory. 79.It Fl i Fl -bind-address-ipv4 80Listen for IPv4 BitTorrent connections on a specific address. Only one IPv4 listening address is allowed. Default: 0.0.0.0 (All addresses) 81.It Fl I Fl -bind-address-ipv6 82Listen for IPv6 BitTorrent connections on a specific address. Only one IPv6 listening address is allowed. Default: :: (All addresses) 83.It Fl r Fl -rpc-bind-address 84Listen for RPC connections on a specific address. This must be an IPv4 address. Only one RPC listening address is allowed. Default: 0.0.0.0 (All addresses) 85.It Fl -paused 86Pause all torrents on startup 87.It Fl L Fl -peerlimit-global Ar limit 88Overall peer limit. Useful on embedded systems where the default might be unsuitable. Default: 240 89.It Fl l Fl -peerlimit-torrent Ar limit 90Peer limit per torrent. Useful on embedded systems where the default might be unsuitable. Default: 60 91.It Fl m Fl -portmap 92Enable portmapping via NAT-PMP or UPnP 93.It Fl M Fl -no-portmap 94Disable portmapping 95.It Fl o Fl -dht 96Enable distributed hash table (DHT). 97.It Fl O Fl -no-dht 98Disable distribued hash table (DHT). 99.It Fl p Fl -port Ar port 100Port to open and listen for RPC requests on. Default: 9091 101.It Fl P, -peerport Ar port 102Port to listen for incoming peers on. Default: 51413 103.It Fl t Fl -auth 104Require clients to authenticate themselves. 105This doesn't do much good unless 106.Ar username 107and 108.Ar password 109are also set. 110.It Fl T Fl -no-auth 111Don't require authentication from clients. 112.It Fl u Fl -username Ar username 113Used for client authentication. 114.It Fl v Fl -password Ar password 115Used for client authentication. 116.It Fl V Fl -version 117Show version number and exit 118.It Fl -utp 119Enable uTP for peer connections. 120.It Fl -no-utp 121Disable uTP for peer connections. 122.It Fl w Fl -download-dir 123Where to store downloaded data. 124.It Fl e Fl -logfile 125Where to store transmission's log messages. 126.It Fl -log-error 127Show error messages 128.It Fl -log-info 129Show error and info messages 130.It Fl -log-debug 131Show error, info, and debug messages 132.El 133.Sh ENVIRONMENT 134.Bl -tag -width Fl 135.It Ev http_proxy 136libcurl uses this environment variable when performing tracker announces. 137.It Ev TRANSMISSION_HOME 138Sets the default config-dir. 139.El 140.Sh FILES 141.Bl -tag -width Ds -compact 142.It ~/.config/transmission-daemon 143The config-dir used when neither 144.Op Ev TRANSMISSION_HOME 145nor 146.Op Fl g 147is specified. 148See http://trac.transmissionbt.com/wiki/ConfigFiles for more information. 149.El 150.Sh AUTHORS 151.An -nosplit 152.An Jordan Lee , 153.An Josh Elsasser , 154.An Eric Petit , 155and 156.An Mitchell Livingston . 157.Sh SEE ALSO 158.Xr transmission-create 1 , 159.Xr transmission-daemon 1 , 160.Xr transmission-edit 1 , 161.Xr transmission-gtk 1 , 162.Xr transmission-qt 1 , 163.Xr transmission-remote 1 , 164.Xr transmission-show 1 165.Pp 166http://www.transmissionbt.com/ 167