Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
BTPD(1)				 User Commands			       BTPD(1)

       btpd - BitTorrent Protocol Daemon

       btpd [-d	dir] [-p port] [OPTIONS...]

       Btpd is a utility for sharing files over	the BitTorrent network
       protocol.  It runs in daemon mode, thus needing no controlling terminal
       or gui.	Instead, the daemon is controlled by btcli, its	control
       utility,	or other programs capable of sending commands and queries on
       the control socket.

       btpd consists of	the following programs:
	   btpd	- The bittorrent client.
	   btcli - Command line	interface to btpd.
	   btinfo - Shows information from a torrent file.

       All programs accept the --help option.

       -d dir The path for the btpd directory.	Default	is $HOME/.btpd.

       -p n, --port n
	      Listen at	port n.	Default	is 6881.

       --help [mode]
	      Show this	text or	help for the specified mode.

       -4     Use IPv4.	If given in conjunction	with -6, both versions are

       -6     Use IPv6.	By default IPv4	is used.  Unfortunately	enabling both
	      IPv6 and IPv4 in btpd is less useful than	it should be. The
	      problem is that some sites have trackers for both	versions and
	      it's likely that the IPv6	one, which probably has	less peers,
	      will be used in favour of	the IPv4 one.

       --bw-in n
	      Limit incoming BitTorrent	traffic	to n kB/s.  Default is 0 which
	      means unlimited.

       --bw-out	n
	      Limit outgoing BitTorrent	traffic	to n kB/s.  Default is 0 which
	      means unlimited.

	      Start btpd without any active torrents.

       --ip addr
	      Let the tracker distribute the given address instead of the one
	      it sees btpd connect from.

       --ipcprot mode
	      Set the protection mode of the command socket.  The mode is
	      specified	by an octal number. Default is 0600.

       --logfile file
	      Where to put the logfile.	By default it's	put in the btpd	dir.

       --max-peers n
	      Limit the	amount of peers	to n.

       --max-uploads n
	      Controls the number of simultaneous uploads.  The	possible
	      values are:
	      n	< -1 : Choose n	>= 2 based on --bw-out (default).
	      n	= -1 : Upload to every interested peer.
	      n	=  0 : Dont't upload to	anyone.
	      n	>  0 : Upload to at most n peers simultaneously.

	      Keep the btpd process in the foregorund and log to std{out,err}.
	      This option is intended for debugging purposes.

       --prealloc n
	      Preallocate disk space in	chunks of n kB.	Default	is 2048.  Note
	      that n will be rounded up	to the closest multiple	of the torrent
	      piece size. If n is zero no preallocation	will be	done.

       To start	btpd with default settings you only need to run	it. However,
       there are many useful options you may want to use. To see a full	list
       run btpd	--help.	If you didn't specify otherwise,  btpd starts with the
       same set	of active torrents as it had the last time it was shut down.

       btdp will store information and write its log in	$HOME/.btpd. Therefore
       it needs	to be able to write there during its execution.	You can
       specify another directory via the -d option or the $BTPD_HOME variable.

       It is recommended to specifiy the maximum number	of uploads. Bittorrent
       employs a tit for tat algorithm,	so uploading at	good rates allows for
       downloading.  Try to find a balance between uploads/outgoing bandwidth
       and the number of active	torrents.

       Note: You should	only need one instance of btpd regardless of how many
       torrents	you want to share.

       Start btpd with all options set to their	default	values.
	   $ btpd

       Start btpd as above, but	with torrent data in the directory
	   $ btpd -d /var/torrents

       Start btpd and make it listen on	port 12345, limit outgoing bandwidth
       to 200kB/s, limit the number of peers to	40 and not start any torrents
       that were active	the last time btpd was shut down.
	   $ btpd -p 12345 --bw-out 200	--max-peers 40 --empty-start

       If btpd has shut	down for some unknown reason, check the	logfile	for
       possible	clues.

       Known bugs are listed at

       Before submitting a bug report, please verify that you are running the
       latest version of btpd.

       Current maintainers:

       - Marq Schneider	<>

       Past contributors:

       - Richard Nyberg	<>

       btcli(1)	btinfo(1)

BitTorrent Protocol Daemon 0.16	  2010-07-31			       BTPD(1)


Want to link to this manual page? Use this URL:

home | help