From f8cb9b67de8045717ff3e5ac503f17fc87107190 Mon Sep 17 00:00:00 2001 From: ITriskTI Date: Sun, 27 Jan 2013 21:12:55 +0300 Subject: [PATCH] Update and fixed some bugs --- doc/manual-src/ru/aria2c.rst | 83 ++++++++++++++++++++++++------------ 1 file changed, 55 insertions(+), 28 deletions(-) diff --git a/doc/manual-src/ru/aria2c.rst b/doc/manual-src/ru/aria2c.rst index 1c8b51d9..bd774c25 100644 --- a/doc/manual-src/ru/aria2c.rst +++ b/doc/manual-src/ru/aria2c.rst @@ -453,13 +453,15 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може .. option:: --private-key= Использовать закрытый ключ в FILE. Закрытый ключ должен - быть дешифрованным и в PEM-формате. Режим работы с исходно - зашифрованным закрытым ключом не определен. Смотрите также + быть дешифрованным и в PEM-формате. Режим работы, с исходно + зашифрованным закрытым ключом, не определён. Смотрите также параметр :option:`--certificate`. .. option:: --referer= - Задать источника запроса. Влияет на все URI. + Задать источник запроса. Влияет на все URI. Если задано ``*``, то каждый + URI запроса будет использован как источник запроса. Это может быть полезно + при использовании с параметром :option:`--parameterized-uri <-P>`. .. option:: --enable-http-keep-alive[=true|false] @@ -583,7 +585,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може .. option:: -S, --show-files[=true|false] Вывести список файлов из ".torrent", ".meta4" или ".metalink" и - выйти. Для файла .torrent будет выведена более детальная + завершить работу. Для файла .torrent будет выведена более детальная информация (информация по хэшу, размер блока и др.). Специфические параметры BitTorrent @@ -608,7 +610,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може .. option:: --bt-external-ip= Указать внешний IP-адрес BitTorrent-трекера для отчета. - Не смотря на то, что эта функция названа ``external`` (``внешний``), + Несмотря на то, что эта функция названа ``external`` (``внешний``), она может принимать любой IP-адрес. IPADDRESS должен быть числовым IP-адресом. @@ -732,7 +734,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може .. option:: --bt-tracker-connect-timeout= Задать время ожидания в секундах для установки соединения с трекером. - После установки соединения, это параметр станет не действительным, + После установки соединения, это параметр станет недействительным, а вместо него будет использован :option:`--bt-tracker-timeout`. По умолчанию: ``60`` @@ -1119,6 +1121,12 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може Сменить путь к файлу конфигурации на PATH. По умолчанию: ``$HOME/.aria2/aria2.conf`` +.. option:: --console-log-level= + + Задать уровень вывода событий на консоль. LEVEL может + быть: ``debug``, ``info``, ``notice``, ``warn`` или ``error``. + По умолчанию: ``notice`` + .. option:: -D, --daemon[=true|false] Запустить как демон (фоновый процесс). Текущий рабочий каталог @@ -1427,11 +1435,11 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може Удалять контрольный файл перед загрузкой. При использовании с :option:`--allow-overwrite=true <--allow-overwrite>` файл всегда загружается с нуля. Это может понадобиться пользователям - за прокси-сервером, не поддерживающим возобновление загрузки. + за прокси-сервером, который блокирует возобновление загрузки. .. option:: --save-session= - Сохранять ошибочные/незаконченные загрузки в FILE при выходе. Вы можете + Сохранять ошибочные/незаконченные загрузки в FILE при завершении работы. Вы можете передать этот выходной файл aria2c с параметром :option:`--input-file <-i>` при перезапуске. Обратите внимание, что загрузки, добавленные через RPC-методы :func:`aria2.addTorrent`, :func:`aria2.addMetalink` и чьи метаданные не могут @@ -1457,6 +1465,13 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може 5. Локальный metalink-файл Никакой значимый GID не сохранится. +.. option:: --save-session-interval= + + Сохранять ошибочные/незаконченные загрузки в файл, указанный в + параметре :option:`--save-session`, каждые SEC секунд. + Если указан ``0``, то файл будет сохранён только тогда, когда + aria2 завершит работу. По умолчанию: ``0`` + .. option:: --stop= Останавливать программу после того как пройдет @@ -1469,8 +1484,8 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може Остановить приложение, когда процесс с идентификационный номером PID не работает. Это полезно, если процесс aria2 запущен из родительского процесса. Родительский процесс может запустить aria2 со своим - идентификационным номером и когда он (процесс) завершиться по какой-то - причине, aria2 может обнаружить это и самостоятельно завершиться. + идентификационным номером и когда он (процесс) завершится по какой-то + причине, aria2 может обнаружить это и самостоятельно завершить работу. .. option:: --truncate-console-readout[=true|false] @@ -1481,10 +1496,14 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може .. option:: -v, --version Вывести номер версии, информацию об авторских - правах, конфигурации и выйти. + правах, конфигурации и завершить работу. + +Примечания для параметров +~~~~~~~~~~~~~~~~~~~~~~~~~ + +Необязательные аргументы +^^^^^^^^^^^^^^^^^^^^^^^^ -Параметры, которые принимают аргументы -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Параметры, которые имеют значения в квадратных скобках ([]), могут принимать дополнительные (необязательные) аргументы. Обычно отсутствие аргумента эквивалентно ``true``. Если вы используется короткую форму параметров @@ -1493,6 +1512,14 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може между именем параметра и аргументом, то аргумент будет обрабатываться как URI, и это не то, что обычно вы ожидаете. +Единицы (K и M) +^^^^^^^^^^^^^^^ + +Некоторые параметры принимают ``K`` и ``M`` для удобства представления 1024 +и 1048576 соответственно. aria2 определяет эти символы без учета +регистра. Другими словами, ``k`` и ``m`` могут быть использованы также как +``K`` и ``M`` соответственно. + URI, MAGNET-ССЫЛКА, TORRENT-ФАЙЛ, METALINK-ФАЙЛ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -1608,9 +1635,9 @@ RPC-метода :func:`aria2.getFiles`. Если вы хотите получи Если произошла проблема с сетью. 7 - Если были не завершенные загрузки. Эта ошибка только появляется, только если - все завершенные загрузки были успешны и были не завершенные загрузки в - очереди, когда aria2 завершилась по нажатию :kbd:`Ctrl-C` пользователем или при + Если были незавершенные загрузки. Эта ошибка только появляется, только если + все завершенные загрузки были успешны и были незавершенные загрузки в + очереди, когда aria2 завершила работу по нажатию :kbd:`Ctrl-C` пользователем или при отправке сигнала TERM или INT. 8 @@ -1618,7 +1645,7 @@ RPC-метода :func:`aria2.getFiles`. Если вы хотите получи как обязательное для завершения загрузки. 9 - Если было не достаточно доступного места на диске. + Если было недостаточно пространства на диске. 10 Если размер блока был отличным от указанного контрольном .aria2-файле. @@ -1721,7 +1748,7 @@ aria2 распознает следующие переменные окруже .. note:: - Не смотря на то, что aria2 допускает ``ftp://`` и ``https://`` схемы прокси в URI, + Несмотря на то, что aria2 допускает ``ftp://`` и ``https://`` схемы прокси в URI, она просто предполагает, что определен ``http://`` и не меняет своего поведения, основанного на определенной схеме. @@ -1784,12 +1811,12 @@ Netrc machine .example.org login myid password mypasswd -Домен ``aria2.example.org`` сопоставляется с ``.example.org`` и используется -``myid`` и ``mypasswd``. +Доменное имя ``aria2.example.org`` совпадает с ``.example.org`` и +используется ``myid`` и ``mypasswd``. -Примеры некоторых доменных сопоставлений: домен ``example.net`` не -сопоставим с ``.example.org``. Домен ``example.org`` не сопоставим -``.example.org`` из-за предшествующей ``.``. Если вы хотите соответствия +Примеры некоторых совпадений доменных имен: доменное имя ``example.net`` не +совпадает с ``.example.org``. Доменное имя ``example.org`` не совпадает +``.example.org`` из-за предшествующей ``.``. Если вы хотите совпадения ``example.org``, то точно укажите - ``example.org``. Контрольный файл @@ -2001,7 +2028,7 @@ URI. Эти дополнительные строки должны начина 00:00:00 1 Января, 1970, UTC. Обязательно. ``status`` - ERROR, когда сервер не доступен из-за неисправности или тайм-аута. Иначе - + ERROR, когда сервер недоступен из-за неисправности или тайм-аута. Иначе - OK. Эти поля должны быть в одной строке. Последовательность полей не имеет @@ -2359,7 +2386,7 @@ GID загрузки, то значение не будет включено в ответ. ``dir`` - Каталог для сохранения файлов. Этот параметр не доступен для остановленных + Каталог для сохранения файлов. Этот параметр недоступен для остановленных загрузок. ``files`` @@ -3275,7 +3302,7 @@ GID Параметры :option:`header <--header>` и :option:`index-out <-O>` допускают нескольких определений в командной строке. Поскольку имя должно быть уникальным в структуре (многие реализации библиотеки XML-RPC использует хэш -или словарь для структуры), одной строки не достаточно. Для преодоления этой +или словарь для структуры), одной строки недостаточно. Для преодоления этой ситуации, они могут взять массив в качестве значения, а также строку. Пример JSON-RPC @@ -3428,7 +3455,7 @@ params, является данными, которые переносит эт Это уведомление будет оправлено, если загрузка в BitTorrent завершена (но - сидирование может быть не окончено). *event* - такая же структура, как + сидирование может быть не закончено). *event* - такая же структура, как параметр *event* в методе :func:`aria2.onDownloadStart`. @@ -3792,7 +3819,7 @@ Checksum .. note:: - Если aria2c не собрана с c-ares, то :option:`--enable-async-dns6` + Если aria2c собрана без c-ares, то :option:`--enable-async-dns6` не нужен. aria2 разделяет один и тот же порт между IPv4 и IPv6 DHT. Добавить и удалить URI трекера