From 3a6f39ca7a1e0b6946c4c72f7fa37dbe6c382121 Mon Sep 17 00:00:00 2001 From: ITriskTI Date: Mon, 18 Apr 2016 15:54:39 +0300 Subject: [PATCH] Update aria2c.rst --- doc/manual-src/ru/aria2c.rst | 101 ++++++++++++++++++++++++----------- 1 file changed, 70 insertions(+), 31 deletions(-) diff --git a/doc/manual-src/ru/aria2c.rst b/doc/manual-src/ru/aria2c.rst index 620a4ace..aaa6156b 100644 --- a/doc/manual-src/ru/aria2c.rst +++ b/doc/manual-src/ru/aria2c.rst @@ -108,7 +108,7 @@ HTTP(S)/FTP, они тут же могут выгружаться в BitTorrent- Смотрите также раздел `ОКРУЖЕНИЕ`_. .. note:: - + Если пользователь и пароль вставлены в URI-прокси и они также указаны в параметрах *--{http,https,ftp,all}-proxy-{user,passwd}*, то те, которые указаны позже переопределят предыдущие параметры. @@ -223,7 +223,7 @@ HTTP(S)/FTP, они тут же могут выгружаться в BitTorrent- включена. .. note:: - + Файл netrc считывается только при запуске, если :option:`--no-netrc <-n>` задан как ``false``. Так что если :option:`--no-netrc <-n>` задан как ``true`` при загрузке, то netrc недоступен на протяжении всей сессии. Вы не сможете получить @@ -322,7 +322,7 @@ HTTP(S)/FTP, они тут же могут выгружаться в BitTorrent- По умолчанию: ``5`` .. note:: - + Некоторые Metalink регламентируют количество серверов для соединения. aria2 строго соблюдает это. Это значит, что если Metalink определяет атрибут ``maxconnections`` меньше чем N, то aria2 использует это, более низкое @@ -436,7 +436,7 @@ HTTP(S)/FTP, они тут же могут выгружаться в BitTorrent- По умолчанию: 'false .. note:: - + Некоторые серверы отвечают ``Content-Encoding: gzip`` для файлов, которые сами по себе сжаты (gzipped). aria2 добавляет их, так или иначе, из-за заголовка ответа. @@ -523,7 +523,7 @@ HTTP(S)/FTP, они тут же могут выгружаться в BitTorrent- По умолчанию: ``false`` .. note:: - + С точки зрения производительности, как правило, нет преимущества от включения этого параметра. @@ -995,7 +995,7 @@ HTTP(S)/FTP, они тут же могут выгружаться в BitTorrent- Смотрите также параметр :option:`--seed-ratio`. .. note:: - + Указанный :option:`--seed-time=0 <--seed-time>` отключает сидирование после завершения загрузки. @@ -1053,7 +1053,7 @@ HTTP(S)/FTP, они тут же могут выгружаться в BitTorrent- Указать предпочитаемый протокол. Возможные значения: ``http``, ``https``, ``ftp`` и ``none``. Указать ``none`` для отключения этой возможности. По умолчанию: ``none`` - + .. option:: --metalink-enable-unique-protocol[=true|false] Если задано ``true``, а в metalink-файле доступно несколько @@ -1580,7 +1580,7 @@ HTTP(S)/FTP, они тут же могут выгружаться в BitTorrent- По умолчанию: ``1M`` .. note:: - + Возможный вариант использования параметра :option:`--piece-length` - изменение диапазона запроса в одном конвейерном HTTP-запросе. Для включения конвейерной обработки HTTP используйте @@ -1728,7 +1728,7 @@ HTTP(S)/FTP, они тут же могут выгружаться в BitTorrent- Укорачивать консольный индикатор, чтобы он поместился в одну строку. По умолчанию: ``true`` - + .. option:: -v, --version Вывести номер версии, информацию об авторских @@ -1990,7 +1990,7 @@ aria2 распознает следующие переменные окруже переменную. .. note:: - + Несмотря на то, что aria2 допускает ``ftp://`` и ``https://`` схемы прокси в URI, она просто предполагает, что определен ``http://`` и не меняет своего поведения, основанного на определенной схеме. @@ -2220,7 +2220,7 @@ URI. Эти дополнительные строки должны начина * :option:`uri-selector <--uri-selector>` * :option:`use-head <--use-head>` * :option:`user-agent <-U>` - + Эти параметры имеют точно такой же смысл, что параметры командной строки, но это применимо только к URI, к которым они принадлежат. Обратите внимание, что параметры во входном файле не должны иметь префикс ``--``. @@ -2371,9 +2371,9 @@ RPC-метод `system.multicall` обрабатывается особым об против RPC-интерфейса. Поэтому рекомендуется отдавать предпочтение пакетным или `system.multicall` запросам, когда это необходимо. - `system.listMethods` может выполняться без секретного маркера. Так он - просто возвращает все доступные методы, и ничего не изменяет, это - безопасно без секретного маркера. + `system.listMethods` и `system.listNotifications` могут выполняться без секретного маркера. Так они + просто возвращает доступные методы/уведомления, и ничего не изменяют, они + безопасны без секретного маркера. Методы ~~~~~~ @@ -2723,6 +2723,15 @@ RPC-метод `system.multicall` обрабатывается особым об ``name`` имя в разделе info. Используется ``name.utf-8``, если доступно. + ``verifiedLength`` + Количество проверенных байт во время проверки хэша. Это поле + появляется только тогда, когда загрузка начинает проверять хэш. + + ``verifyIntegrityPending`` + ``true`` - если эта загрузка ожидает в очереди проверки хэша. + Это поле появляется только тогда, когда эта загрузка находится + в очереди. + **Пример JSON-RPC** Следующий пример получает информацию о загрузке с GID#2089b05ecca3d829:: @@ -3607,6 +3616,36 @@ RPC-метод `system.multicall` обрабатывается особым об >>> s.system.listMethods() ['aria2.addUri', 'aria2.addTorrent', ... +.. function:: system.listNotifications() + + Этот метод возвращает все доступные RPC-методы в массиве строк. + В отличие от других методов, этот метод не требует секретный маркер. + Это безопасно, потому что этот метод просто возвращает названия доступных + уведомлений. + + **Пример JSON-RPC** + :: + + >>> import urllib2, json + >>> from pprint import pprint + >>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer', + ... 'method':'system.listNotifications'}) + >>> 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.onDownloadStart', + u'aria2.onDownloadPause', + ... + + **Пример XML-RPC** + :: + + >>> import xmlrpclib + >>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc') + >>> s.system.listNotifications() + ['aria2.onDownloadStart', 'aria2.onDownloadPause', ... + Обработка ошибок ~~~~~~~~~~~~~~~~ @@ -3767,49 +3806,49 @@ RPC-сервер может отправлять уведомления клие Это уведомление будет оправлено, когда загрузка запущена. Параметр *event* имеет тип структура и содержит следующие ключи. Ключ имеет тип строка. - + ``gid`` GID загрузки. - + .. function:: aria2.onDownloadPause(event) Это уведомление будет оправлено, когда загрузка приостановлена. *event* - такая же структура, как параметр *event* в методе :func:`aria2.onDownloadStart`. - + .. function:: aria2.onDownloadStop(event) Это уведомление будет оправлено, когда загрузка остановлена пользователем. *event* - такая же структура, как параметр *event* в методе :func:`aria2.onDownloadStart`. - + .. function:: aria2.onDownloadComplete(event) - + Это уведомление будет оправлено, когда загрузка завершена. Для BitTorrent-загрузок, это уведомление отправляется, когда загрузка завершена и сидирование окончено. *event* - такая же структура, как параметр *event* в методе :func:`aria2.onDownloadStart`. - + .. function:: aria2.onDownloadError(event) - + Это уведомление будет оправлено, когда загрузка остановлена из-за ошибки. *event* - такая же структура, как параметр *event* в методе :func:`aria2.onDownloadStart`. - + .. function:: aria2.onBtDownloadComplete(event) - + Это уведомление будет оправлено, когда torrent-загрузка завершена, но сидирование продолжается. *event* - такая же структура, как параметр *event* в методе :func:`aria2.onDownloadStart`. - + Пример кода XML-RPC-клиента ~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -3820,15 +3859,15 @@ RPC-сервер может отправлять уведомления клие .. code-block:: ruby #!/usr/bin/env ruby - + require 'xmlrpc/client' require 'pp' - + client=XMLRPC::Client.new2("http://localhost:6800/rpc") - + options={ "dir" => "/downloads" } result=client.call("aria2.addUri", [ "http://localhost/aria2.tar.bz2" ], options) - + pp result @@ -3837,7 +3876,7 @@ RPC-сервер может отправлять уведомления клие import xmlrpclib from pprint import pprint - + s = xmlrpclib.ServerProxy("http://localhost:6800/rpc") r = s.aria2.addUri(["http://localhost/aria2.tar.bz2"], {"dir":"/downloads"}) pprint(r) @@ -3972,7 +4011,7 @@ Checksum $ aria2c --ftp-proxy="http://proxy:8080" "ftp://host/file" .. note:: - + Смотрите для подробностей :option:`--http-proxy`, :option:`--https-proxy`, :option:`--ftp-proxy`, :option:`--all-proxy` и @@ -4306,7 +4345,7 @@ RPC $ aria2c -V file.metalink .. note:: - + При использовании BitTorrent или Metalink с контрольными суммами блоков данных можно эффективно исправлять поврежденные загрузки.