Provided by:
apt_0.8.16~exp12ubuntu10_i386 
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 natively. 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 is used to remove packages that were automatically
installed to satisfy dependencies for other packages and are now no
longer needed.
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 it 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