2009-02-15 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>

Enclosed all URLs in double quotes in command-line examples.
	* doc/aria2c.1.txt
pull/1/head
Tatsuhiro Tsujikawa 2009-02-15 03:36:55 +00:00
parent f362463e15
commit 604cbccd0a
4 changed files with 88 additions and 83 deletions

View File

@ -1,3 +1,8 @@
2009-02-15 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>
Enclosed all URLs in double quotes in command-line examples.
* doc/aria2c.1.txt
2009-02-15 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>
Updated reference/see also section.

View File

@ -143,7 +143,7 @@ The file name of the downloaded file\&.
.nr an-break-flag 1
.br
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 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 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"
.PP
\fB\-\-proxy\-method\fR=METHOD
.RS 4
@ -319,7 +319,7 @@ Enable HTTP/1\&.1 pipelining\&. Default:
.RS 4
Append HEADER to HTTP request header\&. You can use this option repeatedly to specify more than one header: aria2c
\fB\-\-header\fR="X\-A: b78"
\fB\-\-header\fR="X\-B: 9J1" http://host/file
\fB\-\-header\fR="X\-B: 9J1" "http://host/file"
.RE
.PP
\fB\-\-load\-cookies\fR=FILE
@ -1102,7 +1102,7 @@ Download a file
.sp
.RS 4
.nf
aria2c http://host/file\&.zip
aria2c "http://host/file\&.zip"
.fi
.RE
.sp
@ -1124,7 +1124,7 @@ Download a file using 1 connection
.sp
.RS 4
.nf
aria2c \-s1 http://host/file\&.zip
aria2c \-s1 "http://host/file\&.zip"
.fi
.RE
.sp
@ -1154,7 +1154,7 @@ Download a file from 2 different HTTP servers
.sp
.RS 4
.nf
aria2c http://host/file\&.zip http://mirror/file\&.zip
aria2c "http://host/file\&.zip" "http://mirror/file\&.zip"
.fi
.RE
.RE
@ -1168,7 +1168,7 @@ Download a file from HTTP and FTP servers
.sp
.RS 4
.nf
aria2c http://host1/file\&.zip ftp://host2/file\&.zip
aria2c "http://host1/file\&.zip" "ftp://host2/file\&.zip"
.fi
.RE
.RE
@ -1206,7 +1206,7 @@ For HTTP:
.sp
.RS 4
.nf
aria2c \-\-http\-proxy=http://proxy:8080 http://host/file
aria2c \-\-http\-proxy="http://proxy:8080" "http://host/file"
.fi
.RE
For FTP:
@ -1214,7 +1214,7 @@ For FTP:
.sp
.RS 4
.nf
aria2c \-\-ftp\-proxy=http://proxy:8080 ftp://host/file
aria2c \-\-ftp\-proxy="http://proxy:8080" "ftp://host/file"
.fi
.RE
.sp
@ -1236,7 +1236,7 @@ Proxy with authorization
.sp
.RS 4
.nf
aria2c \-\-http\-proxy=http://username:password@proxy:8080 http://host/file
aria2c \-\-http\-proxy="http://username:password@proxy:8080" "http://host/file"
.fi
.RE
.RE
@ -1251,7 +1251,7 @@ Download files with remote Metalink
.sp
.RS 4
.nf
aria2c \-\-follow\-metalink=mem http://host/file\&.metalink
aria2c \-\-follow\-metalink=mem "http://host/file\&.metalink"
.fi
.RE
.RE
@ -1338,7 +1338,7 @@ Download files from remote BitTorrent file
.sp
.RS 4
.nf
aria2c \-\-follow\-torrent=mem http://host/file\&.torrent
aria2c \-\-follow\-torrent=mem "http://host/file\&.torrent"
.fi
.RE
.RE
@ -1396,7 +1396,7 @@ Download a file using torrent and HTTP/FTP server
.sp
.RS 4
.nf
aria2c \-Ttest\&.torrent http://host1/file ftp://host2/file
aria2c \-Ttest\&.torrent "http://host1/file" "ftp://host2/file"
.fi
.RE
.sp
@ -1521,7 +1521,7 @@ Load cookies
.sp
.RS 4
.nf
aria2c \-\-load\-cookies=cookies\&.txt http://host/file\&.zip
aria2c \-\-load\-cookies=cookies\&.txt "http://host/file\&.zip"
.fi
.RE
.sp
@ -1543,7 +1543,7 @@ Resume download started by web browsers or another programs
.sp
.RS 4
.nf
aria2c \-c \-s2 http://host/partiallydownloadedfile\&.zip
aria2c \-c \-s2 "http://host/partiallydownloadedfile\&.zip"
.fi
.RE
.RE
@ -1646,7 +1646,7 @@ You can specify set of parts:
.sp
.RS 4
.nf
aria2c \-P http://{host1,host2,host3}/file\&.iso
aria2c \-P "http://{host1,host2,host3}/file\&.iso"
.fi
.RE
You can specify numeric sequence:
@ -1654,7 +1654,7 @@ You can specify numeric sequence:
.sp
.RS 4
.nf
aria2c \-Z \-P http://host/image[000\-100]\&.png
aria2c \-Z \-P "http://host/image[000\-100]\&.png"
.fi
.RE
.sp
@ -1671,7 +1671,7 @@ You can specify step counter:
.sp
.RS 4
.nf
aria2c \-Z \-P http://host/image[A\-Z:2]\&.png
aria2c \-Z \-P "http://host/image[A\-Z:2]\&.png"
.fi
.RE
.RE
@ -1685,7 +1685,7 @@ Parallel downloads of arbitrary number of URL,metalink,torrent
.sp
.RS 4
.nf
aria2c \-j3 \-Z http://host/file1 file2\&.torrent file3\&.metalink
aria2c \-j3 \-Z "http://host/file1" file2\&.torrent file3\&.metalink
.fi
.RE
.RE

View File

@ -554,7 +554,7 @@ downloading a file like BitTorrent.</p></div>
<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
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>
aria2c -o myfile.zip "http://mirror1/file.zip" "http://mirror2/file.zip"</td>
</tr></table>
</div>
<div class="vlist"><dl>
@ -789,7 +789,7 @@ aria2c -o myfile.zip http://mirror1/file.zip http://mirror2/file.zip</td>
<p>
Append HEADER to HTTP request header.
You can use this option repeatedly to specify more than one header:
aria2c <strong>--header</strong>="X-A: b78" <strong>--header</strong>="X-B: 9J1" http://host/file
aria2c <strong>--header</strong>="X-A: b78" <strong>--header</strong>="X-B: 9J1" "http://host/file"
</p>
</dd>
<dt>
@ -1881,7 +1881,7 @@ host=localhost, protocol=ftp, dl_speed=0, last_updated=1222491632, status=ERROR<
<h4 id="_download_a_file">Download a file</h4>
<div class="listingblock">
<div class="content">
<pre><tt>aria2c http://host/file.zip</tt></pre>
<pre><tt>aria2c "http://host/file.zip"</tt></pre>
</div></div>
<div class="admonitionblock">
<table><tr>
@ -1894,7 +1894,7 @@ host=localhost, protocol=ftp, dl_speed=0, last_updated=1222491632, status=ERROR<
<h4 id="_download_a_file_using_1_connection">Download a file using 1 connection</h4>
<div class="listingblock">
<div class="content">
<pre><tt>aria2c -s1 http://host/file.zip</tt></pre>
<pre><tt>aria2c -s1 "http://host/file.zip"</tt></pre>
</div></div>
<div class="admonitionblock">
<table><tr>
@ -1916,12 +1916,12 @@ host=localhost, protocol=ftp, dl_speed=0, last_updated=1222491632, status=ERROR<
<h4 id="_download_a_file_from_2_different_http_servers">Download a file from 2 different HTTP servers</h4>
<div class="listingblock">
<div class="content">
<pre><tt>aria2c http://host/file.zip http://mirror/file.zip</tt></pre>
<pre><tt>aria2c "http://host/file.zip" "http://mirror/file.zip"</tt></pre>
</div></div>
<h4 id="_download_a_file_from_http_and_ftp_servers">Download a file from HTTP and FTP servers</h4>
<div class="listingblock">
<div class="content">
<pre><tt>aria2c http://host1/file.zip ftp://host2/file.zip</tt></pre>
<pre><tt>aria2c "http://host1/file.zip" "ftp://host2/file.zip"</tt></pre>
</div></div>
<h4 id="_download_files_listed_in_a_text_file_concurrently">Download files listed in a text file concurrently</h4>
<div class="listingblock">
@ -1940,12 +1940,12 @@ host=localhost, protocol=ftp, dl_speed=0, last_updated=1222491632, status=ERROR<
<div class="para"><p>For HTTP:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt>aria2c --http-proxy=http://proxy:8080 http://host/file</tt></pre>
<pre><tt>aria2c --http-proxy="http://proxy:8080" "http://host/file"</tt></pre>
</div></div>
<div class="para"><p>For FTP:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt>aria2c --ftp-proxy=http://proxy:8080 ftp://host/file</tt></pre>
<pre><tt>aria2c --ftp-proxy="http://proxy:8080" "ftp://host/file"</tt></pre>
</div></div>
<div class="admonitionblock">
<table><tr>
@ -1960,13 +1960,13 @@ You can specify proxy in the environment variables. See <strong>ENVIRONMENT</str
<h4 id="_proxy_with_authorization">Proxy with authorization</h4>
<div class="listingblock">
<div class="content">
<pre><tt>aria2c --http-proxy=http://username:password@proxy:8080 http://host/file</tt></pre>
<pre><tt>aria2c --http-proxy="http://username:password@proxy:8080" "http://host/file"</tt></pre>
</div></div>
<h3 id="_metalink_download">Metalink Download</h3><div style="clear:left"></div>
<h4 id="_download_files_with_remote_metalink">Download files with remote Metalink</h4>
<div class="listingblock">
<div class="content">
<pre><tt>aria2c --follow-metalink=mem http://host/file.metalink</tt></pre>
<pre><tt>aria2c --follow-metalink=mem "http://host/file.metalink"</tt></pre>
</div></div>
<h4 id="_download_using_a_local_metalink_file">Download using a local metalink file</h4>
<div class="listingblock">
@ -2010,7 +2010,7 @@ directory.</td>
<h4 id="_download_files_from_remote_bittorrent_file">Download files from remote BitTorrent file</h4>
<div class="listingblock">
<div class="content">
<pre><tt>aria2c --follow-torrent=mem http://host/file.torrent</tt></pre>
<pre><tt>aria2c --follow-torrent=mem "http://host/file.torrent"</tt></pre>
</div></div>
<h4 id="_download_using_a_local_torrent_file">Download using a local torrent file</h4>
<div class="listingblock">
@ -2041,7 +2041,7 @@ directory.</td>
<h4 id="_download_a_file_using_torrent_and_http_ftp_server">Download a file using torrent and HTTP/FTP server</h4>
<div class="listingblock">
<div class="content">
<pre><tt>aria2c -Ttest.torrent http://host1/file ftp://host2/file</tt></pre>
<pre><tt>aria2c -Ttest.torrent "http://host1/file" "ftp://host2/file"</tt></pre>
</div></div>
<div class="admonitionblock">
<table><tr>
@ -2114,7 +2114,7 @@ forwarding, it's up to you to do it manually.</td>
<h4 id="_load_cookies">Load cookies</h4>
<div class="listingblock">
<div class="content">
<pre><tt>aria2c --load-cookies=cookies.txt http://host/file.zip</tt></pre>
<pre><tt>aria2c --load-cookies=cookies.txt "http://host/file.zip"</tt></pre>
</div></div>
<div class="admonitionblock">
<table><tr>
@ -2127,7 +2127,7 @@ forwarding, it's up to you to do it manually.</td>
<h4 id="_resume_download_started_by_web_browsers_or_another_programs">Resume download started by web browsers or another programs</h4>
<div class="listingblock">
<div class="content">
<pre><tt>aria2c -c -s2 http://host/partiallydownloadedfile.zip</tt></pre>
<pre><tt>aria2c -c -s2 "http://host/partiallydownloadedfile.zip"</tt></pre>
</div></div>
<h4 id="_client_certificate_authorization_for_ssl_tls">Client certificate authorization for SSL/TLS</h4>
<div class="listingblock">
@ -2177,12 +2177,12 @@ checksums.</td>
<div class="para"><p>You can specify set of parts:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt>aria2c -P http://{host1,host2,host3}/file.iso</tt></pre>
<pre><tt>aria2c -P "http://{host1,host2,host3}/file.iso"</tt></pre>
</div></div>
<div class="para"><p>You can specify numeric sequence:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt>aria2c -Z -P http://host/image[000-100].png</tt></pre>
<pre><tt>aria2c -Z -P "http://host/image[000-100].png"</tt></pre>
</div></div>
<div class="admonitionblock">
<table><tr>
@ -2195,12 +2195,12 @@ checksums.</td>
<div class="para"><p>You can specify step counter:</p></div>
<div class="listingblock">
<div class="content">
<pre><tt>aria2c -Z -P http://host/image[A-Z:2].png</tt></pre>
<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>
<div class="listingblock">
<div class="content">
<pre><tt>aria2c -j3 -Z http://host/file1 file2.torrent file3.metalink</tt></pre>
<pre><tt>aria2c -j3 -Z "http://host/file1" file2.torrent file3.metalink</tt></pre>
</div></div>
<h4 id="_bittorrent_encryption">BitTorrent Encryption</h4>
<div class="para"><p>Encrypt whole payload using ARC4:</p></div>
@ -2244,7 +2244,7 @@ files in the program, then also delete it here.</p></div>
</div>
<div id="footer">
<div id="footer-text">
Last updated 2009-02-15 12:20:50 JST
Last updated 2009-02-15 12:35:52 JST
</div>
</div>
</body>

View File

@ -115,7 +115,7 @@ HTTP/FTP Options
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 *-i*, *-Z* option. For example:
aria2c -o myfile.zip \http://mirror1/file.zip \http://mirror2/file.zip
aria2c -o myfile.zip "http://mirror1/file.zip" "http://mirror2/file.zip"
*--proxy-method*=METHOD::
Set the method to use in proxy request. 'METHOD' is either 'get' or
@ -238,7 +238,7 @@ HTTP Specific Options
*--header*=HEADER::
Append HEADER to HTTP request header.
You can use this option repeatedly to specify more than one header:
aria2c *--header*="X-A: b78" *--header*="X-B: 9J1" \http://host/file
aria2c *--header*="X-A: b78" *--header*="X-B: 9J1" "http://host/file"
*--load-cookies*=FILE::
Load Cookies from FILE using the Firefox3 format (SQLite3) and the
@ -874,7 +874,7 @@ HTTP/FTP Segmented Download
Download a file
^^^^^^^^^^^^^^^
--------------------------------
aria2c http://host/file.zip
aria2c "http://host/file.zip"
--------------------------------
[NOTE]
aria2 uses 5 connections to download 1 file by default.
@ -882,7 +882,7 @@ aria2 uses 5 connections to download 1 file by default.
Download a file using 1 connection
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
----------------------------------
aria2c -s1 http://host/file.zip
aria2c -s1 "http://host/file.zip"
----------------------------------
[NOTE]
aria2 uses 5 connections to download 1 file by default.
@ -893,15 +893,15 @@ To pause a download, press Ctrl-C. You can resume the transfer by running aria2c
Download a file from 2 different HTTP servers
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
--------------------------------------------------
aria2c http://host/file.zip http://mirror/file.zip
--------------------------------------------------
------------------------------------------------------
aria2c "http://host/file.zip" "http://mirror/file.zip"
------------------------------------------------------
Download a file from HTTP and FTP servers
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-------------------------------------------------
aria2c http://host1/file.zip ftp://host2/file.zip
-------------------------------------------------
-----------------------------------------------------
aria2c "http://host1/file.zip" "ftp://host2/file.zip"
-----------------------------------------------------
Download files listed in a text file concurrently
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@ -914,13 +914,13 @@ aria2c -ifiles.txt -j2
Using proxy
^^^^^^^^^^^
For HTTP:
------------------------------------------------------
aria2c --http-proxy=http://proxy:8080 http://host/file
------------------------------------------------------
----------------------------------------------------------
aria2c --http-proxy="http://proxy:8080" "http://host/file"
----------------------------------------------------------
For FTP:
------------------------------------------------------
aria2c --ftp-proxy=http://proxy:8080 ftp://host/file
------------------------------------------------------
--------------------------------------------------------
aria2c --ftp-proxy="http://proxy:8080" "ftp://host/file"
--------------------------------------------------------
[NOTE]
See *--http-proxy*, *--https-proxy*, *--ftp-proxy* and *--all-proxy* for
@ -929,17 +929,17 @@ You can specify proxy in the environment variables. See *ENVIRONMENT* section.
Proxy with authorization
^^^^^^^^^^^^^^^^^^^^^^^^
------------------------------------------------------
aria2c --http-proxy=http://username:password@proxy:8080 http://host/file
------------------------------------------------------
----------------------------------------------------------------------------
aria2c --http-proxy="http://username:password@proxy:8080" "http://host/file"
----------------------------------------------------------------------------
Metalink Download
~~~~~~~~~~~~~~~~~
Download files with remote Metalink
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
------------------------------------------------------
aria2c --follow-metalink=mem http://host/file.metalink
------------------------------------------------------
--------------------------------------------------------
aria2c --follow-metalink=mem "http://host/file.metalink"
--------------------------------------------------------
Download using a local metalink file
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@ -975,9 +975,9 @@ BitTorrent Download
~~~~~~~~~~~~~~~~~~~
Download files from remote BitTorrent file
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-------------------------------------------------------
aria2c --follow-torrent=mem http://host/file.torrent
-------------------------------------------------------
------------------------------------------------------
aria2c --follow-torrent=mem "http://host/file.torrent"
------------------------------------------------------
Download using a local torrent file
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@ -998,9 +998,9 @@ aria2c -j2 file1.torrent file2.torrent
Download a file using torrent and HTTP/FTP server
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-----------------------------------------------------------
aria2c -Ttest.torrent http://host1/file ftp://host2/file
-----------------------------------------------------------
------------------------------------------------------------
aria2c -Ttest.torrent "http://host1/file" "ftp://host2/file"
------------------------------------------------------------
[NOTE]
Downloading multi file torrent with HTTP/FTP is not supported.
@ -1049,17 +1049,17 @@ More advanced HTTP features
~~~~~~~~~~~~~~~~~~~~~~~~~~~
Load cookies
^^^^^^^^^^^^
------------------------------------------------------
aria2c --load-cookies=cookies.txt http://host/file.zip
------------------------------------------------------
--------------------------------------------------------
aria2c --load-cookies=cookies.txt "http://host/file.zip"
--------------------------------------------------------
[NOTE]
You can use Firefox/Mozilla's cookie file without modification.
Resume download started by web browsers or another programs
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
---------------------------------------------------
aria2c -c -s2 http://host/partiallydownloadedfile.zip
---------------------------------------------------
-------------------------------------------------------
aria2c -c -s2 "http://host/partiallydownloadedfile.zip"
-------------------------------------------------------
Client certificate authorization for SSL/TLS
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@ -1102,28 +1102,28 @@ aria2c --lowest-speed-limit=10K file.metalink
Parameterized URI support
^^^^^^^^^^^^^^^^^^^^^^^^^
You can specify set of parts:
---------------------------------------------
aria2c -P http://{host1,host2,host3}/file.iso
---------------------------------------------
-----------------------------------------------
aria2c -P "http://{host1,host2,host3}/file.iso"
-----------------------------------------------
You can specify numeric sequence:
-------------------------------------------
aria2c -Z -P http://host/image[000-100].png
-------------------------------------------
---------------------------------------------
aria2c -Z -P "http://host/image[000-100].png"
---------------------------------------------
[NOTE]
-Z option is required if the all URIs don't point to the same file, such as the above example.
You can specify step counter:
-----------------------------------------
aria2c -Z -P http://host/image[A-Z:2].png
-----------------------------------------
-------------------------------------------
aria2c -Z -P "http://host/image[A-Z:2].png"
-------------------------------------------
Parallel downloads of arbitrary number of URL,metalink,torrent
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
------------------------------------------------------------
aria2c -j3 -Z http://host/file1 file2.torrent file3.metalink
------------------------------------------------------------
--------------------------------------------------------------
aria2c -j3 -Z "http://host/file1" file2.torrent file3.metalink
--------------------------------------------------------------
BitTorrent Encryption
^^^^^^^^^^^^^^^^^^^^^