transmission/daemon/transmission-daemon.1

.Dd July 21, 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 | B
.Op Fl f
.Op Fl g Ar directory
.Op Fl h
.Op Fl p Ar port
.Op Fl t | T
.Op Fl u Ar username
.Op Fl v Ar password
.Op Fl w Ar download-dir
.Ek

.Sh DESCRIPTION
.Nm
is a daemon-based Transmission session that can be controlled
via RPC commands from transmission's web interface or
.Xr transmission-remote 1 .

.Sh OPTIONS
.Bl -tag -width Ds

.It Fl a Fl -allowed Ar x.x.x.x,...
Allow RPC accecss to a comma-delimited whitelist of IP addresses.
Wildcards can be specified in an address by using '*'.
Default: "127.0.0.1"
Example: "127.0.0.*,192.168.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 B Fl -no-blocklist
Disble blocklists.

.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 T Fl -no-auth
Don't require authentication from clients.

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

.It Fl v Fl -password Ar password
Used for client authentication.

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

.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/
add more rpc unit tests. man page cleanups. 2008-07-21 16:11:47 +00:00			`.Dd July 21, 2008`
Merge daemon branch to trunk. 2007-04-18 16:39:10 +00:00			`.Dt TRANSMISSION-DAEMON 1`
minor tweaks. 2008-05-19 16:16:38 +00:00
Merge daemon branch to trunk. 2007-04-18 16:39:10 +00:00			`.Sh NAME`
			`.Nm transmission-daemon`
			`.Nd a bittorrent client`
			`.Sh SYNOPSIS`
Add command-line option to use an alternate location for the socket file. 2007-05-24 03:59:53 +00:00			`.Bk -words`
Merge daemon branch to trunk. 2007-04-18 16:39:10 +00:00			`.Nm transmission-daemon`
			`.Fl h`
			`.Nm`
updated daemon manpage 2008-05-19 15:50:30 +00:00			`.Op Fl a Ar (+\|-)x.x.x.x[/x],...`
add more rpc unit tests. man page cleanups. 2008-07-21 16:11:47 +00:00			`.Op Fl b \| B`
#966: allow blocklist support in the daemon. add extra info in the man page explaining how to add blocklists. 2008-06-11 20:09:36 +00:00			`.Op Fl f`
updated daemon manpage 2008-05-19 15:50:30 +00:00			`.Op Fl g Ar directory`
#966: allow blocklist support in the daemon. add extra info in the man page explaining how to add blocklists. 2008-06-11 20:09:36 +00:00			`.Op Fl h`
updated daemon manpage 2008-05-19 15:50:30 +00:00			`.Op Fl p Ar port`
add more rpc unit tests. man page cleanups. 2008-07-21 16:11:47 +00:00			`.Op Fl t \| T`
#966: allow blocklist support in the daemon. add extra info in the man page explaining how to add blocklists. 2008-06-11 20:09:36 +00:00			`.Op Fl u Ar username`
sync the man pages with the cli/daemon/remote changes 2008-07-08 17:44:33 +00:00			`.Op Fl v Ar password`
			`.Op Fl w Ar download-dir`
Add command-line option to use an alternate location for the socket file. 2007-05-24 03:59:53 +00:00			`.Ek`
minor tweaks. 2008-05-19 16:16:38 +00:00
Merge daemon branch to trunk. 2007-04-18 16:39:10 +00:00			`.Sh DESCRIPTION`
			`.Nm`
minor tweaks. 2008-05-19 16:16:38 +00:00			`is a daemon-based Transmission session that can be controlled`
add more rpc unit tests. man page cleanups. 2008-07-21 16:11:47 +00:00			`via RPC commands from transmission's web interface or`
			`.Xr transmission-remote 1 .`

			`.Sh OPTIONS`
Merge daemon branch to trunk. 2007-04-18 16:39:10 +00:00			`.Bl -tag -width Ds`
#966: allow blocklist support in the daemon. add extra info in the man page explaining how to add blocklists. 2008-06-11 20:09:36 +00:00
#1309: Web/RPC interface ACL ignored 2008-10-01 20:23:57 +00:00			`.It Fl a Fl -allowed Ar x.x.x.x,...`
			`Allow RPC accecss to a comma-delimited whitelist of IP addresses.`
update the daemon manpage to explain wildcarding in the ACL 2008-09-26 16:51:12 +00:00			`Wildcards can be specified in an address by using '*'.`
#1309: Web/RPC interface ACL ignored 2008-10-01 20:23:57 +00:00			`Default: "127.0.0.1"`
			`Example: "127.0.0.,192.168.1."`
#966: allow blocklist support in the daemon. add extra info in the man page explaining how to add blocklists. 2008-06-11 20:09:36 +00:00
			`.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.`

sync the man pages with the cli/daemon/remote changes 2008-07-08 17:44:33 +00:00			`.It Fl B Fl -no-blocklist`
#966: allow blocklist support in the daemon. add extra info in the man page explaining how to add blocklists. 2008-06-11 20:09:36 +00:00			`Disble blocklists.`

Merge daemon branch to trunk. 2007-04-18 16:39:10 +00:00			`.It Fl f Fl -foreground`
#966: allow blocklist support in the daemon. add extra info in the man page explaining how to add blocklists. 2008-06-11 20:09:36 +00:00			`Run in the foreground and print errors to stderr.`

updated daemon manpage 2008-05-19 15:50:30 +00:00			`.It Fl g Fl -config-dir Ar directory`
fix up the man pages a bit 2008-05-20 18:21:36 +00:00			`Where to look for .torrent and config files on startup.`
#966: allow blocklist support in the daemon. add extra info in the man page explaining how to add blocklists. 2008-06-11 20:09:36 +00:00
Merge daemon branch to trunk. 2007-04-18 16:39:10 +00:00			`.It Fl h Fl -help`
			`Print command-line option descriptions.`
#966: allow blocklist support in the daemon. add extra info in the man page explaining how to add blocklists. 2008-06-11 20:09:36 +00:00
updated daemon manpage 2008-05-19 15:50:30 +00:00			`.It Fl p Fl -port Ar port`
			`Port to open and listen for RPC requests on. Default: 9091`
#966: allow blocklist support in the daemon. add extra info in the man page explaining how to add blocklists. 2008-06-11 20:09:36 +00:00
			`.It Fl t Fl -auth`
			`Require clients to authenticate themselves.`
			`This doesn't do much good unless`
sync the man pages with the cli/daemon/remote changes 2008-07-08 17:44:33 +00:00			`.Ar username`
			`and`
			`.Ar password`
			`are also set.`
#966: allow blocklist support in the daemon. add extra info in the man page explaining how to add blocklists. 2008-06-11 20:09:36 +00:00
sync the man pages with the cli/daemon/remote changes 2008-07-08 17:44:33 +00:00			`.It Fl T Fl -no-auth`
#966: allow blocklist support in the daemon. add extra info in the man page explaining how to add blocklists. 2008-06-11 20:09:36 +00:00			`Don't require authentication from clients.`

sync the man pages with the cli/daemon/remote changes 2008-07-08 17:44:33 +00:00			`.It Fl u Fl -username Ar username`
#966: allow blocklist support in the daemon. add extra info in the man page explaining how to add blocklists. 2008-06-11 20:09:36 +00:00			`Used for client authentication.`

sync the man pages with the cli/daemon/remote changes 2008-07-08 17:44:33 +00:00			`.It Fl v Fl -password Ar password`
#966: allow blocklist support in the daemon. add extra info in the man page explaining how to add blocklists. 2008-06-11 20:09:36 +00:00			`Used for client authentication.`

sync the man pages with the cli/daemon/remote changes 2008-07-08 17:44:33 +00:00			`.It Fl w Fl -download-dir`
			`Where to store downloaded data.`

Merge daemon branch to trunk. 2007-04-18 16:39:10 +00:00			`.El`
updated daemon manpage 2008-05-19 15:50:30 +00:00
minor tweaks. 2008-05-19 16:16:38 +00:00			`.Sh ENVIRONMENT`
			`.Bl -tag -width Fl`
			`.It Ev TRANSMISSION_HOME`
			`Sets the default config-dir.`
			`.El`

#1004: update man pages FILES section 2008-06-09 15:06:48 +00:00
Merge daemon branch to trunk. 2007-04-18 16:39:10 +00:00			`.Sh FILES`
#1004: update man pages FILES section 2008-06-09 15:06:48 +00:00			`.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`

minor tweaks. 2008-05-19 16:16:38 +00:00
Merge daemon branch to trunk. 2007-04-18 16:39:10 +00:00			`.Sh AUTHORS`
			`.An -nosplit`
RPC/IPC redesign 2008-05-18 16:44:30 +00:00			`.An Charles Kerr ,`
			`.An Josh Elsasser ,`
			`.An Eric Petit ,`
Merge daemon branch to trunk. 2007-04-18 16:39:10 +00:00			`and`
RPC/IPC redesign 2008-05-18 16:44:30 +00:00			`.An Mitchell Livingston .`
minor tweaks. 2008-05-19 16:16:38 +00:00
Merge daemon branch to trunk. 2007-04-18 16:39:10 +00:00			`.Sh SEE ALSO`
			`.Xr transmissioncli 1 ,`
janitorial work for the freeze: (1) finish replacing "transmission-gtk" with "transmission". (2) add Charles to authors lists in man pages. (3) standardize the summary as "A fast and easy BitTorrent client" in the rpm spec, gtk about dialog, and man pages. (4) fold together similar translation strings in the gtk client. (5) use g_strerror instead of strerror in the gtk client. 2007-10-13 17:33:53 +00:00			`.Xr transmission 1 ,`
Merge daemon branch to trunk. 2007-04-18 16:39:10 +00:00			`.Xr transmission-remote 1`
			`.Pp`
update some more URLS to www.transmissionbt.com 2008-01-20 14:53:38 +00:00			`http://www.transmissionbt.com/`