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.73.5-1
Maintainer: Zim Package Maintainers <zim@packages.debian.org>
Uploaders: Raphaël Hertzog <hertzog@debian.org>
Homepage: https://zim-wiki.org
Standards-Version: 4.5.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:
 80d43d5c1c6a47c695079eb02bc8ad36b84d6e57 2159901 zim_0.73.5.orig.tar.gz
 b1cd86dc4819a80126efbf6ee6eba17a33f451d3 10124 zim_0.73.5-1.debian.tar.xz
Checksums-Sha256:
 a36f15d92c3994c0d55b07f83253b3d8b826beb3714865edbabc14f1cc91d63a 2159901 zim_0.73.5.orig.tar.gz
 6c2db642d9ac1c2440ed08e0cd584006045b342b255f37ffe42bd5459fb5cb76 10124 zim_0.73.5-1.debian.tar.xz
Files:
 fa76ceb8ac7d7354fb0e2bc5607e9faa 2159901 zim_0.73.5.orig.tar.gz
 a0c824d979efb196cde0176d3cb9c719 10124 zim_0.73.5-1.debian.tar.xz

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

iQEzBAEBCgAdFiEE1823g1EQnhJ1LsbSA4gdq+vCmrkFAmAa3ooACgkQA4gdq+vC
mrkq1gf/cs7irmbCSDrADVqsqYBrFJ1FyprE3jiHLNs0OQLryhFj9tzDuilX35VE
HkCfxSaKkzgvQLYtpuw1VBfhOdngTdHO39U6eljkaScnfLWU8Z5n/q+YeedxItoY
X3TtzMexFmb4WJqlylfjbXeqbLdYvsILQ3NVnE48AzkaBQlCC2d9bqecZhWiKfzq
gNxIDVDDhqCXMPe7QCErCBiFPUVpGN7b+6QWN0RxOTLZdj/slRD73rT++VmY+xN1
L8BSLcjXie+ES11MhQNYaLpCv2vqImlZaxkFWvsKBo9ndRFSbE3/RNK479a4KGve
KrdpGUJXy9uLPuAMyn5WphwXJ7OZXQ==
=YFDk
-----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.73.5-1.dsc
dpkg-source: info: extracting zim in zim-0.73.5
dpkg-source: info: unpacking zim_0.73.5.orig.tar.gz
dpkg-source: info: unpacking zim_0.73.5-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 package

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,172 kB of source archives.
Get:1 https://deb.debian.org/debian bullseye/main zim 0.73.5-1 (dsc) [1,580 B]
Get:2 https://deb.debian.org/debian bullseye/main zim 0.73.5-1 (tar) [2,160 kB]
Get:3 https://deb.debian.org/debian bullseye/main zim 0.73.5-1 (diff) [10.1 kB]
Fetched 2,172 kB in 0s (7,176 kB/s)
dpkg-source: info: extracting zim in zim-0.73.5
dpkg-source: info: unpacking zim_0.73.5.orig.tar.gz
dpkg-source: info: unpacking zim_0.73.5-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/

ANANT MÉS ENLLÀEnviament de només paquets font per part del mantenidor

Just després del llançament de Debian 10 Buster, el Release Team va anunciar que els enviaments binaris dels mantenidors ja no s'acceptaran per a main i que tots els paquets binaris d'aquest component han de ser construïts automàticament a partir dels enviaments obligatòriament només amb codi font. Mentre que els enviaments binaris encara estan permesos per als components contrib i non-free, no ens centrarem en aquesta possibilitat, ja que només hauria de ser l'excepció.