From b95f0928f74be7c3454b77d60008e324aa2b44ea Mon Sep 17 00:00:00 2001 From: Tatsuhiro Tsujikawa Date: Tue, 21 Jun 2011 21:38:34 +0900 Subject: [PATCH] Added Russian translation of man page contributed by ITriskTI. --- configure.ac | 3 +- doc/Makefile.am | 1 + doc/ru/Makefile.am | 4 + doc/ru/aria2c.1 | 6157 ++++++++++++++++++++++++++++++++++++++++++++ 4 files changed, 6164 insertions(+), 1 deletion(-) create mode 100644 doc/ru/Makefile.am create mode 100644 doc/ru/aria2c.1 diff --git a/configure.ac b/configure.ac index 97b31b0c..a030dc2c 100644 --- a/configure.ac +++ b/configure.ac @@ -502,7 +502,8 @@ AC_CONFIG_FILES([Makefile po/Makefile.in intl/Makefile lib/Makefile - doc/Makefile]) + doc/Makefile + doc/ru/Makefile]) AC_OUTPUT echo " " diff --git a/doc/Makefile.am b/doc/Makefile.am index bdc0dffe..72be15e5 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -1,3 +1,4 @@ +SUBDIRS = ru man_MANS = aria2c.1 EXTRA_DIST = $(man_MANS) dist_doc_DATA = aria2c.1.html aria2c.1.asciidoc diff --git a/doc/ru/Makefile.am b/doc/ru/Makefile.am new file mode 100644 index 00000000..372d292c --- /dev/null +++ b/doc/ru/Makefile.am @@ -0,0 +1,4 @@ +# Russian translation of man page. +mandir=@mandir@/ru +man_MANS = aria2c.1 +EXTRA_DIST = $(man_MANS) diff --git a/doc/ru/aria2c.1 b/doc/ru/aria2c.1 new file mode 100644 index 00000000..16e6c3aa --- /dev/null +++ b/doc/ru/aria2c.1 @@ -0,0 +1,6157 @@ +.\" t +.\" Title: aria2c +.\" Author: Tatsuhiro Tsujikawa +.\" Generator: DocBook XSL Stylesheets v1.75.2 +.\" Date: 05/21/2011 +.\" Manual: Aria2 Manual +.\" Source: Aria2 1.11.2 +.\" Language: English +.\" +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH ARIA2C 1 05/21/2011 "Aria2 1\&.11\&.2" "Руководство по Aria2" +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH НАЗВАНИЕ +aria2c \- Ультра быстрая утилита загрузки +.SH СИНТАКСИС +.sp +aria2c [\fIПАРАМЕТРЫ\fP] [\fIURI\fP | \fIMAGNET\-ССЫЛКА\fP | \fITORRENT\-ФАЙЛ\fP | +\fIMETALINK\-ФАЙЛ\fP]\&... +.SH ОПИСАНИЕ +.sp +aria2 \- это утилита для загрузки файлов\&. Поддерживаемые протоколы: +HTTP(S), FTP, BitTorrent и Metalink\&. Для загрузки файла, aria2 может +использовать разные источники/протоколы и пытается максимально использовать +пропускной способности канала\&. Есть поддержка загрузки файла по протоколам +HTTP(S)/FTP и BitTorrent одновременно, пока данные загружаются по +HTTP(S)/FTP, они тут же могут выгружаться в BitTorrent\-рой\&. Используя +контрольные суммы блока данных для Metalink, aria2 автоматически проверяет +куски данных, которые загружаются по BitTorrent\&. +.SH ПАРАМЕТРЫ +.SS "Основные параметры" +.PP +\fB\-d\fP, \fB\-\-dir\fP=DIR +.RS 4 +Каталог для сохранения скачанных файлов\&. +.RE +.PP +\fB\-i\fP, \fB\-\-input\-file\fP=FILE +.RS 4 +Загрузить URI, найденные в файле FILE\&. Вы можете указать несколько URI для +одного объекта: отделяйте URI на одной строке, используя символ +TAB\&. Читается ввод из stdin (стандартный поток ввода), когда указано +\fI\-\fP\&. Дополнительные параметры можно указывать после каждой строки с +URI\&. Эта необязательная строка должна начинаться с одного или нескольких +пробелов и содержать один параметр\&. Смотрите подраздел \fBВходной файл\fP для +детальных пояснений\&. +.RE +.PP +\fB\-l\fP, \fB\-\-log\fP=LOG +.RS 4 +Имя файла для журнала событий\&. Если указан \fI\-\fP (дефис), то журнал событий +будет записан в stdout (стандартный поток вывода).\& Если указана пустая +строка (""), то журнал событий не будет записан в файл\&. +.RE +.PP +\fB\-j\fP, \fB\-\-max\-concurrent\-downloads\fP=N +.RS 4 +Установить максимальное количество параллельных загрузок для каждого +статического (HTTP/FTP) URI, torrent и metalink\&. Смотрите также параметры +\fB\-s\fP и \fB\-C\fP\&. По умолчанию: \fI5\fP +.RE +.PP +\fB\-V\fP, \fB\-\-check\-integrity\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Проверить целостность файла путем подтверждения хэшей блоков или хэша +полного файла\&. Этот параметр влияет лишь на BitTorrent и Metalink загрузки +с контрольной суммой блоков. Параметр может обнаружить поврежденные части +файла и перезагрузить их\&. Если есть хэш полного файла, то проверка +выполняется только когда файл уже полностью загружен\&. Момент полной +загрузки определяется по размеру файла\&. Если проверка хэша завершилась +неудачно, то файл будет перезагружен с нуля\&. Если есть хэши блоков и хэш +полного файла, то будут использоваться только хэши блоков\&. По умолчанию: +\fIfalse\fP +.RE +.PP +\fB\-c\fP, \fB\-\-continue\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Продолжить загрузку частично загруженного файла\&. Используйте этот +параметр, чтобы возобновить загрузку, начатую в веб\-браузере или в другой +программе, которая загружает файлы последовательно сначала\&. Сейчас этот +параметр можно использовать только для HTTP(S)/FTP загрузок\&. По умолчанию: +\fIfalse\fP +.RE +.PP +\fB\-h\fP, \fB\-\-help\fP[=TAG|KEYWORD] +.RS 4 +Справочное сообщение определяется метками (TAG)\&. Метки начинаются с +"#"\&. Например, "\-\-help=#http" даст справку по параметрам, помеченным +меткой "#http"\&. Если задано слово (KEYWORD), не являющееся меткой, то +будет выведена справка по параметрам, содержащих это слово\&. Возможные +значения: \fI#basic\fP, \fI#advanced\fP, \fI#http\fP, \fI#https\fP, \fI#ftp\fP, +\fI#metalink\fP, \fI#bittorrent\fP, \fI#cookie\fP, \fI#hook\fP, \fI#file\fP, \fI#rpc\fP, +\fI#experimental\fP, \fI#all\fP По умолчанию: \fI#basic\fP +.RE +.SS "Параметры HTTP/FTP" +.PP +\fB\-\-all\-proxy\fP=PROXY +.RS 4 +Использовать указанный прокси\-сервер для всех протоколов\&. Для стирания +ранее определенного адрес используйте ""\&. Вы можете отменить эту +установку и указать прокси\-сервер для отдельного протокола, используя +параметры \fB\-\-http\-proxy\fP, \fB\-\-https\-proxy\fP и \fB\-\-ftp\-proxy\fP\&. Влияет на +все URI\&. Формат PROXY \- +[http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ]\&. Смотрите также раздел +\fBОКРУЖЕНИЕ\fP +.RE +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Если пользователь и пароль вставлены в URI\-прокси и они также указаны в +параметрах \fB\-\-{http,https,ftp,all}\-proxy\-{user,passwd}\fP, то приоритетным +будет самое последнее\&. Например, у вас http\-proxy\-user="myname", +http\-proxy\-passwd="mypass" в aria2\&.conf и вы указали +\-\-http\-proxy="http://proxy" в командной строке, тогда запрос к HTTP\-прокси +"http://proxy" будет с пользователем "myname" и паролем "mypass"\&. Другой +пример: если вы указали в командной строке +\-\-http\-proxy="http://user:pass@proxy" \-\-http\-proxy\-user="myname" +\-\-http\-proxy\-passwd="mypass", тогда запрос к HTTP\-прокси "http://proxy" +будет с пользователем "myname" и паролем "mypass"\&. Еще один пример: если +вы указали в командной строке \-\-http\-proxy\-user="myname" +\-\-http\-proxy\-passwd="mypass" \-\-http\-proxy="http://user:pass@proxy", тогда +запрос к HTTP\-прокси "http://proxy" будет с пользователем "user" и паролем +"pass"\&. +.sp .5v +.RE +.PP +\fB\-\-all\-proxy\-passwd\fP=PASSWD +.RS 4 +Задать пароль для параметра \fB\-\-all\-proxy\fP\&. +.RE +.PP +\fB\-\-all\-proxy\-user\fP=USER +.RS 4 +Задать пользователя для параметра \fB\-\-all\-proxy\fP\&. +.RE +.PP +\fB\-\-connect\-timeout\fP=SEC +.RS 4 +Задать в соединении время ожидания в секундах для установки подключения к +HTTP/FTP/прокси серверу\&. После установки подключения этот параметр не +имеет значения, и вместо него используется параметр \fB\-\-timeout\fP\&. По +умолчанию: \fI60\fP +.RE +.PP +\fB\-\-dry\-run\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Если задано \fItrue\fP, aria2 только проверяет, является ли удаленный файл +доступным и не загружает данные\&. Этот параметр влияет на HTTP/FTP +загрузку\&. BitTorrent загрузки отменяются, если указано \fItrue\fP. По +умолчанию: \fIfalse\fP +.RE +.PP +\fB\-\-lowest\-speed\-limit\fP=SPEED +.RS 4 +Закрывать подключение, если скорость загрузки меньше чем или равна значению +SPEED (байт в секунду)\&. 0 означает, что aria2 не имеет нижнего ограничения +скорости\&. Вы можете добавить \fIK\fP или \fIM\fP(1K = 1024, 1M = 1024K)\&. Этот +параметр не влияет на BitTorrent загрузки\&. По умолчанию: \fI0\fP +.RE +.PP +\fB\-x\fP, \fB\-\-max\-connection\-per\-server\fP=NUM +.RS 4 +Максимально количество соединений с одним сервером для каждой загрузки\&. По +умолчанию: \fI1\fP +.RE +.PP +\fB\-\-max\-file\-not\-found\fP=NUM +.RS 4 +Если aria2 получает статус "file not found" (файл не найден) с удаленных +HTTP/FTP серверов NUM раз без получения хотя бы одного байта, тогда +принудительно отказывается от загрузки. Укажите 0, чтобы отключить этот +параметр. Этот параметр действенен только, когда используются HTTP/FTP +серверы\&. По умолчанию: \fI0\fP +.RE +.PP +\fB\-m\fP, \fB\-\-max\-tries\fP=N +.RS 4 +Задать количество попыток\&. \fI0\fP означает неограниченно. Смотрите также +\fB\-\-retry\-wait\fP\&. По умолчанию: \fI5\fP +.RE +.PP +\fB\-k\fP, \fB\-\-min\-split\-size\fP=SIZE +.RS 4 +aria2 не разбивает на части меньше чем 2*SIZE байт\&. Например, нужно +загрузить файл размером 20МиБ\&. Если SIZE задать 10M, то aria2 может +разбить файл на части в 2\-ух диапазонах [0\-10МиБ) и [10МиБ\-20МиБ) и +загрузить его используя 2 источника (если \fB\-\-split\fP >= 2, конечно +же)\&. Если SIZE задать 15M, т.к. 2*15M > 20MiB, aria2 не разобьет файл +на части и загрузит его используя 1 источник\&. Вы можете добавить \fIK\fP или +\fIM\fP(1K = 1024, 1M = 1024K)\&. Возможные значения: \fI1M\fP\-\fI1024M\fP По +умолчанию: \fI20M\fP +.RE +.PP +\fB\-n\fP, \fB\-\-no\-netrc\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Отключить поддержку netrc\&. Поддержка netrc по умолчанию включена\&. +.RE +.PP +\fB\-\-no\-proxy\fP=ДОМЕНЫ +.RS 4 +Укажите через запятую имена хостов, домены и сетевые адреса с CIDR\-блоком, +или без него, для которых не будет использоваться прокси\&. +.RE +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Для сетевых адресов с CIDR\-блоком (метод IP\-адресации, например +192.168.0.20/24), работают только IPv4 адреса\&. Текущая реализация не +разрешает имена хостов в URI для сравнения сетевых адресов указанных в +\fB\-\-no\-proxy\fP\&. Таким образом это эффективно только если в URI есть +IP\-адреса\&. +.sp .5v +.RE +.PP +\fB\-o\fP, \fB\-\-out\fP=FILE +.RS 4 +Сохранить загруженный файл под указанным именем\&. Если используется +параметр \fB\-Z\fP, то данный параметр игнорируется. +.RE +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +В Metalink или BitTorrent загрузках вы не можете указать имя файла\&. Имя +файла указывается здесь только когда используются URI и aria2 с командной +строкой без параметров \fB\-i\fP, \fB\-Z\fP\&. Например: aria2c \-o myfile\&.zip +"http://mirror1/file\&.zip" "http://mirror2/file\&.zip" +.sp .5v +.RE +.PP +\fB\-\-proxy\-method\fP=METHOD +.RS 4 +Задать метод для использования в прокси\-запросах\&. \fIMETHOD\fP один из двух: +\fIget\fP или \fItunnel\fP\&. HTTPS загрузки всегда используют \fItunnel\fP, не +обращая внимания на этот параметр\&. По умолчанию: \fIget\fP +.RE +.PP +\fB\-R\fP, \fB\-\-remote\-time\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Извлекать временную метку файла с удаленного HTTP/FTP сервера и, если это +доступно, применить ее к локальному файлу\&. По умолчанию: \fIfalse\fP +.RE +.PP +\fB\-\-reuse\-uri\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Повторно использовать уже использованные URI, если не осталось +неиспользованных URI\&. По умолчанию: \fItrue\fP +.RE +.PP +\fB\-\-retry\-wait\fP=SEC +.RS 4 +Задать в секундах интервал ожидания между повторными попытками\&. При SEC +> 0, если HTTP сервер возвращает ответ 503, aria2 будет снова пытаться +загрузить\&. По умолчанию: \fI0\fP +.RE +.PP +\fB\-\-server\-stat\-of\fP=FILE +.RS 4 +Указать имя файла, в который сохраняется профиль функционирования +сервера\&. Вы можете загрузить сохраненные данные, используя параметр +\fB\-\-server\-stat\-if\fP\&. Формат файла смотрите ниже в подразделе \fBПрофиль +функционирования сервера\fP\&. +.RE +.PP +\fB\-\-server\-stat\-if\fP=FILE +.RS 4 +Указать имя файла для загрузки профиля функционирования сервера. Загруженные +данные будут использованы в некоторых URI селекторах, таких как +\fIfeedback\fP. Смотрите также параметр \fB\-\-uri\-selector\fP\&. Формат файла +смотрите ниже в подразделе \fBПрофиль функционирования сервера\fP\&. +.RE +.PP +\fB\-\-server\-stat\-timeout\fP=SEC +.RS 4 +Указывает время ожидания в секундах, для того, чтобы сделать +недействительным профиль функционирования сервера, с тех пор, как состоялся +последний контакт с ним\&. По умолчанию: \fI86400\fP (24 часа) +.RE +.PP +\fB\-s\fP, \fB\-\-split\fP=N +.RS 4 +Загружать файл, используя N соединений\&. Если задано более чем N URI, будут +использоваться первые N URI, а оставшиеся URI будут в резерве\&. Если задано +менее чем N URI, то URI будут использованы более одного раза, так чтобы были +задействованы все N соединений одновременно\&. Количество соединений к +одному и тому же хосту ограничивается параметром +\fB\-\-max\-connection\-per\-server\fP\&. Пожалуйста, смотрите также параметр \fB\-j\fP +и \fB\-\-min\-split\-size\fP\&. Обратите внимание, что для Metalink загрузок этот +параметр не эффективен, в место него используйте параметр \fB\-C\fP\&. По +умолчанию: \fI5\fP +.RE +.PP +\fB\-t\fP, \fB\-\-timeout\fP=SEC +.RS 4 +Задать время ожидания в секундах\&. По умолчанию: \fI60\fP +.RE +.PP +\fB\-\-uri\-selector\fP=SELECTOR +.RS 4 +Указать алгоритм выбора URI\&. Возможные значения: \fIinorder\fP, \fIfeedback\fP и +\fIadaptive\fP\&. Если задано \fIinorder\fP, то URI проверяются в порядке +представления в списке URI\&. Если задано \fIfeedback\fP, aria2 использует +скорость загрузки, которая наблюдалась в предыдущих загрузках, и выбирает +самый быстрый сервер в списке URI\&. Это также эффективно исключает мертвые +зеркала. Наблюдаемая скорость загрузки является частью профиля +функционирования сервера, упомянутой в параметрах \fB\-\-server\-stat\-of\fP и +\fB\-\-server\-stat\-if\fP\&. Если задано \fIadaptive\fP, выбирается одно из лучших +зеркал для первого и резервного соединений\&. Дополнительно, возвращаются +зеркала, которые пока не были проверены, и, если каждое из них уже +проверено, возвращаются зеркала, которые должны быть проверены +снова\&. Иначе зеркала больше не выбираются.\& Подобно \fIfeedback\fP, +используются профиль функционирования сервера\&. По умолчанию: \fIfeedback\fP +.RE +.SS "Специфические параметры HTTP" +.PP +\fB\-\-ca\-certificate\fP=FILE +.RS 4 +Использовать сертификат авторизации в FILE для проверки узлов\&. Сертификат +должен быть в PEM\-формате и содержать многоразовые +CA\-сертификаты\&. Используйте параметр \fB\-\-check\-certificate\fP, чтобы +разрешить проверку\&. +.RE +.PP +\fB\-\-certificate\fP=FILE +.RS 4 +Использовать клиентский сертификат в FILE\&. Сертификат должен быть в +PEM\-формате\&. Вы можете использовать параметр \fB\-\-private\-key\fP, чтобы +указать закрытый ключ\&. +.RE +.PP +\fB\-\-check\-certificate\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Проверять каждый из используемых сертификатов, которые указаны в параметре +\fB\-\-ca\-certificate\fP\&. По умолчанию: \fItrue\fP +.RE +.PP +\fB\-\-http\-accept\-gzip\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Посылать "Accept: deflate, gzip" в запросе\-заголовке и добавлять в ответ, +если удаленный сервер ответит "Content\-Encoding: gzip" или +"Content\-Encoding: deflate"\&. По умолчанию: \fIfalse\fP +.RE +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Некоторые серверы отвечают "Content\-Encoding: gzip" для файлов, которые сами +по себе сжаты (gzipped)\&. aria2 добавляет их так или иначе из\-за заголовка +ответа\&. +.sp .5v +.RE +.PP +\fB\-\-http\-auth\-challenge\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Отправлять заголовок HTTP авторизации только тогда, когда он запрошен с +сервера\&. Если задано \fIfalse\fP, тогда заголовок авторизации всегда +отправляется на сервер\&. Существует исключение: если имя пользователя и +пароль являются встроенными в URI, то заголовок авторизации всегда +отправляется на сервер, независимо от этого параметра\&. По умолчанию: +\fIfalse\fP +.RE +.PP +\fB\-\-http\-no\-cache\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Посылать заголовок Cache\-Control: no\-cache и Pragma: no\-cache, чтобы +избежать кэширования содержимого\&. Если задано \fIfalse\fP, то эти заголовки +не посылаются и вы можете добавить любую директиву к заголовку Cache\-Control +с помощью параметра \fB\-\-header\fP\&. По умолчанию: \fItrue\fP +.RE +.PP +\fB\-\-http\-user\fP=USER +.RS 4 +Задать пользователя для HTTP\&. Влияет на все URI\&. +.RE +.PP +\fB\-\-http\-passwd\fP=PASSWD +.RS 4 +Задать пароль для HTTP\&. Влияет на все URI\&. +.RE +.PP +\fB\-\-http\-proxy\fP=PROXY +.RS 4 +Использовать указанный прокси\-сервер для HTTP\&. Ранее указанный адрес можно +стереть, указав ""\&. Смотрите также параметр \fB\-\-all\-proxy\fP\&. Влияет на +все URI\&. Формат PROXY \- [http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ]\&. +.RE +.PP +\fB\-\-http\-proxy\-passwd\fP=PASSWD +.RS 4 +Задать пароль для параметра \fB\-\-http\-proxy\fP\&. +.RE +.PP +\fB\-\-http\-proxy\-user\fP=USER +.RS 4 +Задать пользователя для параметра \fB\-\-http\-proxy\fP\&. +.RE +.PP +\fB\-\-https\-proxy\fP=PROXY +.RS 4 +Использовать указанный прокси\-сервер для HTTPS\&. Ранее указанный адрес +можно стереть, указав ""\&. Смотрите также параметр \fB\-\-all\-proxy\fP\&. Влияет +на все URI\&. Формат PROXY \- [http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ]\&. +.RE +.PP +\fB\-\-https\-proxy\-passwd\fP=PASSWD +.RS 4 +Задать пароль для параметра \fB\-\-https\-proxy\fP\&. +.RE +.PP +\fB\-\-https\-proxy\-user\fP=USER +.RS 4 +Задать пользователя для параметра \fB\-\-https\-proxy\fP\&. +.RE +.PP +\fB\-\-private\-key\fP=FILE +.RS 4 +Использовать закрытый ключ в FILE\&. Закрытый ключ должен быть дешифрованным +и в PEM\-формате\&. Режим работы с исходно зашифрованным закрытым ключом не +определен\&. Смотрите также параметр \fB\-\-certificate\fP\&. +.RE +.PP +\fB\-\-referer\fP=REFERER +.RS 4 +Задать источника запроса\&. Влияет на все URI\&. +.RE +.PP +\fB\-\-enable\-http\-keep\-alive\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Включить HTTP/1\&.1 постоянное соединение\&. По умолчанию: \fItrue\fP +.RE +.PP +\fB\-\-enable\-http\-pipelining\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Включить конвейерную обработку HTTP/1\&.1\&. По умолчанию: \fIfalse\fP +.RE +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +С точки зрения производительности, как правило, нет преимущества от +включения этого параметра\&. +.sp .5v +.RE +.PP +\fB\-\-header\fP=HEADER +.RS 4 +Добавлять HEADER к HTTP запросу\-заголовку\&. Вы можете использовать этот +параметр повторно, чтоб указать более одного заголовка: aria2c +\fB\-\-header\fP="X\-A: b78" \fB\-\-header\fP="X\-B: 9J1" "http://host/file" +.RE +.PP +\fB\-\-load\-cookies\fP=FILE +.RS 4 +Загружать куки\-файл из FILE, используя форматы Firefox3 (SQLite3), +Chromium/Google Chrome (SQLite3) и Mozilla/Firefox(1\&.x/2\&.x)/Netscape\&. +.RE +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Если aria2 собрана без libsqlite3, то форматы куки\-файлов Firefox3 и +Chromium/Google Chrome не поддерживаются\&. +.sp .5v +.RE +.PP +\fB\-\-save\-cookies\fP=FILE +.RS 4 +Сохранить куки в FILE формате Mozilla/Firefox(1\&.x/2\&.x)/Netscape\&. Если +FILE уже существует, то он будет перезаписан\&. Куки\-сессия также сохранится +и значение ее окончания будет трактоваться как 0\&. Возможные значения: +\fI/путь/к/файлу\fP +.RE +.PP +\fB\-\-use\-head\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Использовать метод HEAD для первого запроса к HTTP серверу\&. По умолчанию: +\fIfalse\fP +.RE +.PP +\fB\-U\fP, \fB\-\-user\-agent\fP=USER_AGENT +.RS 4 +Задать клиентское приложение для HTTP(S) загрузок\&. По умолчанию: +\fIaria2/$VERSION\fP, $VERSION заменяется на версию пакета\&. +.RE +.SS "Специфические параметры FTP" +.PP +\fB\-\-ftp\-user\fP=USER +.RS 4 +Задать пользователя для FTP\&. Влияет на все URI\&. По умолчанию: +\fIanonymous\fP +.RE +.PP +\fB\-\-ftp\-passwd\fP=PASSWD +.RS 4 +Задать пароль для FTP\&. Влияет на все URI\&. Если имя пользователя +встроено, но пароль отсутствует в URI, то aria2 пытается использовать пароль +из \&.netrc\&. Если пароль найден в \&.netrc, то он используется\&. Если +нет, используется пароль указанный в этом параметре\&. По умолчанию: +\fIARIA2USER@\fP +.RE +.PP +\fB\-p\fP, \fB\-\-ftp\-pasv\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Использовать пассивный режим FTP\&. Если задано \fIfalse\fP, то будет +использован активный режим\&. По умолчанию: \fItrue\fP +.RE +.PP +\fB\-\-ftp\-proxy\fP=PROXY +.RS 4 +Использовать указанный прокси\-сервер для FTP\&. Ранее указанный адрес можно +стереть, указав ""\&. Смотрите также параметр \fB\-\-all\-proxy\fP\&. Влияет на +все URI\&. Формат PROXY \- [http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ] +.RE +.PP +\fB\-\-ftp\-proxy\-passwd\fP=PASSWD +.RS 4 +Задать пароль для параметра \fB\-\-ftp\-proxy\fP\&. +.RE +.PP +\fB\-\-ftp\-proxy\-user\fP=USER +.RS 4 +Задать пользователя для параметра \fB\-\-ftp\-proxy\fP\&. +.RE +.PP +\fB\-\-ftp\-type\fP=TYPE +.RS 4 +Задать тип передачи для FTP\&. TYPE может быть один из двух: \fIbinary\fP или +\fIascii\fP\&. По умолчанию: \fIbinary\fP +.RE +.PP +\fB\-\-ftp\-reuse\-connection\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Повторно использовать FTP соединение\&. По умолчанию: \fItrue\fP +.RE +.SS "Параметры BitTorrent/Metalink" +.PP +\fB\-\-select\-file\fP=INDEX\&... +.RS 4 +Задать файл для загрузки по заданному индексу\&. Вы можете найти индекс +файла, используя параметр \fB\-\-show\-files\fP. Составной индекс можно указать, +используя ",", например: \fI3,6\fP\&. Вы можете также использовать "\-", чтобы +указать диапазон: \fI1\-5\fP\&. "," и "\-" могут быть использованы вместе: +\fI1\-5,8,9\fP\&. Когда используется с параметром \fB\-M\fP, индекс может сильно +зависеть от запроса (смотрите параметры \fB\-\-metalink\-\fP*)\&. +.RE +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +В много файловом торренте, смежные файлы, указанные в этом параметре также +могут быть загружены\&. Это не ошибка, а особенность утилиты\&. Одиночный +блок данных может включать несколько файлов или часть файла, и aria2 запишет +блок данных соответствующего файла\&. +.sp .5v +.RE +.PP +\fB\-S\fP, \fB\-\-show\-files\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Вывести список файлов из \&.torrent, \&.meta4 или \&.metalink и выйти. Для +файла \&.torrent будет выведена более детальная информация (информация по +хэшу, размер блока и др.)\&. +.RE +.SS "Специфические параметры BitTorrent" +.PP +\fB\-\-bt\-enable\-lpd\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Включить поиск локальных пиров\&. Если в torrent\-файле установлен приватный +признак, то aria2 не будет использовать эту возможность, даже если задано +\fItrue\fP\&. По умолчанию: \fIfalse\fP +.RE +.PP +\fB\-\-bt\-exclude\-tracker\fP=URI[,\&...] +.RS 4 +Разделенный запятыми список URI анонса BitTorrent\-трекера, которые будут +исключены\&. Вы можете использовать специальное значение "*", которое +соответствует всем URI, таким образом исключаются все URI анонса\&. При +указании "*" в оболочке командной строке, не забывайте, экранировать или +брать в кавычки. Смотрите также параметр \fB\-\-bt\-tracker\fP\&. +.RE +.PP +\fB\-\-bt\-external\-ip\fP=IPADDRESS +.RS 4 +Указать внешний IP\-адрес BitTorrent\-трекера для отчета\&. Не смотря на то, +что эта функция названа "external" ("внешний"), она может принимать любой +IP\-адрес\&. IPADDRESS должен быть числовым IP\-адресом\&. +.RE +.PP +\fB\-\-bt\-hash\-check\-seed\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Если задано \fItrue\fP, то после проверки хэша с использованием параметра +\fB\-\-check\-integrity\fP и когда файл загружен полностью, продолжается раздача +файла\&. Если вы хотите проверить файл и загрузить его только если он +поврежден или не загружен полностью, то задайте этот параметр как +\fIfalse\fP\&. Этот параметр влияет лишь на BitTorrent загрузки\&. По +умолчанию: \fItrue\fP +.RE +.PP +\fB\-\-bt\-lpd\-interface\fP=INTERFACE +.RS 4 +Использовать для поиска локальных пиров заданный интерфейс. Если этот +параметр не указан, используется интерфейс по умолчанию. Можно указать имя +интерфейса и IP\-адрес. Возможные значения: интерфейс, IP\-адрес +.RE +.PP +\fB\-\-bt\-max\-open\-files\fP=NUM +.RS 4 +Указать максимальное количество файлов для открытия в каждой BitTorrent +загрузке\&. По умолчанию: \fI100\fP +.RE +.PP +\fB\-\-bt\-max\-peers\fP=NUM +.RS 4 +Указать максимальное количество узлов для каждого торрента\&. \fI0\fP означает +неограниченно\&. Смотрите также параметр +\fB\-\-bt\-request\-peer\-speed\-limit\fP\&. По умолчанию: \fI55\fP +.RE +.PP +\fB\-\-bt\-metadata\-only\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Загрузить только метаданные\&. Файл(ы), описывающий метаданные не должен +быть загружен\&. Этот параметр эффективен только если используется +BitTorrent Magnet\-ссылка\&. Смотрите также параметр +\fB\-\-bt\-save\-metadata\fP\&. По умолчанию: \fIfalse\fP +.RE +.PP +\fB\-\-bt\-min\-crypto\-level\fP=\fIplain\fP|\fIarc4\fP +.RS 4 +Задать минимальный уровень метода шифрования\&. Если узел поддерживает +несколько методов шифрования, aria2 выбирает наименьший, который +удовлетворяет заданный уровень\&. По умолчанию: \fIplain\fP +.RE +.PP +\fB\-\-bt\-prioritize\-piece\fP=\fIhead\fP[=SIZE],\fItail\fP[=SIZE] +.RS 4 +Пытаться загрузить сначала первую и последнюю части каждого файла\&. Это +бывает полезно для предварительного просмотра файлов\&. Аргумент может +содержать 2 ключевых слова: \fIhead\fP и \fItail\fP\&. Для включения обоих, +необходимо разделить их запятой\&. Ключевые слова принимают один параметр, +SIZE\&. Например, если указано \fIhead\fP=SIZE, части, в пределах первых SIZE +байт каждого файла, получат повышенный приоритет\&. \fItail\fP=SIZE обозначает +диапазон из последних SIZE байт каждого файла\&. SIZE может включать букву +\fIK\fP или \fIM\fP для обозначения размера в килобайтах или мегабайтах, +соответственно (1K = 1024, 1M = 1024K)\&. Если SIZE пропущено, то будет +использовано по умолчанию значение: SIZE=1M\&. +.RE +.PP +\fB\-\-bt\-require\-crypto\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Если задано \fItrue\fP, aria2 не принимает и не устанавливает соединение с +унаследованныммм BitTorrent handshake\-сообщением (рукопожатие) (BitTorrent +протокол). Таким образом aria2 всегда использует обфускацию +handshake\-сообщения. По умолчанию: \fIfalse\fP +.RE +.PP +\fB\-\-bt\-request\-peer\-speed\-limit\fP=SPEED +.RS 4 +Если итоговая скорость загрузки каждого торрента ниже чем SPEED, aria2 +временно увеличивает количество узлов, пытаясь увеличить скорость +загрузки\&. Настройка этого параметра с выбранной вами скоростью загрузки +может, в некоторых случаях, увеличить вашу скорость загрузки\&. Вы можете +добавить \fIK\fP или \fIM\fP(1K = 1024, 1M = 1024K)\&. По умолчанию: \fI50K\fP +.RE +.PP +\fB\-\-bt\-save\-metadata\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Сохранить метаданные как файл \&.torrent\&. Этот параметр эффективен только +если используется BitTorrent Magnet\-ссылка\&. Имя файла шестнадцатеричное +представление хэша с расширением \&.torrent\&. Файл сохранится в каталог, в +тот же самый, куда сохранится загружаемый файл\&. Если тот же самый файл уже +существует, метаданные не сохранятся\&. Смотрите также параметр +\fB\-\-bt\-metadata\-only\fP\&. По умолчанию: \fIfalse\fP +.RE +.PP +\fB\-\-bt\-seed\-unverified\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Раздавать первоначально загруженные файлы без проверки хэшей блоков\&. По +умолчанию: \fIfalse\fP +.RE +.PP +\fB\-\-bt\-stop\-timeout\fP=SEC +.RS 4 +Остановить BitTorrent загрузку, если скорость загрузки равна 0 на протяжении +SEC секунд. Если задано \fI0\fP, то эта возможность не будет использоваться. По +умолчанию: \fI0\fP +.RE +.PP +\fB\-\-bt\-tracker\fP=URI[,\&...] +.RS 4 +Разделенный запятыми список дополнительных URI анонса +BitTorrent\-трекеров\&. На эти URI не действует параметр +\fB\-\-bt\-exclude\-tracker\fP, потому что они добавляются после URI, указанных в +параметре \fB\-\-bt\-exclude\-tracker\fP, которые исключаются\&. +.RE +.PP +\fB\-\-bt\-tracker\-connect\-timeout\fP=SEC +.RS 4 +Задать время ожидания в секундах для установки соединения с +трекером\&. После установки соединения, это параметр станет не +действительным, а вместо него будет использован +\fB\-\-bt\-tracker\-timeout\fP\&. По умолчанию: \fI60\fP +.RE +.PP +\fB\-\-bt\-tracker\-interval\fP=SEC +.RS 4 +Задать интервал в секундах между запросами трекера\&. Это полностью отменяет +значение интервала и aria2 использует только это значение и игнорирует +минимальный интервал и значение интервала в ответе трекера\&. Если задан +\fI0\fP, aria2 определяет интервал основываясь на ответе трекера и прогрессе +загрузки\&. По умолчанию: \fI0\fP +.RE +.PP +\fB\-\-bt\-tracker\-timeout\fP=SEC +.RS 4 +Задать время ожидания в секундах\&. По умолчанию: \fI60\fP +.RE +.PP +\fB\-\-dht\-entry\-point\fP=HOST:PORT +.RS 4 +Задать хост и порт, как точку входа в IPv4 DHT сеть\&. +.RE +.PP +\fB\-\-dht\-entry\-point6\fP=ХОСТ:ПОРТ +.RS 4 +Задать хост и порт, как точку входа в IPv6 DHT сеть\&. +.RE +.PP +\fB\-\-dht\-file\-path\fP=PATH +.RS 4 +Заменять файл таблицы маршрутизации IPv4 DHT на PATH\&. По умолчанию: +\fI$HOME/\&.aria2/dht\&.dat\fP +.RE +.PP +\fB\-\-dht\-file\-path6\fP=PATH +.RS 4 +Заменять файл таблицы маршрутизации IPv6 DHT на PATH\&. По умолчанию: +\fI$HOME/\&.aria2/dht\&.dat\fP +.RE +.PP +\fB\-\-dht\-listen\-addr6\fP=ADDR +.RS 4 +Указать адрес привязки сокета для IPv6 DHT\&. Он должен быть глобальным IPv6 +unicast\-адресом хоста\&. +.RE +.PP +\fB\-\-dht\-listen\-port\fP=PORT\&... +.RS 4 +Задать прослушиваемый UDP\-порт для обоих IPv4 и IPv6 DHT\&. Несколько портов +можно указать через ",", например: \fI6881,6885\fP\&. Вы так же можете +использовать "\-" что бы указать диапазон: \fI6881\-6999\fP\&. "," и "\-" могут +быть использованы вместе\&. По умолчанию: \fI6881\-6999\fP +.RE +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Удостоверьтесь, что указанные порты открыты для входящего UDP\-трафика\&. +.sp .5v +.RE +.PP +\fB\-\-dht\-message\-timeout\fP=SEC +.RS 4 +Задать время ожидания в секундах\&. По умолчанию: \fI10\fP +.RE +.PP +\fB\-\-enable\-dht\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Включить IPv4 DHT функциональность\&. Если в torrent\-файле задан приватный +признак, aria2 не будет использовать DHT для загрузки, даже если установлен +\fItrue\fP\&. По умолчанию: \fItrue\fP +.RE +.PP +\fB\-\-enable\-dht6\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Включить IPv6 DHT функциональность\&. Если в torrent\-файле задан приватный +признак, aria2 не будет использовать DHT для загрузки, даже если установлен +\fItrue\fP\&. Используйте параметр \fB\-\-dht\-listen\-port\fP для указания +прослушиваемого порта\&. Смотрите также параметр \fB\-\-dht\-listen\-addr6\fP\&. +.RE +.PP +\fB\-\-enable\-peer\-exchange\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Включить расширение BitTorrent\-протокола для обмена списками +участников\&. Если в torrent\-файле задан приватный признак, то эта +возможность будет отключена, даже если установлен \fItrue\fP\&. По умолчанию: +\fItrue\fP +.RE +.PP +\fB\-\-follow\-torrent\fP=\fItrue\fP|\fIfalse\fP|\fImem\fP +.RS 4 +Если указать \fItrue\fP или \fImem\fP, тогда загруженный файл, расширение которого +\- "\&.torrent" или mime\-тип \- "application/x\-bittorrent", aria2 анализирует +как torrent\-файл и загружает файлы указанные в нем\&. Если указано \fImem\fP, +тогда torrent\-файл не записывается на диск, а содержится в памяти\&. Если +указано \fIfalse\fP, действия, упомянутые выше не совершаются\&. По умолчанию: +\fItrue\fP +.RE +.PP +\fB\-O\fP, \fB\-\-index\-out\fP=INDEX=PATH +.RS 4 +Задать путь к файлу с индексом=INDEX\&. Вы можете найти индекс файла +используя параметр \fB\-\-show\-files\fP\&. PATH является относительным путем к +тому, который указан в параметре \fB\-\-dir\fP\&. Вы можете использовать этот +параметр много раз\&. Используйте этот параметр, когда хотите указать имена +выходных файлов для BitTorrent\-загрузок\&. +.RE +.PP +\fB\-\-listen\-port\fP=PORT\&... +.RS 4 +Указать номер TCP\-порта для BitTorrent\-загрузок. Несколько портов можно +указать используя ",", например: \fI6881,6885\fP\&. Вы также можете +использовать "\-", чтоб указать диапазон: \fI6881\-6999\fP\&. "," и "\-" могут +быть использованы вместе: \fI6881\-6889,6999\fP\&. По умолчанию: \fI6881\-6999\fP +.RE +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Удостоверьтесь, что указанные порты открыты для входящего TCP\-трафика\&. +.sp .5v +.RE +.PP +\fB\-\-max\-overall\-upload\-limit\fP=SPEED +.RS 4 +Задать максимальную общую скорость отдачи в байтах/сек\&. \fI0\fP значит +неограничено\&. Вы можете добавить \fIK\fP или \fIM\fP(1K = 1024, 1M = +1024K)\&. Чтобы ограничить скорость отдачи для узла торрента, используйте +параметр \fB\-\-max\-upload\-limit\fP\&. По умолчанию: \fI0\fP +.RE +.PP +\fB\-u\fP, \fB\-\-max\-upload\-limit\fP=SPEED +.RS 4 +Задать максимальную скорость отдачи каждого узла торрента в +байтах/сек\&. \fI0\fP значит неограниченно\&. Вы можете добавить \fIK\fP или +\fIM\fP(1K = 1024, 1M = 1024K)\&. Чтобы ограничить общую скорость отдачи, +используйте параметр \fB\-\-max\-overall\-upload\-limit\fP\&. По умолчанию: \fI0\fP +.RE +.PP +\fB\-\-peer\-id\-prefix\fP=PEER_ID_PREFIX +.RS 4 +Указать префикс для ID узла\&. ID узла в BitTorrent имеет размер 20 +байт\&. Если будет указано более 20 байт, то только первые 20 будут +использоваться, если будет указано меньше 20, то они будут дополнены +случайными данными до 20 байт\&. По умолчанию: \fIaria2/$VERSION\fP, $VERSION +заменяется на версию пакета\&. +.RE +.PP +\fB\-\-seed\-ratio\fP=RATIO +.RS 4 +Указать рейтинг\&. Сидировать завершенные торренты, пока рейтинг не станет +больше RATIO\&. Очень рекомендуется указать тут равный или больший +\fI1\&.0\fP\&. Указать \fI0\&.0\fP, если вы планируете сидировать независимо от +рейтинга\&. Если указан параметр \fB\-\-seed\-time\fP вместе с этим параметром, +сидирование закончится тогда, когда хотя бы одно условие будет +удовлетворено\&. +.RE +.PP +\fB\-\-seed\-time\fP=MINUTES +.RS 4 +Указать время сидирования (раздачи) в минутах. Смотрите также параметр +\fB\-\-seed\-ratio\fP\&. +.RE +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Указаный \fB\-\-seed\-time\fP=\fI0\fP отключает сидирование после завершения +загрузки\&. +.sp .5v +.RE +.PP +\fB\-T\fP, \fB\-\-torrent\-file\fP=TORRENT\-ФАЙЛ +.RS 4 +Путь к файлу \&.torrent\&. Вы не обязаны использовать этот параметр, +т\&.к\&. файл \&.torrent можно указать без \fB\-T\fP\&. +.RE +.SS "Специфические параметры Metalink" +.PP +\fB\-\-follow\-metalink\fP=\fItrue\fP|\fIfalse\fP|\fImem\fP +.RS 4 +Если указано \fItrue\fP или \fImem\fP и когда загруженный файл имеет расширение +"\&.meta4" или "\&.metalink", или mime\-тип "application/metalink4+xml" или +"application/metalink+xml", aria2 считает его metalink\-файлом и загружает +упомянутые в нем файлы.\& Если указано \fImem\fP, то metalink\-файл не +сохраняется на диск, а просто хранится в памяти\&. Если указано \fIfalse\fP, то +вышеприведенная операция не производится\&. По умолчанию: \fItrue\fP +.RE +.PP +\fB\-\-metalink\-base\-uri\fP=URI +.RS 4 +Указать основной URI для разрешения относительных URI в элементе +metalink:url и metalink:metaurl в metalink\-файле, сохраненном на локальном +диске\&. Если URI указывает на каталог, то URI должен заканчиваться на +\fI/\fP\&. +.RE +.PP +\fB\-M\fP, \fB\-\-metalink\-file\fP=METALINK\-ФАЙЛ +.RS 4 +Путь к файлу \&.meta4 и \&.metalink\&. Читает ввод из stdin, если в качестве +имени файла указано \fI\-\fP\&. Вы не обязаны использовать этот параметр, +т\&.к\&. файлы \&.metalink можно указать без \fB\-M\fP\&. +.RE +.PP +\fB\-C\fP, \fB\-\-metalink\-servers\fP=NUM_SERVERS +.RS 4 +Количество серверов для одновременного подключения\&. Некоторые Metalink +регулируют количество серверов для соединения\&. aria2 точно придерживается +их\&. Это значит, что если Metalink определяет атрибут maxconnections ниже +чем NUM_SERVERS, тогда aria2 использует значение атрибута maxconnections +вместо NUM_SERVERS\&. Смотрите также параметры \fB\-s\fP и \fB\-j\fP\&. По +умолчанию: \fI5\fP +.RE +.PP +\fB\-\-metalink\-language\fP=LANGUAGE +.RS 4 +The language of the file to download\&. +.RE +.PP +\fB\-\-metalink\-location\fP=LOCATION[,\&...] +.RS 4 +Местонахождение предпочитаемого сервера\&. Список, разделенный запятыми, +допустимых местонахождений, например, \fIjp,us\fP\&. +.RE +.PP +\fB\-\-metalink\-os\fP=OS +.RS 4 +Целевая операционная система файла для загрузки\&. +.RE +.PP +\fB\-\-metalink\-version\fP=VERSION +.RS 4 +The version of the file to download\&. +.RE +.PP +\fB\-\-metalink\-preferred\-protocol\fP=PROTO +.RS 4 +Указать предпочитаемый протокол\&. Возможные значения: \fIhttp\fP, \fIhttps\fP, +\fIftp\fP и \fInone\fP\&. Указать \fInone\fP для отключения этой возможности\&. По +умолчанию: \fInone\fP +.RE +.PP +\fB\-\-metalink\-enable\-unique\-protocol\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Если задано \fItrue\fP, а в metalink\-файле доступно несколько протоколов, то +aria2 использует один из них\&. Используйте параметр +\fB\-\-metalink\-preferred\-protocol\fP, чтобы указать предпочитаемый протокол\&. +.RE +.SS "Параметры RPC" +.PP +\fB\-\-enable\-rpc\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Включить JSON\-RPC/XML\-RPC сервер\&. Настоятельно рекомендуется указать имя +пользователя и пароль, используя параметры \fB\-\-rpc\-user\fP и +\fB\-\-rpc\-passwd\fP\&. Смотрите также параметр \fB\-\-rpc\-listen\-port\fP\&. По +умолчанию: \fIfalse\fP +.RE +.PP +\fB\-\-rpc\-listen\-all\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Слушать входящие JSON\-RPC/XML\-RPC запросы на всех сетевых +интерфейсах\&. Если указано \fIfalse\fP, слушать только на локальном петлевом +интерфейсе (loopback)\&. По умолчанию: \fIfalse\fP +.RE +.PP +\fB\-\-rpc\-listen\-port\fP=PORT +.RS 4 +Указать номер порта, для прослушивания JSON\-RPC/XML\-RPC +сервером\&. Возможные значения: \fI1024\fP\-\fI65535\fP\&. По умолчанию: \fI6800\fP +.RE +.PP +\fB\-\-rpc\-max\-request\-size\fP=SIZE +.RS 4 +Задать максимальный размер JSON\-RPC/XML\-RPC\-запроса\&. Если aria2 выявит +запрос с размером большим, чем SIZE байт, тогда соединение будет +отклонено\&. По умолчанию: \fI2M\fP +.RE +.PP +\fB\-\-rpc\-passwd\fP=PASSWD +.RS 4 +Задать JSON\-RPC/XML\-RPC пароль\&. +.RE +.PP +\fB\-\-rpc\-user\fP=USER +.RS 4 +Задать JSON\-RPC/XML\-RPC пользователя\&. +.RE +.SS "Дополнительные параметры" +.PP +\fB\-\-allow\-overwrite\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Повторно запустить загрузку с нуля, если соответствующий контрольный файл +отсутствует\&. Смотрите также параметр \fB\-\-auto\-file\-renaming\fP\&. По +умолчанию: \fIfalse\fP +.RE +.PP +\fB\-\-allow\-piece\-length\-change\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Если задано \fIfalse\fP, aria2 останавливает загрузку, когда длина блока +отлична от той, которая находится в контрольном файле\&. Если задано +\fItrue\fP, вы можете продолжать, однако некоторый прогресс загрузки будет +потерян\&. По умолчанию: \fIfalse\fP +.RE +.PP +\fB\-\-always\-resume\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Всегда возобновлять загрузку\&. Если задано \fItrue\fP, aria2 всегда пытается +возобновить загрузку и если это не возможно, останавливает ее\&. Если задано +\fIfalse\fP, тогда для всех заданных URI не поддерживается возобновление +загрузки, или aria2 столкнется с невозможностью возобновления загрузки URI +\fIN\fP\-ое количество раз (значение \fIN\fP указывается в параметре +\fB\-\-max\-resume\-failure\-tries\fP), то aria2 будет загружать файл с +нуля\&. Смотрите параметр \fB\-\-max\-resume\-failure\-tries\fP\&. По умолчанию: +\fItrue\fP +.RE +.PP +\fB\-\-async\-dns\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Включить асинхронный DNS\&. По умолчанию: \fItrue\fP +.RE +.PP +\fB\-\-async\-dns\-server\fP=IPADDRESS[,\&...] +.RS 4 +Разделенный запятыми список адресов DNS\-серверов, которые используют +асинхронный DNS\-преобразователь\&. Обычно асинхронный DNS\-преобразователь +читает адреса DNS серверов из \fI/etc/resolv\&.conf\fP\&. Когда используется +этот параметр, то используются DNS\-серверы указанные в параметре вместо +указанных в \fI/etc/resolv\&.conf\fP\&. Вы можете указать оба IPv4 и IPv6 +адреса\&. Этот параметр полезен, когда в системе нет \fI/etc/resolv\&.conf\fP и +у пользователя нет прав на его создание\&. +.RE +.PP +\fB\-\-auto\-file\-renaming\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Переименовать файл, если такой уже существует\&. Этот параметр работает +только для HTTP(S)/FTP загрузок\&. К имени файла будет добавлена точка и +число от 1 до 9999\&. По умолчанию: \fItrue\fP +.RE +.PP +\fB\-\-auto\-save\-interval\fP=SEC +.RS 4 +Сохранять контрольный файл (*\&.aria2) каждые SEC секунд\&. Если задано +\fI0\fP, тогда контрольный файл не сохраняется на протяжении загрузки\&. aria2 +сохраняет контрольный файл тогда, когда останавливается, не смотря на +значение\&. Возможные значения: от \fI0\fP до \fI600\fP\&. По умолчанию: \fI60\fP +.RE +.PP +\fB\-\-conditional\-get\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Загружать файл только когда локальный файл старше чем удаленный\&. Эта +функция работает только для HTTP(S)\-загрузок\&. Это не работает, если размер +файла указан в Metalink\&. Это также игнорирует заголовок +Content\-Disposition\&. Если контрольный файл существует, то этот параметр +игнорируется\&. Эта функция использует заголовок If\-Modified\-Since, как +условие для получения только нового файла\&. При получении времени +модификации локального файла, используется указанное пользователем имя файла +(см. параметр \fB\-\-out\fP) или часть имени файла в URI, если \fB\-\-out\fP не +указан\&. Для перезаписи существующего файла необходим параметр +\fB\-\-allow\-overwrite\fP\&. По умолчанию: \fIfalse\fP +.RE +.PP +\fB\-\-conf\-path\fP=PATH +.RS 4 +Сменить путь к файлу конфигурации на PATH\&. По умолчанию: +\fI$HOME/\&.aria2/aria2\&.conf\fP +.RE +.PP +\fB\-D\fP, \fB\-\-daemon\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Запустить как демон (фоновый процесс)\&. Текущий рабочий каталог будет +заменен на \fI/\fP, а стандартный ввод, стандартный вывод, стандартный вывод +ошибок будут перенаправлены на \fI/dev/null\fP\&. По умолчанию: \fIfalse\fP +.RE +.PP +\fB\-\-disable\-ipv6\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Отключить IPv6\&. Это полезно, если вы используете поврежденный DNS и хотите +избежать ужасно медленного поиска AAAA\-записи\&. По умолчанию: \fIfalse\fP +.RE +.PP +\fB\-\-enable\-async\-dns6\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Включить IPv6 разрешение имен в асинхронном DNS\-преобразователе\&. Этот +параметр будет игнорироваться, если \fB\-\-async\-dns\fP=\fIfalse\fP\&. По умолчанию: +\fIfalse\fP +.RE +.PP +\fB\-\-enable\-direct\-io\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Включить прямое I/O (чтение/запись), которое уменьшает использование +микропроцессора во время резервирования места для файла\&. Выключите, если +произошла какая\-либо ошибка\&. По умолчанию: \fItrue\fP +.RE +.PP +\fB\-\-event\-poll\fP=POLL +.RS 4 +Указать метод опроса событий\&. Возможные значения: \fIepoll\fP, \fIkqueue\fP, +\fIport\fP, \fIpoll\fP и \fIselect\fP\&. Каждый метод \fIepoll\fP, \fIkqueue\fP, \fIport\fP и +\fIpoll\fP доступен, если система поддерживает его\&. \fIepoll\fP доступен в +современных дистрибутивах Linux\&. \fIkqueue\fP доступен в различных *BSD +системах, включая Mac OS X\&. \fIport\fP доступен в Open Solaris\&. Значение +по умолчанию может изменяться в зависимости от системы, которую вы +используете\&. +.RE +.PP +\fB\-\-file\-allocation\fP=METHOD +.RS 4 +Указать метод резервирования места для файла\&. \fInone\fP не происходит +предварительное резервирование места для файла\&. \fIprealloc\fP \- +предварительное резервирование места для файла перед началом загрузки\&. Это +может продолжаться некоторое время, в зависимости от размера файла\&. Если +вы используете новые файловые системы, наподобие ext4 (с поддержкой +экстентов), btrfs или xfs, тогда лучше выбрать \fIfalloc\fP\&. Так как они +резервируют место под большие (на несколько Гигабайт) файлы почти +мгновенно\&. Не используйте \fIfalloc\fP вместе с наследными файловыми +системами, такими как ext3 потому, что это будет продолжаться почти столько +же времени, как и \fIprealloc\fP, а также полностью заблокирует aria2, пока не +окончится резервирование места\&. \fIfalloc\fP может быть недоступным, если +ваша система не содержит функцию \fBposix_fallocate\fP()\&. Возможные значения: +\fInone\fP, \fIprealloc\fP, \fIfalloc\fP\&. По умолчанию: \fIprealloc\fP +.RE +.PP +\fB\-\-human\-readable\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Выводить на консоль размеры и скорость в удобочитаемом формате (например, +1\&.2Ки, 3\&.4Ми)\&. По умолчанию: \fItrue\fP +.RE +.PP +\fB\-\-interface\fP=INTERFACE +.RS 4 +Привязать сокеты к заданному интерфейсу\&. Вы можете указать имя интерфейса, +IP\-адрес и имя хоста\&. Возможные значения: имя интерфейса (например, eth0), +IP\-адрес (например, 192.168.0.12), имя хоста (например, myhost) +.RE +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Если интерфейс имеет несколько адресов, то настоятельно рекомендуется +указать IP\-адрес явно\&. Смотрите также \fB\-\-disable\-ipv6\fP\&. Если ваша +система не имеет getifaddrs(), это параметр не принимает имя интерфейса\&. +.sp .5v +.RE +.PP +\fB\-\-max\-download\-result\fP=NUM +.RS 4 +Задать максимальное количество результатов загрузок, которые находятся в +памяти\&. Результаты загрузок \- завершенные/ошибка/удаленные +загрузки\&. Результаты загрузок хранятся FIFO очереди, в которой может +хранится NUM результатов загрузок\&. Когда очередь заполнена и появляется +новый результат загрузки, то старейший результат загрузки удаляется из +начала очереди, а новый добавляется в конец\&. Указание большого числа в +этом параметре может привести к высокому потреблению памяти после тысяч +загрузок\&. Значение 0 отключит сохранение результата загрузки\&. По +умолчанию: \fI1000\fP +.RE +.PP +\fB\-\-max\-resume\-failure\-tries\fP=N +.RS 4 +Если параметр \fB\-\-always\-resume\fP=\fIfalse\fP, aria2 загрузит файл с нуля, при +обнаружении \fIN\fP\-го URI, не поддерживающего возобновление\&. Если \fIN\fP=\fI0\fP, +то aria2 загрузит файл с нуля, когда все URI не поддерживают +возобновление\&. Смотрите параметр \fB\-\-always\-resume\fP\&. По умолчанию: \fI0\fP +.RE +.PP +\fB\-\-log\-level\fP=LEVEL +.RS 4 +Задать уровень вывода журнала событий\&. LEVEL может быть: \fIdebug\fP, +\fIinfo\fP, \fInotice\fP, \fIwarn\fP или \fIerror\fP\&. По умолчанию: \fIdebug\fP +.RE +.PP +\fB\-\-on\-bt\-download\-complete\fP=COMMAND +.RS 4 +Для BitTorrent, в \fB\-\-on\-download\-complete\fP указывается команда, которая +вызывается после завершение загрузки и окончания сидирования\&. С другой +стороны, этот параметр определяет команду, которая будет выполнена после +завершения загрузки, но до сидирования\&. Смотрите раздел \fBПерехват +сообщения\fP для более подробной информации о COMMAND\&. Возможные значения: +\fI/путь/к/команде\fP +.RE +.PP +\fB\-\-on\-download\-complete\fP=COMMAND +.RS 4 +Задать команду, которая будет выполнена после завершения +загрузки\&. Смотрите раздел \fBПерехват сообщения\fP для более подробной +информации о COMMAND\&. Смотрите также параметр +\fB\-\-on\-download\-stop\fP\&. Возможные значения: \fI/путь/к/команде\fP +.RE +.PP +\fB\-\-on\-download\-error\fP=COMMAND +.RS 4 +Задать команду, которая будет выполнена после того, как загрузка будет +прервана из\-за ошибки\&. Смотрите раздел \fBПерехват сообщения\fP для более +подробной информации о COMMAND\&. Смотрите также параметр +\fB\-\-on\-download\-stop\fP\&. Возможные значения: \fI/путь/к/команде\fP +.RE +.PP +\fB\-\-on\-download\-pause\fP=COMMAND +.RS 4 +Задать команду, которая будет выполнена после того, как загрузка будет +приостановлена\&. Смотрите раздел \fBПерехват сообщения\fP для более подробной +информации о COMMAND\&. Возможные значения: \fI/путь/к/команде\fP +.RE +.PP +\fB\-\-on\-download\-start\fP=COMMAND +.RS 4 +Задать команду, которая будет выполнена после того, как началась +загрузка\&. Смотрите раздел \fBПерехват сообщения\fP для более подробной +информации о COMMAND\&. Возможные значения: \fI/путь/к/команде\fP +.RE +.PP +\fB\-\-on\-download\-stop\fP=COMMAND +.RS 4 +Задать команду, которая будет выполнена после того, как загрузка +остановлена\&. Вы можете изменить команду, которая будет выполнятся при +определенном результате загрузки, используя параметры +\fB\-\-on\-download\-complete\fP и \fB\-\-on\-download\-error\fP\&. Если они указаны, то +команда определенная в этом параметре не будет выполнятся\&. Смотрите раздел +\fBПерехват сообщения\fP для более подробной информации о COMMAND\&. Возможные +значения: \fI/путь/к/команде\fP +.RE +.PP +\fB\-\-show\-console\-readout\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Показывать консольный вывод\&. По умолчанию: \fItrue\fP +.RE +.PP +\fB\-\-summary\-interval\fP=SEC +.RS 4 +Задать интервал в секундах до вывода сообщения о прогрессе +загрузки\&. Установка \fI0\fP запрещает вывод\&. По умолчанию: \fI60\fP +.RE +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +В загрузках много файлового торрента, по определенным смежным файлам также, +которые размещены в части одного блока\&. +.sp .5v +.RE +.PP +\fB\-Z\fP, \fB\-\-force\-sequential\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Получить URI в последовательности командной строки и загрузить каждое URI в +отдельной сессии, как в обычных утилитах загрузки командной строки\&. По +умолчанию: \fIfalse\fP +.RE +.PP +\fB\-\-max\-overall\-download\-limit\fP=SPEED +.RS 4 +Задать максимальную общую скорость загрузки в байтах/сек\&. \fI0\fP значит +неограничено\&. Вы можете добавить \fIK\fP или \fIM\fP(1K = 1024, 1M = +1024K)\&. Чтобы ограничить скорость загрузки для узла, используйте параметр +\fB\-\-max\-download\-limit\fP\&. По умолчанию: \fI0\fP +.RE +.PP +\fB\-\-max\-download\-limit\fP=SPEED +.RS 4 +Установить максимальную скорость каждого узла загрузки в байтах/сек\&. \fI0\fP +значит неограниченно. Вы можете добавить \fIK\fP или \fIM\fP(1K = 1024, 1M = +1024K)\&. Чтобы ограничить общую скорость загрузки, используйте параметр +\fB\-\-max\-overall\-download\-limit\fP\&. По умолчанию: \fI0\fP +.RE +.PP +\fB\-\-no\-conf\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Отключить загрузку файла aria2\&.conf\&. +.RE +.PP +\fB\-\-no\-file\-allocation\-limit\fP=SIZE +.RS 4 +Не резервируется место для файлов, размер которых меньше SIZE. Вы можете +добавить \fIK\fP или \fIM\fP(1K = 1024, 1M = 1024K)\&. По умолчанию: \fI5M\fP +.RE +.PP +\fB\-P\fP, \fB\-\-parameterized\-uri\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Включить поддержку параметризованных URI\&. Вы можете указать набор частей: +\fIhttp://{sv1,sv2,sv3}/foo\&.iso\fP\&. Также вы можете указать числовую +последовательность с шагом счетчика: +\fIhttp://host/image[000\-100:2]\&.img\fP\&. Шагом счетчика можно +пренебречь\&. Если все URI не указывают на такой же файл, как во втором +приведенном выше примере, то необходим параметр \fB\-Z\fP. По умолчанию: +\fIfalse\fP +.RE +.PP +\fB\-q\fP, \fB\-\-quiet\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Сделать aria2 молчаливой (без консольного вывода)\&. По умолчанию: \fIfalse\fP +.RE +.PP +\fB\-\-realtime\-chunk\-checksum\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Подтверждать правильность блока данных путем вычисления контрольной суммы во +время загрузки файла, если предусмотрена контрольная сумма блоков\&. По +умолчанию: \fItrue\fP +.RE +.PP +\fB\-\-remove\-control\-file\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Удалять контрольный файл перед загрузкой\&. При использовании с +\fB\-\-allow\-overwrite\fP=\fItrue\fP файл всегда загружается с нуля\&. Это может +понадобиться пользователям за прокси\-сервером, не поддерживающим +возобновление загрузки\&. +.RE +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Для Metalink\-загрузок, \-C1 рекомендуется для прокси\-серверов, не +поддерживающих возобновление загрузки, во избежании создания лишних +соединений\&. +.sp .5v +.RE +.PP +\fB\-\-save\-session\fP=FILE +.RS 4 +Сохранять ошибочные/незаконченные загрузки в FILE при выходе\&. Вы можете +передать этот выходной файл aria2c с параметром \fB\-i\fP при +перезапуске\&. Обратите внимание, что загрузки добавленные через RPC\-методы +\fBaria2\&.addTorrent\fP, \fBaria2\&.addMetalink\fP и чьи метаданные не могут быть +сохранены как файл, не будут сохраняться\&. +.RE +.PP +\fB\-\-stop\fP=SEC +.RS 4 +Останавливать программу после того как пройдет SEC секунд\&. Если задано +\fI0\fP, эта возможность будет отключена\&. По умолчанию: \fI0\fP +.RE +.PP +\fB\-v\fP, \fB\-\-version\fP +.RS 4 +Вывести номер версии, информацию об авторских правах, конфигурации и +выйти\&. +.RE +.SS "Параметры, которые принимают аргументы" +.sp +Параметры, которые имеют значения в квадратных скобках ([]), могут принимать +дополнительные (необязательные) аргументы\&. Обычно отсутствие аргумента +эквивалентно \fItrue\fP\&. Если вы используется короткую форму параметров +(например, \fI\-V\fP) и указываете аргумент, то имя параметра и его аргумент +должны быть объедены (например, \fI\-Vfalse\fP)\&. Если будут вставлены пробелы +между именем параметра и аргументом, то аргумент будет обрабатываться как +URI, и это не то, что обычно вы ожидаете\&. +.SS "URI, MAGNET\-ССЫЛКА, TORRENT\-ФАЙЛ, METALINK\-ФАЙЛ" +.sp +Вы можете перечислить несколько URI в командной строке\&. Пока вы не указали +параметр \fB\-Z\fP, все URI должны указывать на один и тот же файл или загрузка +завершиться не удачно\&. +.sp +Вы можете указать произвольное количество BitTorrent Magnet URI\&. Обратите +внимание, что они всегда будут обрабатываться как отдельная +загрузка\&. Поддерживаются оба Info Hash (Информация о хэше), как +закодированный 40 шестнадцатеричными символами, так и закодированный 32 +символами Base32\-кодировки\&. Поддерживаются составные параметры +"tr"\&. Т.к. в BitTorrent Magnet URI возможно присутствие символа "&", то +настоятельно рекомендуется всегда заключать URI в одиночные(\*(Aq) или +двойные(") кавычки\&. Так же настоятельно рекомендуется включить DHT, +особенно когда параметр "tr" не указан\&. Смотрите +http://www\&.bittorrent\&.org/beps/bep_0009\&.html для детальной информации +по BitTorrent Magnet URI\&. +.sp +Вы также можете указать произвольное количество torrent\-файлов и +Metalink\-документов, которые хранятся на локальном диске\&. Обратите +внимание, что они всегда будут обрабатываться как отдельная +загрузка\&. Поддерживаются оба формата: Metalink4 и Metalink версии 3\&.0\&. +.sp +Вы можете указать вместе, torrent\-файл c параметром \fB\-T\fP и URI\&. Сделав +это, вы можете загружать файл используя torrent\-рой и HTTP(S)/FTP\-сервер +одновременно, пока данные из HTTP(S)/FTP выгружаются в torrent\-рой\&. Для +одно файловых торрентов, URI может быть завершенным, который указывает на +ресурс, или же если заканчиваться символом /, тогда name (имя) в +torrent\-файле будет добавлено\&. Для много файловых торентов, name (имя) и +path (путь) в torrent\-файле будут добавлены из URI для каждого файла\&. +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Удостоверьтесь, что URI заключен в одинарные(\*(Aq) или двойные(") кавычки, +если есть символ "&" или любые символы, которые имеют особое значение в +командной оболочке\&. +.sp .5v +.RE +.SS "Возобновление загрузки" +.sp +Обычно, вы можете возобновить передачу, только давая ту же самую команду +(aria2c URI), которая выполнялась при предыдущей передаче, созданной +aria2\&. +.sp +Если предыдущая передача создана веб\-браузером или wget\-подобным менеджером +загрузки, тогда используйте параметр \fB\-c\fP для продолжения передачи (aria2c +\fB\-c\fP URI)\&. +.SS "Перехват сообщения" +.sp +aria2 предоставляет параметры, в которых указываются произвольные команды, +выполняемые после наступления определенного события\&. В настоящие время +доступны следующие параметры: \fB\-\-on\-bt\-download\-complete\fP, +\fB\-\-on\-download\-pause\fP, \fB\-\-on\-download\-complete\fP\&. \fB\-\-on\-download\-start\fP, +\fB\-\-on\-download\-error\fP, \fB\-\-on\-download\-stop\fP\&. +.sp +aria2 передает 3 аргумента указанной команды, которая выполняется\&. Это +аргументы: GID, количество файлов и путь к файлу\&. Для HTTP\-, FTP\-загрузок, +обычно количество файлов \- 1\&. BitTorrent загрузка может содержать +множество файлов\&. Если число файлов больше чем один, то путь к файлу будет +для первого\&. Другими словами, это значение параметра path в первой +структуре, определенный параметр которой имеет значение true (истина), в +ответе RPC\-метода \fBaria2\&.getFiles\fP\&. Если вы хотите получить все пути к +файлам, то рассмотрите использование JSON\-RPC/XML\-RPC\&. Обратите внимание, +что путь к файлу может меняться в процессе загрузки по HTTP из\-за +перенаправления или заголовка Content\-Disposition\&. +.sp +Посмотрите пример, как аргументы передаются команде\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +$ cat hook\&.sh +#!/bin/sh +echo "Called with [$1] [$2] [$3]" +$ aria2c \-\-on\-download\-complete hook\&.sh http://example\&.org/file\&.iso +Called with [1] [1] [/path/to/file\&.iso] +.fi +.if n \{\ +.RE +.\} +.SH "КОДЫ ЗАВЕРШЕНИЯ" +.sp +Поскольку aria2 может обрабатывать несколько загрузок одновременно, она +сталкивается с множеством ошибок в сессии\&. aria2 возвращает следующий код +завершения, основанный на последней встретившейся ошибке\&. +.PP +\fB0\fP +.RS 4 +Если все загрузки завершились успешно\&. +.RE +.PP +\fB1\fP +.RS 4 +Если произошла неизвестная ошибка\&. +.RE +.PP +\fB2\fP +.RS 4 +Если время истекло\&. +.RE +.PP +\fB3\fP +.RS 4 +Если ресурс не был найден\&. +.RE +.PP +\fB4\fP +.RS 4 +Если aria2 получила определенное число ошибок "ресурс не найден"\&. Смотрите +параметр \fB\-\-max\-file\-not\-found\fP\&. +.RE +.PP +\fB5\fP +.RS 4 +Если загрузка прервана, поскольку скорость загрузки была слишком +медленной\&. Смотрите параметр \fB\-\-lowest\-speed\-limit\fP +.RE +.PP +\fB6\fP +.RS 4 +Если произошла проблема с сетью\&. +.RE +.PP +\fB7\fP +.RS 4 +Если были не завершенные загрузки\&. Эта ошибка только появляется только +если все завершенные загрузки были успешны и были не завершенные загрузки в +очереди, когда aria2 завершилась по нажатию Ctrl\-C пользователем или при +отправке сигнала TERM или INT\&. +.RE +.PP +\fB8\fP +.RS 4 +Если удаленный сервер не поддерживает возобновление, когда оно было указано +как обязательное для завершения загрузки\&. +.RE +.PP +\fB9\fP +.RS 4 +Если было не достаточно доступного места на диске\&. +.RE +.PP +\fB10\fP +.RS 4 +Если размер блока был отличным от указанного контрольном файле +\&.aria2\&. Смотрите параметр \fB\-\-allow\-piece\-length\-change\fP\&. +.RE +.PP +\fB11\fP +.RS 4 +Если aria2 был загружен один и тот же файл в тот момент\&. +.RE +.PP +\fB12\fP +.RS 4 +Если aria2 загрузила торрент с одним и тем же хэшем в этот момент\&. +.RE +.PP +\fB13\fP +.RS 4 +Если файл уже существует\&. Смотрите параметр \fB\-\-allow\-overwrite\fP\&. +.RE +.PP +\fB14\fP +.RS 4 +Если не удалось переименование\&. Смотрите параметр +\fB\-\-auto\-file\-renaming\fP\&. +.RE +.PP +\fB15\fP +.RS 4 +Если aria2 не смогла открыть существующий файл\&. +.RE +.PP +\fB16\fP +.RS 4 +Если aria2 не смогла создать новый файл или обрезать существующий файл\&. +.RE +.PP +\fB17\fP +.RS 4 +Если произошла ошибка чтения/записи файла\&. +.RE +.PP +\fB18\fP +.RS 4 +Если aria2 не смогла создать каталог\&. +.RE +.PP +\fB19\fP +.RS 4 +Если не удалось разрешение имен (DNS)\&. +.RE +.PP +\fB20\fP +.RS 4 +Если aria2 не смогла проанализировать Metalink\-документ\&. +.RE +.PP +\fB21\fP +.RS 4 +Если FTP\-команда не удалась\&. +.RE +.PP +\fB22\fP +.RS 4 +Если HTTP\-заголовок ответа был испорчен или неожиданым\&. +.RE +.PP +\fB23\fP +.RS 4 +Если произошло слишком много перенаправлений\&. +.RE +.PP +\fB24\fP +.RS 4 +Если HTTP\-авторизация не удалась\&. +.RE +.PP +\fB25\fP +.RS 4 +Если aria2 не смогла проанализировать закодированный файл (обычно +\&.torrent\-файл)\&. +.RE +.PP +\fB26\fP +.RS 4 +Если файл \&.torrent был испорчен или потерена информация, которая +необходима aria2\&. +.RE +.PP +\fB27\fP +.RS 4 +Если Magnet\-ссылка была плохой\&. +.RE +.PP +\fB28\fP +.RS 4 +Если был задан плохой/неопознанный параметр или неожиданный аргумент к +нему\&. +.RE +.PP +\fB29\fP +.RS 4 +Если удаленный сервер не смог обработать запрос из\-за временной перегрузки +или регламентных работ\&. +.RE +.PP +\fB30\fP +.RS 4 +Если aria2 не смогла проанализировать JSON\-RPC\-запрос\&. +.RE +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Ошибка, произошедшая в завершенной загрузке, не будет передана как код +завершения\&. +.sp .5v +.RE +.SH ОКРУЖЕНИЕ +.sp +aria2 распознает следующие переменные окружения\&. +.PP +http_proxy [http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ] +.RS 4 +Указать прокси\-сервер для использования в HTTP\&. Заменяет значение +http\-proxy в конфигурационном файле\&. Параметр \fB\-\-http\-proxy\fP в командной +строке заменяет эту переменную\&. +.RE +.PP +https_proxy [http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ] +.RS 4 +Указать прокси\-сервер для использования в HTTPS\&. Заменяет значение +https\-proxy в конфигурационном файле\&. Параметр \fB\-\-https\-proxy\fP в +командной строке заменяет эту переменную\&. +.RE +.PP +ftp_proxy [http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ] +.RS 4 +Указать прокси\-сервер для использования в FTP\&. Заменяет значение ftp\-proxy +в конфигурационном файле\&. Параметр \fB\-\-ftp\-proxy\fP в командной строке +заменяет эту переменную\&. +.RE +.PP +all_proxy [http://][ПОЛЬЗОВАТЕЛЬ:ПАРОЛЬ@]ХОСТ[:ПОРТ] +.RS 4 +Указать прокси\-сервер для использования если не указан контретный протокол +для прокси\&. Заменяет значение all\-proxy в конфигурационном +файле\&. Параметр \fB\-\-all\-proxy\fP в командной строке заменяет эту +переменную\&. +.RE +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Не смотря на то, что aria2 допускает ftp:// и https:// схемы прокси в URI, +она просто предполагает, что определен http:// и не меняет своего поведения, +основанного на определенной схеме\&. +.sp .5v +.RE +.PP +no_proxy [ДОМЕН,\&...] +.RS 4 +Указать, разделенные запятыми, имена хостов, доменов и сетевых адресов с +CIDR\-блоком, или без него, для которых прокси использоваться не +будет\&. Заменяет значение no\-proxy в конфигурационном файле\&. Параметр +\fB\-\-no\-proxy\fP в командной строке заменяет эту переменную\&. +.RE +.SH ФАЙЛЫ +.SS aria2\&.conf +.sp +По умолчанию, aria2 анализирует \fI$HOME/\&.aria2/aria2\&.conf\fP как +конфигурационный файл\&. Вы можете указать путь к конфигурационному файлу в +параметре \fB\-\-conf\-path\fP\&. Если вы не хотите использовать конфигурационный +файл, используйте параметр \fB\-\-no\-conf\fP\&. +.sp +Конфигурационный файл \- это текстовый файл, содержащий один параметр в +строке\&. В каждой строке, вы можете указать пары имя\-значение в формате: +ИМЯ=ЗНАЧЕНИЕ, где имя \- это длинный параметр командной строки, без префикса +"\-\-"\&. Вы можете использовать тот же синтаксис, что и для параметра +командной строки\&. Строки начинающиеся с "#" рассматриваются как +комментарии\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +# пример конфигурационного файла для aria2c +listen\-port=60000 +dht\-listen\-port=60000 +seed\-ratio=1\&.0 +max\-upload\-limit=50K +ftp\-pasv=true +.fi +.if n \{\ +.RE +.\} +.SS dht\&.dat +.sp +По умолчанию, таблица маршрутизации IPv4 DHT хранится в +\fI$HOME/\&.aria2/dht\&.dat\fP, а таблица маршрутизации IPv6 DHT хранится в +\fI$HOME/\&.aria2/dht6\&.dat\fP\&. +.SS Netrc +.sp +Поддержка Netrc включена по умолчанию для HTTP(S)/FTP\&. Для отключения +поддержки netrc, укажите параметр \fB\-n\fP\&. Ваш файл \&.netrc должен иметь +соответствующие права (600)\&. +.sp +Если имя машины (machine) начинается с "\&.", то aria2 представляет это как +соответствие домену вместо точного соответствия\&. Это расширение +aria2\&. Пример соответствия домену, представляет следующие содержимое +\&.netrc: +.sp +.if n \{\ +.RS 4 +.\} +.nf +machine \&.example\&.org login myid password mypasswd +.fi +.if n \{\ +.RE +.\} +.sp +При соответствии домену, aria2\&.example\&.org будет соответствовать +\&.example\&.org и будет использованы myid и mypasswd\&. example\&.org также +соответствует \&.example\&.org\&. Но example\&.net не будет соответствовать +\&.example\&.org\&. +.SS "Контрольный файл" +.sp +aria2 использует контрольный файл для отслеживания прогресса +загрузки\&. Контрольный файл размещается в том же каталоге, что и +загружаемый файл, и имеет имя, как у загружаемого файла с добавлением +"\&.aria2"\&. Например, если file\&.zip загружаемый файл, тогда контрольный +файл будет file\&.zip\&.aria2\&. (Существует исключение для этого +именования\&. При загрузке торрента с множеством файлов, контрольный файл +будет в "корневом каталоге" с именем торрента и добавлением +"\&.aria2"\&. Имя "корневого каталога" \- значение ключа "name" в "info" +внутри torrent\-файла\&.) +.sp +Обычно контрольный файл удаляется после завершения загрузки\&. Если aria2 +решает, что загрузка не может быть возобновлена (например, когда загружается +файл с HTTP\-сервера, который не поддерживает возобновление), контрольный +файл не создается\&. +.sp +Обычно, если вы потеряете контрольный файл, вы не сможете возобновить +загрузку\&. Но если у вас есть torrent или metalink файлы с контрольными +суммами блоков данных, вы сможете возобновить загрузку без контрольного +файла, указав параметр \fB\-V\fP в командной строке aria2c\&. +.SS "Входной файл" +.sp +Входной файл может содержать список URI для загрузки aria2\&. Вы можете +указать несколько URI для одного объекта, разделяя URI, в одной строке, +табуляцией\&. +.sp +Каждая строка рассматривается, как аргумент командой строки\&. Следовательно +на них влияют параметры \fB\-Z\fP и \fB\-P\fP \&. +.sp +Строка, которая начинается с "#" обрабатывается как комментарий и +пропускается\&. +.sp +Кроме того, следующие параметры могут быть определены после каждой строки с +URI\&. Эти дополнительные строки должны начинаться с пробела(ов)\&. +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBall\-proxy\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBall\-proxy\-passwd\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBall\-proxy\-user\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBallow\-overwrite\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBallow\-piece\-length\-change\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBalways\-resume\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBasync\-dns\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBauto\-file\-renaming\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBbt\-enable\-lpd\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBbt\-exclude\-tracker\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBbt\-external\-ip\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBbt\-hash\-check\-seed\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBbt\-max\-open\-files\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBbt\-max\-peers\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBbt\-metadata\-only\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBbt\-min\-crypto\-level\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBbt\-prioritize\-piece\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBbt\-request\-peer\-speed\-limit\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBbt\-require\-crypto\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBbt\-save\-metadata\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBbt\-seed\-unverified\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBbt\-stop\-timeout\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBbt\-tracker\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBbt\-tracker\-connect\-timeout\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBbt\-tracker\-interval\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBbt\-tracker\-timeout\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBcheck\-integrity\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBconditional\-get\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBconnect\-timeout\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBcontinue\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBdir\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBdry\-run\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBenable\-async\-dns6\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBenable\-http\-keep\-alive\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBenable\-http\-pipelining\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBenable\-peer\-exchange\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBfile\-allocation\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBfollow\-metalink\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBfollow\-torrent\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBftp\-passwd\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBftp\-pasv\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBftp\-proxy\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBftp\-proxy\-passwd\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBftp\-proxy\-user\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBftp\-reuse\-connection\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBftp\-type\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBftp\-user\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBheader\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBhttp\-accept\-gzip\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBhttp\-auth\-challenge\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBhttp\-no\-cache\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBhttp\-passwd\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBhttp\-proxy\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBhttp\-proxy\-passwd\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBhttp\-proxy\-user\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBhttp\-user\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBhttps\-proxy\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBhttps\-proxy\-passwd\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBhttps\-proxy\-user\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBindex\-out\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBlowest\-speed\-limit\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBmax\-connection\-per\-server\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBmax\-download\-limit\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBmax\-file\-not\-found\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBmax\-resume\-failure\-tries\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBmax\-tries\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBmax\-upload\-limit\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBmetalink\-enable\-unique\-protocol\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBmetalink\-language\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBmetalink\-location\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBmetalink\-os\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBmetalink\-preferred\-protocol\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBmetalink\-servers\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBmetalink\-version\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBmin\-split\-size\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBno\-file\-allocation\-limit\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBno\-netrc\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBno\-proxy\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBout\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBparameterized\-uri\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBproxy\-method\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBrealtime\-chunk\-checksum\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBreferer\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBremote\-time\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBremove\-control\-file\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBreuse\-uri\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBseed\-ratio\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBseed\-time\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBselect\-file\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBsplit\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBtimeout\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBuse\-head\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBuser\-agent\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBretry\-wait\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBmetalink\-base\-uri\fP +.RE +.sp +Эти параметры имеют точно такой же смысл, что параметры командной строки, но +это применимо только к URI, к которым они принадлежат\&. Обратите внимание, +что параметры во входном файле не должны иметь префикс "\-\-"\&. +.sp +Например, такое сожержимое uri\&.txt +.sp +.if n \{\ +.RS 4 +.\} +.nf +http://server/file\&.iso http://mirror/file\&.iso + dir=/iso_images + out=file\&.img +http://foo/bar +.fi +.if n \{\ +.RE +.\} +.sp +Если aria2 выполняется с параметрами \fB\-i\fP uri\&.txt \fB\-d\fP /tmp, а загрузка +происходит с http://server/file\&.iso и http://mirror/file\&.iso, то +\fIfile\&.iso\fP сохранится как \fI/iso_images/file\&.img\fP\&. Файл \fIbar\fP +загрузится с http://foo/bar и сохранится как \fI/tmp/bar\fP\&. +.sp +В некоторых случаях, параметр \fBout\fP не имеет никакого эффекта\&. Смотрите +примечание по ограничениям параметра \fB\-\-out\fP\&. +.SS "Профиль функционирования сервера" +.sp +Этот раздел описывает формат профиля функционирования сервера\&. Это +открытый текстовый файл, каждая строка которого имеет несколько пар +ИМЯ=ЗНАЧЕНИЕ, разделенных запятыми\&. В настоящее время распознаются +следующие ИМЕНА: +.PP +host +.RS 4 +Хост\-имя сервера\&. Обязательно\&. +.RE +.PP +protocol +.RS 4 +Протокол для этого профиля, такие как ftp, http\&. Обязательно\&. +.RE +.PP +dl_speed +.RS 4 +Средняя скорость загрузки, которая наблюдалась при предыдущей загрузке, в +байт/секунду\&. Обязательно\&. +.RE +.PP +sc_avg_speed +.RS 4 +Средняя скорость загрузки, которая наблюдалась при предыдущей загрузке, в +байт/секунду\&. Это значение обновляется только если загрузка произведена +при одном соединении и только с использованием +AdaptiveURISelector\&. Необязательно\&. +.RE +.PP +mc_avg_speed +.RS 4 +Средняя скорость загрузки, которая наблюдалась при предыдущей загрузке, в +байт/секунду\&. Это значение обновляется только если загрузка произведена +при нескольких соединениях и только с использованием +AdaptiveURISelector\&. Необязательно\&. +.RE +.PP +counter +.RS 4 +Сколько раз использовался сервер\&. В настоящее время это значение +используется только при AdaptiveURISelector\&. Необязательно\&. +.RE +.PP +last_updated +.RS 4 +Время связи, в GMT, с этим сервером, указывается в секундах начиная с +00:00:00 1 Января, 1970, UTC\&. Обязательно\&. +.RE +.PP +status +.RS 4 +ERROR, когда сервер не доступен из\-за неисправности или тайм\-аута\&. Иначе \- +OK\&. +.RE +.sp +Эти поля должны быть в одной строке\&. Последовательность полей не имеет +значения\&. Вы можете размещать пары, отличные от перечисленных выше; они +будут просто игнорироваться\&. +.sp +Например следующим образом: +.sp +.if n \{\ +.RS 4 +.\} +.nf +host=localhost, protocol=http, dl_speed=32000, last_updated=1222491640, status=OK +host=localhost, protocol=ftp, dl_speed=0, last_updated=1222491632, status=ERROR +.fi +.if n \{\ +.RE +.\} +.SH RPC\-ИНТЕРФЕЙС +.sp +aria2 обеспечивает JSON\-RPC и XML\-RPC, они в основном имеют одинаковые +функции\&. +.sp +Путь для запроса к JSON\-RPC\-интерфейсу \- \fI/jsonrpc\fP\&. Путь для запроса к +XML\-RPC\-интерфейсу \- \fI/rpc\fP\&. +.sp +JSON\-RPC реализован на основе JSON\-RPC 2\&.0 Спецификация (2010\-03\-26) с +поддержкой HTTP POST и GET (JSONP)\&. +.sp +JSON\-RPC\-интерфейс не поддерживает уведомления\&. Он так же не поддерживает +числа с плавающей точкой\&. Символы должны быть в кодировке UTF\-8\&. +.sp +В следующем документе о JSON\-RPC, описана структура JSON\-объекта\&. +.SS Терминология +.PP +GID +.RS 4 +GID (или gid) \- это ключ, для управление каждой загрузкой\&. Каждая загрузка +имеет уникальный GID\&. В настоящие время GID представлен как целое число, +но обрабатывается как не целое число, т.к. он может быть изменен на другой +тип в будущих версиях\&. Обратите внимание, что GID существует в локальной +сессии и не сохраняется при завершении работы aria2\&. +.RE +.SS Методы +.sp +Весь код в примерах написан на Python2\&.7\&. +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.addUri (uris[, options[, position]])\fP +.RS 4 +.sp +Этот метод добавляет новый HTTP(S)/FTP/BitTorrent Magnet URI\&. Параметр +\fIuris\fP имеет тип массив, элемент которого имеет тип строка и содержит +URI\&. Для BitTorrent Magnet URI, \fIuris\fP должен содержать только один +элемент, и он должен быть BitTorrent Magnet URI\&. URI в параметре \fIuris\fP +должны указывать на один и тот же файл\&. Если вы смешивайте другие URI, +указывающие на другой файл, то aria2 не сообщит об этом, но и загрузка может +неудачно завершаться\&. Параметр \fIoptions\fP имеет тип структура, элементы +которой являются парой имя и значение\&. Смотрите ниже \fBПараметры\fP для +более подробной информации\&. Если параметр \fIposition\fP задан как целое +число, начиная с 0, то новая загрузка будет вставлена на позицию \fIposition\fP +в очередь ожидания\&. Если параметр \fIposition\fP не задан или больше чем +размер очереди, то загрузка будет добавлена в конец очереди\&. Этот метод +возвращает GID зарегистрированной загрузки\&. +.sp +Следующий пример добавляет http://example\&.org/file в aria2: +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import urllib2, json +>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, +\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.addUri\*(Aq, +\&.\&.\&. \*(Aqparams\*(Aq:[[\*(Aqhttp://example\&.org/file\*(Aq]]}) +>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) +>>> c\&.read() +\*(Aq{"id":"qwer","jsonrpc":"2\&.0","result":"1"}\*(Aq +.fi +.if n \{\ +.RE +.\} +.sp +Следующий пример добавляет http://example\&.org/file в aria2: +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import xmlrpclib +>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) +>>> s\&.aria2\&.addUri([\*(Aqhttp://example\&.org/file\*(Aq]) +\*(Aq1\*(Aq +.fi +.if n \{\ +.RE +.\} +.sp +Следующий пример добавляет два источника и некоторые параметры: +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> s\&.aria2\&.addUri([\*(Aqhttp://example\&.org/file\*(Aq, \*(Aqhttp://mirror/file\*(Aq], + dict(dir="/tmp")) +\*(Aq2\*(Aq +.fi +.if n \{\ +.RE +.\} +.sp +Следующий пример добавляет загрузку и вставляет ее перед ожидающими +загрузками: +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> s\&.aria2\&.addUri([\*(Aqhttp://example\&.org/file\*(Aq], {}, 0) +\*(Aq3\*(Aq +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.addTorrent (torrent[, uris[, options[, position]]])\fP +.RS 4 +.sp +Этот метод добавляет BitTorrent\-загрузку путем загрузки +\&.torrent\-файла\&. Если вы хотите добавить BitTorrent Magnet URI, взамен +используйте метод \fBaria2\&.addUri\fP\&. Параметр \fItorrent\fP имеет тип base64, +с содержанием Base64\-кодировки в \&.torrent\-файле\&. Параметр \fIuris\fP имеет +тип массив, элемент которого имеет тип строка и содержит URI\&. Параметр +\fIuris\fP используется для Web\-сидирования\&. Для одно файловых торрентов, URI +может быть завершенным, который указывает на ресурс, или же если +заканчиваться символом /, тогда будет добавлено имя из torrent\-файла\&. Для +много файловых торентов, имя и путь в торренте будут добавлены из URI для +каждого файла\&. Параметр \fIoptions\fP имеет тип структура, элементы которой +являются парой имя и значение\&. Смотрите ниже \fBПараметры\fP для более +подробной информации\&. Если параметр \fIposition\fP задан как целое число, +начиная с 0, то новая загрузка будет вставлена на позицию \fIposition\fP в +очередь ожидания\&. Если параметр \fIposition\fP не задан или больше чем размер +очереди, то загрузка будет добавлена в конец очереди\&. Этот метод +возвращает GID зарегистрированной загрузки\&. Загруженные данные сохраняются +в файл с именем шестнадцатеричной строки SHA\-1\-хэша этих данных плюс +"\&.torrent", в каталог указанный в параметре \fB\-\-dir\fP\&. Например, имя +файла 0a3893293e27ac0490424c06de4d09242215f0a6\&.torrent\&. Если этот файл +существует, то он будет перезаписан\&. Если файл не может быть успешно +сохранен, то загрузки, добавленныее этим методом, не сохраняются при помощи +параметра \fB\-\-save\-session\fP\&. +.sp +Следующий пример добавляет локальный файл file\&.torrent в aria2: +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import urllib2, json, base64 +>>> torrent = base64\&.b64encode(open(\*(Aqfile\&.torrent\*(Aq)\&.read()) +>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqasdf\*(Aq, +\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.addTorrent\*(Aq, \*(Aqparams\*(Aq:[torrent]}) +>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) +>>> c\&.read() +\*(Aq{"id":"asdf","jsonrpc":"2\&.0","result":"6"}\*(Aq +.fi +.if n \{\ +.RE +.\} +.sp +Следующий пример добавляет локальный файл file\&.torrent в aria2: +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import xmlrpclib +>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) +>>> s\&.aria2\&.addTorrent(xmlrpclib\&.Binary(open(\*(Aqfile\&.torrent\*(Aq)\&.read())) +\*(Aq6\*(Aq +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.addMetalink (metalink[, options[, position]])\fP +.RS 4 +.sp +Этот метод добавляет Metalink\-загрузку путем загрузки +\&.metalink\-файла\&. Параметр \fImetalink\fP имеет тип base64, с содержанием +Base64\-кодировки в \&.metalink\-файле\&. Параметр \fIoptions\fP имеет тип +структура, элементы которой являются парой имя\-значение\&. Смотрите ниже +\fBПараметры\fP для более подробной информации\&. Если параметр \fIposition\fP +задан как целое число, начиная с 0, то новая загрузка будет вставлена на +позицию \fIposition\fP в очередь ожидания\&. Если параметр \fIposition\fP не задан +или больше чем размер очереди, то загрузка будет добавлена в конец +очереди\&. Этот метод возвращает GID зарегистрированной +загрузки\&. Загруженные данные сохраняются в файл с именем шестнадцатеричной +строки SHA\-1\-хэша этих данных плюс "\&.metalink", в каталог указанный в +параметре \fB\-\-dir\fP\&. Например, имя файла +0a3893293e27ac0490424c06de4d09242215f0a6\&.metalink\&. Если этот файл +существует, то он будет перезаписан\&. Если файл не может быть успешно +сохранен, то загрузки, добавленныее этим методом, не сохраняются при помощи +параметра \fB\-\-save\-session\fP\&. +.sp +Следующий пример добавляет локальный файл file\&.meta4 в aria2: +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import urllib2, json, base64 +>>> metalink = base64\&.b64encode(open(\*(Aqfile\&.meta4\*(Aq)\&.read()) +>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, +\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.addMetalink\*(Aq, \*(Aqparams\*(Aq:[metalink]}) +>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) +>>> c\&.read() +\*(Aq{"id":"qwer","jsonrpc":"2\&.0","result":["8"]}\*(Aq +.fi +.if n \{\ +.RE +.\} +.sp +Следующий пример добавляет локальный файл file\&.meta4 в aria2: +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import xmlrpclib +>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) +>>> s\&.aria2\&.addMetalink(xmlrpclib\&.Binary(open(\*(Aqfile\&.meta4\*(Aq)\&.read())) +[\*(Aq8\*(Aq] +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.remove (gid)\fP +.RS 4 +.sp +Этот метод удаляет загрузку, которая обозначена \fIgid\fP\&. Параметр \fIgid\fP +имеет тип строка\&. Если указана загрузка, которая загружается в данный +момент, то сперва она остановится\&. Статус удаления станет "removed" +(удаленно)\&. Этот метод возвращает GID удаленной загрузки\&. +.sp +Следующий пример удаляет загрузку, GID которой "3": +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import urllib2, json +>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, +\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.remove\*(Aq, \*(Aqparams\*(Aq:[\*(Aq3\*(Aq]}) +>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) +>>> c\&.read() +\*(Aq{"id":"qwer","jsonrpc":"2\&.0","result":"3"}\*(Aq +.fi +.if n \{\ +.RE +.\} +.sp +Следующий пример удаляет загрузку, GID которой "3": +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import xmlrpclib +>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) +>>> s\&.aria2\&.remove(\*(Aq3\*(Aq) +\*(Aq3\*(Aq +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.forceRemove (gid)\fP +.RS 4 +.sp +Этот метод удаляет загрузку, которая обозначена \fIgid\fP\&. Метод действует +подобно \fBaria2\&.remove\fP, за исключением того, что метод удаляет загрузку +без каких\-либо действий, которые требует времени, например связь с +BitTorrent\-трекером\&. +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.pause (gid)\fP +.RS 4 +.sp +Этот метод приостанавливает загрузку, которая обозначена \fIgid\fP\&. Параметр +\fIgid\fP имеет тип строки\&. Статус приостановки станет "paused" +(приостановлено)\&. Если загрузка активна, то загрузка переместится на +первую позицию в очередь ожидания\&. Пока статус "paused", загрузка не +начнется\&. Для смены статуса на "waiting", используйте метод +\fBaria2\&.unpause\fP\&. Этот метод возвращает GID приостановленной загрузки\&. +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.pauseAll ()\fP +.RS 4 +.sp +Этот метод эквивалентен по вызову \fBaria2\&.pause\fP, для каждой +активной/ожидающей закачки\&. Этот метод возвращает "OK", в случае успеха\&. +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.forcePause (pid)\fP +.RS 4 +.sp +Этот метод приостанавливает загрузку, которая обозначена \fIgid\fP\&. Метод +действует подобно \fBaria2\&.pause\fP, за исключением того, что метод +приостанавливает загрузку без каких\-либо действий, которые требует времени, +например связь с BitTorrent\-трекером\&. +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.forcePauseAll ()\fP +.RS 4 +.sp +Этот метод эквивалентен по вызову \fBaria2\&.forcePause\fP, для каждой +активной/ожидающей закачки\&. Этот метод возвращает "OK", в случае успеха\&. +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.unpause (gid)\fP +.RS 4 +.sp +Этот метод изменяет статус загрузки, которая обозначена \fIgid\fP, с "paused" +на "waiting"\&. Это позволяет перезапускать загрузку\&. Значение ключа +\fIgid\fP имеет тип строки\&. Этот метод возвращает GID, снятой с паузы, +загрузки\&. +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.unpauseAll ()\fP +.RS 4 +.sp +Этот метод эквивалентен по вызову \fBaria2\&.unpause\fP, для каждой +активной/ожидающей закачки\&. Этот метод возвращает "OK", в случае успеха\&. +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.tellStatus (gid[, keys])\fP +.RS 4 +.sp +Этот метод возвращает состояние загрузки, которая обозначена +\fIgid\fP\&. Параметр \fIgid\fP имеет тип строка\&. Параметр \fIkeys\fP имеет тип +массив строк\&. Если \fIkeys\fP указан, то ответ содержит определенные значения +в массиве \fIkeys\fP\&. Если \fIkeys\fP пустой или не указан, то ответ содержит +все значения\&. Это полезно, если вы хотите использовать определенные +параметры, чтобы исключить множество пересылок\&. Например, +\fBaria2\&.tellStatus\fP("1", ["gid", "status"]) возвратит \fIgid\fP и +\fIstatus\fP\&. Ответ имеет тип структура и содержит следующие поля\&. Поля +имеют тип строка\&. +.PP +gid +.RS 4 +GID этой загрузки\&. +.RE +.PP +status +.RS 4 +"active" \- загружаемая/сидируемая в данный момент\&. "waiting" \- ожидающая в +очереди; загрузка не началась\&. "paused" \- приостановленная\&. "error" \- +остановленная, т.к. произошла ошибка\&. "complete" \- остановленная и +завершенная загрузка\&. "removed" \- удаленная пользователем загрузка\&. +.RE +.PP +totalLength +.RS 4 +Общий объем загрузки в байтах\&. +.RE +.PP +completedLength +.RS 4 +Загруженный объем загрузки в байтах\&. +.RE +.PP +uploadLength +.RS 4 +Выгруженный объем загрузки в байтах\&. +.RE +.PP +bitfield +.RS 4 +Шестнадцатеричное представление процесса загрузки\&. Старший бит +соответствует блоку с индексом 0\&. Бит устанавливается, если блок доступен +и не устанавливается, если блок отсутствует\&. Запасные биты в конце +устанавливаются в 0\&. Если загрузка еще не начался, этот значение не будет +включено в ответ\&. +.RE +.PP +downloadSpeed +.RS 4 +Скорость загрузки в байт/сек\&. +.RE +.PP +uploadSpeed +.RS 4 +Скорость выгрузки в байт/сек\&. +.RE +.PP +infoHash +.RS 4 +Информация о хэше (InfoHash)\&. Только для BitTorrent\&. +.RE +.PP +numSeeders +.RS 4 +Количество сидов, к которым подключен клиент\&. Только для BitTorrent\&. +.RE +.PP +pieceLength +.RS 4 +Размер блока в байтах\&. +.RE +.PP +numPieces +.RS 4 +Количество блоков\&. +.RE +.PP +connections +.RS 4 +Количество пиров/серверов, к которым подключен клиент\&. +.RE +.PP +errorCode +.RS 4 +Последний код ошибки, которая произошла при загрузке\&. Значение имеет тип +строки\&. Коды ошибок определены в разделе \fBКОДЫ ЗАВЕРШЕНИЯ\fP\&. Это +значение доступно только для остановленных/завершенных загрузок\&. +.RE +.PP +followedBy +.RS 4 +Список с GID, которые сгенерированы в результате запуска этой +загрузки\&. Например, когда aria2 загружает Metalink\-файл, то это генерирует +загрузки, описанные в нем (см. параметр \fB\-\-follow\-metalink\fP)\&. Это +значение полезно для отслеживания автоматически сгенерированных +загрузок\&. Если таких загрузок нет, то значение не будет включено в +ответ\&. +.RE +.PP +belongsTo +.RS 4 +GID родительской загрузки\&. Некоторые загрузки являются частью другой +загрузки\&. Например, если файл в Metalink содержит BitTorrent\-ответ, +загрузка \&.torrent будет частью этого файла\&. Если эта загрузка не имеет +родительской загрузки, то значение не будет включено в ответ\&. +.RE +.PP +dir +.RS 4 +Каталог для сохранения файлов\&. Этот параметр не доступен для остановленных +загрузок\&. +.RE +.PP +files +.RS 4 +Возвращает список файлов\&. Элемент списка \- это структура, такая же, что и +в методе \fBaria2\&.getFiles\fP\&. +.RE +.PP +bittorrent +.RS 4 +Структура, в которой содержится информация, извлеченная из +\&.torrent\-файла\&. Только для BitTorrent\&. Содержит следующие поля\&. +.PP +announceList +.RS 4 +Список списков URI анонса\&. Если \&.torrent\-файл содержит анонс, а не +список\-анонс, то анонс конвертируется в формат списка\-анонса\&. +.RE +.PP +comment +.RS 4 +Комментарий по торренту\&. Используется comment\&.utf\-8, если доступно\&. +.RE +.PP +creationDate +.RS 4 +Время создания торрента\&. Значение является целым числом, с начала века, +измеряется в секундах\&. +.RE +.PP +mode +.RS 4 +Файловый режим торрента\&. Значение одно из двух: \fIsingle\fP (одиночный) или +\fImulti\fP (множественный)\&. +.RE +.PP +info +.RS 4 +Структура, которая содержит данные из раздела Info\&. Она содержит следующие +поля\&. +.PP +name +.RS 4 +имя в разделе info\&. Используется name\&.utf\-8, если доступно\&. +.RE +.RE +.RE +.sp +Следующий пример получает иформацию о загрузке, GID которой "1": +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import urllib2, json +>>> from pprint import pprint +>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, +\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.tellStatus\*(Aq, \*(Aqparams\*(Aq:[\*(Aq1\*(Aq]}) +>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) +>>> pprint(json\&.loads(c\&.read())) +{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, + u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, + u\*(Aqresult\*(Aq: {u\*(Aqbitfield\*(Aq: u\*(Aq0000000000\*(Aq, + u\*(AqcompletedLength\*(Aq: u\*(Aq901120\*(Aq, + u\*(Aqconnections\*(Aq: u\*(Aq1\*(Aq, + u\*(Aqdir\*(Aq: u\*(Aq/downloads\*(Aq, + u\*(AqdownloadSpeed\*(Aq: u\*(Aq15158\*(Aq, + u\*(Aqfiles\*(Aq: [{u\*(Aqindex\*(Aq: u\*(Aq1\*(Aq, + u\*(Aqlength\*(Aq: u\*(Aq34896138\*(Aq, + u\*(Aqpath\*(Aq: u\*(Aq/downloads/file\*(Aq, + u\*(Aqselected\*(Aq: u\*(Aqtrue\*(Aq, + u\*(Aquris\*(Aq: [{u\*(Aqstatus\*(Aq: u\*(Aqused\*(Aq, + u\*(Aquri\*(Aq: u\*(Aqhttp://example\&.org/file\*(Aq}]}], + u\*(Aqgid\*(Aq: u\*(Aq1\*(Aq, + u\*(AqnumPieces\*(Aq: u\*(Aq34\*(Aq, + u\*(AqpieceLength\*(Aq: u\*(Aq1048576\*(Aq, + u\*(Aqstatus\*(Aq: u\*(Aqactive\*(Aq, + u\*(AqtotalLength\*(Aq: u\*(Aq34896138\*(Aq, + u\*(AquploadLength\*(Aq: u\*(Aq0\*(Aq, + u\*(AquploadSpeed\*(Aq: u\*(Aq0\*(Aq}} +.fi +.if n \{\ +.RE +.\} +.sp +Следующий пример получает информацию об определенных полях, который вас +интересуют: +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, +\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.tellStatus\*(Aq, +\&.\&.\&. \*(Aqparams\*(Aq:[\*(Aq1\*(Aq, [\*(Aqgid\*(Aq, +\&.\&.\&. \*(AqtotalLength\*(Aq, +\&.\&.\&. \*(AqcompletedLength\*(Aq]]}) +>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) +>>> pprint(json\&.loads(c\&.read())) +{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, + u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, + u\*(Aqresult\*(Aq: {u\*(AqcompletedLength\*(Aq: u\*(Aq5701632\*(Aq, + u\*(Aqgid\*(Aq: u\*(Aq1\*(Aq, + u\*(AqtotalLength\*(Aq: u\*(Aq34896138\*(Aq}} +.fi +.if n \{\ +.RE +.\} +.sp +Следующий пример получает иформацию о загрузке, GID которой "1": +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import xmlrpclib +>>> from pprint import pprint +>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) +>>> r = s\&.aria2\&.tellStatus(\*(Aq1\*(Aq) +>>> pprint(r) +{\*(Aqbitfield\*(Aq: \*(Aqffff80\*(Aq, + \*(AqcompletedLength\*(Aq: \*(Aq34896138\*(Aq, + \*(Aqconnections\*(Aq: \*(Aq0\*(Aq, + \*(Aqdir\*(Aq: \*(Aq/downloads\*(Aq, + \*(AqdownloadSpeed\*(Aq: \*(Aq0\*(Aq, + \*(AqerrorCode\*(Aq: \*(Aq0\*(Aq, + \*(Aqfiles\*(Aq: [{\*(Aqindex\*(Aq: \*(Aq1\*(Aq, + \*(Aqlength\*(Aq: \*(Aq34896138\*(Aq, + \*(Aqpath\*(Aq: \*(Aq/downloads/file\*(Aq, + \*(Aqselected\*(Aq: \*(Aqtrue\*(Aq, + \*(Aquris\*(Aq: [{\*(Aqstatus\*(Aq: \*(Aqused\*(Aq, + \*(Aquri\*(Aq: \*(Aqhttp://example\&.org/file\*(Aq}]}], + \*(Aqgid\*(Aq: \*(Aq1\*(Aq, + \*(AqnumPieces\*(Aq: \*(Aq17\*(Aq, + \*(AqpieceLength\*(Aq: \*(Aq2097152\*(Aq, + \*(Aqstatus\*(Aq: \*(Aqcomplete\*(Aq, + \*(AqtotalLength\*(Aq: \*(Aq34896138\*(Aq, + \*(AquploadLength\*(Aq: \*(Aq0\*(Aq, + \*(AquploadSpeed\*(Aq: \*(Aq0\*(Aq} +.fi +.if n \{\ +.RE +.\} +.sp +Следующий пример получает информацию об определенных полях, который вас +интересуют: +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> r = s\&.aria2\&.tellStatus(\*(Aq1\*(Aq, [\*(Aqgid\*(Aq, \*(AqtotalLength\*(Aq, \*(AqcompletedLength\*(Aq]) +>>> pprint(r) +{\*(AqcompletedLength\*(Aq: \*(Aq34896138\*(Aq, \*(Aqgid\*(Aq: \*(Aq1\*(Aq, \*(AqtotalLength\*(Aq: \*(Aq34896138\*(Aq} +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.getUris (gid)\fP +.RS 4 +.sp +Этот метод возвращает URI, используемые в загрузке, которая обозначена +\fIgid\fP\&. Параметр \fIgid\fP имеет тип строка\&. Ответ имеет тип массив, а +элемент \- тип структура и содержит следующие поля\&. Поле имеет тип +строка\&. +.PP +uri +.RS 4 +URI +.RE +.PP +status +.RS 4 + +\fIused\fP, если URI уже использован\&. \fIwaiting\fP, если URI ожидает в +очереди\&. +.RE +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import urllib2, json +>>> from pprint import pprint +>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, +\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.getUris\*(Aq, \*(Aqparams\*(Aq:[\*(Aq1\*(Aq]}) +>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) +>>> pprint(json\&.loads(c\&.read())) +{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, + u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, + u\*(Aqresult\*(Aq: [{u\*(Aqstatus\*(Aq: u\*(Aqused\*(Aq, + u\*(Aquri\*(Aq: u\*(Aqhttp://example\&.org/file\*(Aq}]} +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import xmlrpclib +>>> from pprint import pprint +>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) +>>> r = s\&.aria2\&.getUris(\*(Aq1\*(Aq) +>>> pprint(r) +[{\*(Aqstatus\*(Aq: \*(Aqused\*(Aq, \*(Aquri\*(Aq: \*(Aqhttp://example\&.org/file\*(Aq}] +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.getFiles (gid)\fP +.RS 4 +.sp +Этот метод возвращает список файлов загрузки, которая обозначена +\fIgid\fP\&. Параметр \fIgid\fP имеет тип строка\&. Ответ имеет тип массив, а +элемент \- тип структура и содержит следующие поля\&. Поле имеет тип +строка\&. +.PP +index +.RS 4 +Индекс файла\&. Начинается с 1\&. Последовательность файлов такая же, что и +в много файловом торренте\&. +.RE +.PP +path +.RS 4 +Путь к файлу\&. +.RE +.PP +length +.RS 4 +Размер файла в байта\&. +.RE +.PP +selected +.RS 4 +"true" \- если этот файл выбран параметром \fB\-\-select\-file\fP\&. Если параметр +\fB\-\-select\-file\fP не указан или это одно файловый торрент или загрузка не +торрент, то это значение всегда будет "true"\&. Иначе "false"\&. +.RE +.PP +uris +.RS 4 +Возвращает список URI для этого файла\&. Элемент списка такая же структура, +что используется в методе \fBaria2\&.getUris\fP\&. +.RE +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import urllib2, json +>>> from pprint import pprint +>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, +\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.getFiles\*(Aq, \*(Aqparams\*(Aq:[\*(Aq1\*(Aq]}) +>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) +>>> pprint(json\&.loads(c\&.read())) +{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, + u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, + u\*(Aqresult\*(Aq: [{u\*(Aqindex\*(Aq: u\*(Aq1\*(Aq, + u\*(Aqlength\*(Aq: u\*(Aq34896138\*(Aq, + u\*(Aqpath\*(Aq: u\*(Aq/downloads/file\*(Aq, + u\*(Aqselected\*(Aq: u\*(Aqtrue\*(Aq, + u\*(Aquris\*(Aq: [{u\*(Aqstatus\*(Aq: u\*(Aqused\*(Aq, + u\*(Aquri\*(Aq: u\*(Aqhttp://example\&.org/file\*(Aq}]}]} +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import xmlrpclib +>>> from pprint import pprint +>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) +>>> r = s\&.aria2\&.getFiles(\*(Aq1\*(Aq) +>>> pprint(r) +[{\*(Aqindex\*(Aq: \*(Aq1\*(Aq, + \*(Aqlength\*(Aq: \*(Aq34896138\*(Aq, + \*(Aqpath\*(Aq: \*(Aq/downloads/file\*(Aq, + \*(Aqselected\*(Aq: \*(Aqtrue\*(Aq, + \*(Aquris\*(Aq: [{\*(Aqstatus\*(Aq: \*(Aqused\*(Aq, + \*(Aquri\*(Aq: \*(Aqhttp://example\&.org/file\*(Aq}]}] +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.getPeers (gid)\fP +.RS 4 +.sp +Этот метод возвращает список пиров загрузки, которая обозначена +\fIgid\fP\&. Параметр \fIgid\fP имеет тип строка\&. Этот метод только для +BitTorrent\&. Ответ имеет тип массив, а элемент \- тип структура и содержит +следующие поля\&. Поле имеет тип строка\&. +.PP +peerId +.RS 4 +Закодированное ID пира\&. +.RE +.PP +ip +.RS 4 +IP\-адрес пира\&. +.RE +.PP +port +.RS 4 +Номер порта пира\&. +.RE +.PP +bitfield +.RS 4 +Шестнадцатеричное представление процесса загрузки\&. Старший бит +соответствует блоку с индексом 0\&. Бит устанавливается, если блок доступен +и не устанавливается, если блок отсутствует\&. Запасные биты в конце +устанавливаются в 0\&. +.RE +.PP +amChoking +.RS 4 +"true" \- если этот клиент блокирует пира\&. Иначе "false"\&. +.RE +.PP +peerChoking +.RS 4 +"true" \- если пир блокирует этого клиента\&. Иначе "false"\&. +.RE +.PP +downloadSpeed +.RS 4 +Скорость загрузки (байт/сек), с которой этот клиент получает от пира\&. +.RE +.PP +uploadSpeed +.RS 4 +Скорость выгрузки (байт/сек), с которой этот клиент отдает пиру\&. +.RE +.PP +seeder +.RS 4 +"true" \- если этот клиент является сидом\&. Иначе "false"\&. +.RE +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import urllib2, json +>>> from pprint import pprint +>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, +\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.getPeers\*(Aq, \*(Aqparams\*(Aq:[\*(Aq1\*(Aq]}) +>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) +>>> pprint(json\&.loads(c\&.read())) +{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, + u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, + u\*(Aqresult\*(Aq: [{u\*(AqamChoking\*(Aq: u\*(Aqtrue\*(Aq, + u\*(Aqbitfield\*(Aq: u\*(Aqffffffffffffffffffffffffffffffffffffffff\*(Aq, + u\*(AqdownloadSpeed\*(Aq: u\*(Aq10602\*(Aq, + u\*(Aqip\*(Aq: u\*(Aq10\&.0\&.0\&.9\*(Aq, + u\*(AqpeerChoking\*(Aq: u\*(Aqfalse\*(Aq, + u\*(AqpeerId\*(Aq: u\*(Aqaria2%2F1%2E10%2E5%2D%87%2A%EDz%2F%F7%E6\*(Aq, + u\*(Aqport\*(Aq: u\*(Aq6881\*(Aq, + u\*(Aqseeder\*(Aq: u\*(Aqtrue\*(Aq, + u\*(AquploadSpeed\*(Aq: u\*(Aq0\*(Aq}, + {u\*(AqamChoking\*(Aq: u\*(Aqfalse\*(Aq, + u\*(Aqbitfield\*(Aq: u\*(Aqffffeff0fffffffbfffffff9fffffcfff7f4ffff\*(Aq, + u\*(AqdownloadSpeed\*(Aq: u\*(Aq8654\*(Aq, + u\*(Aqip\*(Aq: u\*(Aq10\&.0\&.0\&.30\*(Aq, + u\*(AqpeerChoking\*(Aq: u\*(Aqfalse\*(Aq, + u\*(AqpeerId\*(Aq: u\*(Aqbittorrent client758\*(Aq, + u\*(Aqport\*(Aq: u\*(Aq37842\*(Aq, + u\*(Aqseeder\*(Aq: u\*(Aqfalse\*(Aq, + u\*(AquploadSpeed\*(Aq: u\*(Aq6890\*(Aq}]} +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import xmlrpclib +>>> from pprint import pprint +>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) +>>> r = s\&.aria2\&.getPeers(\*(Aq1\*(Aq) +>>> pprint(r) +[{\*(AqamChoking\*(Aq: \*(Aqtrue\*(Aq, + \*(Aqbitfield\*(Aq: \*(Aqffffffffffffffffffffffffffffffffffffffff\*(Aq, + \*(AqdownloadSpeed\*(Aq: \*(Aq10602\*(Aq, + \*(Aqip\*(Aq: \*(Aq10\&.0\&.0\&.9\*(Aq, + \*(AqpeerChoking\*(Aq: \*(Aqfalse\*(Aq, + \*(AqpeerId\*(Aq: \*(Aqaria2%2F1%2E10%2E5%2D%87%2A%EDz%2F%F7%E6\*(Aq, + \*(Aqport\*(Aq: \*(Aq6881\*(Aq, + \*(Aqseeder\*(Aq: \*(Aqtrue\*(Aq, + \*(AquploadSpeed\*(Aq: \*(Aq0\*(Aq}, + {\*(AqamChoking\*(Aq: \*(Aqfalse\*(Aq, + \*(Aqbitfield\*(Aq: \*(Aqffffeff0fffffffbfffffff9fffffcfff7f4ffff\*(Aq, + \*(AqdownloadSpeed\*(Aq: \*(Aq8654\*(Aq, + \*(Aqip\*(Aq: \*(Aq10\&.0\&.0\&.30\*(Aq, + \*(AqpeerChoking\*(Aq: \*(Aqfalse\*(Aq, + \*(AqpeerId\*(Aq: \*(Aqbittorrent client758\*(Aq, + \*(Aqport\*(Aq: \*(Aq37842\*(Aq, + \*(Aqseeder\*(Aq: \*(Aqfalse, + \*(AquploadSpeed\*(Aq: \*(Aq6890\*(Aq}] +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.getServers (gid)\fP +.RS 4 +.sp +Этот метод возвращает текущие подключенные HTTP(S)/FTP\-серверы загрузки, +которая обозначена \fIgid\fP\&. Параметр \fIgid\fP имеет тип строка\&. Ответ имеет +тип массив, а элемент \- тип структура и содержит следующие поля\&. Поле +имеет тип строка\&. +.PP +index +.RS 4 +Индекс файла\&. Начинается с 1\&. Последовательность файлов такая же, что и +в много файловом торренте\&. +.RE +.PP +servers +.RS 4 +Список структур, которые содержат следующие поля\&. +.PP +uri +.RS 4 +Первоначально добавленный URI\&. +.RE +.PP +currentUri +.RS 4 +Это URI в настоящее время используется для загрузки\&. Если происходит +перенаправление, currentUri и uri могут отличаться\&. +.RE +.PP +downloadSpeed +.RS 4 +Скорость загрузки (байт/сек) +.RE +.RE +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import urllib2, json +>>> from pprint import pprint +>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, +\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.getServers\*(Aq, \*(Aqparams\*(Aq:[\*(Aq1\*(Aq]}) +>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) +>>> pprint(json\&.loads(c\&.read())) +{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, + u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, + u\*(Aqresult\*(Aq: [{u\*(Aqindex\*(Aq: u\*(Aq1\*(Aq, + u\*(Aqservers\*(Aq: [{u\*(AqcurrentUri\*(Aq: u\*(Aqhttp://example\&.org/file\*(Aq, + u\*(AqdownloadSpeed\*(Aq: u\*(Aq10467\*(Aq, + u\*(Aquri\*(Aq: u\*(Aqhttp://example\&.org/file\*(Aq}]}]} +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import xmlrpclib +>>> from pprint import pprint +>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) +>>> r = s\&.aria2\&.getServers(\*(Aq1\*(Aq) +>>> pprint(r) +[{\*(Aqindex\*(Aq: \*(Aq1\*(Aq, + \*(Aqservers\*(Aq: [{\*(AqcurrentUri\*(Aq: \*(Aqhttp://example\&.org/dl/file\*(Aq, + \*(AqdownloadSpeed\*(Aq: \*(Aq20285\*(Aq, + \*(Aquri\*(Aq: \*(Aqhttp://example\&.org/file\*(Aq}]}] +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.tellActive ([keys])\fP +.RS 4 +.sp +Этот метод возвращает список активных загрузок\&. Ответ имеет тип массив и +его элемент такая же структура, которая возвращается методом +\fBaria2\&.tellStatus\fP\&. За разъяснениями о параметре \fIkeys\fP, обратитесь к +методу \fBaria2\&.tellStatus\fP\&. +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.tellWaiting (offset, num, [keys])\fP +.RS 4 +.sp +Этот метод возвращает список ожидающих загрузок, включая приостановленные +загрузки\&. \fIoffset\fP имеет целочисленный тип и указывает смещение, начиная +от ожидающей загрузки\&. \fInum\fP имеет целочисленный тип и указывает число +возвращаемых загрузок\&. За разъяснениями о параметре \fIkeys\fP, обратитесь к +методу \fBaria2\&.tellStatus\fP\&. +.sp +Если смещение положительное целое число, то этот метод возвращает загрузки в +диапазоне [\fIoffset\fP, \fIoffset\fP+\fInum\fP)\&. +.sp +\fIoffset\fP может быть отрицательным целым числом\&. \fIoffset\fP == \-1 указывает +на последнею загрузку, которая ожидает в очереди, а \fIoffset\fP == \-2 +указывает на загрузку перед последней, и так далее\&. Загрузки в ответе +находятся в обратном порядке\&. +.sp +Например, допустим что есть три загрузки "A","B" и "C", в этом порядке, +которые ожидают\&. aria2\&.tellWaiting(0, 1) возвратит +["A"]\&. aria2\&.tellWaiting(1, 2) возвратит ["B", +"C"]\&. aria2\&.tellWaiting(\-1, 2) возвратит ["C", "B"]\&. +.sp +Ответ имеет тип массив и его элемент такая же структура, которая +возвращается методом \fBaria2\&.tellStatus\fP\&. +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.tellStopped (offset, num, [keys])\fP +.RS 4 +.sp +Этот метод возвращает список остановленных загрузок\&. \fIoffset\fP имеет +целочисленный тип и указывает смещение, начиная с самой старой +загрузки\&. \fInum\fP имеет целочисленный тип и указывает число возвращаемых +загрузок\&. За разъяснениями о параметре \fIkeys\fP, обратитесь к методу +\fBaria2\&.tellStatus\fP\&. +.sp +\fIoffset\fP и \fInum\fP имеют такую же семантику как и в методе +\fBaria2\&.tellWaiting\fP\&. +.sp +Ответ имеет тип массив и его элемент такая же структура, которая +возвращается методом \fBaria2\&.tellStatus\fP\&. +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.changePosition (gid, pos, how)\fP +.RS 4 +.sp +Этот метод меняет позицию загрузки, которая обозначена \fIgid\fP\&. \fIpos\fP +имеет целочисленный тип\&. \fIhow\fP имеет тип строка\&. Если \fIhow\fP \- +"POS_SET", то это переместит загрузку на позицию, относительно начала +очереди\&. Если \fIhow\fP \- "POS_CUR", это переместит загрузку на позицию, +относительно текущей позиции\&. Если \fIhow\fP \- "POS_END", это переместит +загрузку на позицию, относительно конца очереди\&. Если целевая позиция +меньше чем 0 или за пределами конца очереди, это переместит загрузку в +начало или конец очереди соответственно\&. Ответ имеет целочисленный тип и +является целевой позицией\&. +.sp +Например, если GID#1 размещается на позиции 3, aria2\&.changePosition(1, \-1, +POS_CUR) изменит его позицию на 2\&. Дополнительно aria2\&.changePosition(1, +0, POS_SET) изменит его позицию на 0 (начало очереди)\&. +.sp +Следующий пример перемещает загрузку, GID которой "3", в начало очереди +ожидания: +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import urllib2, json +>>> from pprint import pprint +>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, +\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.changePosition\*(Aq, +\&.\&.\&. \*(Aqparams\*(Aq:[\*(Aq3\*(Aq, 0, \*(AqPOS_SET\*(Aq]}) +>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) +>>> pprint(json\&.loads(c\&.read())) +{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: 0} +.fi +.if n \{\ +.RE +.\} +.sp +Следующий пример перемещает загрузку, GID которой "3", в начало очереди +ожидания: +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import xmlrpclib +>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) +>>> s\&.aria2\&.changePosition(\*(Aq3\*(Aq, 0, \*(AqPOS_SET\*(Aq) +0 +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.changeUri (gid, fileIndex, delUris, addUris[, position])\fP +.RS 4 +.sp +Этот метод удаляет URI в \fIdelUris\fP из загрузки и добавляет URI в \fIaddUris\fP +к загрузке, которая обозначена \fIgid\fP\&. \fIdelUris\fP и \fIaddUris\fP являются +списком строк\&. Загрузка может содержать несколько файлов и URI прилагаются +к каждому файлу\&. \fIfileIndex\fP используется, чтобы выбрать файл для +удаления/подключения заданных URI\&. \fIfileIndex\fP начинается с +1\&. \fIposition\fP используется для указания, куда будут вставлены URI в +существующем списке ожидающих URI\&. \fIposition\fP начинается с 0\&. Когда +\fIposition\fP пропущено, URI добавляются в конец списка\&. Этот метод сначала +выполняет удаление, а потом добавление\&. \fIposition\fP это позиция после URI, +которые будут удалены, а не позиция, когда метод вызывается\&. При удалении +URI, если одинаковые URI существуют в загрузке, только один из них будет +удален, для каждого URI в \fIdelUris\fP\&. Другими словами, есть три URI +"http://example\&.org/aria2" и вы хотите удалить их все, вы должны указать +(по крайней мере) 3 "http://example\&.org/aria2" в \fIdelUris\fP\&. Этот метод +возвращает список, который содержит 2 целых числа\&. Первое \- количество +удаленных URI\&. Второе \- количество добавленных URI\&. +.sp +Следующий пример добавляет 1 URI http://example\&.org/file к файлу с +индексом "1", принадлежащий загрузке, GID которой "2": +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import urllib2, json +>>> from pprint import pprint +>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, +\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.changeUri\*(Aq, +\&.\&.\&. \*(Aqparams\*(Aq:[\*(Aq2\*(Aq, 1, [], [\*(Aqhttp://example\&.org/file\*(Aq]]}) +>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) +>>> pprint(json\&.loads(c\&.read())) +{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: [0, 1]} +.fi +.if n \{\ +.RE +.\} +.sp +Следующий пример добавляет 1 URI http://example\&.org/file к файлу с +индексом "1", принадлежащий загрузке, GID которой "2": +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import xmlrpclib +>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) +>>> s\&.aria2\&.changeUri(\*(Aq2\*(Aq, 1, [], [\*(Aqhttp://example\&.org/file\*(Aq]) +[0, 1] +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.getOption (gid)\fP +.RS 4 +.sp +Этот метод возвращает параметры загрузки, которая обозначена \fIgid\fP\&. Ответ +имеет тип структура\&. Ее поля \- это название параметра\&. Поле имеет тип +строка\&. +.sp +Следующий пример получает параметры загрузки, GID которой "1": +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import urllib2, json +>>> from pprint import pprint +>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, +\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.getOption\*(Aq, \*(Aqparams\*(Aq:[\*(Aq1\*(Aq]}) +>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) +>>> pprint(json\&.loads(c\&.read())) +{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, + u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, + u\*(Aqresult\*(Aq: {u\*(Aqallow\-overwrite\*(Aq: u\*(Aqfalse\*(Aq, + u\*(Aqallow\-piece\-length\-change\*(Aq: u\*(Aqfalse\*(Aq, + u\*(Aqalways\-resume\*(Aq: u\*(Aqtrue\*(Aq, + u\*(Aqasync\-dns\*(Aq: u\*(Aqtrue\*(Aq, + \&.\&.\&. +.fi +.if n \{\ +.RE +.\} +.sp +Следующий пример получает параметры загрузки, GID которой "1": +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import xmlrpclib +>>> from pprint import pprint +>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) +>>> r = s\&.aria2\&.getOption(\*(Aq1\*(Aq) +>>> pprint(r) +{\*(Aqallow\-overwrite\*(Aq: \*(Aqfalse\*(Aq, + \*(Aqallow\-piece\-length\-change\*(Aq: \*(Aqfalse\*(Aq, + \*(Aqalways\-resume\*(Aq: \*(Aqtrue\*(Aq, + \*(Aqasync\-dns\*(Aq: \*(Aqtrue\*(Aq, + \&.\&.\&.\&. +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.changeOption (gid, options)\fP +.RS 4 +.sp +Этот метод изменяет динамически параметры загрузки, которая обозначена +\fIgid\fP\&. \fIgid\fP имеет тип строка\&. \fIoptions\fP имеет тип структура, +доступны параметры: \fBbt\-max\-peers\fP, \fBbt\-request\-peer\-speed\-limit\fP, +\fBmax\-download\-limit\fP и \fBmax\-upload\-limit\fP\&. Этот метод возвращает "OK", в +случае успеха\&. +.sp +Следующий пример устанавливает параметр \fBmax\-download\-limit\fP в "20K" для +загрузки, GID которой "1": +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import urllib2, json +>>> from pprint import pprint +>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, +\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.changeOption\*(Aq, +\&.\&.\&. \*(Aqparams\*(Aq:[\*(Aq1\*(Aq, {\*(Aqmax\-download\-limit\*(Aq:\*(Aq10K\*(Aq}]}) +>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) +>>> pprint(json\&.loads(c\&.read())) +{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: u\*(AqOK\*(Aq} +.fi +.if n \{\ +.RE +.\} +.sp +Следующий пример устанавливает параметр \fBmax\-download\-limit\fP в "20K" для +загрузки, GID которой "1": +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import xmlrpclib +>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) +>>> s\&.aria2\&.changeOption(\*(Aq1\*(Aq, {\*(Aqmax\-download\-limit\*(Aq:\*(Aq20K\*(Aq}) +\*(AqOK\*(Aq +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.getGlobalOption ()\fP +.RS 4 +.sp +Этот метод возвращает глобальные параметры\&. Ответ имеет тип +структура\&. Ее поля \- это название параметра\&. Поле имеет тип +строка\&. Так как глобальные параметры используются в качестве шаблона для +вновь добавляемой загрузки, ответ содержит поля возвращаемые методом +\fBaria2\&.getOption\fP\&. +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.changeGlobalOption (options)\fP +.RS 4 +.sp +Этот метод изменяет динамически глобальные параметры\&. \fIoptions\fP имеет тип +структура, доступны параметры: \fBmax\-concurrent\-downloads\fP, +\fBmax\-overall\-download\-limit\fP, \fBmax\-overall\-upload\-limit\fP, \fBlog\-level\fP и +\fBlog\fP\&. Используя параметр \fBlog\fP, вы можете динамически начинать вести +журнал событий или изменять файл журнала событий\&. Чтобы остановить ведение +журнала событий задайте пустую строку ("") в качестве значения +параметра\&. Обратите внимание, что файл журнала событий всегда открыт в +режиме добавления\&. Этот метод возвращает "OK", в случае успеха\&. +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.purgeDownloadResult ()\fP +.RS 4 +.sp +Этот метод очищает, для освобождения памяти, завершенные/ошибка/удаленные +загрузки\&. Метод возвращает "OK"\&. +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.removeDownloadResult (gid)\fP +.RS 4 +.sp +Этот метод удаляет из памяти завершенную/ошибка/удаленную загрузку, которая +обозначена \fIgid\fP\&. Метод возвращает "OK", в случае успеха\&. +.sp +Следующий пример удаляет результат загрузки, GID которой "1": +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import urllib2, json +>>> from pprint import pprint +>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, +\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.removeDownloadResult\*(Aq, +\&.\&.\&. \*(Aqparams\*(Aq:[\*(Aq1\*(Aq]}) +>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) +>>> pprint(json\&.loads(c\&.read())) +{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: u\*(AqOK\*(Aq} +.fi +.if n \{\ +.RE +.\} +.sp +Следующий пример удаляет результат загрузки, GID которой "1": +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import xmlrpclib +>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) +>>> s\&.aria2\&.removeDownloadResult(\*(Aq1\*(Aq) +\*(AqOK\*(Aq +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.getVersion ()\fP +.RS 4 +.sp +Этот метод возвращает версию программы и список включенных +возможностей\&. Ответ имеет тип структура и содержит следующие поля\&. +.PP +version +.RS 4 +Номер версии программы в строке\&. +.RE +.PP +enabledFeatures +.RS 4 +Список включенных возможностей\&. Каждое имя возможности имеет тип строка\&. +.RE +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import urllib2, json +>>> from pprint import pprint +>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, +\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.getVersion\*(Aq}) +>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) +>>> pprint(json\&.loads(c\&.read())) +{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, + u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, + u\*(Aqresult\*(Aq: {u\*(AqenabledFeatures\*(Aq: [u\*(AqAsync DNS\*(Aq, + u\*(AqBitTorrent\*(Aq, + u\*(AqFirefox3 Cookie\*(Aq, + u\*(AqGZip\*(Aq, + u\*(AqHTTPS\*(Aq, + u\*(AqMessage Digest\*(Aq, + u\*(AqMetalink\*(Aq, + u\*(AqXML\-RPC\*(Aq], + u\*(Aqversion\*(Aq: u\*(Aq1\&.11\&.0\*(Aq}} +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import xmlrpclib +>>> from pprint import pprint +>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) +>>> r = s\&.aria2\&.getVersion() +>>> pprint(r) +{\*(AqenabledFeatures\*(Aq: [\*(AqAsync DNS\*(Aq, + \*(AqBitTorrent\*(Aq, + \*(AqFirefox3 Cookie\*(Aq, + \*(AqGZip\*(Aq, + \*(AqHTTPS\*(Aq, + \*(AqMessage Digest\*(Aq, + \*(AqMetalink\*(Aq, + \*(AqXML\-RPC\*(Aq], + \*(Aqversion\*(Aq: \*(Aq1\&.11\&.0\*(Aq} +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.getSessionInfo ()\fP +.RS 4 +.sp +Этот метод возвращает информацию о сессии\&. Ответ имеет тип структура и +содежит следующие поля\&. +.PP +sessionId +.RS 4 +ID сессии, которое генерируется каждый раз, при запуске aria2\&. +.RE +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import urllib2, json +>>> from pprint import pprint +>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, +\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.getSessionInfo\*(Aq}) +>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) +>>> pprint(json\&.loads(c\&.read())) +{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, + u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, + u\*(Aqresult\*(Aq: {u\*(AqsessionId\*(Aq: u\*(Aqcd6a3bc6a1de28eb5bfa181e5f6b916d44af31a9\*(Aq}} +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import xmlrpclib +>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) +>>> s\&.aria2\&.getSessionInfo() +{\*(AqsessionId\*(Aq: \*(Aqcd6a3bc6a1de28eb5bfa181e5f6b916d44af31a9\*(Aq} +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.shutdown ()\fP +.RS 4 +.sp +Этот метод закрывает aria2\&. Метод возвращает "OK"\&. +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBaria2.forceShutdown ()\fP +.RS 4 +.sp +Этот метод закрывает aria2\&. Метод действует подобно \fBaria2\&.shutdown\fP, +за исключением того, что метод выполняется без каких\-либо действий, которые +требует времени, связь с BitTorrent\-трекером пропускается\&. +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBsystem.multicall (methods)\fP +.RS 4 +.sp +Этот метод объединяет несколько вызовов методов в один запрос\&. \fImethods\fP +имеет тип массив, а элемент является структурой\&. Структура содержит два +поля: "methodName" и "params"\&. "methodName" \- это имя вызываемого метода, +а "params" \- содержит параметры к методу\&. Метод возвращает массив +ответов\&. Элемент массива будет одним из двух: массивом из одного элемента, +который содержит возвращаемое значение, для каждого вызываемого метода или +структурой с ошибками в полях, если вызов объединенного метода завершился +неудачно\&. +.sp +В следующем примере мы добавляем 2 загрузки\&. Первая \- +http://example\&.org/file и вторая \- один \&.torrent\-файл: +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import urllib2, json, base64 +>>> from pprint import pprint +>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, +\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqsystem\&.multicall\*(Aq, +\&.\&.\&. \*(Aqparams\*(Aq:[[{\*(AqmethodName\*(Aq:\*(Aqaria2\&.addUri\*(Aq, +\&.\&.\&. \*(Aqparams\*(Aq:[[\*(Aqhttp://example\&.org\*(Aq]]}, +\&.\&.\&. {\*(AqmethodName\*(Aq:\*(Aqaria2\&.addTorrent\*(Aq, +\&.\&.\&. \*(Aqparams\*(Aq:[base64\&.b64encode(open(\*(Aqfile\&.torrent\*(Aq)\&.read())]}]]}) +>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) +>>> pprint(json\&.loads(c\&.read())) +{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: [[u\*(Aq1\*(Aq], [u\*(Aq2\*(Aq]]} +.fi +.if n \{\ +.RE +.\} +.sp +JSON\-RPC также поддерживает пакетный запрос, который описывается в +спецификации JSON\-RPC 2\&.0: +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> jsonreq = json\&.dumps([{\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, +\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.addUri\*(Aq, +\&.\&.\&. \*(Aqparams\*(Aq:[[\*(Aqhttp://example\&.org\*(Aq]]}, +\&.\&.\&. {\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqasdf\*(Aq, +\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.addTorrent\*(Aq, +\&.\&.\&. \*(Aqparams\*(Aq:[base64\&.b64encode(open(\*(Aqfile\&.torrent\*(Aq)\&.read())]}]) +>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) +>>> pprint(json\&.loads(c\&.read())) +[{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: u\*(Aq1\*(Aq}, + {u\*(Aqid\*(Aq: u\*(Aqasdf\*(Aq, u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, u\*(Aqresult\*(Aq: u\*(Aq2\*(Aq}] +.fi +.if n \{\ +.RE +.\} +.sp +В следующем примере мы добавляем 2 загрузки\&. Первая \- +http://example\&.org/file и вторая \- один \&.torrent\-файл: +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import xmlrpclib +>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) +>>> mc = xmlrpclib\&.MultiCall(s) +>>> mc\&.aria2\&.addUri([\*(Aqhttp://example\&.org/file\*(Aq]) +>>> mc\&.aria2\&.addTorrent(xmlrpclib\&.Binary(open(\*(Aqfile\&.torrent\*(Aq)\&.read())) +>>> r = mc() +>>> tuple(r) +(\*(Aq2\*(Aq, \*(Aq3\*(Aq) +.fi +.if n \{\ +.RE +.\} +.RE +.SS "Обработка ошибок" +.sp +В JSON\-RPC, aria2 возвращает JSON\-объект, который содержит код ошибки в коде +и сообщение об ошибке в сообщении\&. +.sp +В XML\-RPC, aria2 возвращает faultCode=1 и сообщение об ошибке в +faultString\&. +.SS Параметры +.sp +Те же параметры, что доступны для \fB\-i\fP\&. Смотрите подраздел \fBInput File\fP +для полного списка параметров\&. +.sp +В структуре, имя элемента \- это имя параметра (без "\-\-"), а значение +элемента \- аргумент в виде строки\&. +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПример JSON\-RPC\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +{\*(Aqsplit\*(Aq:\*(Aq1\*(Aq, \*(Aqhttp\-proxy\*(Aq:\*(Aqhttp://proxy/\*(Aq} +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПример XML\-RPC\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf + + + split + 1 + + + http\-proxy + http://proxy/ + + +.fi +.if n \{\ +.RE +.\} +.sp +Параметры \fBheader\fP и \fBindex\-out\fP допускают нескольких определений в +командной строке\&. Поскольку имя должно быть уникальным в структуре (многие +реализации библиотеки XML\-RPC использует хэш или словарь для структуры), +одной строки не достаточно\&. Для преодоления этой ситуации, они могут взять +массив в качестве значения, а также строку\&. +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПример JSON\-RPC\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +{\*(Aqheader\*(Aq:[\*(AqAccept\-Language: ja\*(Aq, \*(AqAccept\-Charset: utf\-8\*(Aq]} +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПример XML\-RPC\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf + + + header + + + + Accept\-Language: ja + Accept\-Charset: utf\-8 + + + + + +.fi +.if n \{\ +.RE +.\} +.sp +Следующий пример добавляет загрузку с двумя параметрами: dir и +header\&. Параметр header имеет 2 значения, поэтому используется список: +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import xmlrpclib +>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) +>>> opts = dict(dir=\*(Aq/tmp\*(Aq, +\&.\&.\&. header=[\*(AqAccept\-Language: ja\*(Aq, +\&.\&.\&. \*(AqAccept\-Charset: utf\-8\*(Aq]) +>>> s\&.aria2\&.addUri([\*(Aqhttp://example\&.org/file\*(Aq], opts) +\*(Aq1\*(Aq +.fi +.if n \{\ +.RE +.\} +.RE +.SS "JSON\-RPC используя HTTP GET" +.sp +JSON\-RPC\-интерфейс также поддерживает запрос через HTTP GET\&. Схема +кодирования в GET параметров основанных на JSON\-RPC через HTTP, описана в +спецификации (2008\-1\-15(RC1))\&. Кодирование параметров через GET следующие: +.sp +.if n \{\ +.RS 4 +.\} +.nf +/jsonrpc?method=METHOD_NAME&id=ID¶ms=BASE64_ENCODED_PARAMS +.fi +.if n \{\ +.RE +.\} +.sp +\fImethod\fP и \fIid\fP всегда обрабатывается как JSON\-строка и они должны быть в +кодировке UTF\-8\&. +.sp +Например, закодированная строка aria2\&.tellStatus(\fI3\fP) с id=\fIfoo\fP +выглядит так: +.sp +.if n \{\ +.RS 4 +.\} +.nf +/jsonrpc?method=aria2\&.tellStatus&id=foo¶ms=WyIzIl0%3D +.fi +.if n \{\ +.RE +.\} +.sp +Параметр \fIparams\fP \- это JSON\-массив в Base64\-кодировке, который обычно +появляется в атрибуте \fIparams\fP в JSON\-RPC\-запросе объекта\&. В примере +выше, params \- [\fI3\fP], следовательно: +.sp +.if n \{\ +.RS 4 +.\} +.nf +[\*(Aq3\*(Aq] \-\-(Base64)\-\-> WyIzIl0= \-\-(Percent Encode)\-\-> WyIzIl0%3D +.fi +.if n \{\ +.RE +.\} +.sp +JSON\-RPC\-интерфейс поддерживает JSONP\&. Вы можете определить функцию +обратного вызова в параметре \fIjsoncallback\fP\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +/jsonrpc?method=aria2\&.tellStatus&id=foo¶ms=WyIzIl0%3D&jsoncallback=cb +.fi +.if n \{\ +.RE +.\} +.sp +Для пакетного запроса, параметры \fImethod\fP и \fIid\fP не должны быть +указаны\&. Полный запрос должен быть определен в параметре +\fIparams\fP\&. Например, пакетный запрос +.sp +.if n \{\ +.RS 4 +.\} +.nf +[{\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, \*(Aqmethod\*(Aq:\*(Aqaria2\&.getVersion\*(Aq}, + {\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqasdf\*(Aq, \*(Aqmethod\*(Aq:\*(Aqaria2\&.tellActive\*(Aq}] +.fi +.if n \{\ +.RE +.\} +.sp +должен кодироваться так: +.sp +.if n \{\ +.RS 4 +.\} +.nf +/jsonrpc?params=W3sianNvbnJwYyI6ICIyLjAiLCAiaWQiOiAicXdlciIsICJtZXRob2QiOiAiYXJpYTIuZ2V0VmVyc2lvbiJ9LCB7Impzb25ycGMiOiAiMi4wIiwgImlkIjogImFzZGYiLCAibWV0aG9kIjogImFyaWEyLnRlbGxBY3RpdmUifV0%3D +.fi +.if n \{\ +.RE +.\} +.SS "Пример кода клиента XML\-RPC" +.sp +Следующий Ruby\-скрипт добавляет \fIhttp://localhost/aria2\&.tar\&.bz2\fP и +параметр \fB\-\-dir\fP=\fI/downloads\fP к aria2c, которая работает на localhost и +отображает ответ\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +#!/usr/bin/env ruby + +require \*(Aqxmlrpc/client\*(Aq +require \*(Aqpp\*(Aq + +client=XMLRPC::Client\&.new2("http://localhost:6800/rpc") + +options={ "dir" => "/downloads" } +result=client\&.call("aria2\&.addUri", [ "http://localhost/aria2\&.tar\&.bz2" ], options) + +pp result +.fi +.if n \{\ +.RE +.\} +.sp +Если вы любитель Python, то можете использовать xmlrpclib(для Python3\&.x, +используйте взамен xmlrpc\&.client) для взаимодействия с aria2\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +import xmlrpclib +from pprint import pprint + +s = xmlrpclib\&.ServerProxy("http://localhost:6800/rpc") +r = s\&.aria2\&.addUri(["http://localhost/aria2\&.tar\&.bz2"], {"dir":"/downloads"}) +pprint(r) +.fi +.if n \{\ +.RE +.\} +.SH ПРИМЕРЫ +.SS "Загрузка по HTTP/FTP" +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBЗагрузка файла\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c "http://host/file\&.zip" +.fi +.if n \{\ +.RE +.\} +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Для остановки загрузки, нажмите Ctrl\-C\&. Вы можете возобновить передачу, +запустив aria2c с теми же аргументами в том же каталоге\&. Вы можете +изменить URI, если они указывают на тот же самый файл\&. +.sp .5v +.RE +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBЗагрузка файла с 2\-ух разных HTTP\-серверов\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c "http://host/file\&.zip" "http://mirror/file\&.zip" +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBЗагрузка файла с одно хоста, используя 2 соединения\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-x2 \-k1M "http://host/file\&.zip" +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBЗагрузка файла с HTTP\- и FTP\-серверов\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c "http://host1/file\&.zip" "ftp://host2/file\&.zip" +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBОдновременная загрузка файлов, перечисленных в текстовом файле\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-ifiles\&.txt \-j2 +.fi +.if n \{\ +.RE +.\} +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +параметр \-j указывает количество параллельных загрузок\&. +.sp .5v +.RE +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBИспользование прокси\-сервера\fP +.RS 4 +.sp +Для HTTP: +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-http\-proxy="http://proxy:8080" "http://host/file" +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-http\-proxy="http://proxy:8080" \-\-no\-proxy="localhost,127\&.0\&.0\&.1,192\&.168\&.0\&.0/16" "http://host/file" +.fi +.if n \{\ +.RE +.\} +.sp +Для FTP: +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-ftp\-proxy="http://proxy:8080" "ftp://host/file" +.fi +.if n \{\ +.RE +.\} +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Смотрите для подробностей \fB\-\-http\-proxy\fP, \fB\-\-https\-proxy\fP, \fB\-\-ftp\-proxy\fP, +\fB\-\-all\-proxy\fP и \fB\-\-no\-proxy\fP\&. Вы можете указать прокси в переменных +окружения\&. Смотрите раздел \fBОКРУЖЕНИЕ\fP\&. +.sp .5v +.RE +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПрокси\-сервер с авторизацией\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-http\-proxy="http://username:password@proxy:8080" "http://host/file" +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-http\-proxy="http://proxy:8080" \-\-http\-proxy\-user="username" \-\-http\-proxy\-passwd="password" "http://host/file" +.fi +.if n \{\ +.RE +.\} +.RE +.SS "Загрузка Metalink" +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBЗагрузка файлов с удалленного Metalink\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-follow\-metalink=mem "http://host/file\&.metalink" +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBЗагрузка, используя локальный metalink\-файл\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-p \-\-lowest\-speed\-limit=4000 file\&.metalink +.fi +.if n \{\ +.RE +.\} +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Для остановки загрузки, нажмите Ctrl\-C\&. Вы можете возобновить передачу, +запустив aria2c с теми же аргументами в том же каталоге\&. +.sp .5v +.RE +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBЗагрузка нескольких локальных metalink\-файлов\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-j2 file1\&.metalink file2\&.metalink +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBЗагрузка только выбранных файлов, используя индекс\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-select\-file=1\-4,8 file\&.metalink +.fi +.if n \{\ +.RE +.\} +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Индекс выводится на консоль при использовании параметра \-S\&. +.sp .5v +.RE +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBЗагрузка файла, используя локальный .metalink\-файл с пользовательскими +настройками\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-metalink\-location=jp,us \-\-metalink\-version=1\&.1 \-\-metalink\-language=en\-US file\&.metalink +.fi +.if n \{\ +.RE +.\} +.RE +.SS "Загрузка BitTorrent" +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBЗагрузка файлов из удаленного BitTorrent\-файла\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-follow\-torrent=mem "http://host/file\&.torrent" +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBЗагрузка, используя локальный torrent\-файл\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-max\-upload\-limit=40K file\&.torrent +.fi +.if n \{\ +.RE +.\} +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +\-\-max\-upload\-limit определяет максимальную скорость отдачи\&. +.sp .5v +.RE +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Для остановки загрузки, нажмите Ctrl\-C\&. Вы можете возобновить передачу, +запустив aria2c с теми же аргументами в том же каталоге\&. +.sp .5v +.RE +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBЗагрузка, используя BitTorrent Magnet URI\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c "magnet:?xt=urn:btih:248D0A1CD08284299DE78D5C1ED359BB46717D8C&dn=aria2" +.fi +.if n \{\ +.RE +.\} +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Не забывайте заключать BitTorrent Magnet URI, в которой есть символ "&", в +одиночные(\*(Aq) или двойные(") кавычки\&. +.sp .5v +.RE +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBЗагрузка 2\-х торрентов\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-j2 file1\&.torrent file2\&.torrent +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBЗагрузка файла, используя торрент и HTTP/FTP\-сервер\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-Ttest\&.torrent "http://host1/file" "ftp://host2/file" +.fi +.if n \{\ +.RE +.\} +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Загрузка много файлового торрента через HTTP/FTP не поддерживается\&. +.sp .5v +.RE +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBЗагрузка только выбранных файлов, используя индекс (обычно называют +"выборочная загрузка")\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-select\-file=1\-4,8 file\&.torrent +.fi +.if n \{\ +.RE +.\} +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Индекс выводится на консоль при использовании параметра \-S\&. +.sp .5v +.RE +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBУказание имени выходного файла\fP +.RS 4 +.sp +Для указания выходного имени файла в BitTorrent\-загрузках, вам нужно узнать +индекс файла в torrent\-файле, используя параметр \fB\-S\fP\&. Например, +результат выглядит следующим образом: +.sp +.if n \{\ +.RS 4 +.\} +.nf +idx|path/length +===+====================== + 1|dist/base\-2\&.6\&.18\&.iso + |99\&.9MiB +\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- + 2|dist/driver\-2\&.6\&.18\&.iso + |169\&.0MiB +\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- +.fi +.if n \{\ +.RE +.\} +.sp +Сохраняет \fIdist/base\-2\&.6\&.18\&.iso\fP в \fI/tmp/mydir/base\&.iso\fP и +\fIdist/driver\-2\&.6\&.18\&.iso\fP в \fI/tmp/dir/driver\&.iso\fP, при +использовании следующей команды: +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-dir=/tmp \-\-index\-out=1=mydir/base\&.iso \-\-index\-out=2=dir/driver\&.iso file\&.torrent +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBИзменение прослушиваемого порта для входящих соединений от пиров\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-listen\-port=7000\-7001,8000 file\&.torrent +.fi +.if n \{\ +.RE +.\} +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Т.к. aria2 не настраивает брандмауэр или маршрутизатор для перенаправления +портов, вам решать как это сделать вручную\&. +.sp .5v +.RE +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBУказать условие остановки программы после завершения загрузки торрента\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-seed\-time=120 \-\-seed\-ratio=1\&.0 file\&.torrent +.fi +.if n \{\ +.RE +.\} +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +В приведенном выше примере, программа завершается через 120 минут после +завершения загрузки или при достижении рейтинга сидирования 1\&.0\&. +.sp .5v +.RE +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBРегулировка скорости отдачи\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-max\-upload\-limit=100K file\&.torrent +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBВключить IPv4 DHT\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-enable\-dht \-\-dht\-listen\-port=6881 file\&.torrent +.fi +.if n \{\ +.RE +.\} +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +DHT использует udp\-порт\&. Так как aria2 не настраивает брандмауэр или +маршрутизатор для перенаправления портов, вам решать как это сделать +вручную\&. +.sp .5v +.RE +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBВключить IPv6 DHT\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-enable\-dht6 \-\-dht\-listen\-port=6881 \-\-dht\-listen\-addr6=YOUR_GLOBAL_UNICAST_IPV6_ADDR \-\-enable\-async\-dns6 +.fi +.if n \{\ +.RE +.\} +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Если aria2c не собрана с c\-ares, то \fB\-\-enable\-async\-dns6\fP не нужен\&. aria2 +разделяет один и тот же порт между IPv4 и IPv6 DHT\&. +.sp .5v +.RE +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBДобавить и удалить URI трекера\fP +.RS 4 +.sp +Удалить все URI анонса трекеров, описанных в \&.torrent\-файле и взамен +использовать "http://tracker1/announce" и "http://tracker2/announce"\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-bt\-exclude\-tracker="*" \-\-bt\-tracker="http://tracker1/announce,http://tracker2/announce" file\&.torrent +.fi +.if n \{\ +.RE +.\} +.RE +.SS "Больше расширенных возможностей для HTTP" +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBЗагрузить куки\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-load\-cookies=cookies\&.txt "http://host/file\&.zip" +.fi +.if n \{\ +.RE +.\} +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Вы можите использовать без изменения cookie\-файл Firefox/Mozilla/Chromium\&. +.sp .5v +.RE +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBВозобновление загрузки, которая начата в браузере или другой программе\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-c \-s2 "http://host/partiallydownloadedfile\&.zip" +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBКлиентский сертификат авторизации для SSL/TLS\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-certificate=/path/to/mycert\&.pem \-\-private\-key=/path/to/mykey\&.pem https://host/file +.fi +.if n \{\ +.RE +.\} +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Указанный в \fB\-\-private\-key\fP файл должен быть расшифрован\&. Режим работы с +исходно зашифрованным закрытым ключом не определен\&. +.sp .5v +.RE +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПроверить узел при SSL/TLS, используя исходные CA\-сертификаты\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-ca\-certificate=/path/to/ca\-certificates\&.crt \-\-check\-certificate https://host/file +.fi +.if n \{\ +.RE +.\} +.RE +.SS "И еще больше расширенных возможностей" +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBРегулировка скорости загрузки\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-max\-download\-limit=100K file\&.metalink +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBИсправить поврежденную загрузку\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-V file\&.metalink +.fi +.if n \{\ +.RE +.\} +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Этот параметр доступен только при использовании BitTorrent или metalink с +контрольными суммами блоков данных\&. +.sp .5v +.RE +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBОтклонить соединение, если скорость загрузки меньше чем определенное +значение\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-lowest\-speed\-limit=10K file\&.metalink +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПоддержка параметризованных URI\fP +.RS 4 +.sp +Вы можете определить набор частей: +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-P "http://{host1,host2,host3}/file\&.iso" +.fi +.if n \{\ +.RE +.\} +.sp +Вы можете определить числовую последовательность: +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-Z \-P "http://host/image[000\-100]\&.png" +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПримечание\fP +.ps -1 +.br +.sp +Параметр \-Z необходим, если все URI не указывают на один и тот же файл, как +в примере указанном выше\&. +.sp .5v +.RE +.sp +Вы можете определить шаг счетчика: +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-Z \-P "http://host/image[A\-Z:2]\&.png" +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBПараллельные загрузки с произвольным числом URI,metalink,torrent\fP +.RS 4 +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-j3 \-Z "http://host/file1" file2\&.torrent file3\&.metalink +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBШифрование BitTorrent\fP +.RS 4 +.sp +Шифровать всю полезную нагрузку используя ARC4: +.sp +.if n \{\ +.RS 4 +.\} +.nf +aria2c \-\-bt\-min\-crypto\-level=arc4 \-\-bt\-require\-crypto=true file\&.torrent +.fi +.if n \{\ +.RE +.\} +.RE +.SH "СМОТРИТЕ ТАКЖЕ" +.sp +Веб\-сайт проекта: http://aria2\&.sourceforge\&.net/ +.sp +Вики aria2: http://sourceforge\&.net/apps/trac/aria2/wiki +.sp +Домашняя страница Metalink: http://www\&.metalinker\&.org/ +.sp +Описание формата Metalink: http://tools\&.ietf\&.org/html/rfc5854 +.SH "АВТОРСКОЕ ПРАВО" +.sp +Авторское право \(co 2006, 2011 Tatsuhiro Tsujikawa +.sp +Эта программа является свободным программным обеспечением; вы можете +распространять его и/или изменять его в соответствии с условиями лицензии +GNU General Public License, опубликованной Free Software Foundation; либо +License версии 2, либо (по вашему выбору) любой более поздней версии\&. +.sp +Эта программа распространяется в надежде, что она будет полезной, но БЕЗ +КАКИХ\-ЛИБО ГАРАНТИЙ, даже без подразумеваемых гарантий КОММЕРЧЕСКОЙ ЦЕННОСТИ +или ПРИГОДНОСТИ ДЛЯ ОПРЕДЕЛЕННОЙ ЦЕЛИ\&. См. GNU General Public License для +более подробной информации\&. +.sp +Вы должны получить копию GNU General Public License вместе с этой +программой; если нет, напишите в Free Software Foundation, Inc\&., 51 +Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA +.sp +Кроме того, в качестве особого исключения, владельцы авторских прав дают +разрешение на ссылку части кода этой программы с библиотекой OpenSSL при +определенных условиях, как описано в каждом отдельном исходном файле, а +также распространять эту комбинацию вместе\&. Вы должны подчиняться GNU +General Public License во всех отношениях для всего используемого кода, +кроме OpenSSL\&. Если вы измените файл(ы) с этим исключением, вы можете +расширить это исключение для вашей версии файла(ов), но вы не обязаны делать +это\&. Если вы не хотите сделать это, удалите это заявление об исключении из +вашей версии\&. Если вы удалите это заявление об исключении из всех исходных +файлов в программе, то удалить его и здесь\&. +.SH АВТОР +.PP +\fBTatsuhiro Tsujikawa\fP <\&t\-tujikawa@users\&.sourceforge\&.net\&> +.RS 4 +Автор. +.RE + +.SH "АВТОР ПЕРЕВОДА" +ITriskTI +.SH "ПРИМЕЧАНИЕ +Эта страница руководства может содержать не обязательно самую последнюю информацию. Если есть некоторые противоречия между этой страницей руководства и фактическим программным обеспечением, пожалуйста, обращайтесь к английской версии страницы руководства. \ No newline at end of file