mirror of https://github.com/aria2/aria2
2009-05-27 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>
Updated README for 1.4.0 release. Use new table syntax of asciidoc. * READMEpull/1/head
parent
1c1ec3bd6d
commit
861ada066f
|
@ -1,3 +1,9 @@
|
||||||
|
2009-05-27 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>
|
||||||
|
|
||||||
|
Updated README for 1.4.0 release. Use new table syntax of
|
||||||
|
asciidoc.
|
||||||
|
* README
|
||||||
|
|
||||||
2009-05-27 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>
|
2009-05-27 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>
|
||||||
|
|
||||||
Documented --xml-rpc-max-request-size option in man page.
|
Documented --xml-rpc-max-request-size option in man page.
|
||||||
|
|
26
README
26
README
|
@ -37,6 +37,7 @@ Here is a list of features.
|
||||||
* Chunked transfer encoding support
|
* Chunked transfer encoding support
|
||||||
* Load Cookies from file using the Firefox3 format and the Mozilla/Firefox
|
* Load Cookies from file using the Firefox3 format and the Mozilla/Firefox
|
||||||
(1.x/2.x)/Netscape format.
|
(1.x/2.x)/Netscape format.
|
||||||
|
* Save Cookies in the Mozilla/Firefox (1.x/2.x)/Netscape format.
|
||||||
* Custom HTTP Header support
|
* Custom HTTP Header support
|
||||||
* Persistent Connections support
|
* Persistent Connections support
|
||||||
* FTP through HTTP Proxy
|
* FTP through HTTP Proxy
|
||||||
|
@ -46,6 +47,7 @@ Here is a list of features.
|
||||||
(single-file torrent only)
|
(single-file torrent only)
|
||||||
* Rename/change the directory structure of BitTorrent downloads
|
* Rename/change the directory structure of BitTorrent downloads
|
||||||
completely
|
completely
|
||||||
|
* XML-RPC interface
|
||||||
* Run as a daemon process
|
* Run as a daemon process
|
||||||
* Selective download in multi-file torrent/Metalink
|
* Selective download in multi-file torrent/Metalink
|
||||||
* Chunk checksum validation in Metalink
|
* Chunk checksum validation in Metalink
|
||||||
|
@ -60,18 +62,18 @@ Dependency
|
||||||
----------
|
----------
|
||||||
|
|
||||||
.External Library Dependency
|
.External Library Dependency
|
||||||
[frame="all", grid="all"]
|
[options="header"]
|
||||||
`--------------------`---------------------------
|
|=================================================
|
||||||
features dependency
|
|features |dependency
|
||||||
-------------------------------------------------
|
|HTTPS |GnuTLS or OpenSSL
|
||||||
HTTPS GnuTLS or OpenSSL
|
|BitTorrent |GnuTLS+Libgcrypt or OpenSSL
|
||||||
BitTorrent GnuTLS+Libgcrypt or OpenSSL
|
|Metalink |libxml2 or Expat.
|
||||||
Metalink libxml2 or Expat.
|
|Checksum |GnuTLS+Libgcrypt or OpenSSL
|
||||||
Checksum GnuTLS+Libgcrypt or OpenSSL
|
|gzip, deflate in HTTP|zlib
|
||||||
gzip, deflate in HTTP zlib
|
|Async DNS |C-Ares
|
||||||
Async DNS C-Ares
|
|Firefox3 cookie |libsqlite3
|
||||||
Firefox3 cookie libsqlite3
|
|XML-RPC |libxml2 or Expat.
|
||||||
-------------------------------------------------
|
|=================================================
|
||||||
|
|
||||||
Note;;
|
Note;;
|
||||||
GNU TLS has precedence over OpenSSL if both libraries are installed.
|
GNU TLS has precedence over OpenSSL if both libraries are installed.
|
||||||
|
|
284
README.html
284
README.html
|
@ -3,7 +3,8 @@
|
||||||
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
|
||||||
<head>
|
<head>
|
||||||
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
||||||
<meta name="generator" content="AsciiDoc 8.2.7" />
|
<meta name="generator" content="AsciiDoc 8.4.4" />
|
||||||
|
<title>aria2 - The ultra fast download utility</title>
|
||||||
<style type="text/css">
|
<style type="text/css">
|
||||||
/* Debug borders */
|
/* Debug borders */
|
||||||
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
|
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
|
||||||
|
@ -110,11 +111,13 @@ div#footer-badges {
|
||||||
padding-bottom: 0.5em;
|
padding-bottom: 0.5em;
|
||||||
}
|
}
|
||||||
|
|
||||||
div#preamble,
|
div#preamble {
|
||||||
|
margin-top: 1.5em;
|
||||||
|
margin-bottom: 1.5em;
|
||||||
|
}
|
||||||
div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
|
div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
|
||||||
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
|
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
|
||||||
div.admonitionblock {
|
div.admonitionblock {
|
||||||
margin-right: 10%;
|
|
||||||
margin-top: 1.5em;
|
margin-top: 1.5em;
|
||||||
margin-bottom: 1.5em;
|
margin-bottom: 1.5em;
|
||||||
}
|
}
|
||||||
|
@ -156,9 +159,6 @@ div.sidebarblock > div.content {
|
||||||
padding: 0.5em;
|
padding: 0.5em;
|
||||||
}
|
}
|
||||||
|
|
||||||
div.listingblock {
|
|
||||||
margin-right: 0%;
|
|
||||||
}
|
|
||||||
div.listingblock > div.content {
|
div.listingblock > div.content {
|
||||||
border: 1px solid silver;
|
border: 1px solid silver;
|
||||||
background: #f4f4f4;
|
background: #f4f4f4;
|
||||||
|
@ -167,6 +167,7 @@ div.listingblock > div.content {
|
||||||
|
|
||||||
div.quoteblock {
|
div.quoteblock {
|
||||||
padding-left: 2.0em;
|
padding-left: 2.0em;
|
||||||
|
margin-right: 10%;
|
||||||
}
|
}
|
||||||
div.quoteblock > div.attribution {
|
div.quoteblock > div.attribution {
|
||||||
padding-top: 0.5em;
|
padding-top: 0.5em;
|
||||||
|
@ -175,6 +176,7 @@ div.quoteblock > div.attribution {
|
||||||
|
|
||||||
div.verseblock {
|
div.verseblock {
|
||||||
padding-left: 2.0em;
|
padding-left: 2.0em;
|
||||||
|
margin-right: 10%;
|
||||||
}
|
}
|
||||||
div.verseblock > div.content {
|
div.verseblock > div.content {
|
||||||
white-space: pre;
|
white-space: pre;
|
||||||
|
@ -218,6 +220,7 @@ dt {
|
||||||
margin-top: 0.5em;
|
margin-top: 0.5em;
|
||||||
margin-bottom: 0;
|
margin-bottom: 0;
|
||||||
font-style: normal;
|
font-style: normal;
|
||||||
|
color: navy;
|
||||||
}
|
}
|
||||||
dd > *:first-child {
|
dd > *:first-child {
|
||||||
margin-top: 0.1em;
|
margin-top: 0.1em;
|
||||||
|
@ -226,12 +229,28 @@ dd > *:first-child {
|
||||||
ul, ol {
|
ul, ol {
|
||||||
list-style-position: outside;
|
list-style-position: outside;
|
||||||
}
|
}
|
||||||
div.olist > ol {
|
ol.arabic {
|
||||||
list-style-type: decimal;
|
list-style-type: decimal;
|
||||||
}
|
}
|
||||||
div.olist2 > ol {
|
ol.loweralpha {
|
||||||
list-style-type: lower-alpha;
|
list-style-type: lower-alpha;
|
||||||
}
|
}
|
||||||
|
ol.upperalpha {
|
||||||
|
list-style-type: upper-alpha;
|
||||||
|
}
|
||||||
|
ol.lowerroman {
|
||||||
|
list-style-type: lower-roman;
|
||||||
|
}
|
||||||
|
ol.upperroman {
|
||||||
|
list-style-type: upper-roman;
|
||||||
|
}
|
||||||
|
|
||||||
|
div.compact ul, div.compact ol,
|
||||||
|
div.compact p, div.compact p,
|
||||||
|
div.compact div, div.compact div {
|
||||||
|
margin-top: 0.1em;
|
||||||
|
margin-bottom: 0.1em;
|
||||||
|
}
|
||||||
|
|
||||||
div.tableblock > table {
|
div.tableblock > table {
|
||||||
border: 3px solid #527bbd;
|
border: 3px solid #527bbd;
|
||||||
|
@ -243,22 +262,53 @@ thead {
|
||||||
tfoot {
|
tfoot {
|
||||||
font-weight: bold;
|
font-weight: bold;
|
||||||
}
|
}
|
||||||
|
td > div.verse {
|
||||||
|
white-space: pre;
|
||||||
|
}
|
||||||
|
p.table {
|
||||||
|
margin-top: 0;
|
||||||
|
}
|
||||||
|
/* Because the table frame attribute is overriden by CSS in most browsers. */
|
||||||
|
div.tableblock > table[frame="void"] {
|
||||||
|
border-style: none;
|
||||||
|
}
|
||||||
|
div.tableblock > table[frame="hsides"] {
|
||||||
|
border-left-style: none;
|
||||||
|
border-right-style: none;
|
||||||
|
}
|
||||||
|
div.tableblock > table[frame="vsides"] {
|
||||||
|
border-top-style: none;
|
||||||
|
border-bottom-style: none;
|
||||||
|
}
|
||||||
|
|
||||||
div.hlist {
|
|
||||||
|
div.hdlist {
|
||||||
margin-top: 0.8em;
|
margin-top: 0.8em;
|
||||||
margin-bottom: 0.8em;
|
margin-bottom: 0.8em;
|
||||||
}
|
}
|
||||||
div.hlist td {
|
div.hdlist tr {
|
||||||
padding-bottom: 15px;
|
padding-bottom: 15px;
|
||||||
}
|
}
|
||||||
td.hlist1 {
|
dt.hdlist1.strong, td.hdlist1.strong {
|
||||||
|
font-weight: bold;
|
||||||
|
}
|
||||||
|
td.hdlist1 {
|
||||||
vertical-align: top;
|
vertical-align: top;
|
||||||
font-style: normal;
|
font-style: normal;
|
||||||
padding-right: 0.8em;
|
padding-right: 0.8em;
|
||||||
|
color: navy;
|
||||||
}
|
}
|
||||||
td.hlist2 {
|
td.hdlist2 {
|
||||||
vertical-align: top;
|
vertical-align: top;
|
||||||
}
|
}
|
||||||
|
div.hdlist.compact tr {
|
||||||
|
margin: 0;
|
||||||
|
padding-bottom: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.comment {
|
||||||
|
background: yellow;
|
||||||
|
}
|
||||||
|
|
||||||
@media print {
|
@media print {
|
||||||
div#footer-badges { display: none; }
|
div#footer-badges { display: none; }
|
||||||
|
@ -330,16 +380,7 @@ div.exampleblock-content {
|
||||||
|
|
||||||
/* IE6 sets dynamically generated links as visited. */
|
/* IE6 sets dynamically generated links as visited. */
|
||||||
div#toc a:visited { color: blue; }
|
div#toc a:visited { color: blue; }
|
||||||
|
|
||||||
/* Because IE6 child selector is broken. */
|
|
||||||
div.olist2 ol {
|
|
||||||
list-style-type: lower-alpha;
|
|
||||||
}
|
|
||||||
div.olist2 div.olist ol {
|
|
||||||
list-style-type: decimal;
|
|
||||||
}
|
|
||||||
</style>
|
</style>
|
||||||
<title>aria2 - The ultra fast download utility</title>
|
|
||||||
</head>
|
</head>
|
||||||
<body>
|
<body>
|
||||||
<div id="header">
|
<div id="header">
|
||||||
|
@ -349,21 +390,21 @@ div.olist2 div.olist ol {
|
||||||
</div>
|
</div>
|
||||||
<h2 id="_disclaimer">1. Disclaimer</h2>
|
<h2 id="_disclaimer">1. Disclaimer</h2>
|
||||||
<div class="sectionbody">
|
<div class="sectionbody">
|
||||||
<div class="para"><p>This program comes with no warranty.
|
<div class="paragraph"><p>This program comes with no warranty.
|
||||||
You must use this program at your own risk.</p></div>
|
You must use this program at your own risk.</p></div>
|
||||||
</div>
|
</div>
|
||||||
<h2 id="_introduction">2. Introduction</h2>
|
<h2 id="_introduction">2. Introduction</h2>
|
||||||
<div class="sectionbody">
|
<div class="sectionbody">
|
||||||
<div class="para"><p>aria2 is a utility for downloading files. The supported protocols are
|
<div class="paragraph"><p>aria2 is a utility for downloading files. The supported protocols are
|
||||||
HTTP(S), FTP, BitTorrent, and Metalink. aria2 can download a file from
|
HTTP(S), FTP, BitTorrent, and Metalink. aria2 can download a file from
|
||||||
multiple sources/protocols and tries to utilize your maximum download
|
multiple sources/protocols and tries to utilize your maximum download
|
||||||
bandwidth. It supports downloading a file from HTTP(S)/FTP and
|
bandwidth. It supports downloading a file from HTTP(S)/FTP and
|
||||||
BitTorrent at the same time, while the data downloaded from
|
BitTorrent at the same time, while the data downloaded from
|
||||||
HTTP(S)/FTP is uploaded to the BitTorrent swarm. Using Metalink's
|
HTTP(S)/FTP is uploaded to the BitTorrent swarm. Using Metalink’s
|
||||||
chunk checksums, aria2 automatically validates chunks of data while
|
chunk checksums, aria2 automatically validates chunks of data while
|
||||||
downloading a file like BitTorrent.</p></div>
|
downloading a file like BitTorrent.</p></div>
|
||||||
<div class="para"><p>Here is a list of features.</p></div>
|
<div class="paragraph"><p>Here is a list of features.</p></div>
|
||||||
<div class="ilist"><ul>
|
<div class="ulist"><ul>
|
||||||
<li>
|
<li>
|
||||||
<p>
|
<p>
|
||||||
Command-line interface
|
Command-line interface
|
||||||
|
@ -438,6 +479,11 @@ Load Cookies from file using the Firefox3 format and the Mozilla/Firefox
|
||||||
</li>
|
</li>
|
||||||
<li>
|
<li>
|
||||||
<p>
|
<p>
|
||||||
|
Save Cookies in the Mozilla/Firefox (1.x/2.x)/Netscape format.
|
||||||
|
</p>
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
<p>
|
||||||
Custom HTTP Header support
|
Custom HTTP Header support
|
||||||
</p>
|
</p>
|
||||||
</li>
|
</li>
|
||||||
|
@ -475,6 +521,11 @@ Rename/change the directory structure of BitTorrent downloads
|
||||||
</li>
|
</li>
|
||||||
<li>
|
<li>
|
||||||
<p>
|
<p>
|
||||||
|
XML-RPC interface
|
||||||
|
</p>
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
<p>
|
||||||
Run as a daemon process
|
Run as a daemon process
|
||||||
</p>
|
</p>
|
||||||
</li>
|
</li>
|
||||||
|
@ -520,83 +571,56 @@ Parameterized URI support
|
||||||
<div class="sectionbody">
|
<div class="sectionbody">
|
||||||
<div class="tableblock">
|
<div class="tableblock">
|
||||||
<table rules="all"
|
<table rules="all"
|
||||||
|
width="100%"
|
||||||
frame="border"
|
frame="border"
|
||||||
cellspacing="0" cellpadding="4">
|
cellspacing="0" cellpadding="4">
|
||||||
<caption class="title">Table: External Library Dependency</caption>
|
<caption class="title">External Library Dependency</caption>
|
||||||
<col width="240" />
|
<col width="50%" />
|
||||||
<col width="320" />
|
<col width="50%" />
|
||||||
<thead>
|
<thead>
|
||||||
<tr>
|
<tr>
|
||||||
<th align="left">
|
<th align="left" valign="top">features </th>
|
||||||
features
|
<th align="left" valign="top">dependency</th>
|
||||||
</th>
|
</tr>
|
||||||
<th align="left">
|
|
||||||
dependency
|
|
||||||
</th>
|
|
||||||
</tr>
|
|
||||||
</thead>
|
</thead>
|
||||||
<tbody valign="top">
|
<tbody>
|
||||||
<tr>
|
<tr>
|
||||||
<td align="left">
|
<td align="left" valign="top"><p class="table">HTTPS</p></td>
|
||||||
HTTPS
|
<td align="left" valign="top"><p class="table">GnuTLS or OpenSSL</p></td>
|
||||||
</td>
|
</tr>
|
||||||
<td align="left">
|
<tr>
|
||||||
GnuTLS or OpenSSL
|
<td align="left" valign="top"><p class="table">BitTorrent</p></td>
|
||||||
</td>
|
<td align="left" valign="top"><p class="table">GnuTLS+Libgcrypt or OpenSSL</p></td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr>
|
<tr>
|
||||||
<td align="left">
|
<td align="left" valign="top"><p class="table">Metalink</p></td>
|
||||||
BitTorrent
|
<td align="left" valign="top"><p class="table">libxml2 or Expat.</p></td>
|
||||||
</td>
|
</tr>
|
||||||
<td align="left">
|
<tr>
|
||||||
GnuTLS+Libgcrypt or OpenSSL
|
<td align="left" valign="top"><p class="table">Checksum</p></td>
|
||||||
</td>
|
<td align="left" valign="top"><p class="table">GnuTLS+Libgcrypt or OpenSSL</p></td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr>
|
<tr>
|
||||||
<td align="left">
|
<td align="left" valign="top"><p class="table">gzip, deflate in HTTP</p></td>
|
||||||
Metalink
|
<td align="left" valign="top"><p class="table">zlib</p></td>
|
||||||
</td>
|
</tr>
|
||||||
<td align="left">
|
<tr>
|
||||||
libxml2 or Expat.
|
<td align="left" valign="top"><p class="table">Async DNS</p></td>
|
||||||
</td>
|
<td align="left" valign="top"><p class="table">C-Ares</p></td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr>
|
<tr>
|
||||||
<td align="left">
|
<td align="left" valign="top"><p class="table">Firefox3 cookie</p></td>
|
||||||
Checksum
|
<td align="left" valign="top"><p class="table">libsqlite3</p></td>
|
||||||
</td>
|
</tr>
|
||||||
<td align="left">
|
<tr>
|
||||||
GnuTLS+Libgcrypt or OpenSSL
|
<td align="left" valign="top"><p class="table">XML-RPC</p></td>
|
||||||
</td>
|
<td align="left" valign="top"><p class="table">libxml2 or Expat.</p></td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr>
|
|
||||||
<td align="left">
|
|
||||||
gzip, deflate in HTTP
|
|
||||||
</td>
|
|
||||||
<td align="left">
|
|
||||||
zlib
|
|
||||||
</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td align="left">
|
|
||||||
Async DNS
|
|
||||||
</td>
|
|
||||||
<td align="left">
|
|
||||||
C-Ares
|
|
||||||
</td>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td align="left">
|
|
||||||
Firefox3 cookie
|
|
||||||
</td>
|
|
||||||
<td align="left">
|
|
||||||
libsqlite3
|
|
||||||
</td>
|
|
||||||
</tr>
|
|
||||||
</tbody>
|
</tbody>
|
||||||
</table>
|
</table>
|
||||||
</div>
|
</div>
|
||||||
<div class="vlist"><dl>
|
<div class="dlist"><dl>
|
||||||
<dt>
|
<dt class="hdlist1">
|
||||||
Note
|
Note
|
||||||
</dt>
|
</dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
@ -605,7 +629,7 @@ Note
|
||||||
If you prefer OpenSSL, run configure with --without-gnutls.
|
If you prefer OpenSSL, run configure with --without-gnutls.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt>
|
<dt class="hdlist1">
|
||||||
Note
|
Note
|
||||||
</dt>
|
</dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
@ -615,11 +639,11 @@ Note
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
</dl></div>
|
</dl></div>
|
||||||
<div class="para"><p>You can disable BitTorrent, Metalink support by providing
|
<div class="paragraph"><p>You can disable BitTorrent, Metalink support by providing
|
||||||
--disable-bittorrent, --disable-metalink respectively to configure
|
--disable-bittorrent, --disable-metalink respectively to configure
|
||||||
script.</p></div>
|
script.</p></div>
|
||||||
<div class="para"><p>In order to enable async DNS support, you need c-ares.</p></div>
|
<div class="paragraph"><p>In order to enable async DNS support, you need c-ares.</p></div>
|
||||||
<div class="ilist"><ul>
|
<div class="ulist"><ul>
|
||||||
<li>
|
<li>
|
||||||
<p>
|
<p>
|
||||||
c-ares: <a href="http://daniel.haxx.se/projects/c-ares/">http://daniel.haxx.se/projects/c-ares/</a>
|
c-ares: <a href="http://daniel.haxx.se/projects/c-ares/">http://daniel.haxx.se/projects/c-ares/</a>
|
||||||
|
@ -629,10 +653,10 @@ c-ares: <a href="http://daniel.haxx.se/projects/c-ares/">http://daniel.haxx.se/p
|
||||||
</div>
|
</div>
|
||||||
<h2 id="_how_to_build">4. How to build</h2>
|
<h2 id="_how_to_build">4. How to build</h2>
|
||||||
<div class="sectionbody">
|
<div class="sectionbody">
|
||||||
<div class="para"><p>In order to build aria2 from the source package, you need following
|
<div class="paragraph"><p>In order to build aria2 from the source package, you need following
|
||||||
development packages(package name may vary depending on the
|
development packages(package name may vary depending on the
|
||||||
distribution you use):</p></div>
|
distribution you use):</p></div>
|
||||||
<div class="ilist"><ul>
|
<div class="ulist"><ul>
|
||||||
<li>
|
<li>
|
||||||
<p>
|
<p>
|
||||||
libgnutls-dev (Required for HTTPS, BitTorrent, Checksum support)
|
libgnutls-dev (Required for HTTPS, BitTorrent, Checksum support)
|
||||||
|
@ -669,32 +693,32 @@ libsqlite3-dev (Required for Firefox3 cookie support)
|
||||||
</p>
|
</p>
|
||||||
</li>
|
</li>
|
||||||
</ul></div>
|
</ul></div>
|
||||||
<div class="para"><p>You can use libssl-dev instead of
|
<div class="paragraph"><p>You can use libssl-dev instead of
|
||||||
libgnutls-dev,libgpg-error-dev,libgcrypt-dev:</p></div>
|
libgnutls-dev,libgpg-error-dev,libgcrypt-dev:</p></div>
|
||||||
<div class="ilist"><ul>
|
<div class="ulist"><ul>
|
||||||
<li>
|
<li>
|
||||||
<p>
|
<p>
|
||||||
libssl-dev (Required for HTTPS, BitTorrent, Checksum support)
|
libssl-dev (Required for HTTPS, BitTorrent, Checksum support)
|
||||||
</p>
|
</p>
|
||||||
</li>
|
</li>
|
||||||
</ul></div>
|
</ul></div>
|
||||||
<div class="para"><p>You can use libexpat1-dev instead of libxml2-dev:</p></div>
|
<div class="paragraph"><p>You can use libexpat1-dev instead of libxml2-dev:</p></div>
|
||||||
<div class="ilist"><ul>
|
<div class="ulist"><ul>
|
||||||
<li>
|
<li>
|
||||||
<p>
|
<p>
|
||||||
libexpat1-dev (Required for Metalink support)
|
libexpat1-dev (Required for Metalink support)
|
||||||
</p>
|
</p>
|
||||||
</li>
|
</li>
|
||||||
</ul></div>
|
</ul></div>
|
||||||
<div class="para"><p>The quickest way to build aria2 is just type following commands:</p></div>
|
<div class="paragraph"><p>The quickest way to build aria2 is just type following commands:</p></div>
|
||||||
<div class="listingblock">
|
<div class="listingblock">
|
||||||
<div class="content">
|
<div class="content">
|
||||||
<pre><tt>$ ./configure
|
<pre><tt>$ ./configure
|
||||||
$ make</tt></pre>
|
$ make</tt></pre>
|
||||||
</div></div>
|
</div></div>
|
||||||
<div class="para"><p>The configure script checks available libraries and enables the features
|
<div class="paragraph"><p>The configure script checks available libraries and enables the features
|
||||||
as much as possible because all the features are enabled by default.</p></div>
|
as much as possible because all the features are enabled by default.</p></div>
|
||||||
<div class="para"><p>Since 1.1.0, aria2 checks the certificate of HTTPS servers by default.
|
<div class="paragraph"><p>Since 1.1.0, aria2 checks the certificate of HTTPS servers by default.
|
||||||
If you build with HTTPS support, I recommend to supply the path to the
|
If you build with HTTPS support, I recommend to supply the path to the
|
||||||
CA bundle file. For example, in Debian the path to CA bundle file is
|
CA bundle file. For example, in Debian the path to CA bundle file is
|
||||||
<em>/etc/ssl/certs/ca-certificates.crt</em> (in ca-certificates package). This
|
<em>/etc/ssl/certs/ca-certificates.crt</em> (in ca-certificates package). This
|
||||||
|
@ -705,14 +729,14 @@ configure script using --with-ca-bundle option:</p></div>
|
||||||
<pre><tt>$ ./configure --with-ca-bundle='/etc/ssl/certs/ca-certificates.crt'
|
<pre><tt>$ ./configure --with-ca-bundle='/etc/ssl/certs/ca-certificates.crt'
|
||||||
$ make</tt></pre>
|
$ make</tt></pre>
|
||||||
</div></div>
|
</div></div>
|
||||||
<div class="para"><p>Without --with-ca-bundle option, you will encounter the error when
|
<div class="paragraph"><p>Without --with-ca-bundle option, you will encounter the error when
|
||||||
accessing HTTPS servers because the certificate cannot be verified
|
accessing HTTPS servers because the certificate cannot be verified
|
||||||
without CA bundle. In such case, you can specify the CA bundle file
|
without CA bundle. In such case, you can specify the CA bundle file
|
||||||
using aria2's --ca-certificate option. If you don't have CA bundle
|
using aria2’s --ca-certificate option. If you don’t have CA bundle
|
||||||
file installed, then the last resort is disable the certificate
|
file installed, then the last resort is disable the certificate
|
||||||
validation using --check-certificate=false.</p></div>
|
validation using --check-certificate=false.</p></div>
|
||||||
<div class="para"><p>The executable is <em>aria2c</em> in src directory.</p></div>
|
<div class="paragraph"><p>The executable is <em>aria2c</em> in src directory.</p></div>
|
||||||
<div class="para"><p>aria2 uses CppUnit for automated unit testing. To run the unit test:</p></div>
|
<div class="paragraph"><p>aria2 uses CppUnit for automated unit testing. To run the unit test:</p></div>
|
||||||
<div class="listingblock">
|
<div class="listingblock">
|
||||||
<div class="content">
|
<div class="content">
|
||||||
<pre><tt>$ make check</tt></pre>
|
<pre><tt>$ make check</tt></pre>
|
||||||
|
@ -721,9 +745,9 @@ validation using --check-certificate=false.</p></div>
|
||||||
<h2 id="_bittorrrent">5. BitTorrrent</h2>
|
<h2 id="_bittorrrent">5. BitTorrrent</h2>
|
||||||
<div class="sectionbody">
|
<div class="sectionbody">
|
||||||
<h3 id="_about_filename">5.1. About filename</h3><div style="clear:left"></div>
|
<h3 id="_about_filename">5.1. About filename</h3><div style="clear:left"></div>
|
||||||
<div class="para"><p>The filename of the downloaded file is determined as follows:</p></div>
|
<div class="paragraph"><p>The filename of the downloaded file is determined as follows:</p></div>
|
||||||
<div class="vlist"><dl>
|
<div class="dlist"><dl>
|
||||||
<dt>
|
<dt class="hdlist1">
|
||||||
single-file mode
|
single-file mode
|
||||||
</dt>
|
</dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
@ -736,7 +760,7 @@ single-file mode
|
||||||
option.
|
option.
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt>
|
<dt class="hdlist1">
|
||||||
multi-file mode
|
multi-file mode
|
||||||
</dt>
|
</dt>
|
||||||
<dd>
|
<dd>
|
||||||
|
@ -747,16 +771,16 @@ multi-file mode
|
||||||
</p>
|
</p>
|
||||||
</dd>
|
</dd>
|
||||||
</dl></div>
|
</dl></div>
|
||||||
<div class="para"><p>Before download starts, a complete directory structure is created if
|
<div class="paragraph"><p>Before download starts, a complete directory structure is created if
|
||||||
needed. By default, aria2 opens at most 100 files mentioned in
|
needed. By default, aria2 opens at most 100 files mentioned in
|
||||||
.torrent file, and directly writes to and reads from these files.
|
.torrent file, and directly writes to and reads from these files.
|
||||||
The number of files to open simultaneously can be controlled by
|
The number of files to open simultaneously can be controlled by
|
||||||
--bt-max-open-files option.</p></div>
|
--bt-max-open-files option.</p></div>
|
||||||
<h3 id="_dht">5.2. DHT</h3><div style="clear:left"></div>
|
<h3 id="_dht">5.2. DHT</h3><div style="clear:left"></div>
|
||||||
<div class="para"><p>As of release 0.13.0, aria2 supports DHT. By default, the routing
|
<div class="paragraph"><p>As of release 0.13.0, aria2 supports DHT. By default, the routing
|
||||||
table is saved to $HOME/.aria2/dht.dat.</p></div>
|
table is saved to $HOME/.aria2/dht.dat.</p></div>
|
||||||
<h3 id="_other_things_should_be_noted">5.3. Other things should be noted</h3><div style="clear:left"></div>
|
<h3 id="_other_things_should_be_noted">5.3. Other things should be noted</h3><div style="clear:left"></div>
|
||||||
<div class="ilist"><ul>
|
<div class="ulist"><ul>
|
||||||
<li>
|
<li>
|
||||||
<p>
|
<p>
|
||||||
-o option is used to change the filename of .torrent file itself,
|
-o option is used to change the filename of .torrent file itself,
|
||||||
|
@ -771,7 +795,7 @@ The port numbers that aria2 uses by default are 6881-6999 for TCP
|
||||||
</li>
|
</li>
|
||||||
<li>
|
<li>
|
||||||
<p>
|
<p>
|
||||||
aria2 doesn't configure port-forwarding automatically. Please
|
aria2 doesn’t configure port-forwarding automatically. Please
|
||||||
configure your router or firewall manually.
|
configure your router or firewall manually.
|
||||||
</p>
|
</p>
|
||||||
</li>
|
</li>
|
||||||
|
@ -792,31 +816,31 @@ As of release 0.10.0, aria2 stops sending request message after
|
||||||
</div>
|
</div>
|
||||||
<h2 id="_metalink">6. Metalink</h2>
|
<h2 id="_metalink">6. Metalink</h2>
|
||||||
<div class="sectionbody">
|
<div class="sectionbody">
|
||||||
<div class="para"><p>The current implementation supports HTTP(S)/FTP/BitTorrent. The other
|
<div class="paragraph"><p>The current implementation supports HTTP(S)/FTP/BitTorrent. The other
|
||||||
P2P protocols are ignored.</p></div>
|
P2P protocols are ignored.</p></div>
|
||||||
<div class="para"><p>For checksum verification, MD5, SHA1, and SHA256 are supported. If
|
<div class="paragraph"><p>For checksum verification, MD5, SHA1, and SHA256 are supported. If
|
||||||
multiple hash algorithms are provided, aria2 uses SHA1. If whole file
|
multiple hash algorithms are provided, aria2 uses SHA1. If whole file
|
||||||
checksum verification fails, aria2 doesn't retry the download and just
|
checksum verification fails, aria2 doesn’t retry the download and just
|
||||||
exits with non-zero return code.</p></div>
|
exits with non-zero return code.</p></div>
|
||||||
<div class="para"><p>The supported user preferences are version, language, location,
|
<div class="paragraph"><p>The supported user preferences are version, language, location,
|
||||||
protocol and os.</p></div>
|
protocol and os.</p></div>
|
||||||
<div class="para"><p>If chunk checksums are provided in Metalink file, aria2 automatically
|
<div class="paragraph"><p>If chunk checksums are provided in Metalink file, aria2 automatically
|
||||||
validates chunks of data during download. This behavior can be turned
|
validates chunks of data during download. This behavior can be turned
|
||||||
off by a command-line option.</p></div>
|
off by a command-line option.</p></div>
|
||||||
<div class="para"><p>If signature is included in a Metalink file, aria2 saves it as a file
|
<div class="paragraph"><p>If signature is included in a Metalink file, aria2 saves it as a file
|
||||||
after the completion of the download. The filename is download
|
after the completion of the download. The filename is download
|
||||||
filename + ".sig". If same file already exists, the signature file is
|
filename + ".sig". If same file already exists, the signature file is
|
||||||
not saved.</p></div>
|
not saved.</p></div>
|
||||||
</div>
|
</div>
|
||||||
<h2 id="_netrc">7. netrc</h2>
|
<h2 id="_netrc">7. netrc</h2>
|
||||||
<div class="sectionbody">
|
<div class="sectionbody">
|
||||||
<div class="para"><p>netrc support is enabled by default for HTTP(S)/FTP. To disable netrc
|
<div class="paragraph"><p>netrc support is enabled by default for HTTP(S)/FTP. To disable netrc
|
||||||
support, specify -n command-line option. Your .netrc file should have
|
support, specify -n command-line option. Your .netrc file should have
|
||||||
correct permissions(600).</p></div>
|
correct permissions(600).</p></div>
|
||||||
</div>
|
</div>
|
||||||
<h2 id="_references">8. References</h2>
|
<h2 id="_references">8. References</h2>
|
||||||
<div class="sectionbody">
|
<div class="sectionbody">
|
||||||
<div class="ilist"><ul>
|
<div class="ulist"><ul>
|
||||||
<li>
|
<li>
|
||||||
<p>
|
<p>
|
||||||
man aria2c
|
man aria2c
|
||||||
|
@ -836,7 +860,7 @@ man aria2c
|
||||||
</div>
|
</div>
|
||||||
<div id="footer">
|
<div id="footer">
|
||||||
<div id="footer-text">
|
<div id="footer-text">
|
||||||
Last updated 2009-04-28 22:20:49 JST
|
Last updated 2009-05-27 00:49:50 JST
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</body>
|
</body>
|
||||||
|
|
Loading…
Reference in New Issue