Update and fixed some bugs

pull/43/head
ITriskTI 2013-01-27 21:12:55 +03:00
parent 382cb9a191
commit f8cb9b67de
1 changed files with 55 additions and 28 deletions

View File

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