2010-07-09 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>

Documented that aria2 supports Chromium/Google Chrom cookies file.
	* doc/aria2c.1.txt
	* README
pull/1/head
Tatsuhiro Tsujikawa 2010-07-08 16:51:49 +00:00
parent 52a6ea008e
commit be423e2c77
6 changed files with 47 additions and 34 deletions

View File

@ -1,3 +1,9 @@
2010-07-09 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>
Documented that aria2 supports Chromium/Google Chrom cookies file.
* doc/aria2c.1.txt
* README
2010-07-09 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net> 2010-07-09 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>
Fixed the bug that aria2 cannot handle %2F in FTP URI properly. Fixed the bug that aria2 cannot handle %2F in FTP URI properly.

27
README
View File

@ -36,7 +36,8 @@ Here is a list of features.
* Verify peer using given trusted CA certificate in HTTPS * Verify peer using given trusted CA certificate in HTTPS
* Client certificate authentication in HTTPS * Client certificate authentication in HTTPS
* 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, Chromium/Google Chrome
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. * Save Cookies in the Mozilla/Firefox (1.x/2.x)/Netscape format.
* Custom HTTP Header support * Custom HTTP Header support
@ -66,17 +67,17 @@ Dependency
.External Library Dependency .External Library Dependency
[options="header"] [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/Chromium cookie|libsqlite3
|XML-RPC |libxml2 or Expat. |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.
@ -106,7 +107,7 @@ distribution you use):
* libc-ares-dev (Required for async DNS support) * libc-ares-dev (Required for async DNS support)
* libxml2-dev (Required for Metalink support) * libxml2-dev (Required for Metalink support)
* zlib1g-dev (Required for gzip, deflate decoding support in HTTP) * zlib1g-dev (Required for gzip, deflate decoding support in HTTP)
* libsqlite3-dev (Required for Firefox3 cookie support) * libsqlite3-dev (Required for Firefox3/Chromium cookie support)
You can use libssl-dev instead of You can use libssl-dev instead of
libgnutls-dev,libgpg-error-dev,libgcrypt-dev: libgnutls-dev,libgpg-error-dev,libgcrypt-dev:

View File

@ -646,7 +646,8 @@ Chunked transfer encoding support
</li> </li>
<li> <li>
<p> <p>
Load Cookies from file using the Firefox3 format and the Mozilla/Firefox Load Cookies from file using the Firefox3 format, Chromium/Google Chrome
and the Mozilla/Firefox
(1.x/2.x)/Netscape format. (1.x/2.x)/Netscape format.
</p> </p>
</li> </li>
@ -758,7 +759,7 @@ cellspacing="0" cellpadding="4">
<col width="50%" /> <col width="50%" />
<thead> <thead>
<tr> <tr>
<th align="left" valign="top">features </th> <th align="left" valign="top">features </th>
<th align="left" valign="top">dependency</th> <th align="left" valign="top">dependency</th>
</tr> </tr>
</thead> </thead>
@ -788,7 +789,7 @@ cellspacing="0" cellpadding="4">
<td align="left" valign="top"><p class="table">C-Ares</p></td> <td align="left" valign="top"><p class="table">C-Ares</p></td>
</tr> </tr>
<tr> <tr>
<td align="left" valign="top"><p class="table">Firefox3 cookie</p></td> <td align="left" valign="top"><p class="table">Firefox3/Chromium cookie</p></td>
<td align="left" valign="top"><p class="table">libsqlite3</p></td> <td align="left" valign="top"><p class="table">libsqlite3</p></td>
</tr> </tr>
<tr> <tr>
@ -868,7 +869,7 @@ zlib1g-dev (Required for gzip, deflate decoding support in HTTP)
</li> </li>
<li> <li>
<p> <p>
libsqlite3-dev (Required for Firefox3 cookie support) libsqlite3-dev (Required for Firefox3/Chromium cookie support)
</p> </p>
</li> </li>
</ul></div> </ul></div>
@ -1056,7 +1057,7 @@ man aria2c
<div id="footnotes"><hr /></div> <div id="footnotes"><hr /></div>
<div id="footer"> <div id="footer">
<div id="footer-text"> <div id="footer-text">
Last updated 2010-06-02 21:11:14 JST Last updated 2010-07-09 01:48:09 JST
</div> </div>
</div> </div>
</body> </body>

View File

@ -2,12 +2,12 @@
.\" Title: aria2c .\" Title: aria2c
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 06/28/2010 .\" Date: 07/09/2010
.\" Manual: Aria2 Manual .\" Manual: Aria2 Manual
.\" Source: Aria2 1.9.4 .\" Source: Aria2 1.9.5
.\" Language: English .\" Language: English
.\" .\"
.TH "ARIA2C" "1" "06/28/2010" "Aria2 1\&.9\&.4" "Aria2 Manual" .TH "ARIA2C" "1" "07/09/2010" "Aria2 1\&.9\&.5" "Aria2 Manual"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * Define some portability stuff .\" * Define some portability stuff
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
@ -480,7 +480,7 @@ Append HEADER to HTTP request header\&. You can use this option repeatedly to sp
.PP .PP
\fB\-\-load\-cookies\fR=FILE \fB\-\-load\-cookies\fR=FILE
.RS 4 .RS 4
Load Cookies from FILE using the Firefox3 format (SQLite3) and the Mozilla/Firefox(1\&.x/2\&.x)/Netscape format\&. Load Cookies from FILE using the Firefox3 format (SQLite3), Chromium/Google Chrome (SQLite3) and the Mozilla/Firefox(1\&.x/2\&.x)/Netscape format\&.
.RE .RE
.if n \{\ .if n \{\
.sp .sp
@ -495,7 +495,7 @@ Load Cookies from FILE using the Firefox3 format (SQLite3) and the Mozilla/Firef
.ps -1 .ps -1
.br .br
.sp .sp
If aria2 is built without libsqlite3, then it doesn\(cqt support Firefox3 cookie format\&. If aria2 is built without libsqlite3, then it doesn\(cqt support Firefox3 and Chromium/Google Chrome cookie format\&.
.sp .5v .sp .5v
.RE .RE
.PP .PP
@ -2623,7 +2623,7 @@ GID(or gid) is the key to manage each download\&. Each download has an unique GI
.sp .sp
\fBaria2\&.addUri\fR \fIuris[, options[, position]]\fR \fBaria2\&.addUri\fR \fIuris[, options[, position]]\fR
.sp .sp
This method adds new HTTP(S)/FTP/BitTorrent Magnet URI\&. \fIuris\fR is of type array and its element is URI which is of type string\&. For BitTorrent Magnet URI, \fIuris\fR must have only one element and it should be BitTorrent Magnet URI\&. URIs in \fIuris\fR must point to the same file\&. For example, a file \fIchunkybaconlinux\&.iso\fR is hosted in 2 locations: http://server/chunkybaconlinux\&.iso and http://mirror/chunkybaconlinux\&.iso\&. You can download this iso image using 2 URIs issuing aria2\&.addUri([\fIhttp://server/chunkybaconlinux\&.iso\fR, \fIhttp://mirror/chunkybaconlinux\&.iso\fR])\&. Imagine there is an another file URI, say, http://mirror2/chunkydonutslinux\&.iso, which is different iso image\&. You cannot mix this URI with previous URIs in one aria2\&.addUri command\&. If you do, aria2 does not complain but download may fail\&. \fIoptions\fR is of type struct and its members are a pair of option name and value\&. See \fBOptions\fR below for more details\&. If \fIposition\fR is given as an integer starting from 0, the new download is inserted at \fIposition\fR in the waiting queue\&. If \fIposition\fR is not given or \fIposition\fR is larger than the size of the queue, it is appended at the end of the queue\&. This method returns GID of registered download\&. This method adds new HTTP(S)/FTP/BitTorrent Magnet URI\&. \fIuris\fR is of type array and its element is URI which is of type string\&. For BitTorrent Magnet URI, \fIuris\fR must have only one element and it should be BitTorrent Magnet URI\&. URIs in \fIuris\fR must point to the same file\&. For example, a file chunkybaconlinux\&.iso is hosted in 2 locations: http://server/chunkybaconlinux\&.iso and http://mirror/chunkybaconlinux\&.iso\&. You can download this iso image using 2 URIs by issuing aria2\&.addUri([\fIhttp://server/chunkybaconlinux\&.iso\fR, \fIhttp://mirror/chunkybaconlinux\&.iso\fR])\&. Imagine there is an another file URI, say, http://mirror2/chunkydonutslinux\&.iso, which is different iso image\&. You cannot mix this URI with previous URIs in one aria2\&.addUri command\&. If you do, aria2 does not complain but download may fail\&. \fIoptions\fR is of type struct and its members are a pair of option name and value\&. See \fBOptions\fR below for more details\&. If \fIposition\fR is given as an integer starting from 0, the new download is inserted at \fIposition\fR in the waiting queue\&. If \fIposition\fR is not given or \fIposition\fR is larger than the size of the queue, it is appended at the end of the queue\&. This method returns GID of registered download\&.
.sp .sp
\fBaria2\&.addTorrent\fR \fItorrent[, uris[, options[, position]]]\fR \fBaria2\&.addTorrent\fR \fItorrent[, uris[, options[, position]]]\fR
.sp .sp
@ -3879,7 +3879,7 @@ aria2c \-\-load\-cookies=cookies\&.txt "http://host/file\&.zip"
.ps -1 .ps -1
.br .br
.sp .sp
You can use Firefox/Mozilla\(cqs cookie file without modification\&. You can use Firefox/Mozilla/Chromium\(cqs cookie file without modification\&.
.sp .5v .sp .5v
.RE .RE
.RE .RE

View File

@ -1143,7 +1143,8 @@ response header.</td>
</dt> </dt>
<dd> <dd>
<p> <p>
Load Cookies from FILE using the Firefox3 format (SQLite3) and the Load Cookies from FILE using the Firefox3 format (SQLite3),
Chromium/Google Chrome (SQLite3) and the
Mozilla/Firefox(1.x/2.x)/Netscape format. Mozilla/Firefox(1.x/2.x)/Netscape format.
</p> </p>
</dd> </dd>
@ -1153,7 +1154,8 @@ response header.</td>
<td class="icon"> <td class="icon">
<div class="title">Note</div> <div class="title">Note</div>
</td> </td>
<td class="content">If aria2 is built without libsqlite3, then it doesn&#8217;t support Firefox3 cookie format.</td> <td class="content">If aria2 is built without libsqlite3, then it doesn&#8217;t support Firefox3
and Chromium/Google Chrome cookie format.</td>
</tr></table> </tr></table>
</div> </div>
<div class="dlist"><dl> <div class="dlist"><dl>
@ -3065,10 +3067,10 @@ GID
type array and its element is URI which is of type string. For type array and its element is URI which is of type string. For
BitTorrent Magnet URI, <em>uris</em> must have only one element and it should BitTorrent Magnet URI, <em>uris</em> must have only one element and it should
be BitTorrent Magnet URI. URIs in <em>uris</em> must point to the same be BitTorrent Magnet URI. URIs in <em>uris</em> must point to the same
file. For example, a file <em>chunkybaconlinux.iso</em> is hosted in 2 file. For example, a file chunkybaconlinux.iso is hosted in 2
locations: <a href="http://server/chunkybaconlinux.iso">http://server/chunkybaconlinux.iso</a> and locations: <a href="http://server/chunkybaconlinux.iso">http://server/chunkybaconlinux.iso</a> and
<a href="http://mirror/chunkybaconlinux.iso">http://mirror/chunkybaconlinux.iso</a>. You can download this iso image <a href="http://mirror/chunkybaconlinux.iso">http://mirror/chunkybaconlinux.iso</a>. You can download this iso image
using 2 URIs issuing using 2 URIs by issuing
aria2.addUri([<em>http://server/chunkybaconlinux.iso</em>, aria2.addUri([<em>http://server/chunkybaconlinux.iso</em>,
<em>http://mirror/chunkybaconlinux.iso</em>]). Imagine there is an another <em>http://mirror/chunkybaconlinux.iso</em>]). Imagine there is an another
file URI, say, <a href="http://mirror2/chunkydonutslinux.iso">http://mirror2/chunkydonutslinux.iso</a>, which is file URI, say, <a href="http://mirror2/chunkydonutslinux.iso">http://mirror2/chunkydonutslinux.iso</a>, which is
@ -4086,7 +4088,7 @@ forwarding, it&#8217;s up to you to do it manually.</td>
<td class="icon"> <td class="icon">
<div class="title">Note</div> <div class="title">Note</div>
</td> </td>
<td class="content">You can use Firefox/Mozilla&#8217;s cookie file without modification.</td> <td class="content">You can use Firefox/Mozilla/Chromium&#8217;s cookie file without modification.</td>
</tr></table> </tr></table>
</div> </div>
<h4 id="_resume_download_started_by_web_browsers_or_another_programs">Resume download started by web browsers or another programs</h4> <h4 id="_resume_download_started_by_web_browsers_or_another_programs">Resume download started by web browsers or another programs</h4>
@ -4212,7 +4214,7 @@ files in the program, then also delete it here.</p></div>
<div id="footnotes"><hr /></div> <div id="footnotes"><hr /></div>
<div id="footer"> <div id="footer">
<div id="footer-text"> <div id="footer-text">
Last updated 2010-06-28 21:00:35 JST Last updated 2010-07-09 01:48:36 JST
</div> </div>
</div> </div>
</body> </body>

View File

@ -327,11 +327,14 @@ response 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*=FILE::
Load Cookies from FILE using the Firefox3 format (SQLite3) and the
Load Cookies from FILE using the Firefox3 format (SQLite3),
Chromium/Google Chrome (SQLite3) and the
Mozilla/Firefox(1.x/2.x)/Netscape format. Mozilla/Firefox(1.x/2.x)/Netscape format.
[NOTE] [NOTE]
If aria2 is built without libsqlite3, then it doesn't support Firefox3 cookie format. If aria2 is built without libsqlite3, then it doesn't support Firefox3
and Chromium/Google Chrome cookie format.
*--save-cookies*=FILE:: *--save-cookies*=FILE::
@ -2146,7 +2149,7 @@ Load cookies
aria2c --load-cookies=cookies.txt "http://host/file.zip" aria2c --load-cookies=cookies.txt "http://host/file.zip"
-------------------------------------------------------- --------------------------------------------------------
[NOTE] [NOTE]
You can use Firefox/Mozilla's cookie file without modification. You can use Firefox/Mozilla/Chromium's cookie file without modification.
Resume download started by web browsers or another programs Resume download started by web browsers or another programs
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^