github
/
aria2
mirror of https://github.com/aria2/aria2
1
0
Fork 0
Code Issues Releases Wiki Activity

2010-10-30 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net> 

Added cross reference in XML-RPC method section. Also added cross
	reference for remaining -i list options.
	* doc/aria2c.1.txt
pull/1/head
Tatsuhiro Tsujikawa 2010-10-30 12:24:55 +00:00
parent 55273729f2
commit b67f6dc126
3 changed files with 139 additions and 95 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
ChangeLog
View File

@ -1,3 +1,9 @@
2010-10-30 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>
Added cross reference in XML-RPC method section. Also added cross
reference for remaining -i list options.
* doc/aria2c.1.txt
2010-10-30 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net> 2010-10-30 Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>
Updated doc Updated doc

131
doc/aria2c.1.html
View File

@ -619,7 +619,8 @@ downloading a file like BitTorrent.</p></div>
Downloads URIs found in FILE. You can specify multiple URIs for a single Downloads URIs found in FILE. You can specify multiple URIs for a single
entity: separate URIs on a single line using the TAB character. entity: separate URIs on a single line using the TAB character.
Reads input from stdin when <em>-</em> is specified. Reads input from stdin when <em>-</em> is specified.
The additional <strong>out</strong> and <strong>dir</strong> options can be specified after each line of The additional <strong><a href="#aria2_optref_out">out</a></strong> and <strong><a href="#aria2_optref_dir">dir</a></strong>
options can be specified after each line of
URIs. This optional line must start with white space(s). URIs. This optional line must start with white space(s).
See <strong><a href="#_input_file">Input File</a></strong> subsection for details. See <strong><a href="#_input_file">Input File</a></strong> subsection for details.
</p> </p>
@ -3158,7 +3159,8 @@ http://foo/bar</tt></pre>
<em>file.iso</em> is saved as <em>/iso_images/file.img</em> and it is downloaded <em>file.iso</em> is saved as <em>/iso_images/file.img</em> and it is downloaded
from http://server/file.iso and http://mirror/file.iso. The file from http://server/file.iso and http://mirror/file.iso. The file
<em>bar</em> is downloaded from http://foo/bar and saved as <em>/tmp/bar</em>.</p></div> <em>bar</em> is downloaded from http://foo/bar and saved as <em>/tmp/bar</em>.</p></div>
<div class="paragraph"><p>In some cases, <strong>out</strong> parameter has no effect. See note of <strong><a href="#aria2_optref_out">--out</a></strong> <div class="paragraph"><p>In some cases, <strong><a href="#aria2_optref_out">out</a></strong> parameter has no effect.
See note of <strong><a href="#aria2_optref_out">--out</a></strong>
option for the restrictions.</p></div> option for the restrictions.</p></div>
<h3 id="_server_performance_profile">Server Performance Profile</h3><div style="clear:left"></div> <h3 id="_server_performance_profile">Server Performance Profile</h3><div style="clear:left"></div>
<div class="paragraph"><p>This section describes the format of server performance profile. The <div class="paragraph"><p>This section describes the format of server performance profile. The
@ -3269,7 +3271,7 @@ GID
</dl></div> </dl></div>
<h3 id="_methods">Methods</h3><div style="clear:left"></div> <h3 id="_methods">Methods</h3><div style="clear:left"></div>
<div class="paragraph"><p>All code examples come from Python2.7 interpreter.</p></div> <div class="paragraph"><p>All code examples come from Python2.7 interpreter.</p></div>
<h4 id="_strong_aria2_adduri_strong_em_uris_options_position_em"><strong>aria2.addUri</strong> (<em>uris[, options[, position]]</em>)</h4> <h4 id="aria2_xmlrpc_aria2_addUri"><strong>aria2.addUri</strong> (<em>uris[, options[, position]]</em>)</h4>
<h5 id="_description_2">Description</h5> <h5 id="_description_2">Description</h5>
<div class="paragraph"><p>This method adds new HTTP(S)/FTP/BitTorrent Magnet URI. <em>uris</em> is of <div class="paragraph"><p>This method adds new HTTP(S)/FTP/BitTorrent Magnet URI. <em>uris</em> is of
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
@ -3277,7 +3279,7 @@ 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 file. be BitTorrent Magnet URI. URIs in <em>uris</em> must point to the same file.
If you mix other URIs which point to another file, aria2 does not If you mix other URIs which point to another file, aria2 does not
complain but download may fail. <em>options</em> is of type struct and its complain but download may fail. <em>options</em> is of type struct and its
members are a pair of option name and value. See <strong>Options</strong> below for members are a pair of option name and value. See <strong><a href="#aria2_xmlrpc_options">Options</a></strong> below for
more details. If <em>position</em> is given as an integer starting from 0, more details. If <em>position</em> is given as an integer starting from 0,
the new download is inserted at <em>position</em> in the waiting queue. If the new download is inserted at <em>position</em> in the waiting queue. If
<em>position</em> is not given or <em>position</em> is larger than the size of the <em>position</em> is not given or <em>position</em> is larger than the size of the
@ -3303,10 +3305,10 @@ GID of registered download.</p></div>
<pre><tt>&gt;&gt;&gt; s.aria2.addUri(['http://example.org/file'], {}, 0) <pre><tt>&gt;&gt;&gt; s.aria2.addUri(['http://example.org/file'], {}, 0)
'3'</tt></pre> '3'</tt></pre>
</div></div> </div></div>
<h4 id="_strong_aria2_addtorrent_strong_em_torrent_uris_options_position_em"><strong>aria2.addTorrent</strong> (<em>torrent[, uris[, options[, position]]]</em>)</h4> <h4 id="aria2_xmlrpc_aria2_addTorrent"><strong>aria2.addTorrent</strong> (<em>torrent[, uris[, options[, position]]]</em>)</h4>
<h5 id="_description_3">Description</h5> <h5 id="_description_3">Description</h5>
<div class="paragraph"><p>This method adds BitTorrent download by uploading .torrent file. If <div class="paragraph"><p>This method adds BitTorrent download by uploading .torrent file. If
you want to add BitTorrent Magnet URI, use <strong>aria2.addUri</strong> method you want to add BitTorrent Magnet URI, use <strong><a href="#aria2_xmlrpc_aria2_addUri">aria2.addUri</a></strong> method
instead. <em>torrent</em> is of type base64 which contains Base64-encoded instead. <em>torrent</em> is of type base64 which contains Base64-encoded
.torrent file. <em>uris</em> is of type array and its element is URI which .torrent file. <em>uris</em> is of type array and its element is URI which
is of type string. <em>uris</em> is used for Web-seeding. For single file is of type string. <em>uris</em> is used for Web-seeding. For single file
@ -3314,7 +3316,7 @@ torrents, URI can be a complete URI pointing to the resource or if URI
ends with /, name in torrent file is added. For multi-file torrents, ends with /, name in torrent file is added. For multi-file torrents,
name and path in torrent are added to form a URI for each file. name and path in torrent are added to form a URI for each file.
<em>options</em> is of type struct and its members are a pair of option name <em>options</em> is of type struct and its members are a pair of option name
and value. See <strong>Options</strong> below for more details. If <em>position</em> is and value. See <strong><a href="#aria2_xmlrpc_options">Options</a></strong> below for more details. If <em>position</em> is
given as an integer starting from 0, the new download is inserted at given as an integer starting from 0, the new download is inserted at
<em>position</em> in the waiting queue. If <em>position</em> is not given or <em>position</em> in the waiting queue. If <em>position</em> is not given or
<em>position</em> is larger than the size of the queue, it is appended at the <em>position</em> is larger than the size of the queue, it is appended at the
@ -3329,12 +3331,12 @@ Please note that the downloads added by this method are not saved by
&gt;&gt;&gt; s.aria2.addTorrent(xmlrpclib.Binary(open('file.torrent').read())) &gt;&gt;&gt; s.aria2.addTorrent(xmlrpclib.Binary(open('file.torrent').read()))
'6'</tt></pre> '6'</tt></pre>
</div></div> </div></div>
<h4 id="_strong_aria2_addmetalink_strong_em_metalink_options_position_em"><strong>aria2.addMetalink</strong> (<em>metalink[, options[, position]]</em>)</h4> <h4 id="aria2_xmlrpc_aria2_addMetalink"><strong>aria2.addMetalink</strong> (<em>metalink[, options[, position]]</em>)</h4>
<h5 id="_description_4">Description</h5> <h5 id="_description_4">Description</h5>
<div class="paragraph"><p>This method adds Metalink download by uploading .metalink file. <div class="paragraph"><p>This method adds Metalink download by uploading .metalink file.
<em>metalink</em> is of type base64 which contains Base64-encoded .metalink <em>metalink</em> is of type base64 which contains Base64-encoded .metalink
file. <em>options</em> is of type struct and its members are a pair of file. <em>options</em> is of type struct and its members are a pair of
option name and value. See <strong>Options</strong> below for more details. If option name and value. See <strong><a href="#aria2_xmlrpc_options">Options</a></strong> below for more details. If
<em>position</em> is given as an integer starting from 0, the new download is <em>position</em> is given as an integer starting from 0, the new download is
inserted at <em>position</em> in the waiting queue. If <em>position</em> is not inserted at <em>position</em> in the waiting queue. If <em>position</em> is not
given or <em>position</em> is larger than the size of the queue, it is given or <em>position</em> is larger than the size of the queue, it is
@ -3349,7 +3351,7 @@ method are not saved by <strong><a href="#aria2_optref_save_session">--save-sess
&gt;&gt;&gt; s.aria2.addMetalink(xmlrpclib.Binary(open('file.meta4').read())) &gt;&gt;&gt; s.aria2.addMetalink(xmlrpclib.Binary(open('file.meta4').read()))
['8']</tt></pre> ['8']</tt></pre>
</div></div> </div></div>
<h4 id="_strong_aria2_remove_strong_em_gid_em"><strong>aria2.remove</strong> (<em>gid</em>)</h4> <h4 id="aria2_xmlrpc_aria2_remove"><strong>aria2.remove</strong> (<em>gid</em>)</h4>
<h5 id="_description_5">Description</h5> <h5 id="_description_5">Description</h5>
<div class="paragraph"><p>This method removes the download denoted by <em>gid</em>. <em>gid</em> is of type <div class="paragraph"><p>This method removes the download denoted by <em>gid</em>. <em>gid</em> is of type
string. If specified download is in progress, it is stopped at string. If specified download is in progress, it is stopped at
@ -3363,52 +3365,52 @@ returns GID of removed download.</p></div>
&gt;&gt;&gt; s.aria2.remove('3') &gt;&gt;&gt; s.aria2.remove('3')
'3'</tt></pre> '3'</tt></pre>
</div></div> </div></div>
<h4 id="_strong_aria2_forceremove_strong_em_gid_em"><strong>aria2.forceRemove</strong> (<em>gid</em>)</h4> <h4 id="aria2_xmlrpc_aria2_forceRemove"><strong>aria2.forceRemove</strong> (<em>gid</em>)</h4>
<h5 id="_description_6">Description</h5> <h5 id="_description_6">Description</h5>
<div class="paragraph"><p>This method removes the download denoted by <em>gid</em>. This method <div class="paragraph"><p>This method removes the download denoted by <em>gid</em>. This method
behaves just like <strong>aria2.remove</strong> except that this method removes behaves just like <strong><a href="#aria2_xmlrpc_aria2_remove">aria2.remove</a></strong> except that this method removes
download without any action which takes time such as contacting download without any action which takes time such as contacting
BitTorrent tracker.</p></div> BitTorrent tracker.</p></div>
<h4 id="_strong_aria2_pause_strong_em_gid_em"><strong>aria2.pause</strong> (<em>gid</em>)</h4> <h4 id="aria2_xmlrpc_aria2_pause"><strong>aria2.pause</strong> (<em>gid</em>)</h4>
<h5 id="_description_7">Description</h5> <h5 id="_description_7">Description</h5>
<div class="paragraph"><p>This method pauses the download denoted by <em>gid</em>. <em>gid</em> is of type <div class="paragraph"><p>This method pauses the download denoted by <em>gid</em>. <em>gid</em> is of type
string. The status of paused download becomes "paused". If the string. The status of paused download becomes "paused". If the
download is active, the download is placed on the first position of download is active, the download is placed on the first position of
waiting queue. As long as the status is "paused", the download is not waiting queue. As long as the status is "paused", the download is not
started. To change status to "waiting", use <strong>aria2.unpause</strong> method. started. To change status to "waiting", use <strong><a href="#aria2_xmlrpc_aria2_unpause">aria2.unpause</a></strong> method.
This method returns GID of paused download.</p></div> This method returns GID of paused download.</p></div>
<h4 id="_strong_aria2_pauseall_strong"><strong>aria2.pauseAll</strong> ()</h4> <h4 id="aria2_xmlrpc_aria2_pauseAll"><strong>aria2.pauseAll</strong> ()</h4>
<h5 id="_description_8">Description</h5> <h5 id="_description_8">Description</h5>
<div class="paragraph"><p>This method is equal to calling <strong>aria2.pause</strong> for every active/waiting <div class="paragraph"><p>This method is equal to calling <strong><a href="#aria2_xmlrpc_aria2_pause">aria2.pause</a></strong> for every active/waiting
download. This methods returns "OK" for success.</p></div> download. This methods returns "OK" for success.</p></div>
<h4 id="_strong_aria2_forcepause_strong_em_pid_em"><strong>aria2.forcePause</strong> (<em>pid</em>)</h4> <h4 id="aria2_xmlrpc_aria2_forcePause"><strong>aria2.forcePause</strong> (<em>pid</em>)</h4>
<h5 id="_description_9">Description</h5> <h5 id="_description_9">Description</h5>
<div class="paragraph"><p>This method pauses the download denoted by <em>gid</em>. This method <div class="paragraph"><p>This method pauses the download denoted by <em>gid</em>. This method
behaves just like <strong>aria2.pause</strong> except that this method pauses behaves just like <strong><a href="#aria2_xmlrpc_aria2_pause">aria2.pause</a></strong> except that this method pauses
download without any action which takes time such as contacting download without any action which takes time such as contacting
BitTorrent tracker.</p></div> BitTorrent tracker.</p></div>
<h4 id="_strong_aria2_forcepauseall_strong"><strong>aria2.forcePauseAll</strong> ()</h4> <h4 id="aria2_xmlrpc_aria2_forcePauseAll"><strong>aria2.forcePauseAll</strong> ()</h4>
<h5 id="_description_10">Description</h5> <h5 id="_description_10">Description</h5>
<div class="paragraph"><p>This method is equal to calling <strong>aria2.forcePause</strong> for every <div class="paragraph"><p>This method is equal to calling <strong><a href="#aria2_xmlrpc_aria2_forcePause">aria2.forcePause</a></strong> for every
active/waiting download. This methods returns "OK" for success.</p></div> active/waiting download. This methods returns "OK" for success.</p></div>
<h4 id="_strong_aria2_unpause_strong_em_gid_em"><strong>aria2.unpause</strong> (<em>gid</em>)</h4> <h4 id="aria2_xmlrpc_aria2_unpause"><strong>aria2.unpause</strong> (<em>gid</em>)</h4>
<h5 id="_description_11">Description</h5> <h5 id="_description_11">Description</h5>
<div class="paragraph"><p>This method changes the status of the download denoted by <em>gid</em> from <div class="paragraph"><p>This method changes the status of the download denoted by <em>gid</em> from
"paused" to "waiting". This makes the download eligible to restart. "paused" to "waiting". This makes the download eligible to restart.
<em>gid</em> is of type string. This method returns GID of unpaused <em>gid</em> is of type string. This method returns GID of unpaused
download.</p></div> download.</p></div>
<h4 id="_strong_aria2_unpauseall_strong"><strong>aria2.unpauseAll</strong> ()</h4> <h4 id="aria2_xmlrpc_aria2_unpauseAll"><strong>aria2.unpauseAll</strong> ()</h4>
<h5 id="_description_12">Description</h5> <h5 id="_description_12">Description</h5>
<div class="paragraph"><p>This method is equal to calling <strong>aria2.unpause</strong> for every active/waiting <div class="paragraph"><p>This method is equal to calling <strong><a href="#aria2_xmlrpc_aria2_unpause">aria2.unpause</a></strong> for every active/waiting
download. This methods returns "OK" for success.</p></div> download. This methods returns "OK" for success.</p></div>
<h4 id="_strong_aria2_tellstatus_strong_em_gid_keys_em"><strong>aria2.tellStatus</strong> (<em>gid[, keys]</em>)</h4> <h4 id="aria2_xmlrpc_aria2_tellStatus"><strong>aria2.tellStatus</strong> (<em>gid[, keys]</em>)</h4>
<h5 id="_description_13">Description</h5> <h5 id="_description_13">Description</h5>
<div class="paragraph"><p>This method returns download progress of the download denoted by <div class="paragraph"><p>This method returns download progress of the download denoted by
<em>gid</em>. <em>gid</em> is of type string. <em>keys</em> is array of string. If it is <em>gid</em>. <em>gid</em> is of type string. <em>keys</em> is array of string. If it is
specified, the response contains only keys in <em>keys</em> array. If <em>keys</em> specified, the response contains only keys in <em>keys</em> array. If <em>keys</em>
is empty or not specified, the response contains all keys. This is is empty or not specified, the response contains all keys. This is
useful when you just want specific keys and avoid unnecessary useful when you just want specific keys and avoid unnecessary
transfers. For example, <strong>aria2.tellStatus</strong>("1", ["gid", "status"]) transfers. For example, <strong><a href="#aria2_xmlrpc_aria2_tellStatus">aria2.tellStatus</a></strong>("1", ["gid", "status"])
returns <em>gid</em> and <em>status</em> key. The response is of type struct and it returns <em>gid</em> and <em>status</em> key. The response is of type struct and it
contains following keys. The value type is string.</p></div> contains following keys. The value type is string.</p></div>
<div class="dlist"><dl> <div class="dlist"><dl>
@ -3574,7 +3576,7 @@ files
<dd> <dd>
<p> <p>
Returns the list of files. The element of list is the same struct Returns the list of files. The element of list is the same struct
used in <strong>aria2.getFiles</strong> method. used in <strong><a href="#aria2_xmlrpc_aria2_getFiles">aria2.getFiles</a></strong> method.
</p> </p>
</dd> </dd>
<dt class="hdlist1"> <dt class="hdlist1">
@ -3678,7 +3680,7 @@ name
&gt;&gt;&gt; pprint(r) &gt;&gt;&gt; pprint(r)
{'completedLength': '34896138', 'gid': '1', 'totalLength': '34896138'}</tt></pre> {'completedLength': '34896138', 'gid': '1', 'totalLength': '34896138'}</tt></pre>
</div></div> </div></div>
<h4 id="_strong_aria2_geturis_strong_em_gid_em"><strong>aria2.getUris</strong> (<em>gid</em>)</h4> <h4 id="aria2_xmlrpc_aria2_getUris"><strong>aria2.getUris</strong> (<em>gid</em>)</h4>
<h5 id="_description_14">Description</h5> <h5 id="_description_14">Description</h5>
<div class="paragraph"><p>This method returns URIs used in the download denoted by <em>gid</em>. <em>gid</em> <div class="paragraph"><p>This method returns URIs used in the download denoted by <em>gid</em>. <em>gid</em>
is of type string. The response is of type array and its element is of is of type string. The response is of type array and its element is of
@ -3702,7 +3704,7 @@ status
</p> </p>
</dd> </dd>
</dl></div> </dl></div>
<h4 id="_strong_aria2_getfiles_strong_em_gid_em"><strong>aria2.getFiles</strong> (<em>gid</em>)</h4> <h4 id="aria2_xmlrpc_aria2_getFiles"><strong>aria2.getFiles</strong> (<em>gid</em>)</h4>
<h5 id="_description_15">Description</h5> <h5 id="_description_15">Description</h5>
<div class="paragraph"><p>This method returns file list of the download denoted by <em>gid</em>. <em>gid</em> <div class="paragraph"><p>This method returns file list of the download denoted by <em>gid</em>. <em>gid</em>
is of type string. The response is of type array and its element is of is of type string. The response is of type array and its element is of
@ -3749,11 +3751,11 @@ uris
<dd> <dd>
<p> <p>
Returns the list of URI for this file. The element of list is the Returns the list of URI for this file. The element of list is the
same struct used in <strong>aria2.getUris</strong> method. same struct used in <strong><a href="#aria2_xmlrpc_aria2_getUris">aria2.getUris</a></strong> method.
</p> </p>
</dd> </dd>
</dl></div> </dl></div>
<h4 id="_strong_aria2_getpeers_strong_em_gid_em"><strong>aria2.getPeers</strong> (<em>gid</em>)</h4> <h4 id="aria2_xmlrpc_aria2_getPeers"><strong>aria2.getPeers</strong> (<em>gid</em>)</h4>
<h5 id="_description_16">Description</h5> <h5 id="_description_16">Description</h5>
<div class="paragraph"><p>This method returns peer list of the download denoted by <em>gid</em>. <em>gid</em> <div class="paragraph"><p>This method returns peer list of the download denoted by <em>gid</em>. <em>gid</em>
is of type string. This method is for BitTorrent only. The response is of type string. This method is for BitTorrent only. The response
@ -3836,7 +3838,7 @@ seeder
</p> </p>
</dd> </dd>
</dl></div> </dl></div>
<h4 id="_strong_aria2_getservers_strong_em_gid_em"><strong>aria2.getServers</strong> (<em>gid</em>)</h4> <h4 id="aria2_xmlrpc_aria2_getServers"><strong>aria2.getServers</strong> (<em>gid</em>)</h4>
<h5 id="_description_17">Description</h5> <h5 id="_description_17">Description</h5>
<div class="paragraph"><p>This method returns currently connected HTTP(S)/FTP servers of the download denoted by <em>gid</em>. <em>gid</em> is of type string. The response <div class="paragraph"><p>This method returns currently connected HTTP(S)/FTP servers of the download denoted by <em>gid</em>. <em>gid</em> is of type string. The response
is of type array and its element is of type struct and it contains is of type array and its element is of type struct and it contains
@ -3887,19 +3889,19 @@ downloadSpeed
</dl></div> </dl></div>
</dd> </dd>
</dl></div> </dl></div>
<h4 id="_strong_aria2_tellactive_strong_em_keys_em"><strong>aria2.tellActive</strong> (<em>[keys]</em>)</h4> <h4 id="aria2_xmlrpc_aria2_tellActive"><strong>aria2.tellActive</strong> (<em>[keys]</em>)</h4>
<h5 id="_description_18">Description</h5> <h5 id="_description_18">Description</h5>
<div class="paragraph"><p>This method returns the list of active downloads. The response is of <div class="paragraph"><p>This method returns the list of active downloads. The response is of
type array and its element is the same struct returned by type array and its element is the same struct returned by
<strong>aria2.tellStatus</strong> method. For <em>keys</em> parameter, please refer to <strong><a href="#aria2_xmlrpc_aria2_tellStatus">aria2.tellStatus</a></strong> method. For <em>keys</em> parameter, please refer to
<strong>aria2.tellStatus</strong> method.</p></div> <strong><a href="#aria2_xmlrpc_aria2_tellStatus">aria2.tellStatus</a></strong> method.</p></div>
<h4 id="_strong_aria2_tellwaiting_strong_em_offset_num_keys_em"><strong>aria2.tellWaiting</strong> (<em>offset, num, [keys]</em>)</h4> <h4 id="aria2_xmlrpc_aria2_tellWaiting"><strong>aria2.tellWaiting</strong> (<em>offset, num, [keys]</em>)</h4>
<h5 id="_description_19">Description</h5> <h5 id="_description_19">Description</h5>
<div class="paragraph"><p>This method returns the list of waiting download, including paused <div class="paragraph"><p>This method returns the list of waiting download, including paused
downloads. <em>offset</em> is of type integer and specifies the offset from downloads. <em>offset</em> is of type integer and specifies the offset from
the download waiting at the front. <em>num</em> is of type integer and the download waiting at the front. <em>num</em> is of type integer and
specifies the number of downloads to be returned. For <em>keys</em> specifies the number of downloads to be returned. For <em>keys</em>
parameter, please refer to <strong>aria2.tellStatus</strong> method.</p></div> parameter, please refer to <strong><a href="#aria2_xmlrpc_aria2_tellStatus">aria2.tellStatus</a></strong> method.</p></div>
<div class="paragraph"><p>If offset is a positive integer, this method returns downloads in the <div class="paragraph"><p>If offset is a positive integer, this method returns downloads in the
range of [<em>offset</em>, <em>offset</em>+<em>num</em>).</p></div> range of [<em>offset</em>, <em>offset</em>+<em>num</em>).</p></div>
<div class="paragraph"><p><em>offset</em> can be a negative integer. <em>offset</em> == -1 points last <div class="paragraph"><p><em>offset</em> can be a negative integer. <em>offset</em> == -1 points last
@ -3911,18 +3913,18 @@ in this order. aria2.tellWaiting(0, 1) returns
["A"]. aria2.tellWaiting(1, 2) returns ["B", "C"]. ["A"]. aria2.tellWaiting(1, 2) returns ["B", "C"].
aria2.tellWaiting(-1, 2) returns ["C", "B"].</p></div> aria2.tellWaiting(-1, 2) returns ["C", "B"].</p></div>
<div class="paragraph"><p>The response is of type array and its element is the same struct <div class="paragraph"><p>The response is of type array and its element is the same struct
returned by <strong>aria2.tellStatus</strong> method.</p></div> returned by <strong><a href="#aria2_xmlrpc_aria2_tellStatus">aria2.tellStatus</a></strong> method.</p></div>
<h4 id="_strong_aria2_tellstopped_strong_em_offset_num_keys_em"><strong>aria2.tellStopped</strong> (<em>offset, num, [keys]</em>)</h4> <h4 id="aria2_xmlrpc_aria2_tellStopped"><strong>aria2.tellStopped</strong> (<em>offset, num, [keys]</em>)</h4>
<h5 id="_description_20">Description</h5> <h5 id="_description_20">Description</h5>
<div class="paragraph"><p>This method returns the list of stopped download. <em>offset</em> is of type <div class="paragraph"><p>This method returns the list of stopped download. <em>offset</em> is of type
integer and specifies the offset from the oldest download. <em>num</em> is of integer and specifies the offset from the oldest download. <em>num</em> is of
type integer and specifies the number of downloads to be returned. type integer and specifies the number of downloads to be returned.
For <em>keys</em> parameter, please refer to <strong>aria2.tellStatus</strong> method.</p></div> For <em>keys</em> parameter, please refer to <strong><a href="#aria2_xmlrpc_aria2_tellStatus">aria2.tellStatus</a></strong> method.</p></div>
<div class="paragraph"><p><em>offset</em> and <em>num</em> have the same semantics as <strong>aria2.tellWaiting</strong> <div class="paragraph"><p><em>offset</em> and <em>num</em> have the same semantics as <strong><a href="#aria2_xmlrpc_aria2_tellWaiting">aria2.tellWaiting</a></strong>
method.</p></div> method.</p></div>
<div class="paragraph"><p>The response is of type array and its element is the same struct <div class="paragraph"><p>The response is of type array and its element is the same struct
returned by <strong>aria2.tellStatus</strong> method.</p></div> returned by <strong><a href="#aria2_xmlrpc_aria2_tellStatus">aria2.tellStatus</a></strong> method.</p></div>
<h4 id="_strong_aria2_changeposition_strong_em_gid_pos_how_em"><strong>aria2.changePosition</strong> (<em>gid, pos, how</em>)</h4> <h4 id="aria2_xmlrpc_aria2_changePosition"><strong>aria2.changePosition</strong> (<em>gid, pos, how</em>)</h4>
<h5 id="_description_21">Description</h5> <h5 id="_description_21">Description</h5>
<div class="paragraph"><p>This method changes the position of the download denoted by <div class="paragraph"><p>This method changes the position of the download denoted by
<em>gid</em>. <em>pos</em> is of type integer. <em>how</em> is of type string. If <em>how</em> is <em>gid</em>. <em>pos</em> is of type integer. <em>how</em> is of type string. If <em>how</em> is
@ -3938,7 +3940,7 @@ destination position.</p></div>
-1, POS_CUR) will change its position to 2. Additional -1, POS_CUR) will change its position to 2. Additional
aria2.changePosition(1, 0, POS_SET) will change its position to 0(the aria2.changePosition(1, 0, POS_SET) will change its position to 0(the
beginning of the queue).</p></div> beginning of the queue).</p></div>
<h4 id="_strong_aria2_changeuri_strong_em_gid_fileindex_deluris_adduris_position_em"><strong>aria2.changeUri</strong> (<em>gid, fileIndex, delUris, addUris[, position]</em>)</h4> <h4 id="aria2_xmlrpc_aria2_changeUri"><strong>aria2.changeUri</strong> (<em>gid, fileIndex, delUris, addUris[, position]</em>)</h4>
<h5 id="_description_22">Description</h5> <h5 id="_description_22">Description</h5>
<div class="paragraph"><p>This method removes URIs in <em>delUris</em> from and appends URIs in <div class="paragraph"><p>This method removes URIs in <em>delUris</em> from and appends URIs in
<em>addUris</em> to download denoted by <em>gid</em>. <em>delUris</em> and <em>addUris</em> are <em>addUris</em> to download denoted by <em>gid</em>. <em>delUris</em> and <em>addUris</em> are
@ -3957,39 +3959,39 @@ specify (at least) 3 "http://example.org/aria2" in <em>delUris</em>. This
method returns a list which contains 2 integers. The first integer is method returns a list which contains 2 integers. The first integer is
the number of URIs deleted. The second integer is the number of URIs the number of URIs deleted. The second integer is the number of URIs
added.</p></div> added.</p></div>
<h4 id="_strong_aria2_getoption_strong_em_gid_em"><strong>aria2.getOption</strong> (<em>gid</em>)</h4> <h4 id="aria2_xmlrpc_aria2_getOption"><strong>aria2.getOption</strong> (<em>gid</em>)</h4>
<h5 id="_description_23">Description</h5> <h5 id="_description_23">Description</h5>
<div class="paragraph"><p>This method returns options of the download denoted by <em>gid</em>. The <div class="paragraph"><p>This method returns options of the download denoted by <em>gid</em>. The
response is of type struct. Its key is the name of option. The value type response is of type struct. Its key is the name of option. The value type
is string.</p></div> is string.</p></div>
<h4 id="_strong_aria2_changeoption_strong_em_gid_options_em"><strong>aria2.changeOption</strong> (<em>gid, options</em>)</h4> <h4 id="aria2_xmlrpc_aria2_changeOption"><strong>aria2.changeOption</strong> (<em>gid, options</em>)</h4>
<h5 id="_description_24">Description</h5> <h5 id="_description_24">Description</h5>
<div class="paragraph"><p>This method changes options of the download denoted by <em>gid</em> <div class="paragraph"><p>This method changes options of the download denoted by <em>gid</em>
dynamically. <em>gid</em> is of type string. <em>options</em> is of type struct dynamically. <em>gid</em> is of type string. <em>options</em> is of type struct
and the available options are: <strong>bt-max-peers</strong>, and the available options are: <strong><a href="#aria2_optref_bt_max_peers">bt-max-peers</a></strong>,
<strong>bt-request-peer-speed-limit</strong>, <strong>max-download-limit</strong> and <strong><a href="#aria2_optref_bt_request_peer_speed_limit">bt-request-peer-speed-limit</a></strong>, <strong><a href="#aria2_optref_max_download_limit">max-download-limit</a></strong> and
<strong>max-upload-limit</strong>. This method returns "OK" for success.</p></div> <strong><a href="#aria2_optref_max_upload_limit">max-upload-limit</a></strong>. This method returns "OK" for success.</p></div>
<h4 id="_strong_aria2_getglobaloption_strong"><strong>aria2.getGlobalOption</strong> ()</h4> <h4 id="aria2_xmlrpc_aria2_getGlobalOption"><strong>aria2.getGlobalOption</strong> ()</h4>
<h5 id="_description_25">Description</h5> <h5 id="_description_25">Description</h5>
<div class="paragraph"><p>This method returns global options. The response is of type <div class="paragraph"><p>This method returns global options. The response is of type
struct. Its key is the name of option. The value type is string. struct. Its key is the name of option. The value type is string.
Because global options are used as a template for the options of newly Because global options are used as a template for the options of newly
added download, the response contains keys returned by added download, the response contains keys returned by
<strong>aria2.getOption</strong> method.</p></div> <strong><a href="#aria2_xmlrpc_aria2_getOption">aria2.getOption</a></strong> method.</p></div>
<h4 id="_strong_aria2_changeglobaloption_strong_em_options_em"><strong>aria2.changeGlobalOption</strong> (<em>options</em>)</h4> <h4 id="aria2_xmlrpc_aria2_changeGlobalOption"><strong>aria2.changeGlobalOption</strong> (<em>options</em>)</h4>
<h5 id="_description_26">Description</h5> <h5 id="_description_26">Description</h5>
<div class="paragraph"><p>This method changes global options dynamically. <em>options</em> is of type <div class="paragraph"><p>This method changes global options dynamically. <em>options</em> is of type
struct and the available options are <strong>max-concurrent-downloads</strong>, struct and the available options are <strong><a href="#aria2_optref_max_concurrent_downloads">max-concurrent-downloads</a></strong>,
<strong>max-overall-download-limit</strong>, <strong>max-overall-upload-limit</strong>, <strong>log-level</strong> <strong><a href="#aria2_optref_max_overall_download_limit">max-overall-download-limit</a></strong>, <strong><a href="#aria2_optref_max_overall_upload_limit">max-overall-upload-limit</a></strong>, <strong><a href="#aria2_optref_log_level">log-level</a></strong>
and <strong>log</strong>. Using <strong>log</strong> option, you can dynamically start logging or and <strong><a href="#aria2_optref_log">log</a></strong>. Using <strong><a href="#aria2_optref_log">log</a></strong> option, you can dynamically start logging or
change log file. To stop logging, give empty string("") as a parameter change log file. To stop logging, give empty string("") as a parameter
value. Note that log file is always opened in append mode. This method value. Note that log file is always opened in append mode. This method
returns "OK" for success.</p></div> returns "OK" for success.</p></div>
<h4 id="_strong_aria2_purgedownloadresult_strong"><strong>aria2.purgeDownloadResult</strong> ()</h4> <h4 id="aria2_xmlrpc_aria2_purgeDownloadResult"><strong>aria2.purgeDownloadResult</strong> ()</h4>
<h5 id="_description_27">Description</h5> <h5 id="_description_27">Description</h5>
<div class="paragraph"><p>This method purges completed/error/removed downloads to free memory. <div class="paragraph"><p>This method purges completed/error/removed downloads to free memory.
This method returns "OK".</p></div> This method returns "OK".</p></div>
<h4 id="_strong_aria2_getversion_strong"><strong>aria2.getVersion</strong> ()</h4> <h4 id="aria2_xmlrpc_aria2_getVersion"><strong>aria2.getVersion</strong> ()</h4>
<h5 id="_description_28">Description</h5> <h5 id="_description_28">Description</h5>
<div class="paragraph"><p>This method returns version of the program and the list of enabled <div class="paragraph"><p>This method returns version of the program and the list of enabled
features. The response is of type struct and contains following keys.</p></div> features. The response is of type struct and contains following keys.</p></div>
@ -4028,7 +4030,7 @@ enabledFeatures
'XML-RPC'], 'XML-RPC'],
'version': '1.10.5'}</tt></pre> 'version': '1.10.5'}</tt></pre>
</div></div> </div></div>
<h4 id="_strong_aria2_getsessioninfo_strong"><strong>aria2.getSessionInfo</strong> ()</h4> <h4 id="aria2_xmlrpc_aria2_getSessionInfo"><strong>aria2.getSessionInfo</strong> ()</h4>
<h5 id="_description_29">Description</h5> <h5 id="_description_29">Description</h5>
<div class="paragraph"><p>This method returns session information. <div class="paragraph"><p>This method returns session information.
The response is of type struct and contains following key.</p></div> The response is of type struct and contains following key.</p></div>
@ -4049,15 +4051,15 @@ sessionId
&gt;&gt;&gt; s.aria2.getSessionInfo() &gt;&gt;&gt; s.aria2.getSessionInfo()
{'sessionId': 'cd6a3bc6a1de28eb5bfa181e5f6b916d44af31a9'}</tt></pre> {'sessionId': 'cd6a3bc6a1de28eb5bfa181e5f6b916d44af31a9'}</tt></pre>
</div></div> </div></div>
<h4 id="_strong_aria2_shutdown_strong"><strong>aria2.shutdown</strong> ()</h4> <h4 id="aria2_xmlrpc_aria2_shutdown"><strong>aria2.shutdown</strong> ()</h4>
<h5 id="_description_30">Description</h5> <h5 id="_description_30">Description</h5>
<div class="paragraph"><p>This method shutdowns aria2. This method returns "OK".</p></div> <div class="paragraph"><p>This method shutdowns aria2. This method returns "OK".</p></div>
<h4 id="_strong_aria2_forceshutdown_strong"><strong>aria2.forceShutdown</strong> ()</h4> <h4 id="aria2_xmlrpc_aria2_forceShutdown"><strong>aria2.forceShutdown</strong> ()</h4>
<h5 id="_description_31">Description</h5> <h5 id="_description_31">Description</h5>
<div class="paragraph"><p>This method shutdowns aria2. This method behaves like <strong>aria2.shutdown</strong> <div class="paragraph"><p>This method shutdowns aria2. This method behaves like <strong><a href="#aria2_xmlrpc_aria2_shutdown">aria2.shutdown</a></strong>
except that any actions which takes time such as contacting BitTorrent except that any actions which takes time such as contacting BitTorrent
tracker are skipped. This method returns "OK".</p></div> tracker are skipped. This method returns "OK".</p></div>
<h4 id="_strong_system_multicall_strong_em_methods_em"><strong>system.multicall</strong> (<em>methods</em>)</h4> <h4 id="aria2_xmlrpc_system_multicall"><strong>system.multicall</strong> (<em>methods</em>)</h4>
<h5 id="_description_32">Description</h5> <h5 id="_description_32">Description</h5>
<div class="paragraph"><p>This methods encapsulates multiple method calls in a single request. <div class="paragraph"><p>This methods encapsulates multiple method calls in a single request.
<em>methods</em> is of type array and its element is struct. The struct <em>methods</em> is of type array and its element is struct. The struct
@ -4083,7 +4085,7 @@ http://example.org/file and second one is file.torrent:</p></div>
<h3 id="_error_handling">Error Handling</h3><div style="clear:left"></div> <h3 id="_error_handling">Error Handling</h3><div style="clear:left"></div>
<div class="paragraph"><p>In case of error, aria2 returns faultCode=1 and the error message in <div class="paragraph"><p>In case of error, aria2 returns faultCode=1 and the error message in
faultString.</p></div> faultString.</p></div>
<h3 id="_options_2">Options</h3><div style="clear:left"></div> <h3 id="aria2_xmlrpc_options">Options</h3><div style="clear:left"></div>
<div class="paragraph"><p>Same options for <strong><a href="#aria2_optref_input_file">-i</a></strong> list are available. See <strong><a href="#_input_file">Input File</a></strong> subsection for complete list of options.</p></div> <div class="paragraph"><p>Same options for <strong><a href="#aria2_optref_input_file">-i</a></strong> list are available. See <strong><a href="#_input_file">Input File</a></strong> subsection for complete list of options.</p></div>
<div class="paragraph"><p>In the option struct, name element is option name(without preceding <div class="paragraph"><p>In the option struct, name element is option name(without preceding
"--") and value element is argument as string.</p></div> "--") and value element is argument as string.</p></div>
@ -4100,7 +4102,8 @@ faultString.</p></div>
&lt;/member&gt; &lt;/member&gt;
&lt;/struct&gt;</tt></pre> &lt;/struct&gt;</tt></pre>
</div></div> </div></div>
<div class="paragraph"><p><strong>header</strong> and <strong>index-out</strong> option are allowed multiple times in <div class="paragraph"><p><strong><a href="#aria2_optref_header">header</a></strong> and <strong><a href="#aria2_optref_index_out">index-out</a></strong>
option are allowed multiple times in
command-line. Since name should be unique in struct(many XML-RPC command-line. Since name should be unique in struct(many XML-RPC
library implementation uses hash or dict for struct), single string is library implementation uses hash or dict for struct), single string is
not enough. To overcome this situation, they can take array as value not enough. To overcome this situation, they can take array as value
@ -4583,7 +4586,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-10-30 20:41:46 JST Last updated 2010-10-30 21:20:38 JST
</div> </div>
</div> </div>
</body> </body>

97
doc/aria2c.1.txt
View File

@ -37,7 +37,8 @@ Basic Options
Downloads URIs found in FILE. You can specify multiple URIs for a single Downloads URIs found in FILE. You can specify multiple URIs for a single
entity: separate URIs on a single line using the TAB character. entity: separate URIs on a single line using the TAB character.
Reads input from stdin when '-' is specified. Reads input from stdin when '-' is specified.
The additional *out* and *dir* options can be specified after each line of The additional *<<aria2_optref_out, out>>* and *<<aria2_optref_dir, dir>>*
options can be specified after each line of
URIs. This optional line must start with white space(s). URIs. This optional line must start with white space(s).
See *<<_input_file, Input File>>* subsection for details. See *<<_input_file, Input File>>* subsection for details.
@ -1378,7 +1379,8 @@ If aria2 is executed with *<<aria2_optref_input_file, -i>>* uri.txt *<<aria2_opt
from \http://server/file.iso and \http://mirror/file.iso. The file from \http://server/file.iso and \http://mirror/file.iso. The file
'bar' is downloaded from \http://foo/bar and saved as '/tmp/bar'. 'bar' is downloaded from \http://foo/bar and saved as '/tmp/bar'.
In some cases, *out* parameter has no effect. See note of *<<aria2_optref_out, --out>>* In some cases, *<<aria2_optref_out, out>>* parameter has no effect.
See note of *<<aria2_optref_out, --out>>*
option for the restrictions. option for the restrictions.
Server Performance Profile Server Performance Profile
@ -1451,6 +1453,7 @@ Methods
All code examples come from Python2.7 interpreter. All code examples come from Python2.7 interpreter.
[[aria2_xmlrpc_aria2_addUri]]
*aria2.addUri* ('uris[, options[, position]]') *aria2.addUri* ('uris[, options[, position]]')
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@ -1463,7 +1466,7 @@ BitTorrent Magnet URI, 'uris' must have only one element and it should
be BitTorrent Magnet URI. URIs in 'uris' must point to the same file. be BitTorrent Magnet URI. URIs in 'uris' must point to the same file.
If you mix other URIs which point to another file, aria2 does not If you mix other URIs which point to another file, aria2 does not
complain but download may fail. 'options' is of type struct and its complain but download may fail. 'options' is of type struct and its
members are a pair of option name and value. See *Options* below for members are a pair of option name and value. See *<<aria2_xmlrpc_options, Options>>* below for
more details. If 'position' is given as an integer starting from 0, more details. If 'position' is given as an integer starting from 0,
the new download is inserted at 'position' in the waiting queue. If the new download is inserted at 'position' in the waiting queue. If
'position' is not given or 'position' is larger than the size of the 'position' is not given or 'position' is larger than the size of the
@ -1490,6 +1493,7 @@ Adding a download and insert it to the front of waiting downloads:
'3' '3'
--------------------------------------------------------------- ---------------------------------------------------------------
[[aria2_xmlrpc_aria2_addTorrent]]
*aria2.addTorrent* ('torrent[, uris[, options[, position]]]') *aria2.addTorrent* ('torrent[, uris[, options[, position]]]')
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@ -1497,7 +1501,7 @@ Description
+++++++++++ +++++++++++
This method adds BitTorrent download by uploading .torrent file. If This method adds BitTorrent download by uploading .torrent file. If
you want to add BitTorrent Magnet URI, use *aria2.addUri* method you want to add BitTorrent Magnet URI, use *<<aria2_xmlrpc_aria2_addUri, aria2.addUri>>* method
instead. 'torrent' is of type base64 which contains Base64-encoded instead. 'torrent' is of type base64 which contains Base64-encoded
.torrent file. 'uris' is of type array and its element is URI which .torrent file. 'uris' is of type array and its element is URI which
is of type string. 'uris' is used for Web-seeding. For single file is of type string. 'uris' is used for Web-seeding. For single file
@ -1505,7 +1509,7 @@ torrents, URI can be a complete URI pointing to the resource or if URI
ends with /, name in torrent file is added. For multi-file torrents, ends with /, name in torrent file is added. For multi-file torrents,
name and path in torrent are added to form a URI for each file. name and path in torrent are added to form a URI for each file.
'options' is of type struct and its members are a pair of option name 'options' is of type struct and its members are a pair of option name
and value. See *Options* below for more details. If 'position' is and value. See *<<aria2_xmlrpc_options, Options>>* below for more details. If 'position' is
given as an integer starting from 0, the new download is inserted at given as an integer starting from 0, the new download is inserted at
'position' in the waiting queue. If 'position' is not given or 'position' in the waiting queue. If 'position' is not given or
'position' is larger than the size of the queue, it is appended at the 'position' is larger than the size of the queue, it is appended at the
@ -1521,6 +1525,7 @@ Adding local file file.torrent to aria2:
'6' '6'
--------------------------------------------------------------------- ---------------------------------------------------------------------
[[aria2_xmlrpc_aria2_addMetalink]]
*aria2.addMetalink* ('metalink[, options[, position]]') *aria2.addMetalink* ('metalink[, options[, position]]')
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@ -1530,7 +1535,7 @@ Description
This method adds Metalink download by uploading .metalink file. This method adds Metalink download by uploading .metalink file.
'metalink' is of type base64 which contains Base64-encoded .metalink 'metalink' is of type base64 which contains Base64-encoded .metalink
file. 'options' is of type struct and its members are a pair of file. 'options' is of type struct and its members are a pair of
option name and value. See *Options* below for more details. If option name and value. See *<<aria2_xmlrpc_options, Options>>* below for more details. If
'position' is given as an integer starting from 0, the new download is 'position' is given as an integer starting from 0, the new download is
inserted at 'position' in the waiting queue. If 'position' is not inserted at 'position' in the waiting queue. If 'position' is not
given or 'position' is larger than the size of the queue, it is given or 'position' is larger than the size of the queue, it is
@ -1546,6 +1551,7 @@ Adding local file file.meta4 to aria2:
['8'] ['8']
-------------------------------------------------------------------- --------------------------------------------------------------------
[[aria2_xmlrpc_aria2_remove]]
*aria2.remove* ('gid') *aria2.remove* ('gid')
^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^
@ -1565,6 +1571,7 @@ Removing download whose GID is '3':
'3' '3'
-------------------------------------------------------------------- --------------------------------------------------------------------
[[aria2_xmlrpc_aria2_forceRemove]]
*aria2.forceRemove* ('gid') *aria2.forceRemove* ('gid')
^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^
@ -1572,10 +1579,11 @@ Description
+++++++++++ +++++++++++
This method removes the download denoted by 'gid'. This method This method removes the download denoted by 'gid'. This method
behaves just like *aria2.remove* except that this method removes behaves just like *<<aria2_xmlrpc_aria2_remove, aria2.remove>>* except that this method removes
download without any action which takes time such as contacting download without any action which takes time such as contacting
BitTorrent tracker. BitTorrent tracker.
[[aria2_xmlrpc_aria2_pause]]
*aria2.pause* ('gid') *aria2.pause* ('gid')
^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^
@ -1586,18 +1594,20 @@ This method pauses the download denoted by 'gid'. 'gid' is of type
string. The status of paused download becomes "paused". If the string. The status of paused download becomes "paused". If the
download is active, the download is placed on the first position of download is active, the download is placed on the first position of
waiting queue. As long as the status is "paused", the download is not waiting queue. As long as the status is "paused", the download is not
started. To change status to "waiting", use *aria2.unpause* method. started. To change status to "waiting", use *<<aria2_xmlrpc_aria2_unpause, aria2.unpause>>* method.
This method returns GID of paused download. This method returns GID of paused download.
[[aria2_xmlrpc_aria2_pauseAll]]
*aria2.pauseAll* () *aria2.pauseAll* ()
^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^
Description Description
+++++++++++ +++++++++++
This method is equal to calling *aria2.pause* for every active/waiting This method is equal to calling *<<aria2_xmlrpc_aria2_pause, aria2.pause>>* for every active/waiting
download. This methods returns "OK" for success. download. This methods returns "OK" for success.
[[aria2_xmlrpc_aria2_forcePause]]
*aria2.forcePause* ('pid') *aria2.forcePause* ('pid')
^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^
@ -1605,19 +1615,21 @@ Description
+++++++++++ +++++++++++
This method pauses the download denoted by 'gid'. This method This method pauses the download denoted by 'gid'. This method
behaves just like *aria2.pause* except that this method pauses behaves just like *<<aria2_xmlrpc_aria2_pause, aria2.pause>>* except that this method pauses
download without any action which takes time such as contacting download without any action which takes time such as contacting
BitTorrent tracker. BitTorrent tracker.
[[aria2_xmlrpc_aria2_forcePauseAll]]
*aria2.forcePauseAll* () *aria2.forcePauseAll* ()
^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^
Description Description
+++++++++++ +++++++++++
This method is equal to calling *aria2.forcePause* for every This method is equal to calling *<<aria2_xmlrpc_aria2_forcePause, aria2.forcePause>>* for every
active/waiting download. This methods returns "OK" for success. active/waiting download. This methods returns "OK" for success.
[[aria2_xmlrpc_aria2_unpause]]
*aria2.unpause* ('gid') *aria2.unpause* ('gid')
^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^
@ -1629,15 +1641,17 @@ This method changes the status of the download denoted by 'gid' from
'gid' is of type string. This method returns GID of unpaused 'gid' is of type string. This method returns GID of unpaused
download. download.
[[aria2_xmlrpc_aria2_unpauseAll]]
*aria2.unpauseAll* () *aria2.unpauseAll* ()
^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^
Description Description
+++++++++++ +++++++++++
This method is equal to calling *aria2.unpause* for every active/waiting This method is equal to calling *<<aria2_xmlrpc_aria2_unpause, aria2.unpause>>* for every active/waiting
download. This methods returns "OK" for success. download. This methods returns "OK" for success.
[[aria2_xmlrpc_aria2_tellStatus]]
*aria2.tellStatus* ('gid[, keys]') *aria2.tellStatus* ('gid[, keys]')
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@ -1649,7 +1663,7 @@ This method returns download progress of the download denoted by
specified, the response contains only keys in 'keys' array. If 'keys' specified, the response contains only keys in 'keys' array. If 'keys'
is empty or not specified, the response contains all keys. This is is empty or not specified, the response contains all keys. This is
useful when you just want specific keys and avoid unnecessary useful when you just want specific keys and avoid unnecessary
transfers. For example, *aria2.tellStatus*("1", ["gid", "status"]) transfers. For example, *<<aria2_xmlrpc_aria2_tellStatus, aria2.tellStatus>>*("1", ["gid", "status"])
returns 'gid' and 'status' key. The response is of type struct and it returns 'gid' and 'status' key. The response is of type struct and it
contains following keys. The value type is string. contains following keys. The value type is string.
@ -1745,7 +1759,7 @@ dir::
files:: files::
Returns the list of files. The element of list is the same struct Returns the list of files. The element of list is the same struct
used in *aria2.getFiles* method. used in *<<aria2_xmlrpc_aria2_getFiles, aria2.getFiles>>* method.
bittorrent:: bittorrent::
@ -1816,6 +1830,7 @@ Get information specifying keys you are interested in:
{'completedLength': '34896138', 'gid': '1', 'totalLength': '34896138'} {'completedLength': '34896138', 'gid': '1', 'totalLength': '34896138'}
-------------------------------------------------------------------------- --------------------------------------------------------------------------
[[aria2_xmlrpc_aria2_getUris]]
*aria2.getUris* ('gid') *aria2.getUris* ('gid')
^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^
@ -1835,6 +1850,7 @@ status::
'used' if the URI is already used. 'waiting' if the URI is waiting 'used' if the URI is already used. 'waiting' if the URI is waiting
in the queue. in the queue.
[[aria2_xmlrpc_aria2_getFiles]]
*aria2.getFiles* ('gid') *aria2.getFiles* ('gid')
^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^
@ -1867,8 +1883,9 @@ selected::
uris:: uris::
Returns the list of URI for this file. The element of list is the Returns the list of URI for this file. The element of list is the
same struct used in *aria2.getUris* method. same struct used in *<<aria2_xmlrpc_aria2_getUris, aria2.getUris>>* method.
[[aria2_xmlrpc_aria2_getPeers]]
*aria2.getPeers* ('gid') *aria2.getPeers* ('gid')
^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^
@ -1919,6 +1936,7 @@ seeder::
"true" is this client is a seeder. Otherwise "false". "true" is this client is a seeder. Otherwise "false".
[[aria2_xmlrpc_aria2_getServers]]
*aria2.getServers* ('gid') *aria2.getServers* ('gid')
^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^
@ -1951,6 +1969,7 @@ servers::
Download speed (byte/sec) Download speed (byte/sec)
[[aria2_xmlrpc_aria2_tellActive]]
*aria2.tellActive* ('[keys]') *aria2.tellActive* ('[keys]')
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@ -1959,9 +1978,10 @@ Description
This method returns the list of active downloads. The response is of This method returns the list of active downloads. The response is of
type array and its element is the same struct returned by type array and its element is the same struct returned by
*aria2.tellStatus* method. For 'keys' parameter, please refer to *<<aria2_xmlrpc_aria2_tellStatus, aria2.tellStatus>>* method. For 'keys' parameter, please refer to
*aria2.tellStatus* method. *<<aria2_xmlrpc_aria2_tellStatus, aria2.tellStatus>>* method.
[[aria2_xmlrpc_aria2_tellWaiting]]
*aria2.tellWaiting* ('offset, num, [keys]') *aria2.tellWaiting* ('offset, num, [keys]')
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@ -1972,7 +1992,7 @@ This method returns the list of waiting download, including paused
downloads. 'offset' is of type integer and specifies the offset from downloads. 'offset' is of type integer and specifies the offset from
the download waiting at the front. 'num' is of type integer and the download waiting at the front. 'num' is of type integer and
specifies the number of downloads to be returned. For 'keys' specifies the number of downloads to be returned. For 'keys'
parameter, please refer to *aria2.tellStatus* method. parameter, please refer to *<<aria2_xmlrpc_aria2_tellStatus, aria2.tellStatus>>* method.
If offset is a positive integer, this method returns downloads in the If offset is a positive integer, this method returns downloads in the
range of ['offset', 'offset'+'num'). range of ['offset', 'offset'+'num').
@ -1988,8 +2008,9 @@ in this order. aria2.tellWaiting(0, 1) returns
aria2.tellWaiting(-1, 2) returns ["C", "B"]. aria2.tellWaiting(-1, 2) returns ["C", "B"].
The response is of type array and its element is the same struct The response is of type array and its element is the same struct
returned by *aria2.tellStatus* method. returned by *<<aria2_xmlrpc_aria2_tellStatus, aria2.tellStatus>>* method.
[[aria2_xmlrpc_aria2_tellStopped]]
*aria2.tellStopped* ('offset, num, [keys]') *aria2.tellStopped* ('offset, num, [keys]')
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@ -1999,14 +2020,15 @@ Description
This method returns the list of stopped download. 'offset' is of type This method returns the list of stopped download. 'offset' is of type
integer and specifies the offset from the oldest download. 'num' is of integer and specifies the offset from the oldest download. 'num' is of
type integer and specifies the number of downloads to be returned. type integer and specifies the number of downloads to be returned.
For 'keys' parameter, please refer to *aria2.tellStatus* method. For 'keys' parameter, please refer to *<<aria2_xmlrpc_aria2_tellStatus, aria2.tellStatus>>* method.
'offset' and 'num' have the same semantics as *aria2.tellWaiting* 'offset' and 'num' have the same semantics as *<<aria2_xmlrpc_aria2_tellWaiting, aria2.tellWaiting>>*
method. method.
The response is of type array and its element is the same struct The response is of type array and its element is the same struct
returned by *aria2.tellStatus* method. returned by *<<aria2_xmlrpc_aria2_tellStatus, aria2.tellStatus>>* method.
[[aria2_xmlrpc_aria2_changePosition]]
*aria2.changePosition* ('gid, pos, how') *aria2.changePosition* ('gid, pos, how')
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@ -2029,6 +2051,7 @@ For example, if GID#1 is placed in position 3, aria2.changePosition(1,
aria2.changePosition(1, 0, POS_SET) will change its position to 0(the aria2.changePosition(1, 0, POS_SET) will change its position to 0(the
beginning of the queue). beginning of the queue).
[[aria2_xmlrpc_aria2_changeUri]]
*aria2.changeUri* ('gid, fileIndex, delUris, addUris[, position]') *aria2.changeUri* ('gid, fileIndex, delUris, addUris[, position]')
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@ -2053,6 +2076,7 @@ method returns a list which contains 2 integers. The first integer is
the number of URIs deleted. The second integer is the number of URIs the number of URIs deleted. The second integer is the number of URIs
added. added.
[[aria2_xmlrpc_aria2_getOption]]
*aria2.getOption* ('gid') *aria2.getOption* ('gid')
^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^
@ -2063,6 +2087,7 @@ This method returns options of the download denoted by 'gid'. The
response is of type struct. Its key is the name of option. The value type response is of type struct. Its key is the name of option. The value type
is string. is string.
[[aria2_xmlrpc_aria2_changeOption]]
*aria2.changeOption* ('gid, options') *aria2.changeOption* ('gid, options')
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@ -2071,10 +2096,11 @@ Description
This method changes options of the download denoted by 'gid' This method changes options of the download denoted by 'gid'
dynamically. 'gid' is of type string. 'options' is of type struct dynamically. 'gid' is of type string. 'options' is of type struct
and the available options are: *bt-max-peers*, and the available options are: *<<aria2_optref_bt_max_peers, bt-max-peers>>*,
*bt-request-peer-speed-limit*, *max-download-limit* and *<<aria2_optref_bt_request_peer_speed_limit, bt-request-peer-speed-limit>>*, *<<aria2_optref_max_download_limit, max-download-limit>>* and
*max-upload-limit*. This method returns "OK" for success. *<<aria2_optref_max_upload_limit, max-upload-limit>>*. This method returns "OK" for success.
[[aria2_xmlrpc_aria2_getGlobalOption]]
*aria2.getGlobalOption* () *aria2.getGlobalOption* ()
^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^
@ -2085,8 +2111,9 @@ This method returns global options. The response is of type
struct. Its key is the name of option. The value type is string. struct. Its key is the name of option. The value type is string.
Because global options are used as a template for the options of newly Because global options are used as a template for the options of newly
added download, the response contains keys returned by added download, the response contains keys returned by
*aria2.getOption* method. *<<aria2_xmlrpc_aria2_getOption, aria2.getOption>>* method.
[[aria2_xmlrpc_aria2_changeGlobalOption]]
*aria2.changeGlobalOption* ('options') *aria2.changeGlobalOption* ('options')
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@ -2094,13 +2121,14 @@ Description
+++++++++++ +++++++++++
This method changes global options dynamically. 'options' is of type This method changes global options dynamically. 'options' is of type
struct and the available options are *max-concurrent-downloads*, struct and the available options are *<<aria2_optref_max_concurrent_downloads, max-concurrent-downloads>>*,
*max-overall-download-limit*, *max-overall-upload-limit*, *log-level* *<<aria2_optref_max_overall_download_limit, max-overall-download-limit>>*, *<<aria2_optref_max_overall_upload_limit, max-overall-upload-limit>>*, *<<aria2_optref_log_level, log-level>>*
and *log*. Using *log* option, you can dynamically start logging or and *<<aria2_optref_log, log>>*. Using *<<aria2_optref_log, log>>* option, you can dynamically start logging or
change log file. To stop logging, give empty string("") as a parameter change log file. To stop logging, give empty string("") as a parameter
value. Note that log file is always opened in append mode. This method value. Note that log file is always opened in append mode. This method
returns "OK" for success. returns "OK" for success.
[[aria2_xmlrpc_aria2_purgeDownloadResult]]
*aria2.purgeDownloadResult* () *aria2.purgeDownloadResult* ()
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@ -2110,6 +2138,7 @@ Description
This method purges completed/error/removed downloads to free memory. This method purges completed/error/removed downloads to free memory.
This method returns "OK". This method returns "OK".
[[aria2_xmlrpc_aria2_getVersion]]
*aria2.getVersion* () *aria2.getVersion* ()
^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^
@ -2144,6 +2173,7 @@ enabledFeatures::
'version': '1.10.5'} 'version': '1.10.5'}
-------------------------------------------------------------------- --------------------------------------------------------------------
[[aria2_xmlrpc_aria2_getSessionInfo]]
*aria2.getSessionInfo* () *aria2.getSessionInfo* ()
^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^
@ -2164,6 +2194,7 @@ sessionId::
{'sessionId': 'cd6a3bc6a1de28eb5bfa181e5f6b916d44af31a9'} {'sessionId': 'cd6a3bc6a1de28eb5bfa181e5f6b916d44af31a9'}
-------------------------------------------------------------------- --------------------------------------------------------------------
[[aria2_xmlrpc_aria2_shutdown]]
*aria2.shutdown* () *aria2.shutdown* ()
^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^
@ -2172,16 +2203,18 @@ Description
This method shutdowns aria2. This method returns "OK". This method shutdowns aria2. This method returns "OK".
[[aria2_xmlrpc_aria2_forceShutdown]]
*aria2.forceShutdown* () *aria2.forceShutdown* ()
^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^
Description Description
+++++++++++ +++++++++++
This method shutdowns aria2. This method behaves like *aria2.shutdown* This method shutdowns aria2. This method behaves like *<<aria2_xmlrpc_aria2_shutdown, aria2.shutdown>>*
except that any actions which takes time such as contacting BitTorrent except that any actions which takes time such as contacting BitTorrent
tracker are skipped. This method returns "OK". tracker are skipped. This method returns "OK".
[[aria2_xmlrpc_system_multicall]]
*system.multicall* ('methods') *system.multicall* ('methods')
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@ -2217,6 +2250,7 @@ Error Handling
In case of error, aria2 returns faultCode=1 and the error message in In case of error, aria2 returns faultCode=1 and the error message in
faultString. faultString.
[[aria2_xmlrpc_options]]
Options Options
~~~~~~~ ~~~~~~~
@ -2239,7 +2273,8 @@ In the option struct, name element is option name(without preceding
</struct> </struct>
------------------------------------------------- -------------------------------------------------
*header* and *index-out* option are allowed multiple times in *<<aria2_optref_header, header>>* and *<<aria2_optref_index_out, index-out>>*
option are allowed multiple times in
command-line. Since name should be unique in struct(many XML-RPC command-line. Since name should be unique in struct(many XML-RPC
library implementation uses hash or dict for struct), single string is library implementation uses hash or dict for struct), single string is
not enough. To overcome this situation, they can take array as value not enough. To overcome this situation, they can take array as value