L'elenco delle risorse dei pacchetti è utilizzata per localizzare gli archivi del sistema di distribuzione pacchetti in uso sul sistema. Attualmente, questa pagina di manuale documenta solo il sistema di gestione dei pacchetti usato dalla distribuzione Debian GNU/Linux. Questo file di controllo è ubicato in /etc/apt/sources.list.
La lista delle sorgenti (dei pacchetti) è progettata per supportare qualsiasi numero di sorgenti attive e una molteplicità di media delle sorgenti. Il file elenca una sorgente per riga, con la sorgente preferita elencata per prima. Il formato di ogni riga è: type uri args. Il primo elemento, type (tipo) determina il formato per args (gli argomenti), uri è l'Universal Resource Identifier (Identificatore universale di risorsa) (URI), che è un macroinsieme del più specifivo e ben conosciuto Universal Resource Locator, o URL. Le linee rimanenti possono venire marcate come commenti usando un carattere #.
La directory /etc/apt/sources.list.d fornisce un metodo per aggiungere voci di sources.list in file separati che terminano con .list. Il formato è il medesimo del file sources.list regolare.
Il tipo deb descrive un tipico archivio Debian a due livelli, distribuzione/componente. Tipicamente, distribuzione è generalmente una tra stable, unstable, o testing, mentre componente è uno di main, contrib, non-free, o non-us. Il tipo deb-src descrive il codice sorgente della distribuzione debian nella medesima forma del tipo deb. Una riga deb-src è richiesta per recuperare gli indici dei (pacchetti) sorgenti.
Il formato per una voce in sources.list, utilizzando i tipi deb e deb-src è:
deb uri distribuzione [componente1] [componenente2] [...]
L'URI per il tipo deb deve specificare la base della distribuzione Debian, da cui APT troverà le informazioni necessarie. distribuzione può specificare un path esatto, nel qual caso i componenti devono essere omessi e distribuzione deve terminare con una barra rovescia (slash /). Questo è utile quando interessa solo una particolare sotto-sezione dell'archivio, indicata dall'URI. Se distribuzione non specifica un percorso esatto, deve essere presente almeno un componente.
distribuzione può contenere anche una variabile, $(ARCH), che espande alla architettura Debian (i386, m68k, powerpc, ...) utilizzata sul sistema. Questo consente di utilizzare file sources.list, independenti dall'architettura. In generale questo è interesante solo quando viene specificato un percorso esatto, altrimenti APT genererà automaticamente URI con la corrente architettura.
Siccome può essere specificata solo una distribuzione per riga, può essere necessario avere righe multiple per lo stesso URI, se è desiderato un sottoinsieme di tutte le distribuzioni o componenti disponibili per quella ubicazione. APT ordinerà la lista URI dopo aver generato un insieme interno completo, e bloccherà i riferimenti multipli al medesimo host Internet, per esempio, in una singola connessione, cosicché non stabilisca una connessione FTP inefficiente, la chiuda, faccia qualcos'altro e poi ristabilisca una connessione con quel medesimo host. Questa caratteristica è utile per accedere a siti FTP occupati con limitazioni di accesso del numero di utenti anonimi contemporanei. APT inoltre parallelizza le connessioni a host differenti, per occuparsi in maniera più efficiente dei siti con scarsa larghezza di banda.
E' importante elencare le sorgenti in ordine di preferenza, con la sorgente preferita elecata per prima. Tipicamente questo provocherà una scelta per velocità dal piu` veloce al piu` lento (per esempio, CD-ROM seguito dagli host di rete locale, seguito dagli host di internet distanti).
Alcuni esempi:
deb http://http.us.debian.org/debian stable main contrib non-free deb http://http.us.debian.org/debian dists/stable-updates/
I tipi di URI attualmente riconosciuti sono: cdrom, file, http, e ftp.
Utilizza l'archivio memorizzato localmente (o montato con NFS) nella directory /home/jason/debian per stable/main, stable/contrib, e stable/non-free.
deb file:/home/jason/debian stable main contrib non-free
Come il precedente, eccetto che questo utilizza la distribuzione unstable (di sviluppo).
deb file:/home/jason/debian unstable main contrib non-free
La riga per i pacchetti sorgenti come quella sopra
deb-src file:/home/jason/debian unstable main contrib non-free
Utilizza HTTP per accedere all'archivio su archive.debian.org, e usa solo l'area hamm/main.
deb http://archive.debian.org/debian-archive hamm main
Utilizza FTP per accedere all'archivio su ftp.debian.org, sotto la directory debian, e usa solo l'area stable/contrib.
deb ftp://ftp.debian.org/debian stable contrib
Utilizza FTP per accedere all'archivio su ftp.debian.org, sotto la directory dedian e usa solo l'area unstable/contrib. Se questa linea appare come l'unica linea nel precedente esempio in sources.list, verrà usata un singola sessione FTP per entrambe le righe delle risorse.
deb ftp://ftp.debian.org/debian unstable contrib
Utilizza HTTP per accedere all'archivio su nonus.debian.org, sotto la directory debian-non-US.
deb http://nonus.debian.org/debian-non-US stable/non-US main contrib non-free
Utilizza HTTP per accedere all'archivio su nonus.debian.org, sotto la directory debian-non-US e usa solo i file trovati sotto unstable/binary-i386 su macchine i386, unstable/binary-m68k su m68k, e così via per altre architetture supportate. [Notare questo esempio che illustra solo come usare la variabile sostituzione; non-us è così strutturato da non molto]
deb http://ftp.de.debian.org/debian-non-US unstable/binary-$(ARCH)/
La pagina dei bug di APT[1]. Se si desidera riportare un bug in APT, per favore vedere il file /usr/share/doc/debian/bug-reporting.txt o il comando reportbug(1).
Jason Gunthorpe Autore.
Il Team APT Autore
Traduzione e adattamenti in Italiano a cura di Hugh Hartmann <hhartmann@libero.it>, Revisione a cura di Vieri Giugni <v.giugni@gmail.com>.