APT-CACHE(8) APT APT-CACHE(8) NOME apt-cache - pesquisa a cache do APT SINOPSE apt-cache [-agipns] [-o=config_string] [-c=ficheiro_de_configuracao] {gencaches | showpkg pkg... | showsrc pkg... | stats | dump | dumpavail | unmet | search regex... | show pkg [{=numero_de_versao_do_pacote | /lancamento-alvo}]... | depends pkg [{=numero_de_versao_do_pacote | /lancamento-alvo}]... | rdepends pkg [{=numero_de_versao_do_pacote | /lancamento-alvo}]... | pkgnames [prefixo] | dotty pkg [{=numero_de_versao_do_pacote | /lancamento-alvo}]... | xvcg pkg [{=numero_de_versao_do_pacote | /lancamento-alvo}]... | policy [pkg...] | madison pkg... | {-v | --version} | {-h | --help}} DESCRICAO 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. Os metadados sao adquiridos e actualizados via comando 'update' de, por exemplo, apt-get, portanto podem estar desatualizados se a ultima actualizacao aconteceu a muito tempo, mas em troca o apt-cache funciona independentemente da disponibilidade das fontes configuradas (por exemplo em offline). A menos que a opcao -h, ou --help seja fornecida, um dos comandos abaixo tem que estar presentes. gencaches gencaches cria a cache de pacotes do APT. Isto e feito implicitamente por todos os comandos que precisam desta cache se esta estiver em falta ou desatualizada. showpkg pkg... 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 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, "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, "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. Se for acedida a mais do que uma distribuicao (por exemplo "stable" e "unstable"), 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 pkg... 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 pacote binario. Use --only-source para mostrar apenas nomes de pacotes fonte. 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 pkg... show executa uma funcao semelhante ao dpkg --print-avail; mostra os registos do pacote para os pacotes nomeados. search 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 dos pacotes fornecidos. Podem ser usados argumentos separados para especificar multiplos padroes de busca os quais sao lidados em conjunto. depends pkg... depends mostra uma listagem de cada dependencia que um pacote tem e todos os outros pacotes possiveis que podem satisfazer essa dependencia. rdepends pkg... 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 pkg... 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, pacotes virtuais puros sao triangulos, pacotes virtuais de mistura sao diamantes, pacotes desaparecidos sao hexagonos. Caixas cor de laranja significam 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 pkg... O mesmo que dotty, apenas para xvcg a partir de Ferramenta VCG[2]. policy [pkg...] 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 pkg... 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). OPCOES 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 Seleciona 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 Seleciona 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 Por predefinicao o depends and rdepends escrevem todas as dependencias. Isto pode ser "afinado" com estas bandeiras que irao omitir o tipo de dependencia especificado. Item de Configuracao: APT::Cache::ShowDependencyType ex. APT::Cache::ShowRecommends. --implicit Por predefinicao depends e rdepends apresentam apenas dependencias expressamente explicitas nos meta-dados. Com esta bandeira ira tambem mostrar dependencias adicionadas implicitamente com base nos dados encontrados. Um Conflicts: foo por exemplo, expressa implicitamente que este pacote tambem entra em conflito com o pacote foo de qualquer outra arquitectura. Item de Configuracao: APT::Cache::ShowImplicit. -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 selecionada 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 no pacote e nos nomes dos pacotes fornecidos, 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. --with-source nome_do_ficheiro Adiciona o ficheiro fornecido como a fonte para meta-dados. Pode ser repetido para adicionar multiplos ficheiros. Presentemente sao suportados ficheiros *.deb, *.dsc, *.changes, Sources e Packages assim como directorios de pacotes fonte: A correspondencia dos ficheiros e baseada apenas com base no seu nome, nao no seu conteudo. Sources e Packages podem ser comprimidos em qualquer formato suportado pelo apt desde de contenham a extensao correcta. Se voce precisar de armazenar varios ficheiros destes num directorio pode usar um prefixo no nome a sua escolha com um underscore no ultimo caractere ("_"). Exemplo: meu.exemplo_Packages.xz Note que estas fontes sao tratadas como de confianca (veja apt- secure(8)). Item de Configuracao: APT::Sources::With. -h, --help Mostra um sumario curto da utilizacao. -v, --version Mostra a versao do programa. --audit Show audit (and notice) messages. This overrides the quiet option, but only for notice messages, not progress ones. -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 Set a Configuration Option; This will set an arbitrary configuration option. The syntax is -o Foo::Bar=bar. -o and --option can be used multiple times to set different options. --no-color, --color Turn colors on or off. Colors are on by default on supported terminals for apt(8) and can also be disabled using the NO_COLOR or APT_NO_COLOR environment variables, or further configured by the APT::Color configuration option and scope, see apt.conf(5) for information on that. 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 sera implicitamente acrescentado (partial) VEJA TAMBEM apt.conf(5), sources.list(5), apt-get(8), apt-patterns(7) DIAGNOSTICO apt-cache devolve zero em operacao normal, 100 decimal em erro. BUGS pagina 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). TRADUCAO A traducao Portuguesa foi feita por Americo Monteiro de 2009 a 2012. A traducao foi revista pela equipa de traducoes portuguesas da Debian . 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. AUTORES Jason Gunthorpe Equipa do APT NOTAS 1. GraphViz https://graphviz.org/ 2. Ferramenta VCG https://www.rw.cdl.uni- saarland.de/people/sander/private/html/gsvcg1.html 3. pagina de bugs do APT https://bugs.debian.org/src:apt APT 2.9.6 14 Marco 2024 APT-CACHE(8)