|
@@ -0,0 +1,6157 @@
|
|
|
+.\" t
|
|
|
+.\" Title: aria2c
|
|
|
+.\" Author: Tatsuhiro Tsujikawa <t-tujikawa@users.sourceforge.net>
|
|
|
+.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
|
|
|
+.\" Date: 05/21/2011
|
|
|
+.\" Manual: Aria2 Manual
|
|
|
+.\" Source: Aria2 1.11.2
|
|
|
+.\" Language: English
|
|
|
+.\"
|
|
|
+.\"*******************************************************************
|
|
|
+.\"
|
|
|
+.\" This file was generated with po4a. Translate the source file.
|
|
|
+.\"
|
|
|
+.\"*******************************************************************
|
|
|
+.TH ARIA2C 1 05/21/2011 "Aria2 1\&.11\&.2" "Руководство по Aria2"
|
|
|
+.ie \n(.g .ds Aq \(aq
|
|
|
+.el .ds Aq '
|
|
|
+.\" -----------------------------------------------------------------
|
|
|
+.\" * Define some portability stuff
|
|
|
+.\" -----------------------------------------------------------------
|
|
|
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
+.\" http://bugs.debian.org/507673
|
|
|
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
|
|
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
+.\" -----------------------------------------------------------------
|
|
|
+.\" * set default formatting
|
|
|
+.\" -----------------------------------------------------------------
|
|
|
+.\" disable hyphenation
|
|
|
+.nh
|
|
|
+.\" disable justification (adjust text to left margin only)
|
|
|
+.ad l
|
|
|
+.\" -----------------------------------------------------------------
|
|
|
+.\" * MAIN CONTENT STARTS HERE *
|
|
|
+.\" -----------------------------------------------------------------
|
|
|
+.SH НАЗВАНИЕ
|
|
|
+aria2c \- Ультра быстрая утилита загрузки
|
|
|
+.SH СИНТАКСИС
|
|
|
+.sp
|
|
|
+aria2c [\fIПАРАМЕТРЫ\fP] [\fIURI\fP | \fIMAGNET\-ССЫЛКА\fP | \fITORRENT\-ФАЙЛ\fP |
|
|
|
+\fIMETALINK\-ФАЙЛ\fP]\&...
|
|
|
+.SH ОПИСАНИЕ
|
|
|
+.sp
|
|
|
+aria2 \- это утилита для загрузки файлов\&. Поддерживаемые протоколы:
|
|
|
+HTTP(S), FTP, BitTorrent и Metalink\&. Для загрузки файла, aria2 может
|
|
|
+использовать разные источники/протоколы и пытается максимально использовать
|
|
|
+пропускной способности канала\&. Есть поддержка загрузки файла по протоколам
|
|
|
+HTTP(S)/FTP и BitTorrent одновременно, пока данные загружаются по
|
|
|
+HTTP(S)/FTP, они тут же могут выгружаться в BitTorrent\-рой\&. Используя
|
|
|
+контрольные суммы блока данных для Metalink, aria2 автоматически проверяет
|
|
|
+куски данных, которые загружаются по BitTorrent\&.
|
|
|
+.SH ПАРАМЕТРЫ
|
|
|
+.SS "Основные параметры"
|
|
|
+.PP
|
|
|
+\fB\-d\fP, \fB\-\-dir\fP=DIR
|
|
|
+.RS 4
|
|
|
+Каталог для сохранения скачанных файлов\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-i\fP, \fB\-\-input\-file\fP=FILE
|
|
|
+.RS 4
|
|
|
+Загрузить URI, найденные в файле FILE\&. Вы можете указать несколько URI для
|
|
|
+одного объекта: отделяйте URI на одной строке, используя символ
|
|
|
+TAB\&. Читается ввод из stdin (стандартный поток ввода), когда указано
|
|
|
+\fI\-\fP\&. Дополнительные параметры можно указывать после каждой строки с
|
|
|
+URI\&. Эта необязательная строка должна начинаться с одного или нескольких
|
|
|
+пробелов и содержать один параметр\&. Смотрите подраздел \fBВходной файл\fP для
|
|
|
+детальных пояснений\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-l\fP, \fB\-\-log\fP=LOG
|
|
|
+.RS 4
|
|
|
+Имя файла для журнала событий\&. Если указан \fI\-\fP (дефис), то журнал событий
|
|
|
+будет записан в stdout (стандартный поток вывода).\& Если указана пустая
|
|
|
+строка (""), то журнал событий не будет записан в файл\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-j\fP, \fB\-\-max\-concurrent\-downloads\fP=N
|
|
|
+.RS 4
|
|
|
+Установить максимальное количество параллельных загрузок для каждого
|
|
|
+статического (HTTP/FTP) URI, torrent и metalink\&. Смотрите также параметры
|
|
|
+\fB\-s\fP и \fB\-C\fP\&. По умолчанию: \fI5\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-V\fP, \fB\-\-check\-integrity\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Проверить целостность файла путем подтверждения хэшей блоков или хэша
|
|
|
+полного файла\&. Этот параметр влияет лишь на BitTorrent и Metalink загрузки
|
|
|
+с контрольной суммой блоков. Параметр может обнаружить поврежденные части
|
|
|
+файла и перезагрузить их\&. Если есть хэш полного файла, то проверка
|
|
|
+выполняется только когда файл уже полностью загружен\&. Момент полной
|
|
|
+загрузки определяется по размеру файла\&. Если проверка хэша завершилась
|
|
|
+неудачно, то файл будет перезагружен с нуля\&. Если есть хэши блоков и хэш
|
|
|
+полного файла, то будут использоваться только хэши блоков\&. По умолчанию:
|
|
|
+\fIfalse\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-c\fP, \fB\-\-continue\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Продолжить загрузку частично загруженного файла\&. Используйте этот
|
|
|
+параметр, чтобы возобновить загрузку, начатую в веб\-браузере или в другой
|
|
|
+программе, которая загружает файлы последовательно сначала\&. Сейчас этот
|
|
|
+параметр можно использовать только для HTTP(S)/FTP загрузок\&. По умолчанию:
|
|
|
+\fIfalse\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-h\fP, \fB\-\-help\fP[=TAG|KEYWORD]
|
|
|
+.RS 4
|
|
|
+Справочное сообщение определяется метками (TAG)\&. Метки начинаются с
|
|
|
+"#"\&. Например, "\-\-help=#http" даст справку по параметрам, помеченным
|
|
|
+меткой "#http"\&. Если задано слово (KEYWORD), не являющееся меткой, то
|
|
|
+будет выведена справка по параметрам, содержащих это слово\&. Возможные
|
|
|
+значения: \fI#basic\fP, \fI#advanced\fP, \fI#http\fP, \fI#https\fP, \fI#ftp\fP,
|
|
|
+\fI#metalink\fP, \fI#bittorrent\fP, \fI#cookie\fP, \fI#hook\fP, \fI#file\fP, \fI#rpc\fP,
|
|
|
+\fI#experimental\fP, \fI#all\fP По умолчанию: \fI#basic\fP
|
|
|
+.RE
|
|
|
+.SS "Параметры HTTP/FTP"
|
|
|
+.PP
|
|
|
+\fB\-\-all\-proxy\fP=PROXY
|
|
|
+.RS 4
|
|
|
+Использовать указанный прокси\-сервер для всех протоколов\&. Для стирания
|
|
|
+ранее определенного адрес используйте ""\&. Вы можете отменить эту
|
|
|
+установку и указать прокси\-сервер для отдельного протокола, используя
|
|
|
+параметры \fB\-\-http\-proxy\fP, \fB\-\-https\-proxy\fP и \fB\-\-ftp\-proxy\fP\&. Влияет на
|
|
|
+все URI\&. Формат PROXY \-
|
|
|
+[http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ]\&. Смотрите также раздел
|
|
|
+\fBОКРУЖЕНИЕ\fP
|
|
|
+.RE
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Если пользователь и пароль вставлены в URI\-прокси и они также указаны в
|
|
|
+параметрах \fB\-\-{http,https,ftp,all}\-proxy\-{user,passwd}\fP, то приоритетным
|
|
|
+будет самое последнее\&. Например, у вас http\-proxy\-user="myname",
|
|
|
+http\-proxy\-passwd="mypass" в aria2\&.conf и вы указали
|
|
|
+\-\-http\-proxy="http://proxy" в командной строке, тогда запрос к HTTP\-прокси
|
|
|
+"http://proxy" будет с пользователем "myname" и паролем "mypass"\&. Другой
|
|
|
+пример: если вы указали в командной строке
|
|
|
+\-\-http\-proxy="http://user:pass@proxy" \-\-http\-proxy\-user="myname"
|
|
|
+\-\-http\-proxy\-passwd="mypass", тогда запрос к HTTP\-прокси "http://proxy"
|
|
|
+будет с пользователем "myname" и паролем "mypass"\&. Еще один пример: если
|
|
|
+вы указали в командной строке \-\-http\-proxy\-user="myname"
|
|
|
+\-\-http\-proxy\-passwd="mypass" \-\-http\-proxy="http://user:pass@proxy", тогда
|
|
|
+запрос к HTTP\-прокси "http://proxy" будет с пользователем "user" и паролем
|
|
|
+"pass"\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-all\-proxy\-passwd\fP=PASSWD
|
|
|
+.RS 4
|
|
|
+Задать пароль для параметра \fB\-\-all\-proxy\fP\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-all\-proxy\-user\fP=USER
|
|
|
+.RS 4
|
|
|
+Задать пользователя для параметра \fB\-\-all\-proxy\fP\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-connect\-timeout\fP=SEC
|
|
|
+.RS 4
|
|
|
+Задать в соединении время ожидания в секундах для установки подключения к
|
|
|
+HTTP/FTP/прокси серверу\&. После установки подключения этот параметр не
|
|
|
+имеет значения, и вместо него используется параметр \fB\-\-timeout\fP\&. По
|
|
|
+умолчанию: \fI60\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-dry\-run\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Если задано \fItrue\fP, aria2 только проверяет, является ли удаленный файл
|
|
|
+доступным и не загружает данные\&. Этот параметр влияет на HTTP/FTP
|
|
|
+загрузку\&. BitTorrent загрузки отменяются, если указано \fItrue\fP. По
|
|
|
+умолчанию: \fIfalse\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-lowest\-speed\-limit\fP=SPEED
|
|
|
+.RS 4
|
|
|
+Закрывать подключение, если скорость загрузки меньше чем или равна значению
|
|
|
+SPEED (байт в секунду)\&. 0 означает, что aria2 не имеет нижнего ограничения
|
|
|
+скорости\&. Вы можете добавить \fIK\fP или \fIM\fP(1K = 1024, 1M = 1024K)\&. Этот
|
|
|
+параметр не влияет на BitTorrent загрузки\&. По умолчанию: \fI0\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-x\fP, \fB\-\-max\-connection\-per\-server\fP=NUM
|
|
|
+.RS 4
|
|
|
+Максимально количество соединений с одним сервером для каждой загрузки\&. По
|
|
|
+умолчанию: \fI1\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-max\-file\-not\-found\fP=NUM
|
|
|
+.RS 4
|
|
|
+Если aria2 получает статус "file not found" (файл не найден) с удаленных
|
|
|
+HTTP/FTP серверов NUM раз без получения хотя бы одного байта, тогда
|
|
|
+принудительно отказывается от загрузки. Укажите 0, чтобы отключить этот
|
|
|
+параметр. Этот параметр действенен только, когда используются HTTP/FTP
|
|
|
+серверы\&. По умолчанию: \fI0\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-m\fP, \fB\-\-max\-tries\fP=N
|
|
|
+.RS 4
|
|
|
+Задать количество попыток\&. \fI0\fP означает неограниченно. Смотрите также
|
|
|
+\fB\-\-retry\-wait\fP\&. По умолчанию: \fI5\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-k\fP, \fB\-\-min\-split\-size\fP=SIZE
|
|
|
+.RS 4
|
|
|
+aria2 не разбивает на части меньше чем 2*SIZE байт\&. Например, нужно
|
|
|
+загрузить файл размером 20МиБ\&. Если SIZE задать 10M, то aria2 может
|
|
|
+разбить файл на части в 2\-ух диапазонах [0\-10МиБ) и [10МиБ\-20МиБ) и
|
|
|
+загрузить его используя 2 источника (если \fB\-\-split\fP >= 2, конечно
|
|
|
+же)\&. Если SIZE задать 15M, т.к. 2*15M > 20MiB, aria2 не разобьет файл
|
|
|
+на части и загрузит его используя 1 источник\&. Вы можете добавить \fIK\fP или
|
|
|
+\fIM\fP(1K = 1024, 1M = 1024K)\&. Возможные значения: \fI1M\fP\-\fI1024M\fP По
|
|
|
+умолчанию: \fI20M\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-n\fP, \fB\-\-no\-netrc\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Отключить поддержку netrc\&. Поддержка netrc по умолчанию включена\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-no\-proxy\fP=ДОМЕНЫ
|
|
|
+.RS 4
|
|
|
+Укажите через запятую имена хостов, домены и сетевые адреса с CIDR\-блоком,
|
|
|
+или без него, для которых не будет использоваться прокси\&.
|
|
|
+.RE
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Для сетевых адресов с CIDR\-блоком (метод IP\-адресации, например
|
|
|
+192.168.0.20/24), работают только IPv4 адреса\&. Текущая реализация не
|
|
|
+разрешает имена хостов в URI для сравнения сетевых адресов указанных в
|
|
|
+\fB\-\-no\-proxy\fP\&. Таким образом это эффективно только если в URI есть
|
|
|
+IP\-адреса\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-o\fP, \fB\-\-out\fP=FILE
|
|
|
+.RS 4
|
|
|
+Сохранить загруженный файл под указанным именем\&. Если используется
|
|
|
+параметр \fB\-Z\fP, то данный параметр игнорируется.
|
|
|
+.RE
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+В Metalink или BitTorrent загрузках вы не можете указать имя файла\&. Имя
|
|
|
+файла указывается здесь только когда используются URI и aria2 с командной
|
|
|
+строкой без параметров \fB\-i\fP, \fB\-Z\fP\&. Например: aria2c \-o myfile\&.zip
|
|
|
+"http://mirror1/file\&.zip" "http://mirror2/file\&.zip"
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-proxy\-method\fP=METHOD
|
|
|
+.RS 4
|
|
|
+Задать метод для использования в прокси\-запросах\&. \fIMETHOD\fP один из двух:
|
|
|
+\fIget\fP или \fItunnel\fP\&. HTTPS загрузки всегда используют \fItunnel\fP, не
|
|
|
+обращая внимания на этот параметр\&. По умолчанию: \fIget\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-R\fP, \fB\-\-remote\-time\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Извлекать временную метку файла с удаленного HTTP/FTP сервера и, если это
|
|
|
+доступно, применить ее к локальному файлу\&. По умолчанию: \fIfalse\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-reuse\-uri\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Повторно использовать уже использованные URI, если не осталось
|
|
|
+неиспользованных URI\&. По умолчанию: \fItrue\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-retry\-wait\fP=SEC
|
|
|
+.RS 4
|
|
|
+Задать в секундах интервал ожидания между повторными попытками\&. При SEC
|
|
|
+> 0, если HTTP сервер возвращает ответ 503, aria2 будет снова пытаться
|
|
|
+загрузить\&. По умолчанию: \fI0\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-server\-stat\-of\fP=FILE
|
|
|
+.RS 4
|
|
|
+Указать имя файла, в который сохраняется профиль функционирования
|
|
|
+сервера\&. Вы можете загрузить сохраненные данные, используя параметр
|
|
|
+\fB\-\-server\-stat\-if\fP\&. Формат файла смотрите ниже в подразделе \fBПрофиль
|
|
|
+функционирования сервера\fP\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-server\-stat\-if\fP=FILE
|
|
|
+.RS 4
|
|
|
+Указать имя файла для загрузки профиля функционирования сервера. Загруженные
|
|
|
+данные будут использованы в некоторых URI селекторах, таких как
|
|
|
+\fIfeedback\fP. Смотрите также параметр \fB\-\-uri\-selector\fP\&. Формат файла
|
|
|
+смотрите ниже в подразделе \fBПрофиль функционирования сервера\fP\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-server\-stat\-timeout\fP=SEC
|
|
|
+.RS 4
|
|
|
+Указывает время ожидания в секундах, для того, чтобы сделать
|
|
|
+недействительным профиль функционирования сервера, с тех пор, как состоялся
|
|
|
+последний контакт с ним\&. По умолчанию: \fI86400\fP (24 часа)
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-s\fP, \fB\-\-split\fP=N
|
|
|
+.RS 4
|
|
|
+Загружать файл, используя N соединений\&. Если задано более чем N URI, будут
|
|
|
+использоваться первые N URI, а оставшиеся URI будут в резерве\&. Если задано
|
|
|
+менее чем N URI, то URI будут использованы более одного раза, так чтобы были
|
|
|
+задействованы все N соединений одновременно\&. Количество соединений к
|
|
|
+одному и тому же хосту ограничивается параметром
|
|
|
+\fB\-\-max\-connection\-per\-server\fP\&. Пожалуйста, смотрите также параметр \fB\-j\fP
|
|
|
+и \fB\-\-min\-split\-size\fP\&. Обратите внимание, что для Metalink загрузок этот
|
|
|
+параметр не эффективен, в место него используйте параметр \fB\-C\fP\&. По
|
|
|
+умолчанию: \fI5\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-t\fP, \fB\-\-timeout\fP=SEC
|
|
|
+.RS 4
|
|
|
+Задать время ожидания в секундах\&. По умолчанию: \fI60\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-uri\-selector\fP=SELECTOR
|
|
|
+.RS 4
|
|
|
+Указать алгоритм выбора URI\&. Возможные значения: \fIinorder\fP, \fIfeedback\fP и
|
|
|
+\fIadaptive\fP\&. Если задано \fIinorder\fP, то URI проверяются в порядке
|
|
|
+представления в списке URI\&. Если задано \fIfeedback\fP, aria2 использует
|
|
|
+скорость загрузки, которая наблюдалась в предыдущих загрузках, и выбирает
|
|
|
+самый быстрый сервер в списке URI\&. Это также эффективно исключает мертвые
|
|
|
+зеркала. Наблюдаемая скорость загрузки является частью профиля
|
|
|
+функционирования сервера, упомянутой в параметрах \fB\-\-server\-stat\-of\fP и
|
|
|
+\fB\-\-server\-stat\-if\fP\&. Если задано \fIadaptive\fP, выбирается одно из лучших
|
|
|
+зеркал для первого и резервного соединений\&. Дополнительно, возвращаются
|
|
|
+зеркала, которые пока не были проверены, и, если каждое из них уже
|
|
|
+проверено, возвращаются зеркала, которые должны быть проверены
|
|
|
+снова\&. Иначе зеркала больше не выбираются.\& Подобно \fIfeedback\fP,
|
|
|
+используются профиль функционирования сервера\&. По умолчанию: \fIfeedback\fP
|
|
|
+.RE
|
|
|
+.SS "Специфические параметры HTTP"
|
|
|
+.PP
|
|
|
+\fB\-\-ca\-certificate\fP=FILE
|
|
|
+.RS 4
|
|
|
+Использовать сертификат авторизации в FILE для проверки узлов\&. Сертификат
|
|
|
+должен быть в PEM\-формате и содержать многоразовые
|
|
|
+CA\-сертификаты\&. Используйте параметр \fB\-\-check\-certificate\fP, чтобы
|
|
|
+разрешить проверку\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-certificate\fP=FILE
|
|
|
+.RS 4
|
|
|
+Использовать клиентский сертификат в FILE\&. Сертификат должен быть в
|
|
|
+PEM\-формате\&. Вы можете использовать параметр \fB\-\-private\-key\fP, чтобы
|
|
|
+указать закрытый ключ\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-check\-certificate\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Проверять каждый из используемых сертификатов, которые указаны в параметре
|
|
|
+\fB\-\-ca\-certificate\fP\&. По умолчанию: \fItrue\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-http\-accept\-gzip\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Посылать "Accept: deflate, gzip" в запросе\-заголовке и добавлять в ответ,
|
|
|
+если удаленный сервер ответит "Content\-Encoding: gzip" или
|
|
|
+"Content\-Encoding: deflate"\&. По умолчанию: \fIfalse\fP
|
|
|
+.RE
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Некоторые серверы отвечают "Content\-Encoding: gzip" для файлов, которые сами
|
|
|
+по себе сжаты (gzipped)\&. aria2 добавляет их так или иначе из\-за заголовка
|
|
|
+ответа\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-http\-auth\-challenge\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Отправлять заголовок HTTP авторизации только тогда, когда он запрошен с
|
|
|
+сервера\&. Если задано \fIfalse\fP, тогда заголовок авторизации всегда
|
|
|
+отправляется на сервер\&. Существует исключение: если имя пользователя и
|
|
|
+пароль являются встроенными в URI, то заголовок авторизации всегда
|
|
|
+отправляется на сервер, независимо от этого параметра\&. По умолчанию:
|
|
|
+\fIfalse\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-http\-no\-cache\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Посылать заголовок Cache\-Control: no\-cache и Pragma: no\-cache, чтобы
|
|
|
+избежать кэширования содержимого\&. Если задано \fIfalse\fP, то эти заголовки
|
|
|
+не посылаются и вы можете добавить любую директиву к заголовку Cache\-Control
|
|
|
+с помощью параметра \fB\-\-header\fP\&. По умолчанию: \fItrue\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-http\-user\fP=USER
|
|
|
+.RS 4
|
|
|
+Задать пользователя для HTTP\&. Влияет на все URI\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-http\-passwd\fP=PASSWD
|
|
|
+.RS 4
|
|
|
+Задать пароль для HTTP\&. Влияет на все URI\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-http\-proxy\fP=PROXY
|
|
|
+.RS 4
|
|
|
+Использовать указанный прокси\-сервер для HTTP\&. Ранее указанный адрес можно
|
|
|
+стереть, указав ""\&. Смотрите также параметр \fB\-\-all\-proxy\fP\&. Влияет на
|
|
|
+все URI\&. Формат PROXY \- [http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ]\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-http\-proxy\-passwd\fP=PASSWD
|
|
|
+.RS 4
|
|
|
+Задать пароль для параметра \fB\-\-http\-proxy\fP\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-http\-proxy\-user\fP=USER
|
|
|
+.RS 4
|
|
|
+Задать пользователя для параметра \fB\-\-http\-proxy\fP\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-https\-proxy\fP=PROXY
|
|
|
+.RS 4
|
|
|
+Использовать указанный прокси\-сервер для HTTPS\&. Ранее указанный адрес
|
|
|
+можно стереть, указав ""\&. Смотрите также параметр \fB\-\-all\-proxy\fP\&. Влияет
|
|
|
+на все URI\&. Формат PROXY \- [http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ]\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-https\-proxy\-passwd\fP=PASSWD
|
|
|
+.RS 4
|
|
|
+Задать пароль для параметра \fB\-\-https\-proxy\fP\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-https\-proxy\-user\fP=USER
|
|
|
+.RS 4
|
|
|
+Задать пользователя для параметра \fB\-\-https\-proxy\fP\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-private\-key\fP=FILE
|
|
|
+.RS 4
|
|
|
+Использовать закрытый ключ в FILE\&. Закрытый ключ должен быть дешифрованным
|
|
|
+и в PEM\-формате\&. Режим работы с исходно зашифрованным закрытым ключом не
|
|
|
+определен\&. Смотрите также параметр \fB\-\-certificate\fP\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-referer\fP=REFERER
|
|
|
+.RS 4
|
|
|
+Задать источника запроса\&. Влияет на все URI\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-enable\-http\-keep\-alive\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Включить HTTP/1\&.1 постоянное соединение\&. По умолчанию: \fItrue\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-enable\-http\-pipelining\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Включить конвейерную обработку HTTP/1\&.1\&. По умолчанию: \fIfalse\fP
|
|
|
+.RE
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+С точки зрения производительности, как правило, нет преимущества от
|
|
|
+включения этого параметра\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-header\fP=HEADER
|
|
|
+.RS 4
|
|
|
+Добавлять HEADER к HTTP запросу\-заголовку\&. Вы можете использовать этот
|
|
|
+параметр повторно, чтоб указать более одного заголовка: aria2c
|
|
|
+\fB\-\-header\fP="X\-A: b78" \fB\-\-header\fP="X\-B: 9J1" "http://host/file"
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-load\-cookies\fP=FILE
|
|
|
+.RS 4
|
|
|
+Загружать куки\-файл из FILE, используя форматы Firefox3 (SQLite3),
|
|
|
+Chromium/Google Chrome (SQLite3) и Mozilla/Firefox(1\&.x/2\&.x)/Netscape\&.
|
|
|
+.RE
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Если aria2 собрана без libsqlite3, то форматы куки\-файлов Firefox3 и
|
|
|
+Chromium/Google Chrome не поддерживаются\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-save\-cookies\fP=FILE
|
|
|
+.RS 4
|
|
|
+Сохранить куки в FILE формате Mozilla/Firefox(1\&.x/2\&.x)/Netscape\&. Если
|
|
|
+FILE уже существует, то он будет перезаписан\&. Куки\-сессия также сохранится
|
|
|
+и значение ее окончания будет трактоваться как 0\&. Возможные значения:
|
|
|
+\fI/путь/к/файлу\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-use\-head\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Использовать метод HEAD для первого запроса к HTTP серверу\&. По умолчанию:
|
|
|
+\fIfalse\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-U\fP, \fB\-\-user\-agent\fP=USER_AGENT
|
|
|
+.RS 4
|
|
|
+Задать клиентское приложение для HTTP(S) загрузок\&. По умолчанию:
|
|
|
+\fIaria2/$VERSION\fP, $VERSION заменяется на версию пакета\&.
|
|
|
+.RE
|
|
|
+.SS "Специфические параметры FTP"
|
|
|
+.PP
|
|
|
+\fB\-\-ftp\-user\fP=USER
|
|
|
+.RS 4
|
|
|
+Задать пользователя для FTP\&. Влияет на все URI\&. По умолчанию:
|
|
|
+\fIanonymous\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-ftp\-passwd\fP=PASSWD
|
|
|
+.RS 4
|
|
|
+Задать пароль для FTP\&. Влияет на все URI\&. Если имя пользователя
|
|
|
+встроено, но пароль отсутствует в URI, то aria2 пытается использовать пароль
|
|
|
+из \&.netrc\&. Если пароль найден в \&.netrc, то он используется\&. Если
|
|
|
+нет, используется пароль указанный в этом параметре\&. По умолчанию:
|
|
|
+\fIARIA2USER@\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-p\fP, \fB\-\-ftp\-pasv\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Использовать пассивный режим FTP\&. Если задано \fIfalse\fP, то будет
|
|
|
+использован активный режим\&. По умолчанию: \fItrue\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-ftp\-proxy\fP=PROXY
|
|
|
+.RS 4
|
|
|
+Использовать указанный прокси\-сервер для FTP\&. Ранее указанный адрес можно
|
|
|
+стереть, указав ""\&. Смотрите также параметр \fB\-\-all\-proxy\fP\&. Влияет на
|
|
|
+все URI\&. Формат PROXY \- [http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ]
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-ftp\-proxy\-passwd\fP=PASSWD
|
|
|
+.RS 4
|
|
|
+Задать пароль для параметра \fB\-\-ftp\-proxy\fP\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-ftp\-proxy\-user\fP=USER
|
|
|
+.RS 4
|
|
|
+Задать пользователя для параметра \fB\-\-ftp\-proxy\fP\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-ftp\-type\fP=TYPE
|
|
|
+.RS 4
|
|
|
+Задать тип передачи для FTP\&. TYPE может быть один из двух: \fIbinary\fP или
|
|
|
+\fIascii\fP\&. По умолчанию: \fIbinary\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-ftp\-reuse\-connection\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Повторно использовать FTP соединение\&. По умолчанию: \fItrue\fP
|
|
|
+.RE
|
|
|
+.SS "Параметры BitTorrent/Metalink"
|
|
|
+.PP
|
|
|
+\fB\-\-select\-file\fP=INDEX\&...
|
|
|
+.RS 4
|
|
|
+Задать файл для загрузки по заданному индексу\&. Вы можете найти индекс
|
|
|
+файла, используя параметр \fB\-\-show\-files\fP. Составной индекс можно указать,
|
|
|
+используя ",", например: \fI3,6\fP\&. Вы можете также использовать "\-", чтобы
|
|
|
+указать диапазон: \fI1\-5\fP\&. "," и "\-" могут быть использованы вместе:
|
|
|
+\fI1\-5,8,9\fP\&. Когда используется с параметром \fB\-M\fP, индекс может сильно
|
|
|
+зависеть от запроса (смотрите параметры \fB\-\-metalink\-\fP*)\&.
|
|
|
+.RE
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+В много файловом торренте, смежные файлы, указанные в этом параметре также
|
|
|
+могут быть загружены\&. Это не ошибка, а особенность утилиты\&. Одиночный
|
|
|
+блок данных может включать несколько файлов или часть файла, и aria2 запишет
|
|
|
+блок данных соответствующего файла\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-S\fP, \fB\-\-show\-files\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Вывести список файлов из \&.torrent, \&.meta4 или \&.metalink и выйти. Для
|
|
|
+файла \&.torrent будет выведена более детальная информация (информация по
|
|
|
+хэшу, размер блока и др.)\&.
|
|
|
+.RE
|
|
|
+.SS "Специфические параметры BitTorrent"
|
|
|
+.PP
|
|
|
+\fB\-\-bt\-enable\-lpd\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Включить поиск локальных пиров\&. Если в torrent\-файле установлен приватный
|
|
|
+признак, то aria2 не будет использовать эту возможность, даже если задано
|
|
|
+\fItrue\fP\&. По умолчанию: \fIfalse\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-bt\-exclude\-tracker\fP=URI[,\&...]
|
|
|
+.RS 4
|
|
|
+Разделенный запятыми список URI анонса BitTorrent\-трекера, которые будут
|
|
|
+исключены\&. Вы можете использовать специальное значение "*", которое
|
|
|
+соответствует всем URI, таким образом исключаются все URI анонса\&. При
|
|
|
+указании "*" в оболочке командной строке, не забывайте, экранировать или
|
|
|
+брать в кавычки. Смотрите также параметр \fB\-\-bt\-tracker\fP\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-bt\-external\-ip\fP=IPADDRESS
|
|
|
+.RS 4
|
|
|
+Указать внешний IP\-адрес BitTorrent\-трекера для отчета\&. Не смотря на то,
|
|
|
+что эта функция названа "external" ("внешний"), она может принимать любой
|
|
|
+IP\-адрес\&. IPADDRESS должен быть числовым IP\-адресом\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-bt\-hash\-check\-seed\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Если задано \fItrue\fP, то после проверки хэша с использованием параметра
|
|
|
+\fB\-\-check\-integrity\fP и когда файл загружен полностью, продолжается раздача
|
|
|
+файла\&. Если вы хотите проверить файл и загрузить его только если он
|
|
|
+поврежден или не загружен полностью, то задайте этот параметр как
|
|
|
+\fIfalse\fP\&. Этот параметр влияет лишь на BitTorrent загрузки\&. По
|
|
|
+умолчанию: \fItrue\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-bt\-lpd\-interface\fP=INTERFACE
|
|
|
+.RS 4
|
|
|
+Использовать для поиска локальных пиров заданный интерфейс. Если этот
|
|
|
+параметр не указан, используется интерфейс по умолчанию. Можно указать имя
|
|
|
+интерфейса и IP\-адрес. Возможные значения: интерфейс, IP\-адрес
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-bt\-max\-open\-files\fP=NUM
|
|
|
+.RS 4
|
|
|
+Указать максимальное количество файлов для открытия в каждой BitTorrent
|
|
|
+загрузке\&. По умолчанию: \fI100\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-bt\-max\-peers\fP=NUM
|
|
|
+.RS 4
|
|
|
+Указать максимальное количество узлов для каждого торрента\&. \fI0\fP означает
|
|
|
+неограниченно\&. Смотрите также параметр
|
|
|
+\fB\-\-bt\-request\-peer\-speed\-limit\fP\&. По умолчанию: \fI55\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-bt\-metadata\-only\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Загрузить только метаданные\&. Файл(ы), описывающий метаданные не должен
|
|
|
+быть загружен\&. Этот параметр эффективен только если используется
|
|
|
+BitTorrent Magnet\-ссылка\&. Смотрите также параметр
|
|
|
+\fB\-\-bt\-save\-metadata\fP\&. По умолчанию: \fIfalse\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-bt\-min\-crypto\-level\fP=\fIplain\fP|\fIarc4\fP
|
|
|
+.RS 4
|
|
|
+Задать минимальный уровень метода шифрования\&. Если узел поддерживает
|
|
|
+несколько методов шифрования, aria2 выбирает наименьший, который
|
|
|
+удовлетворяет заданный уровень\&. По умолчанию: \fIplain\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-bt\-prioritize\-piece\fP=\fIhead\fP[=SIZE],\fItail\fP[=SIZE]
|
|
|
+.RS 4
|
|
|
+Пытаться загрузить сначала первую и последнюю части каждого файла\&. Это
|
|
|
+бывает полезно для предварительного просмотра файлов\&. Аргумент может
|
|
|
+содержать 2 ключевых слова: \fIhead\fP и \fItail\fP\&. Для включения обоих,
|
|
|
+необходимо разделить их запятой\&. Ключевые слова принимают один параметр,
|
|
|
+SIZE\&. Например, если указано \fIhead\fP=SIZE, части, в пределах первых SIZE
|
|
|
+байт каждого файла, получат повышенный приоритет\&. \fItail\fP=SIZE обозначает
|
|
|
+диапазон из последних SIZE байт каждого файла\&. SIZE может включать букву
|
|
|
+\fIK\fP или \fIM\fP для обозначения размера в килобайтах или мегабайтах,
|
|
|
+соответственно (1K = 1024, 1M = 1024K)\&. Если SIZE пропущено, то будет
|
|
|
+использовано по умолчанию значение: SIZE=1M\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-bt\-require\-crypto\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Если задано \fItrue\fP, aria2 не принимает и не устанавливает соединение с
|
|
|
+унаследованныммм BitTorrent handshake\-сообщением (рукопожатие) (BitTorrent
|
|
|
+протокол). Таким образом aria2 всегда использует обфускацию
|
|
|
+handshake\-сообщения. По умолчанию: \fIfalse\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-bt\-request\-peer\-speed\-limit\fP=SPEED
|
|
|
+.RS 4
|
|
|
+Если итоговая скорость загрузки каждого торрента ниже чем SPEED, aria2
|
|
|
+временно увеличивает количество узлов, пытаясь увеличить скорость
|
|
|
+загрузки\&. Настройка этого параметра с выбранной вами скоростью загрузки
|
|
|
+может, в некоторых случаях, увеличить вашу скорость загрузки\&. Вы можете
|
|
|
+добавить \fIK\fP или \fIM\fP(1K = 1024, 1M = 1024K)\&. По умолчанию: \fI50K\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-bt\-save\-metadata\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Сохранить метаданные как файл \&.torrent\&. Этот параметр эффективен только
|
|
|
+если используется BitTorrent Magnet\-ссылка\&. Имя файла шестнадцатеричное
|
|
|
+представление хэша с расширением \&.torrent\&. Файл сохранится в каталог, в
|
|
|
+тот же самый, куда сохранится загружаемый файл\&. Если тот же самый файл уже
|
|
|
+существует, метаданные не сохранятся\&. Смотрите также параметр
|
|
|
+\fB\-\-bt\-metadata\-only\fP\&. По умолчанию: \fIfalse\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-bt\-seed\-unverified\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Раздавать первоначально загруженные файлы без проверки хэшей блоков\&. По
|
|
|
+умолчанию: \fIfalse\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-bt\-stop\-timeout\fP=SEC
|
|
|
+.RS 4
|
|
|
+Остановить BitTorrent загрузку, если скорость загрузки равна 0 на протяжении
|
|
|
+SEC секунд. Если задано \fI0\fP, то эта возможность не будет использоваться. По
|
|
|
+умолчанию: \fI0\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-bt\-tracker\fP=URI[,\&...]
|
|
|
+.RS 4
|
|
|
+Разделенный запятыми список дополнительных URI анонса
|
|
|
+BitTorrent\-трекеров\&. На эти URI не действует параметр
|
|
|
+\fB\-\-bt\-exclude\-tracker\fP, потому что они добавляются после URI, указанных в
|
|
|
+параметре \fB\-\-bt\-exclude\-tracker\fP, которые исключаются\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-bt\-tracker\-connect\-timeout\fP=SEC
|
|
|
+.RS 4
|
|
|
+Задать время ожидания в секундах для установки соединения с
|
|
|
+трекером\&. После установки соединения, это параметр станет не
|
|
|
+действительным, а вместо него будет использован
|
|
|
+\fB\-\-bt\-tracker\-timeout\fP\&. По умолчанию: \fI60\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-bt\-tracker\-interval\fP=SEC
|
|
|
+.RS 4
|
|
|
+Задать интервал в секундах между запросами трекера\&. Это полностью отменяет
|
|
|
+значение интервала и aria2 использует только это значение и игнорирует
|
|
|
+минимальный интервал и значение интервала в ответе трекера\&. Если задан
|
|
|
+\fI0\fP, aria2 определяет интервал основываясь на ответе трекера и прогрессе
|
|
|
+загрузки\&. По умолчанию: \fI0\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-bt\-tracker\-timeout\fP=SEC
|
|
|
+.RS 4
|
|
|
+Задать время ожидания в секундах\&. По умолчанию: \fI60\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-dht\-entry\-point\fP=HOST:PORT
|
|
|
+.RS 4
|
|
|
+Задать хост и порт, как точку входа в IPv4 DHT сеть\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-dht\-entry\-point6\fP=ХОСТ:ПОРТ
|
|
|
+.RS 4
|
|
|
+Задать хост и порт, как точку входа в IPv6 DHT сеть\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-dht\-file\-path\fP=PATH
|
|
|
+.RS 4
|
|
|
+Заменять файл таблицы маршрутизации IPv4 DHT на PATH\&. По умолчанию:
|
|
|
+\fI$HOME/\&.aria2/dht\&.dat\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-dht\-file\-path6\fP=PATH
|
|
|
+.RS 4
|
|
|
+Заменять файл таблицы маршрутизации IPv6 DHT на PATH\&. По умолчанию:
|
|
|
+\fI$HOME/\&.aria2/dht\&.dat\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-dht\-listen\-addr6\fP=ADDR
|
|
|
+.RS 4
|
|
|
+Указать адрес привязки сокета для IPv6 DHT\&. Он должен быть глобальным IPv6
|
|
|
+unicast\-адресом хоста\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-dht\-listen\-port\fP=PORT\&...
|
|
|
+.RS 4
|
|
|
+Задать прослушиваемый UDP\-порт для обоих IPv4 и IPv6 DHT\&. Несколько портов
|
|
|
+можно указать через ",", например: \fI6881,6885\fP\&. Вы так же можете
|
|
|
+использовать "\-" что бы указать диапазон: \fI6881\-6999\fP\&. "," и "\-" могут
|
|
|
+быть использованы вместе\&. По умолчанию: \fI6881\-6999\fP
|
|
|
+.RE
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Удостоверьтесь, что указанные порты открыты для входящего UDP\-трафика\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-dht\-message\-timeout\fP=SEC
|
|
|
+.RS 4
|
|
|
+Задать время ожидания в секундах\&. По умолчанию: \fI10\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-enable\-dht\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Включить IPv4 DHT функциональность\&. Если в torrent\-файле задан приватный
|
|
|
+признак, aria2 не будет использовать DHT для загрузки, даже если установлен
|
|
|
+\fItrue\fP\&. По умолчанию: \fItrue\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-enable\-dht6\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Включить IPv6 DHT функциональность\&. Если в torrent\-файле задан приватный
|
|
|
+признак, aria2 не будет использовать DHT для загрузки, даже если установлен
|
|
|
+\fItrue\fP\&. Используйте параметр \fB\-\-dht\-listen\-port\fP для указания
|
|
|
+прослушиваемого порта\&. Смотрите также параметр \fB\-\-dht\-listen\-addr6\fP\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-enable\-peer\-exchange\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Включить расширение BitTorrent\-протокола для обмена списками
|
|
|
+участников\&. Если в torrent\-файле задан приватный признак, то эта
|
|
|
+возможность будет отключена, даже если установлен \fItrue\fP\&. По умолчанию:
|
|
|
+\fItrue\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-follow\-torrent\fP=\fItrue\fP|\fIfalse\fP|\fImem\fP
|
|
|
+.RS 4
|
|
|
+Если указать \fItrue\fP или \fImem\fP, тогда загруженный файл, расширение которого
|
|
|
+\- "\&.torrent" или mime\-тип \- "application/x\-bittorrent", aria2 анализирует
|
|
|
+как torrent\-файл и загружает файлы указанные в нем\&. Если указано \fImem\fP,
|
|
|
+тогда torrent\-файл не записывается на диск, а содержится в памяти\&. Если
|
|
|
+указано \fIfalse\fP, действия, упомянутые выше не совершаются\&. По умолчанию:
|
|
|
+\fItrue\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-O\fP, \fB\-\-index\-out\fP=INDEX=PATH
|
|
|
+.RS 4
|
|
|
+Задать путь к файлу с индексом=INDEX\&. Вы можете найти индекс файла
|
|
|
+используя параметр \fB\-\-show\-files\fP\&. PATH является относительным путем к
|
|
|
+тому, который указан в параметре \fB\-\-dir\fP\&. Вы можете использовать этот
|
|
|
+параметр много раз\&. Используйте этот параметр, когда хотите указать имена
|
|
|
+выходных файлов для BitTorrent\-загрузок\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-listen\-port\fP=PORT\&...
|
|
|
+.RS 4
|
|
|
+Указать номер TCP\-порта для BitTorrent\-загрузок. Несколько портов можно
|
|
|
+указать используя ",", например: \fI6881,6885\fP\&. Вы также можете
|
|
|
+использовать "\-", чтоб указать диапазон: \fI6881\-6999\fP\&. "," и "\-" могут
|
|
|
+быть использованы вместе: \fI6881\-6889,6999\fP\&. По умолчанию: \fI6881\-6999\fP
|
|
|
+.RE
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Удостоверьтесь, что указанные порты открыты для входящего TCP\-трафика\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-max\-overall\-upload\-limit\fP=SPEED
|
|
|
+.RS 4
|
|
|
+Задать максимальную общую скорость отдачи в байтах/сек\&. \fI0\fP значит
|
|
|
+неограничено\&. Вы можете добавить \fIK\fP или \fIM\fP(1K = 1024, 1M =
|
|
|
+1024K)\&. Чтобы ограничить скорость отдачи для узла торрента, используйте
|
|
|
+параметр \fB\-\-max\-upload\-limit\fP\&. По умолчанию: \fI0\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-u\fP, \fB\-\-max\-upload\-limit\fP=SPEED
|
|
|
+.RS 4
|
|
|
+Задать максимальную скорость отдачи каждого узла торрента в
|
|
|
+байтах/сек\&. \fI0\fP значит неограниченно\&. Вы можете добавить \fIK\fP или
|
|
|
+\fIM\fP(1K = 1024, 1M = 1024K)\&. Чтобы ограничить общую скорость отдачи,
|
|
|
+используйте параметр \fB\-\-max\-overall\-upload\-limit\fP\&. По умолчанию: \fI0\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-peer\-id\-prefix\fP=PEER_ID_PREFIX
|
|
|
+.RS 4
|
|
|
+Указать префикс для ID узла\&. ID узла в BitTorrent имеет размер 20
|
|
|
+байт\&. Если будет указано более 20 байт, то только первые 20 будут
|
|
|
+использоваться, если будет указано меньше 20, то они будут дополнены
|
|
|
+случайными данными до 20 байт\&. По умолчанию: \fIaria2/$VERSION\fP, $VERSION
|
|
|
+заменяется на версию пакета\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-seed\-ratio\fP=RATIO
|
|
|
+.RS 4
|
|
|
+Указать рейтинг\&. Сидировать завершенные торренты, пока рейтинг не станет
|
|
|
+больше RATIO\&. Очень рекомендуется указать тут равный или больший
|
|
|
+\fI1\&.0\fP\&. Указать \fI0\&.0\fP, если вы планируете сидировать независимо от
|
|
|
+рейтинга\&. Если указан параметр \fB\-\-seed\-time\fP вместе с этим параметром,
|
|
|
+сидирование закончится тогда, когда хотя бы одно условие будет
|
|
|
+удовлетворено\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-seed\-time\fP=MINUTES
|
|
|
+.RS 4
|
|
|
+Указать время сидирования (раздачи) в минутах. Смотрите также параметр
|
|
|
+\fB\-\-seed\-ratio\fP\&.
|
|
|
+.RE
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Указаный \fB\-\-seed\-time\fP=\fI0\fP отключает сидирование после завершения
|
|
|
+загрузки\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-T\fP, \fB\-\-torrent\-file\fP=TORRENT\-ФАЙЛ
|
|
|
+.RS 4
|
|
|
+Путь к файлу \&.torrent\&. Вы не обязаны использовать этот параметр,
|
|
|
+т\&.к\&. файл \&.torrent можно указать без \fB\-T\fP\&.
|
|
|
+.RE
|
|
|
+.SS "Специфические параметры Metalink"
|
|
|
+.PP
|
|
|
+\fB\-\-follow\-metalink\fP=\fItrue\fP|\fIfalse\fP|\fImem\fP
|
|
|
+.RS 4
|
|
|
+Если указано \fItrue\fP или \fImem\fP и когда загруженный файл имеет расширение
|
|
|
+"\&.meta4" или "\&.metalink", или mime\-тип "application/metalink4+xml" или
|
|
|
+"application/metalink+xml", aria2 считает его metalink\-файлом и загружает
|
|
|
+упомянутые в нем файлы.\& Если указано \fImem\fP, то metalink\-файл не
|
|
|
+сохраняется на диск, а просто хранится в памяти\&. Если указано \fIfalse\fP, то
|
|
|
+вышеприведенная операция не производится\&. По умолчанию: \fItrue\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-metalink\-base\-uri\fP=URI
|
|
|
+.RS 4
|
|
|
+Указать основной URI для разрешения относительных URI в элементе
|
|
|
+metalink:url и metalink:metaurl в metalink\-файле, сохраненном на локальном
|
|
|
+диске\&. Если URI указывает на каталог, то URI должен заканчиваться на
|
|
|
+\fI/\fP\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-M\fP, \fB\-\-metalink\-file\fP=METALINK\-ФАЙЛ
|
|
|
+.RS 4
|
|
|
+Путь к файлу \&.meta4 и \&.metalink\&. Читает ввод из stdin, если в качестве
|
|
|
+имени файла указано \fI\-\fP\&. Вы не обязаны использовать этот параметр,
|
|
|
+т\&.к\&. файлы \&.metalink можно указать без \fB\-M\fP\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-C\fP, \fB\-\-metalink\-servers\fP=NUM_SERVERS
|
|
|
+.RS 4
|
|
|
+Количество серверов для одновременного подключения\&. Некоторые Metalink
|
|
|
+регулируют количество серверов для соединения\&. aria2 точно придерживается
|
|
|
+их\&. Это значит, что если Metalink определяет атрибут maxconnections ниже
|
|
|
+чем NUM_SERVERS, тогда aria2 использует значение атрибута maxconnections
|
|
|
+вместо NUM_SERVERS\&. Смотрите также параметры \fB\-s\fP и \fB\-j\fP\&. По
|
|
|
+умолчанию: \fI5\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-metalink\-language\fP=LANGUAGE
|
|
|
+.RS 4
|
|
|
+The language of the file to download\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-metalink\-location\fP=LOCATION[,\&...]
|
|
|
+.RS 4
|
|
|
+Местонахождение предпочитаемого сервера\&. Список, разделенный запятыми,
|
|
|
+допустимых местонахождений, например, \fIjp,us\fP\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-metalink\-os\fP=OS
|
|
|
+.RS 4
|
|
|
+Целевая операционная система файла для загрузки\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-metalink\-version\fP=VERSION
|
|
|
+.RS 4
|
|
|
+The version of the file to download\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-metalink\-preferred\-protocol\fP=PROTO
|
|
|
+.RS 4
|
|
|
+Указать предпочитаемый протокол\&. Возможные значения: \fIhttp\fP, \fIhttps\fP,
|
|
|
+\fIftp\fP и \fInone\fP\&. Указать \fInone\fP для отключения этой возможности\&. По
|
|
|
+умолчанию: \fInone\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-metalink\-enable\-unique\-protocol\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Если задано \fItrue\fP, а в metalink\-файле доступно несколько протоколов, то
|
|
|
+aria2 использует один из них\&. Используйте параметр
|
|
|
+\fB\-\-metalink\-preferred\-protocol\fP, чтобы указать предпочитаемый протокол\&.
|
|
|
+.RE
|
|
|
+.SS "Параметры RPC"
|
|
|
+.PP
|
|
|
+\fB\-\-enable\-rpc\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Включить JSON\-RPC/XML\-RPC сервер\&. Настоятельно рекомендуется указать имя
|
|
|
+пользователя и пароль, используя параметры \fB\-\-rpc\-user\fP и
|
|
|
+\fB\-\-rpc\-passwd\fP\&. Смотрите также параметр \fB\-\-rpc\-listen\-port\fP\&. По
|
|
|
+умолчанию: \fIfalse\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-rpc\-listen\-all\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Слушать входящие JSON\-RPC/XML\-RPC запросы на всех сетевых
|
|
|
+интерфейсах\&. Если указано \fIfalse\fP, слушать только на локальном петлевом
|
|
|
+интерфейсе (loopback)\&. По умолчанию: \fIfalse\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-rpc\-listen\-port\fP=PORT
|
|
|
+.RS 4
|
|
|
+Указать номер порта, для прослушивания JSON\-RPC/XML\-RPC
|
|
|
+сервером\&. Возможные значения: \fI1024\fP\-\fI65535\fP\&. По умолчанию: \fI6800\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-rpc\-max\-request\-size\fP=SIZE
|
|
|
+.RS 4
|
|
|
+Задать максимальный размер JSON\-RPC/XML\-RPC\-запроса\&. Если aria2 выявит
|
|
|
+запрос с размером большим, чем SIZE байт, тогда соединение будет
|
|
|
+отклонено\&. По умолчанию: \fI2M\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-rpc\-passwd\fP=PASSWD
|
|
|
+.RS 4
|
|
|
+Задать JSON\-RPC/XML\-RPC пароль\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-rpc\-user\fP=USER
|
|
|
+.RS 4
|
|
|
+Задать JSON\-RPC/XML\-RPC пользователя\&.
|
|
|
+.RE
|
|
|
+.SS "Дополнительные параметры"
|
|
|
+.PP
|
|
|
+\fB\-\-allow\-overwrite\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Повторно запустить загрузку с нуля, если соответствующий контрольный файл
|
|
|
+отсутствует\&. Смотрите также параметр \fB\-\-auto\-file\-renaming\fP\&. По
|
|
|
+умолчанию: \fIfalse\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-allow\-piece\-length\-change\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Если задано \fIfalse\fP, aria2 останавливает загрузку, когда длина блока
|
|
|
+отлична от той, которая находится в контрольном файле\&. Если задано
|
|
|
+\fItrue\fP, вы можете продолжать, однако некоторый прогресс загрузки будет
|
|
|
+потерян\&. По умолчанию: \fIfalse\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-always\-resume\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Всегда возобновлять загрузку\&. Если задано \fItrue\fP, aria2 всегда пытается
|
|
|
+возобновить загрузку и если это не возможно, останавливает ее\&. Если задано
|
|
|
+\fIfalse\fP, тогда для всех заданных URI не поддерживается возобновление
|
|
|
+загрузки, или aria2 столкнется с невозможностью возобновления загрузки URI
|
|
|
+\fIN\fP\-ое количество раз (значение \fIN\fP указывается в параметре
|
|
|
+\fB\-\-max\-resume\-failure\-tries\fP), то aria2 будет загружать файл с
|
|
|
+нуля\&. Смотрите параметр \fB\-\-max\-resume\-failure\-tries\fP\&. По умолчанию:
|
|
|
+\fItrue\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-async\-dns\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Включить асинхронный DNS\&. По умолчанию: \fItrue\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-async\-dns\-server\fP=IPADDRESS[,\&...]
|
|
|
+.RS 4
|
|
|
+Разделенный запятыми список адресов DNS\-серверов, которые используют
|
|
|
+асинхронный DNS\-преобразователь\&. Обычно асинхронный DNS\-преобразователь
|
|
|
+читает адреса DNS серверов из \fI/etc/resolv\&.conf\fP\&. Когда используется
|
|
|
+этот параметр, то используются DNS\-серверы указанные в параметре вместо
|
|
|
+указанных в \fI/etc/resolv\&.conf\fP\&. Вы можете указать оба IPv4 и IPv6
|
|
|
+адреса\&. Этот параметр полезен, когда в системе нет \fI/etc/resolv\&.conf\fP и
|
|
|
+у пользователя нет прав на его создание\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-auto\-file\-renaming\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Переименовать файл, если такой уже существует\&. Этот параметр работает
|
|
|
+только для HTTP(S)/FTP загрузок\&. К имени файла будет добавлена точка и
|
|
|
+число от 1 до 9999\&. По умолчанию: \fItrue\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-auto\-save\-interval\fP=SEC
|
|
|
+.RS 4
|
|
|
+Сохранять контрольный файл (*\&.aria2) каждые SEC секунд\&. Если задано
|
|
|
+\fI0\fP, тогда контрольный файл не сохраняется на протяжении загрузки\&. aria2
|
|
|
+сохраняет контрольный файл тогда, когда останавливается, не смотря на
|
|
|
+значение\&. Возможные значения: от \fI0\fP до \fI600\fP\&. По умолчанию: \fI60\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-conditional\-get\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Загружать файл только когда локальный файл старше чем удаленный\&. Эта
|
|
|
+функция работает только для HTTP(S)\-загрузок\&. Это не работает, если размер
|
|
|
+файла указан в Metalink\&. Это также игнорирует заголовок
|
|
|
+Content\-Disposition\&. Если контрольный файл существует, то этот параметр
|
|
|
+игнорируется\&. Эта функция использует заголовок If\-Modified\-Since, как
|
|
|
+условие для получения только нового файла\&. При получении времени
|
|
|
+модификации локального файла, используется указанное пользователем имя файла
|
|
|
+(см. параметр \fB\-\-out\fP) или часть имени файла в URI, если \fB\-\-out\fP не
|
|
|
+указан\&. Для перезаписи существующего файла необходим параметр
|
|
|
+\fB\-\-allow\-overwrite\fP\&. По умолчанию: \fIfalse\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-conf\-path\fP=PATH
|
|
|
+.RS 4
|
|
|
+Сменить путь к файлу конфигурации на PATH\&. По умолчанию:
|
|
|
+\fI$HOME/\&.aria2/aria2\&.conf\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-D\fP, \fB\-\-daemon\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Запустить как демон (фоновый процесс)\&. Текущий рабочий каталог будет
|
|
|
+заменен на \fI/\fP, а стандартный ввод, стандартный вывод, стандартный вывод
|
|
|
+ошибок будут перенаправлены на \fI/dev/null\fP\&. По умолчанию: \fIfalse\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-disable\-ipv6\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Отключить IPv6\&. Это полезно, если вы используете поврежденный DNS и хотите
|
|
|
+избежать ужасно медленного поиска AAAA\-записи\&. По умолчанию: \fIfalse\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-enable\-async\-dns6\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Включить IPv6 разрешение имен в асинхронном DNS\-преобразователе\&. Этот
|
|
|
+параметр будет игнорироваться, если \fB\-\-async\-dns\fP=\fIfalse\fP\&. По умолчанию:
|
|
|
+\fIfalse\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-enable\-direct\-io\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Включить прямое I/O (чтение/запись), которое уменьшает использование
|
|
|
+микропроцессора во время резервирования места для файла\&. Выключите, если
|
|
|
+произошла какая\-либо ошибка\&. По умолчанию: \fItrue\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-event\-poll\fP=POLL
|
|
|
+.RS 4
|
|
|
+Указать метод опроса событий\&. Возможные значения: \fIepoll\fP, \fIkqueue\fP,
|
|
|
+\fIport\fP, \fIpoll\fP и \fIselect\fP\&. Каждый метод \fIepoll\fP, \fIkqueue\fP, \fIport\fP и
|
|
|
+\fIpoll\fP доступен, если система поддерживает его\&. \fIepoll\fP доступен в
|
|
|
+современных дистрибутивах Linux\&. \fIkqueue\fP доступен в различных *BSD
|
|
|
+системах, включая Mac OS X\&. \fIport\fP доступен в Open Solaris\&. Значение
|
|
|
+по умолчанию может изменяться в зависимости от системы, которую вы
|
|
|
+используете\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-file\-allocation\fP=METHOD
|
|
|
+.RS 4
|
|
|
+Указать метод резервирования места для файла\&. \fInone\fP не происходит
|
|
|
+предварительное резервирование места для файла\&. \fIprealloc\fP \-
|
|
|
+предварительное резервирование места для файла перед началом загрузки\&. Это
|
|
|
+может продолжаться некоторое время, в зависимости от размера файла\&. Если
|
|
|
+вы используете новые файловые системы, наподобие ext4 (с поддержкой
|
|
|
+экстентов), btrfs или xfs, тогда лучше выбрать \fIfalloc\fP\&. Так как они
|
|
|
+резервируют место под большие (на несколько Гигабайт) файлы почти
|
|
|
+мгновенно\&. Не используйте \fIfalloc\fP вместе с наследными файловыми
|
|
|
+системами, такими как ext3 потому, что это будет продолжаться почти столько
|
|
|
+же времени, как и \fIprealloc\fP, а также полностью заблокирует aria2, пока не
|
|
|
+окончится резервирование места\&. \fIfalloc\fP может быть недоступным, если
|
|
|
+ваша система не содержит функцию \fBposix_fallocate\fP()\&. Возможные значения:
|
|
|
+\fInone\fP, \fIprealloc\fP, \fIfalloc\fP\&. По умолчанию: \fIprealloc\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-human\-readable\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Выводить на консоль размеры и скорость в удобочитаемом формате (например,
|
|
|
+1\&.2Ки, 3\&.4Ми)\&. По умолчанию: \fItrue\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-interface\fP=INTERFACE
|
|
|
+.RS 4
|
|
|
+Привязать сокеты к заданному интерфейсу\&. Вы можете указать имя интерфейса,
|
|
|
+IP\-адрес и имя хоста\&. Возможные значения: имя интерфейса (например, eth0),
|
|
|
+IP\-адрес (например, 192.168.0.12), имя хоста (например, myhost)
|
|
|
+.RE
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Если интерфейс имеет несколько адресов, то настоятельно рекомендуется
|
|
|
+указать IP\-адрес явно\&. Смотрите также \fB\-\-disable\-ipv6\fP\&. Если ваша
|
|
|
+система не имеет getifaddrs(), это параметр не принимает имя интерфейса\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-max\-download\-result\fP=NUM
|
|
|
+.RS 4
|
|
|
+Задать максимальное количество результатов загрузок, которые находятся в
|
|
|
+памяти\&. Результаты загрузок \- завершенные/ошибка/удаленные
|
|
|
+загрузки\&. Результаты загрузок хранятся FIFO очереди, в которой может
|
|
|
+хранится NUM результатов загрузок\&. Когда очередь заполнена и появляется
|
|
|
+новый результат загрузки, то старейший результат загрузки удаляется из
|
|
|
+начала очереди, а новый добавляется в конец\&. Указание большого числа в
|
|
|
+этом параметре может привести к высокому потреблению памяти после тысяч
|
|
|
+загрузок\&. Значение 0 отключит сохранение результата загрузки\&. По
|
|
|
+умолчанию: \fI1000\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-max\-resume\-failure\-tries\fP=N
|
|
|
+.RS 4
|
|
|
+Если параметр \fB\-\-always\-resume\fP=\fIfalse\fP, aria2 загрузит файл с нуля, при
|
|
|
+обнаружении \fIN\fP\-го URI, не поддерживающего возобновление\&. Если \fIN\fP=\fI0\fP,
|
|
|
+то aria2 загрузит файл с нуля, когда все URI не поддерживают
|
|
|
+возобновление\&. Смотрите параметр \fB\-\-always\-resume\fP\&. По умолчанию: \fI0\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-log\-level\fP=LEVEL
|
|
|
+.RS 4
|
|
|
+Задать уровень вывода журнала событий\&. LEVEL может быть: \fIdebug\fP,
|
|
|
+\fIinfo\fP, \fInotice\fP, \fIwarn\fP или \fIerror\fP\&. По умолчанию: \fIdebug\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-on\-bt\-download\-complete\fP=COMMAND
|
|
|
+.RS 4
|
|
|
+Для BitTorrent, в \fB\-\-on\-download\-complete\fP указывается команда, которая
|
|
|
+вызывается после завершение загрузки и окончания сидирования\&. С другой
|
|
|
+стороны, этот параметр определяет команду, которая будет выполнена после
|
|
|
+завершения загрузки, но до сидирования\&. Смотрите раздел \fBПерехват
|
|
|
+сообщения\fP для более подробной информации о COMMAND\&. Возможные значения:
|
|
|
+\fI/путь/к/команде\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-on\-download\-complete\fP=COMMAND
|
|
|
+.RS 4
|
|
|
+Задать команду, которая будет выполнена после завершения
|
|
|
+загрузки\&. Смотрите раздел \fBПерехват сообщения\fP для более подробной
|
|
|
+информации о COMMAND\&. Смотрите также параметр
|
|
|
+\fB\-\-on\-download\-stop\fP\&. Возможные значения: \fI/путь/к/команде\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-on\-download\-error\fP=COMMAND
|
|
|
+.RS 4
|
|
|
+Задать команду, которая будет выполнена после того, как загрузка будет
|
|
|
+прервана из\-за ошибки\&. Смотрите раздел \fBПерехват сообщения\fP для более
|
|
|
+подробной информации о COMMAND\&. Смотрите также параметр
|
|
|
+\fB\-\-on\-download\-stop\fP\&. Возможные значения: \fI/путь/к/команде\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-on\-download\-pause\fP=COMMAND
|
|
|
+.RS 4
|
|
|
+Задать команду, которая будет выполнена после того, как загрузка будет
|
|
|
+приостановлена\&. Смотрите раздел \fBПерехват сообщения\fP для более подробной
|
|
|
+информации о COMMAND\&. Возможные значения: \fI/путь/к/команде\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-on\-download\-start\fP=COMMAND
|
|
|
+.RS 4
|
|
|
+Задать команду, которая будет выполнена после того, как началась
|
|
|
+загрузка\&. Смотрите раздел \fBПерехват сообщения\fP для более подробной
|
|
|
+информации о COMMAND\&. Возможные значения: \fI/путь/к/команде\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-on\-download\-stop\fP=COMMAND
|
|
|
+.RS 4
|
|
|
+Задать команду, которая будет выполнена после того, как загрузка
|
|
|
+остановлена\&. Вы можете изменить команду, которая будет выполнятся при
|
|
|
+определенном результате загрузки, используя параметры
|
|
|
+\fB\-\-on\-download\-complete\fP и \fB\-\-on\-download\-error\fP\&. Если они указаны, то
|
|
|
+команда определенная в этом параметре не будет выполнятся\&. Смотрите раздел
|
|
|
+\fBПерехват сообщения\fP для более подробной информации о COMMAND\&. Возможные
|
|
|
+значения: \fI/путь/к/команде\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-show\-console\-readout\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Показывать консольный вывод\&. По умолчанию: \fItrue\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-summary\-interval\fP=SEC
|
|
|
+.RS 4
|
|
|
+Задать интервал в секундах до вывода сообщения о прогрессе
|
|
|
+загрузки\&. Установка \fI0\fP запрещает вывод\&. По умолчанию: \fI60\fP
|
|
|
+.RE
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+В загрузках много файлового торрента, по определенным смежным файлам также,
|
|
|
+которые размещены в части одного блока\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-Z\fP, \fB\-\-force\-sequential\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Получить URI в последовательности командной строки и загрузить каждое URI в
|
|
|
+отдельной сессии, как в обычных утилитах загрузки командной строки\&. По
|
|
|
+умолчанию: \fIfalse\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-max\-overall\-download\-limit\fP=SPEED
|
|
|
+.RS 4
|
|
|
+Задать максимальную общую скорость загрузки в байтах/сек\&. \fI0\fP значит
|
|
|
+неограничено\&. Вы можете добавить \fIK\fP или \fIM\fP(1K = 1024, 1M =
|
|
|
+1024K)\&. Чтобы ограничить скорость загрузки для узла, используйте параметр
|
|
|
+\fB\-\-max\-download\-limit\fP\&. По умолчанию: \fI0\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-max\-download\-limit\fP=SPEED
|
|
|
+.RS 4
|
|
|
+Установить максимальную скорость каждого узла загрузки в байтах/сек\&. \fI0\fP
|
|
|
+значит неограниченно. Вы можете добавить \fIK\fP или \fIM\fP(1K = 1024, 1M =
|
|
|
+1024K)\&. Чтобы ограничить общую скорость загрузки, используйте параметр
|
|
|
+\fB\-\-max\-overall\-download\-limit\fP\&. По умолчанию: \fI0\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-no\-conf\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Отключить загрузку файла aria2\&.conf\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-no\-file\-allocation\-limit\fP=SIZE
|
|
|
+.RS 4
|
|
|
+Не резервируется место для файлов, размер которых меньше SIZE. Вы можете
|
|
|
+добавить \fIK\fP или \fIM\fP(1K = 1024, 1M = 1024K)\&. По умолчанию: \fI5M\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-P\fP, \fB\-\-parameterized\-uri\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Включить поддержку параметризованных URI\&. Вы можете указать набор частей:
|
|
|
+\fIhttp://{sv1,sv2,sv3}/foo\&.iso\fP\&. Также вы можете указать числовую
|
|
|
+последовательность с шагом счетчика:
|
|
|
+\fIhttp://host/image[000\-100:2]\&.img\fP\&. Шагом счетчика можно
|
|
|
+пренебречь\&. Если все URI не указывают на такой же файл, как во втором
|
|
|
+приведенном выше примере, то необходим параметр \fB\-Z\fP. По умолчанию:
|
|
|
+\fIfalse\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-q\fP, \fB\-\-quiet\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Сделать aria2 молчаливой (без консольного вывода)\&. По умолчанию: \fIfalse\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-realtime\-chunk\-checksum\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Подтверждать правильность блока данных путем вычисления контрольной суммы во
|
|
|
+время загрузки файла, если предусмотрена контрольная сумма блоков\&. По
|
|
|
+умолчанию: \fItrue\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-remove\-control\-file\fP[=\fItrue\fP|\fIfalse\fP]
|
|
|
+.RS 4
|
|
|
+Удалять контрольный файл перед загрузкой\&. При использовании с
|
|
|
+\fB\-\-allow\-overwrite\fP=\fItrue\fP файл всегда загружается с нуля\&. Это может
|
|
|
+понадобиться пользователям за прокси\-сервером, не поддерживающим
|
|
|
+возобновление загрузки\&.
|
|
|
+.RE
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Для Metalink\-загрузок, \-C1 рекомендуется для прокси\-серверов, не
|
|
|
+поддерживающих возобновление загрузки, во избежании создания лишних
|
|
|
+соединений\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-save\-session\fP=FILE
|
|
|
+.RS 4
|
|
|
+Сохранять ошибочные/незаконченные загрузки в FILE при выходе\&. Вы можете
|
|
|
+передать этот выходной файл aria2c с параметром \fB\-i\fP при
|
|
|
+перезапуске\&. Обратите внимание, что загрузки добавленные через RPC\-методы
|
|
|
+\fBaria2\&.addTorrent\fP, \fBaria2\&.addMetalink\fP и чьи метаданные не могут быть
|
|
|
+сохранены как файл, не будут сохраняться\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-\-stop\fP=SEC
|
|
|
+.RS 4
|
|
|
+Останавливать программу после того как пройдет SEC секунд\&. Если задано
|
|
|
+\fI0\fP, эта возможность будет отключена\&. По умолчанию: \fI0\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB\-v\fP, \fB\-\-version\fP
|
|
|
+.RS 4
|
|
|
+Вывести номер версии, информацию об авторских правах, конфигурации и
|
|
|
+выйти\&.
|
|
|
+.RE
|
|
|
+.SS "Параметры, которые принимают аргументы"
|
|
|
+.sp
|
|
|
+Параметры, которые имеют значения в квадратных скобках ([]), могут принимать
|
|
|
+дополнительные (необязательные) аргументы\&. Обычно отсутствие аргумента
|
|
|
+эквивалентно \fItrue\fP\&. Если вы используется короткую форму параметров
|
|
|
+(например, \fI\-V\fP) и указываете аргумент, то имя параметра и его аргумент
|
|
|
+должны быть объедены (например, \fI\-Vfalse\fP)\&. Если будут вставлены пробелы
|
|
|
+между именем параметра и аргументом, то аргумент будет обрабатываться как
|
|
|
+URI, и это не то, что обычно вы ожидаете\&.
|
|
|
+.SS "URI, MAGNET\-ССЫЛКА, TORRENT\-ФАЙЛ, METALINK\-ФАЙЛ"
|
|
|
+.sp
|
|
|
+Вы можете перечислить несколько URI в командной строке\&. Пока вы не указали
|
|
|
+параметр \fB\-Z\fP, все URI должны указывать на один и тот же файл или загрузка
|
|
|
+завершиться не удачно\&.
|
|
|
+.sp
|
|
|
+Вы можете указать произвольное количество BitTorrent Magnet URI\&. Обратите
|
|
|
+внимание, что они всегда будут обрабатываться как отдельная
|
|
|
+загрузка\&. Поддерживаются оба Info Hash (Информация о хэше), как
|
|
|
+закодированный 40 шестнадцатеричными символами, так и закодированный 32
|
|
|
+символами Base32\-кодировки\&. Поддерживаются составные параметры
|
|
|
+"tr"\&. Т.к. в BitTorrent Magnet URI возможно присутствие символа "&", то
|
|
|
+настоятельно рекомендуется всегда заключать URI в одиночные(\*(Aq) или
|
|
|
+двойные(") кавычки\&. Так же настоятельно рекомендуется включить DHT,
|
|
|
+особенно когда параметр "tr" не указан\&. Смотрите
|
|
|
+http://www\&.bittorrent\&.org/beps/bep_0009\&.html для детальной информации
|
|
|
+по BitTorrent Magnet URI\&.
|
|
|
+.sp
|
|
|
+Вы также можете указать произвольное количество torrent\-файлов и
|
|
|
+Metalink\-документов, которые хранятся на локальном диске\&. Обратите
|
|
|
+внимание, что они всегда будут обрабатываться как отдельная
|
|
|
+загрузка\&. Поддерживаются оба формата: Metalink4 и Metalink версии 3\&.0\&.
|
|
|
+.sp
|
|
|
+Вы можете указать вместе, torrent\-файл c параметром \fB\-T\fP и URI\&. Сделав
|
|
|
+это, вы можете загружать файл используя torrent\-рой и HTTP(S)/FTP\-сервер
|
|
|
+одновременно, пока данные из HTTP(S)/FTP выгружаются в torrent\-рой\&. Для
|
|
|
+одно файловых торрентов, URI может быть завершенным, который указывает на
|
|
|
+ресурс, или же если заканчиваться символом /, тогда name (имя) в
|
|
|
+torrent\-файле будет добавлено\&. Для много файловых торентов, name (имя) и
|
|
|
+path (путь) в torrent\-файле будут добавлены из URI для каждого файла\&.
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Удостоверьтесь, что URI заключен в одинарные(\*(Aq) или двойные(") кавычки,
|
|
|
+если есть символ "&" или любые символы, которые имеют особое значение в
|
|
|
+командной оболочке\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.SS "Возобновление загрузки"
|
|
|
+.sp
|
|
|
+Обычно, вы можете возобновить передачу, только давая ту же самую команду
|
|
|
+(aria2c URI), которая выполнялась при предыдущей передаче, созданной
|
|
|
+aria2\&.
|
|
|
+.sp
|
|
|
+Если предыдущая передача создана веб\-браузером или wget\-подобным менеджером
|
|
|
+загрузки, тогда используйте параметр \fB\-c\fP для продолжения передачи (aria2c
|
|
|
+\fB\-c\fP URI)\&.
|
|
|
+.SS "Перехват сообщения"
|
|
|
+.sp
|
|
|
+aria2 предоставляет параметры, в которых указываются произвольные команды,
|
|
|
+выполняемые после наступления определенного события\&. В настоящие время
|
|
|
+доступны следующие параметры: \fB\-\-on\-bt\-download\-complete\fP,
|
|
|
+\fB\-\-on\-download\-pause\fP, \fB\-\-on\-download\-complete\fP\&. \fB\-\-on\-download\-start\fP,
|
|
|
+\fB\-\-on\-download\-error\fP, \fB\-\-on\-download\-stop\fP\&.
|
|
|
+.sp
|
|
|
+aria2 передает 3 аргумента указанной команды, которая выполняется\&. Это
|
|
|
+аргументы: GID, количество файлов и путь к файлу\&. Для HTTP\-, FTP\-загрузок,
|
|
|
+обычно количество файлов \- 1\&. BitTorrent загрузка может содержать
|
|
|
+множество файлов\&. Если число файлов больше чем один, то путь к файлу будет
|
|
|
+для первого\&. Другими словами, это значение параметра path в первой
|
|
|
+структуре, определенный параметр которой имеет значение true (истина), в
|
|
|
+ответе RPC\-метода \fBaria2\&.getFiles\fP\&. Если вы хотите получить все пути к
|
|
|
+файлам, то рассмотрите использование JSON\-RPC/XML\-RPC\&. Обратите внимание,
|
|
|
+что путь к файлу может меняться в процессе загрузки по HTTP из\-за
|
|
|
+перенаправления или заголовка Content\-Disposition\&.
|
|
|
+.sp
|
|
|
+Посмотрите пример, как аргументы передаются команде\&.
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+$ cat hook\&.sh
|
|
|
+#!/bin/sh
|
|
|
+echo "Called with [$1] [$2] [$3]"
|
|
|
+$ aria2c \-\-on\-download\-complete hook\&.sh http://example\&.org/file\&.iso
|
|
|
+Called with [1] [1] [/path/to/file\&.iso]
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.SH "КОДЫ ЗАВЕРШЕНИЯ"
|
|
|
+.sp
|
|
|
+Поскольку aria2 может обрабатывать несколько загрузок одновременно, она
|
|
|
+сталкивается с множеством ошибок в сессии\&. aria2 возвращает следующий код
|
|
|
+завершения, основанный на последней встретившейся ошибке\&.
|
|
|
+.PP
|
|
|
+\fB0\fP
|
|
|
+.RS 4
|
|
|
+Если все загрузки завершились успешно\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB1\fP
|
|
|
+.RS 4
|
|
|
+Если произошла неизвестная ошибка\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB2\fP
|
|
|
+.RS 4
|
|
|
+Если время истекло\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB3\fP
|
|
|
+.RS 4
|
|
|
+Если ресурс не был найден\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB4\fP
|
|
|
+.RS 4
|
|
|
+Если aria2 получила определенное число ошибок "ресурс не найден"\&. Смотрите
|
|
|
+параметр \fB\-\-max\-file\-not\-found\fP\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB5\fP
|
|
|
+.RS 4
|
|
|
+Если загрузка прервана, поскольку скорость загрузки была слишком
|
|
|
+медленной\&. Смотрите параметр \fB\-\-lowest\-speed\-limit\fP
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB6\fP
|
|
|
+.RS 4
|
|
|
+Если произошла проблема с сетью\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB7\fP
|
|
|
+.RS 4
|
|
|
+Если были не завершенные загрузки\&. Эта ошибка только появляется только
|
|
|
+если все завершенные загрузки были успешны и были не завершенные загрузки в
|
|
|
+очереди, когда aria2 завершилась по нажатию Ctrl\-C пользователем или при
|
|
|
+отправке сигнала TERM или INT\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB8\fP
|
|
|
+.RS 4
|
|
|
+Если удаленный сервер не поддерживает возобновление, когда оно было указано
|
|
|
+как обязательное для завершения загрузки\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB9\fP
|
|
|
+.RS 4
|
|
|
+Если было не достаточно доступного места на диске\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB10\fP
|
|
|
+.RS 4
|
|
|
+Если размер блока был отличным от указанного контрольном файле
|
|
|
+\&.aria2\&. Смотрите параметр \fB\-\-allow\-piece\-length\-change\fP\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB11\fP
|
|
|
+.RS 4
|
|
|
+Если aria2 был загружен один и тот же файл в тот момент\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB12\fP
|
|
|
+.RS 4
|
|
|
+Если aria2 загрузила торрент с одним и тем же хэшем в этот момент\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB13\fP
|
|
|
+.RS 4
|
|
|
+Если файл уже существует\&. Смотрите параметр \fB\-\-allow\-overwrite\fP\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB14\fP
|
|
|
+.RS 4
|
|
|
+Если не удалось переименование\&. Смотрите параметр
|
|
|
+\fB\-\-auto\-file\-renaming\fP\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB15\fP
|
|
|
+.RS 4
|
|
|
+Если aria2 не смогла открыть существующий файл\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB16\fP
|
|
|
+.RS 4
|
|
|
+Если aria2 не смогла создать новый файл или обрезать существующий файл\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB17\fP
|
|
|
+.RS 4
|
|
|
+Если произошла ошибка чтения/записи файла\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB18\fP
|
|
|
+.RS 4
|
|
|
+Если aria2 не смогла создать каталог\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB19\fP
|
|
|
+.RS 4
|
|
|
+Если не удалось разрешение имен (DNS)\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB20\fP
|
|
|
+.RS 4
|
|
|
+Если aria2 не смогла проанализировать Metalink\-документ\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB21\fP
|
|
|
+.RS 4
|
|
|
+Если FTP\-команда не удалась\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB22\fP
|
|
|
+.RS 4
|
|
|
+Если HTTP\-заголовок ответа был испорчен или неожиданым\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB23\fP
|
|
|
+.RS 4
|
|
|
+Если произошло слишком много перенаправлений\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB24\fP
|
|
|
+.RS 4
|
|
|
+Если HTTP\-авторизация не удалась\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB25\fP
|
|
|
+.RS 4
|
|
|
+Если aria2 не смогла проанализировать закодированный файл (обычно
|
|
|
+\&.torrent\-файл)\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB26\fP
|
|
|
+.RS 4
|
|
|
+Если файл \&.torrent был испорчен или потерена информация, которая
|
|
|
+необходима aria2\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB27\fP
|
|
|
+.RS 4
|
|
|
+Если Magnet\-ссылка была плохой\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB28\fP
|
|
|
+.RS 4
|
|
|
+Если был задан плохой/неопознанный параметр или неожиданный аргумент к
|
|
|
+нему\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB29\fP
|
|
|
+.RS 4
|
|
|
+Если удаленный сервер не смог обработать запрос из\-за временной перегрузки
|
|
|
+или регламентных работ\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+\fB30\fP
|
|
|
+.RS 4
|
|
|
+Если aria2 не смогла проанализировать JSON\-RPC\-запрос\&.
|
|
|
+.RE
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Ошибка, произошедшая в завершенной загрузке, не будет передана как код
|
|
|
+завершения\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.SH ОКРУЖЕНИЕ
|
|
|
+.sp
|
|
|
+aria2 распознает следующие переменные окружения\&.
|
|
|
+.PP
|
|
|
+http_proxy [http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ]
|
|
|
+.RS 4
|
|
|
+Указать прокси\-сервер для использования в HTTP\&. Заменяет значение
|
|
|
+http\-proxy в конфигурационном файле\&. Параметр \fB\-\-http\-proxy\fP в командной
|
|
|
+строке заменяет эту переменную\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+https_proxy [http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ]
|
|
|
+.RS 4
|
|
|
+Указать прокси\-сервер для использования в HTTPS\&. Заменяет значение
|
|
|
+https\-proxy в конфигурационном файле\&. Параметр \fB\-\-https\-proxy\fP в
|
|
|
+командной строке заменяет эту переменную\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+ftp_proxy [http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ]
|
|
|
+.RS 4
|
|
|
+Указать прокси\-сервер для использования в FTP\&. Заменяет значение ftp\-proxy
|
|
|
+в конфигурационном файле\&. Параметр \fB\-\-ftp\-proxy\fP в командной строке
|
|
|
+заменяет эту переменную\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+all_proxy [http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ]
|
|
|
+.RS 4
|
|
|
+Указать прокси\-сервер для использования если не указан контретный протокол
|
|
|
+для прокси\&. Заменяет значение all\-proxy в конфигурационном
|
|
|
+файле\&. Параметр \fB\-\-all\-proxy\fP в командной строке заменяет эту
|
|
|
+переменную\&.
|
|
|
+.RE
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Не смотря на то, что aria2 допускает ftp:// и https:// схемы прокси в URI,
|
|
|
+она просто предполагает, что определен http:// и не меняет своего поведения,
|
|
|
+основанного на определенной схеме\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+no_proxy [ДОМЕН,\&...]
|
|
|
+.RS 4
|
|
|
+Указать, разделенные запятыми, имена хостов, доменов и сетевых адресов с
|
|
|
+CIDR\-блоком, или без него, для которых прокси использоваться не
|
|
|
+будет\&. Заменяет значение no\-proxy в конфигурационном файле\&. Параметр
|
|
|
+\fB\-\-no\-proxy\fP в командной строке заменяет эту переменную\&.
|
|
|
+.RE
|
|
|
+.SH ФАЙЛЫ
|
|
|
+.SS aria2\&.conf
|
|
|
+.sp
|
|
|
+По умолчанию, aria2 анализирует \fI$HOME/\&.aria2/aria2\&.conf\fP как
|
|
|
+конфигурационный файл\&. Вы можете указать путь к конфигурационному файлу в
|
|
|
+параметре \fB\-\-conf\-path\fP\&. Если вы не хотите использовать конфигурационный
|
|
|
+файл, используйте параметр \fB\-\-no\-conf\fP\&.
|
|
|
+.sp
|
|
|
+Конфигурационный файл \- это текстовый файл, содержащий один параметр в
|
|
|
+строке\&. В каждой строке, вы можете указать пары имя\-значение в формате:
|
|
|
+ИМЯ=ЗНАЧЕНИЕ, где имя \- это длинный параметр командной строки, без префикса
|
|
|
+"\-\-"\&. Вы можете использовать тот же синтаксис, что и для параметра
|
|
|
+командной строки\&. Строки начинающиеся с "#" рассматриваются как
|
|
|
+комментарии\&.
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+# пример конфигурационного файла для aria2c
|
|
|
+listen\-port=60000
|
|
|
+dht\-listen\-port=60000
|
|
|
+seed\-ratio=1\&.0
|
|
|
+max\-upload\-limit=50K
|
|
|
+ftp\-pasv=true
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.SS dht\&.dat
|
|
|
+.sp
|
|
|
+По умолчанию, таблица маршрутизации IPv4 DHT хранится в
|
|
|
+\fI$HOME/\&.aria2/dht\&.dat\fP, а таблица маршрутизации IPv6 DHT хранится в
|
|
|
+\fI$HOME/\&.aria2/dht6\&.dat\fP\&.
|
|
|
+.SS Netrc
|
|
|
+.sp
|
|
|
+Поддержка Netrc включена по умолчанию для HTTP(S)/FTP\&. Для отключения
|
|
|
+поддержки netrc, укажите параметр \fB\-n\fP\&. Ваш файл \&.netrc должен иметь
|
|
|
+соответствующие права (600)\&.
|
|
|
+.sp
|
|
|
+Если имя машины (machine) начинается с "\&.", то aria2 представляет это как
|
|
|
+соответствие домену вместо точного соответствия\&. Это расширение
|
|
|
+aria2\&. Пример соответствия домену, представляет следующие содержимое
|
|
|
+\&.netrc:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+machine \&.example\&.org login myid password mypasswd
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+При соответствии домену, aria2\&.example\&.org будет соответствовать
|
|
|
+\&.example\&.org и будет использованы myid и mypasswd\&. example\&.org также
|
|
|
+соответствует \&.example\&.org\&. Но example\&.net не будет соответствовать
|
|
|
+\&.example\&.org\&.
|
|
|
+.SS "Контрольный файл"
|
|
|
+.sp
|
|
|
+aria2 использует контрольный файл для отслеживания прогресса
|
|
|
+загрузки\&. Контрольный файл размещается в том же каталоге, что и
|
|
|
+загружаемый файл, и имеет имя, как у загружаемого файла с добавлением
|
|
|
+"\&.aria2"\&. Например, если file\&.zip загружаемый файл, тогда контрольный
|
|
|
+файл будет file\&.zip\&.aria2\&. (Существует исключение для этого
|
|
|
+именования\&. При загрузке торрента с множеством файлов, контрольный файл
|
|
|
+будет в "корневом каталоге" с именем торрента и добавлением
|
|
|
+"\&.aria2"\&. Имя "корневого каталога" \- значение ключа "name" в "info"
|
|
|
+внутри torrent\-файла\&.)
|
|
|
+.sp
|
|
|
+Обычно контрольный файл удаляется после завершения загрузки\&. Если aria2
|
|
|
+решает, что загрузка не может быть возобновлена (например, когда загружается
|
|
|
+файл с HTTP\-сервера, который не поддерживает возобновление), контрольный
|
|
|
+файл не создается\&.
|
|
|
+.sp
|
|
|
+Обычно, если вы потеряете контрольный файл, вы не сможете возобновить
|
|
|
+загрузку\&. Но если у вас есть torrent или metalink файлы с контрольными
|
|
|
+суммами блоков данных, вы сможете возобновить загрузку без контрольного
|
|
|
+файла, указав параметр \fB\-V\fP в командной строке aria2c\&.
|
|
|
+.SS "Входной файл"
|
|
|
+.sp
|
|
|
+Входной файл может содержать список URI для загрузки aria2\&. Вы можете
|
|
|
+указать несколько URI для одного объекта, разделяя URI, в одной строке,
|
|
|
+табуляцией\&.
|
|
|
+.sp
|
|
|
+Каждая строка рассматривается, как аргумент командой строки\&. Следовательно
|
|
|
+на них влияют параметры \fB\-Z\fP и \fB\-P\fP \&.
|
|
|
+.sp
|
|
|
+Строка, которая начинается с "#" обрабатывается как комментарий и
|
|
|
+пропускается\&.
|
|
|
+.sp
|
|
|
+Кроме того, следующие параметры могут быть определены после каждой строки с
|
|
|
+URI\&. Эти дополнительные строки должны начинаться с пробела(ов)\&.
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBall\-proxy\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBall\-proxy\-passwd\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBall\-proxy\-user\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBallow\-overwrite\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBallow\-piece\-length\-change\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBalways\-resume\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBasync\-dns\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBauto\-file\-renaming\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBbt\-enable\-lpd\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBbt\-exclude\-tracker\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBbt\-external\-ip\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBbt\-hash\-check\-seed\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBbt\-max\-open\-files\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBbt\-max\-peers\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBbt\-metadata\-only\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBbt\-min\-crypto\-level\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBbt\-prioritize\-piece\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBbt\-request\-peer\-speed\-limit\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBbt\-require\-crypto\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBbt\-save\-metadata\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBbt\-seed\-unverified\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBbt\-stop\-timeout\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBbt\-tracker\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBbt\-tracker\-connect\-timeout\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBbt\-tracker\-interval\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBbt\-tracker\-timeout\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBcheck\-integrity\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBconditional\-get\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBconnect\-timeout\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBcontinue\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBdir\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBdry\-run\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBenable\-async\-dns6\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBenable\-http\-keep\-alive\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBenable\-http\-pipelining\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBenable\-peer\-exchange\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBfile\-allocation\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBfollow\-metalink\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBfollow\-torrent\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBftp\-passwd\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBftp\-pasv\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBftp\-proxy\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBftp\-proxy\-passwd\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBftp\-proxy\-user\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBftp\-reuse\-connection\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBftp\-type\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBftp\-user\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBheader\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBhttp\-accept\-gzip\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBhttp\-auth\-challenge\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBhttp\-no\-cache\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBhttp\-passwd\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBhttp\-proxy\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBhttp\-proxy\-passwd\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBhttp\-proxy\-user\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBhttp\-user\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBhttps\-proxy\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBhttps\-proxy\-passwd\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBhttps\-proxy\-user\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBindex\-out\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBlowest\-speed\-limit\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBmax\-connection\-per\-server\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBmax\-download\-limit\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBmax\-file\-not\-found\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBmax\-resume\-failure\-tries\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBmax\-tries\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBmax\-upload\-limit\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBmetalink\-enable\-unique\-protocol\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBmetalink\-language\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBmetalink\-location\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBmetalink\-os\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBmetalink\-preferred\-protocol\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBmetalink\-servers\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBmetalink\-version\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBmin\-split\-size\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBno\-file\-allocation\-limit\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBno\-netrc\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBno\-proxy\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBout\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBparameterized\-uri\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBproxy\-method\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBrealtime\-chunk\-checksum\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBreferer\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBremote\-time\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBremove\-control\-file\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBreuse\-uri\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBseed\-ratio\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBseed\-time\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBselect\-file\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBsplit\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBtimeout\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBuse\-head\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBuser\-agent\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBretry\-wait\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.RS 4
|
|
|
+.ie n \{\
|
|
|
+\h'-04'\(bu\h'+03'\c
|
|
|
+.\}
|
|
|
+.el \{\
|
|
|
+.sp -1
|
|
|
+.IP \(bu 2.3
|
|
|
+.\}
|
|
|
+
|
|
|
+\fBmetalink\-base\-uri\fP
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+Эти параметры имеют точно такой же смысл, что параметры командной строки, но
|
|
|
+это применимо только к URI, к которым они принадлежат\&. Обратите внимание,
|
|
|
+что параметры во входном файле не должны иметь префикс "\-\-"\&.
|
|
|
+.sp
|
|
|
+Например, такое сожержимое uri\&.txt
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+http://server/file\&.iso http://mirror/file\&.iso
|
|
|
+ dir=/iso_images
|
|
|
+ out=file\&.img
|
|
|
+http://foo/bar
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+Если aria2 выполняется с параметрами \fB\-i\fP uri\&.txt \fB\-d\fP /tmp, а загрузка
|
|
|
+происходит с http://server/file\&.iso и http://mirror/file\&.iso, то
|
|
|
+\fIfile\&.iso\fP сохранится как \fI/iso_images/file\&.img\fP\&. Файл \fIbar\fP
|
|
|
+загрузится с http://foo/bar и сохранится как \fI/tmp/bar\fP\&.
|
|
|
+.sp
|
|
|
+В некоторых случаях, параметр \fBout\fP не имеет никакого эффекта\&. Смотрите
|
|
|
+примечание по ограничениям параметра \fB\-\-out\fP\&.
|
|
|
+.SS "Профиль функционирования сервера"
|
|
|
+.sp
|
|
|
+Этот раздел описывает формат профиля функционирования сервера\&. Это
|
|
|
+открытый текстовый файл, каждая строка которого имеет несколько пар
|
|
|
+ИМЯ=ЗНАЧЕНИЕ, разделенных запятыми\&. В настоящее время распознаются
|
|
|
+следующие ИМЕНА:
|
|
|
+.PP
|
|
|
+host
|
|
|
+.RS 4
|
|
|
+Хост\-имя сервера\&. Обязательно\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+protocol
|
|
|
+.RS 4
|
|
|
+Протокол для этого профиля, такие как ftp, http\&. Обязательно\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+dl_speed
|
|
|
+.RS 4
|
|
|
+Средняя скорость загрузки, которая наблюдалась при предыдущей загрузке, в
|
|
|
+байт/секунду\&. Обязательно\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+sc_avg_speed
|
|
|
+.RS 4
|
|
|
+Средняя скорость загрузки, которая наблюдалась при предыдущей загрузке, в
|
|
|
+байт/секунду\&. Это значение обновляется только если загрузка произведена
|
|
|
+при одном соединении и только с использованием
|
|
|
+AdaptiveURISelector\&. Необязательно\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+mc_avg_speed
|
|
|
+.RS 4
|
|
|
+Средняя скорость загрузки, которая наблюдалась при предыдущей загрузке, в
|
|
|
+байт/секунду\&. Это значение обновляется только если загрузка произведена
|
|
|
+при нескольких соединениях и только с использованием
|
|
|
+AdaptiveURISelector\&. Необязательно\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+counter
|
|
|
+.RS 4
|
|
|
+Сколько раз использовался сервер\&. В настоящее время это значение
|
|
|
+используется только при AdaptiveURISelector\&. Необязательно\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+last_updated
|
|
|
+.RS 4
|
|
|
+Время связи, в GMT, с этим сервером, указывается в секундах начиная с
|
|
|
+00:00:00 1 Января, 1970, UTC\&. Обязательно\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+status
|
|
|
+.RS 4
|
|
|
+ERROR, когда сервер не доступен из\-за неисправности или тайм\-аута\&. Иначе \-
|
|
|
+OK\&.
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+Эти поля должны быть в одной строке\&. Последовательность полей не имеет
|
|
|
+значения\&. Вы можете размещать пары, отличные от перечисленных выше; они
|
|
|
+будут просто игнорироваться\&.
|
|
|
+.sp
|
|
|
+Например следующим образом:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+host=localhost, protocol=http, dl_speed=32000, last_updated=1222491640, status=OK
|
|
|
+host=localhost, protocol=ftp, dl_speed=0, last_updated=1222491632, status=ERROR
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.SH RPC\-ИНТЕРФЕЙС
|
|
|
+.sp
|
|
|
+aria2 обеспечивает JSON\-RPC и XML\-RPC, они в основном имеют одинаковые
|
|
|
+функции\&.
|
|
|
+.sp
|
|
|
+Путь для запроса к JSON\-RPC\-интерфейсу \- \fI/jsonrpc\fP\&. Путь для запроса к
|
|
|
+XML\-RPC\-интерфейсу \- \fI/rpc\fP\&.
|
|
|
+.sp
|
|
|
+JSON\-RPC реализован на основе JSON\-RPC 2\&.0 Спецификация (2010\-03\-26) с
|
|
|
+поддержкой HTTP POST и GET (JSONP)\&.
|
|
|
+.sp
|
|
|
+JSON\-RPC\-интерфейс не поддерживает уведомления\&. Он так же не поддерживает
|
|
|
+числа с плавающей точкой\&. Символы должны быть в кодировке UTF\-8\&.
|
|
|
+.sp
|
|
|
+В следующем документе о JSON\-RPC, описана структура JSON\-объекта\&.
|
|
|
+.SS Терминология
|
|
|
+.PP
|
|
|
+GID
|
|
|
+.RS 4
|
|
|
+GID (или gid) \- это ключ, для управление каждой загрузкой\&. Каждая загрузка
|
|
|
+имеет уникальный GID\&. В настоящие время GID представлен как целое число,
|
|
|
+но обрабатывается как не целое число, т.к. он может быть изменен на другой
|
|
|
+тип в будущих версиях\&. Обратите внимание, что GID существует в локальной
|
|
|
+сессии и не сохраняется при завершении работы aria2\&.
|
|
|
+.RE
|
|
|
+.SS Методы
|
|
|
+.sp
|
|
|
+Весь код в примерах написан на Python2\&.7\&.
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.addUri (uris[, options[, position]])\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод добавляет новый HTTP(S)/FTP/BitTorrent Magnet URI\&. Параметр
|
|
|
+\fIuris\fP имеет тип массив, элемент которого имеет тип строка и содержит
|
|
|
+URI\&. Для BitTorrent Magnet URI, \fIuris\fP должен содержать только один
|
|
|
+элемент, и он должен быть BitTorrent Magnet URI\&. URI в параметре \fIuris\fP
|
|
|
+должны указывать на один и тот же файл\&. Если вы смешивайте другие URI,
|
|
|
+указывающие на другой файл, то aria2 не сообщит об этом, но и загрузка может
|
|
|
+неудачно завершаться\&. Параметр \fIoptions\fP имеет тип структура, элементы
|
|
|
+которой являются парой имя и значение\&. Смотрите ниже \fBПараметры\fP для
|
|
|
+более подробной информации\&. Если параметр \fIposition\fP задан как целое
|
|
|
+число, начиная с 0, то новая загрузка будет вставлена на позицию \fIposition\fP
|
|
|
+в очередь ожидания\&. Если параметр \fIposition\fP не задан или больше чем
|
|
|
+размер очереди, то загрузка будет добавлена в конец очереди\&. Этот метод
|
|
|
+возвращает GID зарегистрированной загрузки\&.
|
|
|
+.sp
|
|
|
+Следующий пример добавляет http://example\&.org/file в aria2:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import urllib2, json
|
|
|
+>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.addUri\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqparams\*(Aq:[[\*(Aqhttp://example\&.org/file\*(Aq]]})
|
|
|
+>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq)
|
|
|
+>>> c\&.read()
|
|
|
+\*(Aq{"id":"qwer","jsonrpc":"2\&.0","result":"1"}\*(Aq
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+Следующий пример добавляет http://example\&.org/file в aria2:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import xmlrpclib
|
|
|
+>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq)
|
|
|
+>>> s\&.aria2\&.addUri([\*(Aqhttp://example\&.org/file\*(Aq])
|
|
|
+\*(Aq1\*(Aq
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+Следующий пример добавляет два источника и некоторые параметры:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> s\&.aria2\&.addUri([\*(Aqhttp://example\&.org/file\*(Aq, \*(Aqhttp://mirror/file\*(Aq],
|
|
|
+ dict(dir="/tmp"))
|
|
|
+\*(Aq2\*(Aq
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+Следующий пример добавляет загрузку и вставляет ее перед ожидающими
|
|
|
+загрузками:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> s\&.aria2\&.addUri([\*(Aqhttp://example\&.org/file\*(Aq], {}, 0)
|
|
|
+\*(Aq3\*(Aq
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.addTorrent (torrent[, uris[, options[, position]]])\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод добавляет BitTorrent\-загрузку путем загрузки
|
|
|
+\&.torrent\-файла\&. Если вы хотите добавить BitTorrent Magnet URI, взамен
|
|
|
+используйте метод \fBaria2\&.addUri\fP\&. Параметр \fItorrent\fP имеет тип base64,
|
|
|
+с содержанием Base64\-кодировки в \&.torrent\-файле\&. Параметр \fIuris\fP имеет
|
|
|
+тип массив, элемент которого имеет тип строка и содержит URI\&. Параметр
|
|
|
+\fIuris\fP используется для Web\-сидирования\&. Для одно файловых торрентов, URI
|
|
|
+может быть завершенным, который указывает на ресурс, или же если
|
|
|
+заканчиваться символом /, тогда будет добавлено имя из torrent\-файла\&. Для
|
|
|
+много файловых торентов, имя и путь в торренте будут добавлены из URI для
|
|
|
+каждого файла\&. Параметр \fIoptions\fP имеет тип структура, элементы которой
|
|
|
+являются парой имя и значение\&. Смотрите ниже \fBПараметры\fP для более
|
|
|
+подробной информации\&. Если параметр \fIposition\fP задан как целое число,
|
|
|
+начиная с 0, то новая загрузка будет вставлена на позицию \fIposition\fP в
|
|
|
+очередь ожидания\&. Если параметр \fIposition\fP не задан или больше чем размер
|
|
|
+очереди, то загрузка будет добавлена в конец очереди\&. Этот метод
|
|
|
+возвращает GID зарегистрированной загрузки\&. Загруженные данные сохраняются
|
|
|
+в файл с именем шестнадцатеричной строки SHA\-1\-хэша этих данных плюс
|
|
|
+"\&.torrent", в каталог указанный в параметре \fB\-\-dir\fP\&. Например, имя
|
|
|
+файла 0a3893293e27ac0490424c06de4d09242215f0a6\&.torrent\&. Если этот файл
|
|
|
+существует, то он будет перезаписан\&. Если файл не может быть успешно
|
|
|
+сохранен, то загрузки, добавленныее этим методом, не сохраняются при помощи
|
|
|
+параметра \fB\-\-save\-session\fP\&.
|
|
|
+.sp
|
|
|
+Следующий пример добавляет локальный файл file\&.torrent в aria2:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import urllib2, json, base64
|
|
|
+>>> torrent = base64\&.b64encode(open(\*(Aqfile\&.torrent\*(Aq)\&.read())
|
|
|
+>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqasdf\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.addTorrent\*(Aq, \*(Aqparams\*(Aq:[torrent]})
|
|
|
+>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq)
|
|
|
+>>> c\&.read()
|
|
|
+\*(Aq{"id":"asdf","jsonrpc":"2\&.0","result":"6"}\*(Aq
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+Следующий пример добавляет локальный файл file\&.torrent в aria2:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import xmlrpclib
|
|
|
+>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq)
|
|
|
+>>> s\&.aria2\&.addTorrent(xmlrpclib\&.Binary(open(\*(Aqfile\&.torrent\*(Aq)\&.read()))
|
|
|
+\*(Aq6\*(Aq
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.addMetalink (metalink[, options[, position]])\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод добавляет Metalink\-загрузку путем загрузки
|
|
|
+\&.metalink\-файла\&. Параметр \fImetalink\fP имеет тип base64, с содержанием
|
|
|
+Base64\-кодировки в \&.metalink\-файле\&. Параметр \fIoptions\fP имеет тип
|
|
|
+структура, элементы которой являются парой имя\-значение\&. Смотрите ниже
|
|
|
+\fBПараметры\fP для более подробной информации\&. Если параметр \fIposition\fP
|
|
|
+задан как целое число, начиная с 0, то новая загрузка будет вставлена на
|
|
|
+позицию \fIposition\fP в очередь ожидания\&. Если параметр \fIposition\fP не задан
|
|
|
+или больше чем размер очереди, то загрузка будет добавлена в конец
|
|
|
+очереди\&. Этот метод возвращает GID зарегистрированной
|
|
|
+загрузки\&. Загруженные данные сохраняются в файл с именем шестнадцатеричной
|
|
|
+строки SHA\-1\-хэша этих данных плюс "\&.metalink", в каталог указанный в
|
|
|
+параметре \fB\-\-dir\fP\&. Например, имя файла
|
|
|
+0a3893293e27ac0490424c06de4d09242215f0a6\&.metalink\&. Если этот файл
|
|
|
+существует, то он будет перезаписан\&. Если файл не может быть успешно
|
|
|
+сохранен, то загрузки, добавленныее этим методом, не сохраняются при помощи
|
|
|
+параметра \fB\-\-save\-session\fP\&.
|
|
|
+.sp
|
|
|
+Следующий пример добавляет локальный файл file\&.meta4 в aria2:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import urllib2, json, base64
|
|
|
+>>> metalink = base64\&.b64encode(open(\*(Aqfile\&.meta4\*(Aq)\&.read())
|
|
|
+>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.addMetalink\*(Aq, \*(Aqparams\*(Aq:[metalink]})
|
|
|
+>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq)
|
|
|
+>>> c\&.read()
|
|
|
+\*(Aq{"id":"qwer","jsonrpc":"2\&.0","result":["8"]}\*(Aq
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+Следующий пример добавляет локальный файл file\&.meta4 в aria2:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import xmlrpclib
|
|
|
+>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq)
|
|
|
+>>> s\&.aria2\&.addMetalink(xmlrpclib\&.Binary(open(\*(Aqfile\&.meta4\*(Aq)\&.read()))
|
|
|
+[\*(Aq8\*(Aq]
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.remove (gid)\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод удаляет загрузку, которая обозначена \fIgid\fP\&. Параметр \fIgid\fP
|
|
|
+имеет тип строка\&. Если указана загрузка, которая загружается в данный
|
|
|
+момент, то сперва она остановится\&. Статус удаления станет "removed"
|
|
|
+(удаленно)\&. Этот метод возвращает GID удаленной загрузки\&.
|
|
|
+.sp
|
|
|
+Следующий пример удаляет загрузку, GID которой "3":
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import urllib2, json
|
|
|
+>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.remove\*(Aq, \*(Aqparams\*(Aq:[\*(Aq3\*(Aq]})
|
|
|
+>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq)
|
|
|
+>>> c\&.read()
|
|
|
+\*(Aq{"id":"qwer","jsonrpc":"2\&.0","result":"3"}\*(Aq
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+Следующий пример удаляет загрузку, GID которой "3":
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import xmlrpclib
|
|
|
+>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq)
|
|
|
+>>> s\&.aria2\&.remove(\*(Aq3\*(Aq)
|
|
|
+\*(Aq3\*(Aq
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.forceRemove (gid)\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод удаляет загрузку, которая обозначена \fIgid\fP\&. Метод действует
|
|
|
+подобно \fBaria2\&.remove\fP, за исключением того, что метод удаляет загрузку
|
|
|
+без каких\-либо действий, которые требует времени, например связь с
|
|
|
+BitTorrent\-трекером\&.
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.pause (gid)\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод приостанавливает загрузку, которая обозначена \fIgid\fP\&. Параметр
|
|
|
+\fIgid\fP имеет тип строки\&. Статус приостановки станет "paused"
|
|
|
+(приостановлено)\&. Если загрузка активна, то загрузка переместится на
|
|
|
+первую позицию в очередь ожидания\&. Пока статус "paused", загрузка не
|
|
|
+начнется\&. Для смены статуса на "waiting", используйте метод
|
|
|
+\fBaria2\&.unpause\fP\&. Этот метод возвращает GID приостановленной загрузки\&.
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.pauseAll ()\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод эквивалентен по вызову \fBaria2\&.pause\fP, для каждой
|
|
|
+активной/ожидающей закачки\&. Этот метод возвращает "OK", в случае успеха\&.
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.forcePause (pid)\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод приостанавливает загрузку, которая обозначена \fIgid\fP\&. Метод
|
|
|
+действует подобно \fBaria2\&.pause\fP, за исключением того, что метод
|
|
|
+приостанавливает загрузку без каких\-либо действий, которые требует времени,
|
|
|
+например связь с BitTorrent\-трекером\&.
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.forcePauseAll ()\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод эквивалентен по вызову \fBaria2\&.forcePause\fP, для каждой
|
|
|
+активной/ожидающей закачки\&. Этот метод возвращает "OK", в случае успеха\&.
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.unpause (gid)\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод изменяет статус загрузки, которая обозначена \fIgid\fP, с "paused"
|
|
|
+на "waiting"\&. Это позволяет перезапускать загрузку\&. Значение ключа
|
|
|
+\fIgid\fP имеет тип строки\&. Этот метод возвращает GID, снятой с паузы,
|
|
|
+загрузки\&.
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.unpauseAll ()\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод эквивалентен по вызову \fBaria2\&.unpause\fP, для каждой
|
|
|
+активной/ожидающей закачки\&. Этот метод возвращает "OK", в случае успеха\&.
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.tellStatus (gid[, keys])\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод возвращает состояние загрузки, которая обозначена
|
|
|
+\fIgid\fP\&. Параметр \fIgid\fP имеет тип строка\&. Параметр \fIkeys\fP имеет тип
|
|
|
+массив строк\&. Если \fIkeys\fP указан, то ответ содержит определенные значения
|
|
|
+в массиве \fIkeys\fP\&. Если \fIkeys\fP пустой или не указан, то ответ содержит
|
|
|
+все значения\&. Это полезно, если вы хотите использовать определенные
|
|
|
+параметры, чтобы исключить множество пересылок\&. Например,
|
|
|
+\fBaria2\&.tellStatus\fP("1", ["gid", "status"]) возвратит \fIgid\fP и
|
|
|
+\fIstatus\fP\&. Ответ имеет тип структура и содержит следующие поля\&. Поля
|
|
|
+имеют тип строка\&.
|
|
|
+.PP
|
|
|
+gid
|
|
|
+.RS 4
|
|
|
+GID этой загрузки\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+status
|
|
|
+.RS 4
|
|
|
+"active" \- загружаемая/сидируемая в данный момент\&. "waiting" \- ожидающая в
|
|
|
+очереди; загрузка не началась\&. "paused" \- приостановленная\&. "error" \-
|
|
|
+остановленная, т.к. произошла ошибка\&. "complete" \- остановленная и
|
|
|
+завершенная загрузка\&. "removed" \- удаленная пользователем загрузка\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+totalLength
|
|
|
+.RS 4
|
|
|
+Общий объем загрузки в байтах\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+completedLength
|
|
|
+.RS 4
|
|
|
+Загруженный объем загрузки в байтах\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+uploadLength
|
|
|
+.RS 4
|
|
|
+Выгруженный объем загрузки в байтах\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+bitfield
|
|
|
+.RS 4
|
|
|
+Шестнадцатеричное представление процесса загрузки\&. Старший бит
|
|
|
+соответствует блоку с индексом 0\&. Бит устанавливается, если блок доступен
|
|
|
+и не устанавливается, если блок отсутствует\&. Запасные биты в конце
|
|
|
+устанавливаются в 0\&. Если загрузка еще не начался, этот значение не будет
|
|
|
+включено в ответ\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+downloadSpeed
|
|
|
+.RS 4
|
|
|
+Скорость загрузки в байт/сек\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+uploadSpeed
|
|
|
+.RS 4
|
|
|
+Скорость выгрузки в байт/сек\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+infoHash
|
|
|
+.RS 4
|
|
|
+Информация о хэше (InfoHash)\&. Только для BitTorrent\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+numSeeders
|
|
|
+.RS 4
|
|
|
+Количество сидов, к которым подключен клиент\&. Только для BitTorrent\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+pieceLength
|
|
|
+.RS 4
|
|
|
+Размер блока в байтах\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+numPieces
|
|
|
+.RS 4
|
|
|
+Количество блоков\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+connections
|
|
|
+.RS 4
|
|
|
+Количество пиров/серверов, к которым подключен клиент\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+errorCode
|
|
|
+.RS 4
|
|
|
+Последний код ошибки, которая произошла при загрузке\&. Значение имеет тип
|
|
|
+строки\&. Коды ошибок определены в разделе \fBКОДЫ ЗАВЕРШЕНИЯ\fP\&. Это
|
|
|
+значение доступно только для остановленных/завершенных загрузок\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+followedBy
|
|
|
+.RS 4
|
|
|
+Список с GID, которые сгенерированы в результате запуска этой
|
|
|
+загрузки\&. Например, когда aria2 загружает Metalink\-файл, то это генерирует
|
|
|
+загрузки, описанные в нем (см. параметр \fB\-\-follow\-metalink\fP)\&. Это
|
|
|
+значение полезно для отслеживания автоматически сгенерированных
|
|
|
+загрузок\&. Если таких загрузок нет, то значение не будет включено в
|
|
|
+ответ\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+belongsTo
|
|
|
+.RS 4
|
|
|
+GID родительской загрузки\&. Некоторые загрузки являются частью другой
|
|
|
+загрузки\&. Например, если файл в Metalink содержит BitTorrent\-ответ,
|
|
|
+загрузка \&.torrent будет частью этого файла\&. Если эта загрузка не имеет
|
|
|
+родительской загрузки, то значение не будет включено в ответ\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+dir
|
|
|
+.RS 4
|
|
|
+Каталог для сохранения файлов\&. Этот параметр не доступен для остановленных
|
|
|
+загрузок\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+files
|
|
|
+.RS 4
|
|
|
+Возвращает список файлов\&. Элемент списка \- это структура, такая же, что и
|
|
|
+в методе \fBaria2\&.getFiles\fP\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+bittorrent
|
|
|
+.RS 4
|
|
|
+Структура, в которой содержится информация, извлеченная из
|
|
|
+\&.torrent\-файла\&. Только для BitTorrent\&. Содержит следующие поля\&.
|
|
|
+.PP
|
|
|
+announceList
|
|
|
+.RS 4
|
|
|
+Список списков URI анонса\&. Если \&.torrent\-файл содержит анонс, а не
|
|
|
+список\-анонс, то анонс конвертируется в формат списка\-анонса\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+comment
|
|
|
+.RS 4
|
|
|
+Комментарий по торренту\&. Используется comment\&.utf\-8, если доступно\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+creationDate
|
|
|
+.RS 4
|
|
|
+Время создания торрента\&. Значение является целым числом, с начала века,
|
|
|
+измеряется в секундах\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+mode
|
|
|
+.RS 4
|
|
|
+Файловый режим торрента\&. Значение одно из двух: \fIsingle\fP (одиночный) или
|
|
|
+\fImulti\fP (множественный)\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+info
|
|
|
+.RS 4
|
|
|
+Структура, которая содержит данные из раздела Info\&. Она содержит следующие
|
|
|
+поля\&.
|
|
|
+.PP
|
|
|
+name
|
|
|
+.RS 4
|
|
|
+имя в разделе info\&. Используется name\&.utf\-8, если доступно\&.
|
|
|
+.RE
|
|
|
+.RE
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+Следующий пример получает иформацию о загрузке, GID которой "1":
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import urllib2, json
|
|
|
+>>> from pprint import pprint
|
|
|
+>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.tellStatus\*(Aq, \*(Aqparams\*(Aq:[\*(Aq1\*(Aq]})
|
|
|
+>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq)
|
|
|
+>>> pprint(json\&.loads(c\&.read()))
|
|
|
+{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq,
|
|
|
+ u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq,
|
|
|
+ u\*(Aqresult\*(Aq: {u\*(Aqbitfield\*(Aq: u\*(Aq0000000000\*(Aq,
|
|
|
+ u\*(AqcompletedLength\*(Aq: u\*(Aq901120\*(Aq,
|
|
|
+ u\*(Aqconnections\*(Aq: u\*(Aq1\*(Aq,
|
|
|
+ u\*(Aqdir\*(Aq: u\*(Aq/downloads\*(Aq,
|
|
|
+ u\*(AqdownloadSpeed\*(Aq: u\*(Aq15158\*(Aq,
|
|
|
+ u\*(Aqfiles\*(Aq: [{u\*(Aqindex\*(Aq: u\*(Aq1\*(Aq,
|
|
|
+ u\*(Aqlength\*(Aq: u\*(Aq34896138\*(Aq,
|
|
|
+ u\*(Aqpath\*(Aq: u\*(Aq/downloads/file\*(Aq,
|
|
|
+ u\*(Aqselected\*(Aq: u\*(Aqtrue\*(Aq,
|
|
|
+ u\*(Aquris\*(Aq: [{u\*(Aqstatus\*(Aq: u\*(Aqused\*(Aq,
|
|
|
+ u\*(Aquri\*(Aq: u\*(Aqhttp://example\&.org/file\*(Aq}]}],
|
|
|
+ u\*(Aqgid\*(Aq: u\*(Aq1\*(Aq,
|
|
|
+ u\*(AqnumPieces\*(Aq: u\*(Aq34\*(Aq,
|
|
|
+ u\*(AqpieceLength\*(Aq: u\*(Aq1048576\*(Aq,
|
|
|
+ u\*(Aqstatus\*(Aq: u\*(Aqactive\*(Aq,
|
|
|
+ u\*(AqtotalLength\*(Aq: u\*(Aq34896138\*(Aq,
|
|
|
+ u\*(AquploadLength\*(Aq: u\*(Aq0\*(Aq,
|
|
|
+ u\*(AquploadSpeed\*(Aq: u\*(Aq0\*(Aq}}
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+Следующий пример получает информацию об определенных полях, который вас
|
|
|
+интересуют:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.tellStatus\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqparams\*(Aq:[\*(Aq1\*(Aq, [\*(Aqgid\*(Aq,
|
|
|
+\&.\&.\&. \*(AqtotalLength\*(Aq,
|
|
|
+\&.\&.\&. \*(AqcompletedLength\*(Aq]]})
|
|
|
+>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq)
|
|
|
+>>> pprint(json\&.loads(c\&.read()))
|
|
|
+{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq,
|
|
|
+ u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq,
|
|
|
+ u\*(Aqresult\*(Aq: {u\*(AqcompletedLength\*(Aq: u\*(Aq5701632\*(Aq,
|
|
|
+ u\*(Aqgid\*(Aq: u\*(Aq1\*(Aq,
|
|
|
+ u\*(AqtotalLength\*(Aq: u\*(Aq34896138\*(Aq}}
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+Следующий пример получает иформацию о загрузке, GID которой "1":
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import xmlrpclib
|
|
|
+>>> from pprint import pprint
|
|
|
+>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq)
|
|
|
+>>> r = s\&.aria2\&.tellStatus(\*(Aq1\*(Aq)
|
|
|
+>>> pprint(r)
|
|
|
+{\*(Aqbitfield\*(Aq: \*(Aqffff80\*(Aq,
|
|
|
+ \*(AqcompletedLength\*(Aq: \*(Aq34896138\*(Aq,
|
|
|
+ \*(Aqconnections\*(Aq: \*(Aq0\*(Aq,
|
|
|
+ \*(Aqdir\*(Aq: \*(Aq/downloads\*(Aq,
|
|
|
+ \*(AqdownloadSpeed\*(Aq: \*(Aq0\*(Aq,
|
|
|
+ \*(AqerrorCode\*(Aq: \*(Aq0\*(Aq,
|
|
|
+ \*(Aqfiles\*(Aq: [{\*(Aqindex\*(Aq: \*(Aq1\*(Aq,
|
|
|
+ \*(Aqlength\*(Aq: \*(Aq34896138\*(Aq,
|
|
|
+ \*(Aqpath\*(Aq: \*(Aq/downloads/file\*(Aq,
|
|
|
+ \*(Aqselected\*(Aq: \*(Aqtrue\*(Aq,
|
|
|
+ \*(Aquris\*(Aq: [{\*(Aqstatus\*(Aq: \*(Aqused\*(Aq,
|
|
|
+ \*(Aquri\*(Aq: \*(Aqhttp://example\&.org/file\*(Aq}]}],
|
|
|
+ \*(Aqgid\*(Aq: \*(Aq1\*(Aq,
|
|
|
+ \*(AqnumPieces\*(Aq: \*(Aq17\*(Aq,
|
|
|
+ \*(AqpieceLength\*(Aq: \*(Aq2097152\*(Aq,
|
|
|
+ \*(Aqstatus\*(Aq: \*(Aqcomplete\*(Aq,
|
|
|
+ \*(AqtotalLength\*(Aq: \*(Aq34896138\*(Aq,
|
|
|
+ \*(AquploadLength\*(Aq: \*(Aq0\*(Aq,
|
|
|
+ \*(AquploadSpeed\*(Aq: \*(Aq0\*(Aq}
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+Следующий пример получает информацию об определенных полях, который вас
|
|
|
+интересуют:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> r = s\&.aria2\&.tellStatus(\*(Aq1\*(Aq, [\*(Aqgid\*(Aq, \*(AqtotalLength\*(Aq, \*(AqcompletedLength\*(Aq])
|
|
|
+>>> pprint(r)
|
|
|
+{\*(AqcompletedLength\*(Aq: \*(Aq34896138\*(Aq, \*(Aqgid\*(Aq: \*(Aq1\*(Aq, \*(AqtotalLength\*(Aq: \*(Aq34896138\*(Aq}
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.getUris (gid)\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод возвращает URI, используемые в загрузке, которая обозначена
|
|
|
+\fIgid\fP\&. Параметр \fIgid\fP имеет тип строка\&. Ответ имеет тип массив, а
|
|
|
+элемент \- тип структура и содержит следующие поля\&. Поле имеет тип
|
|
|
+строка\&.
|
|
|
+.PP
|
|
|
+uri
|
|
|
+.RS 4
|
|
|
+URI
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+status
|
|
|
+.RS 4
|
|
|
+
|
|
|
+\fIused\fP, если URI уже использован\&. \fIwaiting\fP, если URI ожидает в
|
|
|
+очереди\&.
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import urllib2, json
|
|
|
+>>> from pprint import pprint
|
|
|
+>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.getUris\*(Aq, \*(Aqparams\*(Aq:[\*(Aq1\*(Aq]})
|
|
|
+>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq)
|
|
|
+>>> pprint(json\&.loads(c\&.read()))
|
|
|
+{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq,
|
|
|
+ u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq,
|
|
|
+ u\*(Aqresult\*(Aq: [{u\*(Aqstatus\*(Aq: u\*(Aqused\*(Aq,
|
|
|
+ u\*(Aquri\*(Aq: u\*(Aqhttp://example\&.org/file\*(Aq}]}
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import xmlrpclib
|
|
|
+>>> from pprint import pprint
|
|
|
+>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq)
|
|
|
+>>> r = s\&.aria2\&.getUris(\*(Aq1\*(Aq)
|
|
|
+>>> pprint(r)
|
|
|
+[{\*(Aqstatus\*(Aq: \*(Aqused\*(Aq, \*(Aquri\*(Aq: \*(Aqhttp://example\&.org/file\*(Aq}]
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.getFiles (gid)\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод возвращает список файлов загрузки, которая обозначена
|
|
|
+\fIgid\fP\&. Параметр \fIgid\fP имеет тип строка\&. Ответ имеет тип массив, а
|
|
|
+элемент \- тип структура и содержит следующие поля\&. Поле имеет тип
|
|
|
+строка\&.
|
|
|
+.PP
|
|
|
+index
|
|
|
+.RS 4
|
|
|
+Индекс файла\&. Начинается с 1\&. Последовательность файлов такая же, что и
|
|
|
+в много файловом торренте\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+path
|
|
|
+.RS 4
|
|
|
+Путь к файлу\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+length
|
|
|
+.RS 4
|
|
|
+Размер файла в байта\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+selected
|
|
|
+.RS 4
|
|
|
+"true" \- если этот файл выбран параметром \fB\-\-select\-file\fP\&. Если параметр
|
|
|
+\fB\-\-select\-file\fP не указан или это одно файловый торрент или загрузка не
|
|
|
+торрент, то это значение всегда будет "true"\&. Иначе "false"\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+uris
|
|
|
+.RS 4
|
|
|
+Возвращает список URI для этого файла\&. Элемент списка такая же структура,
|
|
|
+что используется в методе \fBaria2\&.getUris\fP\&.
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import urllib2, json
|
|
|
+>>> from pprint import pprint
|
|
|
+>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.getFiles\*(Aq, \*(Aqparams\*(Aq:[\*(Aq1\*(Aq]})
|
|
|
+>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq)
|
|
|
+>>> pprint(json\&.loads(c\&.read()))
|
|
|
+{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq,
|
|
|
+ u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq,
|
|
|
+ u\*(Aqresult\*(Aq: [{u\*(Aqindex\*(Aq: u\*(Aq1\*(Aq,
|
|
|
+ u\*(Aqlength\*(Aq: u\*(Aq34896138\*(Aq,
|
|
|
+ u\*(Aqpath\*(Aq: u\*(Aq/downloads/file\*(Aq,
|
|
|
+ u\*(Aqselected\*(Aq: u\*(Aqtrue\*(Aq,
|
|
|
+ u\*(Aquris\*(Aq: [{u\*(Aqstatus\*(Aq: u\*(Aqused\*(Aq,
|
|
|
+ u\*(Aquri\*(Aq: u\*(Aqhttp://example\&.org/file\*(Aq}]}]}
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import xmlrpclib
|
|
|
+>>> from pprint import pprint
|
|
|
+>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq)
|
|
|
+>>> r = s\&.aria2\&.getFiles(\*(Aq1\*(Aq)
|
|
|
+>>> pprint(r)
|
|
|
+[{\*(Aqindex\*(Aq: \*(Aq1\*(Aq,
|
|
|
+ \*(Aqlength\*(Aq: \*(Aq34896138\*(Aq,
|
|
|
+ \*(Aqpath\*(Aq: \*(Aq/downloads/file\*(Aq,
|
|
|
+ \*(Aqselected\*(Aq: \*(Aqtrue\*(Aq,
|
|
|
+ \*(Aquris\*(Aq: [{\*(Aqstatus\*(Aq: \*(Aqused\*(Aq,
|
|
|
+ \*(Aquri\*(Aq: \*(Aqhttp://example\&.org/file\*(Aq}]}]
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.getPeers (gid)\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод возвращает список пиров загрузки, которая обозначена
|
|
|
+\fIgid\fP\&. Параметр \fIgid\fP имеет тип строка\&. Этот метод только для
|
|
|
+BitTorrent\&. Ответ имеет тип массив, а элемент \- тип структура и содержит
|
|
|
+следующие поля\&. Поле имеет тип строка\&.
|
|
|
+.PP
|
|
|
+peerId
|
|
|
+.RS 4
|
|
|
+Закодированное ID пира\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+ip
|
|
|
+.RS 4
|
|
|
+IP\-адрес пира\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+port
|
|
|
+.RS 4
|
|
|
+Номер порта пира\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+bitfield
|
|
|
+.RS 4
|
|
|
+Шестнадцатеричное представление процесса загрузки\&. Старший бит
|
|
|
+соответствует блоку с индексом 0\&. Бит устанавливается, если блок доступен
|
|
|
+и не устанавливается, если блок отсутствует\&. Запасные биты в конце
|
|
|
+устанавливаются в 0\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+amChoking
|
|
|
+.RS 4
|
|
|
+"true" \- если этот клиент блокирует пира\&. Иначе "false"\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+peerChoking
|
|
|
+.RS 4
|
|
|
+"true" \- если пир блокирует этого клиента\&. Иначе "false"\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+downloadSpeed
|
|
|
+.RS 4
|
|
|
+Скорость загрузки (байт/сек), с которой этот клиент получает от пира\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+uploadSpeed
|
|
|
+.RS 4
|
|
|
+Скорость выгрузки (байт/сек), с которой этот клиент отдает пиру\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+seeder
|
|
|
+.RS 4
|
|
|
+"true" \- если этот клиент является сидом\&. Иначе "false"\&.
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import urllib2, json
|
|
|
+>>> from pprint import pprint
|
|
|
+>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.getPeers\*(Aq, \*(Aqparams\*(Aq:[\*(Aq1\*(Aq]})
|
|
|
+>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq)
|
|
|
+>>> pprint(json\&.loads(c\&.read()))
|
|
|
+{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq,
|
|
|
+ u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq,
|
|
|
+ u\*(Aqresult\*(Aq: [{u\*(AqamChoking\*(Aq: u\*(Aqtrue\*(Aq,
|
|
|
+ u\*(Aqbitfield\*(Aq: u\*(Aqffffffffffffffffffffffffffffffffffffffff\*(Aq,
|
|
|
+ u\*(AqdownloadSpeed\*(Aq: u\*(Aq10602\*(Aq,
|
|
|
+ u\*(Aqip\*(Aq: u\*(Aq10\&.0\&.0\&.9\*(Aq,
|
|
|
+ u\*(AqpeerChoking\*(Aq: u\*(Aqfalse\*(Aq,
|
|
|
+ u\*(AqpeerId\*(Aq: u\*(Aqaria2%2F1%2E10%2E5%2D%87%2A%EDz%2F%F7%E6\*(Aq,
|
|
|
+ u\*(Aqport\*(Aq: u\*(Aq6881\*(Aq,
|
|
|
+ u\*(Aqseeder\*(Aq: u\*(Aqtrue\*(Aq,
|
|
|
+ u\*(AquploadSpeed\*(Aq: u\*(Aq0\*(Aq},
|
|
|
+ {u\*(AqamChoking\*(Aq: u\*(Aqfalse\*(Aq,
|
|
|
+ u\*(Aqbitfield\*(Aq: u\*(Aqffffeff0fffffffbfffffff9fffffcfff7f4ffff\*(Aq,
|
|
|
+ u\*(AqdownloadSpeed\*(Aq: u\*(Aq8654\*(Aq,
|
|
|
+ u\*(Aqip\*(Aq: u\*(Aq10\&.0\&.0\&.30\*(Aq,
|
|
|
+ u\*(AqpeerChoking\*(Aq: u\*(Aqfalse\*(Aq,
|
|
|
+ u\*(AqpeerId\*(Aq: u\*(Aqbittorrent client758\*(Aq,
|
|
|
+ u\*(Aqport\*(Aq: u\*(Aq37842\*(Aq,
|
|
|
+ u\*(Aqseeder\*(Aq: u\*(Aqfalse\*(Aq,
|
|
|
+ u\*(AquploadSpeed\*(Aq: u\*(Aq6890\*(Aq}]}
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import xmlrpclib
|
|
|
+>>> from pprint import pprint
|
|
|
+>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq)
|
|
|
+>>> r = s\&.aria2\&.getPeers(\*(Aq1\*(Aq)
|
|
|
+>>> pprint(r)
|
|
|
+[{\*(AqamChoking\*(Aq: \*(Aqtrue\*(Aq,
|
|
|
+ \*(Aqbitfield\*(Aq: \*(Aqffffffffffffffffffffffffffffffffffffffff\*(Aq,
|
|
|
+ \*(AqdownloadSpeed\*(Aq: \*(Aq10602\*(Aq,
|
|
|
+ \*(Aqip\*(Aq: \*(Aq10\&.0\&.0\&.9\*(Aq,
|
|
|
+ \*(AqpeerChoking\*(Aq: \*(Aqfalse\*(Aq,
|
|
|
+ \*(AqpeerId\*(Aq: \*(Aqaria2%2F1%2E10%2E5%2D%87%2A%EDz%2F%F7%E6\*(Aq,
|
|
|
+ \*(Aqport\*(Aq: \*(Aq6881\*(Aq,
|
|
|
+ \*(Aqseeder\*(Aq: \*(Aqtrue\*(Aq,
|
|
|
+ \*(AquploadSpeed\*(Aq: \*(Aq0\*(Aq},
|
|
|
+ {\*(AqamChoking\*(Aq: \*(Aqfalse\*(Aq,
|
|
|
+ \*(Aqbitfield\*(Aq: \*(Aqffffeff0fffffffbfffffff9fffffcfff7f4ffff\*(Aq,
|
|
|
+ \*(AqdownloadSpeed\*(Aq: \*(Aq8654\*(Aq,
|
|
|
+ \*(Aqip\*(Aq: \*(Aq10\&.0\&.0\&.30\*(Aq,
|
|
|
+ \*(AqpeerChoking\*(Aq: \*(Aqfalse\*(Aq,
|
|
|
+ \*(AqpeerId\*(Aq: \*(Aqbittorrent client758\*(Aq,
|
|
|
+ \*(Aqport\*(Aq: \*(Aq37842\*(Aq,
|
|
|
+ \*(Aqseeder\*(Aq: \*(Aqfalse,
|
|
|
+ \*(AquploadSpeed\*(Aq: \*(Aq6890\*(Aq}]
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.getServers (gid)\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод возвращает текущие подключенные HTTP(S)/FTP\-серверы загрузки,
|
|
|
+которая обозначена \fIgid\fP\&. Параметр \fIgid\fP имеет тип строка\&. Ответ имеет
|
|
|
+тип массив, а элемент \- тип структура и содержит следующие поля\&. Поле
|
|
|
+имеет тип строка\&.
|
|
|
+.PP
|
|
|
+index
|
|
|
+.RS 4
|
|
|
+Индекс файла\&. Начинается с 1\&. Последовательность файлов такая же, что и
|
|
|
+в много файловом торренте\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+servers
|
|
|
+.RS 4
|
|
|
+Список структур, которые содержат следующие поля\&.
|
|
|
+.PP
|
|
|
+uri
|
|
|
+.RS 4
|
|
|
+Первоначально добавленный URI\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+currentUri
|
|
|
+.RS 4
|
|
|
+Это URI в настоящее время используется для загрузки\&. Если происходит
|
|
|
+перенаправление, currentUri и uri могут отличаться\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+downloadSpeed
|
|
|
+.RS 4
|
|
|
+Скорость загрузки (байт/сек)
|
|
|
+.RE
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import urllib2, json
|
|
|
+>>> from pprint import pprint
|
|
|
+>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.getServers\*(Aq, \*(Aqparams\*(Aq:[\*(Aq1\*(Aq]})
|
|
|
+>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq)
|
|
|
+>>> pprint(json\&.loads(c\&.read()))
|
|
|
+{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq,
|
|
|
+ u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq,
|
|
|
+ u\*(Aqresult\*(Aq: [{u\*(Aqindex\*(Aq: u\*(Aq1\*(Aq,
|
|
|
+ u\*(Aqservers\*(Aq: [{u\*(AqcurrentUri\*(Aq: u\*(Aqhttp://example\&.org/file\*(Aq,
|
|
|
+ u\*(AqdownloadSpeed\*(Aq: u\*(Aq10467\*(Aq,
|
|
|
+ u\*(Aquri\*(Aq: u\*(Aqhttp://example\&.org/file\*(Aq}]}]}
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import xmlrpclib
|
|
|
+>>> from pprint import pprint
|
|
|
+>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq)
|
|
|
+>>> r = s\&.aria2\&.getServers(\*(Aq1\*(Aq)
|
|
|
+>>> pprint(r)
|
|
|
+[{\*(Aqindex\*(Aq: \*(Aq1\*(Aq,
|
|
|
+ \*(Aqservers\*(Aq: [{\*(AqcurrentUri\*(Aq: \*(Aqhttp://example\&.org/dl/file\*(Aq,
|
|
|
+ \*(AqdownloadSpeed\*(Aq: \*(Aq20285\*(Aq,
|
|
|
+ \*(Aquri\*(Aq: \*(Aqhttp://example\&.org/file\*(Aq}]}]
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.tellActive ([keys])\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод возвращает список активных загрузок\&. Ответ имеет тип массив и
|
|
|
+его элемент такая же структура, которая возвращается методом
|
|
|
+\fBaria2\&.tellStatus\fP\&. За разъяснениями о параметре \fIkeys\fP, обратитесь к
|
|
|
+методу \fBaria2\&.tellStatus\fP\&.
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.tellWaiting (offset, num, [keys])\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод возвращает список ожидающих загрузок, включая приостановленные
|
|
|
+загрузки\&. \fIoffset\fP имеет целочисленный тип и указывает смещение, начиная
|
|
|
+от ожидающей загрузки\&. \fInum\fP имеет целочисленный тип и указывает число
|
|
|
+возвращаемых загрузок\&. За разъяснениями о параметре \fIkeys\fP, обратитесь к
|
|
|
+методу \fBaria2\&.tellStatus\fP\&.
|
|
|
+.sp
|
|
|
+Если смещение положительное целое число, то этот метод возвращает загрузки в
|
|
|
+диапазоне [\fIoffset\fP, \fIoffset\fP+\fInum\fP)\&.
|
|
|
+.sp
|
|
|
+\fIoffset\fP может быть отрицательным целым числом\&. \fIoffset\fP == \-1 указывает
|
|
|
+на последнею загрузку, которая ожидает в очереди, а \fIoffset\fP == \-2
|
|
|
+указывает на загрузку перед последней, и так далее\&. Загрузки в ответе
|
|
|
+находятся в обратном порядке\&.
|
|
|
+.sp
|
|
|
+Например, допустим что есть три загрузки "A","B" и "C", в этом порядке,
|
|
|
+которые ожидают\&. aria2\&.tellWaiting(0, 1) возвратит
|
|
|
+["A"]\&. aria2\&.tellWaiting(1, 2) возвратит ["B",
|
|
|
+"C"]\&. aria2\&.tellWaiting(\-1, 2) возвратит ["C", "B"]\&.
|
|
|
+.sp
|
|
|
+Ответ имеет тип массив и его элемент такая же структура, которая
|
|
|
+возвращается методом \fBaria2\&.tellStatus\fP\&.
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.tellStopped (offset, num, [keys])\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод возвращает список остановленных загрузок\&. \fIoffset\fP имеет
|
|
|
+целочисленный тип и указывает смещение, начиная с самой старой
|
|
|
+загрузки\&. \fInum\fP имеет целочисленный тип и указывает число возвращаемых
|
|
|
+загрузок\&. За разъяснениями о параметре \fIkeys\fP, обратитесь к методу
|
|
|
+\fBaria2\&.tellStatus\fP\&.
|
|
|
+.sp
|
|
|
+\fIoffset\fP и \fInum\fP имеют такую же семантику как и в методе
|
|
|
+\fBaria2\&.tellWaiting\fP\&.
|
|
|
+.sp
|
|
|
+Ответ имеет тип массив и его элемент такая же структура, которая
|
|
|
+возвращается методом \fBaria2\&.tellStatus\fP\&.
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.changePosition (gid, pos, how)\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод меняет позицию загрузки, которая обозначена \fIgid\fP\&. \fIpos\fP
|
|
|
+имеет целочисленный тип\&. \fIhow\fP имеет тип строка\&. Если \fIhow\fP \-
|
|
|
+"POS_SET", то это переместит загрузку на позицию, относительно начала
|
|
|
+очереди\&. Если \fIhow\fP \- "POS_CUR", это переместит загрузку на позицию,
|
|
|
+относительно текущей позиции\&. Если \fIhow\fP \- "POS_END", это переместит
|
|
|
+загрузку на позицию, относительно конца очереди\&. Если целевая позиция
|
|
|
+меньше чем 0 или за пределами конца очереди, это переместит загрузку в
|
|
|
+начало или конец очереди соответственно\&. Ответ имеет целочисленный тип и
|
|
|
+является целевой позицией\&.
|
|
|
+.sp
|
|
|
+Например, если GID#1 размещается на позиции 3, aria2\&.changePosition(1, \-1,
|
|
|
+POS_CUR) изменит его позицию на 2\&. Дополнительно aria2\&.changePosition(1,
|
|
|
+0, POS_SET) изменит его позицию на 0 (начало очереди)\&.
|
|
|
+.sp
|
|
|
+Следующий пример перемещает загрузку, GID которой "3", в начало очереди
|
|
|
+ожидания:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import urllib2, json
|
|
|
+>>> from pprint import pprint
|
|
|
+>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.changePosition\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqparams\*(Aq:[\*(Aq3\*(Aq, 0, \*(AqPOS_SET\*(Aq]})
|
|
|
+>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq)
|
|
|
+>>> pprint(json\&.loads(c\&.read()))
|
|
|
+{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: 0}
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+Следующий пример перемещает загрузку, GID которой "3", в начало очереди
|
|
|
+ожидания:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import xmlrpclib
|
|
|
+>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq)
|
|
|
+>>> s\&.aria2\&.changePosition(\*(Aq3\*(Aq, 0, \*(AqPOS_SET\*(Aq)
|
|
|
+0
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.changeUri (gid, fileIndex, delUris, addUris[, position])\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод удаляет URI в \fIdelUris\fP из загрузки и добавляет URI в \fIaddUris\fP
|
|
|
+к загрузке, которая обозначена \fIgid\fP\&. \fIdelUris\fP и \fIaddUris\fP являются
|
|
|
+списком строк\&. Загрузка может содержать несколько файлов и URI прилагаются
|
|
|
+к каждому файлу\&. \fIfileIndex\fP используется, чтобы выбрать файл для
|
|
|
+удаления/подключения заданных URI\&. \fIfileIndex\fP начинается с
|
|
|
+1\&. \fIposition\fP используется для указания, куда будут вставлены URI в
|
|
|
+существующем списке ожидающих URI\&. \fIposition\fP начинается с 0\&. Когда
|
|
|
+\fIposition\fP пропущено, URI добавляются в конец списка\&. Этот метод сначала
|
|
|
+выполняет удаление, а потом добавление\&. \fIposition\fP это позиция после URI,
|
|
|
+которые будут удалены, а не позиция, когда метод вызывается\&. При удалении
|
|
|
+URI, если одинаковые URI существуют в загрузке, только один из них будет
|
|
|
+удален, для каждого URI в \fIdelUris\fP\&. Другими словами, есть три URI
|
|
|
+"http://example\&.org/aria2" и вы хотите удалить их все, вы должны указать
|
|
|
+(по крайней мере) 3 "http://example\&.org/aria2" в \fIdelUris\fP\&. Этот метод
|
|
|
+возвращает список, который содержит 2 целых числа\&. Первое \- количество
|
|
|
+удаленных URI\&. Второе \- количество добавленных URI\&.
|
|
|
+.sp
|
|
|
+Следующий пример добавляет 1 URI http://example\&.org/file к файлу с
|
|
|
+индексом "1", принадлежащий загрузке, GID которой "2":
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import urllib2, json
|
|
|
+>>> from pprint import pprint
|
|
|
+>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.changeUri\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqparams\*(Aq:[\*(Aq2\*(Aq, 1, [], [\*(Aqhttp://example\&.org/file\*(Aq]]})
|
|
|
+>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq)
|
|
|
+>>> pprint(json\&.loads(c\&.read()))
|
|
|
+{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: [0, 1]}
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+Следующий пример добавляет 1 URI http://example\&.org/file к файлу с
|
|
|
+индексом "1", принадлежащий загрузке, GID которой "2":
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import xmlrpclib
|
|
|
+>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq)
|
|
|
+>>> s\&.aria2\&.changeUri(\*(Aq2\*(Aq, 1, [], [\*(Aqhttp://example\&.org/file\*(Aq])
|
|
|
+[0, 1]
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.getOption (gid)\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод возвращает параметры загрузки, которая обозначена \fIgid\fP\&. Ответ
|
|
|
+имеет тип структура\&. Ее поля \- это название параметра\&. Поле имеет тип
|
|
|
+строка\&.
|
|
|
+.sp
|
|
|
+Следующий пример получает параметры загрузки, GID которой "1":
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import urllib2, json
|
|
|
+>>> from pprint import pprint
|
|
|
+>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.getOption\*(Aq, \*(Aqparams\*(Aq:[\*(Aq1\*(Aq]})
|
|
|
+>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq)
|
|
|
+>>> pprint(json\&.loads(c\&.read()))
|
|
|
+{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq,
|
|
|
+ u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq,
|
|
|
+ u\*(Aqresult\*(Aq: {u\*(Aqallow\-overwrite\*(Aq: u\*(Aqfalse\*(Aq,
|
|
|
+ u\*(Aqallow\-piece\-length\-change\*(Aq: u\*(Aqfalse\*(Aq,
|
|
|
+ u\*(Aqalways\-resume\*(Aq: u\*(Aqtrue\*(Aq,
|
|
|
+ u\*(Aqasync\-dns\*(Aq: u\*(Aqtrue\*(Aq,
|
|
|
+ \&.\&.\&.
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+Следующий пример получает параметры загрузки, GID которой "1":
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import xmlrpclib
|
|
|
+>>> from pprint import pprint
|
|
|
+>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq)
|
|
|
+>>> r = s\&.aria2\&.getOption(\*(Aq1\*(Aq)
|
|
|
+>>> pprint(r)
|
|
|
+{\*(Aqallow\-overwrite\*(Aq: \*(Aqfalse\*(Aq,
|
|
|
+ \*(Aqallow\-piece\-length\-change\*(Aq: \*(Aqfalse\*(Aq,
|
|
|
+ \*(Aqalways\-resume\*(Aq: \*(Aqtrue\*(Aq,
|
|
|
+ \*(Aqasync\-dns\*(Aq: \*(Aqtrue\*(Aq,
|
|
|
+ \&.\&.\&.\&.
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.changeOption (gid, options)\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод изменяет динамически параметры загрузки, которая обозначена
|
|
|
+\fIgid\fP\&. \fIgid\fP имеет тип строка\&. \fIoptions\fP имеет тип структура,
|
|
|
+доступны параметры: \fBbt\-max\-peers\fP, \fBbt\-request\-peer\-speed\-limit\fP,
|
|
|
+\fBmax\-download\-limit\fP и \fBmax\-upload\-limit\fP\&. Этот метод возвращает "OK", в
|
|
|
+случае успеха\&.
|
|
|
+.sp
|
|
|
+Следующий пример устанавливает параметр \fBmax\-download\-limit\fP в "20K" для
|
|
|
+загрузки, GID которой "1":
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import urllib2, json
|
|
|
+>>> from pprint import pprint
|
|
|
+>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.changeOption\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqparams\*(Aq:[\*(Aq1\*(Aq, {\*(Aqmax\-download\-limit\*(Aq:\*(Aq10K\*(Aq}]})
|
|
|
+>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq)
|
|
|
+>>> pprint(json\&.loads(c\&.read()))
|
|
|
+{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: u\*(AqOK\*(Aq}
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+Следующий пример устанавливает параметр \fBmax\-download\-limit\fP в "20K" для
|
|
|
+загрузки, GID которой "1":
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import xmlrpclib
|
|
|
+>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq)
|
|
|
+>>> s\&.aria2\&.changeOption(\*(Aq1\*(Aq, {\*(Aqmax\-download\-limit\*(Aq:\*(Aq20K\*(Aq})
|
|
|
+\*(AqOK\*(Aq
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.getGlobalOption ()\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод возвращает глобальные параметры\&. Ответ имеет тип
|
|
|
+структура\&. Ее поля \- это название параметра\&. Поле имеет тип
|
|
|
+строка\&. Так как глобальные параметры используются в качестве шаблона для
|
|
|
+вновь добавляемой загрузки, ответ содержит поля возвращаемые методом
|
|
|
+\fBaria2\&.getOption\fP\&.
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.changeGlobalOption (options)\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод изменяет динамически глобальные параметры\&. \fIoptions\fP имеет тип
|
|
|
+структура, доступны параметры: \fBmax\-concurrent\-downloads\fP,
|
|
|
+\fBmax\-overall\-download\-limit\fP, \fBmax\-overall\-upload\-limit\fP, \fBlog\-level\fP и
|
|
|
+\fBlog\fP\&. Используя параметр \fBlog\fP, вы можете динамически начинать вести
|
|
|
+журнал событий или изменять файл журнала событий\&. Чтобы остановить ведение
|
|
|
+журнала событий задайте пустую строку ("") в качестве значения
|
|
|
+параметра\&. Обратите внимание, что файл журнала событий всегда открыт в
|
|
|
+режиме добавления\&. Этот метод возвращает "OK", в случае успеха\&.
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.purgeDownloadResult ()\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод очищает, для освобождения памяти, завершенные/ошибка/удаленные
|
|
|
+загрузки\&. Метод возвращает "OK"\&.
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.removeDownloadResult (gid)\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод удаляет из памяти завершенную/ошибка/удаленную загрузку, которая
|
|
|
+обозначена \fIgid\fP\&. Метод возвращает "OK", в случае успеха\&.
|
|
|
+.sp
|
|
|
+Следующий пример удаляет результат загрузки, GID которой "1":
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import urllib2, json
|
|
|
+>>> from pprint import pprint
|
|
|
+>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.removeDownloadResult\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqparams\*(Aq:[\*(Aq1\*(Aq]})
|
|
|
+>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq)
|
|
|
+>>> pprint(json\&.loads(c\&.read()))
|
|
|
+{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: u\*(AqOK\*(Aq}
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+Следующий пример удаляет результат загрузки, GID которой "1":
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import xmlrpclib
|
|
|
+>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq)
|
|
|
+>>> s\&.aria2\&.removeDownloadResult(\*(Aq1\*(Aq)
|
|
|
+\*(AqOK\*(Aq
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.getVersion ()\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод возвращает версию программы и список включенных
|
|
|
+возможностей\&. Ответ имеет тип структура и содержит следующие поля\&.
|
|
|
+.PP
|
|
|
+version
|
|
|
+.RS 4
|
|
|
+Номер версии программы в строке\&.
|
|
|
+.RE
|
|
|
+.PP
|
|
|
+enabledFeatures
|
|
|
+.RS 4
|
|
|
+Список включенных возможностей\&. Каждое имя возможности имеет тип строка\&.
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import urllib2, json
|
|
|
+>>> from pprint import pprint
|
|
|
+>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.getVersion\*(Aq})
|
|
|
+>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq)
|
|
|
+>>> pprint(json\&.loads(c\&.read()))
|
|
|
+{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq,
|
|
|
+ u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq,
|
|
|
+ u\*(Aqresult\*(Aq: {u\*(AqenabledFeatures\*(Aq: [u\*(AqAsync DNS\*(Aq,
|
|
|
+ u\*(AqBitTorrent\*(Aq,
|
|
|
+ u\*(AqFirefox3 Cookie\*(Aq,
|
|
|
+ u\*(AqGZip\*(Aq,
|
|
|
+ u\*(AqHTTPS\*(Aq,
|
|
|
+ u\*(AqMessage Digest\*(Aq,
|
|
|
+ u\*(AqMetalink\*(Aq,
|
|
|
+ u\*(AqXML\-RPC\*(Aq],
|
|
|
+ u\*(Aqversion\*(Aq: u\*(Aq1\&.11\&.0\*(Aq}}
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import xmlrpclib
|
|
|
+>>> from pprint import pprint
|
|
|
+>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq)
|
|
|
+>>> r = s\&.aria2\&.getVersion()
|
|
|
+>>> pprint(r)
|
|
|
+{\*(AqenabledFeatures\*(Aq: [\*(AqAsync DNS\*(Aq,
|
|
|
+ \*(AqBitTorrent\*(Aq,
|
|
|
+ \*(AqFirefox3 Cookie\*(Aq,
|
|
|
+ \*(AqGZip\*(Aq,
|
|
|
+ \*(AqHTTPS\*(Aq,
|
|
|
+ \*(AqMessage Digest\*(Aq,
|
|
|
+ \*(AqMetalink\*(Aq,
|
|
|
+ \*(AqXML\-RPC\*(Aq],
|
|
|
+ \*(Aqversion\*(Aq: \*(Aq1\&.11\&.0\*(Aq}
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.getSessionInfo ()\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод возвращает информацию о сессии\&. Ответ имеет тип структура и
|
|
|
+содежит следующие поля\&.
|
|
|
+.PP
|
|
|
+sessionId
|
|
|
+.RS 4
|
|
|
+ID сессии, которое генерируется каждый раз, при запуске aria2\&.
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import urllib2, json
|
|
|
+>>> from pprint import pprint
|
|
|
+>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.getSessionInfo\*(Aq})
|
|
|
+>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq)
|
|
|
+>>> pprint(json\&.loads(c\&.read()))
|
|
|
+{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq,
|
|
|
+ u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq,
|
|
|
+ u\*(Aqresult\*(Aq: {u\*(AqsessionId\*(Aq: u\*(Aqcd6a3bc6a1de28eb5bfa181e5f6b916d44af31a9\*(Aq}}
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import xmlrpclib
|
|
|
+>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq)
|
|
|
+>>> s\&.aria2\&.getSessionInfo()
|
|
|
+{\*(AqsessionId\*(Aq: \*(Aqcd6a3bc6a1de28eb5bfa181e5f6b916d44af31a9\*(Aq}
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.shutdown ()\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод закрывает aria2\&. Метод возвращает "OK"\&.
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBaria2.forceShutdown ()\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод закрывает aria2\&. Метод действует подобно \fBaria2\&.shutdown\fP,
|
|
|
+за исключением того, что метод выполняется без каких\-либо действий, которые
|
|
|
+требует времени, связь с BitTorrent\-трекером пропускается\&.
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBsystem.multicall (methods)\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Этот метод объединяет несколько вызовов методов в один запрос\&. \fImethods\fP
|
|
|
+имеет тип массив, а элемент является структурой\&. Структура содержит два
|
|
|
+поля: "methodName" и "params"\&. "methodName" \- это имя вызываемого метода,
|
|
|
+а "params" \- содержит параметры к методу\&. Метод возвращает массив
|
|
|
+ответов\&. Элемент массива будет одним из двух: массивом из одного элемента,
|
|
|
+который содержит возвращаемое значение, для каждого вызываемого метода или
|
|
|
+структурой с ошибками в полях, если вызов объединенного метода завершился
|
|
|
+неудачно\&.
|
|
|
+.sp
|
|
|
+В следующем примере мы добавляем 2 загрузки\&. Первая \-
|
|
|
+http://example\&.org/file и вторая \- один \&.torrent\-файл:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import urllib2, json, base64
|
|
|
+>>> from pprint import pprint
|
|
|
+>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqsystem\&.multicall\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqparams\*(Aq:[[{\*(AqmethodName\*(Aq:\*(Aqaria2\&.addUri\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqparams\*(Aq:[[\*(Aqhttp://example\&.org\*(Aq]]},
|
|
|
+\&.\&.\&. {\*(AqmethodName\*(Aq:\*(Aqaria2\&.addTorrent\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqparams\*(Aq:[base64\&.b64encode(open(\*(Aqfile\&.torrent\*(Aq)\&.read())]}]]})
|
|
|
+>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq)
|
|
|
+>>> pprint(json\&.loads(c\&.read()))
|
|
|
+{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: [[u\*(Aq1\*(Aq], [u\*(Aq2\*(Aq]]}
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+JSON\-RPC также поддерживает пакетный запрос, который описывается в
|
|
|
+спецификации JSON\-RPC 2\&.0:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> jsonreq = json\&.dumps([{\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.addUri\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqparams\*(Aq:[[\*(Aqhttp://example\&.org\*(Aq]]},
|
|
|
+\&.\&.\&. {\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqasdf\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.addTorrent\*(Aq,
|
|
|
+\&.\&.\&. \*(Aqparams\*(Aq:[base64\&.b64encode(open(\*(Aqfile\&.torrent\*(Aq)\&.read())]}])
|
|
|
+>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq)
|
|
|
+>>> pprint(json\&.loads(c\&.read()))
|
|
|
+[{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: u\*(Aq1\*(Aq},
|
|
|
+ {u\*(Aqid\*(Aq: u\*(Aqasdf\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: u\*(Aq2\*(Aq}]
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+В следующем примере мы добавляем 2 загрузки\&. Первая \-
|
|
|
+http://example\&.org/file и вторая \- один \&.torrent\-файл:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import xmlrpclib
|
|
|
+>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq)
|
|
|
+>>> mc = xmlrpclib\&.MultiCall(s)
|
|
|
+>>> mc\&.aria2\&.addUri([\*(Aqhttp://example\&.org/file\*(Aq])
|
|
|
+>>> mc\&.aria2\&.addTorrent(xmlrpclib\&.Binary(open(\*(Aqfile\&.torrent\*(Aq)\&.read()))
|
|
|
+>>> r = mc()
|
|
|
+>>> tuple(r)
|
|
|
+(\*(Aq2\*(Aq, \*(Aq3\*(Aq)
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.SS "Обработка ошибок"
|
|
|
+.sp
|
|
|
+В JSON\-RPC, aria2 возвращает JSON\-объект, который содержит код ошибки в коде
|
|
|
+и сообщение об ошибке в сообщении\&.
|
|
|
+.sp
|
|
|
+В XML\-RPC, aria2 возвращает faultCode=1 и сообщение об ошибке в
|
|
|
+faultString\&.
|
|
|
+.SS Параметры
|
|
|
+.sp
|
|
|
+Те же параметры, что доступны для \fB\-i\fP\&. Смотрите подраздел \fBInput File\fP
|
|
|
+для полного списка параметров\&.
|
|
|
+.sp
|
|
|
+В структуре, имя элемента \- это имя параметра (без "\-\-"), а значение
|
|
|
+элемента \- аргумент в виде строки\&.
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПример JSON\-RPC\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+{\*(Aqsplit\*(Aq:\*(Aq1\*(Aq, \*(Aqhttp\-proxy\*(Aq:\*(Aqhttp://proxy/\*(Aq}
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПример XML\-RPC\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+<struct>
|
|
|
+ <member>
|
|
|
+ <name>split</name>
|
|
|
+ <value><string>1</string></value>
|
|
|
+ </member>
|
|
|
+ <member>
|
|
|
+ <name>http\-proxy</name>
|
|
|
+ <value><string>http://proxy/</string></value>
|
|
|
+ </member>
|
|
|
+</struct>
|
|
|
+.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
|
|
|
+<struct>
|
|
|
+ <member>
|
|
|
+ <name>header</name>
|
|
|
+ <value>
|
|
|
+ <array>
|
|
|
+ <data>
|
|
|
+ <value><string>Accept\-Language: ja</string></value>
|
|
|
+ <value><string>Accept\-Charset: utf\-8</string></value>
|
|
|
+ </data>
|
|
|
+ </array>
|
|
|
+ </value>
|
|
|
+ </member>
|
|
|
+</struct>
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+Следующий пример добавляет загрузку с двумя параметрами: dir и
|
|
|
+header\&. Параметр header имеет 2 значения, поэтому используется список:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+>>> import xmlrpclib
|
|
|
+>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq)
|
|
|
+>>> opts = dict(dir=\*(Aq/tmp\*(Aq,
|
|
|
+\&.\&.\&. header=[\*(AqAccept\-Language: ja\*(Aq,
|
|
|
+\&.\&.\&. \*(AqAccept\-Charset: utf\-8\*(Aq])
|
|
|
+>>> s\&.aria2\&.addUri([\*(Aqhttp://example\&.org/file\*(Aq], opts)
|
|
|
+\*(Aq1\*(Aq
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.SS "JSON\-RPC используя HTTP GET"
|
|
|
+.sp
|
|
|
+JSON\-RPC\-интерфейс также поддерживает запрос через HTTP GET\&. Схема
|
|
|
+кодирования в GET параметров основанных на JSON\-RPC через HTTP, описана в
|
|
|
+спецификации (2008\-1\-15(RC1))\&. Кодирование параметров через GET следующие:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+/jsonrpc?method=METHOD_NAME&id=ID¶ms=BASE64_ENCODED_PARAMS
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+\fImethod\fP и \fIid\fP всегда обрабатывается как JSON\-строка и они должны быть в
|
|
|
+кодировке UTF\-8\&.
|
|
|
+.sp
|
|
|
+Например, закодированная строка aria2\&.tellStatus(\fI3\fP) с id=\fIfoo\fP
|
|
|
+выглядит так:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+/jsonrpc?method=aria2\&.tellStatus&id=foo¶ms=WyIzIl0%3D
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+Параметр \fIparams\fP \- это JSON\-массив в Base64\-кодировке, который обычно
|
|
|
+появляется в атрибуте \fIparams\fP в JSON\-RPC\-запросе объекта\&. В примере
|
|
|
+выше, params \- [\fI3\fP], следовательно:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+[\*(Aq3\*(Aq] \-\-(Base64)\-\-> WyIzIl0= \-\-(Percent Encode)\-\-> WyIzIl0%3D
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+JSON\-RPC\-интерфейс поддерживает JSONP\&. Вы можете определить функцию
|
|
|
+обратного вызова в параметре \fIjsoncallback\fP\&.
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+/jsonrpc?method=aria2\&.tellStatus&id=foo¶ms=WyIzIl0%3D&jsoncallback=cb
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+Для пакетного запроса, параметры \fImethod\fP и \fIid\fP не должны быть
|
|
|
+указаны\&. Полный запрос должен быть определен в параметре
|
|
|
+\fIparams\fP\&. Например, пакетный запрос
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+[{\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, \*(Aqmethod\*(Aq:\*(Aqaria2\&.getVersion\*(Aq},
|
|
|
+ {\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqasdf\*(Aq, \*(Aqmethod\*(Aq:\*(Aqaria2\&.tellActive\*(Aq}]
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+должен кодироваться так:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+/jsonrpc?params=W3sianNvbnJwYyI6ICIyLjAiLCAiaWQiOiAicXdlciIsICJtZXRob2QiOiAiYXJpYTIuZ2V0VmVyc2lvbiJ9LCB7Impzb25ycGMiOiAiMi4wIiwgImlkIjogImFzZGYiLCAibWV0aG9kIjogImFyaWEyLnRlbGxBY3RpdmUifV0%3D
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.SS "Пример кода клиента XML\-RPC"
|
|
|
+.sp
|
|
|
+Следующий Ruby\-скрипт добавляет \fIhttp://localhost/aria2\&.tar\&.bz2\fP и
|
|
|
+параметр \fB\-\-dir\fP=\fI/downloads\fP к aria2c, которая работает на localhost и
|
|
|
+отображает ответ\&.
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+#!/usr/bin/env ruby
|
|
|
+
|
|
|
+require \*(Aqxmlrpc/client\*(Aq
|
|
|
+require \*(Aqpp\*(Aq
|
|
|
+
|
|
|
+client=XMLRPC::Client\&.new2("http://localhost:6800/rpc")
|
|
|
+
|
|
|
+options={ "dir" => "/downloads" }
|
|
|
+result=client\&.call("aria2\&.addUri", [ "http://localhost/aria2\&.tar\&.bz2" ], options)
|
|
|
+
|
|
|
+pp result
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+Если вы любитель Python, то можете использовать xmlrpclib(для Python3\&.x,
|
|
|
+используйте взамен xmlrpc\&.client) для взаимодействия с aria2\&.
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+import xmlrpclib
|
|
|
+from pprint import pprint
|
|
|
+
|
|
|
+s = xmlrpclib\&.ServerProxy("http://localhost:6800/rpc")
|
|
|
+r = s\&.aria2\&.addUri(["http://localhost/aria2\&.tar\&.bz2"], {"dir":"/downloads"})
|
|
|
+pprint(r)
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.SH ПРИМЕРЫ
|
|
|
+.SS "Загрузка по HTTP/FTP"
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBЗагрузка файла\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c "http://host/file\&.zip"
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Для остановки загрузки, нажмите Ctrl\-C\&. Вы можете возобновить передачу,
|
|
|
+запустив aria2c с теми же аргументами в том же каталоге\&. Вы можете
|
|
|
+изменить URI, если они указывают на тот же самый файл\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBЗагрузка файла с 2\-ух разных HTTP\-серверов\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c "http://host/file\&.zip" "http://mirror/file\&.zip"
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBЗагрузка файла с одно хоста, используя 2 соединения\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-x2 \-k1M "http://host/file\&.zip"
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBЗагрузка файла с HTTP\- и FTP\-серверов\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c "http://host1/file\&.zip" "ftp://host2/file\&.zip"
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBОдновременная загрузка файлов, перечисленных в текстовом файле\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-ifiles\&.txt \-j2
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+параметр \-j указывает количество параллельных загрузок\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBИспользование прокси\-сервера\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Для HTTP:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-http\-proxy="http://proxy:8080" "http://host/file"
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-http\-proxy="http://proxy:8080" \-\-no\-proxy="localhost,127\&.0\&.0\&.1,192\&.168\&.0\&.0/16" "http://host/file"
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+Для FTP:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-ftp\-proxy="http://proxy:8080" "ftp://host/file"
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Смотрите для подробностей \fB\-\-http\-proxy\fP, \fB\-\-https\-proxy\fP, \fB\-\-ftp\-proxy\fP,
|
|
|
+\fB\-\-all\-proxy\fP и \fB\-\-no\-proxy\fP\&. Вы можете указать прокси в переменных
|
|
|
+окружения\&. Смотрите раздел \fBОКРУЖЕНИЕ\fP\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПрокси\-сервер с авторизацией\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-http\-proxy="http://username:password@proxy:8080" "http://host/file"
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-http\-proxy="http://proxy:8080" \-\-http\-proxy\-user="username" \-\-http\-proxy\-passwd="password" "http://host/file"
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.SS "Загрузка Metalink"
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBЗагрузка файлов с удалленного Metalink\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-follow\-metalink=mem "http://host/file\&.metalink"
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBЗагрузка, используя локальный metalink\-файл\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-p \-\-lowest\-speed\-limit=4000 file\&.metalink
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Для остановки загрузки, нажмите Ctrl\-C\&. Вы можете возобновить передачу,
|
|
|
+запустив aria2c с теми же аргументами в том же каталоге\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBЗагрузка нескольких локальных metalink\-файлов\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-j2 file1\&.metalink file2\&.metalink
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBЗагрузка только выбранных файлов, используя индекс\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-select\-file=1\-4,8 file\&.metalink
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Индекс выводится на консоль при использовании параметра \-S\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBЗагрузка файла, используя локальный .metalink\-файл с пользовательскими
|
|
|
+настройками\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-metalink\-location=jp,us \-\-metalink\-version=1\&.1 \-\-metalink\-language=en\-US file\&.metalink
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.SS "Загрузка BitTorrent"
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBЗагрузка файлов из удаленного BitTorrent\-файла\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-follow\-torrent=mem "http://host/file\&.torrent"
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBЗагрузка, используя локальный torrent\-файл\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-max\-upload\-limit=40K file\&.torrent
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+\-\-max\-upload\-limit определяет максимальную скорость отдачи\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Для остановки загрузки, нажмите Ctrl\-C\&. Вы можете возобновить передачу,
|
|
|
+запустив aria2c с теми же аргументами в том же каталоге\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBЗагрузка, используя BitTorrent Magnet URI\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c "magnet:?xt=urn:btih:248D0A1CD08284299DE78D5C1ED359BB46717D8C&dn=aria2"
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Не забывайте заключать BitTorrent Magnet URI, в которой есть символ "&", в
|
|
|
+одиночные(\*(Aq) или двойные(") кавычки\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBЗагрузка 2\-х торрентов\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-j2 file1\&.torrent file2\&.torrent
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBЗагрузка файла, используя торрент и HTTP/FTP\-сервер\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-Ttest\&.torrent "http://host1/file" "ftp://host2/file"
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Загрузка много файлового торрента через HTTP/FTP не поддерживается\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBЗагрузка только выбранных файлов, используя индекс (обычно называют
|
|
|
+"выборочная загрузка")\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-select\-file=1\-4,8 file\&.torrent
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Индекс выводится на консоль при использовании параметра \-S\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBУказание имени выходного файла\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Для указания выходного имени файла в BitTorrent\-загрузках, вам нужно узнать
|
|
|
+индекс файла в torrent\-файле, используя параметр \fB\-S\fP\&. Например,
|
|
|
+результат выглядит следующим образом:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+idx|path/length
|
|
|
+===+======================
|
|
|
+ 1|dist/base\-2\&.6\&.18\&.iso
|
|
|
+ |99\&.9MiB
|
|
|
+\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
|
|
|
+ 2|dist/driver\-2\&.6\&.18\&.iso
|
|
|
+ |169\&.0MiB
|
|
|
+\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+Сохраняет \fIdist/base\-2\&.6\&.18\&.iso\fP в \fI/tmp/mydir/base\&.iso\fP и
|
|
|
+\fIdist/driver\-2\&.6\&.18\&.iso\fP в \fI/tmp/dir/driver\&.iso\fP, при
|
|
|
+использовании следующей команды:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-dir=/tmp \-\-index\-out=1=mydir/base\&.iso \-\-index\-out=2=dir/driver\&.iso file\&.torrent
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBИзменение прослушиваемого порта для входящих соединений от пиров\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-listen\-port=7000\-7001,8000 file\&.torrent
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Т.к. aria2 не настраивает брандмауэр или маршрутизатор для перенаправления
|
|
|
+портов, вам решать как это сделать вручную\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBУказать условие остановки программы после завершения загрузки торрента\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-seed\-time=120 \-\-seed\-ratio=1\&.0 file\&.torrent
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+В приведенном выше примере, программа завершается через 120 минут после
|
|
|
+завершения загрузки или при достижении рейтинга сидирования 1\&.0\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBРегулировка скорости отдачи\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-max\-upload\-limit=100K file\&.torrent
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBВключить IPv4 DHT\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-enable\-dht \-\-dht\-listen\-port=6881 file\&.torrent
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+DHT использует udp\-порт\&. Так как aria2 не настраивает брандмауэр или
|
|
|
+маршрутизатор для перенаправления портов, вам решать как это сделать
|
|
|
+вручную\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBВключить IPv6 DHT\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-enable\-dht6 \-\-dht\-listen\-port=6881 \-\-dht\-listen\-addr6=YOUR_GLOBAL_UNICAST_IPV6_ADDR \-\-enable\-async\-dns6
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Если aria2c не собрана с c\-ares, то \fB\-\-enable\-async\-dns6\fP не нужен\&. aria2
|
|
|
+разделяет один и тот же порт между IPv4 и IPv6 DHT\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBДобавить и удалить URI трекера\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Удалить все URI анонса трекеров, описанных в \&.torrent\-файле и взамен
|
|
|
+использовать "http://tracker1/announce" и "http://tracker2/announce"\&.
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-bt\-exclude\-tracker="*" \-\-bt\-tracker="http://tracker1/announce,http://tracker2/announce" file\&.torrent
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.SS "Больше расширенных возможностей для HTTP"
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBЗагрузить куки\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-load\-cookies=cookies\&.txt "http://host/file\&.zip"
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Вы можите использовать без изменения cookie\-файл Firefox/Mozilla/Chromium\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBВозобновление загрузки, которая начата в браузере или другой программе\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-c \-s2 "http://host/partiallydownloadedfile\&.zip"
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBКлиентский сертификат авторизации для SSL/TLS\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-certificate=/path/to/mycert\&.pem \-\-private\-key=/path/to/mykey\&.pem https://host/file
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Указанный в \fB\-\-private\-key\fP файл должен быть расшифрован\&. Режим работы с
|
|
|
+исходно зашифрованным закрытым ключом не определен\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПроверить узел при SSL/TLS, используя исходные CA\-сертификаты\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-ca\-certificate=/path/to/ca\-certificates\&.crt \-\-check\-certificate https://host/file
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.SS "И еще больше расширенных возможностей"
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBРегулировка скорости загрузки\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-max\-download\-limit=100K file\&.metalink
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBИсправить поврежденную загрузку\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-V file\&.metalink
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Этот параметр доступен только при использовании BitTorrent или metalink с
|
|
|
+контрольными суммами блоков данных\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBОтклонить соединение, если скорость загрузки меньше чем определенное
|
|
|
+значение\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-lowest\-speed\-limit=10K file\&.metalink
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПоддержка параметризованных URI\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Вы можете определить набор частей:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-P "http://{host1,host2,host3}/file\&.iso"
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+Вы можете определить числовую последовательность:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-Z \-P "http://host/image[000\-100]\&.png"
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.sp
|
|
|
+.\}
|
|
|
+.RS 4
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПримечание\fP
|
|
|
+.ps -1
|
|
|
+.br
|
|
|
+.sp
|
|
|
+Параметр \-Z необходим, если все URI не указывают на один и тот же файл, как
|
|
|
+в примере указанном выше\&.
|
|
|
+.sp .5v
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+Вы можете определить шаг счетчика:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-Z \-P "http://host/image[A\-Z:2]\&.png"
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBПараллельные загрузки с произвольным числом URI,metalink,torrent\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-j3 \-Z "http://host/file1" file2\&.torrent file3\&.metalink
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.sp
|
|
|
+.it 1 an-trap
|
|
|
+.nr an-no-space-flag 1
|
|
|
+.nr an-break-flag 1
|
|
|
+.br
|
|
|
+.ps +1
|
|
|
+\fBШифрование BitTorrent\fP
|
|
|
+.RS 4
|
|
|
+.sp
|
|
|
+Шифровать всю полезную нагрузку используя ARC4:
|
|
|
+.sp
|
|
|
+.if n \{\
|
|
|
+.RS 4
|
|
|
+.\}
|
|
|
+.nf
|
|
|
+aria2c \-\-bt\-min\-crypto\-level=arc4 \-\-bt\-require\-crypto=true file\&.torrent
|
|
|
+.fi
|
|
|
+.if n \{\
|
|
|
+.RE
|
|
|
+.\}
|
|
|
+.RE
|
|
|
+.SH "СМОТРИТЕ ТАКЖЕ"
|
|
|
+.sp
|
|
|
+Веб\-сайт проекта: http://aria2\&.sourceforge\&.net/
|
|
|
+.sp
|
|
|
+Вики aria2: http://sourceforge\&.net/apps/trac/aria2/wiki
|
|
|
+.sp
|
|
|
+Домашняя страница Metalink: http://www\&.metalinker\&.org/
|
|
|
+.sp
|
|
|
+Описание формата Metalink: http://tools\&.ietf\&.org/html/rfc5854
|
|
|
+.SH "АВТОРСКОЕ ПРАВО"
|
|
|
+.sp
|
|
|
+Авторское право \(co 2006, 2011 Tatsuhiro Tsujikawa
|
|
|
+.sp
|
|
|
+Эта программа является свободным программным обеспечением; вы можете
|
|
|
+распространять его и/или изменять его в соответствии с условиями лицензии
|
|
|
+GNU General Public License, опубликованной Free Software Foundation; либо
|
|
|
+License версии 2, либо (по вашему выбору) любой более поздней версии\&.
|
|
|
+.sp
|
|
|
+Эта программа распространяется в надежде, что она будет полезной, но БЕЗ
|
|
|
+КАКИХ\-ЛИБО ГАРАНТИЙ, даже без подразумеваемых гарантий КОММЕРЧЕСКОЙ ЦЕННОСТИ
|
|
|
+или ПРИГОДНОСТИ ДЛЯ ОПРЕДЕЛЕННОЙ ЦЕЛИ\&. См. GNU General Public License для
|
|
|
+более подробной информации\&.
|
|
|
+.sp
|
|
|
+Вы должны получить копию GNU General Public License вместе с этой
|
|
|
+программой; если нет, напишите в Free Software Foundation, Inc\&., 51
|
|
|
+Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA
|
|
|
+.sp
|
|
|
+Кроме того, в качестве особого исключения, владельцы авторских прав дают
|
|
|
+разрешение на ссылку части кода этой программы с библиотекой OpenSSL при
|
|
|
+определенных условиях, как описано в каждом отдельном исходном файле, а
|
|
|
+также распространять эту комбинацию вместе\&. Вы должны подчиняться GNU
|
|
|
+General Public License во всех отношениях для всего используемого кода,
|
|
|
+кроме OpenSSL\&. Если вы измените файл(ы) с этим исключением, вы можете
|
|
|
+расширить это исключение для вашей версии файла(ов), но вы не обязаны делать
|
|
|
+это\&. Если вы не хотите сделать это, удалите это заявление об исключении из
|
|
|
+вашей версии\&. Если вы удалите это заявление об исключении из всех исходных
|
|
|
+файлов в программе, то удалить его и здесь\&.
|
|
|
+.SH АВТОР
|
|
|
+.PP
|
|
|
+\fBTatsuhiro Tsujikawa\fP <\&t\-tujikawa@users\&.sourceforge\&.net\&>
|
|
|
+.RS 4
|
|
|
+Автор.
|
|
|
+.RE
|
|
|
+
|
|
|
+.SH "АВТОР ПЕРЕВОДА"
|
|
|
+ITriskTI <ITriskTI@gmail.com>
|
|
|
+.SH "ПРИМЕЧАНИЕ
|
|
|
+Эта страница руководства может содержать не обязательно самую последнюю информацию. Если есть некоторые противоречия между этой страницей руководства и фактическим программным обеспечением, пожалуйста, обращайтесь к английской версии страницы руководства.
|