Scroll to navigation

APT-CACHE(8) APT APT-CACHE(8)

NOME

apt-cache - interroga la cache di APT

SINOSSI

apt-cache [-agipns] [-o=config_string] [-c=config_file] {gencaches | showpkg pkg... | showsrc pkg... | stats | dump | dumpavail | unmet | search regex... | show pkg [{=pkg_version_number | /target_release}]... | depends pkg [{=pkg_version_number | /target_release}]... | rdepends pkg [{=pkg_version_number | /target_release}]... | pkgnames [prefix] | dotty pkg [{=pkg_version_number | /target_release}]... | xvcg pkg [{=pkg_version_number | /target_release}]... | policy [pkg...] | madison pkg... | {-v | --version} | {-h | --help}}

DESCRIZIONE

apt-cache esegue una varietà di operazioni sulla cache dei pacchetti di APT. apt-cache non manipola lo stato del sistema ma fornisce operazioni per fare ricerche e generare risultati interessanti partendo dai metadati dei pacchetti. I metadati vengono acquisiti e aggiornati attraverso il comando «update» di, ad esempio, apt-get, perciò possono non essere più attuali se l'ultimo aggiornamento è stato fatto troppo tempo prima, ma d'altro canto apt-cache funziona in modo indipendente dalla disponibilità delle fonti configurate (cioè anche fuori linea).

A meno che non venga fornita l'opzione -h o --help, deve essere presente uno dei comandi seguenti.

gencaches

gencaches crea la cache dei pacchetti di APT. Ciò viene fatto implicitamente da tutti i comandi che hanno bisogno di tale cache, se essa manca o non è aggiornata.

showpkg pkg...

showpkg mostra informazioni sui pacchetti elencati nella riga di comando. I restanti argomenti sono nomi di pacchetto. Sono elencate le versioni disponibili e le dipendenze inverse di ogni pacchetto, oltre alle dipendenze dirette per ogni versione. Le dipendenze dirette (normali) sono quei pacchetti da cui dipende il pacchetto in questione; le dipendenze inverse sono quei pacchetti che dipendono dal pacchetto in questione. Quindi, per un pacchetto, devono essere soddisfatte le dipendenze dirette, ma non necessariamente quelle inverse. Per esempio, apt-cache showpkg libreadline2 produce un risultato simile al seguente:

Package: libreadline2
Versions: 2.1-12(/var/state/apt/lists/pinco_Packages),
Reverse Depends: 
  libreadlineg2,libreadline2
  libreadline2-altdev,libreadline2
Dependencies:
2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null))
Provides:
2.1-12 - 
Reverse Provides: 
Quindi si vede che libreadline2, versione 2.1-12, dipende da libc5 e ncurses3.0 che devono essere installati affinché libreadline2 funzioni. A loro volta, libreadlineg2 e libreadline2-altdev dipendono da libreadline2. Se libreadline2 è installato, devono esserlo anche libc5 e ncurses3.0 (e ldso); non necessariamente devono esserlo libreadlineg2 e libreadline2-altdev. Per il significato specifico del resto dell'output è meglio consultare il codice sorgente di apt.

stats

stats mostra alcune statistiche sulla cache. Non sono previsti ulteriori argomenti. Le statistiche riportate sono:

•Totale nomi dei pacchetti è il numero di nomi di pacchetto trovati nella cache.

•Pacchetti normali è il numero di nomi di pacchetti regolari, normali; sono pacchetti che hanno una corrispondenza uno-a-uno fra il loro nome e il nome usato da altri pacchetti per indicarli nelle loro dipendenze. La maggioranza dei pacchetti ricade in questa categoria.

•Pacchetti virtuali puri è il numero di pacchetti che esistono solo come nome di pacchetto virtuale; vale a dire, i pacchetti «forniscono» solamente il nome del pacchetto virtuale e nessun pacchetto in realtà usa quel nome. Per esempio, «mail-transport-agent» nel sistema Debian è un pacchetto virtuale puro; diversi pacchetti forniscono «mail-transport-agent», ma non c'è alcun pacchetto chiamato «mail-transport-agent».

•Pacchetti virtuali singoli è il numero di pacchetti virtuali per cui esiste solo un pacchetto che li fornisce. Per esempio, nel sistema Debian «X11-text-viewer» è un pacchetto virtuale, ma solo un pacchetto, xless, fornisce «X11-text-viewer».

•Pacchetti virtuali misti è il numero di pacchetti che forniscono un particolare pacchetto virtuale oppure hanno il nome uguale a quello del pacchetto virtuale. Per esempio, nel sistema Debian «debconf» è sia un pacchetto vero e proprio, sia è fornito dal pacchetto debconf-tiny.

•Mancanti è il numero di nomi di pacchetto che vengono menzionati in una dipendenza ma non sono forniti da alcun pacchetto. I pacchetti mancanti possono essere un segno che non si ha accesso a una distribuzione completa o che un pacchetto (reale o virtuale) è stato eliminato da una distribuzione. Di solito vengono menzionati da clausole Conflicts o Breaks.

•Totale versioni distinte è il numero di versioni di pacchetti trovate nella cache. Se si ha accesso a più di una distribuzione (ad esempio sia «stable» che «unstable»), questo valore può essere decisamente più grande del numero dei nomi totali di pacchetto.

•Totale dipendenze è il numero di relazioni di dipendenza dichiarate da tutti i pacchetti nella cache.

showsrc pkg...

showsrc mostra tutti i pacchetti sorgente che corrispondono ai nomi dei pacchetti specificati. Vengono mostrate tutte le versioni, così come tutti i record che dichiarano che il nome è quello di un pacchetto binario. Usare --only-source per visualizzare solo i nomi di pacchetti sorgente.

dump

dump mostra un breve elenco di tutti i pacchetti nella cache. Serve soprattutto a scopo di debug.

dumpavail

dumpavail stampa una lista di pacchetti disponibili su stdout. Questa è adatta all'uso con dpkg(1) ed è usata dal metodo dselect(1).

unmet

unmet mostra un riassunto di tutte le dipendenze non soddisfatte nella cache dei pacchetti.

show pkg...

show esegue una funzione simile a dpkg --print-avail; mostra i record dei pacchetti per i pacchetti specificati.

search regex...

search esegue una ricerca completa a tutto testo in tutti gli elenchi di pacchetti disponibili cercando il modello di espressione regolare POSIX specificato; vedere regex(7). Cerca le occorrenze dell'espressione regolare nei nomi e nelle descrizioni dei pacchetti e stampa il nome e la descrizione breve dei pacchetti, inclusi quelli virtuali. Se viene fornita l'opzione --full, per ciascun pacchetto che soddisfa la ricerca viene prodotto un output identico a quello di show; se viene fornita l'opzione --names-only la ricerca viene fatta solo sul nome del pacchetto e dei pacchetti forniti e non sulla descrizione lunga.

È possibile usare argomenti separati per specificare più modelli di ricerca che vengono combinati con un AND.

depends pkg...

depends mostra un elenco con ogni dipendenza di un pacchetto e tutti i possibili altri pacchetti che possono soddisfare quella dipendenza.

rdepends pkg...

rdepends mostra un elenco di tutte le dipendenze inverse di un pacchetto.

pkgnames [prefix]

Questo comando stampa il nome di tutti i pacchetti che APT conosce. L'argomento opzionale è un prefisso per filtrare l'elenco dei nomi. Il risultato è adatto ad essere usato in una funzione di shell di completamento automatico tramite Tab e viene generato molto rapidamente. Questo comando viene usato al meglio con l'opzione --generate.

Notare che un pacchetto che APT conosce non è necessariamente disponibile per essere scaricato, installabile o installato; ad esempio, i pacchetti virtuali sono anch'essi compresi nell'elenco generato.

dotty pkg...

dotty accetta un elenco di pacchetti dalla riga di comando e genera un output adatto all'uso da parte di dotty del pacchetto GraphViz[1]. Il risultato sarà un insieme di nodi e linee che rappresentano le relazioni fra i pacchetti. In modo predefinito dai pacchetti dati si risalirà a tutti i pacchetti delle dipendenze; ciò può produrre un grafo molto grande. Per limitare il risultato ai soli pacchetti elencati sulla riga di comando, impostare l'opzione APT::Cache::GivenOnly.

I nodi risultanti avranno diverse forme: i pacchetti normali sono rettangoli, i pacchetti virtuali puri sono triangoli, i pacchetti virtuali misti sono rombi, i pacchetti mancanti sono esagoni. I rettangoli arancioni indicano che la ricorsione è stata arrestata (pacchetti foglia), le linee blu sono pre-dipendenze, le linee verdi sono conflitti.

Attenzione: dotty non può creare i grafi degli insiemi più grandi di pacchetti.

xvcg pkg...

Stessa cosa di dotty, ma per xvcg dello strumento VCG[2].

policy [pkg...]

policy è pensato per aiutare a fare il debug di problemi relativi al file delle preferenze. Senza argomenti stampa le priorità di ciascuna fonte. Altrimenti stampa informazioni dettagliate sulla selezione di priorità del pacchetto indicato.

madison pkg...

Il comando madison di apt-cache cerca di imitare il formato di uscita e un sottoinsieme delle funzionalità di madison, lo strumento di gestione dell'archivio di Debian. Mostra le versioni disponibili di un pacchetto in forma tabellare. Contrariamente al madison originale, può mostrare informazioni solamente per l'architettura per cui APT ha recuperato gli elenchi dei pacchetti (APT::Architecture).

OPZIONI

All command line options may be set using the configuration file, the descriptions indicate the configuration option to set. For boolean options you can override the config file by using something like -f-,--no-f, -f=no or several other variations.

-p, --pkg-cache

Seleziona il file in cui memorizzare la cache dei pacchetti. Questa è la cache primaria usata da tutte le operazioni. Voce di configurazione: Dir::Cache::pkgcache.

-s, --src-cache

Seleziona il file in cui memorizzare la cache dei sorgenti. Questa è usata solo da gencaches e memorizza una versione analizzata delle informazioni sui pacchetti provenienti da fonti remote. Al momento della costruzione della cache dei pacchetti, la cache dei sorgenti viene usata per evitare di rileggere tutti i file dei pacchetti. Voce di configurazione: Dir::Cache::srcpkgcache.

-q, --quiet

Silenzioso; produce un output adatto per un file di registro, omettendo gli indicatori di avanzamento. Ulteriori q produrranno un risultato ancor più silenzioso, fino a un massimo di 2. È anche possibile usare -q=n per impostare il livello di silenziosità a n, scavalcando il file di configurazione. Voce di configurazione: quiet.

-i, --important

Stampa solo le dipendenze importanti; da usarsi con unmet e depends. Fa sì che vengano stampate solo le relazioni Depends e Pre-Depends. Voce di configurazione: APT::Cache::Important.

--no-pre-depends, --no-depends, --no-recommends, --no-suggests, --no-conflicts, --no-breaks, --no-replaces, --no-enhances

In modo predefinito depends e rdepends stampano tutte le dipendenze. Ciò può essere modificato con queste opzioni che omettono il tipo specificato di dipendenza. Voce di configurazione APT::Cache::ShowTipoDipendenza, ad es. APT::Cache::ShowRecommends.

--implicit

In modo predefinito depends e rdepends stampano solo le dipendenze esplicitamente espresse nei metadati. Con questa opzione mostrano anche le dipendenze aggiunte implicitamente sulla base dei dati incontrati. Ad esempio un Conflicts: pippo esprime implicitamente che questo pacchetto va in conflitto anche con il pacchetto pippo da qualsiasi altra architettura. Voce di configurazione: APT::Cache::ShowImplicit.

-f, --full

Stampa l'intero record dei pacchetti durante la ricerca. Voce di configurazione: APT::Cache::ShowFull.

-a, --all-versions

Stampa i record completi per tutte le versioni disponibili. Questa è l'impostazione predefinita; per disattivarla, usare --no-all-versions. Se si specifica --no-all-versions, verrà visualizzata solo la versione candidata (quella che sarebbe scelta per l'installazione). Questa opzione è applicabile solo al comando show. Voce di configurazione: APT::Cache::AllVersions.

-g, --generate

Esegui la rigenerazione automatica della cache dei pachetti, piuttosto che usare la cache così com'è. Questa è l'impostazione predefinita; per disattivarla, usare --no-generate. Voce di configurazione: APT::Cache::Generate.

--names-only, -n

Cerca soltanto nei nomi dei pacchetti e dei pacchetti forniti, non nelle descrizioni lunghe. Voce di configurazione: APT::Cache::NamesOnly.

--all-names

Fai sì che pkgnames stampi tutti i nomi, inclusi i pacchetti virtuali e le dipendenze mancanti. Voce di configurazione: APT::Cache::AllNames.

--recurse

Rendi ricorsivi depends e rdepends in modo che tutti i pacchetti menzionati siano stampati una sola volta. Voce di configurazione: APT::Cache::RecurseDepends.

--installed

Limita l'output di depends e rdepends ai pacchetti attualmente installati. Voce di configurazione: APT::Cache::Installed.

--with-source filename

Adds the given file as a source for metadata. Can be repeated to add multiple files. Supported are currently *.deb, *.dsc, *.changes, Sources and Packages files as well as source package directories. Files are matched based on their name only, not their content!

Sources and Packages can be compressed in any format apt supports as long as they have the correct extension. If you need to store multiple of these files in one directory you can prefix a name of your choice with the last character being an underscore ("_"). Example: my.example_Packages.xz

Note that these sources are treated as trusted (see apt-secure(8)). Configuration Item: APT::Sources::With.

-h, --help

Show a short usage summary.

-v, --version

Show the program version.

-c, --config-file

Configuration File; Specify a configuration file to use. The program will read the default configuration file and then this configuration file. If configuration settings need to be set before the default configuration files are parsed specify a file with the APT_CONFIG environment variable. See apt.conf(5) for syntax information.

-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.

FILE

/etc/apt/sources.list
Locations to fetch packages from. Configuration Item: Dir::Etc::SourceList.

/etc/apt/sources.list.d/

File fragments for locations to fetch packages from. Configuration Item: Dir::Etc::SourceParts.

/var/lib/apt/lists/

Storage area for state information for each package resource specified in sources.list(5) Configuration Item: Dir::State::Lists.

/var/lib/apt/lists/partial/

Storage area for state information in transit. Configuration Item: Dir::State::Lists (partial will be implicitly appended)

VEDERE ANCHE

apt.conf(5), sources.list(5), apt-get(8)

DIAGNOSTICA

apt-cache restituisce zero in caso di funzionamento normale e il valore decimale 100 in caso di errore.

BUGS

APT bug page[3]. If you wish to report a bug in APT, please see /usr/share/doc/debian/bug-reporting.txt or the reportbug(1) command.

TRANSLATION

The english translation was done by John Doe <john@doe.org> in 2009, 2010 and Daniela Acme <daniela@acme.us> in 2010 together with the Debian Dummy l10n Team <debian-l10n-dummy@lists.debian.org>.

Note that this translated document may contain untranslated parts. This is done on purpose, to avoid losing content when the translation is lagging behind the original content.

AUTORI

Jason Gunthorpe

APT team

NOTE

1.
GraphViz
2.
strumento VCG
3.
APT bug page
25 novembre 2016 APT 1.4.9