dpkg i apt perquè creguin que algun paquet està instal·lat encara que només sigui una consola buida. Això permet satisfer les dependències d'un paquet quan el programari corresponent s'ha instal·lat fora de l'àmbit del sistema de paquets. Aquest mètode funciona, però ha d'evitar-se sempre que sigui possible, ja que no hi ha cap garantia que el programari instal·lat manualment es comporti exactament com ho faria el paquet corresponent i altres paquets depenent d'ell no funcionarien correctament.
equivs-control i equivs-build (al paquet equivs). L'ordre equivs-control fitxer crea un fitxer de capçalera de paquet de Debian que s'ha d'editar per incloure el nom del paquet esperat, el seu número de versió, el nom del mantenidor, les seves dependències i la seva descripció. Altres camps sense un valor per defecte són opcionals i es poden suprimir. Els camps Copyright, Changelog, Readmei Extra-Files no són camps estàndard en paquets de Debian; només tenen sentit dins de l'àmbit d'aplicació d'equivs-build, i no es mantindran a les capçaleres del paquet generat.
Exemple 15.2. Fitxer de capçalera del paquet fals 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 fitxer. Voilà: el paquet es crea al directori actual i es pot gestionar com qualsevol altre paquet de Debian.
$equivs-build fileequivs-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) The package has been created. Attention, the package has been created in the current directory, not in ".." as indicated by the messaige above!
falcot-data-1.0 que contindrà el paquet amb les fonts. El paquet lògicament s'anomenarà falcot-data i tindrà el número de versió 1.0. L'administrador col·loca els documents en un subdirectori data. Llavors invoquen l'ordre dh_make (del paquet dh-make) per afegir els fitxers requerits pel procés de generació de paquets, que s'emmagatzemaran en un subdirectori debian:
$cd falcot-data-1.0$dh_make --nativeType of package: (single, indep, library, python) [s/i/l/p]?iMaintainer 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 Are the details correct? [Y/n/q] Currently there is not top level Makefile. This may require additional tuning Done. Please edit the files in the debian/ subdirectory now. $
Architecture: all a debian/control). single actua com a contrapartida, i duu a un únic paquet binari que depèn de l'arquitectura de destinació (Architecture: any). En aquest cas, l'opció primera és més rellevant, ja que el paquet només conté documents i no hi ha programes binaris, de manera que es pot utilitzar de manera similar en ordinadors de totes les arquitectures.
dh_make crea un subdirectori debian amb molts fitxers. Alguns són necessaris, en particular rules, control, changelog i copyright. Els fitxers amb l'extensió .ex són fitxers d'exemple que es poden utilitzar modificant-los (i eliminant l'extensió) quan sigui apropiat. Quan no són necessaris, es recomana eliminar-los. El fitxer compat ja no s'usa. En lloc de definir el nivell de compatibilitat de «debhelper» com un número en aquest fitxer, ara està definit com una «build-dependency» (o “dependència de compilació”) sobre el paquet virtual debhelper-compat al fitxer Build-Depends de debian/control.
copyright ha de contenir informació sobre els autors dels documents inclosos al paquet, i els drets d'autor i llicència relacionats. En el nostre cas, es tracta de documents interns i el seu ús es limita a l'empresa Falcot Corp. El format predeterminat utilitzat per a aquest fitxer es defineix al camp Format.
changelog és generalment apropiat; substituir l'«Initial release» (o “versió inicial”) per una explicació més detallada, i canviar la distribució de UNRELEASED o Unstable pel nom la versió de destinació és suficient.
control també s'ha d'actualitzar: el camp Section es pot canviar per misc i els camps Homepage, Vcs-Git i Vcs-Browser van ser eliminats. Els camps Depends es van completar amb firefox-esr | www-browser per assegurar la disponibilitat d'un navegador web capaç de mostrar els documents del paquet. Si el paquet no requereix executar cap ordre com a superusuari (vegeu EINA fakeroot), el camp Rules-Requires-Root es pot deixar com està.
Exemple 15.3. El fitxer 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.
Exemple 15.4. El fitxer changelog
falcot-data (1.0) bullseye; urgency=low
* Initial Release.
* Let's start with few documents:
- internal company structure;
- contacts for each department.
-- Raphael Hertzog <hertzog@debian.org> Sat, 26 Feb 2022 15:12:06 +0100
Exemple 15.5. El fitxer copyright
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ Upstream-Name: falcot-data Files: * Copyright: 2004-2021 Falcot Corp License: All rights reserved.
rules normalment conté un conjunt de regles utilitzades per configurar, compilar i instal·lar el programari en un subdirectori dedicat (anomenat com el paquet binari generat). El contingut d'aquest subdirectori s'arxiva després dins del paquet Debian com si fos l'arrel del sistema de fitxers. En el nostre cas, els fitxers s'instal·laran al subdirectori debian/falcot-data/usr/share/falcot-data/, de manera que instal·lant el paquet generat es desplegaran els fitxers sota /usr/share/falcot-data/. El fitxer rules s'utilitza com a Makefile, amb alguns «targets» o “objectius” estàndard (incloent-hi clean i binary, utilitzats respectivament per netejar el directori d'origen i generar el paquet binari).
debhelper. Aquest és el cas dels fitxers generats per dh_make. Per instal·lar els nostres fitxers, simplement es configura el comportament de l'ordre dh_install creant el següent fitxer debian/falcot-data.install:
data/* usr/share/falcot-data/
falcot-data.desktop i s'instal·la a /usr/share/applications afegint una segona línia a debian/falcot-data.install.
Exemple 15.6. El fitxer 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 queda així:
data/* usr/share/falcot-data/ falcot-data.desktop usr/share/applications/
dpkg-buildpackage -us -uc des del directori falcot-data-1.0.