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