5.3. Estructura d'un paquet font

5.3.1. Format

Un paquet font normalment està compost per tres fitxers, un .dsc, un .orig.tar.gz, i un .debian.tar.xz (o .diff.gz). Permeten la creació de paquets binaris (.deb fitxers descrits anteriorment) a partir dels fitxers de codi font del programa, que estan escrits en un llenguatge de programació.

El fitxer .dsc (control de font Debian o «Debian Source Control») és un fitxer curt de text que conté una capçalera RFC 2822 (igual que el fitxer control estudiat a Secció 5.2.1, «Descripció: l'arxiu control») que descriu el paquet font i indica quins altres fitxers formen part d'aquest. Està signat pel seu mantenidor, que garanteix l'autenticitat. Vegeu Secció 6.6, «Comprovació de l'autenticitat d'un paquet» per a més detalls sobre aquest tema.

Exemple 5.1. Un arxiu .dsc

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512

Format: 3.0 (quilt)
Source: zim
Binary: zim
Architecture: all
Version: 0.75.1-1
Maintainer: Zim Package Maintainers <zim@packages.debian.org>
Uploaders: Raphaël Hertzog <hertzog@debian.org>
Homepage: https://zim-wiki.org
Standards-Version: 4.6.1
Vcs-Browser: https://salsa.debian.org/debian/zim
Vcs-Git: https://salsa.debian.org/debian/zim.git
Build-Depends: debhelper-compat (= 13), python3, python3-gi, python3-xdg, gir1.2-gtk-3.0, dh-python
Package-List:
 zim deb x11 optional arch=all
Checksums-Sha1:
 b4baa294ebc28b07393739875d94fab9557a2e5e 2510821 zim_0.75.1.orig.tar.gz
 e592c9ab8b12276283c6a7bed2246f2e9a843093 10416 zim_0.75.1-1.debian.tar.xz
Checksums-Sha256:
 88e175d7f7e141896f9e958989d252d722556af17bc4bc6f065e7d54287d0385 2510821 zim_0.75.1.orig.tar.gz
 30847b58bb2503b707f1d5c5c356eead31e61db09e677348f07383fcdda3bcb3 10416 zim_0.75.1-1.debian.tar.xz
Files:
 cc73838c1312b5e161d15a51ae4247c4 2510821 zim_0.75.1.orig.tar.gz
 ad84c5ac373071e4957490caf03f3a8b 10416 zim_0.75.1-1.debian.tar.xz

-----BEGIN PGP SIGNATURE-----
Comment: Signed by Raphael Hertzog

iQEzBAEBCgAdFiEE1823g1EQnhJ1LsbSA4gdq+vCmrkFAmO15esACgkQA4gdq+vC
mrkB4AgAj2tYiDW4aQdZfJHr/GGU9rHL99+lTL1VmrXr/I6Z8ggig0JGbTH4Z3lg
QNRu1PbFDJgdO1ho+c0b474iOsT4QTIUu9vHX/enwJ1MiQw8wGDNlsJIS+S33j5n
745p9Y782LTyKaaKPnilHst7pTIGNjmFRlqJr9E8K3gRjZjpTg6HE420epZ6haf1
+gk2npbsy2Psu1LsrbDUCa415COsogar6fpU3Kui3/p8ijT1ED1y9CqoNxATequp
nHkwpnwmi24Y5+RV79SXKW3ECOHTHGKCRWGFtSwCFg0LcAq69cTwnyphXt0gW/+Z
RtG81/jI+mMeRUGsdzdjAVlLK7K75w==
=0po3
-----END PGP SIGNATURE-----

Tingueu en compte que el paquet font també té dependències (Build-Depends) completament diferents de les dels paquets binaris, ja que indiquen les eines necessàries per compilar el programari en qüestió i construir el corresponent paquet binari.

CULTURA Per què dividir en diversos paquets

Molt sovint, un paquet font (d'un programa determinat) pot generar diversos paquets binaris. La divisió està justificada per la possibilitat d'utilitzar (parts de) el programa en diferents contextos. Considereu una biblioteca compartida, es pot instal·lar per fer que una aplicació funcioni (per exemple, libc6), o es pot instal·lar per desenvolupar un nou programa (libc6-dev serà llavors el paquet correcte). Trobem la mateixa lògica per als serveis client/servidor on volem instal·lar la part del servidor en una màquina i la part del client en altres (aquest és el cas, per exemple, de openssh-server i openssh-client).

Amb la mateixa freqüència, la documentació es proporciona en un paquet dedicat: l'usuari pot instal·lar-la independentment del programari, i en qualsevol moment pot optar per eliminar-la per estalviar espai al disc. A més, això també estalvia espai de disc als miralls Debian, ja que el paquet de documentació es compartirà entre totes les arquitectures (en lloc de tenir la documentació duplicada en els paquets per a cada arquitectura).

PERSPECTIVA Diferents formats de paquets font

Originalment només hi havia un format de paquet font. Aquest és el format 1.0, que associa un arxiu .orig.tar.gz amb una “debianització” .diff.gz (hi ha també una variant, consistent en un sol .tar.gz, que s'utilitza automàticament si no hi ha .orig.tar.gz.

Des de Debian 6 Squeeze, els desenvolupadors de Debian tenen l'opció d'utilitzar nous formats que corregeixen molts problemes del format històric. El format 3.0 (quilt) pot combinar múltiples arxius font en el mateix paquet d'origen: a més de l'habitual .orig.tar.gz, altres .orig-component.tar.gz es poden incloure. Això és útil amb programari que es distribueix en diversos components font però per als quals es desitja tenir un únic paquet font. Aquests arxius també es poden comprimir amb xz en lloc de gzip, que estalvia espai de disc i recursos de xarxa. Finalment, el pedaç monolític .diff.gz és substituït per un arxiu .debian.tar.xz que conté les instruccions de compilació i un conjunt de pedaços aportats pel mantenidor del paquet. Aquests últims es registren en un format compatible amb quilt — una eina que facilita la gestió d'una sèrie de pedaços.

El fitxer .orig.tar.gz és un arxiu que conté el codi font tal com el proporciona el desenvolupador original. Es demana als mantenidors del paquet Debian que no modifiquin aquest arxiu per tal de poder comprovar fàcilment l'origen i la integritat del fitxer (mitjançant una simple comparació de la suma de verificació) i per respectar els desitjos d'alguns autors.

El .debian.tar.xz conté totes les modificacions fetes pel mantenidor de Debian, especialment l'addició d'un directori debian que conté les instruccions a executar per construir un o més paquets Debian binaris.

EINA Descomprimint un paquet font

Si teniu un paquet font, podeu utilitzar l'ordre dpkg-source (del paquet dpkg-dev) per descomprimir-lo:

$ dpkg-source -x zim_0.75.1-1.dsc
dpkg-source: info: extracting zim in zim-0.75.1
dpkg-source: info: unpacking zim_0.75.1.orig.tar.gz
dpkg-source: info: unpacking zim_0.75.1-1.debian.tar.xz

També podeu utilitzar apt per baixar un paquet font i desempaquetar-lo directament. Requereix que les línies adequades deb-src estiguin presents en el fitxer /etc/apt/sources.list, tanmateix (per a més detalls, vegeu Secció 6.1, «Omplint el fitxer sources.list»). Aquests s'utilitzen per llistar els repositoris dels paquets font (és a dir, els servidors en els quals s'allotja un grup de paquets font).

$ apt source zim

Reading package lists... Done
NOTICE: 'zim' packaging is maintained in the 'Git' version control system at:
https://salsa.debian.org/debian/zim.git
Please use:
git clone https://salsa.debian.org/debian/zim.git
to retrieve the latest (possibly unreleased) updates to the package.
Need to get 2,523 kB of source archives.
Get:1 http://deb.debian.org/debian bookworm/main zim 0.75.1-1 (dsc) [1,580 B]
Get:2 http://deb.debian.org/debian bookworm/main zim 0.75.1-1 (tar) [2,511 kB]
Get:3 http://deb.debian.org/debian bookworm/main zim 0.75.1-1 (diff) [10.4 kB]
Fetched 2,523 kB in 0s (12.4 MB/s)
dpkg-source: info: extracting zim in zim-0.75.1
dpkg-source: info: unpacking zim_0.75.1.orig.tar.gz
dpkg-source: info: unpacking zim_0.75.1-1.debian.tar.xz

5.3.2. Ús dins de Debian

El paquet font és la base de tot a Debian. Tots els paquets de Debian provenen d'un paquet font, i cada modificació en un paquet de Debian és la conseqüència d'una modificació feta al paquet font. Els mantenidors de Debian treballen amb el paquet de codi font, sabent, però, les conseqüències de les seves accions sobre els paquets binaris. Els fruits del seu treball es troben així en els paquets d'origen disponibles de Debian: podeu tornar fàcilment a ells i tot es deriva d'ells. Capítol 15, Creació d'un paquet Debian conté alguns exemples.

Quan arriba una nova versió d'un paquet font arriba al servidor de Debian, aquest serà utilitzat per una xarxa de màquines de diferents arquitectures per a la compilació en les diverses arquitectures suportades per Debian.

→ https://buildd.debian.org/