5.3. Structuur van een Bron Pakket

5.3.1. Vorm

A source package is usually comprised of three files, a .dsc, a .orig.tar.gz, and a .debian.tar.xz (or .diff.gz). They allow creation of binary packages (.deb files described above) from the source code files of the program, which are written in a programming language.

Het .dsc (Debian Source Control) bestand is een kort tekst bestand dat een RFC 2822 header bevat (net zoals het control bestand bestudeert in Paragraaf 5.2.1, “Omschrijving: het control Bestand”) welke het bron pakket omschrijft en aangeeft welke andere bestanden er deel van uitmaken. Het is gesigneerd door de onderhouder, welke de authenticiteit garandeert. Zie Paragraaf 6.6, “Pakket Authenticiteit Controleren” voor meer details over dit onderwerp.

Voorbeeld 5.1. Een .dsc bestand

-----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-----

Merk op dat het bron pakket ook afhankelijkheden (Build-Depends) heeft. Volledig gescheiden van deze van binaire pakketten, omdat ze het nodige gereedschap om de software in kwestie te compileren en haar binaire bestand te maken aangeeft.

LET OP Onderscheidende namen

Het is belangrijk om hier te melden dat er geen vereiste correspondentie tussen de naam van het bron pakket en dat van het binaire pakket(ten) welke het genereert noodzakelijk is. Het is gemakkelijk te begrijpen als je weet dat ieder bron pakket verschillende binaire pakketten kan genereren. Dit is waarom het .dsc bestand de Source en Binary velden om de naam van het bron pakket expliciet uit te drukken en een lijst te bewaren met binaire pakketten die het genereert.

CULTUUR Waarom onderverdelen in meerdere pakketten

Redelijk frequent kan een bron pakket (voor bepaalde software) meerdere binaire pakketten genereren. De opsplitsing is verantwoord door de mogelijkheid de software (of onderdelen ervan) te gebruiken in een andere context. Neen een gedeelde bibliotheek, het kan geïnstalleerd worden om een programma te laten werken (bij voorbeeld, libc6), of het kan geïnstalleerd worden om een nieuw programma te ontwikkelen (libc6-dev zal dan het correcte pakket zijn). We zien dezelfde logica voor cliënt/server diensten waar we het server gedeelte willen installeren op één machine en het cliënt gedeelte op anderen (dit is zo, bij voorbeeld, bij openssh-server en openssh-client.

Just as frequently, the documentation is provided in a dedicated package: the user may install it independently from the software, and may at any time choose to remove it to save disk space. Additionally, this also saves disk space on the Debian mirrors, since the documentation package will be shared among all of the architectures (instead of having the documentation duplicated in the packages for each architecture).

RESPECTIEVELIJK Verschillende formaten van bron pakketten

In het begin was er enkel één formaat van bron pakket. Dit is het 1.0 formaat, welke een .orig.tar.gz archief verbind aan een .digg.gz “debianization” patch (er is ook een variant die bestaat uit een enkel .tar.gz archief, welke automatische gebruikt wordt als er geen .orig.tar.gz beschikbaar is).

Sinds Debian 6Squeeze hebben Debian ontwikkelaars de mogelijkheid om nieuwe formaten, die problemen van het historische corrigeren, te gebruiken. Formaat 3.0 (quilt) kan meerdere upstream archieven in het zelfde bron pakket bevatten: bovenop het gebruikelijke orig.tar.gz kunnen aanvullende .orig-component.tar.gz archieven bijgevoegd worden. Dit is handig met software die in verschillende upstream componenten verdeeld wordt, maar voor welke een enkel bron pakket gewenst is. Deze archieven kunnen ook gecomprimeerd zijn met xz in plaats van gzip, welke schijfruimte en netwerk middelen besparen. Tenslotte het monolithische patch, .diff.gz is vervangen door een debian.tar.xz archief dat de compileer instructies en een set van upstream patches bijgedragen door de pakket beheerder bevat. Deze laatste zijn opgenomen in een formaat compatibel met quilt — een tool die het beheren van een reeks pakketten faciliteert.

Het .orig.tar.gz bestand is een archief dat de bron code zoals voorzien door de originele ontwikkelaar bevat.Debian pakket onderhouders worden gevraagd om deze niet aan te passen om zo de mogelijkheid te hebben om de origine en integriteit van het pakket te controleren (door eenvoudige vergelijking met een checksum) en om de wensen van bepaalde auteurs te respecteren.

The .debian.tar.xz contains all of the modifications made by the Debian maintainer, especially the addition of a debian directory containing the instructions to execute to construct one or more Debian binary packages.

GEREEDSCHAP Decompressie van een bron pakket

Als je een bron pakket hebt, kun je het dpkg-source commando (van het dpkg-dev pakket) gebruiken om het te decomprimeren:

$ 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

Je kunt ook apt gebruiken om een bron pakket te downloaden en op de juiste manier uit te pakken. Dit vereist wel dat de geschikte deb-src regels in het /etc/apt/sources.list bestand aanwezig zijn (voor meer informatie zie Paragraaf 6.1, “Het sources.list Bestand Invullen”). Deze worden gebruikt om een lijst van “bronnen” van bron pakketten te maken (dit betekent de servers waarop een groep van bron pakketten geherbergd worden).

$ 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. Gebruik binnen Debian

The source package is the foundation of everything in Debian. All Debian packages come from a source package, and each modification in a Debian package is the consequence of a modification made to the source package. The Debian maintainers work with the source package, knowing, however, the consequences of their actions on the binary packages. The fruits of their labors are thus found in the source packages available from Debian: you can easily go back to them and everything stems from them. Hoofdstuk 15, Het creëren van een Debian Pakket contains some examples.

When a new version of a source package arrives on the Debian server, it will then be used by a network of machines of different architectures for compilation on the various architectures supported by Debian.

→ https://buildd.debian.org/