Merge pull request #16 from ITriskTI/master

Fixed some bugs
pull/18/head
Tatsuhiro Tsujikawa 2012-04-23 05:10:16 -07:00
commit 927499d98f
2 changed files with 146 additions and 148 deletions

View File

@ -199,9 +199,10 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. note::
Файл netrc считывается только при запуске, если :option:`--no-netrc <-n>` задан как ``false``. Так что если :option:`--no-netrc <-n>` задан как ``true`` при загрузке, то netrc недоступен на
протяжении всей сессии. Вы не сможете получить доступ к netrc, даже если
отправите :option:`--no-netrc=false, <-n>` используя
Файл netrc считывается только при запуске, если :option:`--no-netrc <-n>` задан
как ``false``. Так что если :option:`--no-netrc <-n>` задан как ``true`` при
загрузке, то netrc недоступен на протяжении всей сессии. Вы не сможете получить
доступ к netrc, даже если отправите :option:`--no-netrc=false, <-n>` используя
:func:`aria2.changeGlobalOption`.
.. option:: --no-proxy=<DOMAINS>
@ -1022,8 +1023,7 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
Если задано ``false``, тогда для всех заданных URI не поддерживается
возобновление загрузки, или aria2 столкнется с невозможностью
возобновления загрузки URI ``N``-ое количество раз
(значение ``N`` указывается в параметре
(значение ``N`` указывается в параметре :option:`--max-resume-failure-tries`,
то aria2 будет загружать файл с нуля. Смотрите параметр
:option:`--max-resume-failure-tries`.
По умолчанию: ``true``
@ -1151,8 +1151,8 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. option:: --hash-check-only[=true|false]
Если задано ``true``, то после проверки хэша, используя параметр
:option:`--check-integrity <-V>`,
загрузка прервётся, в любом случае загрузка завершится.
:option:`--check-integrity <-V>`, загрузка прервётся, в любом
случае загрузка завершится.
По умолчанию: ``false``
.. option:: --human-readable[=true|false]
@ -1172,8 +1172,8 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
Если интерфейс имеет несколько адресов, то настоятельно рекомендуется
указать IP-адрес явно. Смотрите также
:option:`--disable-ipv6`. Если ваша система не имеет :manpage:`getifaddrs(3)`, это параметр не
принимает имя интерфейса.
:option:`--disable-ipv6`. Если ваша система не имеет :manpage:`getifaddrs(3)`, это
параметр не принимает имя интерфейса.
.. option:: --max-download-result=<NUM>
@ -1348,10 +1348,10 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
.. option:: --save-session=<FILE>
Сохранять ошибочные/незаконченные загрузки в FILE при выходе. Вы можете
передать этот выходной файл aria2c с параметром :option:`--input-file <-i>` при перезапуске. Обратите внимание, что
загрузки, добавленные через RPC-методы
:func:`aria2.addTorrent`, :func:`aria2.addMetalink`
и чьи метаданные не могут быть сохранены как файл, не будут сохраняться.
передать этот выходной файл aria2c с параметром :option:`--input-file <-i>` при
перезапуске. Обратите внимание, что загрузки, добавленные через RPC-методы
:func:`aria2.addTorrent`, :func:`aria2.addMetalink` и чьи метаданные не могут
быть сохранены как файл, не будут сохраняться.
Загрузки, удаленные с использованием :func:`aria2.remove` и
:func:`aria2.forceRemove` не будут сохранены.
@ -1395,18 +1395,18 @@ URI, MAGNET-ССЫЛКА, TORRENT-ФАЙЛ, METALINK-ФАЙЛ
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Вы можете перечислить несколько URI в командной строке. Пока вы не указали
параметр :option:`--force-sequential <-Z>`, все URI должны указывать
на один и тот же файл или загрузка завершиться не удачно.
параметр :option:`--force-sequential <-Z>`, все URI должны указывать на один
и тот же файл или загрузка завершиться не удачно.
Вы можете указать произвольное количество BitTorrent Magnet URI. Обратите
внимание, что они всегда будут обрабатываться как отдельная
загрузка. Поддерживаются оба Info Hash (Информация о хэше), как
закодированный 40 шестнадцатеричными символами, так и закодированный 32
символами Base32-кодировки. Поддерживаются составные параметры ``tr``. Т.к. в
BitTorrent Magnet URI возможно присутствие символа ``&``, то настоятельно
рекомендуется всегда заключать URI в одиночные(``'``) или двойные(``"``)
кавычки. Так же настоятельно рекомендуется включить DHT, особенно когда
параметр ``tr`` не указан. Смотрите
символами Base32-кодировки. Поддерживаются составные параметры
``tr``. Т.к. в BitTorrent Magnet URI возможно присутствие символа ``&``, то
настоятельно рекомендуется всегда заключать URI в одиночные(``'``) или
двойные(``"``) кавычки. Так же настоятельно рекомендуется включить DHT,
особенно когда параметр ``tr`` не указан. Смотрите
http://www.bittorrent.org/beps/bep_0009.html для детальной информации по
BitTorrent Magnet URI.
@ -1447,7 +1447,7 @@ aria2 предоставляет параметры, в которых указ
доступны следующие параметры:
:option:`--on-bt-download-complete`,
:option:`--on-download-pause`,
:option:`--on-download-complete`.
:option:`--on-download-complete`,
:option:`--on-download-start`,
:option:`--on-download-error`,
:option:`--on-download-stop`.
@ -1458,11 +1458,10 @@ aria2 передает 3 аргумента указанной команды,
файлов. Если число файлов больше чем один, то путь к файлу будет для
первого. Другими словами, это значение параметра path в первой структуре,
определенный параметр которой имеет значение true (истина), в ответе
RPC-метода :func:`aria2.getFiles`. Если вы хотите
получить все пути к файлам, то рассмотрите использование
JSON-RPC/XML-RPC. Обратите внимание, что путь к файлу может меняться в
процессе загрузки по HTTP из-за перенаправления или заголовка
Content-Disposition.
RPC-метода :func:`aria2.getFiles`. Если вы хотите получить все пути к
файлам, то рассмотрите использование JSON-RPC/XML-RPC. Обратите внимание,
что путь к файлу может меняться в процессе загрузки по HTTP из-за
перенаправления или заголовка Content-Disposition.
Посмотрите пример, как аргументы передаются команде:
@ -1639,15 +1638,15 @@ aria2.conf
По умолчанию, aria2 анализирует ``$HOME/.aria2/aria2.conf`` как
конфигурационный файл. Вы можете указать путь к конфигурационному файлу в
параметре :option:`--conf-path`. Если вы не хотите
использовать конфигурационный файл, используйте параметр
:option:`--no-conf`.
параметре :option:`--conf-path`. Если вы не хотите использовать
конфигурационный файл, используйте параметр :option:`--no-conf`.
Конфигурационный файл - это текстовый файл, содержащий один параметр в
строке. В каждой строке, вы можете указать пары имя-значение в формате:
ИМЯ=ЗНАЧЕНИЕ, где имя - это длинный параметр командной строки, без префикса
``--``. Вы можете использовать тот же синтаксис, что и для параметра командной
строки. Строки начинающиеся с ``#`` рассматриваются как комментарии::
``--``. Вы можете использовать тот же синтаксис, что и для параметра
командной строки. Строки начинающиеся с ``#`` рассматриваются как
комментарии::
# sample configuration file for aria2c
listen-port=60000
@ -1658,18 +1657,18 @@ aria2.conf
dht.dat
~~~~~~~~
~~~~~~~
By default, the routing table of IPv4 DHT is saved to the path
``$HOME/.aria2/dht.dat`` and the routing table of IPv6 DHT is saved to
the path ``$HOME/.aria2/dht6.dat``.
``$HOME/.aria2/dht.dat`` and the routing table of IPv6 DHT is saved to the
path ``$HOME/.aria2/dht6.dat``.
Netrc
~~~~~
Поддержка Netrc включена по умолчанию для HTTP(S)/FTP. Для отключения
поддержки netrc, укажите параметр :option:`--no-netrc <-n>`. Ваш файл
.netrc должен иметь соответствующие права (600).
поддержки netrc, укажите параметр :option:`--no-netrc <-n>`. Ваш файл .netrc
должен иметь соответствующие права (600).
Если имя машины (machine) начинается с ``.``, то aria2 выполняет доменное
сопоставление вместо точного соответствия. Это расширение aria2. Пример
@ -1681,10 +1680,10 @@ Netrc
Домен ``aria2.example.org`` сопоставляется с ``.example.org`` и используется
``myid`` и ``mypasswd``.
Примеры некоторых доменных сопоставлений: домен ``example.net`` не сопоставим
с ``.example.org``. Домен ``example.org`` не сопоставим ``.example.org`` из-за
предшествующей ``.``. Если вы хотите соответствия ``example.org``, то точно
укажите - ``example.org``.
Примеры некоторых доменных сопоставлений: домен ``example.net`` не
сопоставим с ``.example.org``. Домен ``example.org`` не сопоставим
``.example.org`` из-за предшествующей ``.``. Если вы хотите соответствия
``example.org``, то точно укажите - ``example.org``.
Контрольный файл
~~~~~~~~~~~~~~~~
@ -1695,8 +1694,8 @@ aria2 использует контрольный файл для отслежи
``.aria2``. Например, если file.zip загружаемый файл, тогда контрольный файл
будет file.zip.aria2. (Существует исключение для этого именования. При
загрузке торрента с множеством файлов, контрольный файл будет в "корневом
каталоге" с именем торрента и добавлением ``.aria2``. Имя "корневого каталога"
- значение ключа "name" в "info" внутри torrent-файла.)
каталоге" с именем торрента и добавлением ``.aria2``. Имя "корневого
каталога" - значение ключа "name" в "info" внутри torrent-файла.)
Обычно контрольный файл удаляется после завершения загрузки. Если aria2
решает, что загрузка не может быть возобновлена (например, когда загружается
@ -1799,7 +1798,8 @@ URI. Эти дополнительные строки должны начина
* :option:`max-resume-failure-tries <--max-resume-failure-tries>`
* :option:`max-tries <-m>`
* :option:`max-upload-limit <-u>`
* :option:`metalink-enable-unique-protocol <--metalink-enable-unique-protocol>`
* :option:`metalink-enable-unique-protocol
<--metalink-enable-unique-protocol>`
* :option:`metalink-language <--metalink-language>`
* :option:`metalink-location <--metalink-location>`
* :option:`metalink-os <--metalink-os>`
@ -1845,15 +1845,13 @@ URI. Эти дополнительные строки должны начина
http://foo/bar
Если aria2 выполняется с параметрами ``-i uri.txt -d /tmp``,
а загрузка происходит с
\http://server/file.iso и \http://mirror/file.iso, то ``file.iso`` сохранится
как ``/iso_images/file.img``. Файл ``bar`` загрузится с http://foo/bar и
сохранится как ``/tmp/bar``.
Если aria2 выполняется с параметрами ``-i uri.txt -d /tmp``, а загрузка
происходит с \http://server/file.iso и \http://mirror/file.iso, то
``file.iso`` сохранится как ``/iso_images/file.img``. Файл ``bar``
загрузится с http://foo/bar и сохранится как ``/tmp/bar``.
В некоторых случаях, параметр :option:`out <-o>` не имеет никакого
эффекта. Смотрите примечание по ограничениям параметра
:option:`--out <-o>`.
эффекта. Смотрите примечание по ограничениям параметра :option:`--out <-o>`.
Профиль функционирования сервера
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -1913,17 +1911,18 @@ aria2 обеспечивает JSON-RPC через HTTP и XML-RPC через HT
имеют одинаковые функции. aria2 также обеспечивает JSON-RPC через
WebSocket. JSON-RPC через WebSocket использует тот же самый метод сигнатур и
формат ответа как у JSON-RPC через HTTP, но дополнительно имеет сервер,
инициирующий уведомления. Смотрите подробности в разделе
`JSON-RPC через WebSocket`_.
инициирующий уведомления. Смотрите подробности в разделе `JSON-RPC через
WebSocket`_.
Путь запроса к JSON-RPC-интерфейсу (для через HTTP и через WebSocket) -
``/jsonrpc``. Путь запроса к XML-RPC-интерфейсу - ``/rpc``.
WebSocket URI для JSON-RPC через WebSocket является ``ws://HOST:PORT/jsonrpc``.
WebSocket URI для JSON-RPC через WebSocket является
``ws://HOST:PORT/jsonrpc``.
Реализованный JSON-RPC основан на спецификации
JSON-RPC 2.0 <http://jsonrpc.org/specification> и поддерживает HTTP POST и
GET (JSONP). Использование WebSocket как транспорта является начальным
Реализованный JSON-RPC основан на спецификации JSON-RPC 2.0
<http://jsonrpc.org/specification> и поддерживает HTTP POST и GET
(JSONP). Использование WebSocket как транспорта является начальным
расширением aria2.
JSON-RPC-интерфейс не поддерживает уведомления в HTTP, но RPC-сервер будет
@ -1961,10 +1960,11 @@ GID
указывать на один и тот же файл. Если вы смешивайте другие URI, указывающие
на другой файл, то aria2 не сообщит об этом, но и загрузка может неудачно
завершаться. Параметр *options* имеет тип структура, элементы которой
являются парой имя и значение. Смотрите ниже :ref:`rpc_options` для более подробной информации. Если параметр *position* задан
как целое число, начиная с 0, то новая загрузка будет вставлена на позицию
*position* в очередь ожидания. Если параметр *position* не задан или больше
чем размер очереди, то загрузка будет добавлена в конец очереди. Этот метод
являются парой имя и значение. Смотрите ниже :ref:`rpc_options` для более
подробной информации. Если параметр *position* задан как целое число,
начиная с 0, то новая загрузка будет вставлена на позицию *position* в
очередь ожидания. Если параметр *position* не задан или больше чем размер
очереди, то загрузка будет добавлена в конец очереди. Этот метод
возвращает GID зарегистрированной загрузки.
**Пример JSON-RPC**
@ -2294,8 +2294,8 @@ GID
``errorCode``
Последний код ошибки, которая произошла при загрузке. Значение имеет тип
строки. Коды ошибок определены в разделе `КОДЫ ЗАВЕРШЕНИЯ`_. Это значение доступно только для остановленных/завершенных
загрузок.
строки. Коды ошибок определены в разделе `КОДЫ ЗАВЕРШЕНИЯ`_. Это значение доступно
только для остановленных/завершенных загрузок.
``followedBy``
Список с GID, которые сгенерированы в результате запуска этой
@ -2794,7 +2794,9 @@ GID
пределами конца очереди, это переместит загрузку в начало или конец очереди
соответственно. Ответ имеет целочисленный тип и является целевой позицией.
Например, если GID#1 размещается на позиции 3, ``aria2.changePosition('1', -1, 'POS_CUR')`` изменит его позицию на 2. Дополнительно ``aria2.changePosition('1', 0, 'POS_SET')`` изменит его позицию на 0 (начало очереди).
Например, если GID#1 размещается на позиции 3, ``aria2.changePosition('1', -1, 'POS_CUR')``
изменит его позицию на 2. Дополнительно ``aria2.changePosition('1', 0, 'POS_SET')``
изменит его позицию на 0 (начало очереди).
**Пример JSON-RPC**
@ -3325,9 +3327,8 @@ GID
Параметры
~~~~~~~~~
Такие же параметры, что доступны для
:option:`--input-file <-i>`. Смотрите подраздел `Входной файл`_ для полного
списка параметров.
Такие же параметры, что доступны для :option:`--input-file <-i>`. Смотрите
подраздел `Входной файл`_ для полного списка параметров.
В структуре, имя элемента - это имя параметра (без ``--``), а значение
элемента - аргумент в виде строки.
@ -3355,11 +3356,10 @@ GID
</struct>
Параметры :option:`header <--header>` и :option:`index-out <-O>`
допускают нескольких определений в
командной строке. Поскольку имя должно быть уникальным в структуре
(многие реализации библиотеки XML-RPC использует хэш или словарь
для структуры), одной строки не достаточно. Для преодоления этой
Параметры :option:`header <--header>` и :option:`index-out <-O>` допускают
нескольких определений в командной строке. Поскольку имя должно быть
уникальным в структуре (многие реализации библиотеки XML-RPC использует хэш
или словарь для структуры), одной строки не достаточно. Для преодоления этой
ситуации, они могут взять массив в качестве значения, а также строку.
Пример JSON-RPC
@ -3404,16 +3404,14 @@ JSON-RPC используя HTTP GET
~~~~~~~~~~~~~~~~~~~~~~~~~~~
JSON-RPC-интерфейс также поддерживает запрос через HTTP GET. Схема
кодирования в GET параметров основанных на
JSON-RPC
через HTTP Спецификация [2008-1-15(RC1)]. Кодирование параметров через GET
следующие::
кодирования в GET параметров основанных на JSON-RPC через HTTP Спецификация
[2008-1-15(RC1)]. Кодирование параметров через GET следующие::
/jsonrpc?method=METHOD_NAME&id=ID&params=BASE64_ENCODED_PARAMS
``method`` и ``id`` всегда обрабатывается как JSON-строка и они должны быть в
кодировке UTF-8.
``method`` и ``id`` всегда обрабатывается как JSON-строка и они должны быть
в кодировке UTF-8.
Например, закодированная строка aria2.tellStatus('3') с id='foo' выглядит
так::
@ -3435,8 +3433,8 @@ JSON-RPC-интерфейс поддерживает JSONP. Вы можете о
Для пакетного запроса, параметры ``method`` и ``id`` не должны быть
указаны. Полный запрос должен быть определен в параметре ``params``. Например,
пакетный запрос::
указаны. Полный запрос должен быть определен в параметре
``params``. Например, пакетный запрос::
[{'jsonrpc':'2.0', 'id':'qwer', 'method':'aria2.getVersion'},
{'jsonrpc':'2.0', 'id':'asdf', 'method':'aria2.tellActive'}]
@ -3522,8 +3520,8 @@ params, является данными, которые переносит эт
~~~~~~~~~~~~~~~~~~~~~~~~~~~
Следующий Ruby-скрипт добавляет ``http://localhost/aria2.tar.bz2``, с
параметром :option:`--dir=/downloads, <-d>` в aria2c, которая
работает на localhost и отображает ответ:
параметром :option:`--dir=/downloads, <-d>` в aria2c, которая работает на
localhost и отображает ответ:
.. code-block:: ruby
@ -3752,8 +3750,8 @@ params, является данными, которые переносит эт
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Для указания выходного имени файла в BitTorrent-загрузках, вам нужно узнать
индекс файла в torrent-файле, используя параметр
:option:`--show-files <-S>`. Например, результат выглядит следующим образом::
индекс файла в torrent-файле, используя параметр :option:`--show-files
<-S>`. Например, результат выглядит следующим образом::
idx|path/length
===+======================
@ -3831,8 +3829,8 @@ params, является данными, которые переносит эт
Добавить и удалить URI трекера
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Удалить все URI анонса трекеров, описанных в file.torrent и
взамен использовать ``http://tracker1/announce`` и ``http://tracker2/announce``:
Удалить все URI анонса трекеров, описанных в file.torrent и взамен
использовать ``http://tracker1/announce`` и ``http://tracker2/announce``:
.. code-block:: console

View File

@ -3,10 +3,10 @@
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
Aria2 Manual
============
Руководство по Aria2
====================
Contents:
Содержание:
.. toctree::
:maxdepth: 3