merge

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

diff --git a/sys/man/1/torrent b/sys/man/1/torrent
index e2bc3f7472911d876a508e31b6145fab28e74e24..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
@@ -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).