Documentazione Debian
Debian mette a disposizione una vastissima documentazione riguardante sia la comunità Debian, sia il sistema operativo Debian sia ogni singola applicazione presente nei repository ufficiali della distribuzione.
Tutti (e non solo i membri della comunità Debian) sono caldamente invitati a leggerla sia per apprendere conoscenze che non si hanno (e di cui non si sospetta nemmeno l'esistenza) sia per cercare risposte che possano risolvere problemi più o meno comuni.
Tutta la documentazione è stata scritta nel corso degli anni e modificata o integrata per seguire i cambiamenti che Debian (e le applicazioni) hanno subìto nel tempo.
Probabilmente tutte le curiosità e i problemi sono già stati vissuti da qualcun altro e tempestivamente documentati nello spirito di collaborazione e libera diffusione della conoscenza che contraddistingue Debian; non resta che leggere!
Tutta la documentazione è completamente libera e modificabile, chiunque può suggerire cambiamenti.
![]() Debian 8 "jessie" Debian 9 "stretch" Debian 10 "buster" |
Introduzione
Questa guida cercherà di raggruppare il maggior numero possibile di link e informazioni riguardanti la documentazione ufficiale presente in Debian. Se qualcosa manca, basta aggiungerla!
Tutti sono liberi di modificare questa pagina per fare in modo che chi si trovasse a leggerla possa ottenere il maggior numero possibile di informazioni su Debian e poter restituire in seguito un po' della conoscenza acquisita alla comunità a cui appartiene (non necessariamente Debian :) )
Il progetto Debian
Contratto sociale
Il contratto sociale che è alla base della comunità Debian e la filosofia che ne muove le scelte e i passi.
Il Contratto Sociale Debian
Le Linee Guida Debian per il Software Libero (Debian Free Software Guidelines - DFSG)
Una versione solo in lingua inglese é contenuta nel pacchetto doc-debian.
Debian Project History
Questo manuale tratta la storia, gli scopi e le problematiche del Progetto Debian.
Breve storia di Debian
Consultabile e scaricabile in lingua italiana in diversi formati
Il manuale è disponibile nel pacchetto multilingue: debian-history.
Il sistema operativo Debian
Guida all'installazione
Il manuale descrive la procedura di installazione per installare Debian e per risolvere eventuali problemi legati all'installazione.
Guida all'installazione di Debian
Disponibile per ogni architettura supportata, consultabile e scaricabile in vari formati. Debian buster – Guida all'installazione.
É presente come pacchetto multilingue per diverse architetture. Pagina di riferimento
É necessario installare, con privilegi di amministrazione, il pacchetto relativo alla propria architettura. Ad esempio per leggere la guida sull'installazione per amd64, il pacchetto é installation-guide-amd64:
# apt install installation-guide-amd64
Il percorso della guida é usr/share/doc/installation-guide-amd64/
con ulteriori sottocartelle relative alle varie traduzioni. Pe la lingua italiana é it comprendente i formati HTML, PDF e TXT.
Debian release notes
Le note di rilascio di Debian. Vengono scritte quando una nuova versione di Debian è disponibile per il download.
Note di rilascio di Debian
Disponibile per ogni architettura supportata, consultabile e scaricabile in vari formati.
Debian reference guide
La guida di riferimento per chiunque utilizzi Debian.
Debian Reference
Consultabile e scaricabile in vari formati
Il pacchetto installabile della guida è disponibile in diverse lingue: debian-reference (versione inglese) e debian-reference-it (in italiano) nella cartella /usr/share/debian-reference
nei formati HTML, EPUB, PDF e TXT.
Debian FAQ
Le domande (e le risposte) più ricorrenti che si pone un utente Debian.
Debian FAQ
Consultabili e scaricabili in lingua italiana e in diversi formati
Il pacchetto installabile delle FAQ é disponibili in diverse lingue debian-faq (versione inglese) nella cartella /usr/share/doc/debian/FAQ
e debian-faq-it (versione italiana) nella sottocartella /usr/share/doc/debian/FAQ/it
rispettivamente, nel formato HTML, PDF, PS e TXT.
Debian Policy
Questo documento contiene tutto ciò che c'è da sapere sulla distribuzione Debian, il suo utilizzo del filesystem e i requisiti richiesti affinché un pacchetto possa aderire alle regole che Debian si è data.
Debian Policy
Consultabile e scaricabile in lingua inglese anche in altr formati
La policy di Debian è disponibile come pacchetto (in inglese) debian-policy, leggendo tutta la documentazione presente nella cartella /usr/share/doc/debian-policy
nei formati disponibili.
The Debian Administrator's Handbook
Libro che spiega come amministrare una macchina Debian. Leggere anche qui.
Il Manuale dell'Amministratore Debian
Il manuale è incluso anche nel pacchetto debian-handbook nella cartella /usr/share/doc/debian-handbook/html
in formato HTML.
Securing Debian Manual
Il manuale per configurare correttamente Debian dal punto di vista della sicurezza e per utilizzare le applicazioni necessarie a renderlo più sicuro e stabile.
Securing Debian Manual (EN)] - Manuale di sicurezza Debian
Il manuale è incluso anche nel pacchetto harden-doc, che non è presente in Debian 8 (Jessie), nella cartella /usr/share/doc/harden-doc
in formato HTML oppure compresso nei formati PDF, PS e TXT.
Documentazione dei pacchetti
Ciascun pacchetto installa i propri file di documentazione nella directory /usr/share/doc/
o nella directory /usr/share/doc-base/
.
In queste directory sono presenti, e divisi in sottodirectory, tutti i file che ciascun pacchetto mette a disposizione per documentare il proprio funzionamento.
Per conoscere quali sono i file che un pacchetto installa sul filesystem, si può ricorrere a dpkg:
$ dpkg -L nomepacchetto
Changelog.gz e Changelog.Debian.gz
È il file in cui sono contenuti tutti i cambiamenti apportati al pacchetto .deb dal suo maintainer o dall'upstreamer. Può essere visualizzato con zless
:
$ zless Changelog.gz
Copyright
È il file che contiene informazioni sulla licenza e il copyright del contenuto del pacchetto.
News
È il file in cui il maintainer può inserire le novità introdotte dalle varie versioni del pacchetto.
Readme
Il nome può trovarsi in diverse forme, ma l'unica cosa importante è che questo è un file da leggere assolutamente se si hanno problemi con un determinato pacchetto.
Questi file sono tipicamente scritti dall'upstreamer del programma. Se il maintainer del pacchetto Debian è una persona diversa, è facile che esista anche un file README.Debian o con nome simile.
Pacchetti di documentazione
Ulteriore documentazione può essere contenuta in pacchetti separati che hanno, tipicamente ma non necessariamente, nel nome l'indicazione "-doc". È caso ad esempio di "linux-doc" o di "apt-doc"; ma ne esistono tantissimi altri.
La lista può essere ottenuta a partire dal tag "role:documentation" che accompagna pacchetti di questo tipo:
$ aptitude search "?tag(documentation)"
(forma abbreviata: "~Gdocumentation"
)
È possibile utilizzare anche il solo debtags
come segue, senza ricorrere alla ricerca avanzata di aptitude
:
$ debtags search role::documentation
Notare che per effettuare una ricerca basata su tag servirà almeno uno dei pacchetti aptitude e debtags
. Per installare quello preferito, con privilegi di amministrazione è sufficiente:
# apt install aptitude # apt install debtags
Le pagine di manuale
Anche note come man pages o manpage o pagine man, sono probabilmente il tipo di documentazione più conosciuto e immediatamente accessibile a chiunque si trovi a che fare con una distribuzione Debian.
La policy di Debian impone che qualunque pacchetto o funzione o libreria utilizzata debba essere accompagnata da una pagina di manuale, per cui è sufficiente un:
$ man apt
per aprire, ad esempio, la pagina di manuale di "apt".
Le pagine di manuale si trovano nella directory /usr/share/man/
.
I file info
Alcuni pacchetti, in particolare buona parte di quelli appartenenti al Progetto GNU, possono prevedere una documentazione molto corposa oppure includere diversi comandi, ciascuno dei quali con una propria documentazione. In questo caso, accanto alla pagina di manuale, viene installato anche un file "info" che è possibile leggere con il comando "info". Ad esempio il comando:
$ info grep
permetterà di leggere il file "info" associato a grep.
Fornisce informazioni molto utili in particolare per: grub
, find
, nano
, gnupg
, wget
, grep
e sed
. Tutti i file info si trovano nella directory /usr/share/info/
.
In nuove installazioni di Debian 10 (Buster) è necessario installare il pacchetto, dato che non è più presente di default:
# apt install info
Il kernel Linux
linux-doc
Questo pacchetto contiene tutte le informazioni sulla struttura del kernel e le specifiche dei driver.
Esistono diversi pacchetti in base alla versione del kernel: linux-doc-3.2, linux-doc-4.14. linux-doc-4.18.
Kernel Hacker's Guide
Contiene, sotto forma di manpage, la documentazione sulle API del kernel Linux. Il nome di questi pacchetti è del tipo linux-manual-versione, ad esempio linux-manual-3.2, linux-manual-3.16, linux-manual-4.9 .
Il pacchetto non è più presente a partire da Debian 10 (buster).
Debian Kernel Handbook
Probabilmente la guida che bisogna assolutamente leggere se si vuol compilare un kernel per Debian, pacchettizzarlo in formato .deb o applicare una patch.
Debian Kernel Handbook
La guida è contenuta anche nel pacchetto debian-kernel-handbook.
Pacchettizzazione
Se si vuol imparare a creare un pacchetto .deb, non si può prescindere dal leggere le seguenti guide.
Guida per il nuovo Maintainer
Scritta per coloro vogliono manutenere un pacchetto Debian e che si apprestano a diventare Debian Maintainers. Spiega i passi necessari per creare un pacchetto Debian in modo che soddisfi tutti gli standard necessari per essere incluso nella distribuzione.
Guida per il nuovo maintainer
La documentazione è presente anche nei pacchetti maint-guide (in inglese) e maint-guide-it (in italiano).
Debian Developer's Reference
Scritta per i Debian Developers ma consultabile, ovviamente, da chiunque. Copre tutti gli aspetti necessari da conoscere per essere un buon DD.
Debian Developer's Reference
la guida è presente nel pacchetto developers-reference ed è disponibile in diverse lingue (inglese, tedesco, francese e giapponese).
Debian Packaging Tutorial
Semplice guida sulla pacchettizzazione in Debian. Il tutorial è corredato da molti link ed esempi e la sua lettura è fortemente consigliata per chi si accinge a creare un pacchetto Debian per la prima volta.
La documentazione si trova in formato PDF nel pacchetto packaging-tutorial ed è disponibile in diverse lingue.
I file PDF possono essere scaricati anche da qui.
Wiki Debian
Il Wiki è un ulteriore strumento messo a disposizione per fornire documentazione, howto, guide e informazioni su tutti gli aspetti che riguardano il progetto Debian, i progetti ad esso collegati e la configurazione del sistema operativo.
Il Wiki di Debian
Pagine web dei pacchetti
Ciascun pacchetto ha una pagina web in cui vengono riportate molte informazioni sulla sua funzione, sul suo stato, sui maintainers, sui bug e tanto altro.
È disponibile anche, se esiste, la homepage del programma se esso è il risultato di progetti esterni a Debian.
Ad esempio questa è la pagina web del pacchetto apt. Per effettuare una ricerca dei pacchetti o nei pacchetti, si può utilizzare https://www.debian.org/distrib/packages .
Documentazione esterna
Ogni pacchetto di Debian può essere il risultato degli sforzi degli sviluppatori per consentire alle applicazioni, non specificatamente pensate per Debian, di poter tranquillamente essere installate su una macchina Debian.
In questo caso è disponibile sempre una documentazione esterna a Debian.
Per poterla leggere, in genere è consigliabile far riferimento alle homepage dei progetti di ciascuna applicazione.
Link utili
Documentation (EN)
Documentazione (IT)
Debian Users' Manuals (EN)
Manuali del DDP per gli utenti (IT)
Guida scritta da: S3v | Debianized 60% |
Estesa da: | |
Verificata da: | |
Verificare ed estendere la guida | Cos'è una guida Debianized |