diff --git a/doc/ru/aria2c.1.asciidoc b/doc/ru/aria2c.1.asciidoc index 534acd2a..4601348c 100644 --- a/doc/ru/aria2c.1.asciidoc +++ b/doc/ru/aria2c.1.asciidoc @@ -51,7 +51,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може [[aria2_optref_max_concurrent_downloads]]*-j*, *--max-concurrent-downloads*=N:: Задать максимальное количество параллельных загрузок для каждого статического (HTTP/FTP) URI, torrent и metalink. Смотрите также - параметры *<>* и *<>*. + параметр *<>*. По умолчанию: '5' [[aria2_optref_check_integrity]]*-V*, *--check-integrity*[='true'|'false']:: @@ -60,7 +60,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може полного файла. Этот параметр влияет лишь на BitTorrent, Metalink или HTTP(S)/FTP загрузки с параметром *<>*. Параметр может обнаружить поврежденные части файла и перезагрузить их. - Если есть хэш полного файла, то проверка выполняется только когда файл + Если есть хэш полного файла, то проверка выполняется только, когда файл уже полностью загружен. Момент полной загрузки определяется по размеру файла. Если проверка хэша завершилась неудачно, то файл будет перезагружен с нуля. Если есть хэши блоков и хэш полного файла, то будут @@ -84,7 +84,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може содержащих это слово. Возможные значения: '#basic', '#advanced', '#http', '#https', '#ftp', '#metalink', '#bittorrent', '#cookie', '#hook', '#file', '#rpc', '#checksum', '#experimental', - '#deprecated', '#help', '#all' + '#deprecated', '#help', '#all'. По умолчанию: '#basic' Параметры HTTP/FTP @@ -128,7 +128,7 @@ http-proxy-passwd="mypass" в aria2.conf и вы указали [[aria2_optref_checksum]]*--checksum*=TYPE=DIGEST:: Задать контрольную сумму. TYPE - тип хэша. Поддерживаемые типы хэшей - перечислены в "Hash Algorithms" при "aria2c -v". + перечислены в "Алгоритмы хэширования" при "aria2c -v". DIGEST - шестнадцатеричное значение хэша. Например, указание значения sha-1 хэша выглядит так: sha-1=0192ba11326fe2298c8cb4de616f4d4140213838 @@ -136,7 +136,7 @@ http-proxy-passwd="mypass" в aria2.conf и вы указали [[aria2_optref_connect_timeout]]*--connect-timeout*=SEC:: Задать в соединении время ожидания в секундах для установки - подключения к HTTP/FTP/прокси серверу. После установки + подключения к HTTP/FTP/прокси-серверу. После установки подключения этот параметр не имеет значения, и вместо него используется параметр *<>*. По умолчанию: '60' @@ -149,7 +149,7 @@ http-proxy-passwd="mypass" в aria2.conf и вы указали По умолчанию: 'false' [[aria2_optref_lowest_speed_limit]]*--lowest-speed-limit*=SPEED:: - Закрывать подключение, если скорость загрузки меньше чем или равна + Закрывать соединение, если скорость загрузки меньше чем или равна значению SPEED (байт в секунду). '0' означает, что aria2 не имеет нижнего ограничения скорости. Вы можете добавить 'K' или 'M' (1K = 1024, 1M = 1024K). Этот параметр не влияет на @@ -165,7 +165,7 @@ http-proxy-passwd="mypass" в aria2.conf и вы указали [[aria2_optref_max_file_not_found]]*--max-file-not-found*=NUM:: Если aria2 получает статус "file not found" (файл не найден) с - удаленных HTTP/FTP-серверов NUM раз без получения хотя бы одного байта, + удаленных HTTP/FTP-серверов NUM раз без получения, хотя бы одного байта, тогда принудительно отказывается от загрузки. Укажите '0', чтобы отключить этот параметр. Этот параметр действенен только, когда используются HTTP/FTP-серверы. @@ -181,10 +181,10 @@ http-proxy-passwd="mypass" в aria2.conf и вы указали aria2 не разбивает на части меньше чем 2*SIZE байт. Например, нужно загрузить файл размером 20МиБ. Если SIZE задать 10M, то aria2 может разбить файл на части в 2-ух диапазонах [0-10МиБ) и - [10МиБ-20МиБ) и загрузить его используя 2 источника + [10МиБ-20МиБ) и загрузить его, используя 2 источника (если *<>* >= 2, конечно же). Если SIZE задать 15M, т.к. 2*15M > 20MiB, aria2 не разобьет файл - на части и загрузит его используя 1 источник. Вы можете + на части и загрузит его, используя 1 источник. Вы можете добавить 'K' или 'M'(1K = 1024, 1M = 1024K). Возможные значения: '1M'-'1024M'. По умолчанию: '20M' @@ -193,6 +193,15 @@ http-proxy-passwd="mypass" в aria2.conf и вы указали Отключить поддержку netrc. Поддержка netrc по умолчанию включена. +[NOTE] + +Файл netrc считывается только при запуске, если *<>* задан как 'false'. Так что если *<>* задан как 'true' при загрузке, то netrc недоступен на +протяжении всей сессии. Вы не сможете получить доступ к netrc, даже если +отправите *<>*='false', используя +*<>*. + [[aria2_optref_no_proxy]]*--no-proxy*=DOMAINS:: Укажите через запятую имена хостов, домены и сетевые адреса с CIDR-блоком, или без него, для которых не будет использоваться прокси. @@ -201,8 +210,8 @@ http-proxy-passwd="mypass" в aria2.conf и вы указали Для сетевых адресов с CIDR-блоком (метод IP-адресации, например 192.168.0.20/24), работают только IPv4 адреса. Текущая реализация не разрешает имена хостов в URI для сравнения сетевых адресов указанных в -*<>*. Таким образом это эффективно только -если в URI есть IP-адреса. +*<>*. Таким образом, это эффективно, +только если в URI есть IP-адреса. [[aria2_optref_out]]*-o*, *--out*=FILE:: @@ -212,7 +221,7 @@ http-proxy-passwd="mypass" в aria2.conf и вы указали [NOTE] В Metalink или BitTorrent загрузках вы не можете указать имя файла. Имя -файла указывается здесь только когда используются URI и aria2 с командной +файла указывается здесь, только когда используются URI и aria2 с командной строкой без параметров *<>*, *<>*. Например: aria2c -o myfile.zip "http://mirror1/file.zip" "http://mirror2/file.zip" @@ -272,13 +281,16 @@ http-proxy-passwd="mypass" в aria2.conf и вы указали так чтобы были задействованы все N соединений одновременно. Количество соединений к одному и тому же хосту ограничивается параметром *<>*. - Пожалуйста, смотрите также параметр - *<>* и - *<>*. Обратите внимание, - что для Metalink загрузок этот параметр не эффективен, вместо него - используйте параметр *<>*. + Смотрите также параметр *<>*. По умолчанию: '5' +[NOTE] + +Некоторые Metalink регламентируют количество серверов для соединения. aria2 +строго придерживается этого. Это значит, что если Metalink определяет +атрибут maxconnections меньше чем N, то aria2 использует значение атрибута +maxconnections вместо N. + [[aria2_optref_stream_piece_selector]]*--stream-piece-selector*=SELECTOR:: Указать алгоритм выбора блока, который используется в HTTP/FTP-загрузке. @@ -296,7 +308,7 @@ http-proxy-passwd="mypass" в aria2.conf и вы указали *<>*, так что необходимо будет указать разумное значение параметра *<>*. - Если задано 'geom', то aria2 в начале выберет блок с минимальным + Если задано 'geom', то aria2 вначале выберет блок с минимальным индексом, как при 'inorder', однако она сохранит экспоненциально большую область от ранее выбранного блока. Это уменьшит количество установленных подключений и в то же @@ -356,7 +368,7 @@ http-proxy-passwd="mypass" в aria2.conf и вы указали [NOTE] Некоторые серверы отвечают "Content-Encoding: gzip" для файлов, которые сами -по себе сжаты (gzipped). aria2 добавляет их так или иначе из-за заголовка +по себе сжаты (gzipped). aria2 добавляет их, так или иначе, из-за заголовка ответа. [[aria2_optref_http_auth_challenge]]*--http-auth-challenge*[='true'|'false']:: @@ -371,7 +383,7 @@ http-proxy-passwd="mypass" в aria2.conf и вы указали Отправлять заголовок Cache-Control: no-cache и Pragma: no-cache, чтобы избежать кэширования содержимого. Если задано 'false', то эти - заголовки не посылаются и вы можете добавить любую директиву к + заголовки не посылаются, и вы можете добавить любую директиву к заголовку Cache-Control с помощью параметра *<>*. По умолчанию: 'true' @@ -452,7 +464,7 @@ Chromium/Google Chrome не поддерживаются. Сохранить куки в FILE формате Mozilla/Firefox(1.x/2.x)/Netscape. Если FILE уже существует, то он будет перезаписан. Куки-сессия также - сохранится и значение ее окончания будет трактоваться как 0. + сохранится, и значение ее окончания будет трактоваться как 0. Возможные значения: '/путь/к/файлу' [[aria2_optref_use_head]]*--use-head*[='true'|'false']:: @@ -475,7 +487,7 @@ Chromium/Google Chrome не поддерживаются. Задать пароль для FTP. Влияет на все URI. Если имя пользователя встроено, но пароль отсутствует в URI, то aria2 пытается использовать пароль из .netrc. Если пароль найден в .netrc, то он используется. - Если нет, используется пароль указанный в этом параметре. + Если нет, используется пароль, указанный в этом параметре. По умолчанию: 'ARIA2USER@' [[aria2_optref_ftp_pasv]]*-p*, *--ftp-pasv*[='true'|'false']:: @@ -519,7 +531,7 @@ Chromium/Google Chrome не поддерживаются. от запроса (смотрите параметры *--metalink-**). [NOTE] -В много файловом торренте, смежные файлы, указанные в этом параметре также +В многофайловом торренте, смежные файлы, указанные в этом параметре также могут быть загружены. Это не ошибка, а особенность утилиты. Одиночный блок данных может включать несколько файлов или часть файла, и aria2 запишет блок данных соответствующего файла. @@ -543,7 +555,7 @@ Chromium/Google Chrome не поддерживаются. Разделенный запятыми список URI анонса BitTorrent-трекера, которые будут исключены. Вы можете использовать специальное - значение "*", которое соответствует всем URI, таким образом + значение "*", которое соответствует всем URI, таким образом, исключаются все URI анонса. При указании "*" в оболочке командной строке, не забывайте, экранировать или брать в кавычки. Смотрите также параметр *<>*. @@ -556,7 +568,7 @@ Chromium/Google Chrome не поддерживаются. [[aria2_optref_bt_hash_check_seed]]*--bt-hash-check-seed*[='true'|'false']:: Если задано 'true', то после проверки хэша с использованием параметра - *<>* и когда файл + *<>*, и когда файл загружен полностью, продолжается раздача файла. Если вы хотите проверить файл и загрузить его только если он поврежден или не загружен полностью, то задайте этот параметр как 'false'. Этот параметр влияет @@ -583,8 +595,8 @@ Chromium/Google Chrome не поддерживаются. [[aria2_optref_bt_metadata_only]]*--bt-metadata-only*[='true'|'false']:: Загрузить только метаданные. Файл(ы), описывающий метаданные не - должен быть загружен. Этот параметр эффективен только если - спользуется BitTorrent Magnet-ссылка. Смотрите также параметр + должен быть загружен. Этот параметр эффективен, только если + используется BitTorrent Magnet-ссылка. Смотрите также параметр *<>*. По умолчанию: 'false' @@ -611,12 +623,12 @@ Chromium/Google Chrome не поддерживаются. [[aria2_optref_bt_require_crypto]]*--bt-require-crypto*[='true'|'false']:: Если задано 'true', aria2 не принимает и не устанавливает соединение с унаследованным BitTorrent handshake-сообщением (рукопожатие) - (BitTorrent протокол). Таким образом aria2 всегда использует обфускацию + (BitTorrent протокол). Таким образом, aria2 всегда использует обфускацию handshake-сообщения. По умолчанию: 'false' [[aria2_optref_bt_request_peer_speed_limit]]*--bt-request-peer-speed-limit*=SPEED:: - Если итоговая скорость загрузки каждого торрента ниже чем SPEED, + Если итоговая скорость загрузки каждого торрента, ниже чем SPEED, aria2 временно увеличивает количество узлов, пытаясь увеличить скорость загрузки. Настройка этого параметра с выбранной вами скоростью загрузки может, в некоторых случаях, увеличить вашу @@ -666,7 +678,7 @@ Chromium/Google Chrome не поддерживаются. Задать интервал в секундах между запросами трекера. Это полностью отменяет значение интервала и aria2 использует только это значение и игнорирует минимальный интервал и значение интервала в ответе - трекера. Если задан '0', aria2 определяет интервал основываясь на + трекера. Если задан '0', aria2 определяет интервал, основываясь на ответе трекера и прогрессе загрузки. По умолчанию: '0' @@ -736,14 +748,14 @@ Chromium/Google Chrome не поддерживаются. [[aria2_optref_follow_torrent]]*--follow-torrent*='true'|'false'|'mem':: Если указать 'true' или 'mem', тогда загруженный файл, расширение которого - ".torrent" или mime-тип - "application/x-bittorrent", - aria2 анализирует как torrent-файл и загружает файлы указанные в нем. + aria2 анализирует как torrent-файл и загружает файлы, указанные в нем. Если указано 'mem', тогда torrent-файл не записывается на диск, а содержится в памяти. Если указано 'false', действия, упомянутые - выше не совершаются. + выше, не совершаются. По умолчанию: 'true' [[aria2_optref_index_out]]*-O*, *--index-out*=INDEX=PATH:: - Задать путь к файлу с индексом=INDEX. Вы можете найти индекс файла + Задать путь к файлу PATH с индексом INDEX. Вы можете найти индекс файла, используя параметр *<>*. PATH является относительным путем к тому, который указан в параметре *<>*. Вы можете использовать этот параметр @@ -751,8 +763,8 @@ Chromium/Google Chrome не поддерживаются. выходных файлов для BitTorrent-загрузок. [[aria2_optref_listen_port]]*--listen-port*=PORT...:: - Указать номер TCP-порта для BitTorrent-загрузок. Несколько портов можно - указать используя ",", например: '6881,6885'. Вы также можете + Задать номер TCP-порта для BitTorrent-загрузок. Несколько портов можно + указать, используя ",", например: '6881,6885'. Вы также можете использовать "-", чтобы указать диапазон: '6881-6999'. "," и "-" могут быть использованы вместе: '6881-6889,6999'. По умолчанию: '6881-6999' @@ -833,16 +845,6 @@ Chromium/Google Chrome не поддерживаются. имени файла указано '-'. Вы не обязаны использовать этот параметр, т.к. файлы .metalink можно указать без *<>*. -[[aria2_optref_metalink_servers]]*-C*, *--metalink-servers*=NUM_SERVERS:: - Количество серверов для одновременного подключения. Некоторые - Metalink регулируют количество серверов для соединения. aria2 - точно придерживается их. Это значит, что если Metalink определяет - атрибут maxconnections ниже чем NUM_SERVERS, тогда aria2 использует - значение атрибута maxconnections вместо NUM_SERVERS. Смотрите также - параметры *<>* и - *<>*. - По умолчанию: '5' - [[aria2_optref_metalink_language]]*--metalink-language*=LANGUAGE:: Язык файла для загрузки. @@ -953,7 +955,7 @@ Chromium/Google Chrome не поддерживаются. Разделенный запятыми список адресов DNS-серверов, которые используют асинхронный DNS-преобразователь. Обычно асинхронный DNS-преобразователь читает адреса DNS-серверов из '/etc/resolv.conf'. Когда используется - этот параметр, то используются DNS-серверы указанные в параметре вместо + этот параметр, то используются DNS-серверы, указанные в параметре вместо указанных в '/etc/resolv.conf'. Вы можете указать оба IPv4 и IPv6 адреса. Этот параметр полезен, когда в системе нет '/etc/resolv.conf' и у пользователя нет прав на его создание. @@ -974,7 +976,7 @@ Chromium/Google Chrome не поддерживаются. [[aria2_optref_conditional_get]]*--conditional-get*[='true'|'false']:: - Загружать файл только когда локальный файл старше чем удаленный. + Загружать файл только когда локальный файл старше, чем удаленный. Эта функция работает только для HTTP(S)-загрузок. Это не работает, если размер файла указан в Metalink. Это также игнорирует заголовок Content-Disposition. Если контрольный файл существует, то этот @@ -1010,7 +1012,7 @@ Chromium/Google Chrome не поддерживаются. задан как 'default', то отображается GID, статус, средняя скорость загрузки и путь/URI. Если загружается множество файлов, то отобразиться путь/URI первого запрашиваемого файла, а остальные пропускаются. Если OPT задан как 'full', - то отображается GID, стаус, средняя скорость загрузки, процент прогресса и + то отображается GID, статус, средняя скорость загрузки, процент прогресса и путь/URI. Процент прогресса и путь/URI отобразиться для каждого запрашиваемого файла в отдельной строке. По умолчанию: 'default' @@ -1146,7 +1148,7 @@ Chromium/Google Chrome не поддерживаются. остановлена. Вы можете изменить команду, которая будет выполнятся при определенном результате загрузки, используя параметры *<>* и *<>*. - Если они указаны, то команда определенная в этом параметре не + Если они указаны, то команда, определенная в этом параметре не будет выполнятся. Смотрите раздел *<<_перехват_сообщения, Перехват сообщения>>* для более подробной информации о COMMAND. Возможные значения: '/путь/к/команде' @@ -1156,14 +1158,14 @@ Chromium/Google Chrome не поддерживаются. Задать длину блока для HTTP/FTP-загрузок. Это является границей, когда aria2 разделяет файл на части. Все разделения происходят многократно по этой длине. Этот параметр будет игнорироваться при BitTorrent-загрузках. - Также будет игнорироваться если Metalink-файл содержит хэши блоков. + Также будет игнорироваться, если Metalink-файл содержит хэши блоков. По умолчанию: '1M' [NOTE] Возможный вариант использования параметра *<>* - изменение диапазона запроса в одном конвейерном -HTTP-запросе. Для включение конвейерной обработки HTTP используйте +HTTP-запросе. Для включения конвейерной обработки HTTP используйте *<>*. [[aria2_optref_show_console_readout]]*--show-console-readout*[='true'|'false']:: @@ -1177,7 +1179,7 @@ HTTP-запросе. Для включение конвейерной обраб По умолчанию: '60' [NOTE] -В загрузках много файлового торрента, по определенным смежным файлам также, +В загрузках многофайлового торрента, по определенным смежным файлам также, которые размещены в части одного блока. [[aria2_optref_force_sequential]]*-Z*, *--force-sequential*[='true'|'false']:: @@ -1234,20 +1236,14 @@ HTTP-запросе. Для включение конвейерной обраб всегда загружается с нуля. Это может понадобиться пользователям за прокси-сервером, не поддерживающим возобновление загрузки. -[NOTE] - -Для Metalink-загрузок, -C1 рекомендуется для прокси-серверов, не -поддерживающих возобновление загрузки, во избежании создания лишних -соединений. - [[aria2_optref_save_session]]*--save-session*=FILE:: Сохранять ошибочные/незаконченные загрузки в FILE при выходе. Вы можете передать этот выходной файл aria2c с параметром *<>* при перезапуске. Обратите внимание, что - загрузки добавленные через RPC-методы + загрузки, добавленные через RPC-методы *<>*, *<>* и чьи метаданные не могут быть сохранены как файл, не будут сохраняться. - Загрузки удаленные с использованием *<>* и + Загрузки, удаленные с использованием *<>* и *<>* не будут сохранены. [[aria2_optref_stop]]*--stop*=SEC:: @@ -1256,6 +1252,14 @@ HTTP-запросе. Для включение конвейерной обраб отключена. По умолчанию: '0' +[[aria2_optref_stop_with_process]]*--stop-with-process*=PID:: + + Остановить приложение, когда процесс с идентификационный номером PID + не работает. Это полезно, если процесс aria2 запущен из родительского + процесса. Родительский процесс может запустить aria2 со своим + идентификационным номером и когда он (процесс) завершиться по какой-то + причине, aria2 может обнаружить это и самостоятельно завершиться. + [[aria2_optref_truncate_console_readout]]*--truncate-console-readout*[='true'|'false']:: Укорачивать консольный вывод, чтобы он поместился в @@ -1300,13 +1304,13 @@ Metalink-документов, которые хранятся на локаль что они всегда будут обрабатываться как отдельная загрузка. Поддерживаются оба формата: Metalink4 и Metalink версии 3.0. -Вы можете указать вместе, torrent-файл c параметром -T и URI. Сделав это, вы -можете загружать файл используя torrent-рой и HTTP(S)/FTP-сервер -одновременно, пока данные из HTTP(S)/FTP выгружаются в torrent-рой. Для одно -файловых торрентов, URI может быть завершенным, который указывает на ресурс, -или же если заканчиваться символом /, тогда name (имя) в torrent-файле будет -добавлено. Для много файловых торентов, name (имя) и path (путь) в -torrent-файле будут добавлены из URI для каждого файла. +Вы можете указать вместе, torrent-файл с параметром -T и URI. Сделав это, вы +можете загружать файл, используя torrent-рой и HTTP(S)/FTP-сервер +одновременно, пока данные из HTTP(S)/FTP выгружаются в torrent-рой. Для +однофайловых торрентов, URI может быть завершенным, который указывает на +ресурс, или же если заканчиваться символом /, тогда name (имя) в +torrent-файле будет добавлено. Для многофайловых торентов, name (имя) и path +(путь) в torrent-файле будут добавлены из URI для каждого файла. [NOTE] Удостоверьтесь, что URI заключен в одинарные(') или двойные(") кавычки, если @@ -1327,7 +1331,7 @@ torrent-файле будут добавлены из URI для каждого ~~~~~~~~~~~~~~~~~~ aria2 предоставляет параметры, в которых указываются произвольные команды, -выполняемые после наступления определенного события. В настоящие время +выполняемые после наступления определенного события. В настоящее время доступны следующие параметры: *<>*, *<>*, *<>* в командной строке заменяет эту переменную. @@ -1577,18 +1581,21 @@ Netrc поддержки netrc, укажите параметр *<>*. Ваш файл .netrc должен иметь соответствующие права (600). -Если имя машины (machine) начинается с ".", то aria2 представляет это как -соответствие домену вместо точного соответствия. Это расширение -aria2. Пример соответствия домену, представляет следующие содержимое .netrc: +Если имя машины (machine) начинается с ".", то aria2 выполняет доменное +сопоставление вместо точного соответствия. Это расширение aria2. Пример +доменного сопоставления, представьте себе следующие содержимое .netrc: ------------------------------------------------- machine .example.org login myid password mypasswd ------------------------------------------------- -При соответствии домену, aria2.example.org будет соответствовать -.example.org и будет использованы myid и mypasswd. example.org также -соответствует .example.org. Но example.net не будет соответствовать -.example.org. +Домен "aria2.example.org" сопоставляется с ".example.org" и используется +'myid' и 'mypasswd'. + +Примеры некоторых доменных сопоставлений: домен "example.net" не сопоставим +с ".example.org". Домен "example.org" не сопоставим ".example.org" из-за +предшествующей ".". Если вы хотите соответствия "example.org", то точно +укажите - "example.org". Контрольный файл ~~~~~~~~~~~~~~~~ @@ -1619,7 +1626,7 @@ aria2 использует контрольный файл для отслежи указать несколько URI для одного объекта, разделяя URI, в одной строке, табуляцией. -Каждая строка рассматривается, как аргумент командой строки. Следовательно +Каждая строка рассматривается, как аргумент командой строки. Следовательно, на них влияют параметры *<>* и *<>*. @@ -1701,7 +1708,6 @@ URI. Эти дополнительные строки должны начина * *<>* * *<>* * *<>* -* *<>* * *<>* * *<>* * *<>* @@ -1729,6 +1735,7 @@ URI. Эти дополнительные строки должны начина * *<>* * *<>* * *<>* +* *<>* Эти параметры имеют точно такой же смысл, что параметры командной строки, но это применимо только к URI, к которым они принадлежат. Обратите внимание, @@ -1772,13 +1779,13 @@ dl_speed:: sc_avg_speed:: Средняя скорость загрузки, которая наблюдалась при предыдущей загрузке, в - байт/секунду. Это значение обновляется только если загрузка произведена при + байт/секунду. Это значение обновляется, только если загрузка произведена при одном соединении и только с использованием AdaptiveURISelector. Необязательно. mc_avg_speed:: Средняя скорость загрузки, которая наблюдалась при предыдущей загрузке, в - байт/секунду. Это значение обновляется только если загрузка произведена при + байт/секунду. Это значение обновляется, только если загрузка произведена при нескольких соединениях и только с использованием AdaptiveURISelector. Необязательно. @@ -1787,7 +1794,7 @@ counter:: используется только при AdaptiveURISelector. Необязательно. last_updated:: - Время связи, в GMT, с этим сервером, указывается в секундах начиная с + Время связи, в GMT, с этим сервером, указывается в секундах, начиная с 00:00:00 1 Января, 1970, UTC. Обязательно. status:: @@ -1798,7 +1805,7 @@ status:: значения. Вы можете размещать пары, отличные от перечисленных выше; они будут просто игнорироваться. -Например следующим образом: +Например, следующим образом: -------------------------------------------------------------------------------- host=localhost, protocol=http, dl_speed=32000, last_updated=1222491640, status=OK host=localhost, protocol=ftp, dl_speed=0, last_updated=1222491632, status=ERROR @@ -1827,8 +1834,8 @@ JSON-RPC-интерфейс не поддерживает уведомления GID:: - GID (или gid) - это ключ, для управление каждой загрузкой. Каждая загрузка - имеет уникальный GID. В настоящие время GID представлен как целое число, но + GID (или gid) - это ключ, для управления каждой загрузкой. Каждая загрузка + имеет уникальный GID. В настоящее время GID представлен как целое число, но обрабатывается как не целое число, т.к. он может быть изменен на другой тип в будущих версиях. Обратите внимание, что GID существует в локальной сессии и не сохраняется при завершении работы aria2. @@ -1914,10 +1921,10 @@ URI. Для BitTorrent Magnet URI, 'uris' должен содержать тол *<>*. Параметр 'torrent' имеет тип base64, с содержанием Base64-кодировки .в .torrent-файле. Параметр 'uris' имеет тип массив, элемент которого имеет тип строка и содержит URI. -Параметр 'uris' используется для Web-сидирования. Для одно файловых +Параметр 'uris' используется для Web-сидирования. Для однофайловых торрентов, URI может быть завершенным, который указывает на ресурс, или же если заканчиваться символом /, тогда будет добавлено имя из -torrent-файла. Для много файловых торентов, имя и путь в торренте будут +torrent-файла. Для многофайловых торентов, имя и путь в торренте будут добавлены из URI для каждого файла. Параметр 'options' имеет тип структура, элементы которой являются парой имя и значение. Смотрите ниже *<>* для более подробной информации. Если @@ -1981,7 +1988,7 @@ Base64-кодировки в .metalink-файле. Параметр 'options' и параметре *<>*. Например, имя файла 0a3893293e27ac0490424c06de4d09242215f0a6.metalink. Если этот файл существует, то он будет перезаписан. Если файл не может быть успешно -сохранен, то загрузки, добавленныее этим методом, не сохраняются при помощи +сохранен, то загрузки, добавленные этим методом, не сохраняются при помощи параметра *<>*. Пример JSON-RPC @@ -2020,7 +2027,7 @@ Base64-кодировки в .metalink-файле. Параметр 'options' и Этот метод удаляет загрузку, которая обозначена 'gid'. Параметр 'gid' имеет тип строка. Если указана загрузка, которая загружается в данный момент, то -сперва она остановится. Статус удаления станет "removed" (удаленно). Этот +сначала она остановится. Статус удаления станет "removed" (удаленно). Этот метод возвращает GID удаленной загрузки. Пример JSON-RPC @@ -2277,7 +2284,7 @@ bittorrent:: Пример JSON-RPC +++++++++++++++ -Следующий пример получает иформацию о загрузке, GID которой "1": +Следующий пример получает информацию о загрузке, GID которой "1": --------------------------------------------------------------------------- >>> import urllib2, json @@ -2330,7 +2337,7 @@ bittorrent:: Пример XML-RPC ++++++++++++++ -Следующий пример получает иформацию о загрузке, GID которой "1": +Следующий пример получает информацию о загрузке, GID которой "1": -------------------------------------------------------------------- >>> import xmlrpclib @@ -2430,7 +2437,7 @@ status:: index:: Индекс файла. Начинается с 1. Последовательность файлов такая же, что и в - много файловом торренте. + многофайловом торренте. path:: @@ -2453,7 +2460,7 @@ selected:: "true" - если этот файл выбран параметром *<>*. Если параметр *<>* не указан или это одно файловый торрент или загрузка не + --select-file>>* не указан или это однофайловый торрент или загрузка не торрент, то это значение всегда будет "true". Иначе "false". uris:: @@ -2627,7 +2634,7 @@ seeder:: index:: Индекс файла. Начинается с 1. Последовательность файлов такая же, что и в - много файловом торренте. + многофайловом торренте. servers:: @@ -2734,7 +2741,7 @@ aria2.tellStatus>>*. загрузок. За разъяснениями о параметре 'keys', обратитесь к методу *<>*. -'offset' и 'num' имеют такую же семантику как и в методе +'offset' и 'num' имеют такую же семантику, как и в методе *<>*. Ответ имеет тип массив и его элемент такая же структура, которая @@ -2902,12 +2909,22 @@ URI. 'position' начинается с 0. Когда 'position' пропуще ++++++++ Этот метод изменяет динамически параметры загрузки, которая обозначена -'gid'. 'gid' имеет тип строка. 'options' имеет тип структура, доступны -параметры: *<>*, -*<>*, -*<>* и -*<>*. Этот метод возвращает -"OK", в случае успеха. +'gid'. 'gid' имеет тип строка. 'options' имеет тип структура. Доступны +следующие параметры для активных загрузок: + +* *<>* +* *<>* +* *<>* +* *<>* + +Для ожидающих или приостановленных загрузок, в дополнение к выше +перечисленным параметрам, доступны параметры, перечисленные в подразделе +*<<_входной_файл, Входной файл>>*, исключая следующие параметры: +*<>*, *<>*, *<>*, *<>* и +*<>*. Этот метод возвращает "OK", в +случае успеха. Пример JSON-RPC +++++++++++++++ @@ -2960,16 +2977,30 @@ aria2.getOption>>*. ++++++++ Этот метод изменяет динамически глобальные параметры. 'options' имеет тип -структура, доступны параметры: *<>*, *<>*, *<>*, *<>* и -*<>*. Используя параметр *<>*, -вы можете динамически начинать вести журнал событий или изменять файл -журнала событий. Чтобы остановить ведение журнала событий задайте пустую -строку ("") в качестве значения параметра. Обратите внимание, что файл -журнала событий всегда открыт в режиме добавления. Этот метод возвращает -"OK", в случае успеха. +структура. Доступны следующие параметры: + +* *<>* +* *<>* +* *<>* +* *<>* +* *<>* +* *<>* +* *<>* +* *<>* +* *<>* +* *<>* + +В дополнение к ним, параметры перечисленные в подразделе *<<_входной_файл, +Входной файл>>*, исключая следующие параметры: *<>*, *<>*, *<>*, *<>* и *<>*. + +Используя параметр *<>*, вы можете динамически +начинать вести журнал событий или изменять файл журнала событий. Чтобы +остановить ведение журнала событий, задайте пустую строку ("") в качестве +значения параметра. Обратите внимание, что файл журнала событий всегда +открыт в режиме добавления. Этот метод возвращает "OK", в случае успеха. [[aria2_rpc_aria2_getGlobalStat]] *aria2.getGlobalStat* () @@ -2984,11 +3015,11 @@ max-overall-upload-limit>>*, *<>* и downloadSpeed:: - Общая скорости загрузки (байт/сек). + Общая скорость загрузки (байт/сек). uploadSpeed:: - Общая скорости отдачи (байт/сек). + Общая скорость отдачи (байт/сек). numActive:: @@ -3418,9 +3449,9 @@ JSON-RPC-интерфейс поддерживает JSONP. Вы можете о Пример кода клиента XML-RPC ~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Следующий Ruby-скрипт добавляет 'http://localhost/aria2.tar.bz2' и параметр -*<>*='/downloads' к aria2c, которая работает на -localhost и отображает ответ. +Следующий Ruby-скрипт добавляет 'http://localhost/aria2.tar.bz2', с +параметром *<>*='/downloads', в aria2c, которая +работает на localhost и отображает ответ. ---------------------------------------------- #!/usr/bin/env ruby @@ -3603,7 +3634,7 @@ aria2c -j2 file1.torrent file2.torrent aria2c -Ttest.torrent "http://host1/file" "ftp://host2/file" ------------------------------------------------------------ [NOTE] -Загрузка много файлового торрента через HTTP/FTP не поддерживается. +Загрузка многофайлового торрента через HTTP/FTP не поддерживается. Загрузка только выбранных файлов, используя индекс (обычно называют "выборочная загрузка") ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -3646,7 +3677,7 @@ aria2c --listen-port=7000-7001,8000 file.torrent --------------------------------------------------- [NOTE] Т.к. aria2 не настраивает брандмауэр или маршрутизатор для перенаправления -портов, вам решать как это сделать вручную. +портов, вам решать, как это сделать вручную. Указать условие остановки программы после завершения загрузки торрента ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^