Equery/it

è uno strumento per effettuare molte semplici operazioni comuni di Portage. Tra le altre operazioni, esso può mostrare le dipendenze dei pacchetti, i metadata e i files installati.

Emerge
Equery è una parte di strumenti installati con il pacchetto :

per informazioni sull'installazione di o di altri strumenti vedere l'articolo Gentoolkit.

Introduzione
è uno strumento che mostra informazioni utili sui pacchetti installati nel sistema. si basa su un sistema di moduli. Ogni modulo ha un'abbreviazione. Per esempio, digitare è la stessa cosa che digitare. Invocando l'opzione   verranno mostrate tutte le opzioni globali ed elencati tutti i moduli disponibili con la loro relativa abbreviazione. Aggiungere un modulo alla fine del comando verrà mostrata la schermata di aiuto per questo specifico modulo. Come ultima cosa, eseguire mostrerà una spiegazione dettagliata di tutti i moduli disponibili e le opzioni disponibili con alcuni esempi utili.

Sotto c'è una lista di caratteristiche che funzionano con la maggior parte di moduli.

Come, non comprende i nomi parziali di pacchetti:

Diversamente da, può accettare il globbing della shell nel nome della categoria e/o nel nome del pacchetto:

La maggior parte dei moduli di equery prendono input multipli:

Qualche modulo permette anche espressioni regolari:

Le prossime poche sezioni di questo documento fanno una breve introduzione ai differenti moduli.

Funzionalità
Per vedere una lista di tutte le funzionalità di equery, eseguirlo semplicemente senza argomenti:

Aliases
Un approccio comune di lavorare con è di creare aliases. Quando si utilizza la bash questi possono generalmente essere messi nel file :

Cercare il pacchetto da cui proviene il file con l'opzione belongs (b)
può cercare i file corrispondenti a una espressione regolare tramite l'opzione. L'opzione  ferma la ricerca una volta che la corrispondenza viene trovata. Dal momento che nessun file sul vostro sistema dovrebbe essere di proprietà di due pacchetti, questa è una sicura ottimizzazione.

Può essere utilizzata anche una versione breve di. Per esempio, per vedere a quale pacchetto appartiene :

Visualizzazione delle voci ChangeLog con changes (c)
fa vedere all'utente le voci ChangeLog per una versione di pacchetto entro un range di versioni. Immaginare che dopo l'esecuzione del comando Portage mostra un messaggio che dice che sta per essere aggiornato. Per vedere quali sono i cambiamenti può essere utilizzato questo comando:

Verificare l'integrità del pacchetto con check (k)
Qualche volta è utile verificare l'integrità di un pacchetto. può verificare le MD5 sums così come il timestamps per indicare quando un pacchetto potrebbe essere stato corrotto, sostituito o rimosso.

Elencare tutti i pacchetti dipendenti da un pacchetto con dependes (d)
Vi siete mai chiesti il motivo per cui un certo pacchetto è stato installato sul sistema? può dire quali sono i pacchetti che lo elencano come dipendenza tramite l'opzione. Si possono anche includere le dipendenze indirette con l'opzione.

Un secondo esempio elenca tutti i pacchetti direttamente dipendenti da udev:

Vedere dipendenze circolari con degraph (g)
è l'opposto di. Essa cercherà tutti gli ebuilds da cui un dato pacchetto dipende (non gli ebuilds che dipendono dal pacchetto). Quando trova una dipendenza, essa cercherà ricorsivamente tutte le "altre" sotto-dipendenze di quel pacchetto. Controllare quanto è profondo il controllo sull'albero del Portage con l'opzione.

Notare come  è una dipendenza "diretta" e   è una dipendenza "indiretta" se la USE   è impostata.

Elencare i files installati da un pacchetto con files (f)
può elencare tutti i fles installati da un ebuild con il modulo. Provare  per leggere facilmente l'impaginazione della directory. Utilizzare  per trovare solo un certo tipo di file. Per esempio, per trovare dove sono installati gli eseguibili, utilizzare, o per trovare rapidamente la posizione del file di configurazione provare con.

Un altro esempio, per elencare tutti i files installati da :

Descriptions of other modules and additional command line flags can be found in the equery man page.

Looking for packages that have a specific USE flag with hasuse (h)
can be used to find packages with a given USE flag. will not indicate if the flag has been enabled or not; it simply outputs a list of ebuilds that have the queried flag as an option. See the EXAMPLES section of  in the  man page for more tip on getting this kind of information.

Listing packages with list (l)
is a simple, yet powerful module to list packages that are installed, in the Portage tree or in an overlay.

The standard query will search installed packages for the given package name. Passing in  displays all packages in the set. In the leftmost field it is possible to see all the above packages are (nstalled) and from the  (ortage) tree. They are not masked (the second field is blank), and they are all installed in the default slot (0).

Use local options to look for packages in the Portage tree and overlays.

In this is it possible to see version 7.2.182 is installed and there are no versions available from an overlay. Users can see which versions are keyword masked by the  in the second field.

Viewing package metadata with 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 the package which be very useful:

Finding package sizes with size (s)
Ever been curious to find out how much space a specific package is occupying? Since a package could have its files over a number of directories, the usual command might not give the correct figure. Not to worry, to the rescue!

Using  prints the total space used in human-readable units and lists the total number of files the package has. To get the total size in bytes use.

Listing per-package USE flags with uses (u)
's  module can provide information about what USE flags are available for a specific package and which of those flags is currently enabled.

Here a number of USE flags are enabled in gstreamer's plugin meta-package, but it can be seen that there are other USE flags available. For more information on USE flags, please refer to the USE Flags chapter of the Gentoo Handbook.

Finding the ebuild path with which (w)
is a simple script to help users quickly find the file path to an ebuild. If an unversioned package name is passed using  it will return the path to the newest installable ebuild version. In other words, it would return the ebuild Portage would use if was typed. also accepts a versioned package to get the path to that ebuild.

Lastly, if none of the above features of have provided an answer, try using   to manually search an ebuild with programs like,  or :