mirror of https://github.com/aria2/aria2
Add Portuguese manual
This translation is based on aria2 version 1.15.2 manual. Contributed by Gilberto dos Santos Alvespull/46/head
Tatsuhiro Tsujikawa
parent
4095b2ec6b
commit
e8491b989b
|
|
@ -646,6 +646,8 @@ AC_CONFIG_FILES([Makefile
|
|||
doc/manual-src/en/conf.py
|
||||
doc/manual-src/ru/Makefile
|
||||
doc/manual-src/ru/conf.py
|
||||
doc/manual-src/pt/Makefile
|
||||
doc/manual-src/pt/conf.py
|
||||
deps/Makefile])
|
||||
AC_OUTPUT
|
||||
|
||||
|
|
|
|||
|
|
@ -1 +1 @@
|
|||
SUBDIRS = en ru
|
||||
SUBDIRS = en ru pt
|
||||
|
|
|
|||
|
|
@ -0,0 +1,139 @@
|
|||
# Makefile for Sphinx documentation
|
||||
#
|
||||
# You can set these variables from the command line.
|
||||
SPHINXOPTS =
|
||||
SPHINXBUILD = sphinx-build
|
||||
PAPER =
|
||||
BUILDDIR = _build
|
||||
|
||||
# Internal variables.
|
||||
PAPEROPT_a4 = -D latex_paper_size=a4
|
||||
PAPEROPT_letter = -D latex_paper_size=letter
|
||||
ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
|
||||
|
||||
# Configurations for aria2.
|
||||
mandir = @mandir@/pt
|
||||
man_MANS = $(BUILDDIR)/man/aria2c.1
|
||||
EXTRA_DIST = $(man_MANS) aria2c.rst index.rst README.rst _static/default2.css
|
||||
|
||||
$(man_MANS): aria2c.rst
|
||||
$(MAKE) man
|
||||
|
||||
# Autogenerated rules by sphinx-quickstart
|
||||
|
||||
.PHONY: help docclean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest
|
||||
|
||||
help:
|
||||
@echo "Please use \`make <target>' where <target> is one of"
|
||||
@echo " html to make standalone HTML files"
|
||||
@echo " dirhtml to make HTML files named index.html in directories"
|
||||
@echo " singlehtml to make a single large HTML file"
|
||||
@echo " pickle to make pickle files"
|
||||
@echo " json to make JSON files"
|
||||
@echo " htmlhelp to make HTML files and a HTML help project"
|
||||
@echo " qthelp to make HTML files and a qthelp project"
|
||||
@echo " devhelp to make HTML files and a Devhelp project"
|
||||
@echo " epub to make an epub"
|
||||
@echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
|
||||
@echo " latexpdf to make LaTeX files and run them through pdflatex"
|
||||
@echo " text to make text files"
|
||||
@echo " man to make manual pages"
|
||||
@echo " changes to make an overview of all changed/added/deprecated items"
|
||||
@echo " linkcheck to check all external links for integrity"
|
||||
@echo " doctest to run all doctests embedded in the documentation (if enabled)"
|
||||
|
||||
docclean:
|
||||
-rm -rf $(BUILDDIR)/*
|
||||
|
||||
html:
|
||||
$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
|
||||
@echo
|
||||
@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
|
||||
|
||||
dirhtml:
|
||||
$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
|
||||
@echo
|
||||
@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
|
||||
|
||||
singlehtml:
|
||||
$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
|
||||
@echo
|
||||
@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
|
||||
|
||||
pickle:
|
||||
$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
|
||||
@echo
|
||||
@echo "Build finished; now you can process the pickle files."
|
||||
|
||||
json:
|
||||
$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
|
||||
@echo
|
||||
@echo "Build finished; now you can process the JSON files."
|
||||
|
||||
htmlhelp:
|
||||
$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
|
||||
@echo
|
||||
@echo "Build finished; now you can run HTML Help Workshop with the" \
|
||||
".hhp project file in $(BUILDDIR)/htmlhelp."
|
||||
|
||||
qthelp:
|
||||
$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
|
||||
@echo
|
||||
@echo "Build finished; now you can run "qcollectiongenerator" with the" \
|
||||
".qhcp project file in $(BUILDDIR)/qthelp, like this:"
|
||||
@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/aria2.qhcp"
|
||||
@echo "To view the help file:"
|
||||
@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/aria2.qhc"
|
||||
|
||||
devhelp:
|
||||
$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
|
||||
@echo
|
||||
@echo "Build finished."
|
||||
@echo "To view the help file:"
|
||||
@echo "# mkdir -p $$HOME/.local/share/devhelp/aria2"
|
||||
@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/aria2"
|
||||
@echo "# devhelp"
|
||||
|
||||
epub:
|
||||
$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
|
||||
@echo
|
||||
@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
|
||||
|
||||
latex:
|
||||
$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
|
||||
@echo
|
||||
@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
|
||||
@echo "Run \`make' in that directory to run these through (pdf)latex" \
|
||||
"(use \`make latexpdf' here to do that automatically)."
|
||||
|
||||
latexpdf:
|
||||
$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
|
||||
@echo "Running LaTeX files through pdflatex..."
|
||||
$(MAKE) -C $(BUILDDIR)/latex all-pdf
|
||||
@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
|
||||
|
||||
text:
|
||||
$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
|
||||
@echo
|
||||
@echo "Build finished. The text files are in $(BUILDDIR)/text."
|
||||
|
||||
man:
|
||||
$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
|
||||
@echo
|
||||
@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
|
||||
|
||||
changes:
|
||||
$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
|
||||
@echo
|
||||
@echo "The overview file is in $(BUILDDIR)/changes."
|
||||
|
||||
linkcheck:
|
||||
$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
|
||||
@echo
|
||||
@echo "Link check complete; look for any errors in the above output " \
|
||||
"or in $(BUILDDIR)/linkcheck/output.txt."
|
||||
|
||||
doctest:
|
||||
$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
|
||||
@echo "Testing of doctests in the sources finished, look at the " \
|
||||
"results in $(BUILDDIR)/doctest/output.txt."
|
||||
|
|
@ -0,0 +1,488 @@
|
|||
aria2 - Utilitário para Download Super Ultra Rápido
|
||||
===================================================
|
||||
:Author: Tatsuhiro Tsujikawa
|
||||
:Email: t-tujikawa_at_users_dot_sourceforge_dot_net
|
||||
:translator: tradução Portuguese gsavix@gmail.com
|
||||
|
||||
Renúncia
|
||||
--------
|
||||
Este programa não vem com garantias. O uso deste programa é por sua
|
||||
conta e risco.
|
||||
|
||||
Introdução
|
||||
----------
|
||||
aria2 é um utilitário para download de arquivos. Os protocolos suportados são
|
||||
HTTP, HTTPS, FTP, BitTorrent e Metalink. aria2 pode baixar arquivos de
|
||||
múltiplas fontes protocolos e tenta utilizar para isso a máxima banda possível.
|
||||
Pode funcionar em diversas plataformas de computadores e sistemas operacionais,
|
||||
como por exemplo: GNU Linux, OS X, Windows, Android entre outros. Ao mesmo
|
||||
tempo pode executar download de HTTP, HTTPS, FTP e BitTorrent enquanto estes
|
||||
dados podem ser disponibilizados (uploaded) ao mesmo tempo para o BitTorrent ou
|
||||
para você ir assistindo um filme enquanto o download prossegue. Através da
|
||||
verificação (checksum) de partes dos dados dos Metalink's, aria2
|
||||
automaticamente valida partes (chunks) do BitTorrent.
|
||||
|
||||
A página do projeto está em http://aria2.sourceforge.net/.
|
||||
|
||||
Veja `aria2 Manual Online <http://aria2.sourceforge.net/manual/pt/html/>`_
|
||||
e `Exemplos de Uso <http://sourceforge.net/apps/trac/aria2/wiki/UsageExample>`_
|
||||
para aprender como a usar aria2.
|
||||
|
||||
Funcionalidades
|
||||
---------------
|
||||
|
||||
Lista de Configurações:
|
||||
|
||||
* Interface de linha de comando
|
||||
* Download arquivos protocolos HTTP, HTTPS, FTP, BitTorrent
|
||||
* Download Segmentado
|
||||
* Metalink versão 4 (RFC 5854) suporte (HTTP, FTP, BitTorrent)
|
||||
* Metalink versão 3 suporte (HTTP, FTP, BitTorrent)
|
||||
* Metalink (RFC 6249) suporte (HTTP)
|
||||
* Implementação HTTP/1.1
|
||||
* Suporte Proxy HTTP Proxy
|
||||
* Suporte autenticação HTTP BASIC
|
||||
* Suporte autenticação HTTP Proxy
|
||||
* Váriavéis de ambiente (conjunto abrangente) para proxy: http_proxy, https_proxy,
|
||||
ftp_proxy, all_proxy e no_proxy
|
||||
* HTTP com gzip, suporte a codificação de conteúdo (deflate)
|
||||
* Verificação de peer usando Certificados Acreditados informado em HTTPS
|
||||
* Processamento de autenticação Cliente usando Certificado Acreditado HTTPS
|
||||
* Suporte a transferência (Chunked) codificada
|
||||
* Carga de Cookies a partir de arquivos formato Firefox 3, Chromium/Google Chrome
|
||||
e Mozilla / Firefox / IcedWeasel / (1.x/2.x) / Netscape.
|
||||
* Salvar Cookies em arquivo formato Mozilla 3, Firefox (1.x/2.x), Chromium, Netscape.
|
||||
* Suporte a Cabeçalho HTTP modificado ou personalizado
|
||||
* Suporte a Conexões Persistentes
|
||||
* FTP através de Proxy HTTP
|
||||
* Controle de velocidade Download e Upload (utilização da Banda Rede)
|
||||
* Extensões BitTorrent: Conexão rápida, DHT, PEX, MSE/PSE, Multi-Tracker
|
||||
* BitTorrent `WEB-Seeding <http://getright.com/seedtorrent.html>`_. aria2
|
||||
faz requisições de mais de uma parte de um (chunk) para reduzir sobreposições de
|
||||
requisições. Também permite requisições pipeline com tamanho especificado
|
||||
* BitTorrent Local Peer Discovery
|
||||
* Atualização ou Modificação (Rename) de estrutura de diretórios de downloads
|
||||
BitTorrent já finalizados
|
||||
* Interface JSON-RPC (sobre HTTP e WebSocket) / XML-RPC
|
||||
* Execução em modo daemon
|
||||
* Download Seletivosem múltiplos arquivos torrent/Metalink
|
||||
* Validação e checksum de parte (Chunk) em Metalink
|
||||
* Desabilidar download segmentado em Metalink
|
||||
* Suporte a Netrc
|
||||
* Suporte a arquivo de Configuração
|
||||
* Download de URIs a partir de arquivo texto ou entrada padrão com especificação
|
||||
opçional de arquivo de saída
|
||||
* Suporte a URI parametrizadas (intervalos, etc)
|
||||
* Suporte a IPv6
|
||||
|
||||
Como obter o código fonte
|
||||
-------------------------
|
||||
|
||||
O código fonte é mantido no Github:
|
||||
https://github.com/tatsuhiro-t/aria2
|
||||
|
||||
Para obter o último código fonte, execute o seguinte comando::
|
||||
|
||||
$ git clone git://github.com/tatsuhiro-t/aria2.git
|
||||
|
||||
Aria2 será criado no diretório corrente do seu computador com os arquivos fonte.
|
||||
|
||||
|
||||
Dependências
|
||||
------------
|
||||
|
||||
|
||||
======================== ========================================
|
||||
funcionalidade dependência
|
||||
======================== ========================================
|
||||
HTTPS GnuTLS ou OpenSSL
|
||||
BitTorrent libnettle+libgmp ou libgcrypt ou OpenSSL
|
||||
Metalink libxml2 ou Expat.
|
||||
Checksum libnettle ou libgcrypt ou OpenSSL
|
||||
gzip, deflate em HTTP zlib
|
||||
Async DNS C-Ares
|
||||
Firefox3/Chromium cookie libsqlite3
|
||||
XML-RPC libxml2 ou Expat.
|
||||
JSON-RPC sobre WebSocket libnettle ou libgcrypt ou OpenSSL
|
||||
======================== ========================================
|
||||
|
||||
|
||||
.. note::
|
||||
|
||||
libxml2 tem precedência sobre Expat se ambas bibliotecas instaladas.
|
||||
Caso prefira Expat, execute o configure com ``--without-libxml2``.
|
||||
|
||||
.. note::
|
||||
|
||||
GnuTLS tem precedência sobre OpenSSL se ambas bibliotecas instaladas.
|
||||
Caso prefira OpenSSL, execute configure com ``--without-gnutls``
|
||||
``--with-openssl``.
|
||||
|
||||
.. note::
|
||||
|
||||
libnettle tem precedência sobre libgcrypt se ambas bibliotecas instaladas.
|
||||
Caso prefira libgcrypt, execute configure com
|
||||
`--without-libnettle --with-libgcrypt``. Se OpenSSL é selecionada em
|
||||
detrimento de GnuTLS, nem libnettle nem libgcrypt poderão ser usadas.
|
||||
|
||||
São necessárias as seguintes configurações de bibliotecas SSl e cruypto:
|
||||
|
||||
* libgcrypt
|
||||
* libnettle
|
||||
* OpenSSL
|
||||
* GnuTLS + libgcrypt
|
||||
* GnuTLS + libnettle
|
||||
|
||||
BitTorrent e Metalink podem ser desabilitados fornecendo as opções
|
||||
``--disable-bittorrent`` e ``--disable-metalink`` ao executar o script configure.
|
||||
|
||||
|
||||
Para habilitar DNS assíncrono é necessário c-ares.
|
||||
|
||||
* projeto c-ares: http://daniel.haxx.se/projects/c-ares/
|
||||
|
||||
Como fazer o build
|
||||
------------------
|
||||
Para fazer o build do aria2 a partir dos fontes, instalar antes
|
||||
pacotes de desenvolvimento ( o nome pode variar nas distribuições):
|
||||
* libgnutls-dev (Requerido para suporte HTTPS, BitTorrent, Checksum)
|
||||
* nettle-dev (Requerido para suporte BitTorrent, Checksum)
|
||||
* libgmp-dev (Requerido para suporte BitTorrent)
|
||||
* libc-ares-dev (Requerido para suporte DNS async DNS )
|
||||
* libxml2-dev (Requerido para suporte Metalink)
|
||||
* zlib1g-dev (Requerido para suporte em HTTP decodificação gzip e deflate)
|
||||
* libsqlite3-dev (Requerido para suporte cookie Firefox3 / Chromium)
|
||||
|
||||
Você pode usar libgcrypt-dev ao invés de nettle-dev e libgmp-dev:
|
||||
|
||||
* libgpg-error-dev (Requerido para suporte BitTorrent, Checksum)
|
||||
* libgcrypt-dev (Requerido para suporte BitTorrent, Checksum)
|
||||
|
||||
Pode ser usado libssl-dev ao invés de
|
||||
libgnutls-dev, nettle-dev, libgmp-dev, libgpg-error-dev e libgcrypt-dev:
|
||||
|
||||
* libssl-dev (Requerido para suporte Checksum de HTTPS, BitTorrent )
|
||||
|
||||
Pode ser usado libexpat1-dev ao invés de libxml2-dev:
|
||||
|
||||
* libexpat1-dev (Requerido for Metalink suporte)
|
||||
|
||||
Pode ser necessário usar pkg-config para detectar as bibliotecas
|
||||
acima mencionadas.
|
||||
|
||||
Para a distribuição Fedora são necessários os seguintes pacotes:
|
||||
|
||||
* gcc, gcc-c++, kernel-devel, libgcrypt-devel, libgcrypt-devel,
|
||||
libxml2-devel, openssl-devel
|
||||
|
||||
Se foi feito o download do código fonte a partir de um repositório git,
|
||||
deverá ser executado o seguinte comando para criar o script de
|
||||
configuração (configure) e outros scripts também necessários
|
||||
para o build ou compilação do aria2::
|
||||
|
||||
$ autoreconf -i
|
||||
|
||||
Para construir a documentação é necessário instalar
|
||||
`Sphinx <http://sphinx.pocoo.org/>`_ que constroi página (man), html ou pdf
|
||||
contendo a documentação nos idiomas existentes.
|
||||
|
||||
Para construir aria2 para Mac OS X, de uma olhada em build_osx_release.sh,
|
||||
o qual cria binários DMG que são padrões para OS X.
|
||||
|
||||
A maneira mais rápida para compilar o aria2 é executar o script::
|
||||
|
||||
$ ./configure
|
||||
|
||||
Para compilar com link-edição estática utilize o opção da linha
|
||||
de comando ``ARIA2_STATIC=yes``::
|
||||
|
||||
$ ./configure ARIA2_STATIC=yes
|
||||
|
||||
Após a configuração feita, execute ``make`` para compilar o programa::
|
||||
|
||||
$ make
|
||||
|
||||
Ver `Compilação Cross Windows binário`_ para Criar Binário para
|
||||
Windows. Ver `Compilação Cross Android binário`_ para criar
|
||||
Binário para Android.
|
||||
O script configure verifica as bibliotecas
|
||||
disponíveis e habilita
|
||||
ou desabilita as funcionalidades na maior abrangência possivel, pois
|
||||
por padrão todas as funcionalidades são habilitadas. Desde a versão
|
||||
1.1.0, aria2 verifica o certificado do servidor HTTPS como padrão.
|
||||
Se a compilação usou OpenSSL ou a recente versão de GnuTLS na qual há
|
||||
função ``gnutls_certificate_set_x509_system_trust()`` e a biblioteca
|
||||
foi adequadamente configurada para localizar o certificado CA
|
||||
armazenado, aria2 carrega automaticamente estes certificados no início.
|
||||
Se este não ocorrer, recomenda-se fornecer o caminho para o arquivo que
|
||||
contém o certificado. Por Exemplo, no Debian o caminho para o arquivo CA
|
||||
é "/etc/ssl/certs/ca-certificates.crt" (no pacote ca-certificates).
|
||||
Isto varia de acordo com sua distribuição Linux. Pode ser informada a opção
|
||||
``--with-ca-bundle`` para configurar o script usado pelo make::
|
||||
|
||||
$ ./configure --with-ca-bundle='/etc/ssl/certs/ca-certificates.crt'
|
||||
$ make
|
||||
|
||||
Sem a opção ``--with-ca-bundle``, haverá um erro ao acessar servidores
|
||||
HTTPS pois o certificado não pode ser verificado sem possuir um pacote CA
|
||||
(entidade certificadora). Nesse caso, pode ser especificado um arquivo de
|
||||
certificado usando opção aria2's ``--ca-certificate``. Caso não haja um
|
||||
certificado instalado, então o último recurso é desabilitar a validação
|
||||
do certificado usando a opção ``--check-certificate=false``.
|
||||
|
||||
Por padrão, arquivo chamado (bash_completion) ``aria2c`` é instalado no
|
||||
diretório ``$prefix/share/doc/aria2/bash_completion``. Para mudar o
|
||||
diretório de instalação do arquivo utilize a opção
|
||||
``--with-bashcompletiondir``.
|
||||
|
||||
O executavel é 'aria2c' no diretório src.
|
||||
|
||||
aria2 usa CppUnit para (test unit) automatizado. Para executar o
|
||||
test unit emita o comando::
|
||||
|
||||
$ make check
|
||||
|
||||
Compilação Cross Windows binário
|
||||
--------------------------------
|
||||
|
||||
Nessa seção, está descrito como fazer o build do binário para Windows
|
||||
usando o compilador cross mingw-w64 no Debian Linux.
|
||||
|
||||
Basicamente, após compilar e instalar as bibliotecas dependentes, que
|
||||
são pré-requisitos pode ser feita a compilação cross apenas passando
|
||||
através da opção ``--host`` e especificando-se as variáveis
|
||||
``CPPFLAGS``, ``LDFLAGS`` e ``PKG_CONFIG_LIBDIR`` que serão usadas
|
||||
no procedimento (configure). Para maior conveniência e menor custo
|
||||
de desenvolvimento, é fornecida uma maneira fácil de configurar as
|
||||
características do build / compilação.
|
||||
|
||||
O script ``mingw-config`` é um ``(wrapper)`` para mingw-w64.
|
||||
Sua utilização é para gerar uma compilação oficial para Windows. Esse
|
||||
script assume que as seguintes bibliotecas tenham sido compiladas
|
||||
e/ou instaladas para a compilação cross:
|
||||
|
||||
* c-ares
|
||||
* openssl
|
||||
* expat
|
||||
* sqlite3
|
||||
* zlib
|
||||
* cppunit
|
||||
|
||||
Algumas variáveis de ambiente precisam ser ajustadas para compilar:
|
||||
|
||||
``HOST``
|
||||
compilação-cross para compilar programas que serão executados em
|
||||
um computador ``HOST``. Padrão para ``i686-w64-mingw32``.
|
||||
Para compilar binário para 64bits, especificar ``x86_64-w64-mingw32``.
|
||||
|
||||
``PREFIX``
|
||||
Prefixo do diretório onde as bibliotecas dependentes estão instaladas.
|
||||
Padrão para ``/usr/local/$HOST``. ``-I$PREFIX/include`` será adicionado
|
||||
às opções ``CPPFLAGS``. ``-L$PREFIX/lib`` será adicionado em
|
||||
``LDFLAGS``. ``$PREFIX/lib/pkgconfig`` será configurado para
|
||||
``PKG_CONFIG_LIBDIR``.
|
||||
|
||||
Por exemplo, para construir um binário para 64bits utilize::
|
||||
|
||||
$ HOST=x86_64-w64-mingw32 ./mingw-config
|
||||
|
||||
Compilação Cross Android binário
|
||||
--------------------------------
|
||||
|
||||
Nessa seção, descrevemos como construir um binário usando o compilador-cross
|
||||
NDD no Linux Debian.
|
||||
|
||||
``android-config`` é um script para configurar compilação para Android, o qual
|
||||
assume que as seguintes bibliotecas também foram construídas para
|
||||
compilador-cross:
|
||||
|
||||
* c-ares
|
||||
* openssl
|
||||
* expat
|
||||
|
||||
Quando compilando as bibliotecas, certifique-se que o compartilhamento (share)
|
||||
esteja desabilitado e confirme que somente biblioteca estática está habilitado.
|
||||
A compilação será feita somente com bibliotecas estáticas.
|
||||
|
||||
A bibliteca zlib que vem com o Android NDK, portanto não é necessário
|
||||
compilar uma zlib nossa.
|
||||
|
||||
``android-config`` assume os seguintes pontos:
|
||||
|
||||
* Android NDK está instalado no local definido pela variável de ambiente
|
||||
``$ANDROID_HOME``. Consultar seção "3/ Chamando o compilador (jeito fácil):"
|
||||
no Android NDK
|
||||
``docs/STANDALONE-TOOLCHAIN.html`` para instalar (toolchain) personalizada.
|
||||
* Bibliotecas dependentes devem estar instaladas em
|
||||
``$ANDROID_HOME/usr/local``.
|
||||
|
||||
Antes executar ``android-config`` e ``android-make``, a variável de ambiente
|
||||
``$ANDOIRD_HOME`` deve apontar para o caminho correto.
|
||||
|
||||
Após ``android-config``, executar ``android-make`` para compilar os fontes.
|
||||
|
||||
Para Gerar a documentação
|
||||
-------------------------
|
||||
|
||||
`Sphinx <http://sphinx.pocoo.org/>`_ é usado para construir a
|
||||
documentação. As páginas (man) da documentação são criadas se através do
|
||||
comando ``make`` caso estas páginas estejam desatualizadas. Tambem
|
||||
pode ser construida a versão em HTML da documentação do aria2 através
|
||||
do comando ``make html``. A versão HTML também está disponível em:
|
||||
`Original em Inglês <http://aria2.sourceforge.net/manual/en/html/>`_
|
||||
e nas traduções em:
|
||||
(`Português <http://aria2.sourceforge.net/manual/pt/html/>`_ e
|
||||
`Russo <http://aria2.sourceforge.net/manual/ru/html/>`_).
|
||||
|
||||
BitTorrrent
|
||||
-----------
|
||||
|
||||
Sobre Nome de arquivos
|
||||
~~~~~~~~~~~~~~~~~~~~~~
|
||||
O nome do arquivo que será baixado é determinado da seguinte maneira:
|
||||
|
||||
modo arquivo simples
|
||||
O a chave "name" está presento no arquivo .torrent, o nome do
|
||||
arquivo será o valor da chave "name". De outra maneira o nome
|
||||
do arquivo será baseado no arquivo .torrent mais o sufixo
|
||||
".file". Exemplo: arquivo .torrent é "brasil.torrrent", então
|
||||
o nome do arquivo baixado será: "brasil.torrent.file". O
|
||||
diretório onde será armazenado o arquivo pode ser especificado
|
||||
através da opção -d.
|
||||
|
||||
modo arquivos múltiplos
|
||||
A estrutura completa diretório/arquivo mencionada no arquivo .torrent será
|
||||
creada. O diretório base que conterá toda estrutura de diretórios e arquivos
|
||||
baixados, pode ser especificado através da opção -d.
|
||||
Antes do download iniciar a estrutura completa dos diretórios necessários
|
||||
ao download será criada. Por padrão aria2 abre no mínimo 100 arquivos
|
||||
mencionados no arquivo .torrent e diretamente executa gravação e leitura desses
|
||||
arquivos. O número máximo de arquivos para serem abertos simultaneamente pode
|
||||
ser controlado através da opção ``--bt-max-open-files``.
|
||||
|
||||
DHT
|
||||
~~~
|
||||
|
||||
aria2 suporte DHT. Por padrão, a tabela de roteamento
|
||||
para IPv4 DHT é salva em ``$HOME/.aria2/dht.dat`` e a tabela de
|
||||
roteamento para IPv6 DHT é salva em ``$HOME/.aria2/dht6.dat``.
|
||||
aria2 utiliza o mesmo número de porta para ouvir ambos
|
||||
IPv4 e IPv6 DHT.
|
||||
|
||||
Outras informações importantes
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
* Se a opção -o é usada para mudar o nome do arquivo de saida
|
||||
.torrent não o nome do arquivo dentro do arquivo .torrent.
|
||||
Para esta finalidade utilizar opção ``--index-out``.
|
||||
* Os números de portas padrões que o aria2 utiliza para TCP e UDP
|
||||
estão no intervalo de 6881 até 6999 (6881-6999).
|
||||
* aria2 não configura automaticamente port-forwarding.
|
||||
Por favor configurar manualmente seu roteador ou firewall.
|
||||
* O número máximo de é 55. Este limite pode ser excedido quando
|
||||
a taxa de download é muito baixa. Esta taxa de download pode ser
|
||||
ajustada com a opção ``--bt-request-peer-speed-limit``.
|
||||
* Desde a versão 0.10.0, aria2 parou de enviar mensagem de
|
||||
requisição após o download seletivo completar-se.
|
||||
|
||||
|
||||
Metalink
|
||||
--------
|
||||
|
||||
A implementação atual suporte HTTP, HTTPS, FTP e BitTorrent. Outros
|
||||
protocolos P2P são ignorados. São suportados documentos das versões
|
||||
Metalink4 e Metalink 3.0.
|
||||
|
||||
Para validação de (checksum) são suportados: md5, sha-1, sha-224,
|
||||
sha-256, sha-384 e sha-512. Se múltiplos algoritmos de hast
|
||||
são fornecidos aria2 utiliza o mais robusto. Se a validação do
|
||||
checksum falhar totalmente aria2 não tentará mais fazer download e
|
||||
terminará o processamento com código de retorno diferente de zero.
|
||||
|
||||
As preferências de usuário suportadas são versão, idioma, local,
|
||||
protocolo e sistema operacional.
|
||||
|
||||
Se verificação (checksum) de (chunk) são fornecidas em um arquivo
|
||||
Metalink, aria2 automaticamente valida (chunk) partes dos dados
|
||||
durante o download. Esse comportamente pode ser desligado através
|
||||
de opção da linha de comando.
|
||||
|
||||
Se uma assinatura (certificado) é incluida em um arquivo Metalink,
|
||||
aria2 salva a assinatura como um arquivo após a conclusão do download.
|
||||
O nome do arquivo terá o sufixo ".sig". Caso já exista não será salvo.
|
||||
|
||||
Em torrent de múltiplos arquivos Metalink4, podem aparecer no elemento
|
||||
metalink:metaurl. Uma vez que aria2 não faz download de 2 Torrents
|
||||
iguais ao mesmo tempo, aria2 agrupa arquivos em elementos metalink:file
|
||||
os quais tem o mesmo metaurl BitTorrent e serão baixados de um
|
||||
simples BitTorrent (swarm).
|
||||
Isto basicamente ocorre para download de multiplos arquivos Torrent quando
|
||||
há seleção de arquivo(s), portanto arquivos adjacentes que não estão
|
||||
no documento Metalink mas que compartilham a mesma (peça ou pedaço)
|
||||
do arquivo selecionado também serão baixados e criados.
|
||||
|
||||
Se uma URI relativa é especificada em um elemento metalink:url ou
|
||||
metalink:metaurl, aria2 usa a URI do arquivo Metalink como URI base
|
||||
para resolver a URI relativa. Se a URI relativa encontra-se em um
|
||||
arquivo Metalink que é lido do disco local, aria2 usa o valor da
|
||||
opção ``--metalink-base-uri`` como URI base. Se essa opção não é
|
||||
especificada a URI relativa será ignorada.
|
||||
|
||||
Metalink/HTTP
|
||||
-------------
|
||||
|
||||
Esta versão utiliza links rel=duplicate. aria2 interpreta
|
||||
os campos do cabeçalho do Digest e verifica onde o valor do digest
|
||||
confere com outras fontes. Se houver diferença, derruba a conexão.
|
||||
aria2 também utiliza esse valor do digest para executar verificação do
|
||||
checksum após o download terminar. aria2 reconhece valor geo.
|
||||
Para sobrepor o valor de sua preferência utilize a opção
|
||||
``--metalink-location``.
|
||||
|
||||
netrc
|
||||
-----
|
||||
O suporte netrc é habilitado por padrão para HTTP, HTTPS e FTP. Para desabilitar
|
||||
especificar opção -n na linha de comando. Seu arquivo .netrc precisa possuir
|
||||
permissões corretas (600).
|
||||
|
||||
WebSocket
|
||||
---------
|
||||
|
||||
O servidor WebSocket intrínseco no aria2 implementa a especificação
|
||||
definida na RFC 6455. O protocolo suportado refere-se a versão 13.
|
||||
|
||||
Referências
|
||||
-----------
|
||||
|
||||
* `aria2 Manual Inglês <http://aria2.sourceforge.net/manual/en/html/>`_ versão inglês
|
||||
* `aria2 Manual Russo <http://aria2.sourceforge.net/manual/ru/html/>`_ versão russo
|
||||
* `aria2 Manual Português <http://aria2.sourceforce.net/manual/pt/html/>`_ versão portugues
|
||||
* http://aria2.sourceforge.net/
|
||||
* http://sourceforge.net/apps/trac/aria2/wiki
|
||||
* https://github.com/tatsuhiro-t/aria2
|
||||
* `RFC 959 FILE TRANSFER PROTOCOL (FTP) <http://tools.ietf.org/html/rfc959>`_
|
||||
* `RFC 1738 Uniform Resource Locators (URL) <http://tools.ietf.org/html/rfc1738>`_
|
||||
* `RFC 2428 FTP Extensions for IPv6 and NATs <http://tools.ietf.org/html/rfc2428>`_
|
||||
* `RFC 2616 Hypertext Transfer Protocol -- HTTP/1.1 <http://tools.ietf.org/html/rfc2616>`_
|
||||
* `RFC 3659 Extensions to FTP <http://tools.ietf.org/html/rfc3659>`_
|
||||
* `RFC 3986 Uniform Resource Identifier (URI): Generic Syntax <http://tools.ietf.org/html/rfc3986>`_
|
||||
* `RFC 4038 Application Aspects of IPv6 Transition <http://tools.ietf.org/html/rfc4038>`_
|
||||
* `RFC 5854 The Metalink Download Description Format <http://tools.ietf.org/html/rfc5854>`_
|
||||
* `RFC 6249 Metalink/HTTP: Mirrors and Hashes <http://tools.ietf.org/html/rfc6249>`_
|
||||
* `RFC 6265 HTTP State Management Mechanism <http://tools.ietf.org/html/rfc6265>`_
|
||||
* `RFC 6455 The WebSocket Protocol <http://tools.ietf.org/html/rfc6455>`_
|
||||
|
||||
* `The BitTorrent Protocol Specification <http://www.bittorrent.org/beps/bep_0003.html>`_
|
||||
* `BitTorrent: DHT Protocol <http://www.bittorrent.org/beps/bep_0005.html>`_
|
||||
* `BitTorrent: Fast Extension <http://www.bittorrent.org/beps/bep_0006.html>`_
|
||||
* `BitTorrent: IPv6 Tracker Extension <http://www.bittorrent.org/beps/bep_0007.html>`_
|
||||
* `BitTorrent: Extension for Peers to Send Metadata Files <http://www.bittorrent.org/beps/bep_0009.html>`_
|
||||
* `BitTorrent: Extension Protocol <http://www.bittorrent.org/beps/bep_0010.html>`_
|
||||
* `BitTorrent: Multitracker Metadata Extension <http://www.bittorrent.org/beps/bep_0012.html>`_
|
||||
* `BitTorrent: WebSeed - HTTP/FTP Seeding (GetRight style) <http://www.bittorrent.org/beps/bep_0019.html>`_
|
||||
* `BitTorrent: Private Torrents <http://www.bittorrent.org/beps/bep_0027.html>`_
|
||||
* `BitTorrent: BitTorrent DHT Extensions for IPv6 <http://www.bittorrent.org/beps/bep_0032.html>`_
|
||||
* `BitTorrent: Message Stream Encryption <http://wiki.vuze.com/w/Message_Stream_Encryption>`_
|
||||
* `Kademlia: A Peer-to-peer Information System Based on the XOR Metric <http://pdos.csail.mit.edu/~petar/papers/maymounkov-kademlia-lncs.pdf>`_
|
||||
|
||||
versão atualizada em 26.novembro.2012 por gsavix@gmail.com
|
||||
|
|
@ -0,0 +1,9 @@
|
|||
@import url(http://fonts.googleapis.com/css?family=Roboto:400,400italic,500,500italic);
|
||||
|
||||
pre, tt {
|
||||
font-family: monospace, sans-serif;
|
||||
}
|
||||
|
||||
tt {
|
||||
font-size: 100%;
|
||||
}
|
||||
File diff suppressed because it is too large
Load Diff
|
|
@ -0,0 +1,219 @@
|
|||
# -*- coding: utf-8 -*-
|
||||
#
|
||||
# aria2 documentation build configuration file, created by
|
||||
# sphinx-quickstart on Tue Apr 10 21:34:06 2012.
|
||||
#
|
||||
# This file is execfile()d with the current directory set to its containing dir.
|
||||
#
|
||||
# Note that not all possible configuration values are present in this
|
||||
# autogenerated file.
|
||||
#
|
||||
# All configuration values have a default; values that are commented out
|
||||
# serve to show the default.
|
||||
|
||||
import sys, os
|
||||
|
||||
# If extensions (or modules to document with autodoc) are in another directory,
|
||||
# add these directories to sys.path here. If the directory is relative to the
|
||||
# documentation root, use os.path.abspath to make it absolute, like shown here.
|
||||
#sys.path.insert(0, os.path.abspath('.'))
|
||||
|
||||
# -- General configuration -----------------------------------------------------
|
||||
|
||||
# If your documentation needs a minimal Sphinx version, state it here.
|
||||
#needs_sphinx = '1.0'
|
||||
|
||||
# Add any Sphinx extension module names here, as strings. They can be extensions
|
||||
# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
|
||||
extensions = []
|
||||
|
||||
# Add any paths that contain templates here, relative to this directory.
|
||||
templates_path = ['_templates']
|
||||
|
||||
# The suffix of source filenames.
|
||||
source_suffix = '.rst'
|
||||
|
||||
# The encoding of source files.
|
||||
source_encoding = 'utf-8'
|
||||
|
||||
# The master toctree document.
|
||||
master_doc = 'index'
|
||||
|
||||
# General information about the project.
|
||||
project = u'aria2'
|
||||
# copyright = u'2012, Tatsuhiro Tsujikawa'
|
||||
|
||||
# The version info for the project you're documenting, acts as replacement for
|
||||
# |version| and |release|, also used in various other places throughout the
|
||||
# built documents.
|
||||
#
|
||||
# The short X.Y version.
|
||||
version = '1.15.2'
|
||||
# The full version, including alpha/beta/rc tags.
|
||||
release = '1.15.2'
|
||||
|
||||
# The language for content autogenerated by Sphinx. Refer to documentation
|
||||
# for a list of supported languages.
|
||||
language = 'pt_BR'
|
||||
|
||||
# There are two options for replacing |today|: either, you set today to some
|
||||
# non-false value, then it is used:
|
||||
#today = ''
|
||||
# Else, today_fmt is used as the format for a strftime call.
|
||||
#today_fmt = '%B %d, %Y'
|
||||
|
||||
# List of patterns, relative to source directory, that match files and
|
||||
# directories to ignore when looking for source files.
|
||||
exclude_patterns = ['_build']
|
||||
|
||||
# The reST default role (used for this markup: `text`) to use for all documents.
|
||||
#default_role = None
|
||||
|
||||
# If true, '()' will be appended to :func: etc. cross-reference text.
|
||||
#add_function_parentheses = True
|
||||
|
||||
# If true, the current module name will be prepended to all description
|
||||
# unit titles (such as .. function::).
|
||||
#add_module_names = True
|
||||
|
||||
# If true, sectionauthor and moduleauthor directives will be shown in the
|
||||
# output. They are ignored by default.
|
||||
#show_authors = False
|
||||
|
||||
# The name of the Pygments (syntax highlighting) style to use.
|
||||
pygments_style = 'sphinx'
|
||||
|
||||
# A list of ignored prefixes for module index sorting.
|
||||
#modindex_common_prefix = []
|
||||
|
||||
|
||||
# -- Options for HTML output ---------------------------------------------------
|
||||
|
||||
# The theme to use for HTML and HTML Help pages. See the documentation for
|
||||
# a list of builtin themes.
|
||||
html_theme = 'default'
|
||||
|
||||
# Theme options are theme-specific and customize the look and feel of a theme
|
||||
# further. For a list of options available for each theme, see the
|
||||
# documentation.
|
||||
html_theme_options = {'bodyfont':'roboto, sans-serif',
|
||||
'headfont':'roboto, "Trebuchet MS", sans-serif'}
|
||||
|
||||
# Add any paths that contain custom themes here, relative to this directory.
|
||||
#html_theme_path = []
|
||||
|
||||
# The name for this set of Sphinx documents. If None, it defaults to
|
||||
# "<project> v<release> documentation".
|
||||
#html_title = None
|
||||
|
||||
# A shorter title for the navigation bar. Default is the same as html_title.
|
||||
html_short_title = u'Documentação aria2 em Português'
|
||||
|
||||
# The name of an image file (relative to this directory) to place at the top
|
||||
# of the sidebar.
|
||||
#html_logo = None
|
||||
|
||||
# The name of an image file (within the static path) to use as favicon of the
|
||||
# docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32
|
||||
# pixels large.
|
||||
#html_favicon = None
|
||||
|
||||
# Add any paths that contain custom static files (such as style sheets) here,
|
||||
# relative to this directory. They are copied after the builtin static files,
|
||||
# so a file named "default.css" will overwrite the builtin "default.css".
|
||||
html_static_path = ['_static']
|
||||
|
||||
# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
|
||||
# using the given strftime format.
|
||||
#html_last_updated_fmt = '%b %d, %Y'
|
||||
|
||||
# If true, SmartyPants will be used to convert quotes and dashes to
|
||||
# typographically correct entities.
|
||||
html_use_smartypants = False
|
||||
|
||||
# Custom sidebar templates, maps document names to template names.
|
||||
#html_sidebars = {}
|
||||
|
||||
# Additional templates that should be rendered to pages, maps page names to
|
||||
# template names.
|
||||
#html_additional_pages = {}
|
||||
|
||||
# If false, no module index is generated.
|
||||
#html_domain_indices = True
|
||||
|
||||
# If false, no index is generated.
|
||||
#html_use_index = True
|
||||
|
||||
# If true, the index is split into individual pages for each letter.
|
||||
#html_split_index = False
|
||||
|
||||
# If true, links to the reST sources are added to the pages.
|
||||
#html_show_sourcelink = True
|
||||
|
||||
# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
|
||||
#html_show_sphinx = True
|
||||
|
||||
# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
|
||||
html_show_copyright = False
|
||||
|
||||
# If true, an OpenSearch description file will be output, and all pages will
|
||||
# contain a <link> tag referring to it. The value of this option must be the
|
||||
# base URL from which the finished HTML is served.
|
||||
#html_use_opensearch = ''
|
||||
|
||||
# This is the file name suffix for HTML files (e.g. ".xhtml").
|
||||
#html_file_suffix = None
|
||||
|
||||
# Output file base name for HTML help builder.
|
||||
htmlhelp_basename = 'aria2doc'
|
||||
|
||||
|
||||
# -- Options for LaTeX output --------------------------------------------------
|
||||
|
||||
# The paper size ('letter' or 'a4').
|
||||
#latex_paper_size = 'letter'
|
||||
|
||||
# The font size ('10pt', '11pt' or '12pt').
|
||||
#latex_font_size = '10pt'
|
||||
|
||||
# Grouping the document tree into LaTeX files. List of tuples
|
||||
# (source start file, target name, title, author, documentclass [howto/manual]).
|
||||
latex_documents = [
|
||||
('index', 'aria2.tex', u'Documentação aria2 em Português',
|
||||
u'Tatsuhiro Tsujikawa', 'manual'),
|
||||
]
|
||||
|
||||
# The name of an image file (relative to this directory) to place at the top of
|
||||
# the title page.
|
||||
#latex_logo = None
|
||||
|
||||
# For "manual" documents, if this is true, then toplevel headings are parts,
|
||||
# not chapters.
|
||||
#latex_use_parts = False
|
||||
|
||||
# If true, show page references after internal links.
|
||||
#latex_show_pagerefs = False
|
||||
|
||||
# If true, show URL addresses after external links.
|
||||
#latex_show_urls = False
|
||||
|
||||
# Additional stuff for the LaTeX preamble.
|
||||
#latex_preamble = ''
|
||||
|
||||
# Documents to append as an appendix to all manuals.
|
||||
#latex_appendices = []
|
||||
|
||||
# If false, no module index is generated.
|
||||
#latex_domain_indices = True
|
||||
|
||||
|
||||
# -- Options for manual page output --------------------------------------------
|
||||
|
||||
# One entry per manual page. List of tuples
|
||||
# (source start file, name, description, authors, manual section).
|
||||
man_pages = [
|
||||
('aria2c', 'aria2c', u'Utilitário para download super ultra rápido', [], 1)
|
||||
]
|
||||
|
||||
def setup(app):
|
||||
app.add_stylesheet('default2.css')
|
||||
|
|
@ -0,0 +1,30 @@
|
|||
.. aria2 documentation master file, created by
|
||||
sphinx-quickstart on Tue Apr 10 21:34:06 2012.
|
||||
tradução para portugues do BRASIL
|
||||
gilberto dos santos alves gsavix@gmail.com
|
||||
novembro/2012
|
||||
|
||||
|
||||
O que é aria2
|
||||
=============
|
||||
|
||||
aria2 é um utilitário para download de arquivos, que utiliza protocolos HTTP,
|
||||
HTTPS, FTP, BitTorrent e Metalink. Pode efetuar download de 1 ou vários
|
||||
arquivos, a partir de 1 ou múltiplas fontes e protocolos com ou sem
|
||||
verificação de (checksum) integridade.
|
||||
|
||||
Também pode ser utilizado sem proxy, com proxy reverso ou com outras opções.
|
||||
|
||||
Há suporte para download de arquivos fragmentando-se o resultado em tamanhos
|
||||
pré-determinados ou através da utilização de algoritmos que permitem
|
||||
assistir um filme ou ouvir a música enquanto o download está sendo feito.
|
||||
|
||||
|
||||
Conteúdo:
|
||||
=========
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 2
|
||||
|
||||
aria2c
|
||||
README
|
||||
Loading…
Reference in New Issue