.Dd May 19, 2008
.Dt TRANSMISSION-DAEMON 1

.Sh NAME
.Nm transmission-daemon
.Nd a bittorrent client
.Sh SYNOPSIS
.Bk -words
.Nm transmission-daemon
.Fl h
.Nm
.Op Fl a Ar (+|-)x.x.x.x[/x],...
.Op Fl b
.Op Fl b0
.Op Fl d
.Op Fl f
.Op Fl g Ar directory
.Op Fl h
.Op Fl p Ar port
.Op Fl t
.Op Fl t0
.Op Fl u Ar username
.Op Fl w Ar password
.Ek

.Sh DESCRIPTION
.Nm
is a daemon-based Transmission session that can be controlled
via RPC commands from
.Xr transmission-remote 1
or
.Xr Clutch 1 .
.Pp
The options are as follows:
.Bl -tag -width Ds

.It Fl a Fl -acl Ar (+|-)x.x.x.x[/x],...
Specify access control list (ACL) to control which hosts may submit RPC requests.
ACL is a comma separated list of IP subnets,
each subnet is prepended by '-' or '+' sign.
Plus means allow, minus means deny.
If subnet mask is omitted, like "-1.2.3.4", then it means that single IP address.
Masks may vary from 0 to 32 inclusive.
Default: +127.0.0.1

.It Fl b Fl -blocklist
Enable peer blocklists.  Transmission understands the bluetack blocklist file format.
New blocklists can be added by copying them into the config-dir's "blocklists" subdirectory.

.It Fl b0 Fl -blocklist=0
Disble blocklists.

.It Fl d Fl -download-dir
Where to store downloaded data.

.It Fl f Fl -foreground
Run in the foreground and print errors to stderr.

.It Fl g Fl -config-dir Ar directory
Where to look for .torrent and config files on startup.

.It Fl h Fl -help
Print command-line option descriptions.

.It Fl p Fl -port Ar port
Port to open and listen for RPC requests on.  Default: 9091

.It Fl t Fl -auth
Require clients to authenticate themselves.
This doesn't do much good unless
.Ar username and
.Ar password are also set.

.It Fl t0 Fl -auth=0
Don't require authentication from clients.

.It Fl u Fl -username ar username
Used for client authentication.

.It Fl w Fl -password ar password
Used for client authentication.

.El

.Sh ENVIRONMENT
.Bl -tag -width Fl
.It Ev TRANSMISSION_HOME
Sets the default config-dir.
.El


.Sh FILES
.Bl -tag -width Ds -compact
.It ~/.config/transmission-daemon
The config-dir used when neither
.Op Ev TRANSMISSION_HOME
nor
.Op Fl g
is specified.
.El


.Sh AUTHORS
.An -nosplit
.An Charles Kerr ,
.An Josh Elsasser ,
.An Eric Petit ,
and
.An Mitchell Livingston .

.Sh SEE ALSO
.Xr transmissioncli 1 ,
.Xr transmission 1 ,
.Xr transmission-remote 1
.Pp
http://www.transmissionbt.com/