2010-08-22 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>

Documented --dht-entry-porint6, --dht-file-path6,
	--dht-listen-addr6 and --enable-dht6 option. Updated other things
	too.
	* doc/aria2c.1.txt

ChangeLog

@@ -1,3 +1,10 @@
+2010-08-22  Tatsuhiro Tsujikawa  <t-tujikawa@users.sourceforge.net>
+
+	Documented --dht-entry-porint6, --dht-file-path6,
+	--dht-listen-addr6 and --enable-dht6 option. Updated other things
+	too.
+	* doc/aria2c.1.txt
+
 2010-08-22  Tatsuhiro Tsujikawa  <t-tujikawa@users.sourceforge.net>
 
 	Updated README

doc/aria2c.1

@@ -2,12 +2,12 @@
 .\"     Title: aria2c
 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
-.\"      Date: 08/01/2010
+.\"      Date: 08/22/2010
 .\"    Manual: Aria2 Manual
 .\"    Source: Aria2 1.10.0
 .\"  Language: English
 .\"
-.TH "ARIA2C" "1" "08/01/2010" "Aria2 1\&.10\&.0" "Aria2 Manual"
+.TH "ARIA2C" "1" "08/22/2010" "Aria2 1\&.10\&.0" "Aria2 Manual"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -745,18 +745,34 @@ Set timeout in seconds\&. Default:
 .PP
 \fB\-\-dht\-entry\-point\fR=HOST:PORT
 .RS 4
-Set host and port as an entry point to DHT network\&.
+Set host and port as an entry point to IPv4 DHT network\&.
+.RE
+.PP
+\fB\-\-dht\-entry\-point6\fR=HOST:PORT
+.RS 4
+Set host and port as an entry point to IPv6 DHT network\&.
 .RE
 .PP
 \fB\-\-dht\-file\-path\fR=PATH
 .RS 4
-Change the DHT routing table file to PATH\&. Default:
+Change the IPv4 DHT routing table file to PATH\&. Default:
 \fI$HOME/\&.aria2/dht\&.dat\fR
 .RE
 .PP
+\fB\-\-dht\-file\-path6\fR=PATH
+.RS 4
+Change the IPv6 DHT routing table file to PATH\&. Default:
+\fI$HOME/\&.aria2/dht6\&.dat\fR
+.RE
+.PP
+\fB\-\-dht\-listen\-addr6\fR=ADDR
+.RS 4
+Specify address to bind socket for IPv6 DHT\&. It should be a global unicast IPv6 address of the host\&.
+.RE
+.PP
 \fB\-\-dht\-listen\-port\fR=PORT\&...
 .RS 4
-Set UDP listening port for DHT\&. Multiple ports can be specified by using ",", for example:
+Set UDP listening port for both IPv4 and IPv6 DHT\&. Multiple ports can be specified by using ",", for example:
 \fI6881,6885\fR\&. You can also use "\-" to specify a range:
 \fI6881\-6999\fR\&. "," and "\-" can be used together\&. Default:
 \fI6881\-6999\fR
@@ -786,12 +802,23 @@ Set timeout in seconds\&. Default:
 .PP
 \fB\-\-enable\-dht\fR[=\fItrue\fR|\fIfalse\fR]
 .RS 4
-Enable DHT functionality\&. If a private flag is set in a torrent, aria2 doesn\(cqt use DHT for that download even if
+Enable IPv4 DHT functionality\&. If a private flag is set in a torrent, aria2 doesn\(cqt use DHT for that download even if
 \fItrue\fR
 is given\&. Default:
 \fItrue\fR
 .RE
 .PP
+\fB\-\-enable\-dht6\fR[=\fItrue\fR|\fIfalse\fR]
+.RS 4
+Enable IPv6 DHT functionality\&. If a private flag is set in a torrent, aria2 doesn\(cqt use DHT for that download even if
+\fItrue\fR
+is given\&. Use
+\fB\-\-dht\-listen\-port\fR
+option to specify port number to listen on\&. See also
+\fB\-\-dht\-listen\-addr6\fR
+option\&.
+.RE
+.PP
 \fB\-\-enable\-peer\-exchange\fR[=\fItrue\fR|\fIfalse\fR]
 .RS 4
 Enable Peer Exchange extension\&. If a private flag is set in a torrent, this feature is disabled for that download even if
@@ -3863,7 +3890,7 @@ aria2c \-\-max\-upload\-limit=100K file\&.torrent
 .nr an-break-flag 1
 .br
 .ps +1
-\fBEnable DHT\fR
+\fBEnable IPv4 DHT\fR
 .RS 4
 .sp
 .if n \{\
@@ -3892,6 +3919,41 @@ DHT uses udp port\&. Since aria2 doesn\(cqt configure firewall or router for por
 .sp .5v
 .RE
 .RE
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.ps +1
+\fBEnable IPv6 DHT\fR
+.RS 4
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+aria2c \-\-enable\-dht6 \-\-dht\-listen\-port=6881 \-\-dht\-listen\-addr6=YOUR_GLOBAL_UNICAST_ADDR \-\-enable\-async\-dns6
+.fi
+.if n \{\
+.RE
+.\}
+.if n \{\
+.sp
+.\}
+.RS 4
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.ps +1
+\fBNote\fR
+.ps -1
+.br
+.sp
+If aria2c is not built with c\-ares, \fB\-\-enable\-async\-dns6\fR is unnecessary\&. aria2 shares same port between IPv4 and IPv6 DHT\&.
+.sp .5v
+.RE
+.RE
 .SS "More advanced HTTP features"
 .sp
 .it 1 an-trap
@@ -4185,7 +4247,7 @@ aria2 Wiki: http://sourceforge\&.net/apps/trac/aria2/wiki
 .sp
 Metalink Homepage: http://www\&.metalinker\&.org/
 .sp
-The Metalink Download Description Format: http://www\&.rfc\-editor\&.org/rfc/rfc5854\&.txt
+The Metalink Download Description Format: http://tools\&.ietf\&.org/html/rfc5854
 .SH "COPYRIGHT"
 .sp
 Copyright \(co 2006, 2010 Tatsuhiro Tsujikawa

doc/aria2c.1.html

@@ -1499,7 +1499,15 @@ writes the piece to the appropriate files.</td>
 </dt>
 <dd>
 <p>
-  Set host and port as an entry point to DHT network.
+  Set host and port as an entry point to IPv4 DHT network.
+</p>
+</dd>
+<dt class="hdlist1">
+<strong>--dht-entry-point6</strong>=HOST:PORT
+</dt>
+<dd>
+<p>
+  Set host and port as an entry point to IPv6 DHT network.
 </p>
 </dd>
 <dt class="hdlist1">
@@ -1507,16 +1515,34 @@ writes the piece to the appropriate files.</td>
 </dt>
 <dd>
 <p>
-  Change the DHT routing table file to PATH.
+  Change the IPv4 DHT routing table file to PATH.
   Default: <em>$HOME/.aria2/dht.dat</em>
 </p>
 </dd>
 <dt class="hdlist1">
+<strong>--dht-file-path6</strong>=PATH
+</dt>
+<dd>
+<p>
+  Change the IPv6 DHT routing table file to PATH.
+  Default: <em>$HOME/.aria2/dht6.dat</em>
+</p>
+</dd>
+<dt class="hdlist1">
+<strong>--dht-listen-addr6</strong>=ADDR
+</dt>
+<dd>
+<p>
+  Specify address to bind socket for IPv6 DHT.  It should be a global
+  unicast IPv6 address of the host.
+</p>
+</dd>
+<dt class="hdlist1">
 <strong>--dht-listen-port</strong>=PORT&#8230;
 </dt>
 <dd>
 <p>
-  Set UDP listening port for DHT.
+  Set UDP listening port for both IPv4 and IPv6 DHT.
   Multiple ports can be specified by using ",", for example: <em>6881,6885</em>.
   You can also use "-" to specify a range: <em>6881-6999</em>. "," and "-" can be used
   together.
@@ -1546,9 +1572,20 @@ writes the piece to the appropriate files.</td>
 </dt>
 <dd>
 <p>
-  Enable DHT functionality. If a private flag is set in a torrent, aria2
+  Enable IPv4 DHT functionality. If a private flag is set in a
-  doesn&#8217;t use DHT for that download even if <em>true</em> is given.
+  torrent, aria2 doesn&#8217;t use DHT for that download even if <em>true</em> is
-  Default: <em>true</em>
+  given.  Default: <em>true</em>
+</p>
+</dd>
+<dt class="hdlist1">
+<strong>--enable-dht6</strong>[=<em>true</em>|<em>false</em>]
+</dt>
+<dd>
+<p>
+   Enable IPv6 DHT functionality. If a private flag is set in a
+   torrent, aria2 doesn&#8217;t use DHT for that download even if <em>true</em> is
+   given. Use <strong>--dht-listen-port</strong> option to specify port number to
+   listen on. See also <strong>--dht-listen-addr6</strong> option.
 </p>
 </dd>
 <dt class="hdlist1">
@@ -4122,7 +4159,7 @@ to you to do it manually.</td>
 <div class="content">
 <pre><tt>aria2c --max-upload-limit=100K file.torrent</tt></pre>
 </div></div>
-<h4 id="_enable_dht">Enable DHT</h4>
+<h4 id="_enable_ipv4_dht">Enable IPv4 DHT</h4>
 <div class="listingblock">
 <div class="content">
 <pre><tt>aria2c --enable-dht --dht-listen-port=6881 file.torrent</tt></pre>
@@ -4136,6 +4173,20 @@ to you to do it manually.</td>
 forwarding, it&#8217;s up to you to do it manually.</td>
 </tr></table>
 </div>
+<h4 id="_enable_ipv6_dht">Enable IPv6 DHT</h4>
+<div class="listingblock">
+<div class="content">
+<pre><tt>aria2c --enable-dht6 --dht-listen-port=6881 --dht-listen-addr6=YOUR_GLOBAL_UNICAST_ADDR --enable-async-dns6</tt></pre>
+</div></div>
+<div class="admonitionblock">
+<table><tr>
+<td class="icon">
+<div class="title">Note</div>
+</td>
+<td class="content">If aria2c is not built with c-ares, <strong>--enable-async-dns6</strong> is
+unnecessary. aria2 shares same port between IPv4 and IPv6 DHT.</td>
+</tr></table>
+</div>
 <h3 id="_more_advanced_http_features">More advanced HTTP features</h3><div style="clear:left"></div>
 <h4 id="_load_cookies">Load cookies</h4>
 <div class="listingblock">
@@ -4240,7 +4291,7 @@ checksums.</td>
 <div class="paragraph"><p>Project Web Site: <a href="http://aria2.sourceforge.net/">http://aria2.sourceforge.net/</a></p></div>
 <div class="paragraph"><p>aria2 Wiki: <a href="http://sourceforge.net/apps/trac/aria2/wiki">http://sourceforge.net/apps/trac/aria2/wiki</a></p></div>
 <div class="paragraph"><p>Metalink Homepage: <a href="http://www.metalinker.org/">http://www.metalinker.org/</a></p></div>
-<div class="paragraph"><p>The Metalink Download Description Format: <a href="http://www.rfc-editor.org/rfc/rfc5854.txt">http://www.rfc-editor.org/rfc/rfc5854.txt</a></p></div>
+<div class="paragraph"><p>The Metalink Download Description Format: <a href="http://tools.ietf.org/html/rfc5854">http://tools.ietf.org/html/rfc5854</a></p></div>
 </div>
 <h2 id="_copyright">COPYRIGHT</h2>
 <div class="sectionbody">
@@ -4273,7 +4324,7 @@ files in the program, then also delete it here.</p></div>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2010-08-01 14:56:58 JST
+Last updated 2010-08-22 20:52:39 JST
 </div>
 </div>
 </body>

doc/aria2c.1.txt

@@ -527,14 +527,28 @@ BitTorrent Specific Options
   Set timeout in seconds. Default: '60'
 
 *--dht-entry-point*=HOST:PORT::
-  Set host and port as an entry point to DHT network.
+  Set host and port as an entry point to IPv4 DHT network.
+
+*--dht-entry-point6*=HOST:PORT::
+
+  Set host and port as an entry point to IPv6 DHT network.
 
 *--dht-file-path*=PATH::
-  Change the DHT routing table file to PATH.
+  Change the IPv4 DHT routing table file to PATH.
   Default: '$HOME/.aria2/dht.dat'
 
+*--dht-file-path6*=PATH::
+
+  Change the IPv6 DHT routing table file to PATH.
+  Default: '$HOME/.aria2/dht6.dat'
+
+*--dht-listen-addr6*=ADDR::
+
+  Specify address to bind socket for IPv6 DHT.  It should be a global
+  unicast IPv6 address of the host.
+
 *--dht-listen-port*=PORT...::
-  Set UDP listening port for DHT.
+  Set UDP listening port for both IPv4 and IPv6 DHT.
   Multiple ports can be specified by using ",", for example: '6881,6885'.
   You can also use "-" to specify a range: '6881-6999'. "," and "-" can be used
   together.
@@ -548,9 +562,17 @@ Make sure that the specified ports are open for incoming UDP traffic.
   Set timeout in seconds. Default: '10'
 
 *--enable-dht*[='true'|'false']::
-  Enable DHT functionality. If a private flag is set in a torrent, aria2
+
-  doesn't use DHT for that download even if 'true' is given.
+  Enable IPv4 DHT functionality. If a private flag is set in a
-  Default: 'true'
+  torrent, aria2 doesn't use DHT for that download even if 'true' is
+  given.  Default: 'true'
+
+*--enable-dht6*[='true'|'false']::
+
+   Enable IPv6 DHT functionality. If a private flag is set in a
+   torrent, aria2 doesn't use DHT for that download even if 'true' is
+   given. Use *--dht-listen-port* option to specify port number to
+   listen on. See also *--dht-listen-addr6* option.
 
 *--enable-peer-exchange*[='true'|'false']::
   Enable Peer Exchange extension. If a private flag is set in a torrent, this
@@ -2167,8 +2189,8 @@ Throttle upload speed
 aria2c --max-upload-limit=100K file.torrent
 ---------------------------------------------- 
 
-Enable DHT
+Enable IPv4 DHT
-^^^^^^^^^^
+^^^^^^^^^^^^^^^
 ---------------------------------------------------------
 aria2c --enable-dht --dht-listen-port=6881 file.torrent
 ---------------------------------------------------------
@@ -2176,6 +2198,15 @@ aria2c --enable-dht --dht-listen-port=6881 file.torrent
 DHT uses udp port. Since aria2 doesn't configure firewall or router for port
 forwarding, it's up to you to do it manually.
 
+Enable IPv6 DHT
+^^^^^^^^^^^^^^^
+-----------------------------------------------------------------------------------------------------------
+aria2c --enable-dht6 --dht-listen-port=6881 --dht-listen-addr6=YOUR_GLOBAL_UNICAST_ADDR --enable-async-dns6
+-----------------------------------------------------------------------------------------------------------
+[NOTE]
+If aria2c is not built with c-ares, *--enable-async-dns6* is
+unnecessary. aria2 shares same port between IPv4 and IPv6 DHT.
+
 More advanced HTTP features
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 Load cookies
@@ -2271,7 +2302,7 @@ aria2 Wiki: http://sourceforge.net/apps/trac/aria2/wiki
 
 Metalink Homepage: http://www.metalinker.org/
 
-The Metalink Download Description Format: http://www.rfc-editor.org/rfc/rfc5854.txt
+The Metalink Download Description Format: http://tools.ietf.org/html/rfc5854
 
 COPYRIGHT
 ---------