fixed some bugs

pull/16/head
ITriskTI 2012-04-23 03:24:30 +03:00
parent 003aaf4a09
commit 3c5753baf2
1 changed files with 143 additions and 145 deletions

View File

@ -30,7 +30,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
Загрузить URI, найденные в файле FILE. Вы можете указать несколько URI для одного Загрузить URI, найденные в файле FILE. Вы можете указать несколько URI для одного
объекта: разделяйте URI в строке, используя символ TAB (табуляция). Когда объекта: разделяйте URI в строке, используя символ TAB (табуляция). Когда
указано ``-`` , ввод считывается из stdin (стандартный поток ввода). Дополнительные указано ``-``, ввод считывается из stdin (стандартный поток ввода). Дополнительные
параметры можно указывать после каждой строки с URI. Эта необязательная строка параметры можно указывать после каждой строки с URI. Эта необязательная строка
должна начинаться с одного или нескольких пробелов и содержать один параметр. должна начинаться с одного или нескольких пробелов и содержать один параметр.
Смотрите подраздел `Входной файл`_ для детальных пояснений. Смотрите подраздел `Входной файл`_ для детальных пояснений.
@ -38,7 +38,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. option:: -l, --log=<LOG> .. option:: -l, --log=<LOG>
Имя файла для журнала событий. Если указан ``-`` , то журнал событий будет Имя файла для журнала событий. Если указан ``-``, то журнал событий будет
записан в stdout (стандартный поток вывода). Если указана пустая записан в stdout (стандартный поток вывода). Если указана пустая
строка (""), то журнал событий не будет записан в файл. строка (""), то журнал событий не будет записан в файл.
@ -77,10 +77,10 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
с ``#``. Например, ``--help=#http`` даст справку по параметрам, с ``#``. Например, ``--help=#http`` даст справку по параметрам,
помеченным меткой ``#http``. Если задано слово (KEYWORD), не помеченным меткой ``#http``. Если задано слово (KEYWORD), не
являющееся меткой, то будет выведена справка по параметрам, являющееся меткой, то будет выведена справка по параметрам,
содержащих это слово. Возможные значения: ``#basic`` , ``#advanced`` , содержащих это слово. Возможные значения: ``#basic``, ``#advanced``,
``#http`` , ``#https`` , ``#ftp`` , ``#metalink`` , ``#bittorrent`` , ``#cookie`` , ``#http``, ``#https``, ``#ftp``, ``#metalink``, ``#bittorrent``, ``#cookie``,
``#hook`` , ``#file`` , ``#rpc`` , ``#checksum`` , ``#experimental`` , ``#hook``, ``#file``, ``#rpc``, ``#checksum``, ``#experimental``,
``#deprecated`` , ``#help`` , ``#all``. ``#deprecated``, ``#help``, ``#all``.
По умолчанию: ``#basic`` По умолчанию: ``#basic``
Параметры HTTP/FTP Параметры HTTP/FTP
@ -143,7 +143,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. option:: --dry-run[=true|false] .. option:: --dry-run[=true|false]
Если задано ``true`` , aria2 только проверяет, является ли удаленный Если задано ``true``, aria2 только проверяет, является ли удаленный
файл доступным и не загружает данные. Этот параметр влияет на файл доступным и не загружает данные. Этот параметр влияет на
HTTP/FTP-загрузку. BitTorrent-загрузки отменяются, если указано HTTP/FTP-загрузку. BitTorrent-загрузки отменяются, если указано
``true``. ``true``.
@ -168,7 +168,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
Если aria2 получает статус "file not found" (файл не найден) с Если aria2 получает статус "file not found" (файл не найден) с
удаленных HTTP/FTP-серверов NUM раз без получения, хотя бы одного байта, удаленных HTTP/FTP-серверов NUM раз без получения, хотя бы одного байта,
тогда принудительно отказывается от загрузки. Укажите ``0`` , чтобы тогда принудительно отказывается от загрузки. Укажите ``0``, чтобы
отключить этот параметр. Этот параметр действенен только, когда отключить этот параметр. Этот параметр действенен только, когда
используются HTTP/FTP-серверы. используются HTTP/FTP-серверы.
По умолчанию: ``0`` По умолчанию: ``0``
@ -199,9 +199,10 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. note:: .. note::
Файл netrc считывается только при запуске, если :option:`--no-netrc <-n>` задан как ``false``. Так что если :option:`--no-netrc <-n>` задан как ``true`` при загрузке, то netrc недоступен на Файл netrc считывается только при запуске, если :option:`--no-netrc <-n>` задан
протяжении всей сессии. Вы не сможете получить доступ к netrc, даже если как ``false``. Так что если :option:`--no-netrc <-n>` задан как ``true`` при
отправите :option:`--no-netrc=false, <-n>` используя загрузке, то netrc недоступен на протяжении всей сессии. Вы не сможете получить
доступ к netrc, даже если отправите :option:`--no-netrc=false, <-n>` используя
:func:`aria2.changeGlobalOption`. :func:`aria2.changeGlobalOption`.
.. option:: --no-proxy=<DOMAINS> .. option:: --no-proxy=<DOMAINS>
@ -237,7 +238,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. option:: --proxy-method=<METHOD> .. option:: --proxy-method=<METHOD>
Задать метод для использования в прокси-запросах. METHOD один Задать метод для использования в прокси-запросах. METHOD один
из двух: ``get`` или ``tunnel``. HTTPS-загрузки всегда используют ``tunnel`` , из двух: ``get`` или ``tunnel``. HTTPS-загрузки всегда используют ``tunnel``,
не обращая внимания на этот параметр. не обращая внимания на этот параметр.
По умолчанию: ``get`` По умолчанию: ``get``
@ -306,10 +307,10 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
Указать алгоритм выбора блока, который используется в HTTP/FTP-загрузке. Указать алгоритм выбора блока, который используется в HTTP/FTP-загрузке.
Блок - означает сегмент фиксированной длины, который загружается Блок - означает сегмент фиксированной длины, который загружается
параллельно, в разделенной на части, загрузке. Если задано ``default`` , параллельно, в разделенной на части, загрузке. Если задано ``default``,
то aria2 выберет блок так, чтобы это уменьшило количество установленных то aria2 выберет блок так, чтобы это уменьшило количество установленных
подключений. Это разумное поведение по умолчанию, поскольку установка подключений. Это разумное поведение по умолчанию, поскольку установка
подключения очень затратная операция. Если задано ``inorder`` , то aria2 подключения очень затратная операция. Если задано ``inorder``, то aria2
выберет блок, который имеет минимальный индекс. Index=0 означает первый выберет блок, который имеет минимальный индекс. Index=0 означает первый
из файла. Это будет полезно при просмотре фильма, в то время как он из файла. Это будет полезно при просмотре фильма, в то время как он
загружается. Параметр загружается. Параметр
@ -319,8 +320,8 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
:option:`--min-split-size <-k>`, так что необходимо :option:`--min-split-size <-k>`, так что необходимо
будет указать разумное значение параметра будет указать разумное значение параметра
:option:`--min-split-size <-k>`. :option:`--min-split-size <-k>`.
Если задано ``geom`` , то aria2 вначале выберет блок с минимальным Если задано ``geom``, то aria2 вначале выберет блок с минимальным
индексом, как при ``inorder`` , однако она сохранит индексом, как при ``inorder``, однако она сохранит
экспоненциально большую область от ранее выбранного блока. экспоненциально большую область от ранее выбранного блока.
Это уменьшит количество установленных подключений и в то же Это уменьшит количество установленных подключений и в то же
время это позволит в первую очередь загрузить начало файла. время это позволит в первую очередь загрузить начало файла.
@ -335,20 +336,20 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. option:: --uri-selector=<SELECTOR> .. option:: --uri-selector=<SELECTOR>
Указать алгоритм выбора URI. Возможные значения: ``inorder`` , ``feedback`` Указать алгоритм выбора URI. Возможные значения: ``inorder``, ``feedback``
и ``adaptive``. Если задано ``inorder`` , то URI проверяются в порядке и ``adaptive``. Если задано ``inorder``, то URI проверяются в порядке
представления в списке URI. Если задано ``feedback`` , aria2 использует представления в списке URI. Если задано ``feedback``, aria2 использует
скорость загрузки, которая наблюдалась в предыдущих загрузках, и выбирает скорость загрузки, которая наблюдалась в предыдущих загрузках, и выбирает
самый быстрый сервер в списке URI. Это также эффективно исключает мертвые самый быстрый сервер в списке URI. Это также эффективно исключает мертвые
зеркала. Наблюдаемая скорость загрузки является частью профиля зеркала. Наблюдаемая скорость загрузки является частью профиля
функционирования сервера, упомянутой в параметрах функционирования сервера, упомянутой в параметрах
:option:`--server-stat-of` и :option:`--server-stat-of` и
:option:`--server-stat-if`. Если задано ``adaptive`` , :option:`--server-stat-if`. Если задано ``adaptive``,
выбирается одно из лучших зеркал для первого и резервного соединений. выбирается одно из лучших зеркал для первого и резервного соединений.
Дополнительно, возвращаются зеркала, которые пока не были проверены, и, Дополнительно, возвращаются зеркала, которые пока не были проверены, и,
если каждое из них уже проверено, возвращаются зеркала, которые должны если каждое из них уже проверено, возвращаются зеркала, которые должны
быть проверены снова. Иначе зеркала больше не выбираются. быть проверены снова. Иначе зеркала больше не выбираются.
Подобно ``feedback`` , используются профиль функционирования сервера. Подобно ``feedback``, используются профиль функционирования сервера.
По умолчанию: ``feedback`` По умолчанию: ``feedback``
Специфические параметры HTTP Специфические параметры HTTP
@ -390,7 +391,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. option:: --http-auth-challenge[=true|false] .. option:: --http-auth-challenge[=true|false]
Отправлять заголовок HTTP-авторизации только тогда, когда он запрошен Отправлять заголовок HTTP-авторизации только тогда, когда он запрошен
с сервера. Если задано ``false`` , тогда заголовок авторизации всегда с сервера. Если задано ``false``, тогда заголовок авторизации всегда
отправляется на сервер. Существует исключение: если имя пользователя отправляется на сервер. Существует исключение: если имя пользователя
и пароль являются встроенными в URI, то заголовок авторизации всегда и пароль являются встроенными в URI, то заголовок авторизации всегда
отправляется на сервер, независимо от этого параметра. отправляется на сервер, независимо от этого параметра.
@ -399,7 +400,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. option:: --http-no-cache[=true|false] .. option:: --http-no-cache[=true|false]
Отправлять заголовок Cache-Control: no-cache и Pragma: no-cache, Отправлять заголовок Cache-Control: no-cache и Pragma: no-cache,
чтобы избежать кэширования содержимого. Если задано ``false`` , то эти чтобы избежать кэширования содержимого. Если задано ``false``, то эти
заголовки не посылаются, и вы можете добавить любую директиву к заголовки не посылаются, и вы можете добавить любую директиву к
заголовку Cache-Control с помощью параметра заголовку Cache-Control с помощью параметра
:option:`--header`. :option:`--header`.
@ -504,7 +505,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. option:: -U, --user-agent=<USER_AGENT> .. option:: -U, --user-agent=<USER_AGENT>
Задать клиентское приложение для HTTP(S)-загрузок. Задать клиентское приложение для HTTP(S)-загрузок.
По умолчанию: ``aria2/$VERSION`` , $VERSION заменяется на версию пакета. По умолчанию: ``aria2/$VERSION``, $VERSION заменяется на версию пакета.
Специфические параметры FTP Специфические параметры FTP
~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -524,7 +525,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. option:: -p, --ftp-pasv[=true|false] .. option:: -p, --ftp-pasv[=true|false]
Использовать пассивный режим FTP. Если задано ``false`` , Использовать пассивный режим FTP. Если задано ``false``,
то будет использован активный режим. то будет использован активный режим.
По умолчанию: ``true`` По умолчанию: ``true``
@ -607,7 +608,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. option:: --bt-hash-check-seed[=true|false] .. option:: --bt-hash-check-seed[=true|false]
Если задано ``true`` , то после проверки хэша с использованием параметра Если задано ``true``, то после проверки хэша с использованием параметра
:option:`--check-integrity <-V>`, и когда файл :option:`--check-integrity <-V>`, и когда файл
загружен полностью, продолжается раздача файла. Если вы хотите загружен полностью, продолжается раздача файла. Если вы хотите
проверить файл и загрузить его только если он поврежден или не загружен проверить файл и загрузить его только если он поврежден или не загружен
@ -675,7 +676,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. option:: --bt-require-crypto[=true|false] .. option:: --bt-require-crypto[=true|false]
Если задано ``true`` , aria2 не принимает и не устанавливает соединение с Если задано ``true``, aria2 не принимает и не устанавливает соединение с
унаследованным BitTorrent handshake-сообщением (рукопожатие) унаследованным BitTorrent handshake-сообщением (рукопожатие)
(BitTorrent протокол). Таким образом, aria2 всегда использует обфускацию (BitTorrent протокол). Таким образом, aria2 всегда использует обфускацию
handshake-сообщения. handshake-сообщения.
@ -709,7 +710,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. option:: --bt-stop-timeout=<SEC> .. option:: --bt-stop-timeout=<SEC>
Остановить BitTorrent загрузку, если скорость загрузки равна 0 на Остановить BitTorrent загрузку, если скорость загрузки равна 0 на
протяжении SEC секунд. Если задано ``0`` , то эта возможность не будет протяжении SEC секунд. Если задано ``0``, то эта возможность не будет
использоваться. использоваться.
По умолчанию: ``0`` По умолчанию: ``0``
@ -735,7 +736,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
Задать интервал в секундах между запросами трекера. Это полностью Задать интервал в секундах между запросами трекера. Это полностью
отменяет значение интервала и aria2 использует только это значение отменяет значение интервала и aria2 использует только это значение
и игнорирует минимальный интервал и значение интервала в ответе и игнорирует минимальный интервал и значение интервала в ответе
трекера. Если задан ``0`` , aria2 определяет интервал, основываясь на трекера. Если задан ``0``, aria2 определяет интервал, основываясь на
ответе трекера и прогрессе загрузки. ответе трекера и прогрессе загрузки.
По умолчанию: ``0`` По умолчанию: ``0``
@ -809,11 +810,11 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. option:: --follow-torrent=true|false|mem .. option:: --follow-torrent=true|false|mem
Если указать ``true`` или ``mem`` , тогда загруженный файл, расширение Если указать ``true`` или ``mem``, тогда загруженный файл, расширение
которого - ``.torrent`` или mime-тип - ``application/x-bittorrent``, которого - ``.torrent`` или mime-тип - ``application/x-bittorrent``,
aria2 анализирует как torrent-файл и загружает файлы, указанные в нем. aria2 анализирует как torrent-файл и загружает файлы, указанные в нем.
Если указано ``mem`` , тогда torrent-файл не записывается на диск, Если указано ``mem``, тогда torrent-файл не записывается на диск,
а содержится в памяти. Если указано ``false`` , действия, упомянутые а содержится в памяти. Если указано ``false``, действия, упомянутые
выше, не совершаются. выше, не совершаются.
По умолчанию: ``true`` По умолчанию: ``true``
@ -863,13 +864,13 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
то только первые 20 будут использоваться, если будет то только первые 20 будут использоваться, если будет
указано меньше 20, то они будут дополнены случайными указано меньше 20, то они будут дополнены случайными
данными до 20 байт. данными до 20 байт.
По умолчанию: ``aria2/$VERSION`` , $VERSION заменяется на версию пакета. По умолчанию: ``aria2/$VERSION``, $VERSION заменяется на версию пакета.
.. option:: --seed-ratio=<RATIO> .. option:: --seed-ratio=<RATIO>
Указать рейтинг. Сидировать завершенные торренты, пока рейтинг Указать рейтинг. Сидировать завершенные торренты, пока рейтинг
не станет больше RATIO. Очень рекомендуется указать тут равный не станет больше RATIO. Очень рекомендуется указать тут равный
или больший ``1.0``. Указать ``0.0`` , если вы планируете сидировать или больший ``1.0``. Указать ``0.0``, если вы планируете сидировать
независимо от рейтинга. Если указан параметр независимо от рейтинга. Если указан параметр
:option:`--seed-time` вместе с этим :option:`--seed-time` вместе с этим
параметром, сидирование закончится тогда, когда хотя бы одно параметром, сидирование закончится тогда, когда хотя бы одно
@ -898,8 +899,8 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
Если указано ``true`` или ``mem`` и когда загруженный файл имеет расширение Если указано ``true`` или ``mem`` и когда загруженный файл имеет расширение
``.meta4`` или ``.metalink``, или mime-тип ``application/metalink4+xml`` ``.meta4`` или ``.metalink``, или mime-тип ``application/metalink4+xml``
или ``application/metalink+xml``, aria2 считает его metalink-файлом и или ``application/metalink+xml``, aria2 считает его metalink-файлом и
загружает упомянутые в нем файлы. Если указано ``mem`` , то metalink-файл загружает упомянутые в нем файлы. Если указано ``mem``, то metalink-файл
не сохраняется на диск, а просто хранится в памяти. Если указано ``false`` , не сохраняется на диск, а просто хранится в памяти. Если указано ``false``,
то вышеприведенная операция не производится. то вышеприведенная операция не производится.
По умолчанию: ``true`` По умолчанию: ``true``
@ -935,13 +936,13 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. option:: --metalink-preferred-protocol=<PROTO> .. option:: --metalink-preferred-protocol=<PROTO>
Указать предпочитаемый протокол. Возможные значения: ``http`` , ``https`` , ``ftp`` Указать предпочитаемый протокол. Возможные значения: ``http``, ``https``, ``ftp``
и ``none``. Указать ``none`` для отключения этой возможности. и ``none``. Указать ``none`` для отключения этой возможности.
По умолчанию: ``none`` По умолчанию: ``none``
.. option:: --metalink-enable-unique-protocol[=true|false] .. option:: --metalink-enable-unique-protocol[=true|false]
Если задано ``true`` , а в metalink-файле доступно несколько Если задано ``true``, а в metalink-файле доступно несколько
протоколов, то aria2 использует один из них. Используйте параметр протоколов, то aria2 использует один из них. Используйте параметр
:option:`--metalink-preferred-protocol`, :option:`--metalink-preferred-protocol`,
чтобы указать предпочитаемый протокол. чтобы указать предпочитаемый протокол.
@ -973,7 +974,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. option:: --rpc-listen-all[=true|false] .. option:: --rpc-listen-all[=true|false]
Слушать входящие JSON-RPC/XML-RPC-запросы на всех сетевых интерфейсах. Слушать входящие JSON-RPC/XML-RPC-запросы на всех сетевых интерфейсах.
Если указано ``false`` , слушать только на локальном петлевом Если указано ``false``, слушать только на локальном петлевом
интерфейсе (loopback). интерфейсе (loopback).
По умолчанию: ``false`` По умолчанию: ``false``
@ -1009,21 +1010,20 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. option:: --allow-piece-length-change[=true|false] .. option:: --allow-piece-length-change[=true|false]
Если задано ``false`` , aria2 прерывает загрузку, когда длина блока Если задано ``false``, aria2 прерывает загрузку, когда длина блока
отлична от той, которая находится в контрольном файле. Если задано отлична от той, которая находится в контрольном файле. Если задано
``true`` , вы можете продолжать, однако некоторый прогресс загрузки ``true``, вы можете продолжать, однако некоторый прогресс загрузки
будет потерян. будет потерян.
По умолчанию: ``false`` По умолчанию: ``false``
.. option:: --always-resume[=true|false] .. option:: --always-resume[=true|false]
Всегда возобновлять загрузку. Если задано ``true`` , aria2 всегда пытается Всегда возобновлять загрузку. Если задано ``true``, aria2 всегда пытается
возобновить загрузку и если это не возможно, прерывает ее. возобновить загрузку и если это не возможно, прерывает ее.
Если задано ``false`` , тогда для всех заданных URI не поддерживается Если задано ``false``, тогда для всех заданных URI не поддерживается
возобновление загрузки, или aria2 столкнется с невозможностью возобновление загрузки, или aria2 столкнется с невозможностью
возобновления загрузки URI ``N`` -ое количество раз возобновления загрузки URI ``N``-ое количество раз
(значение ``N`` указывается в параметре (значение ``N`` указывается в параметре :option:`--max-resume-failure-tries`,
то aria2 будет загружать файл с нуля. Смотрите параметр то aria2 будет загружать файл с нуля. Смотрите параметр
:option:`--max-resume-failure-tries`. :option:`--max-resume-failure-tries`.
По умолчанию: ``true`` По умолчанию: ``true``
@ -1053,7 +1053,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. option:: --auto-save-interval=<SEC> .. option:: --auto-save-interval=<SEC>
Сохранять контрольный файл (\*.aria2) каждые SEC секунд. Сохранять контрольный файл (\*.aria2) каждые SEC секунд.
Если задано ``0`` , тогда контрольный файл не сохраняется на Если задано ``0``, тогда контрольный файл не сохраняется на
протяжении загрузки. aria2 сохраняет контрольный файл тогда, протяжении загрузки. aria2 сохраняет контрольный файл тогда,
когда останавливается, не смотря на значение. когда останавливается, не смотря на значение.
Возможные значения: от ``0`` до ``600``. Возможные значения: от ``0`` до ``600``.
@ -1083,17 +1083,17 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. option:: -D, --daemon[=true|false] .. option:: -D, --daemon[=true|false]
Запустить как демон (фоновый процесс). Текущий рабочий каталог Запустить как демон (фоновый процесс). Текущий рабочий каталог
будет заменен на ``/`` , а стандартный ввод, стандартный вывод, будет заменен на ``/``, а стандартный ввод, стандартный вывод,
стандартный вывод ошибок будут перенаправлены на ``/dev/null``. стандартный вывод ошибок будут перенаправлены на ``/dev/null``.
По умолчанию: ``false`` По умолчанию: ``false``
.. option:: --deferred-input[=true|false] .. option:: --deferred-input[=true|false]
Если задано ``true`` , aria2 при запуске не считывает все URI и параметры Если задано ``true``, aria2 при запуске не считывает все URI и параметры
из файла, указанного в параметре :option:`--input-file <-i>`, а из файла, указанного в параметре :option:`--input-file <-i>`, а
считывает их позже отдельно, когда это нужно. Это может сократить считывает их позже отдельно, когда это нужно. Это может сократить
использование памяти, если во входном файле содержится много URI для использование памяти, если во входном файле содержится много URI для
загрузки. Если задано ``false`` , aria2 при запуске считывает все URI загрузки. Если задано ``false``, aria2 при запуске считывает все URI
и параметры. и параметры.
По умолчанию: ``false`` По умолчанию: ``false``
@ -1106,9 +1106,9 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. option:: --download-result=<OPT> .. option:: --download-result=<OPT>
Этот параметр изменяет формат сообщения ``Результаты загрузки``. Если OPT Этот параметр изменяет формат сообщения ``Результаты загрузки``. Если OPT
задан как ``default`` , то отображается GID, статус, средняя скорость загрузки и задан как ``default``, то отображается GID, статус, средняя скорость загрузки и
путь/URI. Если загружается множество файлов, то отобразиться путь/URI первого путь/URI. Если загружается множество файлов, то отобразиться путь/URI первого
запрашиваемого файла, а остальные пропускаются. Если OPT задан как ``full`` , запрашиваемого файла, а остальные пропускаются. Если OPT задан как ``full``,
то отображается GID, статус, средняя скорость загрузки, процент прогресса и то отображается GID, статус, средняя скорость загрузки, процент прогресса и
путь/URI. Процент прогресса и путь/URI отобразиться для каждого путь/URI. Процент прогресса и путь/URI отобразиться для каждого
запрашиваемого файла в отдельной строке. запрашиваемого файла в отдельной строке.
@ -1123,8 +1123,8 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. option:: --event-poll=<POLL> .. option:: --event-poll=<POLL>
Указать метод опроса событий. Возможные значения: ``epoll`` , ``kqueue`` , Указать метод опроса событий. Возможные значения: ``epoll``, ``kqueue``,
``port`` , ``poll`` и ``select``. Каждый метод ``epoll`` , ``kqueue`` , ``port`` и ``port``, ``poll`` и ``select``. Каждый метод ``epoll``, ``kqueue``, ``port`` и
``poll`` доступен, если система поддерживает его. ``epoll`` доступен в ``poll`` доступен, если система поддерживает его. ``epoll`` доступен в
современных дистрибутивах Linux. ``kqueue`` доступен в различных современных дистрибутивах Linux. ``kqueue`` доступен в различных
\*BSD-системах, включая Mac OS X. ``port`` доступен в Open Solaris. \*BSD-системах, включая Mac OS X. ``port`` доступен в Open Solaris.
@ -1142,17 +1142,17 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
Так как они резервируют место под большие (на несколько Гигабайт) файлы Так как они резервируют место под большие (на несколько Гигабайт) файлы
почти мгновенно. Не используйте ``falloc`` вместе с наследными файловыми почти мгновенно. Не используйте ``falloc`` вместе с наследными файловыми
системами, такими как ext3 и FAT32, потому что это будет продолжаться системами, такими как ext3 и FAT32, потому что это будет продолжаться
почти столько же времени, как и ``prealloc`` , а также полностью заблокирует почти столько же времени, как и ``prealloc``, а также полностью заблокирует
aria2, пока не закончится резервирование места. ``falloc`` может быть aria2, пока не закончится резервирование места. ``falloc`` может быть
недоступным, если ваша система не содержит функцию :manpage:`posix_fallocate(3)`. недоступным, если ваша система не содержит функцию :manpage:`posix_fallocate(3)`.
Возможные значения: ``none`` , ``prealloc`` , ``falloc``. Возможные значения: ``none``, ``prealloc``, ``falloc``.
По умолчанию: ``prealloc`` По умолчанию: ``prealloc``
.. option:: --hash-check-only[=true|false] .. option:: --hash-check-only[=true|false]
Если задано ``true`` , то после проверки хэша, используя параметр Если задано ``true``, то после проверки хэша, используя параметр
:option:`--check-integrity <-V>`, :option:`--check-integrity <-V>`, загрузка прервётся, в любом
загрузка прервётся, в любом случае загрузка завершится. случае загрузка завершится.
По умолчанию: ``false`` По умолчанию: ``false``
.. option:: --human-readable[=true|false] .. option:: --human-readable[=true|false]
@ -1172,8 +1172,8 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
Если интерфейс имеет несколько адресов, то настоятельно рекомендуется Если интерфейс имеет несколько адресов, то настоятельно рекомендуется
указать IP-адрес явно. Смотрите также указать IP-адрес явно. Смотрите также
:option:`--disable-ipv6`. Если ваша система не имеет :manpage:`getifaddrs(3)`, это параметр не :option:`--disable-ipv6`. Если ваша система не имеет :manpage:`getifaddrs(3)`, это
принимает имя интерфейса. параметр не принимает имя интерфейса.
.. option:: --max-download-result=<NUM> .. option:: --max-download-result=<NUM>
@ -1191,7 +1191,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
Если параметр :option:`--always-resume=false, <--always-resume>` aria2 Если параметр :option:`--always-resume=false, <--always-resume>` aria2
загрузит файл с нуля, при обнаружении ``N`` -го URI, не поддерживающего загрузит файл с нуля, при обнаружении ``N`` -го URI, не поддерживающего
возобновление. Если ``N`` =``0`` , то aria2 загрузит файл с нуля, когда все возобновление. Если ``N`` =``0``, то aria2 загрузит файл с нуля, когда все
URI не поддерживают возобновление. Смотрите параметр URI не поддерживают возобновление. Смотрите параметр
:option:`--always-resume`. :option:`--always-resume`.
По умолчанию: ``0`` По умолчанию: ``0``
@ -1199,7 +1199,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. option:: --log-level=<LEVEL> .. option:: --log-level=<LEVEL>
Задать уровень вывода журнала событий. LEVEL может Задать уровень вывода журнала событий. LEVEL может
быть: ``debug`` , ``info`` , ``notice`` , ``warn`` или ``error``. быть: ``debug``, ``info``, ``notice``, ``warn`` или ``error``.
По умолчанию: ``debug`` По умолчанию: ``debug``
.. option:: --on-bt-download-complete=<COMMAND> .. option:: --on-bt-download-complete=<COMMAND>
@ -1348,17 +1348,17 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. option:: --save-session=<FILE> .. option:: --save-session=<FILE>
Сохранять ошибочные/незаконченные загрузки в FILE при выходе. Вы можете Сохранять ошибочные/незаконченные загрузки в FILE при выходе. Вы можете
передать этот выходной файл aria2c с параметром :option:`--input-file <-i>` при перезапуске. Обратите внимание, что передать этот выходной файл aria2c с параметром :option:`--input-file <-i>` при
загрузки, добавленные через RPC-методы перезапуске. Обратите внимание, что загрузки, добавленные через RPC-методы
:func:`aria2.addTorrent`, :func:`aria2.addMetalink` :func:`aria2.addTorrent`, :func:`aria2.addMetalink` и чьи метаданные не могут
и чьи метаданные не могут быть сохранены как файл, не будут сохраняться. быть сохранены как файл, не будут сохраняться.
Загрузки, удаленные с использованием :func:`aria2.remove` и Загрузки, удаленные с использованием :func:`aria2.remove` и
:func:`aria2.forceRemove` не будут сохранены. :func:`aria2.forceRemove` не будут сохранены.
.. option:: --stop=<SEC> .. option:: --stop=<SEC>
Останавливать программу после того как пройдет Останавливать программу после того как пройдет
SEC секунд. Если задано ``0`` , эта возможность будет SEC секунд. Если задано ``0``, эта возможность будет
отключена. отключена.
По умолчанию: ``0`` По умолчанию: ``0``
@ -1395,18 +1395,18 @@ URI, MAGNET-ССЫЛКА, TORRENT-ФАЙЛ, METALINK-ФАЙЛ
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Вы можете перечислить несколько URI в командной строке. Пока вы не указали Вы можете перечислить несколько URI в командной строке. Пока вы не указали
параметр :option:`--force-sequential <-Z>`, все URI должны указывать параметр :option:`--force-sequential <-Z>`, все URI должны указывать на один
на один и тот же файл или загрузка завершиться не удачно. и тот же файл или загрузка завершиться не удачно.
Вы можете указать произвольное количество BitTorrent Magnet URI. Обратите Вы можете указать произвольное количество BitTorrent Magnet URI. Обратите
внимание, что они всегда будут обрабатываться как отдельная внимание, что они всегда будут обрабатываться как отдельная
загрузка. Поддерживаются оба Info Hash (Информация о хэше), как загрузка. Поддерживаются оба Info Hash (Информация о хэше), как
закодированный 40 шестнадцатеричными символами, так и закодированный 32 закодированный 40 шестнадцатеричными символами, так и закодированный 32
символами Base32-кодировки. Поддерживаются составные параметры ``tr``. Т.к. в символами Base32-кодировки. Поддерживаются составные параметры
BitTorrent Magnet URI возможно присутствие символа ``&``, то настоятельно ``tr``. Т.к. в BitTorrent Magnet URI возможно присутствие символа ``&``, то
рекомендуется всегда заключать URI в одиночные(``'``) или двойные(``"``) настоятельно рекомендуется всегда заключать URI в одиночные(``'``) или
кавычки. Так же настоятельно рекомендуется включить DHT, особенно когда двойные(``"``) кавычки. Так же настоятельно рекомендуется включить DHT,
параметр ``tr`` не указан. Смотрите особенно когда параметр ``tr`` не указан. Смотрите
http://www.bittorrent.org/beps/bep_0009.html для детальной информации по http://www.bittorrent.org/beps/bep_0009.html для детальной информации по
BitTorrent Magnet URI. BitTorrent Magnet URI.
@ -1447,7 +1447,7 @@ aria2 предоставляет параметры, в которых указ
доступны следующие параметры: доступны следующие параметры:
:option:`--on-bt-download-complete`, :option:`--on-bt-download-complete`,
:option:`--on-download-pause`, :option:`--on-download-pause`,
:option:`--on-download-complete`. :option:`--on-download-complete`,
:option:`--on-download-start`, :option:`--on-download-start`,
:option:`--on-download-error`, :option:`--on-download-error`,
:option:`--on-download-stop`. :option:`--on-download-stop`.
@ -1458,11 +1458,10 @@ aria2 передает 3 аргумента указанной команды,
файлов. Если число файлов больше чем один, то путь к файлу будет для файлов. Если число файлов больше чем один, то путь к файлу будет для
первого. Другими словами, это значение параметра path в первой структуре, первого. Другими словами, это значение параметра path в первой структуре,
определенный параметр которой имеет значение true (истина), в ответе определенный параметр которой имеет значение true (истина), в ответе
RPC-метода :func:`aria2.getFiles`. Если вы хотите RPC-метода :func:`aria2.getFiles`. Если вы хотите получить все пути к
получить все пути к файлам, то рассмотрите использование файлам, то рассмотрите использование JSON-RPC/XML-RPC. Обратите внимание,
JSON-RPC/XML-RPC. Обратите внимание, что путь к файлу может меняться в что путь к файлу может меняться в процессе загрузки по HTTP из-за
процессе загрузки по HTTP из-за перенаправления или заголовка перенаправления или заголовка Content-Disposition.
Content-Disposition.
Посмотрите пример, как аргументы передаются команде: Посмотрите пример, как аргументы передаются команде:
@ -1639,15 +1638,15 @@ aria2.conf
По умолчанию, aria2 анализирует ``$HOME/.aria2/aria2.conf`` как По умолчанию, aria2 анализирует ``$HOME/.aria2/aria2.conf`` как
конфигурационный файл. Вы можете указать путь к конфигурационному файлу в конфигурационный файл. Вы можете указать путь к конфигурационному файлу в
параметре :option:`--conf-path`. Если вы не хотите параметре :option:`--conf-path`. Если вы не хотите использовать
использовать конфигурационный файл, используйте параметр конфигурационный файл, используйте параметр :option:`--no-conf`.
:option:`--no-conf`.
Конфигурационный файл - это текстовый файл, содержащий один параметр в Конфигурационный файл - это текстовый файл, содержащий один параметр в
строке. В каждой строке, вы можете указать пары имя-значение в формате: строке. В каждой строке, вы можете указать пары имя-значение в формате:
ИМЯ=ЗНАЧЕНИЕ, где имя - это длинный параметр командной строки, без префикса ИМЯ=ЗНАЧЕНИЕ, где имя - это длинный параметр командной строки, без префикса
``--``. Вы можете использовать тот же синтаксис, что и для параметра командной ``--``. Вы можете использовать тот же синтаксис, что и для параметра
строки. Строки начинающиеся с ``#`` рассматриваются как комментарии:: командной строки. Строки начинающиеся с ``#`` рассматриваются как
комментарии::
# sample configuration file for aria2c # sample configuration file for aria2c
listen-port=60000 listen-port=60000
@ -1658,18 +1657,18 @@ aria2.conf
dht.dat dht.dat
~~~~~~~~ ~~~~~~~
By default, the routing table of IPv4 DHT is saved to the path By default, the routing table of IPv4 DHT is saved to the path
``$HOME/.aria2/dht.dat`` and the routing table of IPv6 DHT is saved to ``$HOME/.aria2/dht.dat`` and the routing table of IPv6 DHT is saved to the
the path ``$HOME/.aria2/dht6.dat``. path ``$HOME/.aria2/dht6.dat``.
Netrc Netrc
~~~~~ ~~~~~
Поддержка Netrc включена по умолчанию для HTTP(S)/FTP. Для отключения Поддержка Netrc включена по умолчанию для HTTP(S)/FTP. Для отключения
поддержки netrc, укажите параметр :option:`--no-netrc <-n>`. Ваш файл поддержки netrc, укажите параметр :option:`--no-netrc <-n>`. Ваш файл .netrc
.netrc должен иметь соответствующие права (600). должен иметь соответствующие права (600).
Если имя машины (machine) начинается с ``.``, то aria2 выполняет доменное Если имя машины (machine) начинается с ``.``, то aria2 выполняет доменное
сопоставление вместо точного соответствия. Это расширение aria2. Пример сопоставление вместо точного соответствия. Это расширение aria2. Пример
@ -1681,10 +1680,10 @@ Netrc
Домен ``aria2.example.org`` сопоставляется с ``.example.org`` и используется Домен ``aria2.example.org`` сопоставляется с ``.example.org`` и используется
``myid`` и ``mypasswd``. ``myid`` и ``mypasswd``.
Примеры некоторых доменных сопоставлений: домен ``example.net`` не сопоставим Примеры некоторых доменных сопоставлений: домен ``example.net`` не
с ``.example.org``. Домен ``example.org`` не сопоставим ``.example.org`` из-за сопоставим с ``.example.org``. Домен ``example.org`` не сопоставим
предшествующей ``.``. Если вы хотите соответствия ``example.org``, то точно ``.example.org`` из-за предшествующей ``.``. Если вы хотите соответствия
укажите - ``example.org``. ``example.org``, то точно укажите - ``example.org``.
Контрольный файл Контрольный файл
~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~
@ -1695,8 +1694,8 @@ aria2 использует контрольный файл для отслежи
``.aria2``. Например, если file.zip загружаемый файл, тогда контрольный файл ``.aria2``. Например, если file.zip загружаемый файл, тогда контрольный файл
будет file.zip.aria2. (Существует исключение для этого именования. При будет file.zip.aria2. (Существует исключение для этого именования. При
загрузке торрента с множеством файлов, контрольный файл будет в "корневом загрузке торрента с множеством файлов, контрольный файл будет в "корневом
каталоге" с именем торрента и добавлением ``.aria2``. Имя "корневого каталога" каталоге" с именем торрента и добавлением ``.aria2``. Имя "корневого
- значение ключа "name" в "info" внутри torrent-файла.) каталога" - значение ключа "name" в "info" внутри torrent-файла.)
Обычно контрольный файл удаляется после завершения загрузки. Если aria2 Обычно контрольный файл удаляется после завершения загрузки. Если aria2
решает, что загрузка не может быть возобновлена (например, когда загружается решает, что загрузка не может быть возобновлена (например, когда загружается
@ -1799,7 +1798,8 @@ URI. Эти дополнительные строки должны начина
* :option:`max-resume-failure-tries <--max-resume-failure-tries>` * :option:`max-resume-failure-tries <--max-resume-failure-tries>`
* :option:`max-tries <-m>` * :option:`max-tries <-m>`
* :option:`max-upload-limit <-u>` * :option:`max-upload-limit <-u>`
* :option:`metalink-enable-unique-protocol <--metalink-enable-unique-protocol>` * :option:`metalink-enable-unique-protocol
<--metalink-enable-unique-protocol>`
* :option:`metalink-language <--metalink-language>` * :option:`metalink-language <--metalink-language>`
* :option:`metalink-location <--metalink-location>` * :option:`metalink-location <--metalink-location>`
* :option:`metalink-os <--metalink-os>` * :option:`metalink-os <--metalink-os>`
@ -1845,15 +1845,13 @@ URI. Эти дополнительные строки должны начина
http://foo/bar http://foo/bar
Если aria2 выполняется с параметрами ``-i uri.txt -d /tmp``, Если aria2 выполняется с параметрами ``-i uri.txt -d /tmp``, а загрузка
а загрузка происходит с происходит с \http://server/file.iso и \http://mirror/file.iso, то
\http://server/file.iso и \http://mirror/file.iso, то ``file.iso`` сохранится ``file.iso`` сохранится как ``/iso_images/file.img``. Файл ``bar``
как ``/iso_images/file.img``. Файл ``bar`` загрузится с http://foo/bar и загрузится с http://foo/bar и сохранится как ``/tmp/bar``.
сохранится как ``/tmp/bar``.
В некоторых случаях, параметр :option:`out <-o>` не имеет никакого В некоторых случаях, параметр :option:`out <-o>` не имеет никакого
эффекта. Смотрите примечание по ограничениям параметра эффекта. Смотрите примечание по ограничениям параметра :option:`--out <-o>`.
:option:`--out <-o>`.
Профиль функционирования сервера Профиль функционирования сервера
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -1913,17 +1911,18 @@ aria2 обеспечивает JSON-RPC через HTTP и XML-RPC через HT
имеют одинаковые функции. aria2 также обеспечивает JSON-RPC через имеют одинаковые функции. aria2 также обеспечивает JSON-RPC через
WebSocket. JSON-RPC через WebSocket использует тот же самый метод сигнатур и WebSocket. JSON-RPC через WebSocket использует тот же самый метод сигнатур и
формат ответа как у JSON-RPC через HTTP, но дополнительно имеет сервер, формат ответа как у JSON-RPC через HTTP, но дополнительно имеет сервер,
инициирующий уведомления. Смотрите подробности в разделе инициирующий уведомления. Смотрите подробности в разделе `JSON-RPC через
`JSON-RPC через WebSocket`_. WebSocket`_.
Путь запроса к JSON-RPC-интерфейсу (для через HTTP и через WebSocket) - Путь запроса к JSON-RPC-интерфейсу (для через HTTP и через WebSocket) -
``/jsonrpc``. Путь запроса к XML-RPC-интерфейсу - ``/rpc``. ``/jsonrpc``. Путь запроса к XML-RPC-интерфейсу - ``/rpc``.
WebSocket URI для JSON-RPC через WebSocket является ``ws://HOST:PORT/jsonrpc``. WebSocket URI для JSON-RPC через WebSocket является
``ws://HOST:PORT/jsonrpc``.
Реализованный JSON-RPC основан на спецификации Реализованный JSON-RPC основан на спецификации JSON-RPC 2.0
JSON-RPC 2.0 <http://jsonrpc.org/specification> и поддерживает HTTP POST и <http://jsonrpc.org/specification> и поддерживает HTTP POST и GET
GET (JSONP). Использование WebSocket как транспорта является начальным (JSONP). Использование WebSocket как транспорта является начальным
расширением aria2. расширением aria2.
JSON-RPC-интерфейс не поддерживает уведомления в HTTP, но RPC-сервер будет JSON-RPC-интерфейс не поддерживает уведомления в HTTP, но RPC-сервер будет
@ -1961,10 +1960,11 @@ GID
указывать на один и тот же файл. Если вы смешивайте другие URI, указывающие указывать на один и тот же файл. Если вы смешивайте другие URI, указывающие
на другой файл, то aria2 не сообщит об этом, но и загрузка может неудачно на другой файл, то aria2 не сообщит об этом, но и загрузка может неудачно
завершаться. Параметр *options* имеет тип структура, элементы которой завершаться. Параметр *options* имеет тип структура, элементы которой
являются парой имя и значение. Смотрите ниже :ref:`rpc_options` для более подробной информации. Если параметр *position* задан являются парой имя и значение. Смотрите ниже :ref:`rpc_options` для более
как целое число, начиная с 0, то новая загрузка будет вставлена на позицию подробной информации. Если параметр *position* задан как целое число,
*position* в очередь ожидания. Если параметр *position* не задан или больше начиная с 0, то новая загрузка будет вставлена на позицию *position* в
чем размер очереди, то загрузка будет добавлена в конец очереди. Этот метод очередь ожидания. Если параметр *position* не задан или больше чем размер
очереди, то загрузка будет добавлена в конец очереди. Этот метод
возвращает GID зарегистрированной загрузки. возвращает GID зарегистрированной загрузки.
**Пример JSON-RPC** **Пример JSON-RPC**
@ -2294,8 +2294,8 @@ GID
``errorCode`` ``errorCode``
Последний код ошибки, которая произошла при загрузке. Значение имеет тип Последний код ошибки, которая произошла при загрузке. Значение имеет тип
строки. Коды ошибок определены в разделе `КОДЫ ЗАВЕРШЕНИЯ`_. Это значение доступно только для остановленных/завершенных строки. Коды ошибок определены в разделе `КОДЫ ЗАВЕРШЕНИЯ`_. Это значение доступно
загрузок. только для остановленных/завершенных загрузок.
``followedBy`` ``followedBy``
Список с GID, которые сгенерированы в результате запуска этой Список с GID, которые сгенерированы в результате запуска этой
@ -2794,7 +2794,9 @@ GID
пределами конца очереди, это переместит загрузку в начало или конец очереди пределами конца очереди, это переместит загрузку в начало или конец очереди
соответственно. Ответ имеет целочисленный тип и является целевой позицией. соответственно. Ответ имеет целочисленный тип и является целевой позицией.
Например, если GID#1 размещается на позиции 3, ``aria2.changePosition('1', -1, 'POS_CUR')`` изменит его позицию на 2. Дополнительно ``aria2.changePosition('1', 0, 'POS_SET')`` изменит его позицию на 0 (начало очереди). Например, если GID#1 размещается на позиции 3, ``aria2.changePosition('1', -1, 'POS_CUR')``
изменит его позицию на 2. Дополнительно ``aria2.changePosition('1', 0, 'POS_SET')``
изменит его позицию на 0 (начало очереди).
**Пример JSON-RPC** **Пример JSON-RPC**
@ -3325,9 +3327,8 @@ GID
Параметры Параметры
~~~~~~~~~ ~~~~~~~~~
Такие же параметры, что доступны для Такие же параметры, что доступны для :option:`--input-file <-i>`. Смотрите
:option:`--input-file <-i>`. Смотрите подраздел `Входной файл`_ для полного подраздел `Входной файл`_ для полного списка параметров.
списка параметров.
В структуре, имя элемента - это имя параметра (без ``--``), а значение В структуре, имя элемента - это имя параметра (без ``--``), а значение
элемента - аргумент в виде строки. элемента - аргумент в виде строки.
@ -3355,11 +3356,10 @@ GID
</struct> </struct>
Параметры :option:`header <--header>` и :option:`index-out <-O>` Параметры :option:`header <--header>` и :option:`index-out <-O>` допускают
допускают нескольких определений в нескольких определений в командной строке. Поскольку имя должно быть
командной строке. Поскольку имя должно быть уникальным в структуре уникальным в структуре (многие реализации библиотеки XML-RPC использует хэш
(многие реализации библиотеки XML-RPC использует хэш или словарь или словарь для структуры), одной строки не достаточно. Для преодоления этой
для структуры), одной строки не достаточно. Для преодоления этой
ситуации, они могут взять массив в качестве значения, а также строку. ситуации, они могут взять массив в качестве значения, а также строку.
Пример JSON-RPC Пример JSON-RPC
@ -3404,16 +3404,14 @@ JSON-RPC используя HTTP GET
~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~
JSON-RPC-интерфейс также поддерживает запрос через HTTP GET. Схема JSON-RPC-интерфейс также поддерживает запрос через HTTP GET. Схема
кодирования в GET параметров основанных на кодирования в GET параметров основанных на JSON-RPC через HTTP Спецификация
JSON-RPC [2008-1-15(RC1)]. Кодирование параметров через GET следующие::
через HTTP Спецификация [2008-1-15(RC1)]. Кодирование параметров через GET
следующие::
/jsonrpc?method=METHOD_NAME&id=ID&params=BASE64_ENCODED_PARAMS /jsonrpc?method=METHOD_NAME&id=ID&params=BASE64_ENCODED_PARAMS
``method`` и ``id`` всегда обрабатывается как JSON-строка и они должны быть в ``method`` и ``id`` всегда обрабатывается как JSON-строка и они должны быть
кодировке UTF-8. в кодировке UTF-8.
Например, закодированная строка aria2.tellStatus('3') с id='foo' выглядит Например, закодированная строка aria2.tellStatus('3') с id='foo' выглядит
так:: так::
@ -3435,8 +3433,8 @@ JSON-RPC-интерфейс поддерживает JSONP. Вы можете о
Для пакетного запроса, параметры ``method`` и ``id`` не должны быть Для пакетного запроса, параметры ``method`` и ``id`` не должны быть
указаны. Полный запрос должен быть определен в параметре ``params``. Например, указаны. Полный запрос должен быть определен в параметре
пакетный запрос:: ``params``. Например, пакетный запрос::
[{'jsonrpc':'2.0', 'id':'qwer', 'method':'aria2.getVersion'}, [{'jsonrpc':'2.0', 'id':'qwer', 'method':'aria2.getVersion'},
{'jsonrpc':'2.0', 'id':'asdf', 'method':'aria2.tellActive'}] {'jsonrpc':'2.0', 'id':'asdf', 'method':'aria2.tellActive'}]
@ -3522,8 +3520,8 @@ params, является данными, которые переносит эт
~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~
Следующий Ruby-скрипт добавляет ``http://localhost/aria2.tar.bz2``, с Следующий Ruby-скрипт добавляет ``http://localhost/aria2.tar.bz2``, с
параметром :option:`--dir=/downloads, <-d>` в aria2c, которая параметром :option:`--dir=/downloads, <-d>` в aria2c, которая работает на
работает на localhost и отображает ответ: localhost и отображает ответ:
.. code-block:: ruby .. code-block:: ruby
@ -3752,8 +3750,8 @@ params, является данными, которые переносит эт
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Для указания выходного имени файла в BitTorrent-загрузках, вам нужно узнать Для указания выходного имени файла в BitTorrent-загрузках, вам нужно узнать
индекс файла в torrent-файле, используя параметр индекс файла в torrent-файле, используя параметр :option:`--show-files
:option:`--show-files <-S>`. Например, результат выглядит следующим образом:: <-S>`. Например, результат выглядит следующим образом::
idx|path/length idx|path/length
===+====================== ===+======================
@ -3831,8 +3829,8 @@ params, является данными, которые переносит эт
Добавить и удалить URI трекера Добавить и удалить URI трекера
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Удалить все URI анонса трекеров, описанных в file.torrent и Удалить все URI анонса трекеров, описанных в file.torrent и взамен
взамен использовать ``http://tracker1/announce`` и ``http://tracker2/announce``: использовать ``http://tracker1/announce`` и ``http://tracker2/announce``:
.. code-block:: console .. code-block:: console