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 :

Le descrizioni di altri moduli e ulteriori flags da riga di comando possono essere trovati nel man page.

Vedere i pacchetti che hanno una specifica USE flag con hasuse (h)
può essere utilizzata per cercare i pacchetti con una certa USE flag. non indicherà se la flag è stata abilitata o meno; essa mostrerà semplicemente una lista di ebuilds che hanno la flag in questione come opzione. Vedere la sezione degli ESEMPI di  nella pagina  del manuale  per avere maggiori informazioni.

Elencare i pacchetti con list (l)
è un semplice e ancora potente modulo per elencare i pacchetti che sono installati nell'albero del Portage o come overlay.

L'interrogazione standard cercherà i pacchetti installati per il nome del pacchetto dato. Passando  mostra tutti i pacchetti nel gruppo. Nel campo più a sinistra è possibile vedere tutti i pacchetti sopra che sono (nstallati) e dell'albero del  (ortage). Essi non sono mascherati (il secondo campo è vuoto), ed essi sono tutti installati nella slot di default (0).

Utilizzare l'opzione locale per vedere i pacchetti nell'albero del portage e overlays.

Qui è possibile vedere che è installata la versione 7.2.182 e non ci sono versioni disponibili dall'overlay. Gli utenti possono vedere quali versioni sono mascherate (tramite keyword) grazie a   nel secondo campo.

Visualizzazione di pacchetto metadata con meta (m)
Ogni pacchetto nell'albero del Portage fornisce almeno qualche metadata riguardo ai suoi manutentori, ecc... Le quantità di informazioni utili dipendono da quante ne vogliono fornire i manutentori di quel pacchetto. Senza opzioni,  rilascia qualche basilare informazione utile.

Qualche manutentore fornisce informazioni extra riguardo il pacchetto che sono molto utili:

Vedere la dimensione del pacchetto con size (s)
Mai stato curioso si scoprire quanto spazio occupa uno specifico pacchetto? Dal momento che un pacchetto potrebbe avere i suoi files su più directories, il tipico comando potrebbe non dare il risultato esatto. Non bisogna preoccuparsi, aiuta in questo!

utilizzando  viene stampato lo spazio totale utilizzato in unità leggibili ed elenca il numero totale di files che il pacchetto ha. Per ottenere la dimensione totale in bytes utilizzare l'opzione.

Elencare le USE flags per il pacchetto con uses (u)
Il modulo   di  può fornire informazioni su quali USE flags sono disponibili per uno specifico pacchetto e quali di queste flags è attualmente abilitata.

Qui sono abilitate un numero di USE flags in gstreamer's plugin meta-package, ma ci sono altre USE flags disponibili. Per maggiori informazioni sulle USE flags, fare riferimento al capitolo USE Flags dell'Handbook Gentoo.

Trovare il percorso dell'ebuild con which (w)
è uno script semplice per aiutare gli utenti a trovare velocemente il percorso di un file ebuild. Se viene inserito un pacchetto senza specificare la versione, utilizzando, il risultato sarà il percorso dell'ultima versione di ebuild installabile. In altre parole darà come risultato l'ebuild che Portage utilizzerebbe se fosse digitato. accetta anche la "versione" del pacchetto di cui si vuole ottenere il percorso del relativo ebuild.

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