pull/899/merge
Tse Kit Yam 2017-05-08 13:38:32 +00:00 committed by GitHub
commit 60de32211b
2 changed files with 137 additions and 137 deletions

View File

@ -11,7 +11,7 @@ SINOPSE
.. index:: double: Descrição; Sumário .. index:: double: Descrição; Sumário
double: Resumo; Executivo double: Resumo; Executivo
triple: O que; Por que; Porque triple: O que; Por que; Porque
DESCRIÇÃO DESCRIÇÃO
--------- ---------
@ -88,7 +88,7 @@ Opções Comuns
Continua o download a partir de um download parcial, anteriormente Continua o download a partir de um download parcial, anteriormente
interrompido. Use esta opção para retormar um download iniciado a partir interrompido. Use esta opção para retormar um download iniciado a partir
de um browser (navegador) ou outro programa que faz baixa de arquivos de um browser (navegador) ou outro programa que faz baixa de arquivos
sequencialmente desde o início. sequencialmente desde o início.
Atualmente esta opção só é aplicavel a download de HTTP, HTTPS e FTP. Atualmente esta opção só é aplicavel a download de HTTP, HTTPS e FTP.
@ -98,8 +98,8 @@ Opções Comuns
``#``. Por exemplo, digitar ``--help=#http`` para obter a explicação do uso das ``#``. Por exemplo, digitar ``--help=#http`` para obter a explicação do uso das
opções do tema ``#http``. Se digitar um termo que não é tema, haverá exibição opções do tema ``#http``. Se digitar um termo que não é tema, haverá exibição
das opções que incluem o termo informado. das opções que incluem o termo informado.
Valores disponíveis para temas podem ser: ``#basic``, ``#advanced``, Valores disponíveis para temas podem ser: ``#basic``, ``#advanced``,
``#http``, ``#https``, ``#ftp``, ``#http``, ``#https``, ``#ftp``,
``#metalink``, ``#bittorrent``, ``#cookie``, ``#hook``, ``#file``, ``#rpc``, ``#metalink``, ``#bittorrent``, ``#cookie``, ``#hook``, ``#file``, ``#rpc``,
``#checksum``, ``#experimental``, ``#deprecated``, ``#help``, ``#all`` ``#checksum``, ``#experimental``, ``#deprecated``, ``#help``, ``#all``
Padrão: ``#basic`` Padrão: ``#basic``
@ -121,25 +121,25 @@ Opções HTTP / FTP
Ver também seção `VARIÁVEIS DE AMBIENTE`_ section. Ver também seção `VARIÁVEIS DE AMBIENTE`_ section.
.. note:: .. note::
Se usuário e senha são embutidos na URI do proxy eles também podem ser Se usuário e senha são embutidos na URI do proxy eles também podem ser
especificados através das opções especificados através das opções
*--{http,https,ftp,all}-proxy-{usuário,senha}*, *--{http,https,ftp,all}-proxy-{usuário,senha}*,
aqueles que aparecerem por último assumem a precedência. aqueles que aparecerem por último assumem a precedência.
Por exemplo, quando temos: Por exemplo, quando temos:
``http-proxy-user=meunome``, ``http-proxy-passwd=minhasenha`` ``http-proxy-user=meunome``, ``http-proxy-passwd=minhasenha``
em aria2.conf e especificamos ``--http-proxy="http://svrproxy"`` na em aria2.conf e especificamos ``--http-proxy="http://svrproxy"`` na
linha de comando, então obtemos como proxy HTTP ``http://svrproxy`` linha de comando, então obtemos como proxy HTTP ``http://svrproxy``
com o usuário ``meunome`` e senha ``minhasenha``. com o usuário ``meunome`` e senha ``minhasenha``.
Outro exemplo: quando especificamos na linha de comando: Outro exemplo: quando especificamos na linha de comando:
``--http-proxy="http://usuário:senha@svrproxy" --http-proxy-user="meunome" ``--http-proxy="http://usuário:senha@svrproxy" --http-proxy-user="meunome"
--http-proxy-passwd="minhasenha"``, então obtemos proxy HTTP --http-proxy-passwd="minhasenha"``, então obtemos proxy HTTP
``http://svrproxy`` com usuário ``meunome`` e senha ``minhasenha``. ``http://svrproxy`` com usuário ``meunome`` e senha ``minhasenha``.
Mais um exemplo: se especificamos na linha de comando: Mais um exemplo: se especificamos na linha de comando:
``--http-proxy-user="meunome" --http-proxy-passwd="minhasenha" ``--http-proxy-user="meunome" --http-proxy-passwd="minhasenha"
--http-proxy="http://utilizador:acesso@svrproxy"``, então obtemos --http-proxy="http://utilizador:acesso@svrproxy"``, então obtemos
o proxy HTTP ``http://svrproxy`` com o usuário ``utilizador`` o proxy HTTP ``http://svrproxy`` com o usuário ``utilizador``
e a senha ``acesso``. e a senha ``acesso``.
@ -169,9 +169,9 @@ Opções HTTP / FTP
.. option:: --dry-run[=true|false] .. option:: --dry-run[=true|false]
Se ``true`` é informado, aria2 apenas verifica se o arquivo remoto está Se ``true`` é informado, aria2 apenas verifica se o arquivo remoto está
disponível para download dos dados. Esta opção tem efeito em downloads de disponível para download dos dados. Esta opção tem efeito em downloads de
servidores HTTP, HTTPS e FTP. Downloads de BitTorrent serão cancelados se for servidores HTTP, HTTPS e FTP. Downloads de BitTorrent serão cancelados se for
especificado ``true``. especificado ``true``.
Padrão: ``false`` Padrão: ``false``
@ -208,12 +208,12 @@ Opções HTTP / FTP
aria2 não divide menos que 2 * TAMANHO o intervalo de bytes. Por exemplo, aria2 não divide menos que 2 * TAMANHO o intervalo de bytes. Por exemplo,
considere download de um arquivo de 20MiB. Se o TAMANHO é 10M, aria2 pode considere download de um arquivo de 20MiB. Se o TAMANHO é 10M, aria2 pode
dividir o arquivo em 2 intervalos de [0-10MiB) e [10MiB-20MiB) e executar o dividir o arquivo em 2 intervalos de [0-10MiB) e [10MiB-20MiB) e executar o
download usando 2 fontes (logicamente se a opção :option:`--split <-s>` >= 2). download usando 2 fontes (logicamente se a opção :option:`--split <-s>` >= 2).
Se o TAMANHO é 15M, desde que 2 * 15M > 20Mib, aria2 não dividirá o arquivo e Se o TAMANHO é 15M, desde que 2 * 15M > 20Mib, aria2 não dividirá o arquivo e
fará o download de 1 fonte. Pde ser anexado ``K`` ou ``M`` fará o download de 1 fonte. Pde ser anexado ``K`` ou ``M``
(1K = 1024, 1M = 1024K). (1K = 1024, 1M = 1024K).
Valores Possíveis: ``1M`` -``1024M`` Valores Possíveis: ``1M`` -``1024M``
Padrão: ``20M`` Padrão: ``20M``
.. option:: -n, --no-netrc[=true|false] .. option:: -n, --no-netrc[=true|false]
@ -222,7 +222,7 @@ Opções HTTP / FTP
Padrão: Suporte a netrc é habilitado por padrão. Padrão: Suporte a netrc é habilitado por padrão.
.. note:: .. note::
arquivo netrc é lido somente no início se a opção :option:`--no-netrc <-n>` é arquivo netrc é lido somente no início se a opção :option:`--no-netrc <-n>` é
``false``. ``false``.
Portanto se a opção :option:`--no-netrc <-n>` é ``true`` no início, não haverá Portanto se a opção :option:`--no-netrc <-n>` é ``true`` no início, não haverá
@ -238,14 +238,14 @@ Opções HTTP / FTP
.. note:: .. note::
Para endereço de rede com blocos CIDR, ambos endereços IPv4 ou IPv6 funcionam. Para endereço de rede com blocos CIDR, ambos endereços IPv4 ou IPv6 funcionam.
Implementação atual, não resolve nome host em URI para comparar com endereço Implementação atual, não resolve nome host em URI para comparar com endereço
especificado na opção :option:`--no-proxy`. Portanto só será efetiva se a URI especificado na opção :option:`--no-proxy`. Portanto só será efetiva se a URI
possuir números de endereço IP. possuir números de endereço IP.
.. option:: -o, --out=<ARQUIVO> .. option:: -o, --out=<ARQUIVO>
O nome do arquivo baixado. Quando a opção :option:`--force-sequential <-Z>` é O nome do arquivo baixado. Quando a opção :option:`--force-sequential <-Z>` é
utilizada esta opção será ignorada. utilizada esta opção será ignorada.
.. note:: .. note::
@ -275,7 +275,7 @@ Opções HTTP / FTP
.. option:: --reuse-uri[=true|false] .. option:: --reuse-uri[=true|false]
Reutilizar uma URI já utilizada. Se não habilitada as URIs já utilizadas serão Reutilizar uma URI já utilizada. Se não habilitada as URIs já utilizadas serão
abandonadas. abandonadas.
Padrão: ``true`` Padrão: ``true``
@ -292,7 +292,7 @@ Opções HTTP / FTP
Para carregar dados já salvos utilizar opção :option:`--server-stat-if`. Para carregar dados já salvos utilizar opção :option:`--server-stat-if`.
Ver subseção `Perfil Performance Servidor`_ abaixo, Ver subseção `Perfil Performance Servidor`_ abaixo,
para o formato do arquivo. para o formato do arquivo.
.. option:: --server-stat-if=<ARQUIVO> .. option:: --server-stat-if=<ARQUIVO>
@ -320,7 +320,7 @@ Opções HTTP / FTP
Padrão: ``5`` Padrão: ``5``
.. note:: .. note::
Some Metalinks regulate the number of servers to connect. aria2 Some Metalinks regulate the number of servers to connect. aria2
strictly respects them. This means that if Metalink defines the strictly respects them. This means that if Metalink defines the
maxconnections attribute lower than N, then aria2 uses the maxconnections attribute lower than N, then aria2 uses the
@ -382,7 +382,7 @@ Opções Específicas de HTTP e HTTPS
Utilizar o certificado do ARQUIVO FILE para verificar os Servidores. Utilizar o certificado do ARQUIVO FILE para verificar os Servidores.
O certificado precisa estar no formato PEM e pode conter múltiplos O certificado precisa estar no formato PEM e pode conter múltiplos
certificados CA. certificados CA.
Utilizar a opção :option:`--check-certificate` para habilitar a verificação. Utilizar a opção :option:`--check-certificate` para habilitar a verificação.
.. note:: .. note::
@ -408,11 +408,11 @@ Opções Específicas de HTTP e HTTPS
.. option:: --http-accept-gzip[=true|false] .. option:: --http-accept-gzip[=true|false]
Envia cabeçalho requisição ``Accept: deflate, gzip`` e faz (inflate) se Envia cabeçalho requisição ``Accept: deflate, gzip`` e faz (inflate) se
o servidor remoto responder com ``Content-Encoding: gzip`` ou o servidor remoto responder com ``Content-Encoding: gzip`` ou
``Content-Encoding: deflate``. Padrão: ``false`` ``Content-Encoding: deflate``. Padrão: ``false``
.. note:: .. note::
Alguns servidores respondem com ``Content-Encoding: gzip`` para arquivos Alguns servidores respondem com ``Content-Encoding: gzip`` para arquivos
que são gzip. aria2 faz inflate destes por causa do cabeçalho de resposta. que são gzip. aria2 faz inflate destes por causa do cabeçalho de resposta.
@ -478,7 +478,7 @@ Opções Específicas de HTTP e HTTPS
Define a referência. Afeta todas URIs. Se ``*`` é usado, cada URI requisitada é usada Define a referência. Afeta todas URIs. Se ``*`` é usado, cada URI requisitada é usada
como referência (referer). Pode ser útil quando usado em conjunto com a opção como referência (referer). Pode ser útil quando usado em conjunto com a opção
:option:`--parameterized-uri`. :option:`--parameterized-uri`.
.. option:: --enable-http-keep-alive[=true|false] .. option:: --enable-http-keep-alive[=true|false]
@ -491,7 +491,7 @@ Opções Específicas de HTTP e HTTPS
Padrão: ``false`` Padrão: ``false``
.. note:: .. note::
Da perspectiva de performance, não há vantagem em habilitar esta opção. Da perspectiva de performance, não há vantagem em habilitar esta opção.
.. option:: --header=<HEADER> .. option:: --header=<HEADER>
@ -513,14 +513,14 @@ Opções Específicas de HTTP e HTTPS
.. note:: .. note::
Se aria2 é compilado sem libsqlite3, então não havera suporte aos formatos Se aria2 é compilado sem libsqlite3, então não havera suporte aos formatos
de cookie Firefox3 e Chromium / Google Chrome. de cookie Firefox3 e Chromium / Google Chrome.
.. option:: --save-cookies=<ARQUIVO> .. option:: --save-cookies=<ARQUIVO>
Salva Cookies para o ARQUIVO no formato Mozilla / Firefox(1.x/2.x) / Salva Cookies para o ARQUIVO no formato Mozilla / Firefox(1.x/2.x) /
Netscape. Se ARQUIVO já existe, será sobreposto. Cookies da Sessão também Netscape. Se ARQUIVO já existe, será sobreposto. Cookies da Sessão também
serão salvos e seus valores de expiração serão tratados como 0. serão salvos e seus valores de expiração serão tratados como 0.
Valores Possíveis: ``/caminho/do/arquivo`` Valores Possíveis: ``/caminho/do/arquivo``
.. option:: --use-head[=true|false] .. option:: --use-head[=true|false]
@ -607,13 +607,13 @@ Opções Comuns de BitTorrent / Metalink
Imprimir a lista de arquivos do ".torrent", ".meta4" e ".metalink" e termina. Imprimir a lista de arquivos do ".torrent", ".meta4" e ".metalink" e termina.
No caso de arquivo ".torrent", informações adicionais são impressas. No caso de arquivo ".torrent", informações adicionais são impressas.
(infohash, tamanho pedaço, etc). (infohash, tamanho pedaço, etc).
Opções Específicas de BitTorrent Opções Específicas de BitTorrent
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. option:: --bt-enable-lpd[=true|false] .. option:: --bt-enable-lpd[=true|false]
Habilita Descobrir Peer Local. Se indicador particular é configurado Habilita Descobrir Peer Local. Se indicador particular é configurado
no torrent, aria2 não usa esta funcionalidade mesmo que ``true`` foi no torrent, aria2 não usa esta funcionalidade mesmo que ``true`` foi
informato. informato.
Padrão: ``false`` Padrão: ``false``
@ -622,7 +622,7 @@ Opções Específicas de BitTorrent
Lista separada por vírgulas, de trackers de URI BitTorrent que devem ser Lista separada por vírgulas, de trackers de URI BitTorrent que devem ser
removidas. Pode ser usado o valor especial ``*`` para especificar todas removidas. Pode ser usado o valor especial ``*`` para especificar todas
URIs; isso irá excluir todas URIs de "announce". Quando especificar ``*`` URIs; isso irá excluir todas URIs de "announce". Quando especificar ``*``
em uma linha de comando do shell, lembre-se de forçar o escape or delimite em uma linha de comando do shell, lembre-se de forçar o escape or delimite
com aspas, apóstrofo ou em linux com crase caracter `. com aspas, apóstrofo ou em linux com crase caracter `.
Ver também opção :option: `--bt-tracker`. Ver também opção :option: `--bt-tracker`.
@ -635,7 +635,7 @@ Opções Específicas de BitTorrent
.. option:: --bt-hash-check-seed[=true|false] .. option:: --bt-hash-check-seed[=true|false]
Se ``true`` é informado, após o check do hash usando a opção :option: Se ``true`` é informado, após o check do hash usando a opção :option:
`--check-integrity <-V>` e o arquivo esta completo, continue o arquivo seed. `--check-integrity <-V>` e o arquivo esta completo, continue o arquivo seed.
Se desejar verificar o arquivo e efetuar o download somente quando ele estiver Se desejar verificar o arquivo e efetuar o download somente quando ele estiver
imcompleto ou danificado, defina esta opção para ``false``. Esta opção imcompleto ou danificado, defina esta opção para ``false``. Esta opção
@ -692,23 +692,23 @@ Opções Específicas de BitTorrent
Remove os arquivos não selecionados quando o download do BitTorrent estiver Remove os arquivos não selecionados quando o download do BitTorrent estiver
completo. Para selecionar arquivo(s) use a opção :option:`--select-file`. completo. Para selecionar arquivo(s) use a opção :option:`--select-file`.
Se não for usada esta opção, é assumido que todos os arquivos serão Se não for usada esta opção, é assumido que todos os arquivos serão
selecionados. Use esta opção com critério pois ela realmente remove selecionados. Use esta opção com critério pois ela realmente remove
arquivo(s) do seu disco. arquivo(s) do seu disco.
Padrão: ``false`` Padrão: ``false``
.. option:: --bt-require-crypto[=true|false] .. option:: --bt-require-crypto[=true|false]
Se true é informado, aria2 não aceita nem estabelece conexão com handshake de Se true é informado, aria2 não aceita nem estabelece conexão com handshake de
BitTorrent (protocolo \19BitTorrent). Em vez disso aria2 usa BitTorrent (protocolo \19BitTorrent). Em vez disso aria2 usa
(Obfuscation handshake. (Obfuscation handshake.
Padrão: ``false`` Padrão: ``false``
.. option:: --bt-request-peer-speed-limit=<VELOCIDADE> .. option:: --bt-request-peer-speed-limit=<VELOCIDADE>
Se a velocidade total de download do torrent é menor que a <VELOCIDADE>, Se a velocidade total de download do torrent é menor que a <VELOCIDADE>,
aria2 temporariamente incrementa o número de peers para tentar maior aria2 temporariamente incrementa o número de peers para tentar maior
velocidade de download. Configurando esta opção com sua velocidade velocidade de download. Configurando esta opção com sua velocidade
preferida pode incrementar a velocidade de download em alguns casos. Pode preferida pode incrementar a velocidade de download em alguns casos. Pode
ser anexado ``K`` ou ``M`` (1K = 1024, 1M = 1024K). ser anexado ``K`` ou ``M`` (1K = 1024, 1M = 1024K).
Padrão: ``50K`` Padrão: ``50K``
@ -719,7 +719,7 @@ Opções Específicas de BitTorrent
se URI usada é de BitTorrent Magnet. O nome do arquivo é codificado em hash se URI usada é de BitTorrent Magnet. O nome do arquivo é codificado em hash
em hexadecimal com sufixo de ".torrent". O diretório onde será salvo o em hexadecimal com sufixo de ".torrent". O diretório onde será salvo o
o metadado, é o mesmo onde aponta o download do arquivo. Se o arquivo já o metadado, é o mesmo onde aponta o download do arquivo. Se o arquivo já
existe, o metadado não será salvo. Ver tambémn a opção :option: existe, o metadado não será salvo. Ver tambémn a opção :option:
`--bt-metadata-only`. `--bt-metadata-only`.
Padrão: ``false`` Padrão: ``false``
@ -730,9 +730,9 @@ Opções Específicas de BitTorrent
.. option:: --bt-stop-timeout=<SEGUNDOS> .. option:: --bt-stop-timeout=<SEGUNDOS>
Interrompe o download do BitTorrent se a velocidade do for zero por Interrompe o download do BitTorrent se a velocidade do for zero por
consecutivos SEGUNDOS. Se ``0`` é informado, esta funcionalidade é consecutivos SEGUNDOS. Se ``0`` é informado, esta funcionalidade é
desabilitada. desabilitada.
Padrão: ``0`` Padrão: ``0``
.. option:: --bt-tracker=<URI>[,...] .. option:: --bt-tracker=<URI>[,...]
@ -815,7 +815,7 @@ Opções Específicas de BitTorrent
.. option:: --enable-dht6[=true|false] .. option:: --enable-dht6[=true|false]
Habilita funcionalidade DHT IPv6. Se identificador particular é usado em um Habilita funcionalidade DHT IPv6. Se identificador particular é usado em um
torrent, aria2 não usa DHT para aquele download mesmo que ``true`` foi torrent, aria2 não usa DHT para aquele download mesmo que ``true`` foi
informado. Usar opção :option:`--dht-listen-port` para especificar número(s) informado. Usar opção :option:`--dht-listen-port` para especificar número(s)
de porta(s) para ser(em) ouvida(s). Ver também opção :option:` de porta(s) para ser(em) ouvida(s). Ver também opção :option:`
--dht-listen-addr6` --dht-listen-addr6`
@ -823,14 +823,14 @@ Opções Específicas de BitTorrent
.. option:: --enable-peer-exchange[=true|false] .. option:: --enable-peer-exchange[=true|false]
Habilita extensão Peer Exchange. Se um indicador particular é usado nesse Habilita extensão Peer Exchange. Se um indicador particular é usado nesse
torrent, essa funcionalidade será desabilitada para o download, mesmo que torrent, essa funcionalidade será desabilitada para o download, mesmo que
``true`` foi informado. ``true`` foi informado.
Padrão: ``true`` Padrão: ``true``
.. option:: --follow-torrent=true|false|mem .. option:: --follow-torrent=true|false|mem
Se ``true`` ou ``mem`` é especificado, quando um arquivo cujo sufixo é Se ``true`` ou ``mem`` é especificado, quando um arquivo cujo sufixo é
``.torrent`` ou o tipo de conteúdo é ``application/x-bittorrent`` é baixado, ``.torrent`` ou o tipo de conteúdo é ``application/x-bittorrent`` é baixado,
aria2 faz o parse como arquivo torrent e executa o download dos arquivos aria2 faz o parse como arquivo torrent e executa o download dos arquivos
mencionados nele. mencionados nele.
@ -843,7 +843,7 @@ Opções Específicas de BitTorrent
Define o caminho do arquivo com índice=INDEX. O arquivo índice pode ser Define o caminho do arquivo com índice=INDEX. O arquivo índice pode ser
localizado usando-se a opção :option:`--show-files <-S>`. PATH é o caminho localizado usando-se a opção :option:`--show-files <-S>`. PATH é o caminho
relativo ao caminho especificado na opção :option:`--dir <-d>`. relativo ao caminho especificado na opção :option:`--dir <-d>`.
Esta opção pode ser usada múltiplas vezes. Com esta opção pode-se especificar Esta opção pode ser usada múltiplas vezes. Com esta opção pode-se especificar
o nome dos arquivos que serão baixados pelo BitTorrent. o nome dos arquivos que serão baixados pelo BitTorrent.
@ -862,7 +862,7 @@ Opções Específicas de BitTorrent
.. option:: --max-overall-upload-limit=<VELOCIDADE> .. option:: --max-overall-upload-limit=<VELOCIDADE>
Define a velocidade máxima geral de upload em bytes/seg. ``0`` significa Define a velocidade máxima geral de upload em bytes/seg. ``0`` significa
irrestrito. Pode anexar ``K`` ou ``M`` (1K = 1024, 1M = 1024K). Para irrestrito. Pode anexar ``K`` ou ``M`` (1K = 1024, 1M = 1024K). Para
limitar a velocidade de upload por torrent, usar opção limitar a velocidade de upload por torrent, usar opção
:option:`--max-upload-limit <-u>`. :option:`--max-upload-limit <-u>`.
Padrão: ``0`` Padrão: ``0``
@ -870,7 +870,7 @@ Opções Específicas de BitTorrent
.. option:: -u, --max-upload-limit=<VELOCIDADE> .. option:: -u, --max-upload-limit=<VELOCIDADE>
Define a velocidade máxima para cada torrent em bytes/seg. ``0`` significa Define a velocidade máxima para cada torrent em bytes/seg. ``0`` significa
irrestrito. Pode anexar ``K`` ou ``M`` (1K = 1024, 1M = 1024K). Para irrestrito. Pode anexar ``K`` ou ``M`` (1K = 1024, 1M = 1024K). Para
limitar a velocidade global de upload de torrent, usar opção limitar a velocidade global de upload de torrent, usar opção
:option:`--max-overall-upload-limit`. :option:`--max-overall-upload-limit`.
Padrão: ``0`` Padrão: ``0``
@ -889,7 +889,7 @@ Opções Específicas de BitTorrent
RATIO. RATIO.
You are strongly encouraged to specify equals or more than ``1.0`` here. You are strongly encouraged to specify equals or more than ``1.0`` here.
Specify ``0.0`` if you intend to do seeding regardless of share ratio. Specify ``0.0`` if you intend to do seeding regardless of share ratio.
If :option:`--seed-time` option is specified along with this option, If :option:`--seed-time` option is specified along with this option,
seeding ends when at least one of the conditions is satisfied. seeding ends when at least one of the conditions is satisfied.
Padrão: ``1.0`` Padrão: ``1.0``
@ -899,8 +899,8 @@ Opções Específicas de BitTorrent
:option:`--seed-ratio`. :option:`--seed-ratio`.
.. note:: .. note::
Especificando :option:`--seed-time=0 <--seed-time>` desabilita o (seeding) Especificando :option:`--seed-time=0 <--seed-time>` desabilita o (seeding)
após o download ter sido completado. após o download ter sido completado.
.. option:: -T, --torrent-file=<TORRENT_FILE> .. option:: -T, --torrent-file=<TORRENT_FILE>
@ -914,11 +914,11 @@ Opções Específicas de Metalink
.. option:: --follow-metalink=true|false|mem .. option:: --follow-metalink=true|false|mem
If ``true`` or ``mem`` is specified, when a file whose suffix is ``.meta4`` If ``true`` or ``mem`` is specified, when a file whose suffix is ``.meta4``
or ``.metalink`` or content type of ``application/metalink4+xml`` or or ``.metalink`` or content type of ``application/metalink4+xml`` or
``application/metalink+xml`` is downloaded, aria2 parses it as a metalink ``application/metalink+xml`` is downloaded, aria2 parses it as a metalink
file and downloads files mentioned in it. file and downloads files mentioned in it.
If ``mem`` is specified, a metalink file is not written to the disk, If ``mem`` is specified, a metalink file is not written to the disk,
but is just kept in memory. but is just kept in memory.
If ``false`` is specified, the action mentioned above is not taken. If ``false`` is specified, the action mentioned above is not taken.
Padrão: ``true`` Padrão: ``true``
@ -931,7 +931,7 @@ Opções Específicas de Metalink
.. option:: -M, --metalink-file=<METALINK_FILE> .. option:: -M, --metalink-file=<METALINK_FILE>
The file path to ".meta4" and ".metalink" file. Reads input from stdin when The file path to ".meta4" and ".metalink" file. Reads input from stdin when
``-`` is specified. You are not required to use this option because you can ``-`` is specified. You are not required to use this option because you can
specify ".metalink" files without :option:`--metalink-file <-M>`. specify ".metalink" files without :option:`--metalink-file <-M>`.
@ -958,7 +958,7 @@ Opções Específicas de Metalink
The possible values are ``http``, ``https``, ``ftp`` and ``none``. The possible values are ``http``, ``https``, ``ftp`` and ``none``.
Specify ``none`` to disable this feature. Specify ``none`` to disable this feature.
Padrão: ``none`` Padrão: ``none``
.. option:: --metalink-enable-unique-protocol[=true|false] .. option:: --metalink-enable-unique-protocol[=true|false]
If ``true`` is given and several protocols are available for a mirror in a If ``true`` is given and several protocols are available for a mirror in a
@ -1054,7 +1054,7 @@ Opções Avançadas
.. option:: --allow-overwrite[=true|false] .. option:: --allow-overwrite[=true|false]
Reiniciar o download desde o início se o correspondente arquivo de controle Reiniciar o download desde o início se o correspondente arquivo de controle
não existir. Ver também a opção :option:`--auto-file-renaming`. não existir. Ver também a opção :option:`--auto-file-renaming`.
Padrão: ``false`` Padrão: ``false``
.. option:: --allow-piece-length-change[=true|false] .. option:: --allow-piece-length-change[=true|false]
@ -1086,7 +1086,7 @@ Opções Avançadas
usados pelo resolvedor. Normalmente o resolvedor de DNS assíncronos faz a usados pelo resolvedor. Normalmente o resolvedor de DNS assíncronos faz a
leitura dos endereços a partir do arquivo ``/etc/resolv.conf``. leitura dos endereços a partir do arquivo ``/etc/resolv.conf``.
Quando essa opção é usada é feito uso dos servidores DNS especificados na Quando essa opção é usada é feito uso dos servidores DNS especificados na
opção em detrimento do conteúdo do arquivo ``/etc/resolv.conf``. opção em detrimento do conteúdo do arquivo ``/etc/resolv.conf``.
Podem ser usados ambos endereços IPv4 e IPv6. Essa opção é útil Podem ser usados ambos endereços IPv4 e IPv6. Essa opção é útil
quando o sistema não possui ``/etc/resolv.conf`` e o usuário não tem quando o sistema não possui ``/etc/resolv.conf`` e o usuário não tem
permissão para criá-lo. permissão para criá-lo.
@ -1339,7 +1339,7 @@ Opções Avançadas
Padrão: ``1M`` Padrão: ``1M``
.. note:: .. note::
The possible usecase of :option:`--piece-length` The possible usecase of :option:`--piece-length`
option is change the request range in one HTTP pipelined request. option is change the request range in one HTTP pipelined request.
To enable HTTP pipelining use To enable HTTP pipelining use
@ -1456,7 +1456,7 @@ Opções Avançadas
Truncar a linha da console para ajustar-se a uma linha. Truncar a linha da console para ajustar-se a uma linha.
Padrão: ``true`` Padrão: ``true``
.. option:: -v, --version .. option:: -v, --version
Exibe o número da versão, copyright e informação da configuração e sai. Exibe o número da versão, copyright e informação da configuração e sai.
@ -1488,7 +1488,7 @@ apontar para o mesmo arquivo que será baixado ou o download falhará.
Pode-se especificar um número arbitrátio de URIs de BitTorrent Magnet URI. Pode-se especificar um número arbitrátio de URIs de BitTorrent Magnet URI.
Nove que eles sempre serão tratados como downloads separados. Nove que eles sempre serão tratados como downloads separados.
São suportados Hash de Info de 40 characters e Hast de Info Base32 de 32 São suportados Hash de Info de 40 characters e Hast de Info Base32 de 32
characters. Múltiplos parâmetros ``tr`` são suportados. Devido a URI characters. Múltiplos parâmetros ``tr`` são suportados. Devido a URI
BitTorrent Magnet poder conter o caracter ``&``, é altamente recomendável BitTorrent Magnet poder conter o caracter ``&``, é altamente recomendável
delimitar a URI com apóstrofo single(``'``) ou aspas double(``"``). delimitar a URI com apóstrofo single(``'``) ou aspas double(``"``).
@ -1496,7 +1496,7 @@ delimitar a URI com apóstrofo single(``'``) ou aspas double(``"``).
estiver ausente. Ver http://www.bittorrent.org/beps/bep_0009.html estiver ausente. Ver http://www.bittorrent.org/beps/bep_0009.html
para maiores detalhes sobre URI BitTorrent Magnet. para maiores detalhes sobre URI BitTorrent Magnet.
Pode-se também especificar um número arbitrário de arquivos torrent e Pode-se também especificar um número arbitrário de arquivos torrent e
Documentos Metalink armazenados em um dispositivo local. Note que sempre serão Documentos Metalink armazenados em um dispositivo local. Note que sempre serão
tratados como download distintos. Tanto Metalink4 quanto Metalink da versão 3 tratados como download distintos. Tanto Metalink4 quanto Metalink da versão 3
são suportados. são suportados.
@ -1504,14 +1504,14 @@ são suportados.
Pode-se especificar arquivo torrent usando a opção -T e URI. Fazendo isso Pode-se especificar arquivo torrent usando a opção -T e URI. Fazendo isso
o download será baixado do servidor swarm e HTTP, HTTPS e FTP ao mesmo tempo, o download será baixado do servidor swarm e HTTP, HTTPS e FTP ao mesmo tempo,
enquanto os dados do HTTP, HTTPS e FTP serão uploaded para o swarm torrent. enquanto os dados do HTTP, HTTPS e FTP serão uploaded para o swarm torrent.
Para torrent de um arquivo a URI deve ser completa e apontar inclusive o Para torrent de um arquivo a URI deve ser completa e apontar inclusive o
recurso ou se a URI terminar com / o nome do torrent será adicionado. Para recurso ou se a URI terminar com / o nome do torrent será adicionado. Para
múltiplos torrents, name e caminho serão adicionados para formar a URI, para múltiplos torrents, name e caminho serão adicionados para formar a URI, para
cada um dos arquivos. cada um dos arquivos.
.. note:: .. note::
Certifique-se que a URI seja delimitada por apóstrofo single(``'``) ou Certifique-se que a URI seja delimitada por apóstrofo single(``'``) ou
aspas double(``"``) se a URI contiver ``&`` ou qualquer outro caracter que aspas double(``"``) se a URI contiver ``&`` ou qualquer outro caracter que
tenha significado especial para o shell. tenha significado especial para o shell.
@ -1528,7 +1528,7 @@ retomar do ponto onde foi interrompida a transferência.
Interação com Eventos (Hook) Interação com Eventos (Hook)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
aria2 possui opções para especificar comando arbitrário após um evento aria2 possui opções para especificar comando arbitrário após um evento
específico ocorrer. Atualmente as seguintes opções estão disponíveis: específico ocorrer. Atualmente as seguintes opções estão disponíveis:
:option:`--on-bt-download-complete`, :option:`--on-bt-download-complete`,
@ -1543,10 +1543,10 @@ executado. Estes argumentos são: GID, o número de arquivos e o caminho dos
arquivos. Para downloads HTTP, HTTPS e FTP normalmente o número de arquivos é 1. arquivos. Para downloads HTTP, HTTPS e FTP normalmente o número de arquivos é 1.
BitTorrent podem conter múltiplos arquivos. Se o número de arquivos é maior BitTorrent podem conter múltiplos arquivos. Se o número de arquivos é maior
que 1, o caminho do arquivo é o primeiro. Em outras palavras, este é o valor que 1, o caminho do arquivo é o primeiro. Em outras palavras, este é o valor
da chave path da primeira estrutura se aquela chave for verdadeira como da chave path da primeira estrutura se aquela chave for verdadeira como
resposta do método da função :func:`aria2.getFiles` RPC. resposta do método da função :func:`aria2.getFiles` RPC.
Se for necessário todos os caminhos dos arquivos, considere usar o método Se for necessário todos os caminhos dos arquivos, considere usar o método
JSON-RPC/XML-RPC. Lembre-se que o caminho do arquivo pode ser modificado JSON-RPC/XML-RPC. Lembre-se que o caminho do arquivo pode ser modificado
durante o download no HTTP por causa do redirecionamento ou Disposição do durante o download no HTTP por causa do redirecionamento ou Disposição do
Conteúdo do Cabeçalho. Conteúdo do Cabeçalho.
@ -1660,11 +1660,11 @@ retorno ou saída com base no último erro encontrado.
Se URI Magnet URI está errada. Se URI Magnet URI está errada.
28 28
Se opção está errada ou não é reconhecida ou argumento inválido de uma opção Se opção está errada ou não é reconhecida ou argumento inválido de uma opção
foi informado. foi informado.
29 29
Se o servidor remoto não pode manusear uma requisição devido a sobrecarga Se o servidor remoto não pode manusear uma requisição devido a sobrecarga
temporária ou manutenção. temporária ou manutenção.
30 30
@ -1672,7 +1672,7 @@ retorno ou saída com base no último erro encontrado.
.. note:: .. note::
Um erro ocorrido em um download completado não será reportado como um Um erro ocorrido em um download completado não será reportado como um
status de saida nem como código de retorno (exit status). status de saida nem como código de retorno (exit status).
.. index:: double: Variáveis; Ambiente .. index:: double: Variáveis; Ambiente
@ -1703,13 +1703,13 @@ aria2 reconhece as seguintes variáveis de ambiente.
A opção linha de comando :option:`--all-proxy` sobrepõe este valor. A opção linha de comando :option:`--all-proxy` sobrepõe este valor.
.. note:: .. note::
Apesar de aria2 aceitar os esquemas ``ftp://`` e ``https://`` para proxy de Apesar de aria2 aceitar os esquemas ``ftp://`` e ``https://`` para proxy de
URI, aria2 assume que ``http://`` é especificado e não troca o comportamento URI, aria2 assume que ``http://`` é especificado e não troca o comportamento
com base no esquema especificado. com base no esquema especificado.
``no_proxy [DOMÍNIO,...]`` ``no_proxy [DOMÍNIO,...]``
Especifica nome de servidores, separados por vírgula, domínios e endereços Especifica nome de servidores, separados por vírgula, domínios e endereços
de rede com ou sem blocos CIDR para os quais não será usado proxy. de rede com ou sem blocos CIDR para os quais não será usado proxy.
Sobrepõe o valor no-proxy do arquivo de configuração. Sobrepõe o valor no-proxy do arquivo de configuração.
A opção linha de comando :option:`--no-proxy` sobrepõe este valor. A opção linha de comando :option:`--no-proxy` sobrepõe este valor.
@ -1760,11 +1760,11 @@ tabela de rota do IPv6 DHT está em ``$HOME/.aria2/dht6.dat``.
Netrc Netrc
~~~~~ ~~~~~
Por padrão, o suporte a Netrc está habilitado para HTTP, HTTPS e FTP. Para Por padrão, o suporte a Netrc está habilitado para HTTP, HTTPS e FTP. Para
desabilitar o suporte a netrc especificar :option:`--no-netrc <-n>`. Seu desabilitar o suporte a netrc especificar :option:`--no-netrc <-n>`. Seu
arquivo .netrc precisa ter as permissões corretas (600). arquivo .netrc precisa ter as permissões corretas (600).
Se o nome do servidor inicia com ``.``, aria2 executa pesquisa domínio ao Se o nome do servidor inicia com ``.``, aria2 executa pesquisa domínio ao
invés de pesquisa exata. Isto é uma extensão de aria2. Exemplo de pesquisa invés de pesquisa exata. Isto é uma extensão de aria2. Exemplo de pesquisa
de domínio, imagine as seguinte entrada no arquivo .netrc:: de domínio, imagine as seguinte entrada no arquivo .netrc::
@ -1776,7 +1776,7 @@ de domínio, imagine as seguinte entrada no arquivo .netrc::
Mais exemplos de pesquisa domínio: ``nobrasil.net`` não executa pesquisa Mais exemplos de pesquisa domínio: ``nobrasil.net`` não executa pesquisa
domínio ``.nobrasil.net``. ``dobrasil.org`` não faz pesquisa domínio ``.dobrasil.org`` domínio ``.nobrasil.net``. ``dobrasil.org`` não faz pesquisa domínio ``.dobrasil.org``
pois tem maior amplitude hierárquica por causa do ponto precedente ``.``. Se pois tem maior amplitude hierárquica por causa do ponto precedente ``.``. Se
desejar utilizar ``dobrasil.org``, especificar ``dobrasil.org``. desejar utilizar ``dobrasil.org``, especificar ``dobrasil.org``.
.. index:: triple: aria2; arquivo; controle .. index:: triple: aria2; arquivo; controle
@ -1795,7 +1795,7 @@ estará no "diretório topo" do torrent com o sufixo ``.aria2``. O nome do
torrent). torrent).
Normalmente um arquivo controle é apagado quando o download se completa. Se Normalmente um arquivo controle é apagado quando o download se completa. Se
aria2 detecta que o download não pode ser retomado (por exemplo, quando faz aria2 detecta que o download não pode ser retomado (por exemplo, quando faz
download de um servidor HTTP que não suporta retomar o processamento de um download de um servidor HTTP que não suporta retomar o processamento de um
ponto mas sempre do início), o arquivo de controle não será criado. ponto mas sempre do início), o arquivo de controle não será criado.
@ -1814,7 +1814,7 @@ download. Podem ser especificados múltiplas URIs para cada simples entidade:
separar as entidades por um caracter TAB ou espaço. separar as entidades por um caracter TAB ou espaço.
Cada linha é tratada como se fosse especificada através de um argumento da linha Cada linha é tratada como se fosse especificada através de um argumento da linha
de comando. Entretando estas linhas são afetadas pela opção de comando. Entretando estas linhas são afetadas pela opção
:option:`--force-sequential <-Z>` e pela opção :option:`--parameterized-uri <-P>` :option:`--force-sequential <-Z>` e pela opção :option:`--parameterized-uri <-P>`
Quando as URIs do arquivo de entrada são diretamente lidas pelo aria2, as URIs Quando as URIs do arquivo de entrada são diretamente lidas pelo aria2, as URIs
@ -1829,7 +1829,7 @@ URI. Estas linhas opcionais precisam iniciar com um ou mais espaços.
.. hlist:: .. hlist::
:columns: 3 :columns: 3
* :option:`all-proxy <--all-proxy>` * :option:`all-proxy <--all-proxy>`
* :option:`all-proxy-passwd <--all-proxy-passwd>` * :option:`all-proxy-passwd <--all-proxy-passwd>`
* :option:`all-proxy-user <--all-proxy-user>` * :option:`all-proxy-user <--all-proxy-user>`
@ -1934,7 +1934,7 @@ URI. Estas linhas opcionais precisam iniciar com um ou mais espaços.
* :option:`uri-selector <--uri-selector>` * :option:`uri-selector <--uri-selector>`
* :option:`use-head <--use-head>` * :option:`use-head <--use-head>`
* :option:`user-agent <-U>` * :option:`user-agent <-U>`
Estas opções possuem exatamente o mesmo significado das opções existentes na Estas opções possuem exatamente o mesmo significado das opções existentes na
linha de comando, mas aplicam-se apenas a URI a que pertencem. linha de comando, mas aplicam-se apenas a URI a que pertencem.
Por favor perceba que dentro de um arquivo, elas não terão o prefixo ``--``. Por favor perceba que dentro de um arquivo, elas não terão o prefixo ``--``.
@ -1949,7 +1949,7 @@ Por exemplo, o conteúdo do arquivo de entrada uri.txt é::
Se aria2 é executado com as opções ``-i uri.txt -d /tmp``, então o Se aria2 é executado com as opções ``-i uri.txt -d /tmp``, então o
``arquivo.iso`` será salvo como ``/imagens_iso/arquivo.img`` e será baixado ``arquivo.iso`` será salvo como ``/imagens_iso/arquivo.img`` e será baixado
dos servidores ``http://servidor/arquivo.iso`` e dos servidores ``http://servidor/arquivo.iso`` e
``http://espelho/arquivo.iso``. ``http://espelho/arquivo.iso``.
O arquivo ``ba`` e baixado de ``http://fu/ba`` e salvo como ``/tmp/ba``. O arquivo ``ba`` e baixado de ``http://fu/ba`` e salvo como ``/tmp/ba``.
@ -1972,7 +1972,7 @@ delimitados por virgula. Atualmente esta é a lista de nomes reconhecidos:
Protocolo para este perfil, como ftp, http, https. http é requerido. Protocolo para este perfil, como ftp, http, https. http é requerido.
``dl_speed`` ``dl_speed``
Velocidade média de download observada no download prévio, em bytes por Velocidade média de download observada no download prévio, em bytes por
segundo. Requerido. segundo. Requerido.
``sc_avg_speed`` ``sc_avg_speed``
@ -2017,9 +2017,9 @@ INTERFACE RPC
aria2 provê o serviço JSON-RPC sobre HTTP e XML-RPC sobre HTTP e eles aria2 provê o serviço JSON-RPC sobre HTTP e XML-RPC sobre HTTP e eles
basicamente possuem a mesma funcionalidade. aria2 também provê JSON-RPC basicamente possuem a mesma funcionalidade. aria2 também provê JSON-RPC
sobre WebSocket que utiliza o mesmo formato, do método e assinatura e sobre WebSocket que utiliza o mesmo formato, do método e assinatura e
de resposta do formato JSON-RPC sobre HTTP, mas adicionalmente possui de resposta do formato JSON-RPC sobre HTTP, mas adicionalmente possui
notificações iniciadas pelo servidor. notificações iniciadas pelo servidor.
Ver detalhes na seção `JSON-RPC sobre WebSocket`_ . Ver detalhes na seção `JSON-RPC sobre WebSocket`_ .
O caminho requisitado do interface JSON-RPC (sobre HTTP e sobre O caminho requisitado do interface JSON-RPC (sobre HTTP e sobre
@ -2280,7 +2280,7 @@ Python versão 2.7.
.. function:: aria2.unpauseAll() .. function:: aria2.unpauseAll()
This method is equal to calling :func:`aria2.unpause` for every active/waiting This method is equal to calling :func:`aria2.unpause` for every paused
download. This methods returns ``OK`` for success. download. This methods returns ``OK`` for success.
.. function:: aria2.tellStatus(gid[, keys]) .. function:: aria2.tellStatus(gid[, keys])
@ -2343,7 +2343,7 @@ Python versão 2.7.
``errorCode`` ``errorCode``
The last error code occurred in this download. The value is of type The last error code occurred in this download. The value is of type
string. The error codes are defined in `CÓDIGO DE RETORNO ou SAÍDA`_ string. The error codes are defined in `CÓDIGO DE RETORNO ou SAÍDA`_
section. This value is only available for stopped/completed downloads. section. This value is only available for stopped/completed downloads.
``followedBy`` ``followedBy``
@ -2689,7 +2689,7 @@ Python versão 2.7.
.. function:: aria2.getServers(gid) .. function:: aria2.getServers(gid)
This method returns currently connected HTTP, HTTPS, FTP servers of the This method returns currently connected HTTP, HTTPS, FTP servers of the
download denoted by *gid*. *gid* is of type string. The response download denoted by *gid*. *gid* is of type string. The response
is of type array and its element is of type struct and it contains is of type array and its element is of type struct and it contains
following keys. The value type is string. following keys. The value type is string.
@ -3260,7 +3260,7 @@ de erro em (faultString).
Opções Opções
~~~~~~ ~~~~~~
Same options for :option:`--input-file <-i>` list are available. Same options for :option:`--input-file <-i>` list are available.
Ver subseção `Arquivo de Entrada`_ para lista completa de opções. Ver subseção `Arquivo de Entrada`_ para lista completa de opções.
In the option struct, name element is option name(without preceding In the option struct, name element is option name(without preceding
@ -3338,7 +3338,7 @@ JSON-RPC usando HTTP GET
~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~
The JSON-RPC interface also supports request via HTTP GET. The JSON-RPC interface also supports request via HTTP GET.
The encoding scheme in GET parameters is based on JSON-RPC over HTTP The encoding scheme in GET parameters is based on JSON-RPC over HTTP
Specification [2008-1-15(RC1)]. The encoding of GET parameters are follows:: Specification [2008-1-15(RC1)]. The encoding of GET parameters are follows::
/jsonrpc?method=METHOD_NAME&id=ID&params=BASE64_ENCODED_PARAMS /jsonrpc?method=METHOD_NAME&id=ID&params=BASE64_ENCODED_PARAMS
@ -3392,67 +3392,67 @@ Para enviar uma requisição RPC para um servidor RPC, enviar strings serializad
JSON num frame Text. A resposta do servidor RPC será entregue também em um frame JSON num frame Text. A resposta do servidor RPC será entregue também em um frame
Text. Text.
O servidor RPC ira enviar a notificação ao cliente. A notificação é O servidor RPC ira enviar a notificação ao cliente. A notificação é
unidirecional, portanto o cliente que receber a notificação não pode unidirecional, portanto o cliente que receber a notificação não pode
responde-la. Esse método de assinatura de notificação é muito usual mas responde-la. Esse método de assinatura de notificação é muito usual mas
não provê uma identificação de chave. Os valores associados pelos parâmetros não provê uma identificação de chave. Os valores associados pelos parâmetros
chave são os dados que a notificação porta. O formato desses valores chave são os dados que a notificação porta. O formato desses valores
variam dependendo do método de notificação. Os seguintes métodos de notificação variam dependendo do método de notificação. Os seguintes métodos de notificação
são definidos: são definidos:
.. function:: aria2.onDownloadStart(event) .. function:: aria2.onDownloadStart(event)
Essa notificação será enviada quando e se o download for iniciado. Essa notificação será enviada quando e se o download for iniciado.
*event* é o tipo de estrutura e pode conter as seguintes chaves: *event* é o tipo de estrutura e pode conter as seguintes chaves:
O formato do valor é string. O formato do valor é string.
``gid`` ``gid``
GID do download. GID do download.
.. function:: aria2.onDownloadPause(event) .. function:: aria2.onDownloadPause(event)
Esta notificação será enviada se o download for pausado. *event* Esta notificação será enviada se o download for pausado. *event*
tem a mesma estrutura do argumento *event* do método da função tem a mesma estrutura do argumento *event* do método da função
:func:`aria2.onDownloadStart`. :func:`aria2.onDownloadStart`.
.. function:: aria2.onDownloadStop(event) .. function:: aria2.onDownloadStop(event)
Essa notificação será enviada se o download for interrompido pelo usuário. Essa notificação será enviada se o download for interrompido pelo usuário.
*event* tem a mesma estrutura do argumento *event* do método da função *event* tem a mesma estrutura do argumento *event* do método da função
:func:`aria2.onDownloadStart`. :func:`aria2.onDownloadStart`.
.. function:: aria2.onDownloadComplete(event) .. function:: aria2.onDownloadComplete(event)
Esta notificação será enviada quando o download for completado. Para Esta notificação será enviada quando o download for completado. Para
downloads BitTorrent, esta notificação será enviada quando for completado e downloads BitTorrent, esta notificação será enviada quando for completado e
o (seed) terminar. O *event* tem a mesma estrutura do *event* do método da o (seed) terminar. O *event* tem a mesma estrutura do *event* do método da
função :func:`aria2.onDownloadStart`. função :func:`aria2.onDownloadStart`.
.. function:: aria2.onDownloadError(event) .. function:: aria2.onDownloadError(event)
Esta notificação será enviada se o download for interrompido por causa de Esta notificação será enviada se o download for interrompido por causa de
um erro. um erro.
O *event* tem a mesma estrutura do *event* do método da função O *event* tem a mesma estrutura do *event* do método da função
:func:`aria2.onDownloadStart`. :func:`aria2.onDownloadStart`.
.. function:: aria2.onBtDownloadComplete(event) .. function:: aria2.onBtDownloadComplete(event)
Esta notificação será enviada se o download for completado para o Esta notificação será enviada se o download for completado para o
BitTorrent (mas o seeding pode não ter sido concluído). O *event* tem a BitTorrent (mas o seeding pode não ter sido concluído). O *event* tem a
mesma estrutura do *event* do método da função :func:`aria2.onDownloadStart`. mesma estrutura do *event* do método da função :func:`aria2.onDownloadStart`.
Exemplo Cliente XML-RPC Ruby Exemplo Cliente XML-RPC Ruby
~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -3463,15 +3463,15 @@ imprime a resposta do processamento:
.. code-block:: ruby .. code-block:: ruby
#!/usr/bin/env ruby #!/usr/bin/env ruby
require 'xmlrpc/client' require 'xmlrpc/client'
require 'pp' require 'pp'
client=XMLRPC::Client.new2("http://localhost:6800/rpc") client=XMLRPC::Client.new2("http://localhost:6800/rpc")
options={ "dir" => "/downloads" } options={ "dir" => "/downloads" }
result=client.call("aria2.addUri", [ "http://localhost/aria2.tar.bz2" ], options) result=client.call("aria2.addUri", [ "http://localhost/aria2.tar.bz2" ], options)
pp result pp result
@ -3480,7 +3480,7 @@ interagir com aria2::
import xmlrpclib import xmlrpclib
from pprint import pprint from pprint import pprint
s = xmlrpclib.ServerProxy("http://localhost:6800/rpc") s = xmlrpclib.ServerProxy("http://localhost:6800/rpc")
r = s.aria2.addUri(["http://localhost/aria2.tar.bz2"], {"dir":"/downloads"}) r = s.aria2.addUri(["http://localhost/aria2.tar.bz2"], {"dir":"/downloads"})
pprint(r) pprint(r)
@ -3508,7 +3508,7 @@ Entenda o que estes números e strings significam.
será exibida a somatória do tamanho do arquivo. será exibida a somatória do tamanho do arquivo.
``SEEDING`` ``SEEDING``
Taxa compartilhamento ratio. O cliente está funcionando. Após término do Taxa compartilhamento ratio. O cliente está funcionando. Após término do
download do BitTorrent, ``SIZE`` será substituído por ``SEEDING``. download do BitTorrent, ``SIZE`` será substituído por ``SEEDING``.
``CN`` ``CN``
@ -3529,7 +3529,7 @@ Entenda o que estes números e strings significam.
``TOTAL SPD`` ``TOTAL SPD``
A soma das velocidades de download para todos downloads paralelos. A soma das velocidades de download para todos downloads paralelos.
Quando aria2 está alocando o espaço para arquivo ou validando o checksum, Quando aria2 está alocando o espaço para arquivo ou validando o checksum,
adicionalmente exibirá o progresso: adicionalmente exibirá o progresso:
FileAlloc FileAlloc
@ -3552,7 +3552,7 @@ Download de arquivo
.. note:: .. note::
Para parar o download, pressione :kbd:`Ctrl-C`. Posteriormente pode ser Para parar o download, pressione :kbd:`Ctrl-C`. Posteriormente pode ser
retomado o mesmo download no mesmo diretório. Podem ser modificadas as URIs retomado o mesmo download no mesmo diretório. Podem ser modificadas as URIs
pois elas apontam para o mesmo arquivo. pois elas apontam para o mesmo arquivo.
@ -3598,7 +3598,7 @@ Para HTTP:
.. code-block:: console .. code-block:: console
$ aria2c --http-proxy="http://svrproxy:8080" $ aria2c --http-proxy="http://svrproxy:8080"
--no-proxy="localhost,127.0.0.1,192.168.0.0/16" "http://servidor/arquivo" --no-proxy="localhost,127.0.0.1,192.168.0.0/16" "http://servidor/arquivo"
a máscara de rede /16 quer dizer que para toda a rede 192.168 também não a máscara de rede /16 quer dizer que para toda a rede 192.168 também não
@ -3612,7 +3612,7 @@ Para FTP:
.. note:: .. note::
Ver :option:`--http-proxy`, :option:`--https-proxy`, :option:`--ftp-proxy`, Ver :option:`--http-proxy`, :option:`--https-proxy`, :option:`--ftp-proxy`,
:option:`--all-proxy` e :option:`--no-proxy` para detalhes. Proxy pode ser :option:`--all-proxy` e :option:`--no-proxy` para detalhes. Proxy pode ser
especificado nas variáveis de ambiente. Ver seção `VARIÁVEIS DE AMBIENTE`_ . especificado nas variáveis de ambiente. Ver seção `VARIÁVEIS DE AMBIENTE`_ .
@ -3621,14 +3621,14 @@ Proxy com autenticação / autorização
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. code-block:: console .. code-block:: console
$ aria2c --http-proxy="http://usuário:senha@svrproxy:8080" $ aria2c --http-proxy="http://usuário:senha@svrproxy:8080"
"http://servidor/arquivo" "http://servidor/arquivo"
.. code-block:: console .. code-block:: console
$ aria2c --http-proxy="http://svrproxy:8080" $ aria2c --http-proxy="http://svrproxy:8080"
--http-proxy-user="usuário" --http-proxy-passwd="senha" --http-proxy-user="usuário" --http-proxy-passwd="senha"
"http://servidor/arquivo" "http://servidor/arquivo"
@ -3650,7 +3650,7 @@ Download arquivos com Metalink local
.. note:: .. note::
Para parar o download, pressione :kbd:`Ctrl-C`. Para parar o download, pressione :kbd:`Ctrl-C`.
A transferência pode ser retomada executando aria2c com o mesmo argumento A transferência pode ser retomada executando aria2c com o mesmo argumento
no mesmo diretório no mesmo diretório
Download diversos arquivos Metalink local Download diversos arquivos Metalink local
@ -3773,7 +3773,7 @@ Modificar porta escuta para peer de entrada
.. note:: .. note::
Já que aria2 não configura o firewall ou porta de roteamento para portas Já que aria2 não configura o firewall ou porta de roteamento para portas
de encaminhamento, isto deve ser explicitado manualmente por você. de encaminhamento, isto deve ser explicitado manualmente por você.
Especificar condição para para o programa torrent após término do download Especificar condição para para o programa torrent após término do download
@ -3785,7 +3785,7 @@ Especificar condição para para o programa torrent após término do download
.. note:: .. note::
No exemplo acima, o programa termina após transcorrer 120 minutos após No exemplo acima, o programa termina após transcorrer 120 minutos após
término do download ou taxa chegar a 1.0. término do download ou taxa chegar a 1.0.
Controlar velocidade upload Torrent Controlar velocidade upload Torrent
@ -3814,7 +3814,7 @@ Habilitar IPv6 DHT
.. note:: .. note::
Se aria2c não foi compilado com c-ares, a opção :option:`--enable-async-dns6` Se aria2c não foi compilado com c-ares, a opção :option:`--enable-async-dns6`
não é necessária. aria2 compartilha a mesma porta ente IPv4 e IPv6 DHT. não é necessária. aria2 compartilha a mesma porta ente IPv4 e IPv6 DHT.
Adicionar e remover rastreador URI Adicionar e remover rastreador URI
@ -3846,7 +3846,7 @@ Continuar download iniciado por navegadores ou outros programas
Quando desejar continuar ou retomar um download cujo processamento foi Quando desejar continuar ou retomar um download cujo processamento foi
interrompido, seja em navegador ou qualquer outro programa utilize interrompido, seja em navegador ou qualquer outro programa utilize
o aria2c para retomar este download do ponto onde parou. o aria2c para retomar este download do ponto onde parou.
.. code-block:: console .. code-block:: console
$ aria2c -c -s2 "http://servidor/arquivodedownloadparcial.zip" $ aria2c -c -s2 "http://servidor/arquivodedownloadparcial.zip"
@ -3861,14 +3861,14 @@ Autenticação certificado para Cliente SSL/TLS
.. note:: .. note::
O arquivo especificado na opção :option:`--private-key` não pode estar O arquivo especificado na opção :option:`--private-key` não pode estar
criptografado. O comportamento do processo fica indefinido quando o criptografado. O comportamento do processo fica indefinido quando o
arquivo estiver criptografado. arquivo estiver criptografado.
Verificar peer em SSL/TLS usando certificados CA Verificar peer em SSL/TLS usando certificados CA
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. code-block:: console .. code-block:: console
$ aria2c --ca-certificate=/path/para/ca-certificates.crt $ aria2c --ca-certificate=/path/para/ca-certificates.crt
--check-certificate https://servidor/arquivo --check-certificate https://servidor/arquivo
@ -3879,7 +3879,7 @@ Controlar velocidade de download
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Quando for necessário o controle da utilização da banda disponível, pode ser Quando for necessário o controle da utilização da banda disponível, pode ser
utilizado a opção abaixo. Atenção o sufixo K ou M deve ser em letra maiúscula. utilizado a opção abaixo. Atenção o sufixo K ou M deve ser em letra maiúscula.
.. code-block:: console .. code-block:: console
@ -3893,7 +3893,7 @@ Reparar um download danificado
$ aria2c -V arquivo.metalink $ aria2c -V arquivo.metalink
.. note:: .. note::
Reparar downloads danificados pode ser mais eficiente usando Reparar downloads danificados pode ser mais eficiente usando
BitTorrent ou Metalink com a opção verificação (checksums). BitTorrent ou Metalink com a opção verificação (checksums).
@ -3936,7 +3936,7 @@ Verificar validação checksum
^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. code-block:: console .. code-block:: console
$ aria2c --checksum=sha-1=0192ba11326fe2298c8cb4de616f4d4140213837 $ aria2c --checksum=sha-1=0192ba11326fe2298c8cb4de616f4d4140213837
http://dobrasil.org/arquivo http://dobrasil.org/arquivo
@ -3989,7 +3989,7 @@ este programa; caso não tenha, escrevá para Free Software Foundation, Inc.,
Adicionalmente, como uma exceção especial, os detentores do direito autoral Adicionalmente, como uma exceção especial, os detentores do direito autoral
autorizam a permissão para compilar programas que possuem ligação com autorizam a permissão para compilar programas que possuem ligação com
parte do código com a biblioteca OpenSSL sob certas condições como descritas parte do código com a biblioteca OpenSSL sob certas condições como descritas
em cada arquivo fonte e autorizam a distribuição das das combinações das em cada arquivo fonte e autorizam a distribuição das das combinações das
ligações incluindo ambas. ligações incluindo ambas.
Devem ser obedecidos todos os detalhes da Licença Pública GNU Genérica Devem ser obedecidos todos os detalhes da Licença Pública GNU Genérica
em relação a OpenSSL. Caso haja modificação nos arquivos com esta exceção em relação a OpenSSL. Caso haja modificação nos arquivos com esta exceção

View File

@ -2677,7 +2677,7 @@ RPC-метод `system.multicall` обрабатывается особым об
.. function:: aria2.unpauseAll([secret]) .. function:: aria2.unpauseAll([secret])
Этот метод эквивалентен по вызову :func:`aria2.unpause`, для каждой Этот метод эквивалентен по вызову :func:`aria2.unpause`, для каждой
активной/ожидающей закачки. Этот метод возвращает ``OK``. приостановлено закачки. Этот метод возвращает ``OK``.
.. function:: aria2.tellStatus([secret], gid[, keys]) .. function:: aria2.tellStatus([secret], gid[, keys])