From f1de5bac081868a083ebd4497cb6d0936f9b6151 Mon Sep 17 00:00:00 2001 From: ITriskTI Date: Sat, 12 Jul 2014 18:36:21 +0300 Subject: [PATCH] Update aria2c.rst --- doc/manual-src/ru/aria2c.rst | 914 +++++++++++++++++++---------------- 1 file changed, 484 insertions(+), 430 deletions(-) diff --git a/doc/manual-src/ru/aria2c.rst b/doc/manual-src/ru/aria2c.rst index 40610aea..124f5ee2 100644 --- a/doc/manual-src/ru/aria2c.rst +++ b/doc/manual-src/ru/aria2c.rst @@ -9,13 +9,13 @@ aria2c(1) -------- aria2 - это утилита для загрузки файлов. Поддерживаемые протоколы: HTTP(S), -FTP, BitTorrent и Metalink. Для загрузки файла, aria2 может использовать -разные источники/протоколы и пытается максимально использовать пропускную +FTP, BitTorrent и Metalink. aria2 может загрузить файл с разных +источников/протоколов и пытается максимально использовать пропускную способность канала. Есть поддержка загрузки файла по протоколам HTTP(S)/FTP и BitTorrent одновременно, пока данные загружаются по HTTP(S)/FTP, они тут же могут выгружаться в BitTorrent-рой. Используя контрольные суммы блока -данных для Metalink, aria2 автоматически проверяет части данных, которые -загружаются по BitTorrent. +данных для Metalink, aria2 автоматически проверяет части данных во время +загрузки файла. ПАРАМЕТРЫ --------- @@ -28,26 +28,31 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може .. option:: -i, --input-file= - Загрузить URI, найденные в файле FILE. Вы можете указать несколько URI для одного - объекта: разделяйте URI в строке, используя символ TAB (табуляция). Когда - указано ``-``, ввод считывается из stdin (стандартный поток ввода). Дополнительные - параметры можно указывать после каждой строки с URI. Эта необязательная строка - должна начинаться с одного или нескольких пробелов и содержать один параметр. + Загрузить URI, перечисленные в файле FILE. Вы можете указать различные источники + для одного объекта, перечислив различные URI в строке, разделенных символом + TAB (табуляция). + Дополнительные параметры можно указывать после каждой URI-строки. Cтроки параметров + должны начинаться с одного или нескольких пробелов (:kbd:`SPACE` или :kbd:`TAB`) + и содержать один параметр на строку. + Когда ``FILE`` указан как ``-``, aria2 будет считывать ввод из + stdin (стандартный поток ввода). Входной файл может использовать gzip-сжатие. Смотрите подраздел `Входной файл`_ для детальных пояснений. Также смотрите параметр :option:`--deferred-input`. + Также смотрите параметр :option:`--save-session-file`. .. option:: -l, --log= Имя файла для журнала событий. Если указан ``-``, то журнал событий будет записан в stdout (стандартный поток вывода). Если указана пустая - строка (""), то журнал событий не будет записан в файл. + строка ("") или параметр пропущен, то журнал событий вообще не будет записан + на диск. .. option:: -j, --max-concurrent-downloads= Задать максимальное количество параллельных загрузок для каждого - статического (HTTP/FTP) URI, torrent и metalink. Смотрите также - параметр :option:`--split <-s>`. + элемента очереди. + Смотрите также параметр :option:`--split <-s>`. По умолчанию: ``5`` .. option:: -V, --check-integrity[=true|false] @@ -88,33 +93,32 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може ~~~~~~~~~~~~~~~~~~ .. option:: --all-proxy= - Использовать указанный прокси-сервер для всех протоколов. Для стирания - ранее определенного адреса используйте "". Вы можете отменить эту - установку и указать прокси-сервер для отдельного протокола, используя + Использовать указанный прокси-сервер для всех протоколов. Для отмены + ранее определенного адреса используйте "". Вы также можете отменить эту + настройку и указать прокси-сервер для отдельного протокола, используя параметры :option:`--http-proxy`, - :option:`--https-proxy` и - :option:`--ftp-proxy`. Влияет на все URI. + :option:`--https-proxy` и :option:`--ftp-proxy`. Влияет на все загрузки. Формат PROXY - ``[http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ]``. Смотрите также раздел `ОКРУЖЕНИЕ`_. .. note:: Если пользователь и пароль вставлены в URI-прокси и они также указаны в - параметрах *--{http,https,ftp,all}-proxy-{user,passwd}*, то приоритетным - будет самое последнее. Например, у вас ``http-proxy-user="myname"``, - ``http-proxy-passwd="mypass"`` в aria2.conf и вы указали - ``--http-proxy="http://proxy"`` в командной строке, тогда запрос к HTTP-прокси - ``http://proxy`` будет с пользователем ``myname`` и паролем ``mypass``. + параметрах *--{http,https,ftp,all}-proxy-{user,passwd}*, то те, которые + указаны позже переопределят предыдущие параметры. + Например, если вы указали ``http-proxy-user="myname"``, + ``http-proxy-passwd="mypass"`` в aria2.conf и указали + ``--http-proxy="http://proxy"`` в командной строке, тогда вы получите + HTTP-прокси ``http://proxy`` с пользователем ``myname`` и паролем ``mypass``. Другой пример: если вы указали в командной строке ``--http-proxy="http://user:pass@proxy" --http-proxy-user="myname" - --http-proxy-passwd="mypass"``, тогда запрос к HTTP-прокси ``http://proxy`` - будет с пользователем ``myname`` и паролем ``mypass``. + --http-proxy-passwd="mypass"``, тогда вы получите HTTP-прокси ``http://proxy`` + с пользователем ``myname`` и паролем ``mypass``. - Еще один пример: если вы - указали в командной строке ``--http-proxy-user="myname" - --http-proxy-passwd="mypass" --http-proxy="http://user:pass@proxy"``, тогда - запрос к HTTP-прокси ``http://proxy`` будет с пользователем ``user`` и паролем + Еще один пример: если вы указали в командной строке ``--http-proxy-user="myname" + --http-proxy-passwd="mypass" --http-proxy="http://user:pass@proxy"``, тогда вы + получите HTTP-прокси ``http://proxy`` с пользователем ``user`` и паролем ``pass``. .. option:: --all-proxy-passwd= @@ -208,29 +212,29 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може .. option:: --no-proxy= - Укажите через запятую имена хостов, домены и сетевые адреса - с CIDR-блоком, или без него, для которых не будет использоваться прокси. + Укажите через запятую список имён хостов, доменов и сетевых адресов + с или без маски подсети, для которых не будет использоваться прокси. .. note:: - CIDR-блок (метод IP-адресации, например 192.168.0.20/24) работает с IPv4- и - IPv6-адресами. Текущая реализация не разрешает имена хостов в URI для - сравнения сетевых адресов указанных в - :option:`--no-proxy`. Таким образом, это эффективно, только если в URI есть - IP-адреса. + IPv4- и IPv6-адресация работает для сетевых адресов с маской подсети. + Текущая реализация не разрешает имена хостов в URI для сравнения + сетевых адресов указанных в :option:`--no-proxy`. Таким образом, это + эффективно, только если в URI есть IP-адреса. .. option:: -o, --out= - Сохранить загруженный файл под указанным именем. Если используется - параметр :option:`--force-sequential <-Z>`, то данный параметр - игнорируется. + Сохранить загруженный файл под указанным именем. Данный параметр + игнорируется, когда используется параметр :option:`--force-sequential <-Z>`. .. note:: - В Metalink или BitTorrent загрузках вы не можете указать имя файла. Имя - файла указывается здесь, только когда используются URI и aria2 с командной - строкой без параметров :option:`--input-file <-i>`, - :option:`--force-sequential <-Z>`. Например: + Вы не можете указать имя файла для Metalink или BitTorrent загрузок. Имя + файла указанное здесь, используется только когда URI передаются aria2 + с командной строкой непосредственно, но не при использовании параметров + :option:`--input-file <-i>`, :option:`--force-sequential <-Z>`. + + Пример: .. code-block:: console @@ -258,7 +262,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може .. option:: --retry-wait= Задать в секундах интервал ожидания между повторными попытками. - При SEC > 0, если HTTP-сервер возвращает ответ 503, aria2 будет + При `SEC > 0``, если HTTP-сервер возвращает ответ 503, aria2 будет снова пытаться загрузить. По умолчанию: ``0`` @@ -301,8 +305,8 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може Некоторые Metalink регламентируют количество серверов для соединения. aria2 строго соблюдает это. Это значит, что если Metalink определяет атрибут - maxconnections меньше чем N, то aria2 использует значение атрибута - maxconnections вместо N. + ``maxconnections`` меньше чем N, то aria2 использует это, более низкое + значение, вместо N. .. option:: --stream-piece-selector= @@ -391,7 +395,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може использовать PKCS12-файлы. .. note:: - *AppleTLS* пользователи должны использовать утилиту Keychain Access для + *AppleTLS* пользователи должны использовать утилиту KeyChain Access для импорта сертификата клиента и получения соответствующего SHA-1 отпечатка этого сертификата из окна Information. Для запуска aria2c используйте `--certificate=`. @@ -444,33 +448,35 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може .. option:: --http-proxy= - Использовать указанный прокси-сервер для HTTP. Ранее указанный адрес - можно стереть, указав "". Смотрите также параметр - :option:`--all-proxy`. Влияет на все URI. + Использовать указанный прокси-сервер для HTTP. Для отмены + ранее определенного адреса используйте "". + Смотрите также параметр :option:`--all-proxy`. Влияет на все + HTTP-загрузки. Формат PROXY - ``[http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ]``. .. option:: --http-proxy-passwd= - Задать пароль для параметра :option:`--http-proxy`. + Задать пароль для :option:`--http-proxy`. .. option:: --http-proxy-user= - Задать пользователя для параметра :option:`--http-proxy`. + Задать пользователя для :option:`--http-proxy`. .. option:: --https-proxy= - Использовать указанный прокси-сервер для HTTPS. Ранее указанный - адрес можно стереть, указав "". Смотрите также параметр - :option:`--all-proxy`. Влияет на все URI. + Использовать указанный прокси-сервер для HTTPS. Для отмены + ранее определенного адреса используйте "". + Смотрите также параметр :option:`--all-proxy`. Влияет на все + HTTPS-загрузки. Формат PROXY - ``[http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ]``. .. option:: --https-proxy-passwd= - Задать пароль для параметра :option:`--https-proxy`. + Задать пароль для :option:`--https-proxy`. .. option:: --https-proxy-user= - Задать пользователя для параметра :option:`--https-proxy`. + Задать пользователя для :option:`--https-proxy`. .. option:: --private-key= @@ -481,9 +487,10 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може .. option:: --referer= - Задать источник запроса. Влияет на все URI. Если задано ``*``, то каждый - URI запроса будет использован как источник запроса. Это может быть полезно - при использовании с параметром :option:`--parameterized-uri <-P>`. + Задать HTTP источник запроса (Referer). Влияет на все HTTP/HTTPS-загрузки. + Если задано ``*``, то URI загрузки будет также использован как источник запроса. + Это может быть полезно при использовании вместе с параметром + :option:`--parameterized-uri <-P>`. .. option:: --enable-http-keep-alive[=true|false] @@ -561,9 +568,9 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може .. option:: --ftp-proxy= - Использовать указанный прокси-сервер для FTP. Ранее указанный адрес - можно стереть, указав "". Смотрите также параметр - :option:`--all-proxy`. Влияет на все URI. + Использовать указанный прокси-сервер для FTP. Для отмены + ранее определенного адреса используйте "". + Смотрите также параметр :option:`--all-proxy`. Влияет на все FTP-загрузки. Формат PROXY - ``[http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ]`` .. option:: --ftp-proxy-passwd= @@ -948,7 +955,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може .. option:: -M, --metalink-file= - Путь к файлу ".meta4" и ".metalink". Читает ввод из stdin, если в качестве + Путь к файлу ".meta4" и ".metalink". Читает ввод из ``stdin``, если в качестве имени файла указано ``-``. Вы не обязаны использовать этот параметр, т.к. файлы .metalink можно указать без :option:`--metalink-file <-M>`. @@ -998,6 +1005,16 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може только, когда задан :option:`--enable-rpc=true. <--enable-rpc>` По умолчанию: ``false`` +.. option:: --pause-metadata[=true|false] + + Приостановить загрузки, созданные в результате загрузки метаданных. + Есть 3 типа метаданных загрузок в aria2: (1) загрузка .torrent-файла. + (2) загрузка метаданных торрента, используя magnet-ссылку. (3) + загрузка metalink-файла. Эти загрузки метаданных будут генерировать + загрузки, используя их метаданные. Этот параметр приостанавливает + эти последующие загрузки. Этот параметр действует только когда задано + :option:`--enable-rpc=true <--enable-rpc>`. + По умолчанию: ``false`` .. option:: --rpc-allow-origin-all[=true|false] @@ -1021,7 +1038,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може использовать PKCS12-файлы. .. note:: - *AppleTLS* пользователи должны использовать утилиту Keychain Access, чтобы + *AppleTLS* пользователи должны использовать утилиту KeyСhain Access, чтобы сначала генерировать самоподписанный SSL-Server сертификат, например, используя мастер, и получить соответствующий SHA-1 отпечаток нового сертификата из окна Information. @@ -1319,8 +1336,8 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може .. option:: --human-readable[=true|false] - Выводить на консоль размеры и скорость в удобочитаемом формате - (например, 1.2Ки, 3.4Ми). + Выводить размеры и скорость в удобочитаемом формате + (например, 1.2Ки, 3.4Ми) на консольный индикатор. По умолчанию: ``true`` .. option:: --interface= @@ -1424,14 +1441,14 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може .. note:: - Возможный вариант использования параметра + Возможный вариант использования параметра :option:`--piece-length` - изменение диапазона запроса в одном конвейерном HTTP-запросе. Для включения конвейерной обработки HTTP используйте :option:`--enable-http-pipelining`. .. option:: --show-console-readout[=true|false] - Показывать консольный вывод. + Показывать консольный индикатор. По умолчанию: ``true`` .. option:: --summary-interval= @@ -1560,7 +1577,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може .. option:: --truncate-console-readout[=true|false] - Укорачивать консольный вывод, чтобы он поместился в + Укорачивать консольный индикатор, чтобы он поместился в одну строку. По умолчанию: ``true`` @@ -1581,7 +1598,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може (например, ``-V``) и указываете аргумент, то имя параметра и его аргумент должны быть объедены (например, ``-Vfalse``). Если будут вставлены пробелы между именем параметра и аргументом, то аргумент будет обрабатываться как -URI, и это не то, что обычно вы ожидаете. +URI, и это не то, что обычно вы ожидаете. Единицы (K и M) ^^^^^^^^^^^^^^^ @@ -1823,11 +1840,10 @@ aria2 распознает следующие переменные окруже основанного на определенной схеме. ``no_proxy [ДОМЕН,...]`` - Указать, разделенные запятыми, имена хостов, доменов и сетевых адресов с - CIDR-блоком, или без него, для которых прокси использоваться не - будет. Заменяет значение no-proxy в конфигурационном файле. Параметр - :option:`--no-proxy` в командной строке заменяет эту - переменную. + Указать, разделенные запятыми, список имён хостов, доменов и сетевых адресов + с или без маски подсети, для которых не будет использоваться прокси. Заменяет + значение `no-proxy` в конфигурационном файле. Параметр :option:`--no-proxy` в + командной строке заменяет эту переменную. ФАЙЛЫ ----- @@ -2022,6 +2038,7 @@ URI. Эти дополнительные строки должны начина * :option:`out <-o>` * :option:`parameterized-uri <-P>` * :option:`pause <--pause>` + * :option:`pause-metadata <--pause-metadata>` * :option:`piece-length <--piece-length>` * :option:`proxy-method <--proxy-method>` * :option:`realtime-chunk-checksum <--realtime-chunk-checksum>` @@ -2069,7 +2086,7 @@ URI. Эти дополнительные строки должны начина разделенных запятыми. В настоящее время распознаются следующие ИМЕНА: ``host`` - Хост-имя сервера. Обязательно. + Имя хоста сервера. Обязательно. ``protocol`` Протокол для этого профиля, такие как ftp, http. Обязательно. @@ -2115,12 +2132,12 @@ URI. Эти дополнительные строки должны начина RPC-ИНТЕРФЕЙС ------------- -aria2 обеспечивает JSON-RPC через HTTP и XML-RPC через HTTP, они в основном -имеют одинаковые функции. aria2 также обеспечивает JSON-RPC через +aria2 обеспечивает JSON-RPC через HTTP и XML-RPC через HTTP интерфейсы и они +в основном имеют одинаковые функции. aria2 также обеспечивает JSON-RPC через WebSocket. JSON-RPC через WebSocket использует тот же самый метод сигнатур и -формат ответа как у JSON-RPC через HTTP, но дополнительно имеет сервер, -инициирующий уведомления. Смотрите подробности в разделе `JSON-RPC через -WebSocket`_. +формат ответа как у JSON-RPC через HTTP, но дополнительно предоставляет +уведомления, инициированные сервером. Смотрите раздел `JSON-RPC через +WebSocket`_ для получения дополнительной информации. Путь запроса к JSON-RPC-интерфейсу (для через HTTP и через WebSocket) - ``/jsonrpc``. Путь запроса к XML-RPC-интерфейсу - ``/rpc``. @@ -2131,14 +2148,14 @@ WebSocket URI для JSON-RPC через WebSocket является Реализованный JSON-RPC основан на спецификации JSON-RPC 2.0 и поддерживает HTTP POST и GET -(JSONP). Использование WebSocket как транспорта является начальным -расширением aria2. +(JSONP). WebSocket-транспорт является расширением aria2. -JSON-RPC-интерфейс не поддерживает уведомления в HTTP, но RPC-сервер будет -отправлять уведомления в WebSocket. Он также не поддерживает числа с -плавающей точкой. Символы должны быть в кодировке UTF-8. +JSON-RPC-интерфейс не поддерживает уведомления через HTTP, но RPC-сервер +будет отправлять уведомления через WebSocket. Он также не поддерживает числа +с плавающей точкой. Символы должны быть в кодировке UTF-8. -В следующем документе о JSON-RPC, описана структура JSON-объекта. +Читая следующую документацию для JSON-RPC, интерпретируйте структуры как +JSON-объекты. Терминология ~~~~~~~~~~~~ @@ -2146,13 +2163,14 @@ JSON-RPC-интерфейс не поддерживает уведомления GID GID (или gid) - это ключ, для управления каждой загрузкой. Каждая - загрузка имеет уникальный GID. GID сохранится в 64 битах двоичных - данных в aria2. Для RPC-доступа, он должен быть представлен в виде - шестнадцатеричной строки из 16 символов (например, ``2089b05ecca3d829``). + загрузка будет подписана уникальным GID. GID сохранится в aria2 как + 64-битное двоичное значение. + Для RPC-доступа, он должен быть представлен в виде шестнадцатеричной + строки из 16 символов (например, ``2089b05ecca3d829``). Обычно, aria2 генерирует этот GID для каждой загрузки, но пользователь может определить GID вручную, используя параметр :option:`--gid <--gid>`. - При запросе загрузки по GID, вы можете задать префикс GID пока он - является уникальным префиксом среди других. + При запросе загрузок по GID, вы можете задать только префикс GID пока он + является уникальным среди других. .. _rpc_auth: @@ -2167,43 +2185,51 @@ HTTP-авторизация будет удалена и method-level RPC-авт Чтобы использовать method-level RPC-авторизацию, пользователь должен указать секретный маркер RPC-авторизации, используя параметр :option:`--rpc-secret`. Для каждого вызова RPC-метода, вызывающий должен -включать маркер с префиксом ``token:``. Если параметр :option:`--rpc-secret` -не используется, а первым параметром в RPC-методе является строка и -начинается с ``token:``, то ``token:`` удаляется из параметра метода перед -обработкой. +включать маркер с префиксом ``token:``. Даже когда параметр +:option:`--rpc-secret` не используется, и если первым параметром в +RPC-методе является строка и начинается с ``token:``, то она будет удалёна +из списка параметров, прежде чем запрос будет обработан. -Например, если секретный маркер RPC-авторизации - ``$$secret$$``, то -вызываемый RPC-метод `aria2.addUri` будет выглядеть следующим образом: +Например, если секретный маркер RPC-авторизации - ``$$secret$$``, то вызов +RPC-метода `aria2.addUri` будет выглядеть следующим образом: aria2.addUri("token::$$secret$$", ["http://example.org/file"]) RPC-метод `system.multicall` обрабатывается особым образом. Поскольку спецификация XML-RPC позволяет использовать только один массив в качестве -параметра для этого метода, мы не указываем маркер в его вызове. Вместо -этого каждый вложенный вызов метода должен обеспечивать маркер в качестве -первого параметра, как описано выше. +параметра для этого метода, мы не указываем маркер в вызове. Вместо этого +каждый вложенный вызов метода должен обеспечивать маркер в качестве первого +параметра, как описано выше. + +.. note:: + + Проверка секретного маркера в aria2 разработана, чтобы противостоять хотя бы + определенное количество времени, ослаблять атаки методом грубой силы/по словарю + против RPC-интерфейса. Поэтому рекомендуется отдавать предпочтение пакетным + или `system.multicall` запросам, когда это необходимо. Методы ~~~~~~ -Весь код в примерах написан на Python2.7. О параметре *secret* смотрите -:ref:`rpc_auth`. +Весь примеры кода совместимы с Python 2.7. Для получения информации о +параметре *secret* смотрите :ref:`rpc_auth`. .. function:: aria2.addUri([secret], uris[, options[, position]]) - Этот метод добавляет новый HTTP(S)/FTP/BitTorrent Magnet URI. Параметр - *uris* имеет тип массив, элемент которого имеет тип строка и содержит - URI. Для BitTorrent Magnet URI, *uris* должен содержать только один элемент, - и он должен быть BitTorrent Magnet URI. URI в параметре *uris* должны - указывать на один и тот же файл. Если вы смешивайте другие URI, указывающие - на другой файл, то aria2 не сообщит об этом, но и загрузка может неудачно - завершаться. Параметр *options* имеет тип структура, элементы которой - являются парой имя и значение. Смотрите ниже :ref:`rpc_options` для более - подробной информации. Если параметр *position* задан как целое число, - начиная с 0, то новая загрузка будет вставлена на позицию *position* в - очередь ожидания. Если параметр *position* не задан или больше чем размер - очереди, то загрузка будет добавлена в конец очереди. Этот метод - возвращает GID зарегистрированной загрузки. + Этот метод добавляет новую загрузку. Параметр *uris* - это массив + HTTP(S)/FTP/BitTorrent Magnet URI (строки), указывающие на один и тот же + ресурс. Если вы смешивайте URI, указывающие на разные ресурсы, то загрузка + может неудачно завершиться или быть повреждена без жалоб со стороны aria2. + При добавлении BitTorrent Magnet URI, *uris* должен содержать только один + элемент, и он должен быть BitTorrent Magnet-ссылкой. + Параметр *options* - это структура, а её элементы являются парами имя и + значение. + Смотрите ниже :ref:`rpc_options` для более подробной информации. + Если параметр *position* задан, то он должен быть целым числом, + начиная с 0. Новая загрузка будет вставлена на позицию *position* в + очередь ожидания. Если параметр *position* пропущен или больше чем текущий + размер очереди, то новая загрузка будет добавлена в конец очереди. + Этот метод возвращает GID зарегистрированной загрузки. **Пример JSON-RPC** @@ -2226,14 +2252,13 @@ RPC-метод `system.multicall` обрабатывается особым об >>> s.aria2.addUri(['http://example.org/file']) '2089b05ecca3d829' - Следующий пример добавляет два источника и некоторые параметры:: + Следующий пример добавляет новую загрузку с двумя источниками и некоторые параметры:: >>> s.aria2.addUri(['http://example.org/file', 'http://mirror/file'], dict(dir="/tmp")) 'd2703803b52216d1' - Следующий пример добавляет загрузку и вставляет ее перед ожидающими - загрузками:: + Следующий пример добавляет загрузку и вставляет её впереди очереди:: >>> s.aria2.addUri(['http://example.org/file'], {}, 0) 'ca3d829cee549a4d' @@ -2242,26 +2267,26 @@ RPC-метод `system.multicall` обрабатывается особым об Этот метод добавляет BitTorrent-загрузку путем загрузки .torrent-файла. Если вы хотите добавить BitTorrent Magnet URI, взамен используйте метод - :func:`aria2.addUri`. Параметр *torrent* имеет тип base64, с содержанием - Base64-кодировки в .torrent-файле. Параметр *uris* имеет тип массив, - элемент которого имеет тип строка и содержит URI. - Параметр *uris* используется для Web-сидирования. Для однофайловых - торрентов, URI может быть завершенным, который указывает на ресурс, - или же если заканчиваться символом /, тогда будет добавлено имя из - torrent-файла. Для многофайловых торрентов, имя и путь в торренте будут - добавлены из URI для каждого файла. Параметр *options* имеет тип структура, - элементы которой являются парой имя и значение. Смотрите ниже - :ref:`rpc_options` для более подробной информации. Если - параметр *position* задан как целое число, начиная с 0, то новая загрузка - будет вставлена на позицию *position* в очередь ожидания. Если параметр - *position* не задан или больше чем размер очереди, то загрузка будет - добавлена в конец очереди. Этот метод возвращает GID зарегистрированной - загрузки. Если :option:`--rpc-save-upload-metadata` задан как ``true``, + :func:`aria2.addUri`. Параметр *torrent* должен быть base64-кодированной + строкой, с содержимым .torrent-файла. + Параметр *uris* - это массив c URI (строка). Параметр *uris* используется для + Web-сидирования. Для однофайловых торрентов, URI может быть полным, + который указывает на ресурс; если URI заканчивается символом /, тогда будет + добавлено имя из torrent-файла. Для многофайловых торрентов, чтобы cформировать + URI для каждого файла, будут добавлены имя и путь из торрента. + Параметр *options* - это структура, а её элементы являются парами имя и значение. + Смотрите ниже :ref:`rpc_options` для более подробной информации. + Если параметр *position* задан, то он должен быть целым числом, + начиная с 0. Новая загрузка будет вставлена на позицию *position* в + очередь ожидания. Если параметр *position* пропущен или больше чем текущий + размер очереди, то новая загрузка будет добавлена в конец очереди. + Этот метод возвращает GID зарегистрированной загрузки. + Если :option:`--rpc-save-upload-metadata` задан как ``true``, загруженные данные сохраняются в файл с именем шестнадцатеричной строки SHA-1-хэша этих данных плюс ".torrent", в каталог указанный в - параметре :option:`--dir <-d>`. Например, имя файла - 0a3893293e27ac0490424c06de4d09242215f0a6.torrent. Если этот файл существует, - то он будет перезаписан. Если файл не может быть успешно сохранен или + параметре :option:`--dir <-d>`. Например, имя файла может быть + ``0a3893293e27ac0490424c06de4d09242215f0a6.torrent``. Если файл с таким же именем + существует, то он будет перезаписан! Если файл не может быть успешно сохранен или :option:`--rpc-save-upload-metadata` задан как ``false``, то загрузки, добавленные этим методом, не сохраняются при помощи параметра :option:`--save-session`. @@ -2292,20 +2317,21 @@ RPC-метод `system.multicall` обрабатывается особым об .. function:: aria2.addMetalink([secret], metalink[, options[, position]]) Этот метод добавляет Metalink-загрузку путем загрузки .metalink-файла. - Параметр *metalink* имеет тип base64, с содержанием - Base64-кодировки в .metalink-файле. Параметр *options* имеет тип структура, - элементы которой являются парой имя-значение. Смотрите ниже - :ref:`rpc_options` для более подробной информации. Если - параметр *position* задан как целое число, начиная с 0, то новая загрузка - будет вставлена на позицию *position* в очередь ожидания. Если параметр - *position* не задан или больше чем размер очереди, то загрузка будет - добавлена в конец очереди. Этот метод возвращает GID зарегистрированной - загрузки. Загруженные данные сохраняются в файл с именем шестнадцатеричной + Параметр *metalink* должен быть base64-кодированной строкой, с содержимым .metalink-файла. + Параметр *options* - это структура, а её элементы являются парами имя и значение. + Смотрите ниже :ref:`rpc_options` для более подробной информации. + Если параметр *position* задан, то он должен быть целым числом, + начиная с 0. Новая загрузка будет вставлена на позицию *position* в + очередь ожидания. Если параметр *position* пропущен или больше чем текущий + размер очереди, то новая загрузка будет добавлена в конец очереди. + Этот метод возвращает GID зарегистрированной загрузки. + Если :option:`--rpc-save-upload-metadata` задан как ``true``, + загруженные данные сохраняются в файл с именем шестнадцатеричной строки SHA-1-хэша этих данных плюс ".metalink", в каталог указанный в - параметре :option:`--dir <-d>`. Например, имя файла - 0a3893293e27ac0490424c06de4d09242215f0a6.metalink. Если этот файл - существует, то он будет перезаписан. Если файл не может быть успешно сохранен - или :option:`--rpc-save-upload-metadata` задан как ``false``, то + параметре :option:`--dir <-d>`. Например, имя файла может быть + ``0a3893293e27ac0490424c06de4d09242215f0a6.metalink``. Если файл с таким же именем + существует, то он будет перезаписан! Если файл не может быть успешно сохранен или + :option:`--rpc-save-upload-metadata` задан как ``false``, то загрузки, добавленные этим методом, не сохраняются при помощи параметра :option:`--save-session`. @@ -2335,12 +2361,12 @@ RPC-метод `system.multicall` обрабатывается особым об .. function:: aria2.remove([secret], gid) - Этот метод удаляет загрузку, которая обозначена *gid*. Параметр *gid* имеет - тип строка. Если указана загрузка, которая загружается в данный момент, то - сначала она остановится. Статус удаления станет ``removed`` (удаленно). Этот - метод возвращает GID удаленной загрузки. + Этот метод удаляет загрузку, которая обозначена *gid* (строка). + Если указана загрузка, которая загружается в данный момент, то + сначала она остановится. Статус удаления станет ``removed`` (удаленно). + Этот метод возвращает GID удаленной загрузки. - Следующие примеры удаляют загрузку GID#2089b05ecca3d829. + Следующие примеры удаляют загрузку c GID#2089b05ecca3d829. **Пример JSON-RPC** @@ -2366,84 +2392,84 @@ RPC-метод `system.multicall` обрабатывается особым об .. function:: aria2.forceRemove([secret], gid) Этот метод удаляет загрузку, которая обозначена *gid*. Метод действует - подобно :func:`aria2.remove`, за исключением того, что - метод удаляет загрузку без каких-либо действий, которые требует времени, - например связь с BitTorrent-трекером. + подобно :func:`aria2.remove`, за исключением того, что метод удаляет + загрузку без выполнения каких-либо действий, которые требуют времени, + например связь с BitTorrent-трекерами для отмены регистрации загрузки. .. function:: aria2.pause([secret], gid) - Этот метод приостанавливает загрузку, которая обозначена *gid*. Параметр - *gid* имеет тип строки. Статус приостановки станет ``paused`` - (приостановлено). Если загрузка активна, то загрузка переместится на первую - позицию в очередь ожидания. Пока статус ``paused``, загрузка не начнется. Для - смены статуса на ``waiting``, используйте метод :func:`aria2.unpause`. + Этот метод приостанавливает загрузку, которая обозначена *gid* (строка). + Статус приостановки станет ``paused`` (приостановлено). Если загрузка активна, + то загрузка переместится в начало очереди ожидания. Пока статус ``paused``, + загрузка не начнется. Для смены статуса на ``waiting``, используйте метод + :func:`aria2.unpause`. Этот метод возвращает GID приостановленной загрузки. .. function:: aria2.pauseAll([secret]) Этот метод эквивалентен по вызову :func:`aria2.pause`, для каждой - активной/ожидающей закачки. Этот метод возвращает ``OK``, в случае - успеха. + активной/ожидающей закачки. Этот метод возвращает ``OK``. .. function:: aria2.forcePause([secret], pid) Этот метод приостанавливает загрузку, которая обозначена *gid*. Метод - действует подобно :func:`aria2.pause`, за исключением - того, что метод приостанавливает загрузку без каких-либо действий, которые - требует времени, например связь с BitTorrent-трекером. + действует подобно :func:`aria2.pause`, за исключением того, что метод + приостанавливает загрузки без выполнения каких-либо действий, которые + требуют времени,например связь с BitTorrent-трекерами для отмены + регистрации загрузки. .. function:: aria2.forcePauseAll([secret]) Этот метод эквивалентен по вызову :func:`aria2.forcePause`, для каждой - активной/ожидающей закачки. Этот метод возвращает ``OK``, в случае успеха. + активной/ожидающей загрузки. Этот метод возвращает ``OK``. .. function:: aria2.unpause([secret], gid) - Этот метод изменяет статус загрузки, которая обозначена 'gid', с ``paused`` на - ``waiting``. Это позволяет перезапускать загрузку. Значение ключа *gid* имеет - тип строки. Этот метод возвращает GID, снятой с паузы, загрузки. + Этот метод изменяет статус загрузки, которая обозначена 'gid' (строка), с + ``paused`` на ``waiting``, что позволяет перезапускать загрузку. + Этот метод возвращает GID загрузки, снятой с паузы. .. function:: aria2.unpauseAll([secret]) Этот метод эквивалентен по вызову :func:`aria2.unpause`, для каждой - активной/ожидающей закачки. Этот метод возвращает ``OK``, в случае успеха. + активной/ожидающей закачки. Этот метод возвращает ``OK``. .. function:: aria2.tellStatus([secret], gid[, keys]) - Этот метод возвращает состояние загрузки, которая обозначена *gid*. Параметр - *gid* имеет тип строка. Параметр *keys* имеет тип массив строк. Если *keys* - указан, то ответ содержит определенные значения в массиве *keys*. Если - *keys* пустой или не указан, то ответ содержит все значения. Это полезно, - если вы хотите использовать определенные параметры, чтобы исключить - множество пересылок. Например, - ``aria2.tellStatus("2089b05ecca3d829", ["gid", "status"])`` возвратит *gid* и - 'status'. Ответ имеет тип структура и содержит следующие поля. Поле имеет - тип строка. + Этот метод возвращает состояние загрузки, которая обозначена *gid* (строка). + Параметр *keys* - это массив строк. Если *keys* указан, то ответ содержит + только ключи в массиве *keys*. Если *keys* пустой или пропущен, то ответ + содержит все ключи. Это полезно, если вы хотите использовать определенные + параметры, чтобы исключить множество пересылок. Например, ``aria2.tellStatus("2089b05ecca3d829", ["gid", "status"])`` + возвратит только ключи *gid* и *status*. Ответ - это структура и содержит + следующие ключи. Значения являются строками. ``gid`` - GID этой загрузки. + GID загрузки. ``status`` - ``active`` - загружаемая/сидируемая в данный момент. ``waiting`` - ожидающая в - очереди; загрузка не началась. ``paused`` - приостановленная. ``error`` - - остановленная, т.к. произошла ошибка. ``complete`` - остановленная и - завершенная загрузка. ``removed`` - удаленная пользователем загрузка. + ``active`` - загружаемая/сидируемая в данный момент. + ``waiting`` - ожидающая в очереди; загрузка не началась. + ``paused`` - приостановленная. + ``error`` - остановленная, т.к. произошла ошибка. + ``complete`` - остановленная и завершенная загрузка. + ``removed`` - удаленная пользователем загрузка. ``totalLength`` - Общий объем загрузки в байтах. + Общий объём загрузки в байтах. ``completedLength`` - Загруженный объем загрузки в байтах. + Загруженный объём загрузки в байтах. ``uploadLength`` - Выгруженный объем загрузки в байтах. + Выгруженный объём загрузки в байтах. ``bitfield`` Шестнадцатеричное представление процесса загрузки. Старший бит соответствует - блоку с индексом 0. Бит устанавливается, если блок доступен и не - устанавливается, если блок отсутствует. Запасные биты в конце - устанавливаются в 0. Если загрузка еще не начался, этот значение не будет - включено в ответ. + блоку с индексом 0. Любые биты устанавливаются, если блоки загружены и не + устанавливаются, если блоки не загружены и/или отсутствуют. Любые избыточные биты + в конце устанавливаются в 0. Если загрузка ещё не была запущена, этот ключ не будет + включён в ответ. ``downloadSpeed`` Скорость загрузки в байт/сек. @@ -2455,7 +2481,7 @@ RPC-метод `system.multicall` обрабатывается особым об Информация о хэше (InfoHash). Только для BitTorrent. ``numSeeders`` - Количество сидов, к которым подключен клиент. Только для BitTorrent. + Количество сидов, к которым подключена aria2. Только для BitTorrent. ``pieceLength`` Размер блока в байтах. @@ -2464,32 +2490,32 @@ RPC-метод `system.multicall` обрабатывается особым об Количество блоков. ``connections`` - Количество пиров/серверов, к которым подключен клиент. + Количество пиров/серверов, к которым подключена aria2. ``errorCode`` - Последний код ошибки, которая произошла при загрузке. Значение имеет тип - строки. Коды ошибок определены в разделе `КОДЫ ЗАВЕРШЕНИЯ`_. Это значение доступно - только для остановленных/завершенных загрузок. + Код последней ошибки для этого элемента, если таковая имеется. Значение + является строкой. Коды ошибок определены в разделе `КОДЫ ЗАВЕРШЕНИЯ`_. + Это значение доступно только для остановленных/завершённых загрузок. ``followedBy`` - Список с GID, которые сгенерированы в результате запуска этой + Список с GID, которые сгенерируются в результате этой загрузки. Например, когда aria2 загружает Metalink-файл, то это генерирует - загрузки, описанные в нем (см. параметр + загрузки, описанные в Metalink-файле (см. параметр :option:`--follow-metalink`). Это значение полезно для отслеживания автоматически - сгенерированных загрузок. Если таких загрузок нет, то значение не будет - включено в ответ. + сгенерированных загрузок. Если таких загрузок нет, то ключ не будет + включён в ответ. ``belongsTo`` GID родительской загрузки. Некоторые загрузки являются частью другой - загрузки. Например, если файл в Metalink содержит BitTorrent-ответ, загрузка - ".torrent" будет частью этого файла. Если эта загрузка не имеет родительской - загрузки, то значение не будет включено в ответ. + загрузки. Например, если файл в Metalink содержит BitTorrent ресурсы, + загрузки ".torrent" файлов будут частями этого родителя. Если эта + загрузка не имеет родителя, то ключ не будет включён в ответ. ``dir`` Каталог для сохранения файлов. ``files`` - Возвращает список файлов. Элемент списка - это структура, такая же, что и в + Возвращает список файлов. Элементы списка - это структуры, такие же, что и в методе :func:`aria2.getFiles`. ``bittorrent`` @@ -2497,11 +2523,11 @@ RPC-метод `system.multicall` обрабатывается особым об Только для BitTorrent. Содержит следующие поля. ``announceList`` - Список списков URI анонса. Если .torrent-файл содержит анонс, а не - список-анонс, то анонс конвертируется в формат списка-анонса. + Список списков URI анонса. Если торрент содержит ```announce``, а не + `announce-list``, то `announce`` конвертируется в формат `announce-list``. ``comment`` - Комментарий по торренту. Используется ``comment.utf-8``, если доступно. + Комментарий торрента. Используется ``comment.utf-8``, если доступно. ``creationDate`` Время создания торрента. Значение является целым числом, с начала века, @@ -2520,7 +2546,7 @@ RPC-метод `system.multicall` обрабатывается особым об **Пример JSON-RPC** - Следующий пример получает информацию о загрузке GID#2089b05ecca3d829:: + Следующий пример получает информацию о загрузке с GID#2089b05ecca3d829:: >>> import urllib2, json >>> from pprint import pprint @@ -2551,8 +2577,7 @@ RPC-метод `system.multicall` обрабатывается особым об u'uploadLength': u'0', u'uploadSpeed': u'0'}} - Следующий пример получает информацию об определенных полях, который вас - интересуют:: + Следующий пример получает только определённые ключи:: >>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer', ... 'method':'aria2.tellStatus', @@ -2570,7 +2595,7 @@ RPC-метод `system.multicall` обрабатывается особым об **Пример XML-RPC** - Следующий пример получает информацию о загрузке GID#2089b05ecca3d829:: + Следующий пример получает информацию о загрузке с GID#2089b05ecca3d829:: >>> import xmlrpclib >>> from pprint import pprint @@ -2598,8 +2623,7 @@ RPC-метод `system.multicall` обрабатывается особым об 'uploadLength': '0', 'uploadSpeed': '0'} - Следующий пример получает информацию об определенных полях, который вас - интересуют:: + Следующий пример получает только определённые ключи:: >>> r = s.aria2.tellStatus('2089b05ecca3d829', ['gid', 'totalLength', 'completedLength']) >>> pprint(r) @@ -2607,15 +2631,15 @@ RPC-метод `system.multicall` обрабатывается особым об .. function:: aria2.getUris([secret], gid) - Этот метод возвращает URI, используемые в загрузке, которая обозначена - *gid*. Параметр *gid* имеет тип строка. Ответ имеет тип массив, а элемент - - тип структура и содержит следующие поля. Поле имеет тип строка. + Этот метод возвращает URI, используемые в загрузке, которые обозначены + *gid* (строка). Ответ - это массив структур и они содержат следующие ключи. + Значения являются строкой. ``uri`` URI ``status`` - 'used', если URI уже использован. 'waiting', если URI ожидает в очереди. + 'used', если URI используется. 'waiting', если URI все ещё ожидает в очереди. **Пример JSON-RPC** :: @@ -2644,12 +2668,12 @@ RPC-метод `system.multicall` обрабатывается особым об .. function:: aria2.getFiles([secret], gid) - Этот метод возвращает список файлов загрузки, которая обозначена - *gid*. Параметр *gid* имеет тип строка. Ответ имеет тип массив, а элемент - - тип структура и содержит следующие поля. Поле имеет тип строка. + Этот метод возвращает список файлов загрузки, которая обозначена *gid* (строка). + Ответ - это массив и содержит следующие ключи. + Значения являются строками. ``index`` - Индекс файла. Начинается с 1. Последовательность файлов такая же, что и в + Индекс файла, начинается с 1, в том же порядке, как файлы появляются в многофайловом торренте. ``path`` @@ -2659,21 +2683,21 @@ RPC-метод `system.multicall` обрабатывается особым об Размер файла в байта. ``completedLength`` - Загруженный объем файла в байтах. Обратите внимание, что вполне возможно, - что сумма completedLength меньше чем в методе - :func:`aria2.tellStatus`. Это потому, что completedLength в - :func:`aria2.getFiles` считаются только завершенные - блоки. С другой стороны, completedLength в - :func:`aria2.tellStatus` учитывает частично завершенные блоки. + Загруженный объём файла в байтах. Обратите внимание, вполне возможно, + что сумма ``completedLength`` меньше чем возвращаемая методом + :func:`aria2.tellStatus`. Это потому, что в ``completedLength`` + :func:`aria2.getFiles` включены только завершенные + блоки. С другой стороны, в ``completedLength`` + :func:`aria2.tellStatus` также включены частично завершённые блоки. ``selected`` ``true`` - если этот файл выбран параметром :option:`--select-file`. Если параметр :option:`--select-file` не указан или это однофайловый торрент - или загрузка не торрент, то это значение всегда будет ``true``. + или загрузка вообще не торрент, то это значение всегда будет ``true``. Иначе ``false``. ``uris`` - Возвращает список URI для этого файла. Элемент списка такая же структура, + Возвращает список URI для этого файла. Тип элемента такая же структура, что используется в методе :func:`aria2.getUris`. **Пример JSON-RPC** @@ -2714,10 +2738,9 @@ RPC-метод `system.multicall` обрабатывается особым об .. function:: aria2.getPeers([secret], gid) - Этот метод возвращает список пиров загрузки, которая обозначена - *gid*. Параметр *gid* имеет тип строка. Этот метод только для - BitTorrent. Ответ имеет тип массив, а элемент - тип структура и содержит - следующие поля. Поле имеет тип строка. + Этот метод возвращает список пиров загрузки, которая обозначена *gid* (строка). + Этот метод только для BitTorrent. Ответ - это массив структур, которые содержат + следующие ключи. Значения являются строками. ``peerId`` Закодированное ID пира. @@ -2731,14 +2754,14 @@ RPC-метод `system.multicall` обрабатывается особым об ``bitfield`` Шестнадцатеричное представление процесса загрузки. Старший бит соответствует блоку с индексом 0. Бит устанавливается, если блок доступен и не - устанавливается, если блок отсутствует. Запасные биты в конце + устанавливается, если блок отсутствует. Любые запасные биты в конце устанавливаются в 0. ``amChoking`` - ``true`` - если этот клиент блокирует пира. Иначе ``false``. + ``true`` - если aria2 блокирует пира. Иначе ``false``. ``peerChoking`` - ``true`` - если пир блокирует этого клиента. Иначе ``false``. + ``true`` - если пир блокирует aria2. Иначе ``false``. ``downloadSpeed`` Скорость загрузки (байт/сек), с которой этот клиент получает от пира. @@ -2747,7 +2770,7 @@ RPC-метод `system.multicall` обрабатывается особым об Скорость выгрузки (байт/сек), с которой этот клиент отдает пиру. ``seeder`` - ``true`` - если этот клиент является сидом. Иначе ``false``. + ``true`` - если этот пир является сидом. Иначе ``false``. **Пример JSON-RPC** :: @@ -2810,19 +2833,18 @@ RPC-метод `system.multicall` обрабатывается особым об .. function:: aria2.getServers([secret], gid) Этот метод возвращает текущие подключенные HTTP(S)/FTP-серверы загрузки, - которая обозначена *gid*. Параметр *gid* имеет тип строка. Ответ имеет тип - массив, а элемент - тип структура и содержит следующие поля. Поле имеет тип - строка. + которая обозначена *gid* (строка). Ответ - это массив структур, которые содержат + следующие ключи. Значения являются строками. ``index`` - Индекс файла. Начинается с 1. Последовательность файлов такая же, что и в - многофайловом торренте. + Индекс файла, начинается с 1, в том же порядке, как файлы появляются в + многофайловом metalink. ``servers`` - Список структур, которые содержат следующие поля. + Список структур, которые содержат следующие ключи. ``uri`` - Первоначально добавленный URI. + Исходный URI. ``currentUri`` Это URI в настоящее время используется для загрузки. Если происходит @@ -2863,26 +2885,25 @@ RPC-метод `system.multicall` обрабатывается особым об .. function:: aria2.tellActive([secret], [keys]) - Этот метод возвращает список активных загрузок. Ответ имеет тип массив и его - элемент такая же структура, которая возвращается методом - :func:`aria2.tellStatus`. За разъяснениями о - параметре 'keys', обратитесь к методу - :func:`aria2.tellStatus`. + Этот метод возвращает список активных загрузок. Ответ - это массив таких же структур, + возвращаемых методом :func:`aria2.tellStatus`. За разъяснениями о + параметре *keys*, обратитесь к методу :func:`aria2.tellStatus`. .. function:: aria2.tellWaiting([secret], offset, num, [keys]) Этот метод возвращает список ожидающих загрузок, включая приостановленные - загрузки. *offset* имеет целочисленный тип и указывает смещение, начиная от - ожидающей загрузки. *num* имеет целочисленный тип и указывает число - возвращаемых загрузок. За разъяснениями о параметре 'keys', обратитесь к - методу :func:`aria2.tellStatus`. + загрузки. + *offset* является целым числом и указывает смещение, начиная от + ожидающей загрузки. + *num* является целым числом и указывает максимальное число возвращаемых загрузок. + За разъяснениями о параметре *keys*, обратитесь к методу :func:`aria2.tellStatus`. Если смещение положительное целое число, то этот метод возвращает загрузки в диапазоне [*offset*, *offset*+*num*). *offset* может быть отрицательным целым числом. *offset* == -1 указывает на последнею загрузку, которая ожидает в очереди, а *offset* == -2 указывает на - загрузку перед последней, и так далее. Загрузки в ответе находятся в + загрузку перед последней, и так далее. Тогда загрузки в ответе находятся в обратном порядке. Например, допустим, что есть три загрузки "A","B" и "C", в этом порядке, @@ -2890,42 +2911,43 @@ RPC-метод `system.multicall` обрабатывается особым об ``aria2.tellWaiting(1, 2)`` возвратит ``["B", "C"]``. ``aria2.tellWaiting(-1, 2)`` возвратит ``["C", "B"]``. - Ответ имеет тип массив и его элемент такая же структура, которая - возвращается методом :func:`aria2.tellStatus`. + Ответ - это массив таких же структур, возвращаемых методом + :func:`aria2.tellStatus`. .. function:: aria2.tellStopped([secret], offset, num, [keys]) - Этот метод возвращает список остановленных загрузок. *offset* имеет - целочисленный тип и указывает смещение, начиная с самой старой - загрузки. *num* имеет целочисленный тип и указывает число возвращаемых - загрузок. За разъяснениями о параметре 'keys', обратитесь к методу - :func:`aria2.tellStatus`. + Этот метод возвращает список остановленных загрузок. + *offset* является целым числом и указывает смещение, начиная от + последней, недавно остановленной, загрузки. + *num* является целым числом и указывает максимальное число возвращаемых загрузок. + За разъяснениями о параметре *keys*, обратитесь к методу :func:`aria2.tellStatus`. - *offset* и *num* имеют такую же семантику, как и в методе + *offset* и *num* имеют такую же семантику, как описано в методе :func:`aria2.tellWaiting`. - Ответ имеет тип массив и его элемент такая же структура, которая - возвращается методом :func:`aria2.tellStatus`. + Ответ - это массив таких же структур, возвращаемых методом + :func:`aria2.tellStatus`. .. function:: aria2.changePosition([secret], gid, pos, how) - Этот метод меняет позицию загрузки, которая обозначена *gid*. *pos* имеет - целочисленный тип. *how* имеет тип строка. Если *how* - ``POS_SET``, то это + Этот метод меняет позицию загрузки, которая в очереди обозначена *gid*. + *pos* является целым числом. + *how* является строкой. Если *how* - ``POS_SET``, то это переместит загрузку на позицию, относительно начала очереди. Если *how* - ``POS_CUR``, это переместит загрузку на позицию, относительно текущей позиции. Если *how* - ``POS_END``, это переместит загрузку на позицию, относительно конца очереди. Если целевая позиция меньше чем 0 или за пределами конца очереди, это переместит загрузку в начало или конец очереди - соответственно. Ответ имеет целочисленный тип и является целевой позицией. + соответственно. Ответ является целым числом, обозначающее получающуюся позицию. - Например, если GID#2089b05ecca3d829 размещается на позиции 3, + Например, если текущей позицией GID#2089b05ecca3d829 является 3, то ``aria2.changePosition('2089b05ecca3d829', -1, 'POS_CUR')`` - изменит его позицию на 2. Дополнительно + изменит позицию на 2. Дополнительно ``aria2.changePosition('2089b05ecca3d829', 0, 'POS_SET')`` - изменит его позицию на 0 (начало очереди). + изменит позицию на 0 (начало очереди). Следующие примеры перемещают загрузку GID#2089b05ecca3d829 в начало - очереди ожидания. + очереди. **Пример JSON-RPC** @@ -2952,7 +2974,7 @@ RPC-метод `system.multicall` обрабатывается особым об .. function:: aria2.changeUri([secret], gid, fileIndex, delUris, addUris[, position]) Этот метод удаляет URI в *delUris* из загрузки и добавляет URI в *addUris* к - загрузке, которая обозначена *gid*. *delUris* и *addUris* являются списком + загрузке, которая обозначена *gid*. *delUris* и *addUris* являются списками строк. Загрузка может содержать несколько файлов и URI прилагаются к каждому файлу. *fileIndex* используется, чтобы выбрать файл для удаления/подключения заданных URI. *fileIndex* начинается с 1. *position* используется для @@ -2962,13 +2984,13 @@ RPC-метод `system.multicall` обрабатывается особым об добавление. *position* это позиция после URI, которые будут удалены, а не позиция, когда метод вызывается. При удалении URI, если одинаковые URI существуют в загрузке, только один из них будет удален, для каждого URI в - *delUris*. Другими словами, есть три URI ``http://example.org/aria2`` и вы - хотите удалить их все, вы должны указать (по крайней мере) 3 + *delUris*. Другими словами, если есть три URI ``http://example.org/aria2`` и вы + хотите удалить их все, то вы должны указать (по крайней мере) 3 ``http://example.org/aria2`` в *delUris*. Этот метод возвращает список, - который содержит 2 целых числа. Первое - количество удаленных URI. Второе - + который содержит два целых числа. Первое - количество удаленных URI. Второе - количество добавленных URI. - Следующие примеры добавляют 1 URI ``http://example.org/file`` к файлу + Следующие примеры добавляют URI ``http://example.org/file`` к файлу с индексом ``1``, принадлежащий загрузке GID#2089b05ecca3d829. **Пример JSON-RPC** @@ -2997,9 +3019,10 @@ RPC-метод `system.multicall` обрабатывается особым об .. function:: aria2.getOption([secret], gid) - Этот метод возвращает параметры загрузки, которая обозначена *gid*. Ответ - имеет тип структура. Ее поля - это название параметра. Поле имеет тип - строка. Обратите внимание, что этот метод не возвращает параметры, которые + Этот метод возвращает параметры загрузки, которая обозначена *gid*. + Ответ - это структура, где ключи являются именами параметров. Значения + являются строками. + Обратите внимание, что этот метод не возвращает параметры, которые не имеют значение по умолчанию и не были заданы параметрами командной строки, конфигурационными файлами или RPC-методами. @@ -3042,8 +3065,8 @@ RPC-метод `system.multicall` обрабатывается особым об .. function:: aria2.changeOption([secret], gid, options) Этот метод изменяет динамически параметры загрузки, которая обозначена - *gid*. *gid* имеет тип строка. *options* имеет тип структура. Доступны - следующие параметры для активных загрузок: + *gid* (строка). *options* является структурой. + Доступны следующие параметры для активных загрузок: * :option:`bt-max-peers <--bt-max-peers>` * :option:`bt-request-peer-speed-limit <--bt-request-peer-speed-limit>` @@ -3054,10 +3077,12 @@ RPC-метод `system.multicall` обрабатывается особым об Для ожидающих или приостановленных загрузок, в дополнение к выше перечисленным параметрам, доступны параметры, перечисленные в подразделе - `Входной файл`_, исключая следующие параметры: - :option:`dry-run <--dry-run>`, - :option:`metalink-base-uri <--metalink-base-uri>`, - :option:`parameterized-uri <-P>`, :option:`pause <--pause>`, :option:`piece-length <--piece-length>` и + `Входной файл`_, **исключая** следующие параметры: + :option:`dry-run <--dry-run>`, + :option:`metalink-base-uri <--metalink-base-uri>`, + :option:`parameterized-uri <-P>`, + :option:`pause <--pause>`, + :option:`piece-length <--piece-length>`, :option:`rpc-save-upload-metadata <--rpc-save-upload-metadata>`. Этот метод возвращает ``OK``, в случае успеха. @@ -3090,18 +3115,18 @@ RPC-метод `system.multicall` обрабатывается особым об .. function:: aria2.getGlobalOption([secret]) - Этот метод возвращает глобальные параметры. Ответ имеет тип структура. Ее - поля - это название параметра. Поле имеет тип строка. Обратите внимание, что - этот метод не возвращает параметры, которые не имеют значение по умолчанию и - не были заданы параметрами командной строки, конфигурационными файлами или - RPC-методами. Так как глобальные параметры используются в качестве шаблона - для вновь добавляемой загрузки, ответ содержит поля возвращаемые методом - :func:`aria2.getOption`. + Этот метод возвращает глобальные параметры. Ответ является структурой. Её + ключи - это названия параметров. Значения являются строками. + Обратите внимание, что этот метод не возвращает параметры, которые не имеют + значение по умолчанию и не были заданы параметрами командной строки, + конфигурационными файлами или RPC-методами. Так как глобальные параметры + используются в качестве шаблона для вновь добавляемых загрузок, ответ содержит + ключи возвращаемые методом :func:`aria2.getOption`. .. function:: aria2.changeGlobalOption([secret], options) - Этот метод изменяет динамически глобальные параметры. *options* имеет тип - структура. Доступны следующие параметры: + Этот метод изменяет динамически глобальные параметры. *options* является + структурой. Доступны следующие параметры: * :option:`bt-max-open-files <--bt-max-open-files>` * :option:`download-result <--download-result>` @@ -3115,22 +3140,24 @@ RPC-метод `system.multicall` обрабатывается особым об * :option:`save-session <--save-session>` * :option:`server-stat-of <--server-stat-of>` - В дополнение к ним, параметры перечисленные в подразделе `Входной файл`_, исключая следующие параметры: - :option:`checksum <--checksum>`, :option:`index-out <-O>`, - :option:`out <-o>`, :option:`pause <--pause>` и + В дополнение к ним, параметры перечисленные в подразделе `Входной файл`_, **исключая** следующие параметры: + :option:`checksum <--checksum>`, + :option:`index-out <-O>`, + :option:`out <-o>`, + :option:`pause <--pause>`, :option:`select-file <--select-file>`. - Используя параметр :option:`log <-l>`, вы можете динамически + C параметром :option:`log <-l>`, вы можете динамически начинать вести журнал событий или изменять файл журнала событий. Чтобы - остановить ведение журнала событий, задайте пустую строку ("") в качестве + остановить ведение журнала событий, укажите пустую строку ("") в качестве значения параметра. Обратите внимание, что файл журнала событий всегда открыт в режиме добавления. Этот метод возвращает ``OK``, в случае успеха. .. function:: aria2.getGlobalStat([secret]) Этот метод возвращает глобальную статистику по скорости загрузки и скорости - отдачи. Ответ имеет тип структура и содержит следующие поля. Поле имеет тип - строка. + отдачи. Ответ является структурой и содержит следующие ключи. Значения являются + строками. ``downloadSpeed`` Общая скорость загрузки (байт/сек). @@ -3149,7 +3176,7 @@ RPC-метод `system.multicall` обрабатывается особым об ограничено параметром :option:`--max-download-result`. ``numStoppedTotal`` - Количество остановленных загрузок в текущей сессии и не + Количество остановленных загрузок в текущей сессии и *не* ограничено параметром :option:`--max-download-result`. **Пример JSON-RPC** @@ -3219,14 +3246,14 @@ RPC-метод `system.multicall` обрабатывается особым об .. function:: aria2.getVersion([secret]) - Этот метод возвращает версию программы и список включенных - возможностей. Ответ имеет тип структура и содержит следующие поля. + Этот метод возвращает версию aria2 и список включенных + возможностей. Ответ является структурой и содержит следующие ключи. ``version`` - Номер версии программы в строке. + Номер версии aria2 в виде строки. ``enabledFeatures`` - Список включенных возможностей. Каждое имя возможности имеет тип строка. + Список включенных возможностей. Каждая возможность задаётся в виде строки. **Пример JSON-RPC** :: @@ -3269,8 +3296,8 @@ RPC-метод `system.multicall` обрабатывается особым об .. function:: aria2.getSessionInfo([secret]) - Этот метод возвращает информацию о сессии. Ответ имеет тип структура и - содержит следующие поля. + Этот метод возвращает информацию о сессии. + Ответ является структурой и содержит следующие ключи. ``sessionId`` ID сессии, которое генерируется каждый раз, при запуске aria2. @@ -3302,10 +3329,12 @@ RPC-метод `system.multicall` обрабатывается особым об .. function:: aria2.forceShutdown([secret]) - Этот метод закрывает aria2. Метод действует подобно - :func:`aria2.shutdown`, за исключением того, что - метод выполняется без каких-либо действий, которые требует времени, связь с - BitTorrent-трекером пропускается. Метод возвращает ``OK``. + Этот метод закрывает aria2. Метод действует подобно :func:`aria2.shutdown`, + за исключением того, что метод выполняется без выполнения каких-либо действий, + которые требуют времени, например связь с BitTorrent-трекерами для отмены + регистрации загрузок. + Метод возвращает ``OK``. + .. function:: aria2.saveSession([secret]) @@ -3315,13 +3344,13 @@ RPC-метод `system.multicall` обрабатывается особым об .. function:: system.multicall(methods) - Этот метод объединяет несколько вызовов методов в один запрос. *methods* - имеет тип массив, а элемент является структурой. Структура содержит два - поля: ``methodName`` и ``params``. ``methodName`` - это имя вызываемого метода, а - ``params`` - содержит параметры к методу. Метод возвращает массив - ответов. Элемент массива будет одним из двух: массивом из одного элемента, - который содержит возвращаемое значение, для каждого вызываемого метода или - структурой с ошибками в полях, если вызов объединенного метода завершился + Этот метод объединяет несколько вызовов методов в один запрос. + *methods* является массив структур. Структуры содержат два ключа поля: + ``methodName`` и ``params``. ``methodName`` - это имя вызываемого метода, а + ``params`` - содержит параметры вызова метода. Метод возвращает массив + ответов. Элементы массива будут одним из двух: массивом из одного элемента, + который содержит возвращаемое значение, для вызываемого метода или + структурой ошибочного элемента, если вызов объединённого метода завершился неудачно. В следующих примерах мы добавляем 2 загрузки. Первая - @@ -3342,7 +3371,7 @@ RPC-метод `system.multicall` обрабатывается особым об >>> pprint(json.loads(c.read())) {u'id': u'qwer', u'jsonrpc': u'2.0', u'result': [[u'2089b05ecca3d829'], [u'd2703803b52216d1']]} - JSON-RPC также поддерживает пакетный запрос, который описывается в + JSON-RPC дополнительно поддерживает пакетные запросы, которые описываются в спецификации JSON-RPC 2.0:: >>> jsonreq = json.dumps([{'jsonrpc':'2.0', 'id':'qwer', @@ -3371,10 +3400,11 @@ RPC-метод `system.multicall` обрабатывается особым об Обработка ошибок ~~~~~~~~~~~~~~~~ -В JSON-RPC, aria2 возвращает JSON-объект, который содержит код ошибки в коде -и сообщение об ошибке в сообщении. +Через JSON-RPC, aria2 возвращает JSON-объект, который содержит код ошибки в +``code`` и сообщение об ошибке в ``message``. -В XML-RPC, aria2 возвращает faultCode=1 и сообщение об ошибке в faultString. +Через XML-RPC, aria2 возвращает ``faultCode=1`` и сообщение об ошибке в +``faultString``. .. _rpc_options: @@ -3412,9 +3442,10 @@ RPC-метод `system.multicall` обрабатывается особым об Параметры :option:`header <--header>` и :option:`index-out <-O>` допускают нескольких определений в командной строке. Поскольку имя должно быть -уникальным в структуре (многие реализации библиотеки XML-RPC использует хэш -или словарь для структуры), одной строки недостаточно. Для преодоления этой -ситуации, они могут взять массив в качестве значения, а также строку. +уникальным в структуре (многие реализации библиотеки XML-RPC используют хэш +или словарь для структуры), одной строки недостаточно. Для преодоления этого +ограничения, вы можете использовать массив в качестве значения, а также +строку. Пример JSON-RPC ^^^^^^^^^^^^^^^ @@ -3442,8 +3473,9 @@ RPC-метод `system.multicall` обрабатывается особым об -Следующий пример добавляет загрузку с двумя параметрами: dir и -header. Параметр header имеет 2 значения, поэтому используется список:: +Следующий пример добавляет загрузку с двумя параметрами: ``dir`` и +``header``. Параметр ``header`` требует 2 значения, поэтому используется +список:: >>> import xmlrpclib >>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc') @@ -3457,7 +3489,7 @@ header. Параметр header имеет 2 значения, поэтому и JSON-RPC используя HTTP GET ~~~~~~~~~~~~~~~~~~~~~~~~~~~ -JSON-RPC-интерфейс также поддерживает запрос через HTTP GET. Схема +JSON-RPC-интерфейс также поддерживает запросы через HTTP GET. Схема кодирования в GET параметров основанных на JSON-RPC через HTTP Спецификация [2008-1-15(RC1)]. Кодирование параметров через GET следующие:: @@ -3481,12 +3513,12 @@ params - ``["2089b05ecca3d829"]``, следовательно:: --(Кодирование процентом)--> WyIyMDg5YjA1ZWNjYTNkODI5Il0%3D -JSON-RPC-интерфейс поддерживает JSONP. Вы можете определить функцию +JSON-RPC-интерфейс также поддерживает JSONP. Вы можете определить функцию обратного вызова в параметре ``jsoncallback``:: /jsonrpc?method=aria2.tellStatus&id=foo¶ms=WyIyMDg5YjA1ZWNjYTNkODI5Il0%3D&jsoncallback=cb -Для пакетного запроса, параметры ``method`` и ``id`` не должны быть +Для пакетных запросов, параметры ``method`` и ``id`` не должны быть указаны. Полный запрос должен быть определен в параметре ``params``. Например, пакетный запрос:: @@ -3510,20 +3542,21 @@ JSON-RPC через WebSocket использует тот же самый мет последовательную форму JSON-строку в текстовом фрейме. Ответ от RPC-сервера также доставляется в текстовом фрейме. -RPC-сервер отправит уведомление клиенту. Уведомление является -однонаправленным, поэтому клиент, который получил уведомление, не должен -отвечать на него. Метод сигнатуры уведомления такой же, как нормальный метод -запроса, но отсутствует идентификатор ключа. Значение, связанное с ключом -params, является данными, которые переносит это уведомление. Формат этого -значения варьируется в зависимости от метода уведомления. Определены -следующие методы уведомления. +Уведомления +^^^^^^^^^^^ +RPC-сервер может отправлять уведомления клиенту. Уведомления являются +однонаправленными, поэтому клиент, который получает уведомление, не должен +отвечать на него. Метод сигнатуры уведомления такой же, как нормальный +запрос метода, но отсутствует ключ id. Значение, связанное с ключом params, +является данными, которые переносит это уведомление. Формат этого значения +варьируется в зависимости от метода уведомления. Определены следующие методы +уведомления. .. function:: aria2.onDownloadStart(event) - - Это уведомление будет оправлено, если загрузка запущена. Параметр *event* - имеет тип структура и содержит следующие поля. Поле имеет тип строка. + Это уведомление будет оправлено, когда загрузка запущена. + Параметр *event* имеет тип структура и содержит следующие ключи. Ключ имеет тип строка. ``gid`` GID загрузки. @@ -3531,16 +3564,14 @@ params, является данными, которые переносит эт .. function:: aria2.onDownloadPause(event) - - Это уведомление будет оправлено, если загрузка приостановлена. *event* - + Это уведомление будет оправлено, когда загрузка приостановлена. *event* - такая же структура, как параметр *event* в методе :func:`aria2.onDownloadStart`. .. function:: aria2.onDownloadStop(event) - - Это уведомление будет оправлено, если загрузка остановлена + Это уведомление будет оправлено, когда загрузка остановлена пользователем. *event* - такая же структура, как параметр *event* в методе :func:`aria2.onDownloadStart`. @@ -3548,8 +3579,8 @@ params, является данными, которые переносит эт .. function:: aria2.onDownloadComplete(event) - Это уведомление будет оправлено, если загрузка завершена. В - BitTorrent-загрузках, это уведомление отправляется, когда загрузка завершена + Это уведомление будет оправлено, когда загрузка завершена. Для + BitTorrent-загрузок, это уведомление отправляется, когда загрузка завершена и сидирование окончено. *event* - такая же структура, как параметр *event* в методе :func:`aria2.onDownloadStart`. @@ -3557,7 +3588,7 @@ params, является данными, которые переносит эт .. function:: aria2.onDownloadError(event) - Это уведомление будет оправлено, если загрузка остановлена из-за + Это уведомление будет оправлено, когда загрузка остановлена из-за ошибки. *event* - такая же структура, как параметр *event* в методе :func:`aria2.onDownloadStart`. @@ -3565,17 +3596,16 @@ params, является данными, которые переносит эт .. function:: aria2.onBtDownloadComplete(event) - Это уведомление будет оправлено, если загрузка в BitTorrent завершена (но - сидирование может быть не закончено). *event* - такая же структура, как - параметр *event* в методе - :func:`aria2.onDownloadStart`. + Это уведомление будет оправлено, когда torrent-загрузка завершена, но + сидирование продолжается. *event* - такая же структура, как параметр *event* + в методе :func:`aria2.onDownloadStart`. Пример кода XML-RPC-клиента ~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Следующий Ruby-скрипт добавляет ``http://localhost/aria2.tar.bz2``, с -параметром :option:`--dir=/downloads, <-d>` в aria2c, которая работает на -localhost и отображает ответ: +Следующий Ruby-скрипт добавляет ``http://localhost/aria2.tar.bz2`` в aria2c +(работает на localhost) с параметром :option:`--dir=/downloads, <-d>` и +отображает RPC-ответ: .. code-block:: ruby @@ -3592,8 +3622,8 @@ localhost и отображает ответ: pp result -Если вы любитель Python, то можете использовать xmlrpclib(для Python3.x, -используйте взамен xmlrpc.client) для взаимодействия с aria2:: +Если вы любитель Python, то можете использовать xmlrpclib (Python3 +использует xmlrpc.client) для взаимодействия с aria2:: import xmlrpclib from pprint import pprint @@ -3608,8 +3638,8 @@ localhost и отображает ответ: Консольный индикатор ~~~~~~~~~~~~~~~~~~~~ -При загрузке файлов, aria2 отображает консольный индикатор, сообщающий о -прогрессе загрузок. Консольный индикатор имеет вид:: +При загрузке файлов, aria2 отображает индикатор на консоль, для отображения +прогресса загрузок. Консольный индикатор имеет вид:: [#2089b0 400.0KiB/33.2MiB(1%) CN:1 DL:115.7KiB ETA:4m51s] @@ -3617,22 +3647,22 @@ localhost и отображает ответ: ``#NNNNNN`` Первые 6 символов GID в виде шестнадцатеричной строки. GID является - уникальным ID для каждой загрузки. + уникальным ID (внутренний в aria2) для каждой загрузки. GID особенно полезен при + взаимодействии с aria2, используя RPC-интерфейс. ``X/Y(Z%)`` - Загруженный размер, общий размер и загруженный размер - в процентах. Если используется :option:`--select-file`, то + Загруженный размер, общий размер файла и процент выполнения загрузки. + Если используется :option:`--select-file`, то значение является суммой выбранных файлов. ``SEED`` - Рейтинг. Клиент сейчас сидирует(раздает). После завершения - BitTorrent-загрузки, этим заменяется информация о размере. + Рейтинг, когда aria2 сидирует завершённый торрент. ``CN`` - Количество соединений, установленных клиентом. + Количество соединений, установленных aria2. ``SD`` - Количество сидов, к которым сейчас подключен клиент. + Количество сидов, к которым сейчас подключена aria2. ``DL`` Скорость загрузки (байт/сек). @@ -3641,26 +3671,27 @@ localhost и отображает ответ: Скорость выгрузки (байт/сек) и количество выгруженных байт. ``ETA`` - Ожидаемое время завершения. + Ожидаемое время завершения загрузки. -При больше чем 1-ой загрузке, часть информации, описанной выше, будет -опущена, чтобы показать информации о нескольких загрузках. А общая скорость -загрузки и выгрузки будет показана в начале строки. +При больше чем 1-ой загрузке, выполняемой в данный момент, часть информации, +описанной выше будет опущена, чтобы показать информации о нескольких +загрузках. А общая скорость загрузки и выгрузки будет показана в начале +строки. Когда aria2 выделяет место под файл или проверяет контрольную сумму, то при -этом дополнительно отображается их прогресс: +этом дополнительно отображается прогресс этих операций: FileAlloc - GID, выделенный размер и общий размер в байтах. + GID, уже выделенный размер и общий размер в байтах. Checksum - GID, проверенный размер и общий размер в байтах. + GID, уже проверенный размер и общий размер в байтах. ПРИМЕРЫ ------- -Загрузка по HTTP/FTP -~~~~~~~~~~~~~~~~~~~~ +Сегментированные HTTP/FTP-загрузки +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Загрузка файла ^^^^^^^^^^^^^^ .. code-block:: console @@ -3681,15 +3712,20 @@ Checksum $ aria2c "http://host/file.zip" "http://mirror/file.zip" -Загрузка файла с одно хоста, используя 2 соединения -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Загрузка файла с одно хоста, используя множественные соединения +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: console $ aria2c -x2 -k1M "http://host/file.zip" +.. note:: -Загрузка файла с HTTP- и FTP-серверов -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + Параметр -x указывает количество разрешённых соединений, в то время как параметр -k + указывает размер частей данных. + + +Загрузка файла с HTTP- и FTP-серверов одновременно +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: console $ aria2c "http://host1/file.zip" "ftp://host2/file.zip" @@ -3725,7 +3761,6 @@ Checksum $ aria2c --ftp-proxy="http://proxy:8080" "ftp://host/file" - .. note:: Смотрите для подробностей :option:`--http-proxy`, @@ -3734,13 +3769,12 @@ Checksum :option:`--no-proxy`. Вы можете указать прокси в переменных окружения. Смотрите раздел `ОКРУЖЕНИЕ`_. -Прокси-сервер с авторизацией -^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Использование прокси-сервера с авторизацией +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: console $ aria2c --http-proxy="http://username:password@proxy:8080" "http://host/file" - .. code-block:: console $ aria2c --http-proxy="http://proxy:8080" --http-proxy-user="username" --http-proxy-passwd="password" "http://host/file" @@ -3773,8 +3807,8 @@ Checksum $ aria2c -j2 file1.metalink file2.metalink -Загрузка только выбранных файлов, используя индекс -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Загрузка только выбранных файлов +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: console $ aria2c --select-file=1-4,8 file.metalink @@ -3783,8 +3817,8 @@ Checksum Индекс выводится на консоль при использовании параметра -S. -Загрузка файла, используя локальный .metalink-файл с пользовательскими настройками -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Загрузка файла, используя локальный metalink-файл с пользовательскими настройками +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: console $ aria2c --metalink-location=jp,us --metalink-version=1.1 --metalink-language=en-US file.metalink @@ -3792,8 +3826,8 @@ Checksum Загрузка BitTorrent ~~~~~~~~~~~~~~~~~~~ -Загрузка файлов из удаленного BitTorrent-файла -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Загрузка файлов, используя удалённый BitTorrent-файл +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: console $ aria2c --follow-torrent=mem "http://host/file.torrent" @@ -3823,8 +3857,8 @@ Checksum .. note:: - Не забывайте заключать BitTorrent Magnet URI, в которой есть символ ``&``, в - одиночные(``'``) или двойные(``"``) кавычки. + Не забывайте заключать BitTorrent Magnet URI, в которых есть символы ``&``, в + одиночные(``'``) или двойные(``"``) кавычки, когда указывайте URI в командной строке. Загрузка 2-х торрентов ^^^^^^^^^^^^^^^^^^^^^^ @@ -3833,18 +3867,18 @@ Checksum $ aria2c -j2 file1.torrent file2.torrent -Загрузка файла, используя торрент и HTTP/FTP-сервер -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Параллельная загрузка файла посредством торрента и HTTP/FTP-сервера +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: console $ aria2c -Ttest.torrent "http://host1/file" "ftp://host2/file" .. note:: - Загрузка многофайлового торрента через HTTP/FTP не поддерживается. + Загрузка многофайлового торрента одновременно с использованием HTTP/FTP не поддерживается. -Загрузка только выбранных файлов, используя индекс (обычно называют "выборочная загрузка") -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Загрузка только определённых файлов (обычно называют "выборочная загрузка") +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: console $ aria2c --select-file=1-4,8 file.torrent @@ -3853,8 +3887,8 @@ Checksum Индекс выводится на консоль при использовании параметра -S. -Загрузка файла .torrent, без загрузки его содержимого -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Загрузка torrent-файла, без загрузки торрента +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: console $ aria2c --follow-torrent=false "http://host/file.torrent" @@ -3863,8 +3897,8 @@ Checksum ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Для указания выходного имени файла в BitTorrent-загрузках, вам нужно узнать -индекс файла в torrent-файле, используя параметр :option:`--show-files -<-S>`. Например, результат выглядит следующим образом:: +индекс файла в торренте (см.:option:`--show-files <-S>`). Например, вывод +выглядит следующим образом:: idx|path/length ===+====================== @@ -3885,27 +3919,26 @@ Checksum $ aria2c --dir=/tmp --index-out=1=mydir/base.iso --index-out=2=dir/driver.iso file.torrent -Изменение прослушиваемого порта для входящих соединений от пиров -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Изменение прослушиваемого порта для входящих соединений пиров +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: console $ aria2c --listen-port=7000-7001,8000 file.torrent .. note:: - Т.к. aria2 не настраивает брандмауэр или маршрутизатор для перенаправления + Т.к. aria2 не настраивает брандмауэры или маршрутизаторы для перенаправления портов, вам решать, как это сделать вручную. -Указать условие остановки программы после завершения загрузки торрента -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Указать условие остановки сидирования после завершения загрузки торрента +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: console $ aria2c --seed-time=120 --seed-ratio=1.0 file.torrent - .. note:: - В приведенном выше примере, программа завершается через 120 минут после + В приведенном выше примере, сидирование завершается через 120 минут после завершения загрузки или при достижении рейтинга сидирования 1.0. Регулировка скорости отдачи @@ -3914,7 +3947,6 @@ Checksum $ aria2c --max-upload-limit=100K file.torrent - Включить IPv4 DHT ^^^^^^^^^^^^^^^^^ .. code-block:: console @@ -3923,8 +3955,8 @@ Checksum .. note:: - DHT использует udp-порт. Так как aria2 не настраивает брандмауэр или - маршрутизатор для перенаправления портов, вам решать как это сделать + DHT использует UPD. Так как aria2 не настраивает брандмауэр или + маршрутизатор для перенаправления портов, вам решать, как это сделать вручную. Включить IPv6 DHT @@ -3935,12 +3967,12 @@ Checksum .. note:: - aria2 совместно использует один и тот же порт между IPv4 и IPv6 DHT. + aria2 использует те же порты для IPv4 и IPv6 DHT. Добавить и удалить URI трекера ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -Удалить все URI анонса трекеров, описанных в file.torrent и взамен +Игнорировать все URI анонса трекеров, определенные в file.torrent и взамен использовать ``http://tracker1/announce`` и ``http://tracker2/announce``: .. code-block:: console @@ -3960,14 +3992,17 @@ Checksum .. note:: - Вы можете использовать без изменения cookie-файл Firefox/Mozilla/Chromium. + Вы можете использовать без изменения cookie-файлы Firefox/Mozilla/Chromium. -Возобновление загрузки, которая начата в браузере или другой программе -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Возобновление загрузки, которая начата в браузере или других программах +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: console $ aria2c -c -s2 "http://host/partiallydownloadedfile.zip" +.. note:: + + Это будет работать только тогда, когда начальная загрузка не была многосегментной. Клиентский сертификат авторизации для SSL/TLS ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -3996,17 +4031,25 @@ Checksum расшифрован. Режим работы с исходно зашифрованным закрытым ключом не определен. -Проверить узел при SSL/TLS, используя исходные CA-сертификаты -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Проверить SSL/TLS-серверы, используя исходные CA-сертификаты +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: console $ aria2c --ca-certificate=/path/to/ca-certificates.crt --check-certificate https://host/file +.. note:: + + Эта возможность доступна только если aria2 была скомпилирована + с GnuTLS или OpenSSL. + WinTLS и AppleTLS всегда будет использовать хранилище сертификатов + системы. Вместо ``--ca-certificate`` установите сертификат в это + хранилище. + RPC ~~~ -Шифрование RPC-транспорта с использованием SSL/TLS -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Шифрование RPC-трафика с использованием SSL/TLS +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Указать PKC12-файл сервера: @@ -4019,21 +4062,32 @@ RPC Указанный в :option:`--rpc-certificate` файл должен содержать один PKCS12-закодированный сертификат и ключ. Пароль должен быть пустым. -В качестве альтернативы, когда PEM-файлы поддерживаются, указать файл с -сертификатом сервера и файл с закрытым ключом следующим образом: +В качестве альтернативы, когда PEM-файлы поддерживаются (GnuTLS и OpenSSL), +указать файл с сертификатом сервера и файл с закрытым ключом следующим +образом: .. code-block:: console $ aria2c --enable-rpc --rpc-certificate=/path/to/server.crt --rpc-private-key=/path/to/server.key --rpc-secure -И еще больше расширенных возможностей +И ещё больше расширенных возможностей ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Регулировка скорости загрузки ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +.. code-block:: console + +Одной загрузки: + .. code-block:: console $ aria2c --max-download-limit=100K file.metalink +Общая: + +.. code-block:: console + + $ aria2c --max-overall-download-limit=100K file.metalink + Исправить поврежденную загрузку ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -4046,8 +4100,8 @@ RPC При использовании BitTorrent или Metalink с контрольными суммами блоков данных можно эффективно исправлять поврежденные загрузки. -Отклонить соединение, если скорость загрузки меньше чем определенное значение -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Отклонить соединения, если скорость загрузки ниже указанного предела +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: console $ aria2c --lowest-speed-limit=10K file.metalink @@ -4081,8 +4135,8 @@ RPC $ aria2c -Z -P "http://host/image[A-Z:2].png" -Проверка контрольной суммы -^^^^^^^^^^^^^^^^^^^^^^^^^^ +Проверка контрольных сумм +^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: console $ aria2c --checksum=sha-1=0192ba11326fe2298c8cb4de616f4d4140213837 http://example.org/file @@ -4097,7 +4151,7 @@ RPC Шифрование BitTorrent ^^^^^^^^^^^^^^^^^^^^^ -Шифровать всю полезную нагрузку используя ARC4: +Шифровать всю полезную нагрузку используя ARC4 (обфускация): .. code-block:: console