|
|
@@ -2,12 +2,21 @@
|
|
|
.\" Title: aria2c
|
|
|
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
|
|
|
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
|
|
|
-.\" Date: 12/11/2009
|
|
|
+.\" Date: 12/20/2009
|
|
|
.\" Manual: Aria2 Manual
|
|
|
.\" Source: Aria2
|
|
|
.\" Language: English
|
|
|
.\"
|
|
|
-.TH "ARIA2C" "1" "12/11/2009" "Aria2" "Aria2 Manual"
|
|
|
+.TH "ARIA2C" "1" "12/20/2009" "Aria2" "Aria2 Manual"
|
|
|
+.\" -----------------------------------------------------------------
|
|
|
+.\" * Define some portability stuff
|
|
|
+.\" -----------------------------------------------------------------
|
|
|
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
+.\" http://bugs.debian.org/507673
|
|
|
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
|
|
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
+.ie \n(.g .ds Aq \(aq
|
|
|
+.el .ds Aq '
|
|
|
.\" -----------------------------------------------------------------
|
|
|
.\" * set default formatting
|
|
|
.\" -----------------------------------------------------------------
|
|
|
@@ -1109,7 +1118,7 @@ The options that have its argument surrounded by square brackets([]) take an opt
|
|
|
.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\&.
|
|
|
.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" paramters are supported\&. Because BitTorrent Magnet URI is likely to contain "&" character, it is highly recommended to always quote URI with single(\') 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\&.
|
|
|
+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" paramters 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\&.
|
|
|
.sp
|
|
|
@@ -1127,7 +1136,7 @@ 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(\') or double(") quotation if it contains "&" or any characters that have special meaning in shell\&.
|
|
|
+Make sure that URL 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"
|
|
|
@@ -2199,6 +2208,18 @@ errorCode
|
|
|
.RS 4
|
|
|
The last error code occurred in this download\&. The value is of type string\&. The error codes are defined in EXIT STATUS section\&. This value is only available for stopped/completed downloads\&.
|
|
|
.RE
|
|
|
+.PP
|
|
|
+followedBy
|
|
|
+.RS 4
|
|
|
+List of GIDs which are generated by the consequence of this download\&. For example, when aria2 downloaded Metalink file, it generates downloads described in it(see
|
|
|
+\fB\-\-follow\-metalink\fR
|
|
|
+option)\&. This value is useful to track these auto generated downloads\&. If there is no such downloads, this key will not be included in the response\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+belongsTo
|
|
|
+.RS 4
|
|
|
+GID of a parent download\&. Some downloads are a part of another download\&. For example, if a file in Metalink has BitTorrent resource, the download of \&.torrent is a part of that file\&. If this download has no parent, this key will not be included in the response\&.
|
|
|
+.RE
|
|
|
.sp
|
|
|
\fBaria2\&.getUris\fR \fIgid\fR
|
|
|
.sp
|
|
|
@@ -2380,8 +2401,8 @@ The following Ruby script adds \fIhttp://localhost/aria2\&.tar\&.bz2\fR to aria2
|
|
|
.nf
|
|
|
#!/usr/bin/env ruby
|
|
|
|
|
|
-require \'xmlrpc/client\'
|
|
|
-require \'pp\'
|
|
|
+require \*(Aqxmlrpc/client\*(Aq
|
|
|
+require \*(Aqpp\*(Aq
|
|
|
|
|
|
client=XMLRPC::Client\&.new2("http://localhost:6800/rpc")
|
|
|
|
|
|
@@ -2852,7 +2873,7 @@ aria2c "magnet:?xt=urn:btih:248d0a1cd08284299de78d5c1ed359bb46717d8c&dn=aria2"
|
|
|
.ps -1
|
|
|
.br
|
|
|
.sp
|
|
|
-Don\(cqt forget to quote BitTorrent Magnet URI which includes "&" character with single(\') or double(") quotation\&.
|
|
|
+Don\(cqt forget to quote BitTorrent Magnet URI which includes "&" character with single(\*(Aq) or double(") quotation\&.
|
|
|
.sp .5v
|
|
|
.RE
|
|
|
.RE
|
Tatsuhiro Tsujikawa