Update aria2c.rst

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, они тут
+HTTP(S)/FTP/SFTP и BitTorrent одновременно, пока данные загружаются по
-же могут выгружаться в BitTorrent-рой. Используя контрольные суммы блока
+HTTP(S)/FTP, они тут же могут выгружаться в BitTorrent-рой. Используя
-данных для Metalink, aria2 автоматически проверяет части данных во время
+контрольные суммы блока данных для Metalink, aria2 автоматически проверяет
-загрузки файла.
+части данных во время загрузки файла.
 
 ПАРАМЕТРЫ
 ---------
 
+.. note::
+
+  Большинство связанных с FTP параметров применимы также к SFTP.
+  Некоторые параметры не являются эффективными по отношению к SFTP (например, :option:`--ftp-pasv`)
+
 Основные параметры
 ~~~~~~~~~~~~~~~~~~
 .. option:: -d, --dir=<DIR>
@@ -89,8 +94,9 @@ FTP, BitTorrent и Metalink. aria2 может загрузить файл с р
    ``#deprecated``, ``#help``, ``#all``.
    По умолчанию: ``#basic``
 
-Параметры HTTP/FTP
+Параметры HTTP/FTP/SFTP
-~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~
+
 .. option:: --all-proxy=<PROXY>
 
   Использовать указанный прокси-сервер для всех протоколов. Для отмены
@@ -197,6 +203,17 @@ FTP, BitTorrent и Metalink. aria2 может загрузить файл с р
   ``1M`` -``1024M``.
   По умолчанию: ``20M``
 
+
+.. option:: --netrc-path=<FILE>
+
+   Указать путь к файлу .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=<USER>
 
   Задать пользователя для FTP.
@@ -566,6 +583,10 @@ FTP, BitTorrent и Metalink. aria2 может загрузить файл с р
   то будет использован активный режим.
   По умолчанию: ``true``
 
+  .. note::
+
+    Этот параметр игнорируется для SFTP-передачи.
+
 .. option:: --ftp-proxy=<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=<TYPE>=<DIGEST>
+
+  Задать контрольную сумму для публичного SSH-ключа хоста. TYPE - тип хэша.
+  Поддерживаемые типы хэшей - ``sha-1`` или ``md5``.
+  DIGEST - шестнадцатеричное значение хэша.
+  Например: ``sha-1=b030503d4de4539dc7885e6f0f5e256704edf4c3``.
+  Этот параметр может быть использован для проверки публичного ключа сервера
+  при использовании SFTP. Если параметр не задан (по умолчанию), то никакой
+  проверки не происходит.
+
 Параметры BitTorrent/Metalink
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 .. option:: --select-file=<INDEX>...
@@ -1422,12 +1457,12 @@ FTP, BitTorrent и Metalink. aria2 может загрузить файл с р
 
 .. option:: --multiple-interface=<INTERFACES>
 
-  Разделенный запятыми список интерфейсов, для привязки к сокетами.
+  Разделенный запятыми список интерфейсов для привязки сокетов.
-  Запросы будут разделяться между интерфейсами для достижения
+  Запросы будут разделяться между интерфейсами для достижения объединения
-  объединения каналов. Вы можете указать имя интерфейса, IP-адрес и
+  каналов. Вы можете указать имя интерфейса (например, eth0),
-  имя хоста. Если используется :option:`--interface`, то этот параметр
+  IP-адрес (например, 192.168.0.12) и имя хоста (например, myhost). Если
-  будет проигнорирован. Возможные значения: интерфейс, IP-адрес,
+  используется :option:`--interface`, то этот параметр будет проигнорирован.
-  имя хоста
+  Возможные значения: интерфейс, IP-адрес, имя хоста.
 
 .. option:: --log-level=<LEVEL>
 
@@ -1686,13 +1721,14 @@ Metalink-документов, которые хранятся на локаль
 что они всегда будут обрабатываться как отдельная загрузка. Поддерживаются
 оба формата: Metalink4 и Metalink версии 3.0.
 
-Вы можете указать вместе, torrent-файл с параметром -T и URI. Сделав это, вы
+Вы можете указать вместе, torrent-файл с параметром :option:`--torrent-file
-можете загружать файл, используя torrent-рой и HTTP(S)/FTP-сервер
+<-T>` и URI. Сделав это, вы можете загружать файл, используя torrent-рой и
-одновременно, пока данные из HTTP(S)/FTP выгружаются в torrent-рой. Для
+HTTP(S)/FTP/SFTP-сервер одновременно, пока данные из HTTP(S)/FTP/SFTP
-однофайловых торрентов, URI может быть завершенным, который указывает на
+выгружаются в torrent-рой. Для однофайловых торрентов, URI может быть
-ресурс, или же если заканчиваться символом /, тогда name (имя) в
+завершенным, который указывает на ресурс, или же если заканчиваться символом
-torrent-файле будет добавлено. Для многофайловых торрентов, name (имя) и
+/, тогда name (имя) в torrent-файле будет добавлено. Для многофайловых
-path (путь) в torrent-файле будут добавлены из URI для каждого файла.
+торрентов, name (имя) и path (путь) в torrent-файле будут добавлены из URI
+для каждого файла.
 
 .. note::
 
@@ -1724,15 +1760,16 @@ aria2 предоставляет параметры, в которых указ
 :option:`--on-download-stop`.
 
 aria2 передает 3 аргумента указанной команды, которая выполняется. Это
-аргументы: GID, количество файлов и путь к файлу. Для HTTP-, FTP-загрузок,
+аргументы: GID, количество файлов и путь к файлу. Для HTTP-, FTP- и
-обычно количество файлов - 1. BitTorrent загрузка может содержать множество
+SFTP-загрузок, обычно количество файлов - 1. BitTorrent загрузка может
-файлов. Если число файлов больше чем один, то путь к файлу будет для
+содержать множество файлов. Если число файлов больше чем один, то путь к
-первого. Другими словами, это значение параметра path в первой структуре,
+файлу будет для первого. Другими словами, это значение параметра path в
-определенный параметр которой имеет значение true (истина), в ответе
+первой структуре, определенный параметр которой имеет значение true
-RPC-метода :func:`aria2.getFiles`. Если вы хотите получить все пути к
+(истина), в ответе RPC-метода :func:`aria2.getFiles`. Если вы хотите
-файлам, то рассмотрите использование JSON-RPC/XML-RPC. Обратите внимание,
+получить все пути к файлам, то рассмотрите использование
-что путь к файлу может меняться в процессе загрузки по HTTP из-за
+JSON-RPC/XML-RPC. Обратите внимание, что путь к файлу может меняться в
-перенаправления или заголовка Content-Disposition.
+процессе загрузки по 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* (строка). Ответ - это массив структур, которые содержат
   следующие ключи. Значения являются строками.