|
|
@@ -377,7 +377,7 @@ ARIA2C(1) Manual Page
|
|
|
</div>
|
|
|
<h2 id="_description">DESCRIPTION</h2>
|
|
|
<div class="sectionbody">
|
|
|
-<div class="para"><p>aria2 is a utility for downloading files. The supported protocols are HTTP(S), FTP, BitTorrent, and Metalink. It can download a file from multiple sources/protocols and tries to utilize your maximum download bandwidth. It supports downloading a file from HTTP(S)/FTP and BitTorrent at the same time, while the data downloaded from HTTP(S)/FTP is uploaded to the BitTorrent swarm. Using Metalink's chunk checksums, aria2 automatically validates chunks of data while downloading a file like BitTorrent.</p></div>
|
|
|
+<div class="para"><p>aria2 is a utility for downloading files. The supported protocols are HTTP(S), FTP, BitTorrent, and Metalink. aria2 can download a file from multiple sources/protocols and tries to utilize your maximum download bandwidth. It supports downloading a file from HTTP(S)/FTP and BitTorrent at the same time, while the data downloaded from HTTP(S)/FTP is uploaded to the BitTorrent swarm. Using Metalink's chunk checksums, aria2 automatically validates chunks of data while downloading a file like BitTorrent.</p></div>
|
|
|
</div>
|
|
|
<h2 id="_options">OPTIONS</h2>
|
|
|
<div class="sectionbody">
|
|
|
@@ -469,8 +469,8 @@ ARIA2C(1) Manual Page
|
|
|
</dt>
|
|
|
<dd>
|
|
|
<p>
|
|
|
- Use this proxy server in the all protocols.
|
|
|
- You can override this setting and specify a proxy server for particular
|
|
|
+ Use this proxy server for all protocols.
|
|
|
+ You can override this setting and specify a proxy server for a particular
|
|
|
proctol using <strong>--http-proxy</strong>, <strong>--https-proxy</strong> and <strong>--ftp-proxy</strong> options.
|
|
|
This affects all URLs.
|
|
|
The format of PROXY is [http://][USER:PASSWORD@]HOST[:PORT]
|
|
|
@@ -508,7 +508,7 @@ ARIA2C(1) Manual Page
|
|
|
If aria2 recieves `file not found' status from the remote HTTP/FTP
|
|
|
servers NUM times without getting a single byte, then force the
|
|
|
download to fail. Specify <em>0</em> to disable this option. This options is
|
|
|
- only effective only when using HTTP/FTP servers.
|
|
|
+ effective only when using HTTP/FTP servers.
|
|
|
Default: <em>0</em>
|
|
|
</p>
|
|
|
</dd>
|
|
|
@@ -526,7 +526,7 @@ ARIA2C(1) Manual Page
|
|
|
</dt>
|
|
|
<dd>
|
|
|
<p>
|
|
|
- Specify comma separated hostnames or domains to which proxy should not be
|
|
|
+ Specify comma separated hostnames or domains where proxy should not be
|
|
|
used.
|
|
|
</p>
|
|
|
</dd>
|
|
|
@@ -544,9 +544,9 @@ ARIA2C(1) Manual Page
|
|
|
<td class="icon">
|
|
|
<div class="title">Note</div>
|
|
|
</td>
|
|
|
-<td class="content">In Metalink, BitTorrent download you cannot specify file name.
|
|
|
+<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
|
|
|
-is done by command line without <strong>-i</strong>, <strong>-Z</strong> option. For example:
|
|
|
+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>
|
|
|
</div>
|
|
|
@@ -783,7 +783,7 @@ aria2c -o myfile.zip http://mirror1/file.zip http://mirror2/file.zip</td>
|
|
|
</dt>
|
|
|
<dd>
|
|
|
<p>
|
|
|
- Load Cookies from FILE using the Firefox3 format(SQLite3) and the
|
|
|
+ Load Cookies from FILE using the Firefox3 format (SQLite3) and the
|
|
|
Mozilla/Firefox(1.x/2.x)/Netscape format.
|
|
|
</p>
|
|
|
</dd>
|
|
|
@@ -793,7 +793,7 @@ aria2c -o myfile.zip http://mirror1/file.zip http://mirror2/file.zip</td>
|
|
|
<td class="icon">
|
|
|
<div class="title">Note</div>
|
|
|
</td>
|
|
|
-<td class="content">If aria2 is build without libsqlite3, then it doesn't support Firefox3 cookie.</td>
|
|
|
+<td class="content">If aria2 is built without libsqlite3, then it doesn't support Firefox3 cookie format.</td>
|
|
|
</tr></table>
|
|
|
</div>
|
|
|
<div class="vlist"><dl>
|
|
|
@@ -880,7 +880,7 @@ aria2c -o myfile.zip http://mirror1/file.zip http://mirror2/file.zip</td>
|
|
|
</dt>
|
|
|
<dd>
|
|
|
<p>
|
|
|
- Set file to download by specifing its index.
|
|
|
+ Set file to download by specifying its index.
|
|
|
You can find the file index using the <strong>--show-files</strong> option.
|
|
|
Multiple indexes can be specified by using ",", for example: <em>3,6</em>.
|
|
|
You can also use "-" to specify a range: <em>1-5</em>.
|
|
|
@@ -930,7 +930,7 @@ writes the piece to the appropriate files.</td>
|
|
|
<dd>
|
|
|
<p>
|
|
|
Set minimum level of encryption method.
|
|
|
- If several encryption methods are provided by a peer, aria2 chooses a lowest
|
|
|
+ If several encryption methods are provided by a peer, aria2 chooses the lowest
|
|
|
one which satisfies the given level.
|
|
|
Default: <em>plain</em>
|
|
|
</p>
|
|
|
@@ -1091,7 +1091,7 @@ writes the piece to the appropriate files.</td>
|
|
|
<p>
|
|
|
Specify share ratio. Seed completed torrents until share ratio reaches]
|
|
|
RATIO.
|
|
|
- I strongly encourages you to specify equals or more than <em>1.0</em> here.
|
|
|
+ You are strongly encouraged to specify equals or more than <em>1.0</em> here.
|
|
|
Specify <em>0.0</em> if you intend to do seeding regardless of share ratio.
|
|
|
If <strong>--seed-time</strong> option is specified along with this option, seeding ends when
|
|
|
at least one of the conditions is satisfied.
|
|
|
@@ -1112,7 +1112,7 @@ writes the piece to the appropriate files.</td>
|
|
|
<dd>
|
|
|
<p>
|
|
|
The path to the .torrent file.
|
|
|
- You may not use this option because you can specify torrent file without -T.
|
|
|
+ You are not required to use this option because you can specify a torrent file without -T.
|
|
|
</p>
|
|
|
</dd>
|
|
|
</dl></div>
|
|
|
@@ -1124,7 +1124,7 @@ writes the piece to the appropriate files.</td>
|
|
|
<dd>
|
|
|
<p>
|
|
|
If <em>true</em> or <em>mem</em> is specified, when a file whose suffix is ".metaink" or content
|
|
|
- type is "application/metalink+xml" is downloaded, aria2 parses it as a metalink
|
|
|
+ type of "application/metalink+xml" is downloaded, aria2 parses it as a metalink
|
|
|
file and downloads files mentioned in it.
|
|
|
If <em>mem</em> is specified, a metalink file is not written to the disk, but is just
|
|
|
kept in memory.
|
|
|
@@ -1137,8 +1137,8 @@ writes the piece to the appropriate files.</td>
|
|
|
</dt>
|
|
|
<dd>
|
|
|
<p>
|
|
|
- The file path to .metalink file. You may not use this option because you can
|
|
|
- specify metalink file without -M.
|
|
|
+ The file path to .metalink file. You are not required to use this option because you can
|
|
|
+ specify a metalink file without -M.
|
|
|
</p>
|
|
|
</dd>
|
|
|
<dt>
|
|
|
@@ -1147,7 +1147,7 @@ writes the piece to the appropriate files.</td>
|
|
|
<dd>
|
|
|
<p>
|
|
|
The number of servers to connect to simultaneously.
|
|
|
- Some Metalinks regulates the number of servers to connect.
|
|
|
+ Some Metalinks regulate the number of servers to connect.
|
|
|
aria2 strictly respects them.
|
|
|
This means that if Metalink defines the maxconnections attribute lower
|
|
|
than NUM_SERVERS, then aria2 uses the value of maxconnections attribute
|
|
|
@@ -1170,7 +1170,7 @@ writes the piece to the appropriate files.</td>
|
|
|
<dd>
|
|
|
<p>
|
|
|
The location of the preferred server.
|
|
|
- A comma-deliminated list of locations is acceptable, for example, <em>JP,US</em>.
|
|
|
+ A comma-delimited list of locations is acceptable, for example, <em>JP,US</em>.
|
|
|
</p>
|
|
|
</dd>
|
|
|
<dt>
|
|
|
@@ -1335,8 +1335,8 @@ writes the piece to the appropriate files.</td>
|
|
|
<td class="icon">
|
|
|
<div class="title">Note</div>
|
|
|
</td>
|
|
|
-<td class="content">In multi file torrent, the files adjacent forward to the specified files
|
|
|
-are also allocated if they share a same piece.</td>
|
|
|
+<td class="content">In multi file torrent downloads, the files adjacent forward to the specified files
|
|
|
+are also allocated if they share the same piece.</td>
|
|
|
</tr></table>
|
|
|
</div>
|
|
|
<div class="vlist"><dl>
|
|
|
@@ -1398,7 +1398,7 @@ are also allocated if they share a same piece.</td>
|
|
|
</dt>
|
|
|
<dd>
|
|
|
<p>
|
|
|
- Make aria2 quite (no console output).
|
|
|
+ Make aria2 quiet (no console output).
|
|
|
Default: <em>false</em>
|
|
|
</p>
|
|
|
</dd>
|
|
|
@@ -1407,8 +1407,8 @@ are also allocated if they share a same piece.</td>
|
|
|
</dt>
|
|
|
<dd>
|
|
|
<p>
|
|
|
- Validate chunk of data by calculating checkusm while download a file if
|
|
|
- chunk checksums are provided. Currently Metalink is the only way to to
|
|
|
+ Validate chunk of data by calculating checksum while downloading a file if
|
|
|
+ chunk checksums are provided. Currently Metalink is the only way to
|
|
|
provide chunk checksums.
|
|
|
Default: <em>true</em>
|
|
|
</p>
|
|
|
@@ -1437,17 +1437,17 @@ are also allocated if they share a same piece.</td>
|
|
|
<div class="para"><p>The options that have its argument surrounded by square brackets([])
|
|
|
take an optional argument. Usually ommiting the argument is evaluated to <em>true</em>.
|
|
|
If you use short form of these options(such as <em>-V</em>) and give
|
|
|
-an arugment, then the option name and its argument should be concatenated(e.g.
|
|
|
+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="_url_torrent_file_metalink_file">URL, TORRENT_FILE, METALINK_FILE</h3><div style="clear:left"></div>
|
|
|
<div class="para"><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 fail.</p></div>
|
|
|
<div class="para"><p>You can also specify arbitrary number of torrent files and metalink files
|
|
|
-stored in a local drive. Please note that they are always treated as a
|
|
|
+stored on a local drive. Please note that they are always treated as a
|
|
|
separate download.</p></div>
|
|
|
<div class="para"><p>You can specify both torrent file with -T option and URLs. By doing this,
|
|
|
-download a file from both torrent swarm and HTTP(S)/FTP server at the same time,
|
|
|
+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. Note that
|
|
|
only single file torrent can be integrated with HTTP(S)/FTP.</p></div>
|
|
|
<div class="admonitionblock">
|
|
|
@@ -1495,7 +1495,7 @@ contains "&" or any characters that have special meaning in shell.</td>
|
|
|
<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 at 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 URLs 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>
|
|
|
@@ -1508,7 +1508,7 @@ contains "&" or any characters that have special meaning in shell.</td>
|
|
|
<div class="content">
|
|
|
<pre><tt>aria2c http://host1/file.zip ftp://host2/file.zip</tt></pre>
|
|
|
</div></div>
|
|
|
-<h4 id="_download_files_listed_in_a_file_concurrently">Download files listed in a file concurrently</h4>
|
|
|
+<h4 id="_download_files_listed_in_a_text_file_concurrently">Download files listed in a text file concurrently</h4>
|
|
|
<div class="listingblock">
|
|
|
<div class="content">
|
|
|
<pre><tt>aria2c -ifiles.txt -j2</tt></pre>
|
|
|
@@ -1564,7 +1564,7 @@ You can specify proxy in the environment variables. See ENVIRONMENT section.</td
|
|
|
<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 at the same
|
|
|
+You can resume the transfer by running aria2c with the same argument in the same
|
|
|
directory.</td>
|
|
|
</tr></table>
|
|
|
</div>
|
|
|
@@ -1615,7 +1615,7 @@ directory.</td>
|
|
|
<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 run aria2c with the same argument at the same directory.</td>
|
|
|
+<td class="content">To pause a download, press Ctrl-C. You can resume the transfer by run aria2c with the same argument in the same directory.</td>
|
|
|
</tr></table>
|
|
|
</div>
|
|
|
<h4 id="_download_2_torrents">Download 2 torrents</h4>
|
|
|
@@ -1673,7 +1673,7 @@ to you to do it manually.</td>
|
|
|
<td class="icon">
|
|
|
<div class="title">Note</div>
|
|
|
</td>
|
|
|
-<td class="content">In the above example, the program exists when the 120 minutes has elapsed since download completed or seed ratio reaches 1.0.</td>
|
|
|
+<td class="content">In the above example, the program exits when the 120 minutes has elapsed since download completed or seed ratio reaches 1.0.</td>
|
|
|
</tr></table>
|
|
|
</div>
|
|
|
<h4 id="_throttle_upload_speed">Throttle upload speed</h4>
|
|
|
@@ -1798,13 +1798,13 @@ checksums.</td>
|
|
|
<div class="sectionbody">
|
|
|
<div class="para"><p>Usually, you can resume transfer by just issuing same command(aria2c URL)
|
|
|
if the previous transfer is made by aria2.</p></div>
|
|
|
-<div class="para"><p>If the previous transfer is made by a browser or wget like sequencial
|
|
|
+<div class="para"><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 -c URL).</p></div>
|
|
|
</div>
|
|
|
<h2 id="_control_file">CONTROL FILE</h2>
|
|
|
<div class="sectionbody">
|
|
|
-<div class="para"><p>aria2 uses a control file to keep track the progress of download.
|
|
|
-A control file is placed at the same directory of the dowloading file and
|
|
|
+<div class="para"><p>aria2 uses a control file to track the progress of a download.
|
|
|
+A control file is placed in the same directory as the dowloading file and
|
|
|
its filename is the filename of downloading file with ".aria2" appended.
|
|
|
For example, if you are downloading file.zip, then the control file should be
|
|
|
file.zip.aria2.
|
|
|
@@ -1831,14 +1831,14 @@ you can resume the download without a control file by giving
|
|
|
</div>
|
|
|
<h2 id="_input_file">INPUT FILE</h2>
|
|
|
<div class="sectionbody">
|
|
|
-<div class="para"><p>The input file can contain list of URIs to feed them into aria2.
|
|
|
+<div class="para"><p>The input file can contain a list of URIs for aria2 to download.
|
|
|
You can specify multiple URIs for a single entity:
|
|
|
separate URIs on a single line using the TAB character.</p></div>
|
|
|
<div class="para"><p>Each line is treated as if it is provided in command-line argument.
|
|
|
Therefore they are affected by <strong>-Z</strong> and <strong>-P</strong> options.
|
|
|
The additional <strong>out</strong> and <strong>dir</strong> options can be specified after each line of
|
|
|
URIs. This optional line must start with white space(s).</p></div>
|
|
|
-<div class="para"><p>For example, let the content of uri.txt be</p></div>
|
|
|
+<div class="para"><p>For example, the content of uri.txt is</p></div>
|
|
|
<div class="listingblock">
|
|
|
<div class="content">
|
|
|
<pre><tt>http://server/file.iso http://mirror/file.iso
|
|
|
@@ -1905,7 +1905,7 @@ status
|
|
|
</dd>
|
|
|
</dl></div>
|
|
|
<div class="para"><p>Those fields must exist in one line. The order of the fields is not significant.You can put pairs other than above; they are simply ignored.</p></div>
|
|
|
-<div class="para"><p>An example is follow:</p></div>
|
|
|
+<div class="para"><p>An example follows:</p></div>
|
|
|
<div class="listingblock">
|
|
|
<div class="content">
|
|
|
<pre><tt>host=localhost, protocol=http, dl_speed=32000, last_updated=1222491640, status=OK
|
|
|
@@ -1916,7 +1916,7 @@ host=localhost, protocol=ftp, dl_speed=0, last_updated=1222491632, status=ERROR<
|
|
|
<div class="sectionbody">
|
|
|
<h3 id="_aria2_conf">aria2.conf</h3><div style="clear:left"></div>
|
|
|
<div class="para"><p>User configuration file.
|
|
|
-It must be placed under $HOME/.aria2 and must be named as aria2.conf.
|
|
|
+It must be placed under $HOME/.aria2 and must be named aria2.conf.
|
|
|
In each line, there is 1 parameter whose syntax is name=value pair,
|
|
|
where name is the long command-line option name without <em>--</em> prefix.
|
|
|
The lines beginning <em>#</em> are treated as comments.</p></div>
|
|
|
@@ -2030,7 +2030,7 @@ files in the program, then also delete it here.</p></div>
|
|
|
</div>
|
|
|
<div id="footer">
|
|
|
<div id="footer-text">
|
|
|
-Last updated 2008-11-20 21:02:18 JST
|
|
|
+Last updated 2008-11-28 23:31:27 JST
|
|
|
</div>
|
|
|
</div>
|
|
|
</body>
|
Tatsuhiro Tsujikawa