Provided by:
apt_0.8.16~exp5ubuntu13_i386 
NAME
apt-cache - query the APT cache
SYNOPSIS
apt-cache [-hvsn] [-o=config string] [-c=file] {[gencaches] |
[showpkg pkg...] | [showsrc pkg...] | [stats] | [dump] |
[dumpavail] | [unmet] | [search regex] | [show pkg...] |
[depends pkg...] | [rdepends pkg...] | [pkgnames prefix] |
[dotty pkg...] | [xvcg pkg...] | [policy pkgs...] |
[madison pkgs...]}
DESCRI,c~aO
apt-cache executa uma variedade de operacoes na cache de pacotes do
APT. apt-cache nao manipula o estado do sistema mas fornece operacoes
para procurar e gerar resultados interessantes a partir dos metadados
do pacote.
A menos que a opcao -h, ou --help seja fornecida, um dos comandos
abaixo tem que estar presentes.
gencaches
gencaches executa a mesma operacao que o apt-get check. Constroi as
caches de fonte e pacote a partir das fontes em sources.list(5) e a
partir de /var/lib/dpkg/status.
showpkg pacote(s)
showpkg mostra informacao acerca dos pacotes listados na linha de
comandos. Os argumentos restantes sao nomes de pacotes. Sao
listadas as versoes disponiveis e dependencias reversas de cada
pacote listado, assim como as dependencias dianteiras de cada
versao. Dependencias dianteiras (normais) sao aqueles pacotes de
que o pacote em questao depende; dependencias reversas sao aqueles
pacotes que dependem do pacote em questao. Assim, as dependencias
dianteiras de um pacote tem de ser satisfeitas, mas as dependencias
reversas nao precisam de ser. Por exemplo, apt-cache showpkg
libreadline2 devera produzir resultados semelhantes ao seguinte:
Pacote: libreadline2
Versoes: 2.1-12(/var/state/apt/lists/foo_Packages),
Dependencias Reversas Depends:
libreadlineg2,libreadline2
libreadline2-altdev,libreadline2
Dependencias:
2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null))
Fornecimentos:
2.1-12 -
Fornecimentos Reversos:
Assim pode-se ver que libreadline2, versao 2.1-12, depende de libc5
e ncurses3.0 que tem que ser instalados para que libreadline2
funcione. Por sua vez, libreadlineg2 e libreadline2-altdev dependem
de libreadline2. Se libreadline2 for instalado, libc5 e ncurses3.0
(e ldso) tambem tem que ser instalados; libreadlineg2 e
libreadline2-altdev nao precisam de ser instalados. Para o
significado especifico do lembrete da saida e melhor consultar o
codigo fonte do apt.
stats
stats mostra algumas estatisticas acerca da cache. Nao sao
esperados mais argumentos. As estatisticas reportadas sao:
o Total package names e o numero de nomes de pacotes encontrados
na cache.
o Normal packages e o numero de nomes de pacotes regulares e
ordinarios; estes sao pacotes que tem uma correspondencia de
um-para-um entre os seus nomes e os nomes usados por outros
pacotes para eles nas dependencias. A maioria dos pacotes caem
nesta categoria.
o Pure virtual packages e o numero de pacotes que existem apenas
como nome de pacote virtual; isto e, os pacotes apenas
"disponibilizam" o nome do pacote virtual, e nenhum pacote usa
realmente o nome. Por exemplo, "mail-transport-agent" no
sistema Debian GNU/Linux e um pacote puramente virtual; varios
pacotes disponibilizam "mail-transport-agent", mas nao existe
um existe um pacote chamado "mail-transport-agent".
o Single virtual packages e o numero de pacotes com apenas um
pacote a disponibilizar um pacote virtual particular. Por
exemplo, no sistema Debian GNU/Linux, "X11-text-viewer" e um
pacote virtual, mas apenas um pacote, xless, disponibiliza
"X11-text-viewer".
o Mixed virtual packages e o numero de pacotes que ou
disponibilizam um pacote virtual particular ou tem o nome de
pacote virtual como o nome de pacote. Por exemplo, no sistema
Debian GNU/Linux, "debconf" e tanto um pacote real, como tambem
disponibilizado pelo pacote debconf-tiny.
o Missing e o numero de nomes de pacotes que sao referenciados
numa dependencia mas nao foram disponibilizados por nenhum
pacote. Os pacotes em falta podem ser uma evidencia de que nao
se esta a aceder ao total de uma distribuicao, ou que um pacote
(real ou virtual) foi removido da distribuicao. Normalmente sao
referenciados a partir de declaracoes de Conflitos ou Breaks.
o Total distinct versions e o numero de versoes de pacotes
encontrados na cache; este valor e portanto pelo menos igual ao
numero do total de nomes de pacotes. Se mais do que uma
distribuicao (ambas "stable" e "unstable", por exemplo) esta a
ser acedida, este valor pode ser consideravelmente maior que o
numero do total de nomes de pacotes.
o Total dependencies e o numero de relacionamentos com
dependencias reivindicadas por todos os pacotes na cache.
showsrc pacote(s)
showsrc mostra todos os registos de pacotes fonte que correspondem
aos nomes de pacotes fornecidos. Todas as versoes sao mostradas,
assim como todos os registos que declaram o nome como sendo um
Binario.
dump
dump mostra uma listagem curta de todos os pacotes na cache. E
principalmente para depuracao.
dumpavail
dumpavail escreve uma lista de disponibilidades no stdout. Isto e
apropriado para usar com o dpkg(1) e e usado pelo metodo
dselect(1).
unmet
unmet mostra um sumario de todas as dependencias insatisfeitas na
cache do pacote.
show pacote(s)
show executa uma funcao semelhante ao dpkg --print-avail; mostra os
registos do pacote para os pacotes nomeados.
search regex [ regex ... ]
search executa uma busca de texto completo em todas as listas de
pacotes disponiveis para o padrao POSIX regex fornecido, veja
regex(7). Procura nos nomes de pacotes e nas descricoes por uma
ocorrencia da expressao regular e escreve o nome do pacote e a
descricao curta, incluindo nomes de pacotes virtuais. Se for
fornecido --full entao sao produzidos resultados identicos ao show
para cada pacote correspondente, e se for fornecido --names-only
entao nao ha procura na descricao longa, apenas no nome do pacote.
Podem ser usados argumentos separados para especificar multiplos
padroes de busca os quais sao lidados em conjunto.
depends pacote(s)
depends mostra uma listagem de cada dependencia que um pacote tem e
todos os outros pacotes possiveis que podem satisfazer essa
dependencia.
rdepends pacote(s)
rdepends mostra uma listagem de cada dependencia reversa que um
pacote tem.
pkgnames [ prefixo ]
Este comando escreve o nome de cada pacote que o APT conhece. O
argumento opcional e um prefixo de correspondencia para filtrar a
lista de nomes. O resultado e apropriado para usar numa funcao
completa de consola e o resultado e gerado com extrema rapidez.
Este comando fica melhor usado com a opcao --generate.
Note que um pacote que o APT conheca nao esta necessariamente
disponivel para download, instalavel ou instalado, por exemplo, os
pacotes virtuais tambem sao listados na lista gerada.
dotty pacote(s)
dotty recebe uma lista de pacotes na linha de comandos e gera
resultados apropriados para uso pelo dotty do pacote GraphViz[1]. O
resultado sera um conjunto de nos e orlas que representam os
relacionamentos entre os pacotes. Por predefinicao, os pacotes
fornecidos irao seguir todos os pacotes dependentes; isto pode
produzir um grafico muito grande. Para limitar os resultados apenas
aos pacotes listados na linha de comandos, defina a opcao
APT::Cache::GivenOnly.
Os nos resultantes irao ter varias formas; pacotes normais sao
caixas, fornecimentos puros sao triangulos, fornecimentos mistos
sao diamantes, pacotes desaparecidos sao hexagonos. Caixas cor de
laranja significa que a recursao parou [pacotes leaf], linhas azuis
sao pre-dependencias, linhas verdes sao conflitos.
Atencao, o dotty nao consegue fazer graficos com grandes conjuntos
de pacotes.
xvcg pacote(s)
O mesmo que dotty, apenas para xvcg a partir de Ferramenta VCG[2].
policy [ pacote(s) ]
policy destina-se a ajudar a depurar problemas relacionados com o
ficheiro de preferencias. Sem argumentos ira escrever as
propriedades de cada fonte. Caso contrario escreve informacao
detalhada acerca da seleccao de prioridade do pacote nomeado.
madison [ pacote(s) ]
O comando madison do apt-cache tenta imitar o formato de saida e um
subconjunto das funcionalidades da ferramenta madison de gestao de
pacotes da Debian. Mostra versoes disponiveis de um pacote num
formato tabular. Ao contrario do madison original, apenas pode
mostrar informacao para a arquitectura que o APT recolheu listas de
pacotes (APT::Architecture).
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.
-p, --pkg-cache
Selecciona o ficheiro para armazenar a cache do pacote. A cache do
pacote e a cache principal usada por todas as operacoes. Item de
Configuracao: Dir::Cache::pkgcache.
-s, --src-cache
Selecciona o ficheiro para armazenar a cache de fonte. A fonte e
usada apenas pelo gencaches e armazena uma versao analisada da
informacao do pacote a partir de fontes remotas. Ao construir a
cache de pacote e usada a cache fonte para evitar reanalisar todos
os ficheiros do pacote. Item de Configuracao:
Dir::Cache::srcpkgcache.
-q, --quiet
Quiet; produz resultados apropriados para registar em logs,
omitindo os indicadores de progresso. Mais q's irao produzir mais
serenidade ate um maximo de 2. Voce tambem pode usar -q=# para
definir o nivel de serenidade, sobrepondo o ficheiro de
configuracao. Item de Configuracao: quiet.
-i, --important
Escreve apenas dependencias importantes; para usar com unmet e
depends. Separa apenas relacoes de Depends e Pre-Depends para serem
escritas. Item de Configuracao: APT::Cache::Important.
--no-pre-depends, --no-depends, --no-recommends, --no-suggests,
--no-conflicts, --no-breaks, --no-replaces, --no-enhances
Per default the depends and rdepends print all dependencies. This
can be tweaked with these flags which will omit the specified
dependency type. Configuration Item: APT::Cache::ShowDependencyType
e.g. APT::Cache::ShowRecommends.
-f, --full
Escreve registos de pacote completos quando procura. Item de
Configuracao: APT::Cache::ShowFull.
-a, --all-versions
Escreve registos completos para todas as versoes disponiveis. Isto
e a predefinicao; para a desligar, use --no-all-versions. Se
--no-all-versions for especificada, apenas a versao candidata sera
mostrada (aquela que seria seleccionada para instalacao). Esta
opcao e aplicavel apenas ao comando show. Item de Configuracao:
APT::Cache::AllVersions.
-g, --generate
Executa regeneracao automatica da cache de pacote, em vez de usar a
cache como esta. Isto e a predefinicao; para a desligar, use
--no-generate. Item de Configuracao: APT::Cache::Generate.
--names-only, -n
Apenas procura nos nomes dos pacotes, e nao nas descricoes longas.
Item de Configuracao: APT::Cache::NamesOnly.
--all-names
Faz com que o pkgnames escreva todos os nomes, incluindo pacotes
virtuais e dependencias em falta. Item de configuracao:
APT::Cache::AllNames.
--recurse
Torna depends e rdepends recursivo para que todos os pacotes
mencionados sejam escritos uma vez. Item de Configuracao
APT::Cache::RecurseDepends.
--installed
Limita a saida de depends e rdepends aos pacotes que estao
actualmente instalados. Item de Configuracao:
APT::Cache::Installed.
-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.
/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.conf(5), sources.list(5), apt-get(8)
DIAGN'oSTICO
apt-cache devolve zero em operacao normal, 100 decimal em erro.
BUGS
p'agina de bugs do APT[3]. 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. GraphViz
http://www.research.att.com/sw/tools/graphviz/
2. Ferramenta VCG
http://rw4.cs.uni-sb.de/users/sander/html/gsvcg1.html
3. pagina de bugs do APT
http://bugs.debian.org/src:apt