github
/
aria2
mirror of https://github.com/aria2/aria2
1
0
Fork 0
Code Issues Releases Wiki Activity

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
pull/1/head
Tatsuhiro Tsujikawa 2010-08-22 11:54:47 +00:00
parent 38fcf1964d
commit c09ee2f764
4 changed files with 177 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
ChangeLog
View File

@ -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

78
doc/aria2c.1
View File

@ -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

69
doc/aria2c.1.html
View File

@ -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
doesn&#8217;t use DHT for that download even if <em>true</em> is given.
Default: <em>true</em>
Enable IPv4 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. 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>

49
doc/aria2c.1.txt
View File

@ -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.
Default: 'true'
Enable IPv4 DHT functionality. If a private flag is set in a
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
---------