diff --git a/doc/manual-src/ru/aria2c.rst b/doc/manual-src/ru/aria2c.rst index 922dfee9..60f9511a 100644 --- a/doc/manual-src/ru/aria2c.rst +++ b/doc/manual-src/ru/aria2c.rst @@ -9,17 +9,22 @@ aria2c(1) -------- aria2 - это утилита для загрузки файлов. Поддерживаемые протоколы: HTTP(S), -FTP, BitTorrent и Metalink. aria2 может загрузить файл с разных +FTP, SFTP, BitTorrent и Metalink. aria2 может загрузить файл с разных источников/протоколов и пытается максимально использовать пропускную -способность канала. Есть поддержка загрузки файла по протоколам HTTP(S)/FTP -и BitTorrent одновременно, пока данные загружаются по HTTP(S)/FTP, они тут -же могут выгружаться в BitTorrent-рой. Используя контрольные суммы блока -данных для Metalink, aria2 автоматически проверяет части данных во время -загрузки файла. +способность канала. Есть поддержка загрузки файла по протоколам +HTTP(S)/FTP/SFTP и BitTorrent одновременно, пока данные загружаются по +HTTP(S)/FTP, они тут же могут выгружаться в BitTorrent-рой. Используя +контрольные суммы блока данных для Metalink, aria2 автоматически проверяет +части данных во время загрузки файла. ПАРАМЕТРЫ --------- +.. note:: + + Большинство связанных с FTP параметров применимы также к SFTP. + Некоторые параметры не являются эффективными по отношению к SFTP (например, :option:`--ftp-pasv`) + Основные параметры ~~~~~~~~~~~~~~~~~~ .. option:: -d, --dir= @@ -89,8 +94,9 @@ FTP, BitTorrent и Metalink. aria2 может загрузить файл с р ``#deprecated``, ``#help``, ``#all``. По умолчанию: ``#basic`` -Параметры HTTP/FTP -~~~~~~~~~~~~~~~~~~ +Параметры HTTP/FTP/SFTP +~~~~~~~~~~~~~~~~~~~~~~~ + .. option:: --all-proxy= Использовать указанный прокси-сервер для всех протоколов. Для отмены @@ -197,6 +203,17 @@ FTP, BitTorrent и Metalink. aria2 может загрузить файл с р ``1M`` -``1024M``. По умолчанию: ``20M`` + +.. option:: --netrc-path= + + Указать путь к файлу .netrc. + По умолчанию: ``$(HOME)/.netrc`` + + .. note:: + + Права доступа к файлу .netrc должны быть равны 600. Иначе, файл + будет проигнорирован. + .. option:: -n, --no-netrc[=true|false] Отключить поддержку netrc. Поддержка netrc по умолчанию @@ -544,8 +561,8 @@ FTP, BitTorrent и Metalink. aria2 может загрузить файл с р Задать клиентское приложение для HTTP(S)-загрузок. По умолчанию: ``aria2/$VERSION``, $VERSION заменяется на версию пакета. -Специфические параметры FTP -~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Специфические параметры FTP/SFTP +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. option:: --ftp-user= Задать пользователя для FTP. @@ -566,6 +583,10 @@ FTP, BitTorrent и Metalink. aria2 может загрузить файл с р то будет использован активный режим. По умолчанию: ``true`` + .. note:: + + Этот параметр игнорируется для SFTP-передачи. + .. option:: --ftp-proxy= Использовать указанный прокси-сервер для FTP. Для отмены @@ -587,11 +608,25 @@ FTP, BitTorrent и Metalink. aria2 может загрузить файл с р двух: ``binary`` или ``ascii``. По умолчанию: ``binary`` + .. note:: + + Этот параметр игнорируется для SFTP-передачи. + .. option:: --ftp-reuse-connection[=true|false] Повторно использовать FTP соединение. По умолчанию: ``true`` +.. option:: --ssh-host-key-md== + + Задать контрольную сумму для публичного SSH-ключа хоста. TYPE - тип хэша. + Поддерживаемые типы хэшей - ``sha-1`` или ``md5``. + DIGEST - шестнадцатеричное значение хэша. + Например: ``sha-1=b030503d4de4539dc7885e6f0f5e256704edf4c3``. + Этот параметр может быть использован для проверки публичного ключа сервера + при использовании SFTP. Если параметр не задан (по умолчанию), то никакой + проверки не происходит. + Параметры BitTorrent/Metalink ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. option:: --select-file=... @@ -1422,12 +1457,12 @@ FTP, BitTorrent и Metalink. aria2 может загрузить файл с р .. option:: --multiple-interface= - Разделенный запятыми список интерфейсов, для привязки к сокетами. - Запросы будут разделяться между интерфейсами для достижения - объединения каналов. Вы можете указать имя интерфейса, IP-адрес и - имя хоста. Если используется :option:`--interface`, то этот параметр - будет проигнорирован. Возможные значения: интерфейс, IP-адрес, - имя хоста + Разделенный запятыми список интерфейсов для привязки сокетов. + Запросы будут разделяться между интерфейсами для достижения объединения + каналов. Вы можете указать имя интерфейса (например, eth0), + IP-адрес (например, 192.168.0.12) и имя хоста (например, myhost). Если + используется :option:`--interface`, то этот параметр будет проигнорирован. + Возможные значения: интерфейс, IP-адрес, имя хоста. .. option:: --log-level= @@ -1686,13 +1721,14 @@ Metalink-документов, которые хранятся на локаль что они всегда будут обрабатываться как отдельная загрузка. Поддерживаются оба формата: Metalink4 и Metalink версии 3.0. -Вы можете указать вместе, torrent-файл с параметром -T и URI. Сделав это, вы -можете загружать файл, используя torrent-рой и HTTP(S)/FTP-сервер -одновременно, пока данные из HTTP(S)/FTP выгружаются в torrent-рой. Для -однофайловых торрентов, URI может быть завершенным, который указывает на -ресурс, или же если заканчиваться символом /, тогда name (имя) в -torrent-файле будет добавлено. Для многофайловых торрентов, name (имя) и -path (путь) в torrent-файле будут добавлены из URI для каждого файла. +Вы можете указать вместе, torrent-файл с параметром :option:`--torrent-file +<-T>` и URI. Сделав это, вы можете загружать файл, используя torrent-рой и +HTTP(S)/FTP/SFTP-сервер одновременно, пока данные из HTTP(S)/FTP/SFTP +выгружаются в torrent-рой. Для однофайловых торрентов, URI может быть +завершенным, который указывает на ресурс, или же если заканчиваться символом +/, тогда name (имя) в torrent-файле будет добавлено. Для многофайловых +торрентов, name (имя) и path (путь) в torrent-файле будут добавлены из URI +для каждого файла. .. note:: @@ -1724,15 +1760,16 @@ aria2 предоставляет параметры, в которых указ :option:`--on-download-stop`. aria2 передает 3 аргумента указанной команды, которая выполняется. Это -аргументы: GID, количество файлов и путь к файлу. Для HTTP-, FTP-загрузок, -обычно количество файлов - 1. BitTorrent загрузка может содержать множество -файлов. Если число файлов больше чем один, то путь к файлу будет для -первого. Другими словами, это значение параметра path в первой структуре, -определенный параметр которой имеет значение true (истина), в ответе -RPC-метода :func:`aria2.getFiles`. Если вы хотите получить все пути к -файлам, то рассмотрите использование JSON-RPC/XML-RPC. Обратите внимание, -что путь к файлу может меняться в процессе загрузки по HTTP из-за -перенаправления или заголовка Content-Disposition. +аргументы: GID, количество файлов и путь к файлу. Для HTTP-, FTP- и +SFTP-загрузок, обычно количество файлов - 1. BitTorrent загрузка может +содержать множество файлов. Если число файлов больше чем один, то путь к +файлу будет для первого. Другими словами, это значение параметра path в +первой структуре, определенный параметр которой имеет значение true +(истина), в ответе RPC-метода :func:`aria2.getFiles`. Если вы хотите +получить все пути к файлам, то рассмотрите использование +JSON-RPC/XML-RPC. Обратите внимание, что путь к файлу может меняться в +процессе загрузки по HTTP из-за перенаправления или заголовка +Content-Disposition. Посмотрите пример, как аргументы передаются команде: @@ -1857,6 +1894,12 @@ RPC-метода :func:`aria2.getFiles`. Если вы хотите получи 30 Если aria2 не смогла проанализировать JSON-RPC-запрос. +31 + Зарезервировано. Не используется. + +32 + Если проверка контрольной суммы не удалась. + .. note:: Ошибка, произошедшая в завершенной загрузке, не будет передана как код @@ -1940,7 +1983,7 @@ path ``$HOME/.aria2/dht6.dat``. Netrc ~~~~~ -Поддержка Netrc включена по умолчанию для HTTP(S)/FTP. Для отключения +Поддержка Netrc включена по умолчанию для HTTP(S)/FTP/SFTP. Для отключения поддержки netrc, укажите параметр :option:`--no-netrc <-n>`. Ваш файл .netrc должен иметь соответствующие права (600). @@ -2107,6 +2150,7 @@ URI. Эти дополнительные строки должны начина * :option:`seed-time <--seed-time>` * :option:`select-file <--select-file>` * :option:`split <-s>` + * :option:`ssh-host-key-md <--ssh-host-key-md>` * :option:`stream-piece-selector <--stream-piece-selector>` * :option:`timeout <-t>` * :option:`uri-selector <--uri-selector>` @@ -2272,7 +2316,7 @@ RPC-метод `system.multicall` обрабатывается особым об .. function:: aria2.addUri([secret], uris[, options[, position]]) Этот метод добавляет новую загрузку. Параметр *uris* - это массив - HTTP(S)/FTP/BitTorrent Magnet URI (строки), указывающие на один и тот же + HTTP(S)/FTP/SFTP/BitTorrent Magnet URI (строки), указывающие на один и тот же ресурс. Если вы смешивайте URI, указывающие на разные ресурсы, то загрузка может неудачно завершиться или быть повреждена без жалоб со стороны aria2. При добавлении BitTorrent Magnet URI, *uris* должен содержать только один @@ -2887,7 +2931,7 @@ RPC-метод `system.multicall` обрабатывается особым об .. function:: aria2.getServers([secret], gid) - Этот метод возвращает текущие подключенные HTTP(S)/FTP-серверы загрузки, + Этот метод возвращает текущие подключенные HTTP(S)/FTP/SFTP-серверы загрузки, которая обозначена *gid* (строка). Ответ - это массив структур, которые содержат следующие ключи. Значения являются строками.