diff --git a/doc/ru/aria2c.1 b/doc/ru/aria2c.1 index 16e6c3aa..dae15c0f 100644 --- a/doc/ru/aria2c.1 +++ b/doc/ru/aria2c.1 @@ -1,10 +1,10 @@ .\" t .\" Title: aria2c -.\" Author: Tatsuhiro Tsujikawa +.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.75.2 -.\" Date: 05/21/2011 +.\" Date: 06/21/2011 .\" Manual: Aria2 Manual -.\" Source: Aria2 1.11.2 +.\" Source: Aria2 1.12.0 .\" Language: English .\" .\"******************************************************************* @@ -12,7 +12,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH ARIA2C 1 05/21/2011 "Aria2 1\&.11\&.2" "Руководство по Aria2" +.TH ARIA2C 1 06/21/2011 "Aria2 1\&.12\&.0" "Руководство по Aria2" .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- @@ -33,7 +33,7 @@ .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH НАЗВАНИЕ -aria2c \- Ультра быстрая утилита загрузки +aria2c \- сверхбыстрая утилита загрузки .SH СИНТАКСИС .sp aria2c [\fIПАРАМЕТРЫ\fP] [\fIURI\fP | \fIMAGNET\-ССЫЛКА\fP | \fITORRENT\-ФАЙЛ\fP | @@ -47,7 +47,7 @@ HTTP(S), FTP, BitTorrent и Metalink\&. Для загрузки файла, aria HTTP(S)/FTP и BitTorrent одновременно, пока данные загружаются по HTTP(S)/FTP, они тут же могут выгружаться в BitTorrent\-рой\&. Используя контрольные суммы блока данных для Metalink, aria2 автоматически проверяет -куски данных, которые загружаются по BitTorrent\&. +части данных, которые загружаются по BitTorrent\&. .SH ПАРАМЕТРЫ .SS "Основные параметры" .PP @@ -340,6 +340,23 @@ IP\-адреса\&. умолчанию: \fI5\fP .RE .PP +\fB\-\-stream\-piece\-selector\fP=SELECTOR +.RS 4 +Укажите алгоритм выбора блока, который используется в +HTTP/FTP\-загрузке\&. Блок \- означает сегмент фиксированной длины, который +загружается параллельно, в разделенной на части, загрузке\&. Если задано +\fIdefault\fP, то aria2 выберет блок так, чтобы это уменьшило количество +установленных подключений\&. Это разумное поведение по умолчанию, поскольку +установка подключения очень затратная операция\&. Если задано \fIinorder\fP, то +aria2 выберет блок, который имеет минимальный индекс\&. Index=0 означает +первый из файла\&. Это будет полезно при просмотре фильма, в то время как он +загружается\&. Параметр \fB\-\-enable\-http\-pipelining\fP может быть полезен для +снижения накладных расходов при повторном подключении\&. Обратите внимание, +что aria2 принимает на обработку параметр \fB\-\-min\-split\-size\fP, так что +необходимо будет указать разумное значение параметра +\fB\-\-min\-split\-size\fP\&. По умолчанию: \fIdefault\fP +.RE +.PP \fB\-t\fP, \fB\-\-timeout\fP=SEC .RS 4 Задать время ожидания в секундах\&. По умолчанию: \fI60\fP @@ -1067,6 +1084,12 @@ aria2 использует один из них\&. Используйте пар умолчанию: \fIfalse\fP .RE .PP +\fB\-\-pause\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Приостановка загрузки после добавления\&. Этот параметр действенен только, +когда задан \fB\-\-enable\-rpc\fP=\fItrue\fP\&. По умолчанию: \fIfalse\fP +.RE +.PP \fB\-\-rpc\-listen\-all\fP[=\fItrue\fP|\fIfalse\fP] .RS 4 Слушать входящие JSON\-RPC/XML\-RPC запросы на всех сетевых @@ -1221,14 +1244,15 @@ Content\-Disposition\&. Если контрольный файл существ предварительное резервирование места для файла перед началом загрузки\&. Это может продолжаться некоторое время, в зависимости от размера файла\&. Если вы используете новые файловые системы, наподобие ext4 (с поддержкой -экстентов), btrfs или xfs, тогда лучше выбрать \fIfalloc\fP\&. Так как они -резервируют место под большие (на несколько Гигабайт) файлы почти -мгновенно\&. Не используйте \fIfalloc\fP вместе с наследными файловыми -системами, такими как ext3 потому, что это будет продолжаться почти столько -же времени, как и \fIprealloc\fP, а также полностью заблокирует aria2, пока не -окончится резервирование места\&. \fIfalloc\fP может быть недоступным, если -ваша система не содержит функцию \fBposix_fallocate\fP()\&. Возможные значения: -\fInone\fP, \fIprealloc\fP, \fIfalloc\fP\&. По умолчанию: \fIprealloc\fP +экстентов), btrfs, xfs или NTFS (только сборка MinGW) тогда лучше выбрать +\fIfalloc\fP\&. Так как они резервируют место под большие (на несколько +Гигабайт) файлы почти мгновенно\&. Не используйте \fIfalloc\fP вместе с +наследными файловыми системами, такими как ext3 и FAT32, потому что это +будет продолжаться почти столько же времени, как и \fIprealloc\fP, а также +полностью заблокирует aria2, пока не закончится резервирование +места\&. \fIfalloc\fP может быть недоступным, если ваша система не содержит +функцию \fBposix_fallocate\fP()\&. Возможные значения: \fInone\fP, \fIprealloc\fP, +\fIfalloc\fP\&. По умолчанию: \fIprealloc\fP .RE .PP \fB\-\-human\-readable\fP[=\fItrue\fP|\fIfalse\fP] @@ -1457,7 +1481,9 @@ IP\-адрес (например, 192.168.0.12), имя хоста (наприм передать этот выходной файл aria2c с параметром \fB\-i\fP при перезапуске\&. Обратите внимание, что загрузки добавленные через RPC\-методы \fBaria2\&.addTorrent\fP, \fBaria2\&.addMetalink\fP и чьи метаданные не могут быть -сохранены как файл, не будут сохраняться\&. +сохранены как файл, не будут сохраняться\&. Загрузки удаленные с +использованием \fBaria2\&.remove\fP и \fBaria2\&.forceRemove\fP не будут +сохранены\&. .RE .PP \fB\-\-stop\fP=SEC @@ -1466,6 +1492,12 @@ IP\-адрес (например, 192.168.0.12), имя хоста (наприм \fI0\fP, эта возможность будет отключена\&. По умолчанию: \fI0\fP .RE .PP +\fB\-\-truncate\-console\-readout\fP[=\fItrue\fP|\fIfalse\fP] +.RS 4 +Укорачивать консольный вывод, чтобы он поместился в одну строку\&. По +умолчанию: \fItrue\fP +.RE +.PP \fB\-v\fP, \fB\-\-version\fP .RS 4 Вывести номер версии, информацию об авторских правах, конфигурации и @@ -3053,6 +3085,30 @@ URI\&. Эти дополнительные строки должны начин \fBmetalink\-base\-uri\fP .RE .sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBpause\fP +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBstream\-piece\-selector\fP +.RE +.sp Эти параметры имеют точно такой же смысл, что параметры командной строки, но это применимо только к URI, к которым они принадлежат\&. Обратите внимание, что параметры во входном файле не должны иметь префикс "\-\-"\&. @@ -3544,8 +3600,8 @@ BitTorrent\-трекером\&. все значения\&. Это полезно, если вы хотите использовать определенные параметры, чтобы исключить множество пересылок\&. Например, \fBaria2\&.tellStatus\fP("1", ["gid", "status"]) возвратит \fIgid\fP и -\fIstatus\fP\&. Ответ имеет тип структура и содержит следующие поля\&. Поля -имеют тип строка\&. +\fIstatus\fP\&. Ответ имеет тип структура и содержит следующие поля\&. Поле +имеет тип строка\&. .PP gid .RS 4 @@ -4497,6 +4553,85 @@ URI, если одинаковые URI существуют в загрузке, .nr an-break-flag 1 .br .ps +1 +\fBaria2.getGlobalStat ()\fP +.RS 4 +.sp +Этот метод возвращает глобальную статистику по скорости загрузки и скорости +отдачи\&. Ответ имеет тип структура и содержит следующие поля\&. Поле имеет +тип строка\&. +.PP +downloadSpeed +.RS 4 +Общая скорости загрузки (байт/сек)\&. +.RE +.PP +uploadSpeed +.RS 4 +Общая скорости отдачи (байт/сек)\&. +.RE +.PP +numActive +.RS 4 +Количество активных загрузок\&. +.RE +.PP +numWaiting +.RS 4 +Количество ожидающих загрузок\&. +.RE +.PP +numStopped +.RS 4 +Количество остановленных загрузок\&. +.RE +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import urllib2, json +>>> from pprint import pprint +>>> jsonreq = json\&.dumps({\*(Aqjsonrpc\*(Aq:\*(Aq2\&.0\*(Aq, \*(Aqid\*(Aq:\*(Aqqwer\*(Aq, +\&.\&.\&. \*(Aqmethod\*(Aq:\*(Aqaria2\&.getGlobalStat\*(Aq}) +>>> c = urllib2\&.urlopen(\*(Aqhttp://localhost:6800/jsonrpc\*(Aq, jsonreq) +>>> pprint(json\&.loads(c\&.read())) +{u\*(Aqid\*(Aq: u\*(Aqqwer\*(Aq, + u\*(Aqjsonrpc\*(Aq: u\*(Aq2\&.0\*(Aq, + u\*(Aqresult\*(Aq: {u\*(AqdownloadSpeed\*(Aq: u\*(Aq21846\*(Aq, + u\*(AqnumActive\*(Aq: u\*(Aq2\*(Aq, + u\*(AqnumStopped\*(Aq: u\*(Aq0\*(Aq, + u\*(AqnumWaiting\*(Aq: u\*(Aq0\*(Aq, + u\*(AquploadSpeed\*(Aq: u\*(Aq0\*(Aq}} +.fi +.if n \{\ +.RE +.\} +.sp +.if n \{\ +.RS 4 +.\} +.nf +>>> import xmlrpclib +>>> from pprint import pprint +>>> s = xmlrpclib\&.ServerProxy(\*(Aqhttp://localhost:6800/rpc\*(Aq) +>>> r = s\&.aria2\&.getGlobalStat() +>>> pprint(r) +{\*(AqdownloadSpeed\*(Aq: \*(Aq23136\*(Aq, + \*(AqnumActive\*(Aq: \*(Aq2\*(Aq, + \*(AqnumStopped\*(Aq: \*(Aq0\*(Aq, + \*(AqnumWaiting\*(Aq: \*(Aq0\*(Aq, + \*(AquploadSpeed\*(Aq: \*(Aq0\*(Aq} +.fi +.if n \{\ +.RE +.\} +.RE +.sp +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 \fBaria2.purgeDownloadResult ()\fP .RS 4 .sp @@ -6144,14 +6279,8 @@ General Public License во всех отношениях для всего ис это\&. Если вы не хотите сделать это, удалите это заявление об исключении из вашей версии\&. Если вы удалите это заявление об исключении из всех исходных файлов в программе, то удалить его и здесь\&. -.SH АВТОР -.PP -\fBTatsuhiro Tsujikawa\fP <\&t\-tujikawa@users\&.sourceforge\&.net\&> -.RS 4 -Автор. -.RE .SH "АВТОР ПЕРЕВОДА" ITriskTI -.SH "ПРИМЕЧАНИЕ +.SH "ПРИМЕЧАНИЕ" Эта страница руководства может содержать не обязательно самую последнюю информацию. Если есть некоторые противоречия между этой страницей руководства и фактическим программным обеспечением, пожалуйста, обращайтесь к английской версии страницы руководства. \ No newline at end of file