Update and fixed some bugs

doc/manual-src/ru/aria2c.rst

@@ -978,6 +978,13 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
   Добавить заголовок Access-Control-Allow-Origin со значением ``*`` в RPC-ответе.
   По умолчанию: ``false``
 
+.. option:: --rpc-certificate=<FILE>
+
+  Использовать сертификат в FILE для RPC-сервера. Сертификат должен быть
+  в PEM-формате. Используйте параметр :option:`--rpc-private-key`,
+  чтобы указать закрытый ключ. Используйте параметр :option:`--rpc-secure`
+  для включения шифрования.
+
 .. option:: --rpc-listen-all[=true|false]
 
   Слушать входящие JSON-RPC/XML-RPC-запросы на всех сетевых интерфейсах.
@@ -1002,6 +1009,32 @@ FTP, BitTorrent и Metalink. Для загрузки файла, aria2 може
 
   Задать JSON-RPC/XML-RPC пароль.
 
+.. option:: --rpc-private-key=<FILE>
+
+  Использовать закрытый ключ в FILE для RPC-сервера. Закрытый ключ должен
+  быть дешифрованным и в PEM-формате. Используйте параметр
+  :option:`--rpc-secure` для включения шифрования.
+  Смотрите также параметр :option:`--rpc-certificate`.
+
+.. option:: --rpc-save-upload-metadata[=true|false]
+
+  Сохранить загруженные метаданные torrent или metalink в каталоге,
+  заданном параметром :option:`--dir`. Имя файла содержит
+  шестнадцатеричную строку SHA-1-хэша метаданных плюс расширение.
+  Для torrent расширение '.torrent'. Для metalink - это '.meta4'.
+  Если параметр задан как false, то загрузки, добавленные с помощью
+  :func:`aria2.addTorrent` или :func:`aria2.addMetalink`, не будут
+  сохраняться при помощи параметра :option:`--save-session`.
+  По умолчанию: ``false``
+
+.. option:: --rpc-secure[=true|false]
+
+  RPC-транспорт будет зашифрован с использованием SSL/TLS. RPC-клиенты должны
+  использовать https-схему для доступа к серверу. Для WebSocket-клиента,
+  использовать wss-схему. Используйте параметры :option:`--rpc-certificate` и
+  :option:`--rpc-private-key` для указания сертификата севера и закрытого
+  ключа.
+
 .. option:: --rpc-user=<USER>
 
   Задать JSON-RPC/XML-RPC пользователя.
@@ -1439,8 +1472,8 @@ Metalink-документов, которые хранятся на локаль
 одновременно, пока данные из HTTP(S)/FTP выгружаются в torrent-рой. Для
 однофайловых торрентов, URI может быть завершенным, который указывает на
 ресурс, или же если заканчиваться символом /, тогда name (имя) в
-torrent-файле будет добавлено. Для многофайловых торентов, name (имя) и path
+torrent-файле будет добавлено. Для многофайловых торрентов, name (имя) и
-(путь) в torrent-файле будут добавлены из URI для каждого файла.
+path (путь) в torrent-файле будут добавлены из URI для каждого файла.
 
 .. note::
 
@@ -1848,6 +1881,7 @@ URI. Эти дополнительные строки должны начина
   * :option:`remove-control-file <--remove-control-file>`
   * :option:`retry-wait <--retry-wait>`
   * :option:`reuse-uri <--reuse-uri>`
+  * :option:`rpc-save-upload-metadata <--rpc-save-upload-metadata>`
   * :option:`seed-ratio <--seed-ratio>`
   * :option:`seed-time <--seed-time>`
   * :option:`select-file <--select-file>`
@@ -1943,7 +1977,8 @@ WebSocket`_.
 ``/jsonrpc``. Путь запроса к XML-RPC-интерфейсу - ``/rpc``.
 
 WebSocket URI для JSON-RPC через WebSocket является
-``ws://HOST:PORT/jsonrpc``.
+``ws://HOST:PORT/jsonrpc``. Если вы включили SSL/TLS-шифрование, то
+используйте ``wss://HOST:PORT/jsonrpc``.
 
 Реализованный JSON-RPC основан на спецификации JSON-RPC 2.0
 <http://jsonrpc.org/specification> и поддерживает HTTP POST и GET
@@ -2038,15 +2073,15 @@ GID
   
   
   
-  Этот метод добавляет BitTorrent-загрузку путем загрузки .torrent-файла. Если
+  Этот метод добавляет BitTorrent-загрузку путем загрузки .torrent-файла.
-  вы хотите добавить BitTorrent Magnet URI, взамен используйте метод
+  Если вы хотите добавить BitTorrent Magnet URI, взамен используйте метод
-  :func:`aria2.addUri`. Параметр *torrent* имеет тип
+  :func:`aria2.addUri`. Параметр *torrent* имеет тип base64, с содержанием
-  base64, с содержанием Base64-кодировки
+  Base64-кодировки в .torrent-файле. Параметр *uris* имеет тип массив,
-  в .torrent-файле. Параметр *uris* имеет тип массив, элемент которого имеет тип строка и содержит URI.
+  элемент которого имеет тип строка и содержит URI.
   Параметр *uris* используется для Web-сидирования. Для однофайловых
-  торрентов, URI может быть завершенным, который указывает на ресурс, или же
+  торрентов, URI может быть завершенным, который указывает на ресурс,
-  если заканчиваться символом /, тогда будет добавлено имя из
+  или же если заканчиваться символом /, тогда будет добавлено имя из
-  torrent-файла. Для многофайловых торентов, имя и путь в торренте будут
+  torrent-файла. Для многофайловых торрентов, имя и путь в торренте будут
   добавлены из URI для каждого файла. Параметр *options* имеет тип структура,
   элементы которой являются парой имя и значение. Смотрите ниже
   :ref:`rpc_options` для более подробной информации. Если
@@ -2054,11 +2089,13 @@ GID
   будет вставлена на позицию *position* в очередь ожидания. Если параметр
   *position* не задан или больше чем размер очереди, то загрузка будет
   добавлена в конец очереди. Этот метод возвращает GID зарегистрированной
-  загрузки. Загруженные данные сохраняются в файл с именем шестнадцатеричной
+  загрузки. Если :option:`--rpc-save-upload-metadata` задан как ``true``,
+  загруженные данные сохраняются в файл с именем шестнадцатеричной
   строки SHA-1-хэша этих данных плюс ".torrent", в каталог указанный в
   параметре :option:`--dir <-d>`. Например, имя файла
   0a3893293e27ac0490424c06de4d09242215f0a6.torrent. Если этот файл существует,
-  то он будет перезаписан. Если файл не может быть успешно сохранен, то
+  то он будет перезаписан. Если файл не может быть успешно сохранен или
+  :option:`--rpc-save-upload-metadata` задан как ``false``, то
   загрузки, добавленные этим методом, не сохраняются при помощи параметра
   :option:`--save-session`.
   
@@ -2107,9 +2144,10 @@ GID
   строки SHA-1-хэша этих данных плюс ".metalink", в каталог указанный в
   параметре :option:`--dir <-d>`. Например, имя файла
   0a3893293e27ac0490424c06de4d09242215f0a6.metalink. Если этот файл
-  существует, то он будет перезаписан. Если файл не может быть успешно
+  существует, то он будет перезаписан. Если файл не может быть успешно сохранен
-  сохранен, то загрузки, добавленные этим методом, не сохраняются при помощи
+  или :option:`--rpc-save-upload-metadata` задан как ``false``, то
-  параметра :option:`--save-session`.
+  загрузки, добавленные этим методом, не сохраняются при помощи параметра
+  :option:`--save-session`.
   
   **Пример JSON-RPC**
   
@@ -2975,9 +3013,9 @@ GID
   `Входной файл`_, исключая следующие параметры:
   :option:`dry-run <--dry-run>`, 
   :option:`metalink-base-uri <--metalink-base-uri>`, 
-  :option:`parameterized-uri <-P>`, :option:`pause <--pause>` и
+  :option:`parameterized-uri <-P>`, :option:`pause <--pause>`,  :option:`piece-length <--piece-length>` и
-  :option:`piece-length <--piece-length>`. Этот метод возвращает ``"OK"``, в
+  :option:`rpc-save-upload-metadata <--rpc-save-upload-metadata>`.
-  случае успеха.
+  Этот метод возвращает ``"OK"``, в случае успеха.
   
   **Пример JSON-RPC**
   
@@ -3952,6 +3990,18 @@ Checksum
 
   $ aria2c --ca-certificate=/path/to/ca-certificates.crt --check-certificate https://host/file
 
+RPC
+~~~
+
+Шифрование RPC-транспорта с использованием SSL/TLS
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Указать файл с сертификатом сервера и файл с закрытым ключом следующим
+образом:
+
+.. code-block:: console
+
+  $ aria2c --enable-rpc --rpc-certificate=/path/to/server.crt --rpc-private-key=/path/to/server.key --rpc-secure
 
 И еще больше расширенных возможностей
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~