mirror of https://github.com/aria2/aria2
2010-03-13 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>
Updated doc. * doc/aria2c.1.txtpull/1/head
parent
725c46de25
commit
3511e737de
|
@ -1,3 +1,8 @@
|
|||
2010-03-13 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>
|
||||
|
||||
Updated doc.
|
||||
* doc/aria2c.1.txt
|
||||
|
||||
2010-03-13 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>
|
||||
|
||||
Documented about Metalink4 and LPD in README
|
||||
|
|
44
doc/aria2c.1
44
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: 03/12/2010
|
||||
.\" Date: 03/13/2010
|
||||
.\" Manual: Aria2 Manual
|
||||
.\" Source: Aria2 1.9.0
|
||||
.\" Language: English
|
||||
.\"
|
||||
.TH "ARIA2C" "1" "03/12/2010" "Aria2 1\&.9\&.0" "Aria2 Manual"
|
||||
.TH "ARIA2C" "1" "03/13/2010" "Aria2 1\&.9\&.0" "Aria2 Manual"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
|
@ -65,7 +65,7 @@ is specified, log is written to stdout\&.
|
|||
.PP
|
||||
\fB\-j\fR, \fB\-\-max\-concurrent\-downloads\fR=N
|
||||
.RS 4
|
||||
Set maximum number of parallel downloads for every static (HTTP/FTP) URL, torrent and metalink\&. See also
|
||||
Set maximum number of parallel downloads for every static (HTTP/FTP) URI, torrent and metalink\&. See also
|
||||
\fB\-s\fR
|
||||
and
|
||||
\fB\-C\fR
|
||||
|
@ -112,7 +112,7 @@ Use this proxy server for all protocols\&. To erase previously defined proxy, us
|
|||
\fB\-\-https\-proxy\fR
|
||||
and
|
||||
\fB\-\-ftp\-proxy\fR
|
||||
options\&. This affects all URLs\&. The format of PROXY is [http://][USER:PASSWORD@]HOST[:PORT]
|
||||
options\&. This affects all URIs\&. The format of PROXY is [http://][USER:PASSWORD@]HOST[:PORT]
|
||||
.RE
|
||||
.if n \{\
|
||||
.sp
|
||||
|
@ -219,7 +219,7 @@ option is used, this option is ignored\&.
|
|||
.ps -1
|
||||
.br
|
||||
.sp
|
||||
In Metalink or BitTorrent download you cannot specify file name\&. The file name specified here is only used when the URLs fed to aria2 are done by command line without \fB\-i\fR, \fB\-Z\fR option\&. For example: aria2c \-o myfile\&.zip "http://mirror1/file\&.zip" "http://mirror2/file\&.zip"
|
||||
In Metalink or BitTorrent download you cannot specify file name\&. The file name specified here is only used when the URIs fed to aria2 are done by command line without \fB\-i\fR, \fB\-Z\fR option\&. For example: aria2c \-o myfile\&.zip "http://mirror1/file\&.zip" "http://mirror2/file\&.zip"
|
||||
.sp .5v
|
||||
.RE
|
||||
.PP
|
||||
|
@ -276,7 +276,7 @@ Specifies timeout in seconds to invalidate performance profile of the servers si
|
|||
.PP
|
||||
\fB\-s\fR, \fB\-\-split\fR=N
|
||||
.RS 4
|
||||
Download a file using N connections\&. If more than N URLs are given, first N URLs are used and remaining URLs are used for backup\&. If less than N URLs are given, those URLs are used more than once so that N connections total are made simultaneously\&. Please see
|
||||
Download a file using N connections\&. If more than N URIs are given, first N URIs are used and remaining URIs are used for backup\&. If less than N URIs are given, those URIs are used more than once so that N connections total are made simultaneously\&. Please see
|
||||
\fB\-j\fR
|
||||
option too\&. Please note that in Metalink download, this option has no effect and use
|
||||
\fB\-C\fR
|
||||
|
@ -354,19 +354,19 @@ option\&. Default:
|
|||
.PP
|
||||
\fB\-\-http\-user\fR=USER
|
||||
.RS 4
|
||||
Set HTTP user\&. This affects all URLs\&.
|
||||
Set HTTP user\&. This affects all URIs\&.
|
||||
.RE
|
||||
.PP
|
||||
\fB\-\-http\-passwd\fR=PASSWD
|
||||
.RS 4
|
||||
Set HTTP password\&. This affects all URLs\&.
|
||||
Set HTTP password\&. This affects all URIs\&.
|
||||
.RE
|
||||
.PP
|
||||
\fB\-\-http\-proxy\fR=PROXY
|
||||
.RS 4
|
||||
Use this proxy server for HTTP\&. To erase previously defined proxy, use ""\&. See also
|
||||
\fB\-\-all\-proxy\fR
|
||||
option\&. This affects all URLs\&. The format of PROXY is [http://][USER:PASSWORD@]HOST[:PORT]
|
||||
option\&. This affects all URIs\&. The format of PROXY is [http://][USER:PASSWORD@]HOST[:PORT]
|
||||
.RE
|
||||
.PP
|
||||
\fB\-\-http\-proxy\-passwd\fR=PASSWD
|
||||
|
@ -392,7 +392,7 @@ Set user for *\-\-http\-proxy* option\&.
|
|||
.RS 4
|
||||
Use this proxy server for HTTPS\&. To erase previously defined proxy, use ""\&. See also
|
||||
\fB\-\-all\-proxy\fR
|
||||
option\&. This affects all URLs\&. The format of PROXY is [http://][USER:PASSWORD@]HOST[:PORT]
|
||||
option\&. This affects all URIs\&. The format of PROXY is [http://][USER:PASSWORD@]HOST[:PORT]
|
||||
.RE
|
||||
.PP
|
||||
\fB\-\-https\-proxy\-passwd\fR=PASSWD
|
||||
|
@ -418,7 +418,7 @@ option\&.
|
|||
.PP
|
||||
\fB\-\-referer\fR=REFERER
|
||||
.RS 4
|
||||
Set Referer\&. This affects all URLs\&.
|
||||
Set Referer\&. This affects all URIs\&.
|
||||
.RE
|
||||
.PP
|
||||
\fB\-\-enable\-http\-keep\-alive\fR[=\fItrue\fR|\fIfalse\fR]
|
||||
|
@ -482,13 +482,13 @@ Set user agent for HTTP(S) downloads\&. Default:
|
|||
.PP
|
||||
\fB\-\-ftp\-user\fR=USER
|
||||
.RS 4
|
||||
Set FTP user\&. This affects all URLs\&. Default:
|
||||
Set FTP user\&. This affects all URIs\&. Default:
|
||||
\fIanonymous\fR
|
||||
.RE
|
||||
.PP
|
||||
\fB\-\-ftp\-passwd\fR=PASSWD
|
||||
.RS 4
|
||||
Set FTP password\&. This affects all URLs\&. If user name is embedded but password is missing in URI, aria2 tries to resolve password using \&.netrc\&. If password is found in \&.netrc, then use it as password\&. If not, use the password specified in this option\&. Default:
|
||||
Set FTP password\&. This affects all URIs\&. If user name is embedded but password is missing in URI, aria2 tries to resolve password using \&.netrc\&. If password is found in \&.netrc, then use it as password\&. If not, use the password specified in this option\&. Default:
|
||||
\fIARIA2USER@\fR
|
||||
.RE
|
||||
.PP
|
||||
|
@ -504,7 +504,7 @@ is given, the active mode will be used\&. Default:
|
|||
.RS 4
|
||||
Use this proxy server for FTP\&. To erase previously defined proxy, use ""\&. See also
|
||||
\fB\-\-all\-proxy\fR
|
||||
option\&. This affects all URLs\&. The format of PROXY is [http://][USER:PASSWORD@]HOST[:PORT]
|
||||
option\&. This affects all URIs\&. The format of PROXY is [http://][USER:PASSWORD@]HOST[:PORT]
|
||||
.RE
|
||||
.PP
|
||||
\fB\-\-ftp\-proxy\-passwd\fR=PASSWD
|
||||
|
@ -1244,13 +1244,13 @@ Print the version number, copyright and the configuration information and exit\&
|
|||
The options that have its argument surrounded by square brackets([]) take an optional argument\&. Usually omiting the argument is evaluated to \fItrue\fR\&. If you use short form of these options(such as \fI\-V\fR) and give an argument, then the option name and its argument should be concatenated(e\&.g\&. \fI\-Vfalse\fR)\&. If any spaces are inserted between the option name and the argument, the argument will be treated as URI and usually this is not what you expect\&.
|
||||
.SS "URI, MAGNET, TORRENT_FILE, METALINK_FILE"
|
||||
.sp
|
||||
You can specify multiple URLs in command\-line\&. Unless you specify \fB\-Z\fR option, all URLs must point to the same file or downloading will fail\&.
|
||||
You can specify multiple URIs in command\-line\&. Unless you specify \fB\-Z\fR option, all URIs must point to the same file or downloading will fail\&.
|
||||
.sp
|
||||
You can specify arbitrary number of BitTorrent Magnet URI\&. Please note that they are always treated as a separate download\&. Both hex encoded 40 characters Info Hash and Base32 encoded 32 characters Info Hash are supported\&. The multiple "tr" parameters are supported\&. Because BitTorrent Magnet URI is likely to contain "&" character, it is highly recommended to always quote URI with single(\*(Aq) or double(") quotation\&. It is strongly recommended to enable DHT especially when "tr" parameter is missing\&. See http://www\&.bittorrent\&.org/beps/bep_0009\&.html for more details about BitTorrent Magnet URI\&.
|
||||
.sp
|
||||
You can also specify arbitrary number of torrent files and metalink files stored on a local drive\&. Please note that they are always treated as a separate download\&.
|
||||
You can also specify arbitrary number of torrent files and Metalink documents stored on a local drive\&. Please note that they are always treated as a separate download\&. Both Metalink4 and Metalink version 3\&.0 are supported\&.
|
||||
.sp
|
||||
You can specify both torrent file with \-T option and URLs\&. By doing this, you can download a file from both torrent swarm and HTTP(S)/FTP server at the same time, while the data from HTTP(S)/FTP are uploaded to the torrent swarm\&. For single file torrents, URL can be a complete URL pointing to the resource or if URL ends with /, name in torrent file in torrent is added\&. For multi\-file torrents, name and path are added to form a URL for each file\&.
|
||||
You can specify both torrent file with \-T option and URIs\&. By doing this, you can download a file from both torrent swarm and HTTP(S)/FTP server at the same time, while the data from HTTP(S)/FTP are uploaded to the torrent swarm\&. For single file torrents, URI can be a complete URI pointing to the resource or if URI ends with /, name in torrent file in torrent is added\&. For multi\-file torrents, name and path are added to form a URI for each file\&.
|
||||
.if n \{\
|
||||
.sp
|
||||
.\}
|
||||
|
@ -1264,14 +1264,14 @@ You can specify both torrent file with \-T option and URLs\&. By doing this, you
|
|||
.ps -1
|
||||
.br
|
||||
.sp
|
||||
Make sure that URL is quoted with single(\*(Aq) or double(") quotation if it contains "&" or any characters that have special meaning in shell\&.
|
||||
Make sure that URI is quoted with single(\*(Aq) or double(") quotation if it contains "&" or any characters that have special meaning in shell\&.
|
||||
.sp .5v
|
||||
.RE
|
||||
.SS "Resuming Download"
|
||||
.sp
|
||||
Usually, you can resume transfer by just issuing same command(aria2c URL) if the previous transfer is made by aria2\&.
|
||||
Usually, you can resume transfer by just issuing same command(aria2c URI) if the previous transfer is made by aria2\&.
|
||||
.sp
|
||||
If the previous transfer is made by a browser or wget like sequential download manager, then use \-c option to continue the transfer(aria2c \fB\-c\fR URL)\&.
|
||||
If the previous transfer is made by a browser or wget like sequential download manager, then use \-c option to continue the transfer(aria2c \fB\-c\fR URI)\&.
|
||||
.SH "EXIT STATUS"
|
||||
.sp
|
||||
Because aria2 can handle multiple downloads at once, it encounters lots of errors in a session\&. aria2 returns the following exit status based on the last error encountered\&.
|
||||
|
@ -2932,7 +2932,7 @@ aria2 uses 5 connections to download 1 file by default\&. \-s1 limits the number
|
|||
.ps -1
|
||||
.br
|
||||
.sp
|
||||
To pause a download, press Ctrl\-C\&. You can resume the transfer by running aria2c with the same argument in the same directory\&. You can change URLs as long as they are pointing to the same file\&.
|
||||
To pause a download, press Ctrl\-C\&. You can resume the transfer by running aria2c with the same argument in the same directory\&. You can change URIs as long as they are pointing to the same file\&.
|
||||
.sp .5v
|
||||
.RE
|
||||
.RE
|
||||
|
@ -3825,7 +3825,7 @@ aria2c \-Z \-P "http://host/image[A\-Z:2]\&.png"
|
|||
.nr an-break-flag 1
|
||||
.br
|
||||
.ps +1
|
||||
\fBParallel downloads of arbitrary number of URL,metalink,torrent\fR
|
||||
\fBParallel downloads of arbitrary number of URI,metalink,torrent\fR
|
||||
.RS 4
|
||||
.sp
|
||||
.if n \{\
|
||||
|
|
|
@ -627,7 +627,7 @@ downloading a file like BitTorrent.</p></div>
|
|||
</dt>
|
||||
<dd>
|
||||
<p>
|
||||
Set maximum number of parallel downloads for every static (HTTP/FTP) URL,
|
||||
Set maximum number of parallel downloads for every static (HTTP/FTP) URI,
|
||||
torrent and metalink. See also <strong>-s</strong> and <strong>-C</strong> option.
|
||||
Default: <em>5</em>
|
||||
</p>
|
||||
|
@ -681,7 +681,7 @@ downloading a file like BitTorrent.</p></div>
|
|||
Use this proxy server for all protocols. To erase previously
|
||||
defined proxy, use "". You can override this setting and specify a
|
||||
proxy server for a particular protocol using <strong>--http-proxy</strong>,
|
||||
<strong>--https-proxy</strong> and <strong>--ftp-proxy</strong> options. This affects all URLs.
|
||||
<strong>--https-proxy</strong> and <strong>--ftp-proxy</strong> options. This affects all URIs.
|
||||
The format of PROXY is [<a href="http://][USER:PASSWORD@]HOST[:PORT">http://][USER:PASSWORD@]HOST[:PORT</a>]
|
||||
</p>
|
||||
</dd>
|
||||
|
@ -813,7 +813,7 @@ then you get HTTP proxy "http://proxy" with user "user" and password
|
|||
<div class="title">Note</div>
|
||||
</td>
|
||||
<td class="content">In Metalink or BitTorrent download you cannot specify file name.
|
||||
The file name specified here is only used when the URLs fed to aria2
|
||||
The file name specified here is only used when the URIs fed to aria2
|
||||
are done by command line without <strong>-i</strong>, <strong>-Z</strong> option. For example:
|
||||
aria2c -o myfile.zip "http://mirror1/file.zip" "http://mirror2/file.zip"</td>
|
||||
</tr></table>
|
||||
|
@ -886,9 +886,9 @@ aria2c -o myfile.zip "http://mirror1/file.zip" "http://mirror2/file.zip"</td>
|
|||
<dd>
|
||||
<p>
|
||||
Download a file using N connections.
|
||||
If more than N URLs are given, first N URLs are used and remaining URLs are
|
||||
If more than N URIs are given, first N URIs are used and remaining URIs are
|
||||
used for backup.
|
||||
If less than N URLs are given, those URLs are used more than once so that N
|
||||
If less than N URIs are given, those URIs are used more than once so that N
|
||||
connections total are made simultaneously.
|
||||
Please see <strong>-j</strong> option too.
|
||||
Please note that in Metalink download, this option has no effect and use
|
||||
|
@ -987,7 +987,7 @@ aria2c -o myfile.zip "http://mirror1/file.zip" "http://mirror2/file.zip"</td>
|
|||
</dt>
|
||||
<dd>
|
||||
<p>
|
||||
Set HTTP user. This affects all URLs.
|
||||
Set HTTP user. This affects all URIs.
|
||||
</p>
|
||||
</dd>
|
||||
<dt class="hdlist1">
|
||||
|
@ -995,7 +995,7 @@ aria2c -o myfile.zip "http://mirror1/file.zip" "http://mirror2/file.zip"</td>
|
|||
</dt>
|
||||
<dd>
|
||||
<p>
|
||||
Set HTTP password. This affects all URLs.
|
||||
Set HTTP password. This affects all URIs.
|
||||
</p>
|
||||
</dd>
|
||||
<dt class="hdlist1">
|
||||
|
@ -1004,7 +1004,7 @@ aria2c -o myfile.zip "http://mirror1/file.zip" "http://mirror2/file.zip"</td>
|
|||
<dd>
|
||||
<p>
|
||||
Use this proxy server for HTTP. To erase previously defined proxy,
|
||||
use "". See also <strong>--all-proxy</strong> option. This affects all URLs. The
|
||||
use "". See also <strong>--all-proxy</strong> option. This affects all URIs. The
|
||||
format of PROXY is [<a href="http://][USER:PASSWORD@]HOST[:PORT">http://][USER:PASSWORD@]HOST[:PORT</a>]
|
||||
</p>
|
||||
</dd>
|
||||
|
@ -1029,7 +1029,7 @@ aria2c -o myfile.zip "http://mirror1/file.zip" "http://mirror2/file.zip"</td>
|
|||
<dd>
|
||||
<p>
|
||||
Use this proxy server for HTTPS. To erase previously defined proxy,
|
||||
use "". See also <strong>--all-proxy</strong> option. This affects all URLs. The
|
||||
use "". See also <strong>--all-proxy</strong> option. This affects all URIs. The
|
||||
format of PROXY is [<a href="http://][USER:PASSWORD@]HOST[:PORT">http://][USER:PASSWORD@]HOST[:PORT</a>]
|
||||
</p>
|
||||
</dd>
|
||||
|
@ -1065,7 +1065,7 @@ aria2c -o myfile.zip "http://mirror1/file.zip" "http://mirror2/file.zip"</td>
|
|||
</dt>
|
||||
<dd>
|
||||
<p>
|
||||
Set Referer. This affects all URLs.
|
||||
Set Referer. This affects all URIs.
|
||||
</p>
|
||||
</dd>
|
||||
<dt class="hdlist1">
|
||||
|
@ -1152,7 +1152,7 @@ aria2c -o myfile.zip "http://mirror1/file.zip" "http://mirror2/file.zip"</td>
|
|||
</dt>
|
||||
<dd>
|
||||
<p>
|
||||
Set FTP user. This affects all URLs.
|
||||
Set FTP user. This affects all URIs.
|
||||
Default: <em>anonymous</em>
|
||||
</p>
|
||||
</dd>
|
||||
|
@ -1161,7 +1161,7 @@ aria2c -o myfile.zip "http://mirror1/file.zip" "http://mirror2/file.zip"</td>
|
|||
</dt>
|
||||
<dd>
|
||||
<p>
|
||||
Set FTP password. This affects all URLs.
|
||||
Set FTP password. This affects all URIs.
|
||||
If user name is embedded but password is missing in URI, aria2 tries
|
||||
to resolve password using .netrc. If password is found in .netrc,
|
||||
then use it as password. If not, use the password specified in this
|
||||
|
@ -1185,7 +1185,7 @@ aria2c -o myfile.zip "http://mirror1/file.zip" "http://mirror2/file.zip"</td>
|
|||
<dd>
|
||||
<p>
|
||||
Use this proxy server for FTP. To erase previously defined proxy,
|
||||
use "". See also <strong>--all-proxy</strong> option. This affects all URLs. The
|
||||
use "". See also <strong>--all-proxy</strong> option. This affects all URIs. The
|
||||
format of PROXY is [<a href="http://][USER:PASSWORD@]HOST[:PORT">http://][USER:PASSWORD@]HOST[:PORT</a>]
|
||||
</p>
|
||||
</dd>
|
||||
|
@ -2107,8 +2107,8 @@ an argument, then the option name and its argument should be concatenated(e.g.
|
|||
<em>-Vfalse</em>). If any spaces are inserted between the option name and the argument,
|
||||
the argument will be treated as URI and usually this is not what you expect.</p></div>
|
||||
<h3 id="_uri_magnet_torrent_file_metalink_file">URI, MAGNET, TORRENT_FILE, METALINK_FILE</h3><div style="clear:left"></div>
|
||||
<div class="paragraph"><p>You can specify multiple URLs in command-line. Unless you specify
|
||||
<strong>-Z</strong> option, all URLs must point to the same file or downloading will
|
||||
<div class="paragraph"><p>You can specify multiple URIs in command-line. Unless you specify
|
||||
<strong>-Z</strong> option, all URIs must point to the same file or downloading will
|
||||
fail.</p></div>
|
||||
<div class="paragraph"><p>You can specify arbitrary number of BitTorrent Magnet URI. Please note
|
||||
that they are always treated as a separate download. Both hex encoded
|
||||
|
@ -2119,31 +2119,32 @@ recommended to always quote URI with single(') or double(") quotation.
|
|||
It is strongly recommended to enable DHT especially when "tr"
|
||||
parameter is missing. See <a href="http://www.bittorrent.org/beps/bep_0009.html">http://www.bittorrent.org/beps/bep_0009.html</a>
|
||||
for more details about BitTorrent Magnet URI.</p></div>
|
||||
<div class="paragraph"><p>You can also specify arbitrary number of torrent files and metalink files
|
||||
stored on a local drive. Please note that they are always treated as a
|
||||
separate download.</p></div>
|
||||
<div class="paragraph"><p>You can specify both torrent file with -T option and URLs. By doing
|
||||
<div class="paragraph"><p>You can also specify arbitrary number of torrent files and Metalink
|
||||
documents stored on a local drive. Please note that they are always
|
||||
treated as a separate download. Both Metalink4 and Metalink version
|
||||
3.0 are supported.</p></div>
|
||||
<div class="paragraph"><p>You can specify both torrent file with -T option and URIs. By doing
|
||||
this, you can download a file from both torrent swarm and HTTP(S)/FTP
|
||||
server at the same time, while the data from HTTP(S)/FTP are uploaded
|
||||
to the torrent swarm. For single file torrents, URL can be a complete
|
||||
URL pointing to the resource or if URL ends with /, name in torrent
|
||||
to the torrent swarm. For single file torrents, URI can be a complete
|
||||
URI pointing to the resource or if URI ends with /, name in torrent
|
||||
file in torrent is added. For multi-file torrents, name and path are
|
||||
added to form a URL for each file.</p></div>
|
||||
added to form a URI for each file.</p></div>
|
||||
<div class="admonitionblock">
|
||||
<table><tr>
|
||||
<td class="icon">
|
||||
<div class="title">Note</div>
|
||||
</td>
|
||||
<td class="content">Make sure that URL is quoted with single(') or double(") quotation if it
|
||||
<td class="content">Make sure that URI is quoted with single(') or double(") quotation if it
|
||||
contains "&" or any characters that have special meaning in shell.</td>
|
||||
</tr></table>
|
||||
</div>
|
||||
<h3 id="_resuming_download">Resuming Download</h3><div style="clear:left"></div>
|
||||
<div class="paragraph"><p>Usually, you can resume transfer by just issuing same command(aria2c
|
||||
URL) if the previous transfer is made by aria2.</p></div>
|
||||
URI) if the previous transfer is made by aria2.</p></div>
|
||||
<div class="paragraph"><p>If the previous transfer is made by a browser or wget like sequential
|
||||
download manager, then use -c option to continue the transfer(aria2c
|
||||
<strong>-c</strong> URL).</p></div>
|
||||
<strong>-c</strong> URI).</p></div>
|
||||
</div>
|
||||
<h2 id="_exit_status">EXIT STATUS</h2>
|
||||
<div class="sectionbody">
|
||||
|
@ -3588,7 +3589,7 @@ pprint(r)</tt></pre>
|
|||
<td class="icon">
|
||||
<div class="title">Note</div>
|
||||
</td>
|
||||
<td class="content">To pause a download, press Ctrl-C. You can resume the transfer by running aria2c with the same argument in the same directory. You can change URLs as long as they are pointing to the same file.</td>
|
||||
<td class="content">To pause a download, press Ctrl-C. You can resume the transfer by running aria2c with the same argument in the same directory. You can change URIs as long as they are pointing to the same file.</td>
|
||||
</tr></table>
|
||||
</div>
|
||||
<h4 id="_download_a_file_from_2_different_http_servers">Download a file from 2 different HTTP servers</h4>
|
||||
|
@ -3915,7 +3916,7 @@ checksums.</td>
|
|||
<div class="content">
|
||||
<pre><tt>aria2c -Z -P "http://host/image[A-Z:2].png"</tt></pre>
|
||||
</div></div>
|
||||
<h4 id="_parallel_downloads_of_arbitrary_number_of_url_metalink_torrent">Parallel downloads of arbitrary number of URL,metalink,torrent</h4>
|
||||
<h4 id="_parallel_downloads_of_arbitrary_number_of_uri_metalink_torrent">Parallel downloads of arbitrary number of URI,metalink,torrent</h4>
|
||||
<div class="listingblock">
|
||||
<div class="content">
|
||||
<pre><tt>aria2c -j3 -Z "http://host/file1" file2.torrent file3.metalink</tt></pre>
|
||||
|
@ -3964,7 +3965,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-03-12 00:27:52 JST
|
||||
Last updated 2010-03-13 00:35:15 JST
|
||||
</div>
|
||||
</div>
|
||||
</body>
|
||||
|
|
|
@ -46,7 +46,7 @@ Basic Options
|
|||
stdout.
|
||||
|
||||
*-j*, *--max-concurrent-downloads*=N::
|
||||
Set maximum number of parallel downloads for every static (HTTP/FTP) URL,
|
||||
Set maximum number of parallel downloads for every static (HTTP/FTP) URI,
|
||||
torrent and metalink. See also *-s* and *-C* option.
|
||||
Default: '5'
|
||||
|
||||
|
@ -81,7 +81,7 @@ HTTP/FTP Options
|
|||
Use this proxy server for all protocols. To erase previously
|
||||
defined proxy, use "". You can override this setting and specify a
|
||||
proxy server for a particular protocol using *--http-proxy*,
|
||||
*--https-proxy* and *--ftp-proxy* options. This affects all URLs.
|
||||
*--https-proxy* and *--ftp-proxy* options. This affects all URIs.
|
||||
The format of PROXY is [\http://][USER:PASSWORD@]HOST[:PORT]
|
||||
|
||||
[NOTE]
|
||||
|
@ -154,7 +154,7 @@ then you get HTTP proxy "http://proxy" with user "user" and password
|
|||
|
||||
[NOTE]
|
||||
In Metalink or BitTorrent download you cannot specify file name.
|
||||
The file name specified here is only used when the URLs fed to aria2
|
||||
The file name specified here is only used when the URIs fed to aria2
|
||||
are done by command line without *-i*, *-Z* option. For example:
|
||||
aria2c -o myfile.zip "http://mirror1/file.zip" "http://mirror2/file.zip"
|
||||
|
||||
|
@ -192,9 +192,9 @@ aria2c -o myfile.zip "http://mirror1/file.zip" "http://mirror2/file.zip"
|
|||
|
||||
*-s*, *--split*=N::
|
||||
Download a file using N connections.
|
||||
If more than N URLs are given, first N URLs are used and remaining URLs are
|
||||
If more than N URIs are given, first N URIs are used and remaining URIs are
|
||||
used for backup.
|
||||
If less than N URLs are given, those URLs are used more than once so that N
|
||||
If less than N URIs are given, those URIs are used more than once so that N
|
||||
connections total are made simultaneously.
|
||||
Please see *-j* option too.
|
||||
Please note that in Metalink download, this option has no effect and use
|
||||
|
@ -253,15 +253,15 @@ HTTP Specific Options
|
|||
using *--header* option. Default: 'true'
|
||||
|
||||
*--http-user*=USER::
|
||||
Set HTTP user. This affects all URLs.
|
||||
Set HTTP user. This affects all URIs.
|
||||
|
||||
*--http-passwd*=PASSWD::
|
||||
Set HTTP password. This affects all URLs.
|
||||
Set HTTP password. This affects all URIs.
|
||||
|
||||
*--http-proxy*=PROXY::
|
||||
|
||||
Use this proxy server for HTTP. To erase previously defined proxy,
|
||||
use "". See also *--all-proxy* option. This affects all URLs. The
|
||||
use "". See also *--all-proxy* option. This affects all URIs. The
|
||||
format of PROXY is [\http://][USER:PASSWORD@]HOST[:PORT]
|
||||
|
||||
*--http-proxy-passwd*=PASSWD::
|
||||
|
@ -275,7 +275,7 @@ HTTP Specific Options
|
|||
*--https-proxy*=PROXY::
|
||||
|
||||
Use this proxy server for HTTPS. To erase previously defined proxy,
|
||||
use "". See also *--all-proxy* option. This affects all URLs. The
|
||||
use "". See also *--all-proxy* option. This affects all URIs. The
|
||||
format of PROXY is [\http://][USER:PASSWORD@]HOST[:PORT]
|
||||
|
||||
*--https-proxy-passwd*=PASSWD::
|
||||
|
@ -293,7 +293,7 @@ HTTP Specific Options
|
|||
See also *--certificate* option.
|
||||
|
||||
*--referer*=REFERER::
|
||||
Set Referer. This affects all URLs.
|
||||
Set Referer. This affects all URIs.
|
||||
|
||||
*--enable-http-keep-alive*[='true'|'false']::
|
||||
Enable HTTP/1.1 persistent connection.
|
||||
|
@ -334,11 +334,11 @@ If aria2 is built without libsqlite3, then it doesn't support Firefox3 cookie fo
|
|||
FTP Specific Options
|
||||
~~~~~~~~~~~~~~~~~~~~
|
||||
*--ftp-user*=USER::
|
||||
Set FTP user. This affects all URLs.
|
||||
Set FTP user. This affects all URIs.
|
||||
Default: 'anonymous'
|
||||
|
||||
*--ftp-passwd*=PASSWD::
|
||||
Set FTP password. This affects all URLs.
|
||||
Set FTP password. This affects all URIs.
|
||||
If user name is embedded but password is missing in URI, aria2 tries
|
||||
to resolve password using .netrc. If password is found in .netrc,
|
||||
then use it as password. If not, use the password specified in this
|
||||
|
@ -353,7 +353,7 @@ FTP Specific Options
|
|||
*--ftp-proxy*=PROXY::
|
||||
|
||||
Use this proxy server for FTP. To erase previously defined proxy,
|
||||
use "". See also *--all-proxy* option. This affects all URLs. The
|
||||
use "". See also *--all-proxy* option. This affects all URIs. The
|
||||
format of PROXY is [\http://][USER:PASSWORD@]HOST[:PORT]
|
||||
|
||||
*--ftp-proxy-passwd*=PASSWD::
|
||||
|
@ -866,8 +866,8 @@ the argument will be treated as URI and usually this is not what you expect.
|
|||
URI, MAGNET, TORRENT_FILE, METALINK_FILE
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
You can specify multiple URLs in command-line. Unless you specify
|
||||
*-Z* option, all URLs must point to the same file or downloading will
|
||||
You can specify multiple URIs in command-line. Unless you specify
|
||||
*-Z* option, all URIs must point to the same file or downloading will
|
||||
fail.
|
||||
|
||||
You can specify arbitrary number of BitTorrent Magnet URI. Please note
|
||||
|
@ -880,31 +880,32 @@ It is strongly recommended to enable DHT especially when "tr"
|
|||
parameter is missing. See http://www.bittorrent.org/beps/bep_0009.html
|
||||
for more details about BitTorrent Magnet URI.
|
||||
|
||||
You can also specify arbitrary number of torrent files and metalink files
|
||||
stored on a local drive. Please note that they are always treated as a
|
||||
separate download.
|
||||
You can also specify arbitrary number of torrent files and Metalink
|
||||
documents stored on a local drive. Please note that they are always
|
||||
treated as a separate download. Both Metalink4 and Metalink version
|
||||
3.0 are supported.
|
||||
|
||||
You can specify both torrent file with -T option and URLs. By doing
|
||||
You can specify both torrent file with -T option and URIs. By doing
|
||||
this, you can download a file from both torrent swarm and HTTP(S)/FTP
|
||||
server at the same time, while the data from HTTP(S)/FTP are uploaded
|
||||
to the torrent swarm. For single file torrents, URL can be a complete
|
||||
URL pointing to the resource or if URL ends with /, name in torrent
|
||||
to the torrent swarm. For single file torrents, URI can be a complete
|
||||
URI pointing to the resource or if URI ends with /, name in torrent
|
||||
file in torrent is added. For multi-file torrents, name and path are
|
||||
added to form a URL for each file.
|
||||
added to form a URI for each file.
|
||||
|
||||
[NOTE]
|
||||
Make sure that URL is quoted with single(') or double(") quotation if it
|
||||
Make sure that URI is quoted with single(') or double(") quotation if it
|
||||
contains "&" or any characters that have special meaning in shell.
|
||||
|
||||
Resuming Download
|
||||
~~~~~~~~~~~~~~~~~
|
||||
|
||||
Usually, you can resume transfer by just issuing same command(aria2c
|
||||
URL) if the previous transfer is made by aria2.
|
||||
URI) if the previous transfer is made by aria2.
|
||||
|
||||
If the previous transfer is made by a browser or wget like sequential
|
||||
download manager, then use -c option to continue the transfer(aria2c
|
||||
*-c* URL).
|
||||
*-c* URI).
|
||||
|
||||
|
||||
EXIT STATUS
|
||||
|
@ -1769,7 +1770,7 @@ aria2 uses 5 connections to download 1 file by default.
|
|||
-s1 limits the number of connections to just 1.
|
||||
|
||||
[NOTE]
|
||||
To pause a download, press Ctrl-C. You can resume the transfer by running aria2c with the same argument in the same directory. You can change URLs as long as they are pointing to the same file.
|
||||
To pause a download, press Ctrl-C. You can resume the transfer by running aria2c with the same argument in the same directory. You can change URIs as long as they are pointing to the same file.
|
||||
|
||||
Download a file from 2 different HTTP servers
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
@ -2040,7 +2041,7 @@ You can specify step counter:
|
|||
aria2c -Z -P "http://host/image[A-Z:2].png"
|
||||
-------------------------------------------
|
||||
|
||||
Parallel downloads of arbitrary number of URL,metalink,torrent
|
||||
Parallel downloads of arbitrary number of URI,metalink,torrent
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
--------------------------------------------------------------
|
||||
aria2c -j3 -Z "http://host/file1" file2.torrent file3.metalink
|
||||
|
|
Loading…
Reference in New Issue