APT-FTPARCHIVE(1)

NOME
apt-ftparchive - strumento per generare file indice

SINOSSI

apt-ftparchive [-dsq] [--md5] [--delink] [--readonly] [--contents] [--arch architecture] [-o=stringa_config] [-c=file_config] {packages percorso [file-override [prefisso_percorso]] | sources percorso [file-override [prefisso_percorso]] | contents percorso | release percorso | generate file_config sezione... | clean file_config | {-v | --version} | {-h | --help}}

DESCRIZIONE

apt-ftparchive è lo strumento a riga di comando che genera i file indice usati da APT per accedere a una fonte di distribuzione. I file indice devono essere generati sul sito origine in base al contenuto di tale sito.

apt-ftparchive è un sovrainsieme del programma dpkg-scanpackages(1) e incorpora tutte le sue funzionalità tramite il comando packages. Inoltre contiene un generatore di file dei contenuti, contents, e un modo elaborato per gestire tramite script il processo di generazione per un archivio completo.

Internamente apt-ftparchive può far uso di database binari per tenere in cache il contenuto di un file .deb e non si basa su programmi esterni all'infuori di gzip(1). Quando genera un archivio completo, esegue automaticamente un controllo sui file modificati e crea i file compressi desiderati in uscita.

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

packages
    Il comando packages genera un file dell'indice di pacchetti da un albero di directory. Prende la directory data e vi ricerca i file .deb ricorsivamente, emettendo per ciascuno un record sullo stdout. Questo comando è più o meno equivalente a dpkg-scanpackages(1).

    L'opzione --db può essere usata per specificare un database binario da usare come cache.

sources
    Il comando sources genera un file indice dei sorgenti da un albero di directory. Prende la directory data e vi ricerca i file .dsc ricorsivamente, emettendo per ciascuno un record sullo stdout. Questo comando è più o meno equivalente a dpkg-scansources(1).

    Se si specifica un file override, allora verrà cercato un file override sorgente con estensione .src. L'opzione --source-override può essere usata per cambiare il file override sorgente da usare.

contents
    Il comando contents genera un file di contenuti da un albero di directory. Prende la directory data e vi ricerca i file .deb ricorsivamente, leggendo l'elenco dei file da ciascun file. Quindi ordina e scrive sullo stdout l'elenco di file con i corrispondenti pacchetti. Le directory non vengono scritte sull'output. Se più pacchetti contengono lo stesso file, ciascun pacchetto è separato da una virgola nell'output.

    L'opzione --db può essere usata per specificare un database binario da usare come cache.

release
    Il comando release genera un file Release da un albero di directory. In modo predefinito cerca ricorsivamente nella directory data i file Packages, Sources, Contents, Components e icons compressi e non compressi, come anche i file Release, Index e md5sum.txt (APT::FTPArchive::Release::Default-Patterns). Si possono aggiungere ulteriori modelli per i nomi di file elencandoli in APT::FTPArchive::Release::Patterns. Scrive poi sullo stdout un file Release contenente (in modo predefinito) per ogni file un digest MD5, SHA1, SHA256 e SHA512.

    I valori dei campi di metadati aggiuntivi nel file Release sono presi dalle variabili corrispondenti sotto APT::FTPArchive::Release, ad esempio APT::FTPArchive::Release::Origin. I campi supportati sono: Origin, Label, Suite, Version, Codename, Date, NotAutomatic, ButAutomaticUpgrades, Acquire-By-Hash, Valid-Until, Signed-By, Architectures, Components, Description.

generate
    Il comando generate è pensato per essere eseguibile da uno script di cron e costruisce gli indici in base al file di configurazione fornito. Il linguaggio di configurazione fornisce un mezzo flessibile per specificare quali file di indice vengano costruiti a partire da quali directory, oltre a fornire un mezzo semplice per amministrare le impostazioni desiderate.

clean
    Il comando clean pulisce i database usati dal file di configurazione dato, rimuovendo tutti i record non più necessari.

LA CONFIGURAZIONE DI GENERATE

Il comando generate usa un file di configurazione per descrivere gli archivi da generare. Segue il tipico formato di configurazione ISC come usato negli strumenti ISC come bind 8 e dhcpd. apt.conf(5) contiene una descrizione della sintassi. Notare che la configurazione di generate viene letta per sezioni, ma apt.conf(5) viene letto ad albero. Ciò ha effetto soltanto sulla gestione del tag di ambito.

La configurazione di generate ha quattro sezioni separate, ciascuna delle quali è descritta in seguito.

  Sezione Dir

La sezione Dir definisce le directory standard necessarie per localizzare i file richiesti durante il processo di generazione. Queste directory vengono fatte precedere da alcuni percorsi relativi definiti nelle sezioni successive, per produrre un percorso assoluto completo.

ArchiveDir
    Specifica la radice dell'archivio FTP; in una configurazione Debian standard questa è la directory che contiene i nodi ls-LR e dist.

OverrideDir
    Specifica la posizione dei file override.

CacheDir
    Specifica la posizione dei file cache.

FileListDir
    Specifica la posizione dei file con gli elenchi dei file, se viene usata l'impostazione FileList sotto.

  Sezione Default

La sezione Default specifica i valori predefiniti e le impostazioni che controllano il funzionamento del generatore. Altre sezioni possono scavalcare questi valori tramite impostazioni definite per sezione.

Packages::Compress
    Imposta gli schemi di compressione predefiniti da usare per i file indice dei pacchetti. È una stringa che contiene una lista separata da spazi con almeno uno dei compressori configurati con l'ambito di configurazione APT::Compressor. Il valore predefinito per tutti gli schemi di compressione è «. gzip».

Packages::Extensions
    Imposta la lista predefinita di estensioni di file che contraddistinguono i file dei pacchetti. Il valore predefinito è «.deb».

Sources::Compress
    Simile a Packages::Compress, tranne per il fatto che controlla la compressione dei file Sources.

Sources::Extensions
    Imposta la lista predefinita di estensioni che contraddistinguono i file dei sorgenti. Il valore predefinito è «.dsc».

Contents::Compress
    Simile a Packages::Compress, tranne per il fatto che controlla la compressione dei file Contents.

Translation::Compress
    Simile a Packages::Compress, tranne per il fatto che controlla la compressione del file principale Translation-en.

DeLinkLimit
    Specifica il numero dei kilobyte da scollegare (e sostituire con collegamenti fisici) per esecuzione. Viene usato insieme all'impostazione per sezione External-Links.

FileMode
    Specifica la modalità di tutti i file indice creati. Il valore predefinito è 0644. Tutti i file di indice sono impostati a questa modalità a prescindere dall'umask.

LongDescription
    Specifica se le descrizioni lunghe debbano essere incluse nel file Packages o separate in un file Translation-en principale.

  Sezione TreeDefault

Imposta valori predefiniti specifici per le sezioni Tree. Tutte queste variabili sono variabili di sostituzione in cui le stringhe $(DIST), $(SECTION) e $(ARCH) verranno sostituite dai loro rispettivi valori.

MaxContentsChange
    Imposta il numero di kilobyte di file Contents che vengono generati ogni giorno. I file Contents sono ruotati a turno in modo da venire rigenerati tutti nel giro di alcuni giorni.

ContentsAge
    Controlla il numero di giorni durante i quali un file Contents può essere controllato senza modifiche. Al superamento di questo limite, l'orario mtime del file Contents viene aggiornato. Questo può succedere se il file Packages viene modificato in un modo che non ha come risultato un nuovo file Contents [ad esempio una modifica di override]. È consentito un certo ritardo, nella speranza che vengano installati nuovi pacchetti .deb, il che richiederebbe comunque la creazione di un nuovo file. Il valore predefinito è 10, i valori sono espressi in giorni.

Directory
    Imposta la radice dell'albero della directory dei .deb. Il valore predefinito è $(DIST)/$(SECTION)/binary-$(ARCH)/.

SrcDirectory
    Imposta la radice dell'albero della directory dei pacchetti sorgente. Il valore predefinito è $(DIST)/$(SECTION)/source/.

Packages
    Imposta il file Packages di uscita. Il valore predefinito è $(DIST)/$(SECTION)/binary-$(ARCH)/Packages.

Sources
    Imposta il file Sources di uscita. Il valore predefinito è $(DIST)/$(SECTION)/source/Sources.

Translation
    Imposta il file Translation-en principale di uscita contenente le descrizioni lunghe se non devono essere incluse nel file Packages. Il valore predefinito è $(DIST)/$(SECTION)/i18n/Translation-en.

InternalPrefix
    Imposta il prefisso del percorso che fa sì che un collegamento simbolico sia considerato un collegamento interno invece che esterno. Il valore predefinito è $(DIST)/$(SECTION)/.

Contents
    Imposta il file Contents di uscita. Il valore predefinito è $(DIST)/$(SECTION)/Contents-$(ARCH). Se questa impostazione fa sì che più file Packages corrispondano a un solo file Contents (come avviene con il valore predefinito), allora apt-ftparchive unirà automaticamente insieme questi file dei pacchetti.

Contents::Header
    Imposta il file di intestazione da anteporre all'output dei contenuti.

BinCacheDB
    Imposta il database per la cache binaria da usare per questa sezione. Lo stesso database può essere condiviso da più sezioni.

FileList
    Specifica che invece di percorrere l'albero delle directory, apt-ftparchive deve leggere la lista dei file dal file dato. I nomi relativi dei file vengono fatti precedere dalla directory archivio.

SourceFileList
    Specifica che invece di percorrere l'albero delle directory, apt-ftparchive deve leggere la lista dei file dal file dato. I nomi di file relativi vengono fatti precedere dalla directory archivio. Questa opzione viene usata quando si elaborano gli indici dei sorgenti.

  Sezione Tree

La sezione Tree definisce un albero di file standard Debian che consiste in una directory di base, quindi più sezioni in quella directory di base e infine più architetture in ogni sezione. Gli esatti percorsi usati sono definiti dalla variabile di sostituzione Directory.

La sezione Tree accetta un tag di ambito che imposta la variabile $(DIST) e definisce la radice dell'albero (il percorso viene fatto precedere da ArchiveDir). Di solito è un'impostazione simile a dists/trixie.

Tutte le impostazioni definite nella sezione TreeDefault possono essere usate in una sezione Tree, oltre a tre nuove variabili.

Quando elabora una sezione Tree, apt-ftparchive esegue un'operazione simile a:

    for i in Sections do
       for j in Architectures do
          Genera per DIST=ambito SECTION=i ARCH=j

Sections
    Questa è una lista di sezioni che appaiono sotto la distribuzione, separate da spazi; tipicamente è simile a main contrib non-free non-free-firmware.

Architectures
    Questa è una lista separata da spazi di tutte le architetture che sono presenti nella sezione ricerca. L'architettura speciale «source» viene usata per indicare che questo albero ha un archivio sorgente. L'architettura «all» indica che i file specifici per un'architettura come Packages non dovrebbero includere informazioni sui pacchetti con architettura all in tutti i file, dato che saranno disponibili in un file dedicato.

LongDescription
    Specifica se le descrizioni lunghe debbano essere incluse nel file Packages o separate in un file Translation-en principale.

BinOverride
    Imposta il file override binario. Il file override contiene informazioni sulla sezione, la priorità e l'indirizzo del manutentore.

SrcOverride
    Imposta il file override sorgente. Il file override contiene informazioni sulla sezione.

ExtraOverride
    Imposta il file override binario extra.

SrcExtraOverride
    Imposta il file override sorgente extra.

  Sezione BinDirectory

La sezione bindirectory definisce un albero di directory dei binari senza una struttura speciale. Il tag di ambito specifica la posizione della directory dei binari e le impostazioni sono simili a quelle della sezione Tree senza variabili di sostituzione o impostazioni SectionArchitecture.

Packages
    Imposta l'output del file Packages.

Sources
    Imposta l'output del file Sources. È obbligatorio almeno uno fra Packages e Sources.

Contents
    Imposta l'output del file Contents (opzionale).

BinOverride
    Imposta il file override binario.

SrcOverride
    Imposta il file override sorgente.

ExtraOverride
    Imposta il file override binario extra.

SrcExtraOverride
    Imposta il file override sorgente extra.

BinCacheDB
    Imposta il DB della cache.

PathPrefix
    Aggiunge un percorso a tutti i percorsi di uscita.

FileList, SourceFileList
    Specifica il file con l'elenco dei file.

IL FILE OVERRIDE BINARIO

Il file override binario è completamente compatibile con dpkg-scanpackages(1). Contiene quattro campi separati da spazi. Il primo campo è il nome del pacchetto, il secondo è la priorità a cui forzare quel pacchetto, il terzo è la sezione in cui forzare quel pacchetto e l'ultimo campo è il campo di permutazione del manutentore.

La forma generale del campo manutentore è:

    vecchio [// vecchio...]* => nuovo

o semplicemente

    nuovo

. La prima forma consente di specificare una lista di vecchi indirizzi di posta elettronica separati da una doppia sbarra. Se qualcuno di essi viene trovato, allora il campo manutentore viene sostituito con «nuovo». La seconda forma sostituisce invariabilmente il campo manutentore.

IL FILE OVERRIDE SORGENTE

Il file override sorgente è completamente compatibile con dpkg-scansources(1). Contiene due campi separati da spazi. Il primo campo è il nome del pacchetto sorgente, il secondo è la sezione a cui assegnarlo.

IL FILE OVERRIDE EXTRA

Il file override extra permette di aggiungere o sostituire nell'output un tag arbitrario. Ha tre colonne: la prima per il pacchetto, la seconda per il tag e il resto della riga è il nuovo valore.

OPZIONI

Tutte le opzioni a riga di comando si possono impostare usando il file di configurazione; le descrizioni indicano l'opzione da impostare. Per le opzioni booleane si può scavalcare il file di configurazione usando qualcosa come -f-, --no-f, -f=no o diverse altre varianti.

--md5, --sha1, --sha256, --sha512
    Genera i codici di controllo specificati. Queste opzioni sono abilitate in modo predefinito; quando vengono disabilitate i file indice non hanno, quando ciò è possibile, i campi dei codici di controllo. Voci di configurazione: APT::FTPArchive::Codice-di-controllo e APT::FTPArchive::Indice::Codice-di-controllo dove Indice può essere Packages, Sources o Release e Codice-di-controllo può essere MD5, SHA1, SHA256 o SHA512.

-d, --db
    Usa un DB per la cache binaria. Questo non ha effetto sul comando generate. Voce di configurazione: APT::FTPArchive::DB.

-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à, scavalcando il file di configurazione. Voce di configurazione: quiet.

--delink
    Effettua il de-collegamento. Se viene usata l'impostazione External-Links allora questa opzione abilita di fatto il de-collegamento dei file. È attiva in modo predefinito e può essere disabilitata con --no-delink. Voce di configurazione: APT::FTPArchive::DeLinkAct.

--contents
    Effettua la generazione dei Contents. Se viene impostata questa opzione e gli indici dei pacchetti sono generati con un DB della cache, allora anche l'elenco dei file verrà estratto e memorizzato nel DB per gli usi futuri. Quando si usa il comando generate questa opzione permette anche la creazione di qualsiasi file Contents. È attiva in modo predefinito. Voce di configurazione: APT::FTPArchive::Contents.

-s, --source-override
    Seleziona il file override sorgente da usare con il comando sources. Voce di configurazione APT::FTPArchive::SourceOverride.

--readonly
    Rende i database delle cache in sola lettura. Voce di configurazione: APT::FTPArchive::ReadOnlyDB.

-a, --arch
    Accetta per i comandi packages e contents solo i file di pacchetto che corrispondono a *_arch.deb o *_all.deb invece di tutti i file di pacchetto nel percorso specificato. Voce di configurazione: APT::FTPArchive::Architecture.

APT::FTPArchive::AlwaysStat
    apt-ftparchive(1) memorizza in un database cache il maggior numero possibile di metadati. Se i pacchetti sono ricompilati o ripubblicati nuovamente con la stessa versione, questo causa problemi dato che verranno usati dei metadati in cache, come la dimensione e i codici di controllo, non più aggiornati. Notare che questa opzione è impostata in modo predefinito a «false» dato che non è raccomandabile caricare più versioni/compilazioni di un pacchetto con lo stesso numero di versione, perciò in teoria nessuno dovrebbe avere di questi problemi e di conseguenza tutti questi controlli aggiuntivi sono inutili.

APT::FTPArchive::LongDescription
    Questa opzione di configurazione è impostata a «true» in modo predefinito e dovrebbe essere impostata a «false» solamente se l'archivio generato con apt-ftparchive(1) fornisce anche file Translation. Notare che il file principale Translation-en può essere creato solamente con il comando generate.

-h, --help
    Mostra un breve riassunto sull'uso.

-v, --version
    Mostra la versione del programma.

--audit
    Show audit (and notice) messages. This overrides the quiet option, but only for notice messages, not progress ones.

-c, --config-file
    File di configurazione; specifica un file di configurazione da usare. Il programma legge il file di configurazione predefinito e poi questo file di configurazione. Se è necessario modificare le impostazioni di configurazione prima che vengano analizzati i file di configurazione predefiniti, specificare un file con la variabile d'ambiente APT_CONFIG. Vedere apt.conf(5) per informazioni sulla sintassi.

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

ESEMPI

Per creare un file Packages compresso per una directory contenente pacchetti binari (.deb):

    apt-ftparchive packages directory | gzip > Packages.gz

VEDERE ANCHE

apt.conf(5)

DIAGNOSTICA

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

BUG

Pagina dei bug di APT[1]. Se si desidera segnalare un bug in APT, vedere /usr/share/doc/debian/bug-reporting.txt o il comando reportbug(1).

TRADUZIONE

Traduzione in italiano a cura del Team italiano di localizzazione di Debian <debian-l10n-italian@lists.debian.org>. In particolare hanno contribuito Eugenia Franzoni (2000), Hugh Hartmann (2000-2012), Gabriele Stilli (2012), Beatrice Torracca (2012, 2014, 2015).

Notare che questa versione tradotta del documento può contenere parti non tradotte. Ciò è voluto, per evitare di perdere contenuti quando la traduzione non è aggiornata rispetto all'originale.

AUTORI

Jason Gunthorpe

Team APT

NOTE

1.  Pagina dei bug di APT
    https://bugs.debian.org/src:apt