dpkg
e apt
che un determinato pacchetto è installato anche se è soltanto un guscio vuoto. Questo permette di soddisfare le dipendenze di un pacchetto quando il software corrispondente è installato al di là delle scopo del sistema di pacchettizzazione. Questo sistema funziona, ma dovrebbe comunque essere evitato quando possibile, dato che non c'è alcuna garanzia che il software installato manualmente si comporti esattamente come il pacchetto corrispondente e i pacchetti che dipendono da esso potrebbero non funzionare correttamente.
equivs-control
e equivs-build
(nel pacchetto equivs). Il comando equivs-control file
crea un file d'intestazione del pacchetto Debian che dovrebbe essere modificato per contenere il nome del pacchetto, il numero di versione, il nome del manutentore, le dipendenze e la descrizione. Gli altri campi senza un valore predefinito sono opzionali e possono essere eliminati. I campi Copyright
, Changelog
, Readme
e Extra-Files
non sono campi standard nei pacchetti Debian, hanno senso solo nell'ambito di equivs-build
e non saranno conservati nelle intestazioni del pacchetto generato.
Esempio 15.2. File d'intestazione del pacchetto finto libxml-libxml-perl
Section: perl Priority: optional Standards-Version: 4.5.1 Package: libxml-libxml-perl Version: 2.0207-1 Maintainer: Raphael Hertzog <hertzog@debian.org> Depends: libxml2 (>= 2.9.10) Architecture: all Description: Fake package - module manually installed in site_perl This is a fake package to let the packaging system believe that this Debian package is installed. . In fact, the package is not installed since a newer version of the module has been manually compiled & installed in the site_perl directory.
equivs-build file
. Voilà: il pacchetto viene creato nella directory corrente e può essere gestito come qualsiasi altro pacchetto Debian.
$
equivs-build file
equivs-build control dpkg-buildpackage: info: source package libxml-libxml-perl dpkg-buildpackage: info: source version 2.0207-1 dpkg-buildpackage: info: source distribution unstable dpkg-buildpackage: info: source changed by Raphael Hertzog <hertzog@debian.org> dpkg-buildpackage: info: host architecture amd64 dpkg-source --before-build . debian/rules clean dh clean dh_clean debian/rules binary dh binary dh_update_autotools_config dh_autoreconf create-stamp debian/debhelper-build-stamp dh_prep dh_install dh_installdocs dh_installchangelogs dh_perl dh_link dh_strip_nondeterminism dh_compress dh_fixperms dh_missing dh_installdeb dh_gencontrol dh_md5sums dh_builddeb dpkg-deb: building package 'libxml-libxml-perl' in '../libxml-libxml-perl_2.0207-1_all.deb'. dpkg-genbuildinfo --build=binary dpkg-genchanges --build=binary >../libxml-libxml-perl_2.0207-1_amd64.changes dpkg-genchanges: info: binary-only upload (no source code included) dpkg-source --after-build . dpkg-buildpackage: info: binary-only upload (no source included) Il pacchetto è stato creato. Attenzione, il pacchetto è stato creato nella directory attuale, non in ".." come indicato nel messaggio sovrastante!
falcot-data-1.0
che conterrà il sorgente del pacchetto interessato. Il nome del pacchetto sarà logicamente falcot-data
con il numero di versione 1.0
. L'amministratore mette i file dei documenti nella sotto-directory data
. Dopo viene eseguito il comando dh_make
(dal pacchetto dh-make) per aggiungere i file necessari per il processo di generazione del pacchetto, che saranno memorizzati nella sotto-directory debian
:
$
cd falcot-data-1.0
$
dh_make --native
Tipo di pacchetto: (single, indep, library, python) [s/i/l/p]?
i
Maintainer Name : Raphael Hertzog Email-Address : hertzog@debian.org Date : Sat, 26 Feb 2021 13:02:06 +0100 Package Name : falcot-data Version : 1.0 License : gpl3 Package Type : indep I dettagli sono corretti? [Y/n/q] Attualmente non esiste un Makefile di primo livello. Potrebbe essere necessaria un'ulteriore sistemazione. Fatto. Modificare i file nella sottodirectory debian/. $
Architecture: all
in debian/control
). Al contrario, single crea un singolo pacchetto binario che dipende dall'architettura di destinazione (Architecture: any
). In questo caso, la prima scelta è più pertinente, poiché il pacchetto contiene solo documenti e nessun programma binario, quindi può essere usato in modo simile su computer di tutte le architetture.
dh_make
crea la sotto-directory debian
con all'interno molti file. Alcuni sono necessari, in particolare i file rules
, control
, changelog
e copyright
. I file con estensione .ex
sono file di esempio che all'occorrenza possono essere utilizzati modificandoli (rimuovendo anche l'estensione). Quando non sono necessari, si raccomanda di rimuoverli. Il file compat
non viene più utilizzato né creato. Invece di definire il livello di compatibilità di debhelper come un numero in questo file, ora è definito come una dipendenza dalla compilazione del pacchetto virtuale debhelper-compat nel file Build-Depends
in debian/control
.
copyright
deve contenere informazioni relative agli autori dei documenti inclusi nel pacchetto e i relativi copyright e licenza. Nel nostro caso, si tratta di documenti interni e il loro uso è ristretto all'interno della società Falcot Corp. Il formato predefinito usato per questo file è specificato nel campo Format
.
changelog
predefinito è generalmente appropriato; è sufficiente sostituire il "rilascio iniziale" con una spiegazione più prolissa e modificare la distribuzione da NON RILASCIATO
o instabile
al nome di rilascio.
control
deve essere aggiornato: il campo Section
può essere cambiato in misc e i campi Homepage
, Vcs-Git
e Vcs-Browser
sono stati rimossi. Il campo Depends
è stato completato con firefox-esr | www-browser
in modo da garantire la disponibilità di un browser web in grado di visualizzare i documenti del pacchetto. Se il pacchetto non richiede l'esecuzione di comandi come root (vedere STRUMENTO fakeroot
), il campo Rules-Requires-Root
può essere lasciato invariato.
Esempio 15.3. Il file control
Source: falcot-data Section: misc Priority: optional Maintainer: Raphael Hertzog <hertzog@debian.org> Build-Depends: debhelper-compat (= 13) Standards-Version: 4.5.1 Rules-Requires-Root: no Package: falcot-data Architecture: all Depends: firefox-esr | www-browser, ${misc:Depends} Description: Internal Falcot Corp Documentation This package provides several documents describing the internal structure at Falcot Corp. This includes: - organization diagram - contacts for each department. . These documents MUST NOT leave the company. Their use is INTERNAL ONLY.
Esempio 15.4. Il file changelog
falcot-data (1.0) bullseye; urgency=low * Rilascio Iniziale. * Iniziamo con pochi documenti: - struttura interna della società; - contratti per ogni dipartimento. -- Raphael Hertzog <hertzog@debian.org> Sat, 26 Feb 2022 15:12:06 +0100
Esempio 15.5. Il file copyright
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ Upstream-Name: falcot-data Files: * Copyright: 2004-2021 Falcot Corp Licenza: Tutti i diritti riservati.
rules
di solito contiene un insieme di regole utilizzate per configurare, compilare e installare il software in una sotto-directory dedicata (con il nome del pacchetto binario generato). Il contenuto di questa sotto-directory viene archiviato all'interno del pacchetto Debian, come se fosse la radice del file system. In questo caso, i file verranno installati netta sotto-directory debian/falcot-data/usr/share/falcot-data/
, in modo che l'installazione del pacchetto generato metta i file in /usr/share/falcot-data/
. Il file rules
viene utilizzato come un Makefile
, con alcuni obbiettivi predefiniti (compresi clean
e binary
, utilizzati rispettivamente per pulire la directory dei sorgenti e per generare il pacchetto binario).
debhelper
. Questo è il caso per i file generati da dh_make
. Per installare i file interessati, bisogna semplicemente configurare il comportamento del comando dh_install
creando il seguente file debian/falcot-data.install
:
data/* usr/share/falcot-data/
falcot-data.desktop
e lo si installa in /usr/share/applications
aggiungendo una seconda riga a debian/falcot-data.install
.
Esempio 15.6. Il file falcot-data.desktop
[Desktop Entry] Name=Internal Falcot Corp Documentation Comment=Starts a browser to read the documentation Exec=x-www-browser /usr/share/falcot-data/index.html Terminal=false Type=Application Categories=Documentation;
debian/falcot-data.install
è simile a questa:
data/* usr/share/falcot-data/ falcot-data.desktop usr/share/applications/
dpkg-buildpackage -us -uc
all'interno della directory falcot-data-1.0
.