Equery/pt-br

é uma ferramenta para tornar algumas operações comuns do Portage mais simples. Junto de outras operações, ela pode exibir dependências de pacotes, metadata, e arquivos instalados.

Emerge
Equery é parte de um conjunto de ferramentas instalado com o pacote :

Para informações sobre a instalação do ou outras ferramentas visite o artigo Gentoolkit.

Introdução
é uma ferramenta que exibe informações úteis sobre os pacotes instalados no sistema. é baseado num sistema de módulos. Todo módulo tem um nome curto. Por exemplo, rodar é o mesmo que rodar. Invocando a opção   irá mostrar opções globais e listar todos os módulos disponíveis e seus nomes curtos. Adicionar o nome de um módulo ao final irá mostrar a tela de ajuda para este módulo específico. Por último, rodar fornecerá também uma explicação detalhada de todos os módulos e opções disponíveis junto de alguns exemplos úteis.

Abaixo está uma lista de funcionalidades que funcionam na maioria dos módulos.

Assim como o, não entende nomes parciais de pacotes:

Diferente do, aceita englobamento estilo shell no nome do pacote e/ou categoria:

A maioria dos módulos do equery tem múltipla saída:

Alguns módulos também permitem totalmente expressões regulares:

As próximas seções neste documento darão uma introdução rápida aos diferentes módulos do.

Capacidades
Para uma lista de todas as capacidades do equery, apenas rode o seguinte comando sem argumentos:

Aliases
Uma abordagem comum ao trabalhar com o é criar aliases. Ao usar o bash eles normalmente são colocados no arquivo :

Encontrando um pacote ao qual um arquivo pertence (b)
procura por arquivos correspondendo à uma expressão regular com a opção. A opção  para a busca ao encontrar um resultado correspondente. Como nenhum arquivo em seu sistema deve ser propriedade de dois pacotes, esta é uma otimização segura.

Uma versão encurtada de   também pode ser usada. Por exemplo, para listar a qual pacote pertence:

Visualizando entradas do ChangeLog com changes (c)
permite ao usuário visualizar entradas do ChangeLog para uma ou várias versões de um pacote. Imagine após rodar um, o Portage exibir uma mensagem dizendo que será atualizado. Para ver o que mudou este comando pode ser usado:

Verificando integridade de pacotes com check (k)
Por vezes é útil verificar a integridade dos pacotes. pode verificar MD5 bem como timestamps para indicar quando um pacote pode estar corrompido, substituído ou removido.

Listando todos os pacotes que dependem de outro com depends (d)
Já se perguntou por que um certo pacote foi instalado no sistema? pode dizer quais pacotes listam este como dependência com a opção. Inclua dependências indiretas com a opção.

Um segundo exemplo lista todos os pacotes dependendo diretamente de udev:

Obtendo gráficos de dependências com depgraph (g)
é o oposto de. Ele irá encontrar todos os ebuilds dos quais um dado pacote depende (e não os ebuilds que dependem deste pacote). Quando ele encontra uma dependência, irá recursivamente buscar as dependências daquele pacote. Controle o quão a fundo a árvore consegue com a opção.

Reparou como  é uma dependência direta e   é uma dependência indireta se a USE flag   USE está definida?

Listando arquivos instalados por um pacote com files (f)
pode listar todos os arquivos instalados por um ebuild com o módulo. Tente  para obter um layout de diretório de fácil leitura. Use  para encontrar apenas um determinado tipo de arquivo. Por exemplo, para encontrar onde executáveis foram instalados use, ou para encontrar rapidamente o local do arquivo de configuração tente.

Outro exemplo, para listar todos os arquivos instalados pelo :

Descrições de outros módulos e flags de linha de comando adicionais podem ser encontrados na man page do equery.

Procurando por pacotes que tem uma USE flag específica com hasuse (h)
pode ser usado para encontrar pacotes com uma determinada USE flag. não irá indicar se a flag foi habilitada ou não; simplesmente exibe uma lista de ebuilds que tem a flag consultada como opção. Veja a seção EXAMPLES de  na man page do  para mais dicas sobre como obter este tipo de informação.

Listando pacotes com list (l)
é um módulo simples, porém poderoso para listar pacotes instalados da árvore do Portage ou de um overlay.

A consulta padrão irá buscar pacotes instalados para o nome de pacote informado. Passado com  exibe os pacotes no conjunto. No campo mais à esquerda é possível ver que todos os pacotes acima estão (nstalados) e oriundos da árvore do  (ortage). Eles não estão mascarados (o segundo campo está vazio), e todos estão instalados no slot padrão (0).

Use opções locais para buscar pacotes na árvore do Portage e overlays.

Neste é possível ver que a versão 7.2.182 está instalado e não há versões disponíveis de um overlay. Usuários podem ver quais versões estão mascaradas com  no segundo campo.

Visualizando metadata de pacotes com meta (m)
Each package in the Portage tree provides at least some metadata about its maintainer, etc. The amount of useful information depends on how much package maintainers decide to provide. With no options,  returns some basic useful information.

Some maintainers provide extra information about a package, which can be very useful:

Encontrando tamanho de pacotes com size (s)
Já ficou curioso pra saber quanto espaço um pacote está ocupando? Como um pacote pode ter seus arquivos em um número de diretórios, o comando de sempre pode não dar a noção correta. Mas não se preocupe, ao resgate!

Use  para exibir o espaço total usado em unidades legíveis e listar o número total de arquivos que um pacote possui. Para obter o tamanho total em bytes use.

Listando USE flags por pacote com uses (u)
O módulo do   fornece informações sobre quais USE flags estão disponíveis para um certo pacote e quais dessas flags estão ativas no momento.

Aqui está um número de USE flags ativas no pacote de plugins do gstreamer, mas pode ser visto que há outras USE flags disponíveis. Para mais informações sobre USE flags, consulte o capítulo USE Flags do Gentoo Handbook.

Encontrando o caminho dos ebuilds com which (w)
é um script simples para ajudar os usuários a encontrar rapidamente o caminho de um ebuild. Se o nome de um pacote não versionado é passado usando  retornará o caminho para a versão do ebuild instalável mais recente. Em outras palavras, irá retornar o ebuild que o Portage usaria se fosse digitado. também aceita um pacote versionado para conseguir o caminho para o ebuild citado.

Por último, se nenhuma das funcionalidade acima do deram alguma resposta, tente usar   para buscar manualmente um ebuild com programas tais como,  ou :

Veja também

 * q applets - A collection of small and fast Portage helper tools written in C.
 * eix - A set of utilities for searching and diffing the local Portage tree and overlays using a binary cache.
 * Gentoolkit - A suite of tools to ease the administration of a Gentoo system.