5.3. Kildepakkens struktur

5.3.1. Format

En kildepakke består vanligvis av tre filer: En .dsc, en .orig.tar.gz, og en .debian.tar.xz (eller .diff.gz). De tillater at det lages binære pakker (.deb filer beskrevet ovenfor) fra programmets kildekodefiler skrevet i et programmeringsspråk.

.dsc (Debian Source Control)-filen er en tekstfil som inneholder et RFC 2822 filhode (lik control-filen gjennomgått i Seksjon 5.2.1, «Bekrivelse; control-filen») som beskriver kildepakken og angir hvilke andre filer som inngår. Det er signert av sin vedlikeholder, som garanterer for ektheten. Se Seksjon 6.6, «Sjekking av pakkeautensitet» for flere detaljer om dette temaet.

Eksempel 5.1. En .dsc-fil

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

Merk at kildepakken også egne avhengigheter (Build-Depends) helt uavhengig av de binære pakkenes, siden de forklarer hvilke verktøy som kreves til å kompilere og lage binærpakken for programvaren det gjelder.

KULTUR Hvorfor dele opp i flere pakker

Ganske ofte kan en kildepakke (for en gitt programvare) generere flere binære pakker. Oppsplittingen er begrunnet i muligheten til å bruke (deler av) programvaren i ulike sammenhenger. Betraktet som et delt bibliotek, kan den være installert for å få et program til å virke (for eksempel, libc6), eller den kan installeres for å utvikle et nytt program (libc6-dev vil da være den riktige pakken). Vi finner den samme logikken for klient/tjener-tjenester der vi ønsker å installere tjenerdelen på en maskin og klientdelen på andre (dette er tilfellet, for eksempel for openssh-server og openssh-client).

Like ofte, når dokumentasjonen er levert i en egen pakke, kan brukeren installere den uavhengig av programvare, og kan når som helst velge å fjerne den for å spare lagringsplass. I tillegg sparer dette også plass på Debian-speilene, ettersom dokumentasjonspakken deles mellom alle arkitekturer (i stedet for å ha dokumentasjonen duplisert i pakkene for hver enkelt arkitektur).

PERSPEKTIV Ulike kilde-pakkeformater

Originalt var det bare ett kildepakkeformat. Det er 1.0-formatet, som kobler en .orig.tar.gz-tarball med en .diff.gz-«debianiserings»-patch (det er også en variant, som består av et enkelt .tar.gz-arkiv, som brukes automatisk hvis ikke .orig.tar.gz er tilgjengelig).

Etter Debian 6 Squeeze, har Debian-utviklere mulighet til å bruke nye formater som korrigerer for mange problemer i det gamle formatet. Formatet 3.0 (quilt) kan kombinere ulike oppstrøms arkiver i den samme kildepakken: I tillegg til det vanlige .orig.tar.gz, kan i tillegg .orig-komponent.tar.gz-arkiver tas med. Dette er nyttig med programvare som er fordelt på flere oppstrøms komponenter, men hvor en enkelt kildepakke trengs. Disse arkivene kan også komprimeres med xz, i stedet for gzip, som sparer lagringsplass og nettverksressurser. Til slutt, den monolittiske endringslisten,.diff.gz, er erstattet av en .debian.tar.xz-pakke med kompileringsinstruksjonene, og et sett oppstrøm endringer pakkevedlikeholderen har bidratt med. Disse siste er lagt inn i et format som er kompatibelt med quilt - et verktøy som forenkler håndteringen av en samling endringer.

.orig.tar.gz-filen er et arkiv som inneholder kildekoden som er stilt til disposisjon av den opprinnelige utvikleren. Debianpakkevedlikeholdere blir bedt om å ikke endre dette arkivet for å være i stand til enkelt å sjekke opprinnelsen og integriteten til filen (ved enkel sammenligning av sjekksum), og for å respektere ønskene til noen forfattere.

.debian.tar.xz inneholder alle endringene laget av Debians vedlikeholder, spesielt tillegget med en debian-mappe med instruksjoner til å få konstruert en eller flere Debian-pakker.

VERKTØY Å pakke ut en kildepakke

Hvis du har en kildepakke, kan du bruke dpkg-source-kommandoen (fra dpkg-dev-pakken) for å pakke den ut:

$ 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

Du kan også bruke apt for å laste ned en kildepakke og pakke den opp med en gang. Det krever at de passende deb-src-linjer er til stede i /etc/apt/sources.list-filen, (for flere detaljer se gjerne Seksjon 6.1, «Innfylling av sources.list-filen»). Disse brukes til å liste «kildene» til kildepakkene (som betyr tjenere der en gruppe kildepakker ligger).

$ 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. Bruk i Debian

Kildepakken er grunnlaget for alt i Debian. Alle Debian-pakkene kommer fra en kildepakke, og hver endring i en Debian-pakke er konsekvensen av en endring i kildepakken. Når Debians vedlikeholdere arbeider med kildepakken, er de vel vitende om konsekvensene av handlingene for de binære pakkene. Resultatet av arbeidet deres gjenfinnes derfor i kildepakkene fra Debian. Du kan enkelt gå tilbake til dem, og alt stammer derfra. Kapittel 15, Hvordan lage en Debian-pakke inneholder noen eksempler.

Når en ny versjon av en kildepakke ankommer Debian-tjeneren vil den da bli brukt av et nettverk av maskiner med de forskjelligee kompileringsarkitekturene som støttes av Debian.

→ https://buildd.debian.org/