瀏覽代碼

Merge pull request #548 from ITriskTI/patch-2

Update aria2c.rst
Tatsuhiro Tsujikawa 9 年之前
父節點
當前提交
0b7ee8be21
共有 1 個文件被更改,包括 50 次插入3 次删除
  1. 50 3
      doc/manual-src/ru/aria2c.rst

+ 50 - 3
doc/manual-src/ru/aria2c.rst

@@ -44,7 +44,7 @@ HTTP(S)/FTP, они тут же могут выгружаться в BitTorrent-
   Входной файл может использовать gzip-сжатие.
   Смотрите подраздел `Входной файл`_ для детальных пояснений.
   Также смотрите параметр :option:`--deferred-input`.
-  Также смотрите параметр :option:`--save-session-file`.
+  Также смотрите параметр :option:`--save-session`.
 
 .. option:: -l, --log=<LOG>
 
@@ -181,7 +181,10 @@ HTTP(S)/FTP, они тут же могут выгружаться в BitTorrent-
   удаленных HTTP/FTP-серверов NUM раз без получения, хотя бы одного байта,
   тогда принудительно отказывается от загрузки. Укажите ``0``, чтобы
   отключить этот параметр. Этот параметр действенен только, когда
-  используются HTTP/FTP-серверы.
+  используются HTTP/FTP-серверы. Количество повторных попыток засчитывается в
+  :option:`--max-tries`, таким образом, этот параметр также должен быть
+  сконфигурирован.
+
   По умолчанию: ``0``
 
 .. option:: -m, --max-tries=<N>
@@ -1457,6 +1460,15 @@ HTTP(S)/FTP, они тут же могут выгружаться в BitTorrent-
   загрузок. Значение 0 отключит сохранение результата загрузки.
   По умолчанию: ``1000``
 
+.. option:: --max-mmap-limit=<SIZE>
+
+  Задать максимальный размер файла для включения mmap (см. параметр
+  :option:`--enable-mmap`). Размер файла определяется по сумме всех файлов,
+  содержащихся в одной загрузке. Например, если загрузка содержит 5 файлов, то
+  размер файла - это суммарный размер этих файлов. Если размер файла строго больше
+  чем размер, указанный в этом параметре, то mmap будет отключён.
+  По умолчанию: ``9223372036854775807``
+
 .. option:: --max-resume-failure-tries=<N>
 
   Если параметр :option:`--always-resume=false, <--always-resume>` aria2
@@ -2147,6 +2159,7 @@ URI. Эти дополнительные строки должны начина
   * :option:`max-connection-per-server <-x>`
   * :option:`max-download-limit <--max-download-limit>`
   * :option:`max-file-not-found <--max-file-not-found>`
+  * :option:`max-mmap-limit <--max-mmap-limit>`
   * :option:`max-resume-failure-tries <--max-resume-failure-tries>`
   * :option:`max-tries <-m>`
   * :option:`max-upload-limit <-u>`
@@ -2336,6 +2349,10 @@ RPC-метод `system.multicall` обрабатывается особым об
   против RPC-интерфейса. Поэтому рекомендуется отдавать предпочтение пакетным
   или `system.multicall` запросам, когда это необходимо.
 
+  `system.listMethods` может выполняться без секретного маркера. Так он
+  просто возвращает все доступные методы, и ничего не изменяет, это
+  безопасно без секретного маркера.
+
 Методы
 ~~~~~~
 
@@ -2801,7 +2818,7 @@ RPC-метод `system.multicall` обрабатывается особым об
 .. function:: aria2.getFiles([secret], gid)
 
   Этот метод возвращает список файлов загрузки, которая обозначена *gid* (строка).
-  Ответ - это массив и содержит следующие ключи.
+  Ответ - это массив структур, которые содержат следующие ключи.
   Значения являются строками.
 
   ``index``
@@ -3529,6 +3546,36 @@ RPC-метод `system.multicall` обрабатывается особым об
     >>> tuple(r)
     ('2089b05ecca3d829', 'd2703803b52216d1')
 
+.. function:: system.listMethods()
+
+  Этот метод возвращает все доступные RPC-методы в массиве строк.
+  В отличие от других методов, этот метод не требует секретный маркер.
+  Это безопасно, потому что этот метод просто возвращает названия доступных
+  методов.
+
+  **Пример JSON-RPC**
+  ::
+
+    >>> import urllib2, json
+    >>> from pprint import pprint
+    >>> jsonreq = json.dumps({'jsonrpc':'2.0', 'id':'qwer',
+    ...                       'method':'system.listMethods'})
+    >>> c = urllib2.urlopen('http://localhost:6800/jsonrpc', jsonreq)
+    >>> pprint(json.loads(c.read()))
+    {u'id': u'qwer',
+     u'jsonrpc': u'2.0',
+     u'result': [u'aria2.addUri',
+                 u'aria2.addTorrent',
+    ...
+
+  **Пример XML-RPC**
+  ::
+
+    >>> import xmlrpclib
+    >>> s = xmlrpclib.ServerProxy('http://localhost:6800/rpc')
+    >>> s.system.listMethods()
+    ['aria2.addUri', 'aria2.addTorrent', ...
+
 Обработка ошибок
 ~~~~~~~~~~~~~~~~