Provided by: apt_0.8.16~exp5ubuntu13_i386 bug

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