Merge pull request #548 from ITriskTI/patch-2

Update aria2c.rst
pull/558/head
Tatsuhiro Tsujikawa 2016-01-29 21:12:03 +09:00
commit 0b7ee8be21
1 changed files with 50 additions and 3 deletions

View File

@ -44,7 +44,7 @@ HTTP(S)/FTP, они тут же могут выгружаться в BitTorrent-
Входной файл может использовать gzip-сжатие.
Смотрите подраздел `Входной файл`_ для детальных пояснений.
Также смотрите параметр :option:`--deferred-input`.
Также смотрите параметр :option:`--save-session-file`.
Также смотрите параметр :option:`--save-session`.
.. option:: -l, --log=<LOG>
@ -181,7 +181,10 @@ HTTP(S)/FTP, они тут же могут выгружаться в BitTorrent-
удаленных HTTP/FTP-серверов NUM раз без получения, хотя бы одного байта,
тогда принудительно отказывается от загрузки. Укажите ``0``, чтобы
отключить этот параметр. Этот параметр действенен только, когда
используются HTTP/FTP-серверы.
используются HTTP/FTP-серверы. Количество повторных попыток засчитывается в
:option:`--max-tries`, таким образом, этот параметр также должен быть
сконфигурирован.
По умолчанию: ``0``
.. option:: -m, --max-tries=<N>
@ -1457,6 +1460,15 @@ HTTP(S)/FTP, они тут же могут выгружаться в BitTorrent-
загрузок. Значение 0 отключит сохранение результата загрузки.
По умолчанию: ``1000``
.. option:: --max-mmap-limit=<SIZE>
Задать максимальный размер файла для включения mmap (см. параметр
:option:`--enable-mmap`). Размер файла определяется по сумме всех файлов,
содержащихся в одной загрузке. Например, если загрузка содержит 5 файлов, то
размер файла - это суммарный размер этих файлов. Если размер файла строго больше
чем размер, указанный в этом параметре, то mmap будет отключён.
По умолчанию: ``9223372036854775807``
.. option:: --max-resume-failure-tries=<N>
Если параметр :option:`--always-resume=false, <--always-resume>` aria2
@ -2147,6 +2159,7 @@ URI. Эти дополнительные строки должны начина
* :option:`max-connection-per-server <-x>`
* :option:`max-download-limit <--max-download-limit>`
* :option:`max-file-not-found <--max-file-not-found>`
* :option:`max-mmap-limit <--max-mmap-limit>`
* :option:`max-resume-failure-tries <--max-resume-failure-tries>`
* :option:`max-tries <-m>`
* :option:`max-upload-limit <-u>`
@ -2336,6 +2349,10 @@ RPC-метод `system.multicall` обрабатывается особым об
против RPC-интерфейса. Поэтому рекомендуется отдавать предпочтение пакетным
или `system.multicall` запросам, когда это необходимо.
`system.listMethods` может выполняться без секретного маркера. Так он
просто возвращает все доступные методы, и ничего не изменяет, это
безопасно без секретного маркера.
Методы
~~~~~~
@ -2801,7 +2818,7 @@ RPC-метод `system.multicall` обрабатывается особым об
.. function:: aria2.getFiles([secret], gid)
Этот метод возвращает список файлов загрузки, которая обозначена *gid* (строка).
Ответ - это массив и содержит следующие ключи.
Ответ - это массив структур, которые содержат следующие ключи.
Значения являются строками.
``index``
@ -3529,6 +3546,36 @@ RPC-метод `system.multicall` обрабатывается особым об
>>> tuple(r)
('2089b05ecca3d829', 'd2703803b52216d1')
.. function:: system.listMethods()
Этот метод возвращает все доступные RPC-методы в массиве строк.
В отличие от других методов, этот метод не требует секретный маркер.
Это безопасно, потому что этот метод просто возвращает названия доступных
методов.
**Пример JSON-RPC**
::
>>> import urllib2, json
>>> from pprint import pprint
>>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer',
... 'method':'system.listMethods'})
>>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
>>> pprint(json.loads(c.read()))
{u'id': u'qwer',
u'jsonrpc': u'2.0',
u'result': [u'aria2.addUri',
u'aria2.addTorrent',
...
**Пример XML-RPC**
::
>>> import xmlrpclib
>>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc')
>>> s.system.listMethods()
['aria2.addUri', 'aria2.addTorrent', ...
Обработка ошибок
~~~~~~~~~~~~~~~~