winwatch: l allows label changes

[plan9front.git] / sys / man / 1 / torrent

diff --git a/sys/man/1/torrent b/sys/man/1/torrent
index d0502975a032f50d5542a2123fa9b91e63301cf1..e71964e86638128a1917c0ed2ee8a6d834bb0b8f 100644 (file)
--- a/sys/man/1/torrent
+++ b/sys/man/1/torrent
@@ -23,6 +23,12 @@ torrent \- bittorrent client
 ] [
 .B -c
 ] [
+.B -i
+.I peer-id
+] [
+.B -A
+.I user-agent
+] [
 .I file
 ]
 .SH DESCRIPTION
@@ -32,7 +38,7 @@ that are then downloaded by clients in random order.
 As soon as a client completes a piece, it makes the piece 
 available for others to download.
 .PP
-To find find other clients (peers), a tracker-server is
+To find other clients (peers), a tracker-server is
 contacted.
 .PP
 Before files can be transmitted, a torrent-file needs
@@ -45,7 +51,7 @@ option. If provided,
 .I torrent
 reads the file given at the final
 .I file
-argument (or standard-input when omited) and writes
+argument (or standard-input when omitted) and writes
 a torrent file to standard-output and exits.
 A
 .I tracker-url
@@ -60,7 +66,7 @@ can be passed with the
 .B -w
 option. If
 .I webseed-url
-ends with a slash, the filename, from the torrent, concatinated
+ends with a slash, the filename, from the torrent, concatenated
 with the url forms the target url.
 .PP
 Without the
@@ -104,6 +110,23 @@ To monitor the download progress, the
 option can be given to cause the completed and total number of
 pieces written as a line of text to standard-output in one
 second intervals.
+.PP
+The
+.B -i
+option allows you to set the 20-byte
+.I peer-id
+that is sent to trackers and peers. If less than 20 bytes, the
+.I peer-id
+will be padded on the right with random ASCII numbers. The
+.B -A
+option allows setting the http 
+.I user-agent
+string that is used to contact the tracker. These options are
+useful to fool trackers that filter clients based on the
+.I peer-id
+or
+.I user-agent
+.
 .SH EXAMPLES
 Create new torrent file
 .EX
@@ -129,3 +152,6 @@ hget http://www.trackon.org/api/live
 .SH "SEE ALSO"
 .IR hget (1),
 .IR webfs (4)
+.SH HISTORY
+.I Torrent
+first appeared in 9front (October, 2011).