torrent(1) manpage

1 files changed, 75 insertions, 0 deletions

diff --git a/sys/man/1/torrent b/sys/man/1/torrent
new file mode 100644
index 000000000..666862c9d
--- /dev/null
+++ b/sys/man/1/torrent
@@ -0,0 +1,75 @@
+.TH TORRENT 1
+.SH NAME
+torrent \- bittorrent client
+.SH SYNOPSIS
+.B torrent
+[
+.B -d
+]
+[
+.B -v
+]
+[
+.B -p
+]
+[
+.B -m
+.I mtpt
+]
+[
+.B -s
+]
+[
+.I file
+]
+.SH DESCRIPTION
+.I Torrent
+downloads the files that are specified in the torrent
+.I file
+in the current working directory. If no
+.I file
+is given, standard-input is used.
+.PP
+Normally,
+.I torrent
+exits after all files have been downloaded. 
+The
+.B -s
+option causes 
+.I torrent
+to keep seeding.
+.PP
+An alternative mountpoint of the
+.IR webfs (4)
+filesystem can be given with the
+.B -m
+option (defaults to
+.BR /mnt/web ).
+.SH DIAGNOSTICS
+The
+.B -d
+option enables debug output to standard-error.
+.PP
+The
+.B -v
+option causes
+.I torrent
+to list the files contained in the content
+before downloading.
+.PP
+To monitor the download progress, the
+.B -p
+option can be given to cause
+.I torrent
+to print the current and the total number of pieces
+to download every second.
+.SH EXAMPLE
+.EX
+cd /tmp
+hget http://r-36.net/9front/9front.iso.bz2.torrent | ip/torrent -pv | aux/statusbar 'download...'
+.EE
+.SH SOURCE
+.B /sys/src/cmd/ip/torrent.c
+.SH "SEE ALSO
+.IR hget (1),
+.IR webfs (4)