Provided by: apt_0.8.16~exp5ubuntu13_i386 bug

NAME

       apt-get - Utilitario de manuseamento de pacotes do APT -- interface de
       linha de comandos

SYNOPSIS

       apt-get [-sqdyfmubV] [-o= config_string ] [-c= config_file ]
               [-t= target_release] [-a= default_architecture] {update |
               upgrade | dselect-upgrade | dist-upgrade |
               install pkg [ { =pkg_version_number | /target_release } ] ...
               | remove pkg...  | purge pkg...  |
               source pkg [ { =pkg_version_number | /target_release } ] ...  |
               build-dep pkg...  | check | clean | autoclean | autoremove |
               {-v | --version} | {-h | --help}}

DESCRI,c~aO

       apt-get e a ferramenta de linha de comandos para lidar com pacotes, e
       pode ser considerada o "back-end" dos utilizadores para outras
       ferramentas que usam a biblioteca APT. Existem varias interfaces
       "front-end" como o dselect(1), aptitude(8), synaptic(8) e wajig(1).

       A menos que a opcao -h, ou --help seja fornecida, um dos comandos
       abaixo tem que estar presentes.

       update
           update e usado para re-sincronizar os ficheiros de indices de
           pacotes a partir das suas fontes. Os indices dos pacotes
           disponiveis sao obtidos a partir das localizacoes em
           /etc/apt/sources.list. Por exemplo, quando se usa um arquivo
           Debian, este comando recolhe e analisa os ficheiros Packages.gz
           para que a informacao sobre pacotes novos e actualizados fique
           disponivel. Um update deve ser sempre executado antes de um upgrade
           ou dist-upgrade. Por favor note que a medicao do processo total ira
           estar incorrecta pois o tamanho dos ficheiros de pacotes nao pode
           ser conhecido com antecedencia.

       upgrade
           upgrade e usado para instalar as versoes mais recentes de todos os
           pacotes presentemente instalados no sistema a partir das fontes
           enumeradas em /etc/apt/sources.list. Os pacotes presentemente
           instalados com versoes novas sao obtidos e instalados; em nenhumas
           circunstancias os pacotes presentemente instalados serao removidos,
           nem pacotes ja instalados serao obtidos e instalados.Os pacotes
           presentemente instalados com novas versoes e que nao possam ser
           actualizados sem alterarem o estado da instalacao de outro pacote
           serao deixados na versao presente. Deve ser executado primeiro um
           update para que o apt-get fique a saber que estao disponiveis novas
           versoes de pacotes.

       dselect-upgrade
           dselect-upgrade e usado em conjunto com o front-end de pacotes
           Debian tradicional, dselect(1).  dselect-upgrade segue as
           alteracoes feitas pelo dselect(1) ao campo Status dos pacotes
           disponiveis, e executa as accoes necessarias para realizar esse
           estado (por exemplo, a remocao de pacotes antigos e a instalacao de
           novos).

       dist-upgrade
           dist-upgrade adicionalmente a executar a funcao do upgrade, tambem
           lida inteligentemente com as alteracoes de dependencias com as
           novas versoes de pacotes; o apt-get tem um sistema de resolucao de
           conflitos 'inteligente', que ira tentar actualizar os pacotes mais
           importantes a custo dos pacotes menos importantes, caso necessario.
           Portanto, o comando dist-upgrade pode remover alguns pacotes. O
           ficheiro /etc/apt/sources.list contem uma lista de localizacoes de
           onde obter os ficheiros de pacotes desejados. Veja tambem
           apt_preferences(5) para um mecanismo para sobrepor as definicoes
           gerais em pacotes individuais.

       install
           install e seguido por um ou mais pacotes desejados para instalacao
           ou actualizacao. Cada pacote e um nome de pacote, nao um nome de
           ficheiro completamente qualificado (por exemplo, num sistema Debian
           GNU/Linux, libc6 seria o argumento fornecido e nao
           libc6_1.9.6-2.deb). Todos os pacotes necessarios pelos pacotes
           especificados para instalacao irao tambem ser obtidos e instalados.
           O ficheiro /etc/apt/sources.list e usado para localizar os pacotes
           desejados. Se for acrescentado um sinal menos (-) ao nome do pacote
           (sem nenhum espaco a separar), o pacote identificado ira ser
           removido se estiver instalado. A semelhanca, um sinal mais (+) pode
           ser usado para designar um pacote a instalar. Estas ultimas
           funcionalidades podem ser usadas para sobrepor decisoes feitas pelo
           sistema de resolucao de conflitos do apt-get.

           Pode ser seleccionada para instalacao uma versao especifica de um
           pacote ao continuar o nome do pacote com um igual (=) e a versao do
           pacote a seleccionar. Isto ira fazer com que essa versao seja
           localizada e seleccionada para instalacao. Alternativamente pode
           ser seleccionada uma distribuicao especifica ao continuar o nome do
           pacote com uma slash (/) e a versao da distribuicao ou o nome de
           Arquivo (stable, testing, unstable).

           Ambos os mecanismos de seleccao de versao podem regredir pacotes
           (downgrade) e devem ser usados com cuidado.

           Este e tambem o objectivo a usar se deseja actualizar um ou mais
           pacotes ja instalados sem actualizar todos os pacotes que tem no
           seu sistema. Ao contrario do objectivo "upgrade", o qual instala as
           versoes mais recentes de todos os pacotes presentemente instalados,
           o "install" ira instalar a versao mais recente apenas dos pacotes
           especificados. Simplesmente forneca o nome do(s) pacote(s) que
           deseja actualizar, e se estiver disponivel uma nova versao, ela ( e
           as suas dependencias, como descrito em cima) serao descarregadas e
           instaladas.

           Finalmente, o mecanismo apt_preferences(5) permite-lhe criar uma
           politica de instalacao alternativa para pacotes individuais.

           Se nenhum pacote coincidir com a expressao fornecida e a expressao
           conter um de '.', '?' ou '*' entao e assumido ser uma expressao
           regular POSIX, e e aplicada a todos os nomes de pacotes da base de
           dados. Quaisquer correspondencias sao entao instaladas (ou
           removidas). Note que a correspondencia e feita por substring,
           portanto 'lo.*' corresponde a 'how-lo' e 'lowest'. Se isto for
           indesejavel, ancore a expressao regular com a caractere '^' ou '$',
           para criar uma expressao regular mais especifica.

       remove
           remove e identico a install a excepcao que os pacotes sao removidos
           em vez de instalados. Note que remover um pacote deixa os seus
           ficheiros de configuracao no sistema. Se um sinal mais (+) for
           acrescentado ao nome do pacote (sem nenhum espaco a separar), o
           pacote identificado sera instalado em vez de removido.

       purge
           purge e identico ao remove com a excepcao que os pacotes sao
           removidos e purgados (quaisquer ficheiros de configuracao sao
           tambem apagados).

       source
           source faz com que o apt-get procure pacotes fonte. O APT ira
           examinar os pacotes disponiveis para decidir qual pacote fonte
           obter. Ira entao encontrar e descarregar para o directorio actual a
           versao disponivel mais recente desse pacote fonte enquanto respeita
           o lancamento predefinido, definido com a opcao
           APT::Default-Release, a opcao -t ou por pacote com a sintaxe
           pkg/release, se possivel.

           Os pacotes fonte sao acompanhados em separado dos pacotes binarios
           via linha do tipo deb-src no ficheiro sources.list(5). Isto quer
           dizer que voce precisa de adicionar tal linha para cada repositorio
           de onde deseja obter fontes. Se voce nao fizer isto, ira
           provavelmente obter outra versao de fonte (mais recente, antiga ou
           nenhuma) que aquela que tem instalada ou pode instalar.

           If the --compile option is specified then the package will be
           compiled to a binary .deb using dpkg-buildpackage for the
           architecture as defined by the --host-architecture option. If
           --download-only is specified then the source package will not be
           unpacked.

           Uma versao fonte especifica pode ser obtida ao pos-fixar o nome da
           fonte com um igual (=) e depois a versao a procurar, semelhante ao
           mecanismo usado para os ficheiros de pacotes. Isto activa a
           correspondencia exacta do pacote fonte, nome e versao, activando
           implicitamente a opcao APT::Get::Only-Source.

           Note que os pacotes fonte nao sao acompanhados como pacotes
           binarios, eles existem apenas no directorio actual e sao
           semelhantes a descarga de tar balls fonte.

       build-dep
           build-dep causes apt-get to install/remove packages in an attempt
           to satisfy the build dependencies for a source package. By default
           the dependencies are satisfied to build the package nativly. If
           desired a host-architecture can be specified with the
           --host-architecture option instead.

       check
           check e uma ferramenta de diagnostico; actualiza a cache de pacotes
           e verifica por dependencias quebradas.

       download
           download will download the given binary package into the current
           directory.

       clean
           clean limpa o repositorio local dos ficheiros de pacotes obtidos.
           Remove tudo excepto o ficheiro lock de /var/cache/apt/archives/ e
           /var/cache/apt/archives/partial/. Quando o APT e usado com um
           metodo dselect(1), clean e executado automaticamente. Aqueles que
           nao usam o dselect irao provavelmente querer executar apt-get clean
           de tempos a tempos para libertar espaco do disco.

       autoclean
           Tal como o clean, autoclean limpa o repositorio local de ficheiros
           de pacotes obtidos. A diferenca e que apenas remove ficheiros de
           pacotes que ja nao podem ser mais descarregados, e sao na maioria
           dos casos inuteis. Isto permite a manutencao de uma cache durante
           um longo periodo sem que ela cresca descontroladamente. A opcao de
           configuracao APT::Clean-Installed ira prevenir que pacotes
           instalados sejam apagados se estiver definida para 'off'.

       autoremove
           autoremove e usado para remover pacotes que foram instalados
           automaticamente para satisfazer dependencias de algum pacote e que
           ja nao sao necessarios.

       changelog
           changelog downloads a package changelog and displays it through
           sensible-pager. The server name and base directory is defined in
           the APT::Changelogs::Server variable (e. g.
           http://packages.debian.org/changelogs for Debian or
           http://changelogs.ubuntu.com/changelogs for Ubuntu). By default it
           displays the changelog for the version that is installed. However,
           you can specify the same options as for the install command.

OP,c~oES

       Todas as opcoes de linha de comandos podem ser definidas usando o
       ficheiro de configuracao, as descricoes indicam a opcao de configuracao
       a definir. Para opcoes booleanas voce pode sobre por o ficheiro de
       configuracao usando algo como -f-,--no-f, -f=no ou varias outras
       variantes.

       --no-install-recommends
           Nao considera pacotes recomendados como dependencias para
           instalacao. Item de Configuracao: APT::Install-Recommends.

       --install-suggests
           Consider suggested packages as a dependency for installing.
           Configuration Item: APT::Install-Suggests.

       -d, --download-only
           Apenas descarrega; os ficheiros pacotes sao apenas obtidos, nao sao
           desempacotados nem instalados. Item de Configuracao:
           APT::Get::Download-Only.

       -f, --fix-broken
           Corrige; tenta corrigir um sistema com dependencias quebradas no
           lugar. Esta opcao, quando usada com install/remove, pode omitir
           quaisquer pacotes para permitir ao APT deduzir uma solucao
           provavel. Se forem especificados pacotes, este tem de corrigir
           completamente o problema. A opcao e por vezes necessaria quando se
           corre o APT pela primeira vez. O proprio APT nao permite que
           existam num sistema dependencias de pacotes quebradas. E possivel
           que uma estrutura de dependencias de um sistema esteja tao
           corrompida ao ponto de requerer intervencao manual (o que
           normalmente significa usar o dselect(1) ou dpkg --remove para
           eliminar alguns dos pacotes ofensivos). O uso desta opcao
           juntamente com -m pode produzir um erro em algumas situacoes. Item
           de Configuracao: APT::Get::Fix-Broken.

       -m, --ignore-missing, --fix-missing
           Ignora pacotes em falta; Se pacotes nao podem ser obtidos ou falham
           a verificacao de integridade apos obtencao (ficheiros de pacotes
           corrompidos), retem esses pacotes e manuseia o resultado. Usar esta
           opcao em conjunto com -f pode produzir erros em algumas situacoes.
           Se um pacote for seleccionado para instalacao (particularmente se
           for mencionado na linha de comandos) e nao pode ser descarregado
           estao sera retido em silencio. Item de Configuracao:
           APT::Get::Fix-Missing.

       --no-download
           Desactiva a descarga de pacotes. Isto e melhor ser usado com
           --ignore-missing para forcar o APT a usar os .debs que ja foram
           descarregados. Item de Configuracao: APT::Get::Download.

       -q, --quiet
           Silencioso; produz saida apropriada para registar em log, omitindo
           indicadores de progresso. Mais q's ira resultar em mais silencio
           ate o maximo de 2. Voce tambem pode usar -q=# para definir o nivel
           de silencio, sobrepondo o ficheiro de configuracao. Note que o
           silencio nivel 2 implica -y, voce nunca deve usar -qq sem um
           modificador de 'nenhuma accao' tal como -d, --print-uris ou -s pois
           o APT pode decidir fazer algo que voce nao esperava. Item de
           Configuracao: quiet.

       -s, --simulate, --just-print, --dry-run, --recon, --no-act
           Nenhuma accao; executa uma simulacao dos eventos que irao ocorrer
           mas na realidade nao altera o sistema. Item de Configuracao:
           APT::Get::Simulate.

           Uma simulacao corrida como utilizador ira automaticamente
           desactivar o bloqueio (Debug::NoLocking). Tambem sera mostrado um
           aviso indicando que e apenas uma simulacao, se a opcao
           APT::Get::Show-User-Simulation-Note estiver definida (a
           predefinicao e verdadeira). Nem o NoLocking nem o aviso serao
           activados se corrido como root (o root deve saber o que esta a
           fazer sem mais avisos do apt-get).

           A simulacao escreve uma serie de linhas cada uma representando uma
           operacao do dpkg, Configurar (Conf), Remover (Remv), Desempacotar
           (Inst). Parenteses rectos ([]) indicam pacotes quebrados e
           conjuntos de parenteses rectos vazios significam quebras que nao
           tem consequencia (raro).

       -y, --yes, --assume-yes
           Responde sim automaticamente aos avisos; assume "yes" como resposta
           a todos os avisos e corre nao-interactivamente. Se uma situacao
           indesejavel ocorrer, tal como alterar um pacote retido, tentar
           instalar um pacote nao autenticado ou remover um pacote essencial,
           entao o apt-get ira abortar. Item de Configuracao:
           APT::Get::Assume-Yes.

       --assume-no
           Automatic "no" to all prompts. Configuration Item:
           APT::Get::Assume-No.

       -u, --show-upgraded
           Mostra pacotes actualizados; Escreve uma lista de todos os pacotes
           que estao prestes a ser actualizados. Item de Configuracao:
           APT::Get::Show-Upgraded.

       -V, --verbose-versions
           Mostra as versoes completas para pacotes actualizados e instalados.
           Item de Configuracao: APT::Get::Show-Versions.

       -a, --host-architecture
           This option controls the architecture packages are built for by
           apt-get source --compile and how cross-builddependencies are
           satisfied. By default is not set which means that the host
           architecture is the same as the build architecture (which is
           defined by APT::Architecture) Configuration Item:
           APT::Get::Host-Architecture

       -b, --compile, --build
           Compila pacotes fonte apos os descarregar. Item de Configuracao:
           APT::Get::Compile.

       --ignore-hold
           Ignora pacotes retidos; Isto faz com que o apt-get ignore a
           retencao de um pacote. Isto pode ser util em conjunto com
           dist-upgrade para sobrepor um grande numero de retencoes nao
           desejadas. Item de Configuracao: APT::Ignore-Hold.

       --no-upgrade
           Nao actualiza pacotes; Quando usado em conjunto com install, o
           no-upgrade ira prevenir que pacotes sejam actualizados na linha de
           comandos se estes ja estiverem instalados. Item de Configuracao:
           APT::Get::Upgrade.

       --only-upgrade
           Nao instala pacotes novos; Quando usado em conjunto com install, o
           only-upgrade ira prevenir que pacotes sejam actualizados na linha
           de comandos se estes nao estiverem ja instalados. Item de
           Configuracao: APT::Get::Only-Upgrade.

       --force-yes
           Forca o sim; Esta e uma opcao perigosa que ira fazer com que o apt
           continue sem avisar quando esta a fazer algo potencialmente
           prejudicial. Nao deve ser usado excepto em situacoes muito
           especiais. Usar o force-yes pode destruir potencialmente o seu
           sistema! Item de Configuracao: APT::Get::force-yes.

       --print-uris
           Ao inves de ir buscar os ficheiros para instalar, escreve os seus
           URIs. Cada URI ira ter o caminho, o nome de ficheiro de destino, o
           tamanho e o hash md5 esperado. Note que o nome de ficheiro a
           escrever nem sempre ira condizer com o nome do ficheiro no site
           remoto! Isto tambem funciona com os comandos source e update.
           Quando usado com o comando update o MD5 e o tamanho nao sao
           incluidos, e cabe ao utilizador descomprimir quaisquer ficheiros
           comprimidos. Item de Configuracao: APT::Get::Print-URIs.

       --purge
           Usa purgar em vez de remocao para tudo o que seja removido. Um
           asterisco ("*") sera mostrado junto dos pacotes que estao agendados
           para serem purgados.  remove --purge e equivalente ao comando
           purge. Item de Configuracao: APT::Get::Purge.

       --reinstall
           Re-instala pacotes que ja estao instalados e na versao mais
           recente. Item de Configuracao: APT::Get::ReInstall.

       --list-cleanup
           A predefinicao desta opcao e ligada, use --no-list-cleanup para a
           desligar. Quando ligada o apt-get ira gerir automaticamente os
           conteudos de /var/lib/apt/lists para assegurar que os ficheiros
           obsoletos sao apagados. A unica razao para desligar isto e no caso
           de voce alterar frequentemente a sua lista de fontes. Item de
           Configuracao: APT::Get::List-Cleanup.

       -t, --target-release, --default-release
           Esta opcao controla a entrada predefinida para o motor de
           politicas, cria um pin predefinido na prioridade 990 usando a
           string de lancamento especificada. Isto sobrepoe as definicoes
           gerais em /etc/apt/preferences. Os pacotes com pin especifico nao
           sao afectados pelo valor desta opcao. Em resumo, esta opcao
           permite-lhe ter controlo simples sobre de qual distribuicao os
           pacotes serao obtidos. Alguns exemplos comuns podem ser -t '2.1*',
           -t unstable ou -t sid. Item de Configuracao: APT::Default-Release;
           veja tambem o manual apt_preferences(5).

       --trivial-only
           Apenas executa operacoes 'triviais'. Na logica isto pode ser
           considerado relacionado ao --assume-yes, onde --assume-yes ira
           responder 'sim' a todos os avisos, --trivial-only ira responder
           'nao'. Item de Configuracao: APT::Get::Trivial-Only.

       --no-remove
           Se quaisquer pacotes estiverem para ser removidos, o apt-get aborta
           imediatamente sem aviso. Item de Configuracao: APT::Get::Remove.

       --auto-remove
           Se o comando for install ou remove, entao esta opcao age como se
           corresse o comando autoremove, removendo os pacotes de dependencias
           nao utilizados. Item de Configuracao: APT::Get::AutomaticRemove.

       --only-source
           Apenas tem significado para os comandos source e build-dep. Indica
           que os nomes de fontes fornecidos nao sao para serem mapeados
           atraves da tabela de binarios. Isto quer dizer que se esta opcao
           for especificada, estes comandos apenas irao aceitar nomes de
           pacotes fonte como argumentos, em vez de aceitarem nomes de pacotes
           binarios e procurar o pacote fonte correspondente. Item de
           Configuracao: APT::Get::Only-Source.

       --diff-only, --dsc-only, --tar-only
           Descarrega apenas o ficheiro diff, dsc, ou tar de um pacote fonte.
           Item de Configuracao: APT::Get::Diff-Only, APT::Get::Dsc-Only, e
           APT::Get::Tar-Only.

       --arch-only
           Apenas processa dependencias de compilacao dependentes da
           arquitectura. Item de Configuracao: APT::Get::Arch-Only.

       --allow-unauthenticated
           Ignora se os pacotes nao podem ser autenticados e nao avisa sobre
           isso. Isto e util para ferramentas como o pbuilder. Item de
           Configuracao: APT::Get::AllowUnauthenticated.

       -h, --help
           Mostra um sumario curto da utilizacao.

       -v, --version
           Mostra a versao do programa.

       -c, --config-file
           Ficheiro de Configuracao; Especifica o ficheiro de configuracao a
           usar. O programa ira ler o ficheiro de configuracao predefinido e
           depois este ficheiro de configuracao. Se as definicoes de
           configuracao precisarem de ser definidas antes, os ficheiros de
           configuracao predefinidos sao analisados especificando um ficheiro
           com a variavel de ambiente APT_CONFIG. Veja apt.conf(5) para
           informacao de sintaxe.

       -o, --option
           Define uma Opcao de Configuracao; Isto ira definir uma opcao de
           configuracao arbitraria. A sintaxe e -o Foo::Bar=bar.  -o e
           --option podem ser usadas varias vezes para definir opcoes
           diferentes.

FICHEIROS

       /etc/apt/sources.list
           Localizacoes de onde obter pacotes. Item de Configuracao:
           Dir::Etc::SourceList.

       /etc/apt/sources.list.d/
           Ficheiros fragmentados para localizacoes de onde obter pacotes.
           Item de Configuracao: Dir::Etc::SourceParts.

       /etc/apt/apt.conf
           Ficheiro de configuracao do APT. Item de Configuracao:
           Dir::Etc::Main.

       /etc/apt/apt.conf.d/
           Ficheiros de configuracao fragmentados do APT. Item de
           Configuracao: Dir::Etc::Parts.

       /etc/apt/preferences
           Ficheiro de preferencias de versao. Isto e onde voce deve
           especificar "pinning", isto e, uma preferencia para obter certos
           pacotes A partir de uma fonte separada ou a partir duma versao
           diferente de uma distribuicao. Item de Configuracao:
           Dir::Etc::Preferences.

       /etc/apt/preferences.d/
           Ficheiros fragmentados para as preferencias de versao. Item de
           Configuracao: Dir::Etc::PreferencesParts.

       /var/cache/apt/archives/
           Area de armazenamento para ficheiros de pacotes obtidos. Item de
           Configuracao: Dir::Cache::Archives.

       /var/cache/apt/archives/partial/
           Area de armazenamento para ficheiros de pacotes em curso. Item de
           Configuracao: Dir::Cache::Archives (implicit partial).

       /var/lib/apt/lists/
           Area de armazenamento para informacao de estado para cada recurso
           de pacote especificado em sources.list(5) Tem de Configuracao:
           Dir::State::Lists.

       /var/lib/apt/lists/partial/
           Area de armazenamento para informacao de estado em transito. Item
           de Configuracao: Dir::State::Lists (parcial implicito).

VEJA TAMB'eM

       apt-cache(8), apt-cdrom(8), dpkg(1), dselect(1), sources.list(5),
       apt.conf(5), apt-config(8), apt-secure(8), O guia de utilizadores do
       The APT em /usr/share/doc/apt-doc/, apt_preferences(5), o Howto do APT.

DIAGN'oSTICO

       apt-get devolve zero na operacao normal, 100 decimal em erro.

AUTORES ORIGINAIS

       Jason Gunthorpe

AUTORES ACTUAIS

       APT team

       QA Page[3]

BUGS

       p'agina de bugs do APT[4]. Se deseja reportar um bug no APT, por favor
       veja /usr/share/doc/debian/bug-reporting.txt ou o comando reportbug(1).

TRADU,C~AO

       A traducao Portuguesa foi feita por Americo Monteiro
       a_monteiro@netcabo.pt em 2009, 2010. A traducao foi revista pela equipa
       de traducoes portuguesas da Debian traduz@debianpt.org.

       Note que este documento traduzido pode conter partes nao traduzidas.
       Isto e feito propositadamente, para evitar perdas de conteudo quando a
       traducao esta atrasada relativamente ao conteudo original.

AUTHORS

       Jason Gunthorpe

       APT team

NOTES

        1. http://packages.debian.org/changelogs

        2. http://changelogs.ubuntu.com/changelogs

        3. QA Page
           http://packages.qa.debian.org/a/apt.html

        4. pagina de bugs do APT
           http://bugs.debian.org/src:apt