.\" t .\" Title: aria2c .\" Author: Tatsuhiro Tsujikawa .\" Generator: DocBook XSL Stylesheets v1.75.2 .\" Date: 05/21/2011 .\" Manual: Aria2 Manual .\" Source: Aria2 1.11.2 .\" Language: English .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH ARIA2C 1 05/21/2011 "Aria2 1\&.11\&.2" "Руководство по Aria2" .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH НАЗВАНИЕ aria2c \- Ультра быстрая утилита загрузки .SH СИНТАКСИС .sp aria2c [\fIПАРАМЕТРЫ\fP] [\fIURI\fP | \fIMAGNET\-ССЫЛКА\fP | \fITORRENT\-ФАЙЛ\fP | \fIMETALINK\-ФАЙЛ\fP]\&... .SH ОПИСАНИЕ .sp aria2 \- это утилита для загрузки файлов\&. Поддерживаемые протоколы: HTTP(S), FTP, BitTorrent и Metalink\&. Для загрузки файла, aria2 может использовать разные источники/протоколы и пытается максимально использовать пропускной способности канала\&. Есть поддержка загрузки файла по протоколам HTTP(S)/FTP и BitTorrent одновременно, пока данные загружаются по HTTP(S)/FTP, они тут же могут выгружаться в BitTorrent\-рой\&. Используя контрольные суммы блока данных для Metalink, aria2 автоматически проверяет куски данных, которые загружаются по BitTorrent\&. .SH ПАРАМЕТРЫ .SS "Основные параметры" .PP \fB\-d\fP, \fB\-\-dir\fP=DIR .RS 4 Каталог для сохранения скачанных файлов\&. .RE .PP \fB\-i\fP, \fB\-\-input\-file\fP=FILE .RS 4 Загрузить URI, найденные в файле FILE\&. Вы можете указать несколько URI для одного объекта: отделяйте URI на одной строке, используя символ TAB\&. Читается ввод из stdin (стандартный поток ввода), когда указано \fI\-\fP\&. Дополнительные параметры можно указывать после каждой строки с URI\&. Эта необязательная строка должна начинаться с одного или нескольких пробелов и содержать один параметр\&. Смотрите подраздел \fBВходной файл\fP для детальных пояснений\&. .RE .PP \fB\-l\fP, \fB\-\-log\fP=LOG .RS 4 Имя файла для журнала событий\&. Если указан \fI\-\fP (дефис), то журнал событий будет записан в stdout (стандартный поток вывода).\& Если указана пустая строка (""), то журнал событий не будет записан в файл\&. .RE .PP \fB\-j\fP, \fB\-\-max\-concurrent\-downloads\fP=N .RS 4 Установить максимальное количество параллельных загрузок для каждого статического (HTTP/FTP) URI, torrent и metalink\&. Смотрите также параметры \fB\-s\fP и \fB\-C\fP\&. По умолчанию: \fI5\fP .RE .PP \fB\-V\fP, \fB\-\-check\-integrity\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Проверить целостность файла путем подтверждения хэшей блоков или хэша полного файла\&. Этот параметр влияет лишь на BitTorrent и Metalink загрузки с контрольной суммой блоков. Параметр может обнаружить поврежденные части файла и перезагрузить их\&. Если есть хэш полного файла, то проверка выполняется только когда файл уже полностью загружен\&. Момент полной загрузки определяется по размеру файла\&. Если проверка хэша завершилась неудачно, то файл будет перезагружен с нуля\&. Если есть хэши блоков и хэш полного файла, то будут использоваться только хэши блоков\&. По умолчанию: \fIfalse\fP .RE .PP \fB\-c\fP, \fB\-\-continue\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Продолжить загрузку частично загруженного файла\&. Используйте этот параметр, чтобы возобновить загрузку, начатую в веб\-браузере или в другой программе, которая загружает файлы последовательно сначала\&. Сейчас этот параметр можно использовать только для HTTP(S)/FTP загрузок\&. По умолчанию: \fIfalse\fP .RE .PP \fB\-h\fP, \fB\-\-help\fP[=TAG|KEYWORD] .RS 4 Справочное сообщение определяется метками (TAG)\&. Метки начинаются с "#"\&. Например, "\-\-help=#http" даст справку по параметрам, помеченным меткой "#http"\&. Если задано слово (KEYWORD), не являющееся меткой, то будет выведена справка по параметрам, содержащих это слово\&. Возможные значения: \fI#basic\fP, \fI#advanced\fP, \fI#http\fP, \fI#https\fP, \fI#ftp\fP, \fI#metalink\fP, \fI#bittorrent\fP, \fI#cookie\fP, \fI#hook\fP, \fI#file\fP, \fI#rpc\fP, \fI#experimental\fP, \fI#all\fP По умолчанию: \fI#basic\fP .RE .SS "Параметры HTTP/FTP" .PP \fB\-\-all\-proxy\fP=PROXY .RS 4 Использовать указанный прокси\-сервер для всех протоколов\&. Для стирания ранее определенного адрес используйте ""\&. Вы можете отменить эту установку и указать прокси\-сервер для отдельного протокола, используя параметры \fB\-\-http\-proxy\fP, \fB\-\-https\-proxy\fP и \fB\-\-ftp\-proxy\fP\&. Влияет на все URI\&. Формат PROXY \- [http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ]\&. Смотрите также раздел \fBОКРУЖЕНИЕ\fP .RE .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Если пользователь и пароль вставлены в URI\-прокси и они также указаны в параметрах \fB\-\-{http,https,ftp,all}\-proxy\-{user,passwd}\fP, то приоритетным будет самое последнее\&. Например, у вас 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\-user="myname" \-\-http\-proxy\-passwd="mypass" \-\-http\-proxy="http://user:pass@proxy", тогда запрос к HTTP\-прокси "http://proxy" будет с пользователем "user" и паролем "pass"\&. .sp .5v .RE .PP \fB\-\-all\-proxy\-passwd\fP=PASSWD .RS 4 Задать пароль для параметра \fB\-\-all\-proxy\fP\&. .RE .PP \fB\-\-all\-proxy\-user\fP=USER .RS 4 Задать пользователя для параметра \fB\-\-all\-proxy\fP\&. .RE .PP \fB\-\-connect\-timeout\fP=SEC .RS 4 Задать в соединении время ожидания в секундах для установки подключения к HTTP/FTP/прокси серверу\&. После установки подключения этот параметр не имеет значения, и вместо него используется параметр \fB\-\-timeout\fP\&. По умолчанию: \fI60\fP .RE .PP \fB\-\-dry\-run\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Если задано \fItrue\fP, aria2 только проверяет, является ли удаленный файл доступным и не загружает данные\&. Этот параметр влияет на HTTP/FTP загрузку\&. BitTorrent загрузки отменяются, если указано \fItrue\fP. По умолчанию: \fIfalse\fP .RE .PP \fB\-\-lowest\-speed\-limit\fP=SPEED .RS 4 Закрывать подключение, если скорость загрузки меньше чем или равна значению SPEED (байт в секунду)\&. 0 означает, что aria2 не имеет нижнего ограничения скорости\&. Вы можете добавить \fIK\fP или \fIM\fP(1K = 1024, 1M = 1024K)\&. Этот параметр не влияет на BitTorrent загрузки\&. По умолчанию: \fI0\fP .RE .PP \fB\-x\fP, \fB\-\-max\-connection\-per\-server\fP=NUM .RS 4 Максимально количество соединений с одним сервером для каждой загрузки\&. По умолчанию: \fI1\fP .RE .PP \fB\-\-max\-file\-not\-found\fP=NUM .RS 4 Если aria2 получает статус "file not found" (файл не найден) с удаленных HTTP/FTP серверов NUM раз без получения хотя бы одного байта, тогда принудительно отказывается от загрузки. Укажите 0, чтобы отключить этот параметр. Этот параметр действенен только, когда используются HTTP/FTP серверы\&. По умолчанию: \fI0\fP .RE .PP \fB\-m\fP, \fB\-\-max\-tries\fP=N .RS 4 Задать количество попыток\&. \fI0\fP означает неограниченно. Смотрите также \fB\-\-retry\-wait\fP\&. По умолчанию: \fI5\fP .RE .PP \fB\-k\fP, \fB\-\-min\-split\-size\fP=SIZE .RS 4 aria2 не разбивает на части меньше чем 2*SIZE байт\&. Например, нужно загрузить файл размером 20МиБ\&. Если SIZE задать 10M, то aria2 может разбить файл на части в 2\-ух диапазонах [0\-10МиБ) и [10МиБ\-20МиБ) и загрузить его используя 2 источника (если \fB\-\-split\fP >= 2, конечно же)\&. Если SIZE задать 15M, т.к. 2*15M > 20MiB, aria2 не разобьет файл на части и загрузит его используя 1 источник\&. Вы можете добавить \fIK\fP или \fIM\fP(1K = 1024, 1M = 1024K)\&. Возможные значения: \fI1M\fP\-\fI1024M\fP По умолчанию: \fI20M\fP .RE .PP \fB\-n\fP, \fB\-\-no\-netrc\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Отключить поддержку netrc\&. Поддержка netrc по умолчанию включена\&. .RE .PP \fB\-\-no\-proxy\fP=ДОМЕНЫ .RS 4 Укажите через запятую имена хостов, домены и сетевые адреса с CIDR\-блоком, или без него, для которых не будет использоваться прокси\&. .RE .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Для сетевых адресов с CIDR\-блоком (метод IP\-адресации, например 192.168.0.20/24), работают только IPv4 адреса\&. Текущая реализация не разрешает имена хостов в URI для сравнения сетевых адресов указанных в \fB\-\-no\-proxy\fP\&. Таким образом это эффективно только если в URI есть IP\-адреса\&. .sp .5v .RE .PP \fB\-o\fP, \fB\-\-out\fP=FILE .RS 4 Сохранить загруженный файл под указанным именем\&. Если используется параметр \fB\-Z\fP, то данный параметр игнорируется. .RE .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp В Metalink или BitTorrent загрузках вы не можете указать имя файла\&. Имя файла указывается здесь только когда используются URI и aria2 с командной строкой без параметров \fB\-i\fP, \fB\-Z\fP\&. Например: aria2c \-o myfile\&.zip "http://mirror1/file\&.zip" "http://mirror2/file\&.zip" .sp .5v .RE .PP \fB\-\-proxy\-method\fP=METHOD .RS 4 Задать метод для использования в прокси\-запросах\&. \fIMETHOD\fP один из двух: \fIget\fP или \fItunnel\fP\&. HTTPS загрузки всегда используют \fItunnel\fP, не обращая внимания на этот параметр\&. По умолчанию: \fIget\fP .RE .PP \fB\-R\fP, \fB\-\-remote\-time\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Извлекать временную метку файла с удаленного HTTP/FTP сервера и, если это доступно, применить ее к локальному файлу\&. По умолчанию: \fIfalse\fP .RE .PP \fB\-\-reuse\-uri\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Повторно использовать уже использованные URI, если не осталось неиспользованных URI\&. По умолчанию: \fItrue\fP .RE .PP \fB\-\-retry\-wait\fP=SEC .RS 4 Задать в секундах интервал ожидания между повторными попытками\&. При SEC > 0, если HTTP сервер возвращает ответ 503, aria2 будет снова пытаться загрузить\&. По умолчанию: \fI0\fP .RE .PP \fB\-\-server\-stat\-of\fP=FILE .RS 4 Указать имя файла, в который сохраняется профиль функционирования сервера\&. Вы можете загрузить сохраненные данные, используя параметр \fB\-\-server\-stat\-if\fP\&. Формат файла смотрите ниже в подразделе \fBПрофиль функционирования сервера\fP\&. .RE .PP \fB\-\-server\-stat\-if\fP=FILE .RS 4 Указать имя файла для загрузки профиля функционирования сервера. Загруженные данные будут использованы в некоторых URI селекторах, таких как \fIfeedback\fP. Смотрите также параметр \fB\-\-uri\-selector\fP\&. Формат файла смотрите ниже в подразделе \fBПрофиль функционирования сервера\fP\&. .RE .PP \fB\-\-server\-stat\-timeout\fP=SEC .RS 4 Указывает время ожидания в секундах, для того, чтобы сделать недействительным профиль функционирования сервера, с тех пор, как состоялся последний контакт с ним\&. По умолчанию: \fI86400\fP (24 часа) .RE .PP \fB\-s\fP, \fB\-\-split\fP=N .RS 4 Загружать файл, используя N соединений\&. Если задано более чем N URI, будут использоваться первые N URI, а оставшиеся URI будут в резерве\&. Если задано менее чем N URI, то URI будут использованы более одного раза, так чтобы были задействованы все N соединений одновременно\&. Количество соединений к одному и тому же хосту ограничивается параметром \fB\-\-max\-connection\-per\-server\fP\&. Пожалуйста, смотрите также параметр \fB\-j\fP и \fB\-\-min\-split\-size\fP\&. Обратите внимание, что для Metalink загрузок этот параметр не эффективен, в место него используйте параметр \fB\-C\fP\&. По умолчанию: \fI5\fP .RE .PP \fB\-t\fP, \fB\-\-timeout\fP=SEC .RS 4 Задать время ожидания в секундах\&. По умолчанию: \fI60\fP .RE .PP \fB\-\-uri\-selector\fP=SELECTOR .RS 4 Указать алгоритм выбора URI\&. Возможные значения: \fIinorder\fP, \fIfeedback\fP и \fIadaptive\fP\&. Если задано \fIinorder\fP, то URI проверяются в порядке представления в списке URI\&. Если задано \fIfeedback\fP, aria2 использует скорость загрузки, которая наблюдалась в предыдущих загрузках, и выбирает самый быстрый сервер в списке URI\&. Это также эффективно исключает мертвые зеркала. Наблюдаемая скорость загрузки является частью профиля функционирования сервера, упомянутой в параметрах \fB\-\-server\-stat\-of\fP и \fB\-\-server\-stat\-if\fP\&. Если задано \fIadaptive\fP, выбирается одно из лучших зеркал для первого и резервного соединений\&. Дополнительно, возвращаются зеркала, которые пока не были проверены, и, если каждое из них уже проверено, возвращаются зеркала, которые должны быть проверены снова\&. Иначе зеркала больше не выбираются.\& Подобно \fIfeedback\fP, используются профиль функционирования сервера\&. По умолчанию: \fIfeedback\fP .RE .SS "Специфические параметры HTTP" .PP \fB\-\-ca\-certificate\fP=FILE .RS 4 Использовать сертификат авторизации в FILE для проверки узлов\&. Сертификат должен быть в PEM\-формате и содержать многоразовые CA\-сертификаты\&. Используйте параметр \fB\-\-check\-certificate\fP, чтобы разрешить проверку\&. .RE .PP \fB\-\-certificate\fP=FILE .RS 4 Использовать клиентский сертификат в FILE\&. Сертификат должен быть в PEM\-формате\&. Вы можете использовать параметр \fB\-\-private\-key\fP, чтобы указать закрытый ключ\&. .RE .PP \fB\-\-check\-certificate\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Проверять каждый из используемых сертификатов, которые указаны в параметре \fB\-\-ca\-certificate\fP\&. По умолчанию: \fItrue\fP .RE .PP \fB\-\-http\-accept\-gzip\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Посылать "Accept: deflate, gzip" в запросе\-заголовке и добавлять в ответ, если удаленный сервер ответит "Content\-Encoding: gzip" или "Content\-Encoding: deflate"\&. По умолчанию: \fIfalse\fP .RE .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Некоторые серверы отвечают "Content\-Encoding: gzip" для файлов, которые сами по себе сжаты (gzipped)\&. aria2 добавляет их так или иначе из\-за заголовка ответа\&. .sp .5v .RE .PP \fB\-\-http\-auth\-challenge\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Отправлять заголовок HTTP авторизации только тогда, когда он запрошен с сервера\&. Если задано \fIfalse\fP, тогда заголовок авторизации всегда отправляется на сервер\&. Существует исключение: если имя пользователя и пароль являются встроенными в URI, то заголовок авторизации всегда отправляется на сервер, независимо от этого параметра\&. По умолчанию: \fIfalse\fP .RE .PP \fB\-\-http\-no\-cache\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Посылать заголовок Cache\-Control: no\-cache и Pragma: no\-cache, чтобы избежать кэширования содержимого\&. Если задано \fIfalse\fP, то эти заголовки не посылаются и вы можете добавить любую директиву к заголовку Cache\-Control с помощью параметра \fB\-\-header\fP\&. По умолчанию: \fItrue\fP .RE .PP \fB\-\-http\-user\fP=USER .RS 4 Задать пользователя для HTTP\&. Влияет на все URI\&. .RE .PP \fB\-\-http\-passwd\fP=PASSWD .RS 4 Задать пароль для HTTP\&. Влияет на все URI\&. .RE .PP \fB\-\-http\-proxy\fP=PROXY .RS 4 Использовать указанный прокси\-сервер для HTTP\&. Ранее указанный адрес можно стереть, указав ""\&. Смотрите также параметр \fB\-\-all\-proxy\fP\&. Влияет на все URI\&. Формат PROXY \- [http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ]\&. .RE .PP \fB\-\-http\-proxy\-passwd\fP=PASSWD .RS 4 Задать пароль для параметра \fB\-\-http\-proxy\fP\&. .RE .PP \fB\-\-http\-proxy\-user\fP=USER .RS 4 Задать пользователя для параметра \fB\-\-http\-proxy\fP\&. .RE .PP \fB\-\-https\-proxy\fP=PROXY .RS 4 Использовать указанный прокси\-сервер для HTTPS\&. Ранее указанный адрес можно стереть, указав ""\&. Смотрите также параметр \fB\-\-all\-proxy\fP\&. Влияет на все URI\&. Формат PROXY \- [http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ]\&. .RE .PP \fB\-\-https\-proxy\-passwd\fP=PASSWD .RS 4 Задать пароль для параметра \fB\-\-https\-proxy\fP\&. .RE .PP \fB\-\-https\-proxy\-user\fP=USER .RS 4 Задать пользователя для параметра \fB\-\-https\-proxy\fP\&. .RE .PP \fB\-\-private\-key\fP=FILE .RS 4 Использовать закрытый ключ в FILE\&. Закрытый ключ должен быть дешифрованным и в PEM\-формате\&. Режим работы с исходно зашифрованным закрытым ключом не определен\&. Смотрите также параметр \fB\-\-certificate\fP\&. .RE .PP \fB\-\-referer\fP=REFERER .RS 4 Задать источника запроса\&. Влияет на все URI\&. .RE .PP \fB\-\-enable\-http\-keep\-alive\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Включить HTTP/1\&.1 постоянное соединение\&. По умолчанию: \fItrue\fP .RE .PP \fB\-\-enable\-http\-pipelining\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Включить конвейерную обработку HTTP/1\&.1\&. По умолчанию: \fIfalse\fP .RE .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp С точки зрения производительности, как правило, нет преимущества от включения этого параметра\&. .sp .5v .RE .PP \fB\-\-header\fP=HEADER .RS 4 Добавлять HEADER к HTTP запросу\-заголовку\&. Вы можете использовать этот параметр повторно, чтоб указать более одного заголовка: aria2c \fB\-\-header\fP="X\-A: b78" \fB\-\-header\fP="X\-B: 9J1" "http://host/file" .RE .PP \fB\-\-load\-cookies\fP=FILE .RS 4 Загружать куки\-файл из FILE, используя форматы Firefox3 (SQLite3), Chromium/Google Chrome (SQLite3) и Mozilla/Firefox(1\&.x/2\&.x)/Netscape\&. .RE .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Если aria2 собрана без libsqlite3, то форматы куки\-файлов Firefox3 и Chromium/Google Chrome не поддерживаются\&. .sp .5v .RE .PP \fB\-\-save\-cookies\fP=FILE .RS 4 Сохранить куки в FILE формате Mozilla/Firefox(1\&.x/2\&.x)/Netscape\&. Если FILE уже существует, то он будет перезаписан\&. Куки\-сессия также сохранится и значение ее окончания будет трактоваться как 0\&. Возможные значения: \fI/путь/к/файлу\fP .RE .PP \fB\-\-use\-head\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Использовать метод HEAD для первого запроса к HTTP серверу\&. По умолчанию: \fIfalse\fP .RE .PP \fB\-U\fP, \fB\-\-user\-agent\fP=USER_AGENT .RS 4 Задать клиентское приложение для HTTP(S) загрузок\&. По умолчанию: \fIaria2/$VERSION\fP, $VERSION заменяется на версию пакета\&. .RE .SS "Специфические параметры FTP" .PP \fB\-\-ftp\-user\fP=USER .RS 4 Задать пользователя для FTP\&. Влияет на все URI\&. По умолчанию: \fIanonymous\fP .RE .PP \fB\-\-ftp\-passwd\fP=PASSWD .RS 4 Задать пароль для FTP\&. Влияет на все URI\&. Если имя пользователя встроено, но пароль отсутствует в URI, то aria2 пытается использовать пароль из \&.netrc\&. Если пароль найден в \&.netrc, то он используется\&. Если нет, используется пароль указанный в этом параметре\&. По умолчанию: \fIARIA2USER@\fP .RE .PP \fB\-p\fP, \fB\-\-ftp\-pasv\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Использовать пассивный режим FTP\&. Если задано \fIfalse\fP, то будет использован активный режим\&. По умолчанию: \fItrue\fP .RE .PP \fB\-\-ftp\-proxy\fP=PROXY .RS 4 Использовать указанный прокси\-сервер для FTP\&. Ранее указанный адрес можно стереть, указав ""\&. Смотрите также параметр \fB\-\-all\-proxy\fP\&. Влияет на все URI\&. Формат PROXY \- [http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ] .RE .PP \fB\-\-ftp\-proxy\-passwd\fP=PASSWD .RS 4 Задать пароль для параметра \fB\-\-ftp\-proxy\fP\&. .RE .PP \fB\-\-ftp\-proxy\-user\fP=USER .RS 4 Задать пользователя для параметра \fB\-\-ftp\-proxy\fP\&. .RE .PP \fB\-\-ftp\-type\fP=TYPE .RS 4 Задать тип передачи для FTP\&. TYPE может быть один из двух: \fIbinary\fP или \fIascii\fP\&. По умолчанию: \fIbinary\fP .RE .PP \fB\-\-ftp\-reuse\-connection\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Повторно использовать FTP соединение\&. По умолчанию: \fItrue\fP .RE .SS "Параметры BitTorrent/Metalink" .PP \fB\-\-select\-file\fP=INDEX\&... .RS 4 Задать файл для загрузки по заданному индексу\&. Вы можете найти индекс файла, используя параметр \fB\-\-show\-files\fP. Составной индекс можно указать, используя ",", например: \fI3,6\fP\&. Вы можете также использовать "\-", чтобы указать диапазон: \fI1\-5\fP\&. "," и "\-" могут быть использованы вместе: \fI1\-5,8,9\fP\&. Когда используется с параметром \fB\-M\fP, индекс может сильно зависеть от запроса (смотрите параметры \fB\-\-metalink\-\fP*)\&. .RE .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp В много файловом торренте, смежные файлы, указанные в этом параметре также могут быть загружены\&. Это не ошибка, а особенность утилиты\&. Одиночный блок данных может включать несколько файлов или часть файла, и aria2 запишет блок данных соответствующего файла\&. .sp .5v .RE .PP \fB\-S\fP, \fB\-\-show\-files\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Вывести список файлов из \&.torrent, \&.meta4 или \&.metalink и выйти. Для файла \&.torrent будет выведена более детальная информация (информация по хэшу, размер блока и др.)\&. .RE .SS "Специфические параметры BitTorrent" .PP \fB\-\-bt\-enable\-lpd\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Включить поиск локальных пиров\&. Если в torrent\-файле установлен приватный признак, то aria2 не будет использовать эту возможность, даже если задано \fItrue\fP\&. По умолчанию: \fIfalse\fP .RE .PP \fB\-\-bt\-exclude\-tracker\fP=URI[,\&...] .RS 4 Разделенный запятыми список URI анонса BitTorrent\-трекера, которые будут исключены\&. Вы можете использовать специальное значение "*", которое соответствует всем URI, таким образом исключаются все URI анонса\&. При указании "*" в оболочке командной строке, не забывайте, экранировать или брать в кавычки. Смотрите также параметр \fB\-\-bt\-tracker\fP\&. .RE .PP \fB\-\-bt\-external\-ip\fP=IPADDRESS .RS 4 Указать внешний IP\-адрес BitTorrent\-трекера для отчета\&. Не смотря на то, что эта функция названа "external" ("внешний"), она может принимать любой IP\-адрес\&. IPADDRESS должен быть числовым IP\-адресом\&. .RE .PP \fB\-\-bt\-hash\-check\-seed\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Если задано \fItrue\fP, то после проверки хэша с использованием параметра \fB\-\-check\-integrity\fP и когда файл загружен полностью, продолжается раздача файла\&. Если вы хотите проверить файл и загрузить его только если он поврежден или не загружен полностью, то задайте этот параметр как \fIfalse\fP\&. Этот параметр влияет лишь на BitTorrent загрузки\&. По умолчанию: \fItrue\fP .RE .PP \fB\-\-bt\-lpd\-interface\fP=INTERFACE .RS 4 Использовать для поиска локальных пиров заданный интерфейс. Если этот параметр не указан, используется интерфейс по умолчанию. Можно указать имя интерфейса и IP\-адрес. Возможные значения: интерфейс, IP\-адрес .RE .PP \fB\-\-bt\-max\-open\-files\fP=NUM .RS 4 Указать максимальное количество файлов для открытия в каждой BitTorrent загрузке\&. По умолчанию: \fI100\fP .RE .PP \fB\-\-bt\-max\-peers\fP=NUM .RS 4 Указать максимальное количество узлов для каждого торрента\&. \fI0\fP означает неограниченно\&. Смотрите также параметр \fB\-\-bt\-request\-peer\-speed\-limit\fP\&. По умолчанию: \fI55\fP .RE .PP \fB\-\-bt\-metadata\-only\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Загрузить только метаданные\&. Файл(ы), описывающий метаданные не должен быть загружен\&. Этот параметр эффективен только если используется BitTorrent Magnet\-ссылка\&. Смотрите также параметр \fB\-\-bt\-save\-metadata\fP\&. По умолчанию: \fIfalse\fP .RE .PP \fB\-\-bt\-min\-crypto\-level\fP=\fIplain\fP|\fIarc4\fP .RS 4 Задать минимальный уровень метода шифрования\&. Если узел поддерживает несколько методов шифрования, aria2 выбирает наименьший, который удовлетворяет заданный уровень\&. По умолчанию: \fIplain\fP .RE .PP \fB\-\-bt\-prioritize\-piece\fP=\fIhead\fP[=SIZE],\fItail\fP[=SIZE] .RS 4 Пытаться загрузить сначала первую и последнюю части каждого файла\&. Это бывает полезно для предварительного просмотра файлов\&. Аргумент может содержать 2 ключевых слова: \fIhead\fP и \fItail\fP\&. Для включения обоих, необходимо разделить их запятой\&. Ключевые слова принимают один параметр, SIZE\&. Например, если указано \fIhead\fP=SIZE, части, в пределах первых SIZE байт каждого файла, получат повышенный приоритет\&. \fItail\fP=SIZE обозначает диапазон из последних SIZE байт каждого файла\&. SIZE может включать букву \fIK\fP или \fIM\fP для обозначения размера в килобайтах или мегабайтах, соответственно (1K = 1024, 1M = 1024K)\&. Если SIZE пропущено, то будет использовано по умолчанию значение: SIZE=1M\&. .RE .PP \fB\-\-bt\-require\-crypto\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Если задано \fItrue\fP, aria2 не принимает и не устанавливает соединение с унаследованныммм BitTorrent handshake\-сообщением (рукопожатие) (BitTorrent протокол). Таким образом aria2 всегда использует обфускацию handshake\-сообщения. По умолчанию: \fIfalse\fP .RE .PP \fB\-\-bt\-request\-peer\-speed\-limit\fP=SPEED .RS 4 Если итоговая скорость загрузки каждого торрента ниже чем SPEED, aria2 временно увеличивает количество узлов, пытаясь увеличить скорость загрузки\&. Настройка этого параметра с выбранной вами скоростью загрузки может, в некоторых случаях, увеличить вашу скорость загрузки\&. Вы можете добавить \fIK\fP или \fIM\fP(1K = 1024, 1M = 1024K)\&. По умолчанию: \fI50K\fP .RE .PP \fB\-\-bt\-save\-metadata\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Сохранить метаданные как файл \&.torrent\&. Этот параметр эффективен только если используется BitTorrent Magnet\-ссылка\&. Имя файла шестнадцатеричное представление хэша с расширением \&.torrent\&. Файл сохранится в каталог, в тот же самый, куда сохранится загружаемый файл\&. Если тот же самый файл уже существует, метаданные не сохранятся\&. Смотрите также параметр \fB\-\-bt\-metadata\-only\fP\&. По умолчанию: \fIfalse\fP .RE .PP \fB\-\-bt\-seed\-unverified\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Раздавать первоначально загруженные файлы без проверки хэшей блоков\&. По умолчанию: \fIfalse\fP .RE .PP \fB\-\-bt\-stop\-timeout\fP=SEC .RS 4 Остановить BitTorrent загрузку, если скорость загрузки равна 0 на протяжении SEC секунд. Если задано \fI0\fP, то эта возможность не будет использоваться. По умолчанию: \fI0\fP .RE .PP \fB\-\-bt\-tracker\fP=URI[,\&...] .RS 4 Разделенный запятыми список дополнительных URI анонса BitTorrent\-трекеров\&. На эти URI не действует параметр \fB\-\-bt\-exclude\-tracker\fP, потому что они добавляются после URI, указанных в параметре \fB\-\-bt\-exclude\-tracker\fP, которые исключаются\&. .RE .PP \fB\-\-bt\-tracker\-connect\-timeout\fP=SEC .RS 4 Задать время ожидания в секундах для установки соединения с трекером\&. После установки соединения, это параметр станет не действительным, а вместо него будет использован \fB\-\-bt\-tracker\-timeout\fP\&. По умолчанию: \fI60\fP .RE .PP \fB\-\-bt\-tracker\-interval\fP=SEC .RS 4 Задать интервал в секундах между запросами трекера\&. Это полностью отменяет значение интервала и aria2 использует только это значение и игнорирует минимальный интервал и значение интервала в ответе трекера\&. Если задан \fI0\fP, aria2 определяет интервал основываясь на ответе трекера и прогрессе загрузки\&. По умолчанию: \fI0\fP .RE .PP \fB\-\-bt\-tracker\-timeout\fP=SEC .RS 4 Задать время ожидания в секундах\&. По умолчанию: \fI60\fP .RE .PP \fB\-\-dht\-entry\-point\fP=HOST:PORT .RS 4 Задать хост и порт, как точку входа в IPv4 DHT сеть\&. .RE .PP \fB\-\-dht\-entry\-point6\fP=ХОСТ:ПОРТ .RS 4 Задать хост и порт, как точку входа в IPv6 DHT сеть\&. .RE .PP \fB\-\-dht\-file\-path\fP=PATH .RS 4 Заменять файл таблицы маршрутизации IPv4 DHT на PATH\&. По умолчанию: \fI$HOME/\&.aria2/dht\&.dat\fP .RE .PP \fB\-\-dht\-file\-path6\fP=PATH .RS 4 Заменять файл таблицы маршрутизации IPv6 DHT на PATH\&. По умолчанию: \fI$HOME/\&.aria2/dht\&.dat\fP .RE .PP \fB\-\-dht\-listen\-addr6\fP=ADDR .RS 4 Указать адрес привязки сокета для IPv6 DHT\&. Он должен быть глобальным IPv6 unicast\-адресом хоста\&. .RE .PP \fB\-\-dht\-listen\-port\fP=PORT\&... .RS 4 Задать прослушиваемый UDP\-порт для обоих IPv4 и IPv6 DHT\&. Несколько портов можно указать через ",", например: \fI6881,6885\fP\&. Вы так же можете использовать "\-" что бы указать диапазон: \fI6881\-6999\fP\&. "," и "\-" могут быть использованы вместе\&. По умолчанию: \fI6881\-6999\fP .RE .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Удостоверьтесь, что указанные порты открыты для входящего UDP\-трафика\&. .sp .5v .RE .PP \fB\-\-dht\-message\-timeout\fP=SEC .RS 4 Задать время ожидания в секундах\&. По умолчанию: \fI10\fP .RE .PP \fB\-\-enable\-dht\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Включить IPv4 DHT функциональность\&. Если в torrent\-файле задан приватный признак, aria2 не будет использовать DHT для загрузки, даже если установлен \fItrue\fP\&. По умолчанию: \fItrue\fP .RE .PP \fB\-\-enable\-dht6\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Включить IPv6 DHT функциональность\&. Если в torrent\-файле задан приватный признак, aria2 не будет использовать DHT для загрузки, даже если установлен \fItrue\fP\&. Используйте параметр \fB\-\-dht\-listen\-port\fP для указания прослушиваемого порта\&. Смотрите также параметр \fB\-\-dht\-listen\-addr6\fP\&. .RE .PP \fB\-\-enable\-peer\-exchange\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Включить расширение BitTorrent\-протокола для обмена списками участников\&. Если в torrent\-файле задан приватный признак, то эта возможность будет отключена, даже если установлен \fItrue\fP\&. По умолчанию: \fItrue\fP .RE .PP \fB\-\-follow\-torrent\fP=\fItrue\fP|\fIfalse\fP|\fImem\fP .RS 4 Если указать \fItrue\fP или \fImem\fP, тогда загруженный файл, расширение которого \- "\&.torrent" или mime\-тип \- "application/x\-bittorrent", aria2 анализирует как torrent\-файл и загружает файлы указанные в нем\&. Если указано \fImem\fP, тогда torrent\-файл не записывается на диск, а содержится в памяти\&. Если указано \fIfalse\fP, действия, упомянутые выше не совершаются\&. По умолчанию: \fItrue\fP .RE .PP \fB\-O\fP, \fB\-\-index\-out\fP=INDEX=PATH .RS 4 Задать путь к файлу с индексом=INDEX\&. Вы можете найти индекс файла используя параметр \fB\-\-show\-files\fP\&. PATH является относительным путем к тому, который указан в параметре \fB\-\-dir\fP\&. Вы можете использовать этот параметр много раз\&. Используйте этот параметр, когда хотите указать имена выходных файлов для BitTorrent\-загрузок\&. .RE .PP \fB\-\-listen\-port\fP=PORT\&... .RS 4 Указать номер TCP\-порта для BitTorrent\-загрузок. Несколько портов можно указать используя ",", например: \fI6881,6885\fP\&. Вы также можете использовать "\-", чтоб указать диапазон: \fI6881\-6999\fP\&. "," и "\-" могут быть использованы вместе: \fI6881\-6889,6999\fP\&. По умолчанию: \fI6881\-6999\fP .RE .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Удостоверьтесь, что указанные порты открыты для входящего TCP\-трафика\&. .sp .5v .RE .PP \fB\-\-max\-overall\-upload\-limit\fP=SPEED .RS 4 Задать максимальную общую скорость отдачи в байтах/сек\&. \fI0\fP значит неограничено\&. Вы можете добавить \fIK\fP или \fIM\fP(1K = 1024, 1M = 1024K)\&. Чтобы ограничить скорость отдачи для узла торрента, используйте параметр \fB\-\-max\-upload\-limit\fP\&. По умолчанию: \fI0\fP .RE .PP \fB\-u\fP, \fB\-\-max\-upload\-limit\fP=SPEED .RS 4 Задать максимальную скорость отдачи каждого узла торрента в байтах/сек\&. \fI0\fP значит неограниченно\&. Вы можете добавить \fIK\fP или \fIM\fP(1K = 1024, 1M = 1024K)\&. Чтобы ограничить общую скорость отдачи, используйте параметр \fB\-\-max\-overall\-upload\-limit\fP\&. По умолчанию: \fI0\fP .RE .PP \fB\-\-peer\-id\-prefix\fP=PEER_ID_PREFIX .RS 4 Указать префикс для ID узла\&. ID узла в BitTorrent имеет размер 20 байт\&. Если будет указано более 20 байт, то только первые 20 будут использоваться, если будет указано меньше 20, то они будут дополнены случайными данными до 20 байт\&. По умолчанию: \fIaria2/$VERSION\fP, $VERSION заменяется на версию пакета\&. .RE .PP \fB\-\-seed\-ratio\fP=RATIO .RS 4 Указать рейтинг\&. Сидировать завершенные торренты, пока рейтинг не станет больше RATIO\&. Очень рекомендуется указать тут равный или больший \fI1\&.0\fP\&. Указать \fI0\&.0\fP, если вы планируете сидировать независимо от рейтинга\&. Если указан параметр \fB\-\-seed\-time\fP вместе с этим параметром, сидирование закончится тогда, когда хотя бы одно условие будет удовлетворено\&. .RE .PP \fB\-\-seed\-time\fP=MINUTES .RS 4 Указать время сидирования (раздачи) в минутах. Смотрите также параметр \fB\-\-seed\-ratio\fP\&. .RE .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Указаный \fB\-\-seed\-time\fP=\fI0\fP отключает сидирование после завершения загрузки\&. .sp .5v .RE .PP \fB\-T\fP, \fB\-\-torrent\-file\fP=TORRENT\-ФАЙЛ .RS 4 Путь к файлу \&.torrent\&. Вы не обязаны использовать этот параметр, т\&.к\&. файл \&.torrent можно указать без \fB\-T\fP\&. .RE .SS "Специфические параметры Metalink" .PP \fB\-\-follow\-metalink\fP=\fItrue\fP|\fIfalse\fP|\fImem\fP .RS 4 Если указано \fItrue\fP или \fImem\fP и когда загруженный файл имеет расширение "\&.meta4" или "\&.metalink", или mime\-тип "application/metalink4+xml" или "application/metalink+xml", aria2 считает его metalink\-файлом и загружает упомянутые в нем файлы.\& Если указано \fImem\fP, то metalink\-файл не сохраняется на диск, а просто хранится в памяти\&. Если указано \fIfalse\fP, то вышеприведенная операция не производится\&. По умолчанию: \fItrue\fP .RE .PP \fB\-\-metalink\-base\-uri\fP=URI .RS 4 Указать основной URI для разрешения относительных URI в элементе metalink:url и metalink:metaurl в metalink\-файле, сохраненном на локальном диске\&. Если URI указывает на каталог, то URI должен заканчиваться на \fI/\fP\&. .RE .PP \fB\-M\fP, \fB\-\-metalink\-file\fP=METALINK\-ФАЙЛ .RS 4 Путь к файлу \&.meta4 и \&.metalink\&. Читает ввод из stdin, если в качестве имени файла указано \fI\-\fP\&. Вы не обязаны использовать этот параметр, т\&.к\&. файлы \&.metalink можно указать без \fB\-M\fP\&. .RE .PP \fB\-C\fP, \fB\-\-metalink\-servers\fP=NUM_SERVERS .RS 4 Количество серверов для одновременного подключения\&. Некоторые Metalink регулируют количество серверов для соединения\&. aria2 точно придерживается их\&. Это значит, что если Metalink определяет атрибут maxconnections ниже чем NUM_SERVERS, тогда aria2 использует значение атрибута maxconnections вместо NUM_SERVERS\&. Смотрите также параметры \fB\-s\fP и \fB\-j\fP\&. По умолчанию: \fI5\fP .RE .PP \fB\-\-metalink\-language\fP=LANGUAGE .RS 4 The language of the file to download\&. .RE .PP \fB\-\-metalink\-location\fP=LOCATION[,\&...] .RS 4 Местонахождение предпочитаемого сервера\&. Список, разделенный запятыми, допустимых местонахождений, например, \fIjp,us\fP\&. .RE .PP \fB\-\-metalink\-os\fP=OS .RS 4 Целевая операционная система файла для загрузки\&. .RE .PP \fB\-\-metalink\-version\fP=VERSION .RS 4 The version of the file to download\&. .RE .PP \fB\-\-metalink\-preferred\-protocol\fP=PROTO .RS 4 Указать предпочитаемый протокол\&. Возможные значения: \fIhttp\fP, \fIhttps\fP, \fIftp\fP и \fInone\fP\&. Указать \fInone\fP для отключения этой возможности\&. По умолчанию: \fInone\fP .RE .PP \fB\-\-metalink\-enable\-unique\-protocol\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Если задано \fItrue\fP, а в metalink\-файле доступно несколько протоколов, то aria2 использует один из них\&. Используйте параметр \fB\-\-metalink\-preferred\-protocol\fP, чтобы указать предпочитаемый протокол\&. .RE .SS "Параметры RPC" .PP \fB\-\-enable\-rpc\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Включить JSON\-RPC/XML\-RPC сервер\&. Настоятельно рекомендуется указать имя пользователя и пароль, используя параметры \fB\-\-rpc\-user\fP и \fB\-\-rpc\-passwd\fP\&. Смотрите также параметр \fB\-\-rpc\-listen\-port\fP\&. По умолчанию: \fIfalse\fP .RE .PP \fB\-\-rpc\-listen\-all\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Слушать входящие JSON\-RPC/XML\-RPC запросы на всех сетевых интерфейсах\&. Если указано \fIfalse\fP, слушать только на локальном петлевом интерфейсе (loopback)\&. По умолчанию: \fIfalse\fP .RE .PP \fB\-\-rpc\-listen\-port\fP=PORT .RS 4 Указать номер порта, для прослушивания JSON\-RPC/XML\-RPC сервером\&. Возможные значения: \fI1024\fP\-\fI65535\fP\&. По умолчанию: \fI6800\fP .RE .PP \fB\-\-rpc\-max\-request\-size\fP=SIZE .RS 4 Задать максимальный размер JSON\-RPC/XML\-RPC\-запроса\&. Если aria2 выявит запрос с размером большим, чем SIZE байт, тогда соединение будет отклонено\&. По умолчанию: \fI2M\fP .RE .PP \fB\-\-rpc\-passwd\fP=PASSWD .RS 4 Задать JSON\-RPC/XML\-RPC пароль\&. .RE .PP \fB\-\-rpc\-user\fP=USER .RS 4 Задать JSON\-RPC/XML\-RPC пользователя\&. .RE .SS "Дополнительные параметры" .PP \fB\-\-allow\-overwrite\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Повторно запустить загрузку с нуля, если соответствующий контрольный файл отсутствует\&. Смотрите также параметр \fB\-\-auto\-file\-renaming\fP\&. По умолчанию: \fIfalse\fP .RE .PP \fB\-\-allow\-piece\-length\-change\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Если задано \fIfalse\fP, aria2 останавливает загрузку, когда длина блока отлична от той, которая находится в контрольном файле\&. Если задано \fItrue\fP, вы можете продолжать, однако некоторый прогресс загрузки будет потерян\&. По умолчанию: \fIfalse\fP .RE .PP \fB\-\-always\-resume\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Всегда возобновлять загрузку\&. Если задано \fItrue\fP, aria2 всегда пытается возобновить загрузку и если это не возможно, останавливает ее\&. Если задано \fIfalse\fP, тогда для всех заданных URI не поддерживается возобновление загрузки, или aria2 столкнется с невозможностью возобновления загрузки URI \fIN\fP\-ое количество раз (значение \fIN\fP указывается в параметре \fB\-\-max\-resume\-failure\-tries\fP), то aria2 будет загружать файл с нуля\&. Смотрите параметр \fB\-\-max\-resume\-failure\-tries\fP\&. По умолчанию: \fItrue\fP .RE .PP \fB\-\-async\-dns\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Включить асинхронный DNS\&. По умолчанию: \fItrue\fP .RE .PP \fB\-\-async\-dns\-server\fP=IPADDRESS[,\&...] .RS 4 Разделенный запятыми список адресов DNS\-серверов, которые используют асинхронный DNS\-преобразователь\&. Обычно асинхронный DNS\-преобразователь читает адреса DNS серверов из \fI/etc/resolv\&.conf\fP\&. Когда используется этот параметр, то используются DNS\-серверы указанные в параметре вместо указанных в \fI/etc/resolv\&.conf\fP\&. Вы можете указать оба IPv4 и IPv6 адреса\&. Этот параметр полезен, когда в системе нет \fI/etc/resolv\&.conf\fP и у пользователя нет прав на его создание\&. .RE .PP \fB\-\-auto\-file\-renaming\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Переименовать файл, если такой уже существует\&. Этот параметр работает только для HTTP(S)/FTP загрузок\&. К имени файла будет добавлена точка и число от 1 до 9999\&. По умолчанию: \fItrue\fP .RE .PP \fB\-\-auto\-save\-interval\fP=SEC .RS 4 Сохранять контрольный файл (*\&.aria2) каждые SEC секунд\&. Если задано \fI0\fP, тогда контрольный файл не сохраняется на протяжении загрузки\&. aria2 сохраняет контрольный файл тогда, когда останавливается, не смотря на значение\&. Возможные значения: от \fI0\fP до \fI600\fP\&. По умолчанию: \fI60\fP .RE .PP \fB\-\-conditional\-get\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Загружать файл только когда локальный файл старше чем удаленный\&. Эта функция работает только для HTTP(S)\-загрузок\&. Это не работает, если размер файла указан в Metalink\&. Это также игнорирует заголовок Content\-Disposition\&. Если контрольный файл существует, то этот параметр игнорируется\&. Эта функция использует заголовок If\-Modified\-Since, как условие для получения только нового файла\&. При получении времени модификации локального файла, используется указанное пользователем имя файла (см. параметр \fB\-\-out\fP) или часть имени файла в URI, если \fB\-\-out\fP не указан\&. Для перезаписи существующего файла необходим параметр \fB\-\-allow\-overwrite\fP\&. По умолчанию: \fIfalse\fP .RE .PP \fB\-\-conf\-path\fP=PATH .RS 4 Сменить путь к файлу конфигурации на PATH\&. По умолчанию: \fI$HOME/\&.aria2/aria2\&.conf\fP .RE .PP \fB\-D\fP, \fB\-\-daemon\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Запустить как демон (фоновый процесс)\&. Текущий рабочий каталог будет заменен на \fI/\fP, а стандартный ввод, стандартный вывод, стандартный вывод ошибок будут перенаправлены на \fI/dev/null\fP\&. По умолчанию: \fIfalse\fP .RE .PP \fB\-\-disable\-ipv6\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Отключить IPv6\&. Это полезно, если вы используете поврежденный DNS и хотите избежать ужасно медленного поиска AAAA\-записи\&. По умолчанию: \fIfalse\fP .RE .PP \fB\-\-enable\-async\-dns6\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Включить IPv6 разрешение имен в асинхронном DNS\-преобразователе\&. Этот параметр будет игнорироваться, если \fB\-\-async\-dns\fP=\fIfalse\fP\&. По умолчанию: \fIfalse\fP .RE .PP \fB\-\-enable\-direct\-io\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Включить прямое I/O (чтение/запись), которое уменьшает использование микропроцессора во время резервирования места для файла\&. Выключите, если произошла какая\-либо ошибка\&. По умолчанию: \fItrue\fP .RE .PP \fB\-\-event\-poll\fP=POLL .RS 4 Указать метод опроса событий\&. Возможные значения: \fIepoll\fP, \fIkqueue\fP, \fIport\fP, \fIpoll\fP и \fIselect\fP\&. Каждый метод \fIepoll\fP, \fIkqueue\fP, \fIport\fP и \fIpoll\fP доступен, если система поддерживает его\&. \fIepoll\fP доступен в современных дистрибутивах Linux\&. \fIkqueue\fP доступен в различных *BSD системах, включая Mac OS X\&. \fIport\fP доступен в Open Solaris\&. Значение по умолчанию может изменяться в зависимости от системы, которую вы используете\&. .RE .PP \fB\-\-file\-allocation\fP=METHOD .RS 4 Указать метод резервирования места для файла\&. \fInone\fP не происходит предварительное резервирование места для файла\&. \fIprealloc\fP \- предварительное резервирование места для файла перед началом загрузки\&. Это может продолжаться некоторое время, в зависимости от размера файла\&. Если вы используете новые файловые системы, наподобие ext4 (с поддержкой экстентов), btrfs или xfs, тогда лучше выбрать \fIfalloc\fP\&. Так как они резервируют место под большие (на несколько Гигабайт) файлы почти мгновенно\&. Не используйте \fIfalloc\fP вместе с наследными файловыми системами, такими как ext3 потому, что это будет продолжаться почти столько же времени, как и \fIprealloc\fP, а также полностью заблокирует aria2, пока не окончится резервирование места\&. \fIfalloc\fP может быть недоступным, если ваша система не содержит функцию \fBposix_fallocate\fP()\&. Возможные значения: \fInone\fP, \fIprealloc\fP, \fIfalloc\fP\&. По умолчанию: \fIprealloc\fP .RE .PP \fB\-\-human\-readable\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Выводить на консоль размеры и скорость в удобочитаемом формате (например, 1\&.2Ки, 3\&.4Ми)\&. По умолчанию: \fItrue\fP .RE .PP \fB\-\-interface\fP=INTERFACE .RS 4 Привязать сокеты к заданному интерфейсу\&. Вы можете указать имя интерфейса, IP\-адрес и имя хоста\&. Возможные значения: имя интерфейса (например, eth0), IP\-адрес (например, 192.168.0.12), имя хоста (например, myhost) .RE .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Если интерфейс имеет несколько адресов, то настоятельно рекомендуется указать IP\-адрес явно\&. Смотрите также \fB\-\-disable\-ipv6\fP\&. Если ваша система не имеет getifaddrs(), это параметр не принимает имя интерфейса\&. .sp .5v .RE .PP \fB\-\-max\-download\-result\fP=NUM .RS 4 Задать максимальное количество результатов загрузок, которые находятся в памяти\&. Результаты загрузок \- завершенные/ошибка/удаленные загрузки\&. Результаты загрузок хранятся FIFO очереди, в которой может хранится NUM результатов загрузок\&. Когда очередь заполнена и появляется новый результат загрузки, то старейший результат загрузки удаляется из начала очереди, а новый добавляется в конец\&. Указание большого числа в этом параметре может привести к высокому потреблению памяти после тысяч загрузок\&. Значение 0 отключит сохранение результата загрузки\&. По умолчанию: \fI1000\fP .RE .PP \fB\-\-max\-resume\-failure\-tries\fP=N .RS 4 Если параметр \fB\-\-always\-resume\fP=\fIfalse\fP, aria2 загрузит файл с нуля, при обнаружении \fIN\fP\-го URI, не поддерживающего возобновление\&. Если \fIN\fP=\fI0\fP, то aria2 загрузит файл с нуля, когда все URI не поддерживают возобновление\&. Смотрите параметр \fB\-\-always\-resume\fP\&. По умолчанию: \fI0\fP .RE .PP \fB\-\-log\-level\fP=LEVEL .RS 4 Задать уровень вывода журнала событий\&. LEVEL может быть: \fIdebug\fP, \fIinfo\fP, \fInotice\fP, \fIwarn\fP или \fIerror\fP\&. По умолчанию: \fIdebug\fP .RE .PP \fB\-\-on\-bt\-download\-complete\fP=COMMAND .RS 4 Для BitTorrent, в \fB\-\-on\-download\-complete\fP указывается команда, которая вызывается после завершение загрузки и окончания сидирования\&. С другой стороны, этот параметр определяет команду, которая будет выполнена после завершения загрузки, но до сидирования\&. Смотрите раздел \fBПерехват сообщения\fP для более подробной информации о COMMAND\&. Возможные значения: \fI/путь/к/команде\fP .RE .PP \fB\-\-on\-download\-complete\fP=COMMAND .RS 4 Задать команду, которая будет выполнена после завершения загрузки\&. Смотрите раздел \fBПерехват сообщения\fP для более подробной информации о COMMAND\&. Смотрите также параметр \fB\-\-on\-download\-stop\fP\&. Возможные значения: \fI/путь/к/команде\fP .RE .PP \fB\-\-on\-download\-error\fP=COMMAND .RS 4 Задать команду, которая будет выполнена после того, как загрузка будет прервана из\-за ошибки\&. Смотрите раздел \fBПерехват сообщения\fP для более подробной информации о COMMAND\&. Смотрите также параметр \fB\-\-on\-download\-stop\fP\&. Возможные значения: \fI/путь/к/команде\fP .RE .PP \fB\-\-on\-download\-pause\fP=COMMAND .RS 4 Задать команду, которая будет выполнена после того, как загрузка будет приостановлена\&. Смотрите раздел \fBПерехват сообщения\fP для более подробной информации о COMMAND\&. Возможные значения: \fI/путь/к/команде\fP .RE .PP \fB\-\-on\-download\-start\fP=COMMAND .RS 4 Задать команду, которая будет выполнена после того, как началась загрузка\&. Смотрите раздел \fBПерехват сообщения\fP для более подробной информации о COMMAND\&. Возможные значения: \fI/путь/к/команде\fP .RE .PP \fB\-\-on\-download\-stop\fP=COMMAND .RS 4 Задать команду, которая будет выполнена после того, как загрузка остановлена\&. Вы можете изменить команду, которая будет выполнятся при определенном результате загрузки, используя параметры \fB\-\-on\-download\-complete\fP и \fB\-\-on\-download\-error\fP\&. Если они указаны, то команда определенная в этом параметре не будет выполнятся\&. Смотрите раздел \fBПерехват сообщения\fP для более подробной информации о COMMAND\&. Возможные значения: \fI/путь/к/команде\fP .RE .PP \fB\-\-show\-console\-readout\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Показывать консольный вывод\&. По умолчанию: \fItrue\fP .RE .PP \fB\-\-summary\-interval\fP=SEC .RS 4 Задать интервал в секундах до вывода сообщения о прогрессе загрузки\&. Установка \fI0\fP запрещает вывод\&. По умолчанию: \fI60\fP .RE .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp В загрузках много файлового торрента, по определенным смежным файлам также, которые размещены в части одного блока\&. .sp .5v .RE .PP \fB\-Z\fP, \fB\-\-force\-sequential\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Получить URI в последовательности командной строки и загрузить каждое URI в отдельной сессии, как в обычных утилитах загрузки командной строки\&. По умолчанию: \fIfalse\fP .RE .PP \fB\-\-max\-overall\-download\-limit\fP=SPEED .RS 4 Задать максимальную общую скорость загрузки в байтах/сек\&. \fI0\fP значит неограничено\&. Вы можете добавить \fIK\fP или \fIM\fP(1K = 1024, 1M = 1024K)\&. Чтобы ограничить скорость загрузки для узла, используйте параметр \fB\-\-max\-download\-limit\fP\&. По умолчанию: \fI0\fP .RE .PP \fB\-\-max\-download\-limit\fP=SPEED .RS 4 Установить максимальную скорость каждого узла загрузки в байтах/сек\&. \fI0\fP значит неограниченно. Вы можете добавить \fIK\fP или \fIM\fP(1K = 1024, 1M = 1024K)\&. Чтобы ограничить общую скорость загрузки, используйте параметр \fB\-\-max\-overall\-download\-limit\fP\&. По умолчанию: \fI0\fP .RE .PP \fB\-\-no\-conf\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Отключить загрузку файла aria2\&.conf\&. .RE .PP \fB\-\-no\-file\-allocation\-limit\fP=SIZE .RS 4 Не резервируется место для файлов, размер которых меньше SIZE. Вы можете добавить \fIK\fP или \fIM\fP(1K = 1024, 1M = 1024K)\&. По умолчанию: \fI5M\fP .RE .PP \fB\-P\fP, \fB\-\-parameterized\-uri\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Включить поддержку параметризованных URI\&. Вы можете указать набор частей: \fIhttp://{sv1,sv2,sv3}/foo\&.iso\fP\&. Также вы можете указать числовую последовательность с шагом счетчика: \fIhttp://host/image[000\-100:2]\&.img\fP\&. Шагом счетчика можно пренебречь\&. Если все URI не указывают на такой же файл, как во втором приведенном выше примере, то необходим параметр \fB\-Z\fP. По умолчанию: \fIfalse\fP .RE .PP \fB\-q\fP, \fB\-\-quiet\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Сделать aria2 молчаливой (без консольного вывода)\&. По умолчанию: \fIfalse\fP .RE .PP \fB\-\-realtime\-chunk\-checksum\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Подтверждать правильность блока данных путем вычисления контрольной суммы во время загрузки файла, если предусмотрена контрольная сумма блоков\&. По умолчанию: \fItrue\fP .RE .PP \fB\-\-remove\-control\-file\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Удалять контрольный файл перед загрузкой\&. При использовании с \fB\-\-allow\-overwrite\fP=\fItrue\fP файл всегда загружается с нуля\&. Это может понадобиться пользователям за прокси\-сервером, не поддерживающим возобновление загрузки\&. .RE .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Для Metalink\-загрузок, \-C1 рекомендуется для прокси\-серверов, не поддерживающих возобновление загрузки, во избежании создания лишних соединений\&. .sp .5v .RE .PP \fB\-\-save\-session\fP=FILE .RS 4 Сохранять ошибочные/незаконченные загрузки в FILE при выходе\&. Вы можете передать этот выходной файл aria2c с параметром \fB\-i\fP при перезапуске\&. Обратите внимание, что загрузки добавленные через RPC\-методы \fBaria2\&.addTorrent\fP, \fBaria2\&.addMetalink\fP и чьи метаданные не могут быть сохранены как файл, не будут сохраняться\&. .RE .PP \fB\-\-stop\fP=SEC .RS 4 Останавливать программу после того как пройдет SEC секунд\&. Если задано \fI0\fP, эта возможность будет отключена\&. По умолчанию: \fI0\fP .RE .PP \fB\-v\fP, \fB\-\-version\fP .RS 4 Вывести номер версии, информацию об авторских правах, конфигурации и выйти\&. .RE .SS "Параметры, которые принимают аргументы" .sp Параметры, которые имеют значения в квадратных скобках ([]), могут принимать дополнительные (необязательные) аргументы\&. Обычно отсутствие аргумента эквивалентно \fItrue\fP\&. Если вы используется короткую форму параметров (например, \fI\-V\fP) и указываете аргумент, то имя параметра и его аргумент должны быть объедены (например, \fI\-Vfalse\fP)\&. Если будут вставлены пробелы между именем параметра и аргументом, то аргумент будет обрабатываться как URI, и это не то, что обычно вы ожидаете\&. .SS "URI, MAGNET\-ССЫЛКА, TORRENT\-ФАЙЛ, METALINK\-ФАЙЛ" .sp Вы можете перечислить несколько URI в командной строке\&. Пока вы не указали параметр \fB\-Z\fP, все URI должны указывать на один и тот же файл или загрузка завершиться не удачно\&. .sp Вы можете указать произвольное количество BitTorrent Magnet URI\&. Обратите внимание, что они всегда будут обрабатываться как отдельная загрузка\&. Поддерживаются оба Info Hash (Информация о хэше), как закодированный 40 шестнадцатеричными символами, так и закодированный 32 символами Base32\-кодировки\&. Поддерживаются составные параметры "tr"\&. Т.к. в BitTorrent Magnet URI возможно присутствие символа "&", то настоятельно рекомендуется всегда заключать URI в одиночные(\*(Aq) или двойные(") кавычки\&. Так же настоятельно рекомендуется включить DHT, особенно когда параметр "tr" не указан\&. Смотрите http://www\&.bittorrent\&.org/beps/bep_0009\&.html для детальной информации по BitTorrent Magnet URI\&. .sp Вы также можете указать произвольное количество torrent\-файлов и Metalink\-документов, которые хранятся на локальном диске\&. Обратите внимание, что они всегда будут обрабатываться как отдельная загрузка\&. Поддерживаются оба формата: Metalink4 и Metalink версии 3\&.0\&. .sp Вы можете указать вместе, torrent\-файл c параметром \fB\-T\fP и URI\&. Сделав это, вы можете загружать файл используя torrent\-рой и HTTP(S)/FTP\-сервер одновременно, пока данные из HTTP(S)/FTP выгружаются в torrent\-рой\&. Для одно файловых торрентов, URI может быть завершенным, который указывает на ресурс, или же если заканчиваться символом /, тогда name (имя) в torrent\-файле будет добавлено\&. Для много файловых торентов, name (имя) и path (путь) в torrent\-файле будут добавлены из URI для каждого файла\&. .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Удостоверьтесь, что URI заключен в одинарные(\*(Aq) или двойные(") кавычки, если есть символ "&" или любые символы, которые имеют особое значение в командной оболочке\&. .sp .5v .RE .SS "Возобновление загрузки" .sp Обычно, вы можете возобновить передачу, только давая ту же самую команду (aria2c URI), которая выполнялась при предыдущей передаче, созданной aria2\&. .sp Если предыдущая передача создана веб\-браузером или wget\-подобным менеджером загрузки, тогда используйте параметр \fB\-c\fP для продолжения передачи (aria2c \fB\-c\fP URI)\&. .SS "Перехват сообщения" .sp aria2 предоставляет параметры, в которых указываются произвольные команды, выполняемые после наступления определенного события\&. В настоящие время доступны следующие параметры: \fB\-\-on\-bt\-download\-complete\fP, \fB\-\-on\-download\-pause\fP, \fB\-\-on\-download\-complete\fP\&. \fB\-\-on\-download\-start\fP, \fB\-\-on\-download\-error\fP, \fB\-\-on\-download\-stop\fP\&. .sp aria2 передает 3 аргумента указанной команды, которая выполняется\&. Это аргументы: GID, количество файлов и путь к файлу\&. Для HTTP\-, FTP\-загрузок, обычно количество файлов \- 1\&. BitTorrent загрузка может содержать множество файлов\&. Если число файлов больше чем один, то путь к файлу будет для первого\&. Другими словами, это значение параметра path в первой структуре, определенный параметр которой имеет значение true (истина), в ответе RPC\-метода \fBaria2\&.getFiles\fP\&. Если вы хотите получить все пути к файлам, то рассмотрите использование JSON\-RPC/XML\-RPC\&. Обратите внимание, что путь к файлу может меняться в процессе загрузки по HTTP из\-за перенаправления или заголовка Content\-Disposition\&. .sp Посмотрите пример, как аргументы передаются команде\&. .sp .if n \{\ .RS 4 .\} .nf $ cat hook\&.sh #!/bin/sh echo "Called with [$1] [$2] [$3]" $ aria2c \-\-on\-download\-complete hook\&.sh http://example\&.org/file\&.iso Called with [1] [1] [/path/to/file\&.iso] .fi .if n \{\ .RE .\} .SH "КОДЫ ЗАВЕРШЕНИЯ" .sp Поскольку aria2 может обрабатывать несколько загрузок одновременно, она сталкивается с множеством ошибок в сессии\&. aria2 возвращает следующий код завершения, основанный на последней встретившейся ошибке\&. .PP \fB0\fP .RS 4 Если все загрузки завершились успешно\&. .RE .PP \fB1\fP .RS 4 Если произошла неизвестная ошибка\&. .RE .PP \fB2\fP .RS 4 Если время истекло\&. .RE .PP \fB3\fP .RS 4 Если ресурс не был найден\&. .RE .PP \fB4\fP .RS 4 Если aria2 получила определенное число ошибок "ресурс не найден"\&. Смотрите параметр \fB\-\-max\-file\-not\-found\fP\&. .RE .PP \fB5\fP .RS 4 Если загрузка прервана, поскольку скорость загрузки была слишком медленной\&. Смотрите параметр \fB\-\-lowest\-speed\-limit\fP .RE .PP \fB6\fP .RS 4 Если произошла проблема с сетью\&. .RE .PP \fB7\fP .RS 4 Если были не завершенные загрузки\&. Эта ошибка только появляется только если все завершенные загрузки были успешны и были не завершенные загрузки в очереди, когда aria2 завершилась по нажатию Ctrl\-C пользователем или при отправке сигнала TERM или INT\&. .RE .PP \fB8\fP .RS 4 Если удаленный сервер не поддерживает возобновление, когда оно было указано как обязательное для завершения загрузки\&. .RE .PP \fB9\fP .RS 4 Если было не достаточно доступного места на диске\&. .RE .PP \fB10\fP .RS 4 Если размер блока был отличным от указанного контрольном файле \&.aria2\&. Смотрите параметр \fB\-\-allow\-piece\-length\-change\fP\&. .RE .PP \fB11\fP .RS 4 Если aria2 был загружен один и тот же файл в тот момент\&. .RE .PP \fB12\fP .RS 4 Если aria2 загрузила торрент с одним и тем же хэшем в этот момент\&. .RE .PP \fB13\fP .RS 4 Если файл уже существует\&. Смотрите параметр \fB\-\-allow\-overwrite\fP\&. .RE .PP \fB14\fP .RS 4 Если не удалось переименование\&. Смотрите параметр \fB\-\-auto\-file\-renaming\fP\&. .RE .PP \fB15\fP .RS 4 Если aria2 не смогла открыть существующий файл\&. .RE .PP \fB16\fP .RS 4 Если aria2 не смогла создать новый файл или обрезать существующий файл\&. .RE .PP \fB17\fP .RS 4 Если произошла ошибка чтения/записи файла\&. .RE .PP \fB18\fP .RS 4 Если aria2 не смогла создать каталог\&. .RE .PP \fB19\fP .RS 4 Если не удалось разрешение имен (DNS)\&. .RE .PP \fB20\fP .RS 4 Если aria2 не смогла проанализировать Metalink\-документ\&. .RE .PP \fB21\fP .RS 4 Если FTP\-команда не удалась\&. .RE .PP \fB22\fP .RS 4 Если HTTP\-заголовок ответа был испорчен или неожиданым\&. .RE .PP \fB23\fP .RS 4 Если произошло слишком много перенаправлений\&. .RE .PP \fB24\fP .RS 4 Если HTTP\-авторизация не удалась\&. .RE .PP \fB25\fP .RS 4 Если aria2 не смогла проанализировать закодированный файл (обычно \&.torrent\-файл)\&. .RE .PP \fB26\fP .RS 4 Если файл \&.torrent был испорчен или потерена информация, которая необходима aria2\&. .RE .PP \fB27\fP .RS 4 Если Magnet\-ссылка была плохой\&. .RE .PP \fB28\fP .RS 4 Если был задан плохой/неопознанный параметр или неожиданный аргумент к нему\&. .RE .PP \fB29\fP .RS 4 Если удаленный сервер не смог обработать запрос из\-за временной перегрузки или регламентных работ\&. .RE .PP \fB30\fP .RS 4 Если aria2 не смогла проанализировать JSON\-RPC\-запрос\&. .RE .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Ошибка, произошедшая в завершенной загрузке, не будет передана как код завершения\&. .sp .5v .RE .SH ОКРУЖЕНИЕ .sp aria2 распознает следующие переменные окружения\&. .PP http_proxy [http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ] .RS 4 Указать прокси\-сервер для использования в HTTP\&. Заменяет значение http\-proxy в конфигурационном файле\&. Параметр \fB\-\-http\-proxy\fP в командной строке заменяет эту переменную\&. .RE .PP https_proxy [http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ] .RS 4 Указать прокси\-сервер для использования в HTTPS\&. Заменяет значение https\-proxy в конфигурационном файле\&. Параметр \fB\-\-https\-proxy\fP в командной строке заменяет эту переменную\&. .RE .PP ftp_proxy [http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ] .RS 4 Указать прокси\-сервер для использования в FTP\&. Заменяет значение ftp\-proxy в конфигурационном файле\&. Параметр \fB\-\-ftp\-proxy\fP в командной строке заменяет эту переменную\&. .RE .PP all_proxy [http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ] .RS 4 Указать прокси\-сервер для использования если не указан контретный протокол для прокси\&. Заменяет значение all\-proxy в конфигурационном файле\&. Параметр \fB\-\-all\-proxy\fP в командной строке заменяет эту переменную\&. .RE .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Не смотря на то, что aria2 допускает ftp:// и https:// схемы прокси в URI, она просто предполагает, что определен http:// и не меняет своего поведения, основанного на определенной схеме\&. .sp .5v .RE .PP no_proxy [ДОМЕН,\&...] .RS 4 Указать, разделенные запятыми, имена хостов, доменов и сетевых адресов с CIDR\-блоком, или без него, для которых прокси использоваться не будет\&. Заменяет значение no\-proxy в конфигурационном файле\&. Параметр \fB\-\-no\-proxy\fP в командной строке заменяет эту переменную\&. .RE .SH ФАЙЛЫ .SS aria2\&.conf .sp По умолчанию, aria2 анализирует \fI$HOME/\&.aria2/aria2\&.conf\fP как конфигурационный файл\&. Вы можете указать путь к конфигурационному файлу в параметре \fB\-\-conf\-path\fP\&. Если вы не хотите использовать конфигурационный файл, используйте параметр \fB\-\-no\-conf\fP\&. .sp Конфигурационный файл \- это текстовый файл, содержащий один параметр в строке\&. В каждой строке, вы можете указать пары имя\-значение в формате: ИМЯ=ЗНАЧЕНИЕ, где имя \- это длинный параметр командной строки, без префикса "\-\-"\&. Вы можете использовать тот же синтаксис, что и для параметра командной строки\&. Строки начинающиеся с "#" рассматриваются как комментарии\&. .sp .if n \{\ .RS 4 .\} .nf # пример конфигурационного файла для aria2c listen\-port=60000 dht\-listen\-port=60000 seed\-ratio=1\&.0 max\-upload\-limit=50K ftp\-pasv=true .fi .if n \{\ .RE .\} .SS dht\&.dat .sp По умолчанию, таблица маршрутизации IPv4 DHT хранится в \fI$HOME/\&.aria2/dht\&.dat\fP, а таблица маршрутизации IPv6 DHT хранится в \fI$HOME/\&.aria2/dht6\&.dat\fP\&. .SS Netrc .sp Поддержка Netrc включена по умолчанию для HTTP(S)/FTP\&. Для отключения поддержки netrc, укажите параметр \fB\-n\fP\&. Ваш файл \&.netrc должен иметь соответствующие права (600)\&. .sp Если имя машины (machine) начинается с "\&.", то aria2 представляет это как соответствие домену вместо точного соответствия\&. Это расширение aria2\&. Пример соответствия домену, представляет следующие содержимое \&.netrc: .sp .if n \{\ .RS 4 .\} .nf machine \&.example\&.org login myid password mypasswd .fi .if n \{\ .RE .\} .sp При соответствии домену, aria2\&.example\&.org будет соответствовать \&.example\&.org и будет использованы myid и mypasswd\&. example\&.org также соответствует \&.example\&.org\&. Но example\&.net не будет соответствовать \&.example\&.org\&. .SS "Контрольный файл" .sp aria2 использует контрольный файл для отслеживания прогресса загрузки\&. Контрольный файл размещается в том же каталоге, что и загружаемый файл, и имеет имя, как у загружаемого файла с добавлением "\&.aria2"\&. Например, если file\&.zip загружаемый файл, тогда контрольный файл будет file\&.zip\&.aria2\&. (Существует исключение для этого именования\&. При загрузке торрента с множеством файлов, контрольный файл будет в "корневом каталоге" с именем торрента и добавлением "\&.aria2"\&. Имя "корневого каталога" \- значение ключа "name" в "info" внутри torrent\-файла\&.) .sp Обычно контрольный файл удаляется после завершения загрузки\&. Если aria2 решает, что загрузка не может быть возобновлена (например, когда загружается файл с HTTP\-сервера, который не поддерживает возобновление), контрольный файл не создается\&. .sp Обычно, если вы потеряете контрольный файл, вы не сможете возобновить загрузку\&. Но если у вас есть torrent или metalink файлы с контрольными суммами блоков данных, вы сможете возобновить загрузку без контрольного файла, указав параметр \fB\-V\fP в командной строке aria2c\&. .SS "Входной файл" .sp Входной файл может содержать список URI для загрузки aria2\&. Вы можете указать несколько URI для одного объекта, разделяя URI, в одной строке, табуляцией\&. .sp Каждая строка рассматривается, как аргумент командой строки\&. Следовательно на них влияют параметры \fB\-Z\fP и \fB\-P\fP \&. .sp Строка, которая начинается с "#" обрабатывается как комментарий и пропускается\&. .sp Кроме того, следующие параметры могут быть определены после каждой строки с URI\&. Эти дополнительные строки должны начинаться с пробела(ов)\&. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBall\-proxy\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBall\-proxy\-passwd\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBall\-proxy\-user\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBallow\-overwrite\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBallow\-piece\-length\-change\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBalways\-resume\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBasync\-dns\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBauto\-file\-renaming\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBbt\-enable\-lpd\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBbt\-exclude\-tracker\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBbt\-external\-ip\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBbt\-hash\-check\-seed\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBbt\-max\-open\-files\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBbt\-max\-peers\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBbt\-metadata\-only\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBbt\-min\-crypto\-level\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBbt\-prioritize\-piece\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBbt\-request\-peer\-speed\-limit\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBbt\-require\-crypto\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBbt\-save\-metadata\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBbt\-seed\-unverified\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBbt\-stop\-timeout\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBbt\-tracker\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBbt\-tracker\-connect\-timeout\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBbt\-tracker\-interval\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBbt\-tracker\-timeout\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBcheck\-integrity\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBconditional\-get\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBconnect\-timeout\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBcontinue\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBdir\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBdry\-run\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBenable\-async\-dns6\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBenable\-http\-keep\-alive\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBenable\-http\-pipelining\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBenable\-peer\-exchange\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBfile\-allocation\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBfollow\-metalink\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBfollow\-torrent\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBftp\-passwd\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBftp\-pasv\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBftp\-proxy\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBftp\-proxy\-passwd\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBftp\-proxy\-user\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBftp\-reuse\-connection\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBftp\-type\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBftp\-user\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBheader\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBhttp\-accept\-gzip\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBhttp\-auth\-challenge\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBhttp\-no\-cache\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBhttp\-passwd\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBhttp\-proxy\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBhttp\-proxy\-passwd\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBhttp\-proxy\-user\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBhttp\-user\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBhttps\-proxy\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBhttps\-proxy\-passwd\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBhttps\-proxy\-user\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBindex\-out\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBlowest\-speed\-limit\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBmax\-connection\-per\-server\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBmax\-download\-limit\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBmax\-file\-not\-found\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBmax\-resume\-failure\-tries\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBmax\-tries\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBmax\-upload\-limit\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBmetalink\-enable\-unique\-protocol\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBmetalink\-language\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBmetalink\-location\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBmetalink\-os\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBmetalink\-preferred\-protocol\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBmetalink\-servers\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBmetalink\-version\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBmin\-split\-size\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBno\-file\-allocation\-limit\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBno\-netrc\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBno\-proxy\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBout\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBparameterized\-uri\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBproxy\-method\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBrealtime\-chunk\-checksum\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBreferer\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBremote\-time\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBremove\-control\-file\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBreuse\-uri\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBseed\-ratio\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBseed\-time\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBselect\-file\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBsplit\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBtimeout\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBuse\-head\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBuser\-agent\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBretry\-wait\fP .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBmetalink\-base\-uri\fP .RE .sp Эти параметры имеют точно такой же смысл, что параметры командной строки, но это применимо только к URI, к которым они принадлежат\&. Обратите внимание, что параметры во входном файле не должны иметь префикс "\-\-"\&. .sp Например, такое сожержимое uri\&.txt .sp .if n \{\ .RS 4 .\} .nf http://server/file\&.iso http://mirror/file\&.iso dir=/iso_images out=file\&.img http://foo/bar .fi .if n \{\ .RE .\} .sp Если aria2 выполняется с параметрами \fB\-i\fP uri\&.txt \fB\-d\fP /tmp, а загрузка происходит с http://server/file\&.iso и http://mirror/file\&.iso, то \fIfile\&.iso\fP сохранится как \fI/iso_images/file\&.img\fP\&. Файл \fIbar\fP загрузится с http://foo/bar и сохранится как \fI/tmp/bar\fP\&. .sp В некоторых случаях, параметр \fBout\fP не имеет никакого эффекта\&. Смотрите примечание по ограничениям параметра \fB\-\-out\fP\&. .SS "Профиль функционирования сервера" .sp Этот раздел описывает формат профиля функционирования сервера\&. Это открытый текстовый файл, каждая строка которого имеет несколько пар ИМЯ=ЗНАЧЕНИЕ, разделенных запятыми\&. В настоящее время распознаются следующие ИМЕНА: .PP host .RS 4 Хост\-имя сервера\&. Обязательно\&. .RE .PP protocol .RS 4 Протокол для этого профиля, такие как ftp, http\&. Обязательно\&. .RE .PP dl_speed .RS 4 Средняя скорость загрузки, которая наблюдалась при предыдущей загрузке, в байт/секунду\&. Обязательно\&. .RE .PP sc_avg_speed .RS 4 Средняя скорость загрузки, которая наблюдалась при предыдущей загрузке, в байт/секунду\&. Это значение обновляется только если загрузка произведена при одном соединении и только с использованием AdaptiveURISelector\&. Необязательно\&. .RE .PP mc_avg_speed .RS 4 Средняя скорость загрузки, которая наблюдалась при предыдущей загрузке, в байт/секунду\&. Это значение обновляется только если загрузка произведена при нескольких соединениях и только с использованием AdaptiveURISelector\&. Необязательно\&. .RE .PP counter .RS 4 Сколько раз использовался сервер\&. В настоящее время это значение используется только при AdaptiveURISelector\&. Необязательно\&. .RE .PP last_updated .RS 4 Время связи, в GMT, с этим сервером, указывается в секундах начиная с 00:00:00 1 Января, 1970, UTC\&. Обязательно\&. .RE .PP status .RS 4 ERROR, когда сервер не доступен из\-за неисправности или тайм\-аута\&. Иначе \- OK\&. .RE .sp Эти поля должны быть в одной строке\&. Последовательность полей не имеет значения\&. Вы можете размещать пары, отличные от перечисленных выше; они будут просто игнорироваться\&. .sp Например следующим образом: .sp .if n \{\ .RS 4 .\} .nf host=localhost, protocol=http, dl_speed=32000, last_updated=1222491640, status=OK host=localhost, protocol=ftp, dl_speed=0, last_updated=1222491632, status=ERROR .fi .if n \{\ .RE .\} .SH RPC\-ИНТЕРФЕЙС .sp aria2 обеспечивает JSON\-RPC и XML\-RPC, они в основном имеют одинаковые функции\&. .sp Путь для запроса к JSON\-RPC\-интерфейсу \- \fI/jsonrpc\fP\&. Путь для запроса к XML\-RPC\-интерфейсу \- \fI/rpc\fP\&. .sp JSON\-RPC реализован на основе JSON\-RPC 2\&.0 Спецификация (2010\-03\-26) с поддержкой HTTP POST и GET (JSONP)\&. .sp JSON\-RPC\-интерфейс не поддерживает уведомления\&. Он так же не поддерживает числа с плавающей точкой\&. Символы должны быть в кодировке UTF\-8\&. .sp В следующем документе о JSON\-RPC, описана структура JSON\-объекта\&. .SS Терминология .PP GID .RS 4 GID (или gid) \- это ключ, для управление каждой загрузкой\&. Каждая загрузка имеет уникальный GID\&. В настоящие время GID представлен как целое число, но обрабатывается как не целое число, т.к. он может быть изменен на другой тип в будущих версиях\&. Обратите внимание, что GID существует в локальной сессии и не сохраняется при завершении работы aria2\&. .RE .SS Методы .sp Весь код в примерах написан на Python2\&.7\&. .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.addUri (uris[, options[, position]])\fP .RS 4 .sp Этот метод добавляет новый HTTP(S)/FTP/BitTorrent Magnet URI\&. Параметр \fIuris\fP имеет тип массив, элемент которого имеет тип строка и содержит URI\&. Для BitTorrent Magnet URI, \fIuris\fP должен содержать только один элемент, и он должен быть BitTorrent Magnet URI\&. URI в параметре \fIuris\fP должны указывать на один и тот же файл\&. Если вы смешивайте другие URI, указывающие на другой файл, то aria2 не сообщит об этом, но и загрузка может неудачно завершаться\&. Параметр \fIoptions\fP имеет тип структура, элементы которой являются парой имя и значение\&. Смотрите ниже \fBПараметры\fP для более подробной информации\&. Если параметр \fIposition\fP задан как целое число, начиная с 0, то новая загрузка будет вставлена на позицию \fIposition\fP в очередь ожидания\&. Если параметр \fIposition\fP не задан или больше чем размер очереди, то загрузка будет добавлена в конец очереди\&. Этот метод возвращает GID зарегистрированной загрузки\&. .sp Следующий пример добавляет http://example\&.org/file в aria2: .sp .if n \{\ .RS 4 .\} .nf >>> import urllib2, json >>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, \&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.addUri\*(Aq, \&.\&.\&. \*(Aqparams\*(Aq:[[\*(Aqhttp://example\&.org/file\*(Aq]]}) >>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) >>> c\&.read() \*(Aq{"id":"qwer","jsonrpc":"2\&.0","result":"1"}\*(Aq .fi .if n \{\ .RE .\} .sp Следующий пример добавляет http://example\&.org/file в aria2: .sp .if n \{\ .RS 4 .\} .nf >>> import xmlrpclib >>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) >>> s\&.aria2\&.addUri([\*(Aqhttp://example\&.org/file\*(Aq]) \*(Aq1\*(Aq .fi .if n \{\ .RE .\} .sp Следующий пример добавляет два источника и некоторые параметры: .sp .if n \{\ .RS 4 .\} .nf >>> s\&.aria2\&.addUri([\*(Aqhttp://example\&.org/file\*(Aq, \*(Aqhttp://mirror/file\*(Aq], dict(dir="/tmp")) \*(Aq2\*(Aq .fi .if n \{\ .RE .\} .sp Следующий пример добавляет загрузку и вставляет ее перед ожидающими загрузками: .sp .if n \{\ .RS 4 .\} .nf >>> s\&.aria2\&.addUri([\*(Aqhttp://example\&.org/file\*(Aq], {}, 0) \*(Aq3\*(Aq .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.addTorrent (torrent[, uris[, options[, position]]])\fP .RS 4 .sp Этот метод добавляет BitTorrent\-загрузку путем загрузки \&.torrent\-файла\&. Если вы хотите добавить BitTorrent Magnet URI, взамен используйте метод \fBaria2\&.addUri\fP\&. Параметр \fItorrent\fP имеет тип base64, с содержанием Base64\-кодировки в \&.torrent\-файле\&. Параметр \fIuris\fP имеет тип массив, элемент которого имеет тип строка и содержит URI\&. Параметр \fIuris\fP используется для Web\-сидирования\&. Для одно файловых торрентов, URI может быть завершенным, который указывает на ресурс, или же если заканчиваться символом /, тогда будет добавлено имя из torrent\-файла\&. Для много файловых торентов, имя и путь в торренте будут добавлены из URI для каждого файла\&. Параметр \fIoptions\fP имеет тип структура, элементы которой являются парой имя и значение\&. Смотрите ниже \fBПараметры\fP для более подробной информации\&. Если параметр \fIposition\fP задан как целое число, начиная с 0, то новая загрузка будет вставлена на позицию \fIposition\fP в очередь ожидания\&. Если параметр \fIposition\fP не задан или больше чем размер очереди, то загрузка будет добавлена в конец очереди\&. Этот метод возвращает GID зарегистрированной загрузки\&. Загруженные данные сохраняются в файл с именем шестнадцатеричной строки SHA\-1\-хэша этих данных плюс "\&.torrent", в каталог указанный в параметре \fB\-\-dir\fP\&. Например, имя файла 0a3893293e27ac0490424c06de4d09242215f0a6\&.torrent\&. Если этот файл существует, то он будет перезаписан\&. Если файл не может быть успешно сохранен, то загрузки, добавленныее этим методом, не сохраняются при помощи параметра \fB\-\-save\-session\fP\&. .sp Следующий пример добавляет локальный файл file\&.torrent в aria2: .sp .if n \{\ .RS 4 .\} .nf >>> import urllib2, json, base64 >>> torrent = base64\&.b64encode(open(\*(Aqfile\&.torrent\*(Aq)\&.read()) >>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqasdf\*(Aq, \&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.addTorrent\*(Aq, \*(Aqparams\*(Aq:[torrent]}) >>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) >>> c\&.read() \*(Aq{"id":"asdf","jsonrpc":"2\&.0","result":"6"}\*(Aq .fi .if n \{\ .RE .\} .sp Следующий пример добавляет локальный файл file\&.torrent в aria2: .sp .if n \{\ .RS 4 .\} .nf >>> import xmlrpclib >>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) >>> s\&.aria2\&.addTorrent(xmlrpclib\&.Binary(open(\*(Aqfile\&.torrent\*(Aq)\&.read())) \*(Aq6\*(Aq .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.addMetalink (metalink[, options[, position]])\fP .RS 4 .sp Этот метод добавляет Metalink\-загрузку путем загрузки \&.metalink\-файла\&. Параметр \fImetalink\fP имеет тип base64, с содержанием Base64\-кодировки в \&.metalink\-файле\&. Параметр \fIoptions\fP имеет тип структура, элементы которой являются парой имя\-значение\&. Смотрите ниже \fBПараметры\fP для более подробной информации\&. Если параметр \fIposition\fP задан как целое число, начиная с 0, то новая загрузка будет вставлена на позицию \fIposition\fP в очередь ожидания\&. Если параметр \fIposition\fP не задан или больше чем размер очереди, то загрузка будет добавлена в конец очереди\&. Этот метод возвращает GID зарегистрированной загрузки\&. Загруженные данные сохраняются в файл с именем шестнадцатеричной строки SHA\-1\-хэша этих данных плюс "\&.metalink", в каталог указанный в параметре \fB\-\-dir\fP\&. Например, имя файла 0a3893293e27ac0490424c06de4d09242215f0a6\&.metalink\&. Если этот файл существует, то он будет перезаписан\&. Если файл не может быть успешно сохранен, то загрузки, добавленныее этим методом, не сохраняются при помощи параметра \fB\-\-save\-session\fP\&. .sp Следующий пример добавляет локальный файл file\&.meta4 в aria2: .sp .if n \{\ .RS 4 .\} .nf >>> import urllib2, json, base64 >>> metalink = base64\&.b64encode(open(\*(Aqfile\&.meta4\*(Aq)\&.read()) >>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, \&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.addMetalink\*(Aq, \*(Aqparams\*(Aq:[metalink]}) >>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) >>> c\&.read() \*(Aq{"id":"qwer","jsonrpc":"2\&.0","result":["8"]}\*(Aq .fi .if n \{\ .RE .\} .sp Следующий пример добавляет локальный файл file\&.meta4 в aria2: .sp .if n \{\ .RS 4 .\} .nf >>> import xmlrpclib >>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) >>> s\&.aria2\&.addMetalink(xmlrpclib\&.Binary(open(\*(Aqfile\&.meta4\*(Aq)\&.read())) [\*(Aq8\*(Aq] .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.remove (gid)\fP .RS 4 .sp Этот метод удаляет загрузку, которая обозначена \fIgid\fP\&. Параметр \fIgid\fP имеет тип строка\&. Если указана загрузка, которая загружается в данный момент, то сперва она остановится\&. Статус удаления станет "removed" (удаленно)\&. Этот метод возвращает GID удаленной загрузки\&. .sp Следующий пример удаляет загрузку, GID которой "3": .sp .if n \{\ .RS 4 .\} .nf >>> import urllib2, json >>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, \&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.remove\*(Aq, \*(Aqparams\*(Aq:[\*(Aq3\*(Aq]}) >>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) >>> c\&.read() \*(Aq{"id":"qwer","jsonrpc":"2\&.0","result":"3"}\*(Aq .fi .if n \{\ .RE .\} .sp Следующий пример удаляет загрузку, GID которой "3": .sp .if n \{\ .RS 4 .\} .nf >>> import xmlrpclib >>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) >>> s\&.aria2\&.remove(\*(Aq3\*(Aq) \*(Aq3\*(Aq .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.forceRemove (gid)\fP .RS 4 .sp Этот метод удаляет загрузку, которая обозначена \fIgid\fP\&. Метод действует подобно \fBaria2\&.remove\fP, за исключением того, что метод удаляет загрузку без каких\-либо действий, которые требует времени, например связь с BitTorrent\-трекером\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.pause (gid)\fP .RS 4 .sp Этот метод приостанавливает загрузку, которая обозначена \fIgid\fP\&. Параметр \fIgid\fP имеет тип строки\&. Статус приостановки станет "paused" (приостановлено)\&. Если загрузка активна, то загрузка переместится на первую позицию в очередь ожидания\&. Пока статус "paused", загрузка не начнется\&. Для смены статуса на "waiting", используйте метод \fBaria2\&.unpause\fP\&. Этот метод возвращает GID приостановленной загрузки\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.pauseAll ()\fP .RS 4 .sp Этот метод эквивалентен по вызову \fBaria2\&.pause\fP, для каждой активной/ожидающей закачки\&. Этот метод возвращает "OK", в случае успеха\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.forcePause (pid)\fP .RS 4 .sp Этот метод приостанавливает загрузку, которая обозначена \fIgid\fP\&. Метод действует подобно \fBaria2\&.pause\fP, за исключением того, что метод приостанавливает загрузку без каких\-либо действий, которые требует времени, например связь с BitTorrent\-трекером\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.forcePauseAll ()\fP .RS 4 .sp Этот метод эквивалентен по вызову \fBaria2\&.forcePause\fP, для каждой активной/ожидающей закачки\&. Этот метод возвращает "OK", в случае успеха\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.unpause (gid)\fP .RS 4 .sp Этот метод изменяет статус загрузки, которая обозначена \fIgid\fP, с "paused" на "waiting"\&. Это позволяет перезапускать загрузку\&. Значение ключа \fIgid\fP имеет тип строки\&. Этот метод возвращает GID, снятой с паузы, загрузки\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.unpauseAll ()\fP .RS 4 .sp Этот метод эквивалентен по вызову \fBaria2\&.unpause\fP, для каждой активной/ожидающей закачки\&. Этот метод возвращает "OK", в случае успеха\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.tellStatus (gid[, keys])\fP .RS 4 .sp Этот метод возвращает состояние загрузки, которая обозначена \fIgid\fP\&. Параметр \fIgid\fP имеет тип строка\&. Параметр \fIkeys\fP имеет тип массив строк\&. Если \fIkeys\fP указан, то ответ содержит определенные значения в массиве \fIkeys\fP\&. Если \fIkeys\fP пустой или не указан, то ответ содержит все значения\&. Это полезно, если вы хотите использовать определенные параметры, чтобы исключить множество пересылок\&. Например, \fBaria2\&.tellStatus\fP("1", ["gid", "status"]) возвратит \fIgid\fP и \fIstatus\fP\&. Ответ имеет тип структура и содержит следующие поля\&. Поля имеют тип строка\&. .PP gid .RS 4 GID этой загрузки\&. .RE .PP status .RS 4 "active" \- загружаемая/сидируемая в данный момент\&. "waiting" \- ожидающая в очереди; загрузка не началась\&. "paused" \- приостановленная\&. "error" \- остановленная, т.к. произошла ошибка\&. "complete" \- остановленная и завершенная загрузка\&. "removed" \- удаленная пользователем загрузка\&. .RE .PP totalLength .RS 4 Общий объем загрузки в байтах\&. .RE .PP completedLength .RS 4 Загруженный объем загрузки в байтах\&. .RE .PP uploadLength .RS 4 Выгруженный объем загрузки в байтах\&. .RE .PP bitfield .RS 4 Шестнадцатеричное представление процесса загрузки\&. Старший бит соответствует блоку с индексом 0\&. Бит устанавливается, если блок доступен и не устанавливается, если блок отсутствует\&. Запасные биты в конце устанавливаются в 0\&. Если загрузка еще не начался, этот значение не будет включено в ответ\&. .RE .PP downloadSpeed .RS 4 Скорость загрузки в байт/сек\&. .RE .PP uploadSpeed .RS 4 Скорость выгрузки в байт/сек\&. .RE .PP infoHash .RS 4 Информация о хэше (InfoHash)\&. Только для BitTorrent\&. .RE .PP numSeeders .RS 4 Количество сидов, к которым подключен клиент\&. Только для BitTorrent\&. .RE .PP pieceLength .RS 4 Размер блока в байтах\&. .RE .PP numPieces .RS 4 Количество блоков\&. .RE .PP connections .RS 4 Количество пиров/серверов, к которым подключен клиент\&. .RE .PP errorCode .RS 4 Последний код ошибки, которая произошла при загрузке\&. Значение имеет тип строки\&. Коды ошибок определены в разделе \fBКОДЫ ЗАВЕРШЕНИЯ\fP\&. Это значение доступно только для остановленных/завершенных загрузок\&. .RE .PP followedBy .RS 4 Список с GID, которые сгенерированы в результате запуска этой загрузки\&. Например, когда aria2 загружает Metalink\-файл, то это генерирует загрузки, описанные в нем (см. параметр \fB\-\-follow\-metalink\fP)\&. Это значение полезно для отслеживания автоматически сгенерированных загрузок\&. Если таких загрузок нет, то значение не будет включено в ответ\&. .RE .PP belongsTo .RS 4 GID родительской загрузки\&. Некоторые загрузки являются частью другой загрузки\&. Например, если файл в Metalink содержит BitTorrent\-ответ, загрузка \&.torrent будет частью этого файла\&. Если эта загрузка не имеет родительской загрузки, то значение не будет включено в ответ\&. .RE .PP dir .RS 4 Каталог для сохранения файлов\&. Этот параметр не доступен для остановленных загрузок\&. .RE .PP files .RS 4 Возвращает список файлов\&. Элемент списка \- это структура, такая же, что и в методе \fBaria2\&.getFiles\fP\&. .RE .PP bittorrent .RS 4 Структура, в которой содержится информация, извлеченная из \&.torrent\-файла\&. Только для BitTorrent\&. Содержит следующие поля\&. .PP announceList .RS 4 Список списков URI анонса\&. Если \&.torrent\-файл содержит анонс, а не список\-анонс, то анонс конвертируется в формат списка\-анонса\&. .RE .PP comment .RS 4 Комментарий по торренту\&. Используется comment\&.utf\-8, если доступно\&. .RE .PP creationDate .RS 4 Время создания торрента\&. Значение является целым числом, с начала века, измеряется в секундах\&. .RE .PP mode .RS 4 Файловый режим торрента\&. Значение одно из двух: \fIsingle\fP (одиночный) или \fImulti\fP (множественный)\&. .RE .PP info .RS 4 Структура, которая содержит данные из раздела Info\&. Она содержит следующие поля\&. .PP name .RS 4 имя в разделе info\&. Используется name\&.utf\-8, если доступно\&. .RE .RE .RE .sp Следующий пример получает иформацию о загрузке, GID которой "1": .sp .if n \{\ .RS 4 .\} .nf >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, \&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.tellStatus\*(Aq, \*(Aqparams\*(Aq:[\*(Aq1\*(Aq]}) >>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) >>> pprint(json\&.loads(c\&.read())) {u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: {u\*(Aqbitfield\*(Aq: u\*(Aq0000000000\*(Aq, u\*(AqcompletedLength\*(Aq: u\*(Aq901120\*(Aq, u\*(Aqconnections\*(Aq: u\*(Aq1\*(Aq, u\*(Aqdir\*(Aq: u\*(Aq/downloads\*(Aq, u\*(AqdownloadSpeed\*(Aq: u\*(Aq15158\*(Aq, u\*(Aqfiles\*(Aq: [{u\*(Aqindex\*(Aq: u\*(Aq1\*(Aq, u\*(Aqlength\*(Aq: u\*(Aq34896138\*(Aq, u\*(Aqpath\*(Aq: u\*(Aq/downloads/file\*(Aq, u\*(Aqselected\*(Aq: u\*(Aqtrue\*(Aq, u\*(Aquris\*(Aq: [{u\*(Aqstatus\*(Aq: u\*(Aqused\*(Aq, u\*(Aquri\*(Aq: u\*(Aqhttp://example\&.org/file\*(Aq}]}], u\*(Aqgid\*(Aq: u\*(Aq1\*(Aq, u\*(AqnumPieces\*(Aq: u\*(Aq34\*(Aq, u\*(AqpieceLength\*(Aq: u\*(Aq1048576\*(Aq, u\*(Aqstatus\*(Aq: u\*(Aqactive\*(Aq, u\*(AqtotalLength\*(Aq: u\*(Aq34896138\*(Aq, u\*(AquploadLength\*(Aq: u\*(Aq0\*(Aq, u\*(AquploadSpeed\*(Aq: u\*(Aq0\*(Aq}} .fi .if n \{\ .RE .\} .sp Следующий пример получает информацию об определенных полях, который вас интересуют: .sp .if n \{\ .RS 4 .\} .nf >>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, \&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.tellStatus\*(Aq, \&.\&.\&. \*(Aqparams\*(Aq:[\*(Aq1\*(Aq, [\*(Aqgid\*(Aq, \&.\&.\&. \*(AqtotalLength\*(Aq, \&.\&.\&. \*(AqcompletedLength\*(Aq]]}) >>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) >>> pprint(json\&.loads(c\&.read())) {u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: {u\*(AqcompletedLength\*(Aq: u\*(Aq5701632\*(Aq, u\*(Aqgid\*(Aq: u\*(Aq1\*(Aq, u\*(AqtotalLength\*(Aq: u\*(Aq34896138\*(Aq}} .fi .if n \{\ .RE .\} .sp Следующий пример получает иформацию о загрузке, GID которой "1": .sp .if n \{\ .RS 4 .\} .nf >>> import xmlrpclib >>> from pprint import pprint >>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) >>> r = s\&.aria2\&.tellStatus(\*(Aq1\*(Aq) >>> pprint(r) {\*(Aqbitfield\*(Aq: \*(Aqffff80\*(Aq, \*(AqcompletedLength\*(Aq: \*(Aq34896138\*(Aq, \*(Aqconnections\*(Aq: \*(Aq0\*(Aq, \*(Aqdir\*(Aq: \*(Aq/downloads\*(Aq, \*(AqdownloadSpeed\*(Aq: \*(Aq0\*(Aq, \*(AqerrorCode\*(Aq: \*(Aq0\*(Aq, \*(Aqfiles\*(Aq: [{\*(Aqindex\*(Aq: \*(Aq1\*(Aq, \*(Aqlength\*(Aq: \*(Aq34896138\*(Aq, \*(Aqpath\*(Aq: \*(Aq/downloads/file\*(Aq, \*(Aqselected\*(Aq: \*(Aqtrue\*(Aq, \*(Aquris\*(Aq: [{\*(Aqstatus\*(Aq: \*(Aqused\*(Aq, \*(Aquri\*(Aq: \*(Aqhttp://example\&.org/file\*(Aq}]}], \*(Aqgid\*(Aq: \*(Aq1\*(Aq, \*(AqnumPieces\*(Aq: \*(Aq17\*(Aq, \*(AqpieceLength\*(Aq: \*(Aq2097152\*(Aq, \*(Aqstatus\*(Aq: \*(Aqcomplete\*(Aq, \*(AqtotalLength\*(Aq: \*(Aq34896138\*(Aq, \*(AquploadLength\*(Aq: \*(Aq0\*(Aq, \*(AquploadSpeed\*(Aq: \*(Aq0\*(Aq} .fi .if n \{\ .RE .\} .sp Следующий пример получает информацию об определенных полях, который вас интересуют: .sp .if n \{\ .RS 4 .\} .nf >>> r = s\&.aria2\&.tellStatus(\*(Aq1\*(Aq, [\*(Aqgid\*(Aq, \*(AqtotalLength\*(Aq, \*(AqcompletedLength\*(Aq]) >>> pprint(r) {\*(AqcompletedLength\*(Aq: \*(Aq34896138\*(Aq, \*(Aqgid\*(Aq: \*(Aq1\*(Aq, \*(AqtotalLength\*(Aq: \*(Aq34896138\*(Aq} .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.getUris (gid)\fP .RS 4 .sp Этот метод возвращает URI, используемые в загрузке, которая обозначена \fIgid\fP\&. Параметр \fIgid\fP имеет тип строка\&. Ответ имеет тип массив, а элемент \- тип структура и содержит следующие поля\&. Поле имеет тип строка\&. .PP uri .RS 4 URI .RE .PP status .RS 4 \fIused\fP, если URI уже использован\&. \fIwaiting\fP, если URI ожидает в очереди\&. .RE .sp .if n \{\ .RS 4 .\} .nf >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, \&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.getUris\*(Aq, \*(Aqparams\*(Aq:[\*(Aq1\*(Aq]}) >>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) >>> pprint(json\&.loads(c\&.read())) {u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: [{u\*(Aqstatus\*(Aq: u\*(Aqused\*(Aq, u\*(Aquri\*(Aq: u\*(Aqhttp://example\&.org/file\*(Aq}]} .fi .if n \{\ .RE .\} .sp .if n \{\ .RS 4 .\} .nf >>> import xmlrpclib >>> from pprint import pprint >>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) >>> r = s\&.aria2\&.getUris(\*(Aq1\*(Aq) >>> pprint(r) [{\*(Aqstatus\*(Aq: \*(Aqused\*(Aq, \*(Aquri\*(Aq: \*(Aqhttp://example\&.org/file\*(Aq}] .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.getFiles (gid)\fP .RS 4 .sp Этот метод возвращает список файлов загрузки, которая обозначена \fIgid\fP\&. Параметр \fIgid\fP имеет тип строка\&. Ответ имеет тип массив, а элемент \- тип структура и содержит следующие поля\&. Поле имеет тип строка\&. .PP index .RS 4 Индекс файла\&. Начинается с 1\&. Последовательность файлов такая же, что и в много файловом торренте\&. .RE .PP path .RS 4 Путь к файлу\&. .RE .PP length .RS 4 Размер файла в байта\&. .RE .PP selected .RS 4 "true" \- если этот файл выбран параметром \fB\-\-select\-file\fP\&. Если параметр \fB\-\-select\-file\fP не указан или это одно файловый торрент или загрузка не торрент, то это значение всегда будет "true"\&. Иначе "false"\&. .RE .PP uris .RS 4 Возвращает список URI для этого файла\&. Элемент списка такая же структура, что используется в методе \fBaria2\&.getUris\fP\&. .RE .sp .if n \{\ .RS 4 .\} .nf >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, \&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.getFiles\*(Aq, \*(Aqparams\*(Aq:[\*(Aq1\*(Aq]}) >>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) >>> pprint(json\&.loads(c\&.read())) {u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: [{u\*(Aqindex\*(Aq: u\*(Aq1\*(Aq, u\*(Aqlength\*(Aq: u\*(Aq34896138\*(Aq, u\*(Aqpath\*(Aq: u\*(Aq/downloads/file\*(Aq, u\*(Aqselected\*(Aq: u\*(Aqtrue\*(Aq, u\*(Aquris\*(Aq: [{u\*(Aqstatus\*(Aq: u\*(Aqused\*(Aq, u\*(Aquri\*(Aq: u\*(Aqhttp://example\&.org/file\*(Aq}]}]} .fi .if n \{\ .RE .\} .sp .if n \{\ .RS 4 .\} .nf >>> import xmlrpclib >>> from pprint import pprint >>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) >>> r = s\&.aria2\&.getFiles(\*(Aq1\*(Aq) >>> pprint(r) [{\*(Aqindex\*(Aq: \*(Aq1\*(Aq, \*(Aqlength\*(Aq: \*(Aq34896138\*(Aq, \*(Aqpath\*(Aq: \*(Aq/downloads/file\*(Aq, \*(Aqselected\*(Aq: \*(Aqtrue\*(Aq, \*(Aquris\*(Aq: [{\*(Aqstatus\*(Aq: \*(Aqused\*(Aq, \*(Aquri\*(Aq: \*(Aqhttp://example\&.org/file\*(Aq}]}] .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.getPeers (gid)\fP .RS 4 .sp Этот метод возвращает список пиров загрузки, которая обозначена \fIgid\fP\&. Параметр \fIgid\fP имеет тип строка\&. Этот метод только для BitTorrent\&. Ответ имеет тип массив, а элемент \- тип структура и содержит следующие поля\&. Поле имеет тип строка\&. .PP peerId .RS 4 Закодированное ID пира\&. .RE .PP ip .RS 4 IP\-адрес пира\&. .RE .PP port .RS 4 Номер порта пира\&. .RE .PP bitfield .RS 4 Шестнадцатеричное представление процесса загрузки\&. Старший бит соответствует блоку с индексом 0\&. Бит устанавливается, если блок доступен и не устанавливается, если блок отсутствует\&. Запасные биты в конце устанавливаются в 0\&. .RE .PP amChoking .RS 4 "true" \- если этот клиент блокирует пира\&. Иначе "false"\&. .RE .PP peerChoking .RS 4 "true" \- если пир блокирует этого клиента\&. Иначе "false"\&. .RE .PP downloadSpeed .RS 4 Скорость загрузки (байт/сек), с которой этот клиент получает от пира\&. .RE .PP uploadSpeed .RS 4 Скорость выгрузки (байт/сек), с которой этот клиент отдает пиру\&. .RE .PP seeder .RS 4 "true" \- если этот клиент является сидом\&. Иначе "false"\&. .RE .sp .if n \{\ .RS 4 .\} .nf >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, \&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.getPeers\*(Aq, \*(Aqparams\*(Aq:[\*(Aq1\*(Aq]}) >>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) >>> pprint(json\&.loads(c\&.read())) {u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: [{u\*(AqamChoking\*(Aq: u\*(Aqtrue\*(Aq, u\*(Aqbitfield\*(Aq: u\*(Aqffffffffffffffffffffffffffffffffffffffff\*(Aq, u\*(AqdownloadSpeed\*(Aq: u\*(Aq10602\*(Aq, u\*(Aqip\*(Aq: u\*(Aq10\&.0\&.0\&.9\*(Aq, u\*(AqpeerChoking\*(Aq: u\*(Aqfalse\*(Aq, u\*(AqpeerId\*(Aq: u\*(Aqaria2%2F1%2E10%2E5%2D%87%2A%EDz%2F%F7%E6\*(Aq, u\*(Aqport\*(Aq: u\*(Aq6881\*(Aq, u\*(Aqseeder\*(Aq: u\*(Aqtrue\*(Aq, u\*(AquploadSpeed\*(Aq: u\*(Aq0\*(Aq}, {u\*(AqamChoking\*(Aq: u\*(Aqfalse\*(Aq, u\*(Aqbitfield\*(Aq: u\*(Aqffffeff0fffffffbfffffff9fffffcfff7f4ffff\*(Aq, u\*(AqdownloadSpeed\*(Aq: u\*(Aq8654\*(Aq, u\*(Aqip\*(Aq: u\*(Aq10\&.0\&.0\&.30\*(Aq, u\*(AqpeerChoking\*(Aq: u\*(Aqfalse\*(Aq, u\*(AqpeerId\*(Aq: u\*(Aqbittorrent client758\*(Aq, u\*(Aqport\*(Aq: u\*(Aq37842\*(Aq, u\*(Aqseeder\*(Aq: u\*(Aqfalse\*(Aq, u\*(AquploadSpeed\*(Aq: u\*(Aq6890\*(Aq}]} .fi .if n \{\ .RE .\} .sp .if n \{\ .RS 4 .\} .nf >>> import xmlrpclib >>> from pprint import pprint >>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) >>> r = s\&.aria2\&.getPeers(\*(Aq1\*(Aq) >>> pprint(r) [{\*(AqamChoking\*(Aq: \*(Aqtrue\*(Aq, \*(Aqbitfield\*(Aq: \*(Aqffffffffffffffffffffffffffffffffffffffff\*(Aq, \*(AqdownloadSpeed\*(Aq: \*(Aq10602\*(Aq, \*(Aqip\*(Aq: \*(Aq10\&.0\&.0\&.9\*(Aq, \*(AqpeerChoking\*(Aq: \*(Aqfalse\*(Aq, \*(AqpeerId\*(Aq: \*(Aqaria2%2F1%2E10%2E5%2D%87%2A%EDz%2F%F7%E6\*(Aq, \*(Aqport\*(Aq: \*(Aq6881\*(Aq, \*(Aqseeder\*(Aq: \*(Aqtrue\*(Aq, \*(AquploadSpeed\*(Aq: \*(Aq0\*(Aq}, {\*(AqamChoking\*(Aq: \*(Aqfalse\*(Aq, \*(Aqbitfield\*(Aq: \*(Aqffffeff0fffffffbfffffff9fffffcfff7f4ffff\*(Aq, \*(AqdownloadSpeed\*(Aq: \*(Aq8654\*(Aq, \*(Aqip\*(Aq: \*(Aq10\&.0\&.0\&.30\*(Aq, \*(AqpeerChoking\*(Aq: \*(Aqfalse\*(Aq, \*(AqpeerId\*(Aq: \*(Aqbittorrent client758\*(Aq, \*(Aqport\*(Aq: \*(Aq37842\*(Aq, \*(Aqseeder\*(Aq: \*(Aqfalse, \*(AquploadSpeed\*(Aq: \*(Aq6890\*(Aq}] .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.getServers (gid)\fP .RS 4 .sp Этот метод возвращает текущие подключенные HTTP(S)/FTP\-серверы загрузки, которая обозначена \fIgid\fP\&. Параметр \fIgid\fP имеет тип строка\&. Ответ имеет тип массив, а элемент \- тип структура и содержит следующие поля\&. Поле имеет тип строка\&. .PP index .RS 4 Индекс файла\&. Начинается с 1\&. Последовательность файлов такая же, что и в много файловом торренте\&. .RE .PP servers .RS 4 Список структур, которые содержат следующие поля\&. .PP uri .RS 4 Первоначально добавленный URI\&. .RE .PP currentUri .RS 4 Это URI в настоящее время используется для загрузки\&. Если происходит перенаправление, currentUri и uri могут отличаться\&. .RE .PP downloadSpeed .RS 4 Скорость загрузки (байт/сек) .RE .RE .sp .if n \{\ .RS 4 .\} .nf >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, \&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.getServers\*(Aq, \*(Aqparams\*(Aq:[\*(Aq1\*(Aq]}) >>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) >>> pprint(json\&.loads(c\&.read())) {u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: [{u\*(Aqindex\*(Aq: u\*(Aq1\*(Aq, u\*(Aqservers\*(Aq: [{u\*(AqcurrentUri\*(Aq: u\*(Aqhttp://example\&.org/file\*(Aq, u\*(AqdownloadSpeed\*(Aq: u\*(Aq10467\*(Aq, u\*(Aquri\*(Aq: u\*(Aqhttp://example\&.org/file\*(Aq}]}]} .fi .if n \{\ .RE .\} .sp .if n \{\ .RS 4 .\} .nf >>> import xmlrpclib >>> from pprint import pprint >>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) >>> r = s\&.aria2\&.getServers(\*(Aq1\*(Aq) >>> pprint(r) [{\*(Aqindex\*(Aq: \*(Aq1\*(Aq, \*(Aqservers\*(Aq: [{\*(AqcurrentUri\*(Aq: \*(Aqhttp://example\&.org/dl/file\*(Aq, \*(AqdownloadSpeed\*(Aq: \*(Aq20285\*(Aq, \*(Aquri\*(Aq: \*(Aqhttp://example\&.org/file\*(Aq}]}] .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.tellActive ([keys])\fP .RS 4 .sp Этот метод возвращает список активных загрузок\&. Ответ имеет тип массив и его элемент такая же структура, которая возвращается методом \fBaria2\&.tellStatus\fP\&. За разъяснениями о параметре \fIkeys\fP, обратитесь к методу \fBaria2\&.tellStatus\fP\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.tellWaiting (offset, num, [keys])\fP .RS 4 .sp Этот метод возвращает список ожидающих загрузок, включая приостановленные загрузки\&. \fIoffset\fP имеет целочисленный тип и указывает смещение, начиная от ожидающей загрузки\&. \fInum\fP имеет целочисленный тип и указывает число возвращаемых загрузок\&. За разъяснениями о параметре \fIkeys\fP, обратитесь к методу \fBaria2\&.tellStatus\fP\&. .sp Если смещение положительное целое число, то этот метод возвращает загрузки в диапазоне [\fIoffset\fP, \fIoffset\fP+\fInum\fP)\&. .sp \fIoffset\fP может быть отрицательным целым числом\&. \fIoffset\fP == \-1 указывает на последнею загрузку, которая ожидает в очереди, а \fIoffset\fP == \-2 указывает на загрузку перед последней, и так далее\&. Загрузки в ответе находятся в обратном порядке\&. .sp Например, допустим что есть три загрузки "A","B" и "C", в этом порядке, которые ожидают\&. aria2\&.tellWaiting(0, 1) возвратит ["A"]\&. aria2\&.tellWaiting(1, 2) возвратит ["B", "C"]\&. aria2\&.tellWaiting(\-1, 2) возвратит ["C", "B"]\&. .sp Ответ имеет тип массив и его элемент такая же структура, которая возвращается методом \fBaria2\&.tellStatus\fP\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.tellStopped (offset, num, [keys])\fP .RS 4 .sp Этот метод возвращает список остановленных загрузок\&. \fIoffset\fP имеет целочисленный тип и указывает смещение, начиная с самой старой загрузки\&. \fInum\fP имеет целочисленный тип и указывает число возвращаемых загрузок\&. За разъяснениями о параметре \fIkeys\fP, обратитесь к методу \fBaria2\&.tellStatus\fP\&. .sp \fIoffset\fP и \fInum\fP имеют такую же семантику как и в методе \fBaria2\&.tellWaiting\fP\&. .sp Ответ имеет тип массив и его элемент такая же структура, которая возвращается методом \fBaria2\&.tellStatus\fP\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.changePosition (gid, pos, how)\fP .RS 4 .sp Этот метод меняет позицию загрузки, которая обозначена \fIgid\fP\&. \fIpos\fP имеет целочисленный тип\&. \fIhow\fP имеет тип строка\&. Если \fIhow\fP \- "POS_SET", то это переместит загрузку на позицию, относительно начала очереди\&. Если \fIhow\fP \- "POS_CUR", это переместит загрузку на позицию, относительно текущей позиции\&. Если \fIhow\fP \- "POS_END", это переместит загрузку на позицию, относительно конца очереди\&. Если целевая позиция меньше чем 0 или за пределами конца очереди, это переместит загрузку в начало или конец очереди соответственно\&. Ответ имеет целочисленный тип и является целевой позицией\&. .sp Например, если GID#1 размещается на позиции 3, aria2\&.changePosition(1, \-1, POS_CUR) изменит его позицию на 2\&. Дополнительно aria2\&.changePosition(1, 0, POS_SET) изменит его позицию на 0 (начало очереди)\&. .sp Следующий пример перемещает загрузку, GID которой "3", в начало очереди ожидания: .sp .if n \{\ .RS 4 .\} .nf >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, \&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.changePosition\*(Aq, \&.\&.\&. \*(Aqparams\*(Aq:[\*(Aq3\*(Aq, 0, \*(AqPOS_SET\*(Aq]}) >>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) >>> pprint(json\&.loads(c\&.read())) {u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: 0} .fi .if n \{\ .RE .\} .sp Следующий пример перемещает загрузку, GID которой "3", в начало очереди ожидания: .sp .if n \{\ .RS 4 .\} .nf >>> import xmlrpclib >>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) >>> s\&.aria2\&.changePosition(\*(Aq3\*(Aq, 0, \*(AqPOS_SET\*(Aq) 0 .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.changeUri (gid, fileIndex, delUris, addUris[, position])\fP .RS 4 .sp Этот метод удаляет URI в \fIdelUris\fP из загрузки и добавляет URI в \fIaddUris\fP к загрузке, которая обозначена \fIgid\fP\&. \fIdelUris\fP и \fIaddUris\fP являются списком строк\&. Загрузка может содержать несколько файлов и URI прилагаются к каждому файлу\&. \fIfileIndex\fP используется, чтобы выбрать файл для удаления/подключения заданных URI\&. \fIfileIndex\fP начинается с 1\&. \fIposition\fP используется для указания, куда будут вставлены URI в существующем списке ожидающих URI\&. \fIposition\fP начинается с 0\&. Когда \fIposition\fP пропущено, URI добавляются в конец списка\&. Этот метод сначала выполняет удаление, а потом добавление\&. \fIposition\fP это позиция после URI, которые будут удалены, а не позиция, когда метод вызывается\&. При удалении URI, если одинаковые URI существуют в загрузке, только один из них будет удален, для каждого URI в \fIdelUris\fP\&. Другими словами, есть три URI "http://example\&.org/aria2" и вы хотите удалить их все, вы должны указать (по крайней мере) 3 "http://example\&.org/aria2" в \fIdelUris\fP\&. Этот метод возвращает список, который содержит 2 целых числа\&. Первое \- количество удаленных URI\&. Второе \- количество добавленных URI\&. .sp Следующий пример добавляет 1 URI http://example\&.org/file к файлу с индексом "1", принадлежащий загрузке, GID которой "2": .sp .if n \{\ .RS 4 .\} .nf >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, \&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.changeUri\*(Aq, \&.\&.\&. \*(Aqparams\*(Aq:[\*(Aq2\*(Aq, 1, [], [\*(Aqhttp://example\&.org/file\*(Aq]]}) >>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) >>> pprint(json\&.loads(c\&.read())) {u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: [0, 1]} .fi .if n \{\ .RE .\} .sp Следующий пример добавляет 1 URI http://example\&.org/file к файлу с индексом "1", принадлежащий загрузке, GID которой "2": .sp .if n \{\ .RS 4 .\} .nf >>> import xmlrpclib >>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) >>> s\&.aria2\&.changeUri(\*(Aq2\*(Aq, 1, [], [\*(Aqhttp://example\&.org/file\*(Aq]) [0, 1] .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.getOption (gid)\fP .RS 4 .sp Этот метод возвращает параметры загрузки, которая обозначена \fIgid\fP\&. Ответ имеет тип структура\&. Ее поля \- это название параметра\&. Поле имеет тип строка\&. .sp Следующий пример получает параметры загрузки, GID которой "1": .sp .if n \{\ .RS 4 .\} .nf >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, \&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.getOption\*(Aq, \*(Aqparams\*(Aq:[\*(Aq1\*(Aq]}) >>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) >>> pprint(json\&.loads(c\&.read())) {u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: {u\*(Aqallow\-overwrite\*(Aq: u\*(Aqfalse\*(Aq, u\*(Aqallow\-piece\-length\-change\*(Aq: u\*(Aqfalse\*(Aq, u\*(Aqalways\-resume\*(Aq: u\*(Aqtrue\*(Aq, u\*(Aqasync\-dns\*(Aq: u\*(Aqtrue\*(Aq, \&.\&.\&. .fi .if n \{\ .RE .\} .sp Следующий пример получает параметры загрузки, GID которой "1": .sp .if n \{\ .RS 4 .\} .nf >>> import xmlrpclib >>> from pprint import pprint >>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) >>> r = s\&.aria2\&.getOption(\*(Aq1\*(Aq) >>> pprint(r) {\*(Aqallow\-overwrite\*(Aq: \*(Aqfalse\*(Aq, \*(Aqallow\-piece\-length\-change\*(Aq: \*(Aqfalse\*(Aq, \*(Aqalways\-resume\*(Aq: \*(Aqtrue\*(Aq, \*(Aqasync\-dns\*(Aq: \*(Aqtrue\*(Aq, \&.\&.\&.\&. .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.changeOption (gid, options)\fP .RS 4 .sp Этот метод изменяет динамически параметры загрузки, которая обозначена \fIgid\fP\&. \fIgid\fP имеет тип строка\&. \fIoptions\fP имеет тип структура, доступны параметры: \fBbt\-max\-peers\fP, \fBbt\-request\-peer\-speed\-limit\fP, \fBmax\-download\-limit\fP и \fBmax\-upload\-limit\fP\&. Этот метод возвращает "OK", в случае успеха\&. .sp Следующий пример устанавливает параметр \fBmax\-download\-limit\fP в "20K" для загрузки, GID которой "1": .sp .if n \{\ .RS 4 .\} .nf >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, \&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.changeOption\*(Aq, \&.\&.\&. \*(Aqparams\*(Aq:[\*(Aq1\*(Aq, {\*(Aqmax\-download\-limit\*(Aq:\*(Aq10K\*(Aq}]}) >>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) >>> pprint(json\&.loads(c\&.read())) {u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: u\*(AqOK\*(Aq} .fi .if n \{\ .RE .\} .sp Следующий пример устанавливает параметр \fBmax\-download\-limit\fP в "20K" для загрузки, GID которой "1": .sp .if n \{\ .RS 4 .\} .nf >>> import xmlrpclib >>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) >>> s\&.aria2\&.changeOption(\*(Aq1\*(Aq, {\*(Aqmax\-download\-limit\*(Aq:\*(Aq20K\*(Aq}) \*(AqOK\*(Aq .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.getGlobalOption ()\fP .RS 4 .sp Этот метод возвращает глобальные параметры\&. Ответ имеет тип структура\&. Ее поля \- это название параметра\&. Поле имеет тип строка\&. Так как глобальные параметры используются в качестве шаблона для вновь добавляемой загрузки, ответ содержит поля возвращаемые методом \fBaria2\&.getOption\fP\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.changeGlobalOption (options)\fP .RS 4 .sp Этот метод изменяет динамически глобальные параметры\&. \fIoptions\fP имеет тип структура, доступны параметры: \fBmax\-concurrent\-downloads\fP, \fBmax\-overall\-download\-limit\fP, \fBmax\-overall\-upload\-limit\fP, \fBlog\-level\fP и \fBlog\fP\&. Используя параметр \fBlog\fP, вы можете динамически начинать вести журнал событий или изменять файл журнала событий\&. Чтобы остановить ведение журнала событий задайте пустую строку ("") в качестве значения параметра\&. Обратите внимание, что файл журнала событий всегда открыт в режиме добавления\&. Этот метод возвращает "OK", в случае успеха\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.purgeDownloadResult ()\fP .RS 4 .sp Этот метод очищает, для освобождения памяти, завершенные/ошибка/удаленные загрузки\&. Метод возвращает "OK"\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.removeDownloadResult (gid)\fP .RS 4 .sp Этот метод удаляет из памяти завершенную/ошибка/удаленную загрузку, которая обозначена \fIgid\fP\&. Метод возвращает "OK", в случае успеха\&. .sp Следующий пример удаляет результат загрузки, GID которой "1": .sp .if n \{\ .RS 4 .\} .nf >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, \&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.removeDownloadResult\*(Aq, \&.\&.\&. \*(Aqparams\*(Aq:[\*(Aq1\*(Aq]}) >>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) >>> pprint(json\&.loads(c\&.read())) {u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: u\*(AqOK\*(Aq} .fi .if n \{\ .RE .\} .sp Следующий пример удаляет результат загрузки, GID которой "1": .sp .if n \{\ .RS 4 .\} .nf >>> import xmlrpclib >>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) >>> s\&.aria2\&.removeDownloadResult(\*(Aq1\*(Aq) \*(AqOK\*(Aq .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.getVersion ()\fP .RS 4 .sp Этот метод возвращает версию программы и список включенных возможностей\&. Ответ имеет тип структура и содержит следующие поля\&. .PP version .RS 4 Номер версии программы в строке\&. .RE .PP enabledFeatures .RS 4 Список включенных возможностей\&. Каждое имя возможности имеет тип строка\&. .RE .sp .if n \{\ .RS 4 .\} .nf >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, \&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.getVersion\*(Aq}) >>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) >>> pprint(json\&.loads(c\&.read())) {u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: {u\*(AqenabledFeatures\*(Aq: [u\*(AqAsync DNS\*(Aq, u\*(AqBitTorrent\*(Aq, u\*(AqFirefox3 Cookie\*(Aq, u\*(AqGZip\*(Aq, u\*(AqHTTPS\*(Aq, u\*(AqMessage Digest\*(Aq, u\*(AqMetalink\*(Aq, u\*(AqXML\-RPC\*(Aq], u\*(Aqversion\*(Aq: u\*(Aq1\&.11\&.0\*(Aq}} .fi .if n \{\ .RE .\} .sp .if n \{\ .RS 4 .\} .nf >>> import xmlrpclib >>> from pprint import pprint >>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) >>> r = s\&.aria2\&.getVersion() >>> pprint(r) {\*(AqenabledFeatures\*(Aq: [\*(AqAsync DNS\*(Aq, \*(AqBitTorrent\*(Aq, \*(AqFirefox3 Cookie\*(Aq, \*(AqGZip\*(Aq, \*(AqHTTPS\*(Aq, \*(AqMessage Digest\*(Aq, \*(AqMetalink\*(Aq, \*(AqXML\-RPC\*(Aq], \*(Aqversion\*(Aq: \*(Aq1\&.11\&.0\*(Aq} .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.getSessionInfo ()\fP .RS 4 .sp Этот метод возвращает информацию о сессии\&. Ответ имеет тип структура и содежит следующие поля\&. .PP sessionId .RS 4 ID сессии, которое генерируется каждый раз, при запуске aria2\&. .RE .sp .if n \{\ .RS 4 .\} .nf >>> import urllib2, json >>> from pprint import pprint >>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, \&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.getSessionInfo\*(Aq}) >>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) >>> pprint(json\&.loads(c\&.read())) {u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: {u\*(AqsessionId\*(Aq: u\*(Aqcd6a3bc6a1de28eb5bfa181e5f6b916d44af31a9\*(Aq}} .fi .if n \{\ .RE .\} .sp .if n \{\ .RS 4 .\} .nf >>> import xmlrpclib >>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) >>> s\&.aria2\&.getSessionInfo() {\*(AqsessionId\*(Aq: \*(Aqcd6a3bc6a1de28eb5bfa181e5f6b916d44af31a9\*(Aq} .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.shutdown ()\fP .RS 4 .sp Этот метод закрывает aria2\&. Метод возвращает "OK"\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBaria2.forceShutdown ()\fP .RS 4 .sp Этот метод закрывает aria2\&. Метод действует подобно \fBaria2\&.shutdown\fP, за исключением того, что метод выполняется без каких\-либо действий, которые требует времени, связь с BitTorrent\-трекером пропускается\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBsystem.multicall (methods)\fP .RS 4 .sp Этот метод объединяет несколько вызовов методов в один запрос\&. \fImethods\fP имеет тип массив, а элемент является структурой\&. Структура содержит два поля: "methodName" и "params"\&. "methodName" \- это имя вызываемого метода, а "params" \- содержит параметры к методу\&. Метод возвращает массив ответов\&. Элемент массива будет одним из двух: массивом из одного элемента, который содержит возвращаемое значение, для каждого вызываемого метода или структурой с ошибками в полях, если вызов объединенного метода завершился неудачно\&. .sp В следующем примере мы добавляем 2 загрузки\&. Первая \- http://example\&.org/file и вторая \- один \&.torrent\-файл: .sp .if n \{\ .RS 4 .\} .nf >>> import urllib2, json, base64 >>> from pprint import pprint >>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, \&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqsystem\&.multicall\*(Aq, \&.\&.\&. \*(Aqparams\*(Aq:[[{\*(AqmethodName\*(Aq:\*(Aqaria2\&.addUri\*(Aq, \&.\&.\&. \*(Aqparams\*(Aq:[[\*(Aqhttp://example\&.org\*(Aq]]}, \&.\&.\&. {\*(AqmethodName\*(Aq:\*(Aqaria2\&.addTorrent\*(Aq, \&.\&.\&. \*(Aqparams\*(Aq:[base64\&.b64encode(open(\*(Aqfile\&.torrent\*(Aq)\&.read())]}]]}) >>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) >>> pprint(json\&.loads(c\&.read())) {u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: [[u\*(Aq1\*(Aq], [u\*(Aq2\*(Aq]]} .fi .if n \{\ .RE .\} .sp JSON\-RPC также поддерживает пакетный запрос, который описывается в спецификации JSON\-RPC 2\&.0: .sp .if n \{\ .RS 4 .\} .nf >>> jsonreq = json\&.dumps([{\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, \&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.addUri\*(Aq, \&.\&.\&. \*(Aqparams\*(Aq:[[\*(Aqhttp://example\&.org\*(Aq]]}, \&.\&.\&. {\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqasdf\*(Aq, \&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.addTorrent\*(Aq, \&.\&.\&. \*(Aqparams\*(Aq:[base64\&.b64encode(open(\*(Aqfile\&.torrent\*(Aq)\&.read())]}]) >>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) >>> pprint(json\&.loads(c\&.read())) [{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: u\*(Aq1\*(Aq}, {u\*(Aqid\*(Aq: u\*(Aqasdf\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: u\*(Aq2\*(Aq}] .fi .if n \{\ .RE .\} .sp В следующем примере мы добавляем 2 загрузки\&. Первая \- http://example\&.org/file и вторая \- один \&.torrent\-файл: .sp .if n \{\ .RS 4 .\} .nf >>> import xmlrpclib >>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) >>> mc = xmlrpclib\&.MultiCall(s) >>> mc\&.aria2\&.addUri([\*(Aqhttp://example\&.org/file\*(Aq]) >>> mc\&.aria2\&.addTorrent(xmlrpclib\&.Binary(open(\*(Aqfile\&.torrent\*(Aq)\&.read())) >>> r = mc() >>> tuple(r) (\*(Aq2\*(Aq, \*(Aq3\*(Aq) .fi .if n \{\ .RE .\} .RE .SS "Обработка ошибок" .sp В JSON\-RPC, aria2 возвращает JSON\-объект, который содержит код ошибки в коде и сообщение об ошибке в сообщении\&. .sp В XML\-RPC, aria2 возвращает faultCode=1 и сообщение об ошибке в faultString\&. .SS Параметры .sp Те же параметры, что доступны для \fB\-i\fP\&. Смотрите подраздел \fBInput File\fP для полного списка параметров\&. .sp В структуре, имя элемента \- это имя параметра (без "\-\-"), а значение элемента \- аргумент в виде строки\&. .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПример JSON\-RPC\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf {\*(Aqsplit\*(Aq:\*(Aq1\*(Aq, \*(Aqhttp\-proxy\*(Aq:\*(Aqhttp://proxy/\*(Aq} .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПример XML\-RPC\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf split 1 http\-proxy http://proxy/ .fi .if n \{\ .RE .\} .sp Параметры \fBheader\fP и \fBindex\-out\fP допускают нескольких определений в командной строке\&. Поскольку имя должно быть уникальным в структуре (многие реализации библиотеки XML\-RPC использует хэш или словарь для структуры), одной строки не достаточно\&. Для преодоления этой ситуации, они могут взять массив в качестве значения, а также строку\&. .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПример JSON\-RPC\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf {\*(Aqheader\*(Aq:[\*(AqAccept\-Language: ja\*(Aq, \*(AqAccept\-Charset: utf\-8\*(Aq]} .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПример XML\-RPC\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf header Accept\-Language: ja Accept\-Charset: utf\-8 .fi .if n \{\ .RE .\} .sp Следующий пример добавляет загрузку с двумя параметрами: dir и header\&. Параметр header имеет 2 значения, поэтому используется список: .sp .if n \{\ .RS 4 .\} .nf >>> import xmlrpclib >>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) >>> opts = dict(dir=\*(Aq/tmp\*(Aq, \&.\&.\&. header=[\*(AqAccept\-Language: ja\*(Aq, \&.\&.\&. \*(AqAccept\-Charset: utf\-8\*(Aq]) >>> s\&.aria2\&.addUri([\*(Aqhttp://example\&.org/file\*(Aq], opts) \*(Aq1\*(Aq .fi .if n \{\ .RE .\} .RE .SS "JSON\-RPC используя HTTP GET" .sp JSON\-RPC\-интерфейс также поддерживает запрос через HTTP GET\&. Схема кодирования в GET параметров основанных на JSON\-RPC через HTTP, описана в спецификации (2008\-1\-15(RC1))\&. Кодирование параметров через GET следующие: .sp .if n \{\ .RS 4 .\} .nf /jsonrpc?method=METHOD_NAME&id=ID¶ms=BASE64_ENCODED_PARAMS .fi .if n \{\ .RE .\} .sp \fImethod\fP и \fIid\fP всегда обрабатывается как JSON\-строка и они должны быть в кодировке UTF\-8\&. .sp Например, закодированная строка aria2\&.tellStatus(\fI3\fP) с id=\fIfoo\fP выглядит так: .sp .if n \{\ .RS 4 .\} .nf /jsonrpc?method=aria2\&.tellStatus&id=foo¶ms=WyIzIl0%3D .fi .if n \{\ .RE .\} .sp Параметр \fIparams\fP \- это JSON\-массив в Base64\-кодировке, который обычно появляется в атрибуте \fIparams\fP в JSON\-RPC\-запросе объекта\&. В примере выше, params \- [\fI3\fP], следовательно: .sp .if n \{\ .RS 4 .\} .nf [\*(Aq3\*(Aq] \-\-(Base64)\-\-> WyIzIl0= \-\-(Percent Encode)\-\-> WyIzIl0%3D .fi .if n \{\ .RE .\} .sp JSON\-RPC\-интерфейс поддерживает JSONP\&. Вы можете определить функцию обратного вызова в параметре \fIjsoncallback\fP\&. .sp .if n \{\ .RS 4 .\} .nf /jsonrpc?method=aria2\&.tellStatus&id=foo¶ms=WyIzIl0%3D&jsoncallback=cb .fi .if n \{\ .RE .\} .sp Для пакетного запроса, параметры \fImethod\fP и \fIid\fP не должны быть указаны\&. Полный запрос должен быть определен в параметре \fIparams\fP\&. Например, пакетный запрос .sp .if n \{\ .RS 4 .\} .nf [{\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, \*(Aqmethod\*(Aq:\*(Aqaria2\&.getVersion\*(Aq}, {\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqasdf\*(Aq, \*(Aqmethod\*(Aq:\*(Aqaria2\&.tellActive\*(Aq}] .fi .if n \{\ .RE .\} .sp должен кодироваться так: .sp .if n \{\ .RS 4 .\} .nf /jsonrpc?params=W3sianNvbnJwYyI6ICIyLjAiLCAiaWQiOiAicXdlciIsICJtZXRob2QiOiAiYXJpYTIuZ2V0VmVyc2lvbiJ9LCB7Impzb25ycGMiOiAiMi4wIiwgImlkIjogImFzZGYiLCAibWV0aG9kIjogImFyaWEyLnRlbGxBY3RpdmUifV0%3D .fi .if n \{\ .RE .\} .SS "Пример кода клиента XML\-RPC" .sp Следующий Ruby\-скрипт добавляет \fIhttp://localhost/aria2\&.tar\&.bz2\fP и параметр \fB\-\-dir\fP=\fI/downloads\fP к aria2c, которая работает на localhost и отображает ответ\&. .sp .if n \{\ .RS 4 .\} .nf #!/usr/bin/env ruby require \*(Aqxmlrpc/client\*(Aq require \*(Aqpp\*(Aq client=XMLRPC::Client\&.new2("http://localhost:6800/rpc") options={ "dir" => "/downloads" } result=client\&.call("aria2\&.addUri", [ "http://localhost/aria2\&.tar\&.bz2" ], options) pp result .fi .if n \{\ .RE .\} .sp Если вы любитель Python, то можете использовать xmlrpclib(для Python3\&.x, используйте взамен xmlrpc\&.client) для взаимодействия с aria2\&. .sp .if n \{\ .RS 4 .\} .nf import xmlrpclib from pprint import pprint s = xmlrpclib\&.ServerProxy("http://localhost:6800/rpc") r = s\&.aria2\&.addUri(["http://localhost/aria2\&.tar\&.bz2"], {"dir":"/downloads"}) pprint(r) .fi .if n \{\ .RE .\} .SH ПРИМЕРЫ .SS "Загрузка по HTTP/FTP" .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBЗагрузка файла\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c "http://host/file\&.zip" .fi .if n \{\ .RE .\} .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Для остановки загрузки, нажмите Ctrl\-C\&. Вы можете возобновить передачу, запустив aria2c с теми же аргументами в том же каталоге\&. Вы можете изменить URI, если они указывают на тот же самый файл\&. .sp .5v .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBЗагрузка файла с 2\-ух разных HTTP\-серверов\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c "http://host/file\&.zip" "http://mirror/file\&.zip" .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBЗагрузка файла с одно хоста, используя 2 соединения\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-x2 \-k1M "http://host/file\&.zip" .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBЗагрузка файла с HTTP\- и FTP\-серверов\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c "http://host1/file\&.zip" "ftp://host2/file\&.zip" .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBОдновременная загрузка файлов, перечисленных в текстовом файле\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-ifiles\&.txt \-j2 .fi .if n \{\ .RE .\} .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp параметр \-j указывает количество параллельных загрузок\&. .sp .5v .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBИспользование прокси\-сервера\fP .RS 4 .sp Для HTTP: .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-http\-proxy="http://proxy:8080" "http://host/file" .fi .if n \{\ .RE .\} .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-http\-proxy="http://proxy:8080" \-\-no\-proxy="localhost,127\&.0\&.0\&.1,192\&.168\&.0\&.0/16" "http://host/file" .fi .if n \{\ .RE .\} .sp Для FTP: .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-ftp\-proxy="http://proxy:8080" "ftp://host/file" .fi .if n \{\ .RE .\} .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Смотрите для подробностей \fB\-\-http\-proxy\fP, \fB\-\-https\-proxy\fP, \fB\-\-ftp\-proxy\fP, \fB\-\-all\-proxy\fP и \fB\-\-no\-proxy\fP\&. Вы можете указать прокси в переменных окружения\&. Смотрите раздел \fBОКРУЖЕНИЕ\fP\&. .sp .5v .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПрокси\-сервер с авторизацией\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-http\-proxy="http://username:password@proxy:8080" "http://host/file" .fi .if n \{\ .RE .\} .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-http\-proxy="http://proxy:8080" \-\-http\-proxy\-user="username" \-\-http\-proxy\-passwd="password" "http://host/file" .fi .if n \{\ .RE .\} .RE .SS "Загрузка Metalink" .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBЗагрузка файлов с удалленного Metalink\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-follow\-metalink=mem "http://host/file\&.metalink" .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBЗагрузка, используя локальный metalink\-файл\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-p \-\-lowest\-speed\-limit=4000 file\&.metalink .fi .if n \{\ .RE .\} .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Для остановки загрузки, нажмите Ctrl\-C\&. Вы можете возобновить передачу, запустив aria2c с теми же аргументами в том же каталоге\&. .sp .5v .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBЗагрузка нескольких локальных metalink\-файлов\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-j2 file1\&.metalink file2\&.metalink .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBЗагрузка только выбранных файлов, используя индекс\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-select\-file=1\-4,8 file\&.metalink .fi .if n \{\ .RE .\} .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Индекс выводится на консоль при использовании параметра \-S\&. .sp .5v .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBЗагрузка файла, используя локальный .metalink\-файл с пользовательскими настройками\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-metalink\-location=jp,us \-\-metalink\-version=1\&.1 \-\-metalink\-language=en\-US file\&.metalink .fi .if n \{\ .RE .\} .RE .SS "Загрузка BitTorrent" .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBЗагрузка файлов из удаленного BitTorrent\-файла\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-follow\-torrent=mem "http://host/file\&.torrent" .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBЗагрузка, используя локальный torrent\-файл\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-max\-upload\-limit=40K file\&.torrent .fi .if n \{\ .RE .\} .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp \-\-max\-upload\-limit определяет максимальную скорость отдачи\&. .sp .5v .RE .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Для остановки загрузки, нажмите Ctrl\-C\&. Вы можете возобновить передачу, запустив aria2c с теми же аргументами в том же каталоге\&. .sp .5v .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBЗагрузка, используя BitTorrent Magnet URI\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c "magnet:?xt=urn:btih:248D0A1CD08284299DE78D5C1ED359BB46717D8C&dn=aria2" .fi .if n \{\ .RE .\} .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Не забывайте заключать BitTorrent Magnet URI, в которой есть символ "&", в одиночные(\*(Aq) или двойные(") кавычки\&. .sp .5v .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBЗагрузка 2\-х торрентов\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-j2 file1\&.torrent file2\&.torrent .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBЗагрузка файла, используя торрент и HTTP/FTP\-сервер\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-Ttest\&.torrent "http://host1/file" "ftp://host2/file" .fi .if n \{\ .RE .\} .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Загрузка много файлового торрента через HTTP/FTP не поддерживается\&. .sp .5v .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBЗагрузка только выбранных файлов, используя индекс (обычно называют "выборочная загрузка")\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-select\-file=1\-4,8 file\&.torrent .fi .if n \{\ .RE .\} .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Индекс выводится на консоль при использовании параметра \-S\&. .sp .5v .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBУказание имени выходного файла\fP .RS 4 .sp Для указания выходного имени файла в BitTorrent\-загрузках, вам нужно узнать индекс файла в torrent\-файле, используя параметр \fB\-S\fP\&. Например, результат выглядит следующим образом: .sp .if n \{\ .RS 4 .\} .nf idx|path/length ===+====================== 1|dist/base\-2\&.6\&.18\&.iso |99\&.9MiB \-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- 2|dist/driver\-2\&.6\&.18\&.iso |169\&.0MiB \-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- .fi .if n \{\ .RE .\} .sp Сохраняет \fIdist/base\-2\&.6\&.18\&.iso\fP в \fI/tmp/mydir/base\&.iso\fP и \fIdist/driver\-2\&.6\&.18\&.iso\fP в \fI/tmp/dir/driver\&.iso\fP, при использовании следующей команды: .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-dir=/tmp \-\-index\-out=1=mydir/base\&.iso \-\-index\-out=2=dir/driver\&.iso file\&.torrent .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBИзменение прослушиваемого порта для входящих соединений от пиров\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-listen\-port=7000\-7001,8000 file\&.torrent .fi .if n \{\ .RE .\} .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Т.к. aria2 не настраивает брандмауэр или маршрутизатор для перенаправления портов, вам решать как это сделать вручную\&. .sp .5v .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBУказать условие остановки программы после завершения загрузки торрента\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-seed\-time=120 \-\-seed\-ratio=1\&.0 file\&.torrent .fi .if n \{\ .RE .\} .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp В приведенном выше примере, программа завершается через 120 минут после завершения загрузки или при достижении рейтинга сидирования 1\&.0\&. .sp .5v .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBРегулировка скорости отдачи\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-max\-upload\-limit=100K file\&.torrent .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBВключить IPv4 DHT\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-enable\-dht \-\-dht\-listen\-port=6881 file\&.torrent .fi .if n \{\ .RE .\} .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp DHT использует udp\-порт\&. Так как aria2 не настраивает брандмауэр или маршрутизатор для перенаправления портов, вам решать как это сделать вручную\&. .sp .5v .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBВключить IPv6 DHT\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-enable\-dht6 \-\-dht\-listen\-port=6881 \-\-dht\-listen\-addr6=YOUR_GLOBAL_UNICAST_IPV6_ADDR \-\-enable\-async\-dns6 .fi .if n \{\ .RE .\} .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Если aria2c не собрана с c\-ares, то \fB\-\-enable\-async\-dns6\fP не нужен\&. aria2 разделяет один и тот же порт между IPv4 и IPv6 DHT\&. .sp .5v .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBДобавить и удалить URI трекера\fP .RS 4 .sp Удалить все URI анонса трекеров, описанных в \&.torrent\-файле и взамен использовать "http://tracker1/announce" и "http://tracker2/announce"\&. .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-bt\-exclude\-tracker="*" \-\-bt\-tracker="http://tracker1/announce,http://tracker2/announce" file\&.torrent .fi .if n \{\ .RE .\} .RE .SS "Больше расширенных возможностей для HTTP" .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBЗагрузить куки\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-load\-cookies=cookies\&.txt "http://host/file\&.zip" .fi .if n \{\ .RE .\} .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Вы можите использовать без изменения cookie\-файл Firefox/Mozilla/Chromium\&. .sp .5v .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBВозобновление загрузки, которая начата в браузере или другой программе\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-c \-s2 "http://host/partiallydownloadedfile\&.zip" .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBКлиентский сертификат авторизации для SSL/TLS\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-certificate=/path/to/mycert\&.pem \-\-private\-key=/path/to/mykey\&.pem https://host/file .fi .if n \{\ .RE .\} .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Указанный в \fB\-\-private\-key\fP файл должен быть расшифрован\&. Режим работы с исходно зашифрованным закрытым ключом не определен\&. .sp .5v .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПроверить узел при SSL/TLS, используя исходные CA\-сертификаты\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-ca\-certificate=/path/to/ca\-certificates\&.crt \-\-check\-certificate https://host/file .fi .if n \{\ .RE .\} .RE .SS "И еще больше расширенных возможностей" .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBРегулировка скорости загрузки\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-max\-download\-limit=100K file\&.metalink .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBИсправить поврежденную загрузку\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-V file\&.metalink .fi .if n \{\ .RE .\} .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Этот параметр доступен только при использовании BitTorrent или metalink с контрольными суммами блоков данных\&. .sp .5v .RE .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBОтклонить соединение, если скорость загрузки меньше чем определенное значение\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-lowest\-speed\-limit=10K file\&.metalink .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПоддержка параметризованных URI\fP .RS 4 .sp Вы можете определить набор частей: .sp .if n \{\ .RS 4 .\} .nf aria2c \-P "http://{host1,host2,host3}/file\&.iso" .fi .if n \{\ .RE .\} .sp Вы можете определить числовую последовательность: .sp .if n \{\ .RS 4 .\} .nf aria2c \-Z \-P "http://host/image[000\-100]\&.png" .fi .if n \{\ .RE .\} .sp .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПримечание\fP .ps -1 .br .sp Параметр \-Z необходим, если все URI не указывают на один и тот же файл, как в примере указанном выше\&. .sp .5v .RE .sp Вы можете определить шаг счетчика: .sp .if n \{\ .RS 4 .\} .nf aria2c \-Z \-P "http://host/image[A\-Z:2]\&.png" .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBПараллельные загрузки с произвольным числом URI,metalink,torrent\fP .RS 4 .sp .if n \{\ .RS 4 .\} .nf aria2c \-j3 \-Z "http://host/file1" file2\&.torrent file3\&.metalink .fi .if n \{\ .RE .\} .RE .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBШифрование BitTorrent\fP .RS 4 .sp Шифровать всю полезную нагрузку используя ARC4: .sp .if n \{\ .RS 4 .\} .nf aria2c \-\-bt\-min\-crypto\-level=arc4 \-\-bt\-require\-crypto=true file\&.torrent .fi .if n \{\ .RE .\} .RE .SH "СМОТРИТЕ ТАКЖЕ" .sp Веб\-сайт проекта: http://aria2\&.sourceforge\&.net/ .sp Вики aria2: http://sourceforge\&.net/apps/trac/aria2/wiki .sp Домашняя страница Metalink: http://www\&.metalinker\&.org/ .sp Описание формата Metalink: http://tools\&.ietf\&.org/html/rfc5854 .SH "АВТОРСКОЕ ПРАВО" .sp Авторское право \(co 2006, 2011 Tatsuhiro Tsujikawa .sp Эта программа является свободным программным обеспечением; вы можете распространять его и/или изменять его в соответствии с условиями лицензии GNU General Public License, опубликованной Free Software Foundation; либо License версии 2, либо (по вашему выбору) любой более поздней версии\&. .sp Эта программа распространяется в надежде, что она будет полезной, но БЕЗ КАКИХ\-ЛИБО ГАРАНТИЙ, даже без подразумеваемых гарантий КОММЕРЧЕСКОЙ ЦЕННОСТИ или ПРИГОДНОСТИ ДЛЯ ОПРЕДЕЛЕННОЙ ЦЕЛИ\&. См. GNU General Public License для более подробной информации\&. .sp Вы должны получить копию GNU General Public License вместе с этой программой; если нет, напишите в Free Software Foundation, Inc\&., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA .sp Кроме того, в качестве особого исключения, владельцы авторских прав дают разрешение на ссылку части кода этой программы с библиотекой OpenSSL при определенных условиях, как описано в каждом отдельном исходном файле, а также распространять эту комбинацию вместе\&. Вы должны подчиняться GNU General Public License во всех отношениях для всего используемого кода, кроме OpenSSL\&. Если вы измените файл(ы) с этим исключением, вы можете расширить это исключение для вашей версии файла(ов), но вы не обязаны делать это\&. Если вы не хотите сделать это, удалите это заявление об исключении из вашей версии\&. Если вы удалите это заявление об исключении из всех исходных файлов в программе, то удалить его и здесь\&. .SH АВТОР .PP \fBTatsuhiro Tsujikawa\fP <\&t\-tujikawa@users\&.sourceforge\&.net\&> .RS 4 Автор. .RE .SH "АВТОР ПЕРЕВОДА" ITriskTI .SH "ПРИМЕЧАНИЕ Эта страница руководства может содержать не обязательно самую последнюю информацию. Если есть некоторые противоречия между этой страницей руководства и фактическим программным обеспечением, пожалуйста, обращайтесь к английской версии страницы руководства.