.\" t
.\" Title: aria2c
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2
.\" Date: 06/21/2011
.\" Manual: Aria2 Manual
.\" Source: Aria2 1.12.0
.\" Language: English
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH ARIA2C 1 06/21/2011 "Aria2 1\&.12\&.0" "Руководство по 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\-\-stream\-piece\-selector\fP=SELECTOR
.RS 4
Укажите алгоритм выбора блока, который используется в
HTTP/FTP\-загрузке\&. Блок \- означает сегмент фиксированной длины, который
загружается параллельно, в разделенной на части, загрузке\&. Если задано
\fIdefault\fP, то aria2 выберет блок так, чтобы это уменьшило количество
установленных подключений\&. Это разумное поведение по умолчанию, поскольку
установка подключения очень затратная операция\&. Если задано \fIinorder\fP, то
aria2 выберет блок, который имеет минимальный индекс\&. Index=0 означает
первый из файла\&. Это будет полезно при просмотре фильма, в то время как он
загружается\&. Параметр \fB\-\-enable\-http\-pipelining\fP может быть полезен для
снижения накладных расходов при повторном подключении\&. Обратите внимание,
что aria2 принимает на обработку параметр \fB\-\-min\-split\-size\fP, так что
необходимо будет указать разумное значение параметра
\fB\-\-min\-split\-size\fP\&. По умолчанию: \fIdefault\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\-\-pause\fP[=\fItrue\fP|\fIfalse\fP]
.RS 4
Приостановка загрузки после добавления\&. Этот параметр действенен только,
когда задан \fB\-\-enable\-rpc\fP=\fItrue\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 или NTFS (только сборка MinGW) тогда лучше выбрать
\fIfalloc\fP\&. Так как они резервируют место под большие (на несколько
Гигабайт) файлы почти мгновенно\&. Не используйте \fIfalloc\fP вместе с
наследными файловыми системами, такими как ext3 и FAT32, потому что это
будет продолжаться почти столько же времени, как и \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 и чьи метаданные не могут быть
сохранены как файл, не будут сохраняться\&. Загрузки удаленные с
использованием \fBaria2\&.remove\fP и \fBaria2\&.forceRemove\fP не будут
сохранены\&.
.RE
.PP
\fB\-\-stop\fP=SEC
.RS 4
Останавливать программу после того как пройдет SEC секунд\&. Если задано
\fI0\fP, эта возможность будет отключена\&. По умолчанию: \fI0\fP
.RE
.PP
\fB\-\-truncate\-console\-readout\fP[=\fItrue\fP|\fIfalse\fP]
.RS 4
Укорачивать консольный вывод, чтобы он поместился в одну строку\&. По
умолчанию: \fItrue\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
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBpause\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBstream\-piece\-selector\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.getGlobalStat ()\fP
.RS 4
.sp
Этот метод возвращает глобальную статистику по скорости загрузки и скорости
отдачи\&. Ответ имеет тип структура и содержит следующие поля\&. Поле имеет
тип строка\&.
.PP
downloadSpeed
.RS 4
Общая скорости загрузки (байт/сек)\&.
.RE
.PP
uploadSpeed
.RS 4
Общая скорости отдачи (байт/сек)\&.
.RE
.PP
numActive
.RS 4
Количество активных загрузок\&.
.RE
.PP
numWaiting
.RS 4
Количество ожидающих загрузок\&.
.RE
.PP
numStopped
.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\&.getGlobalStat\*(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\*(AqdownloadSpeed\*(Aq: u\*(Aq21846\*(Aq,
u\*(AqnumActive\*(Aq: u\*(Aq2\*(Aq,
u\*(AqnumStopped\*(Aq: u\*(Aq0\*(Aq,
u\*(AqnumWaiting\*(Aq: u\*(Aq0\*(Aq,
u\*(AquploadSpeed\*(Aq: u\*(Aq0\*(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\&.getGlobalStat()
>>> pprint(r)
{\*(AqdownloadSpeed\*(Aq: \*(Aq23136\*(Aq,
\*(AqnumActive\*(Aq: \*(Aq2\*(Aq,
\*(AqnumStopped\*(Aq: \*(Aq0\*(Aq,
\*(AqnumWaiting\*(Aq: \*(Aq0\*(Aq,
\*(AquploadSpeed\*(Aq: \*(Aq0\*(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.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 "АВТОР ПЕРЕВОДА"
ITriskTI
.SH "ПРИМЕЧАНИЕ"
Эта страница руководства может содержать не обязательно самую последнюю информацию. Если есть некоторые противоречия между этой страницей руководства и фактическим программным обеспечением, пожалуйста, обращайтесь к английской версии страницы руководства.