.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "dsc 5" .TH dsc 5 2024-01-19 1.22.3 "dpkg suite" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH NAAM .IX Header "NAAM" dsc \- Indeling van het controlebestand van Debian-broncodepakketten .SH OVERZICHT .IX Header "OVERZICHT" \&\fIbestandsnaam\fR\fB.dsc\fR .SH BESCHRIJVING .IX Header "BESCHRIJVING" Elk Debian-broncodepakket bestaat uit een .dsc\-controlebestand, dat een aantal velden bevat volgens de indeling \fBdeb822\fR\|(5). .PP Ieder veld begint met een markering, zoals \fBSource\fR of \fBBinary\fR (niet hoofdlettergevoelig), gevolgd door een dubbele punt en de tekstinhoud van het veld (hoofdlettergevoelig tenzij anders vermeld). Velden worden enkel door veldmarkeringen begrensd. De tekstinhoud van het veld kan met andere woorden verschillende regels lang zijn, maar de installatiegereedschappen zullen bij het verwerken van de tekstinhoud de regels gewoonlijk samenvoegen (behalve in het geval van de multiregel-velden \fBPackage-List\fR, \fBFiles\fR, \fBChecksums\-Sha1\fR en \fBChecksums\-Sha256\fR; zie hierna) .PP De controle-data mogen ingesloten liggen in een OpenPGP-handtekening met ASCII-harnas volgens de specificatie RFC4880. .SH VELDEN .IX Header "VELDEN" .IP "\fBFormat:\fR \fIindelingsversie\fR (verplicht)" 4 .IX Item "Format: indelingsversie (verplicht)" De waarde van dit veld declareert de indelingsversie van het broncodepakket. De veldwaarde wordt door programma's die met een broncodepakket werken, gebruikt om de bestandenlijst in het broncodepakket te interpreteren en te bepalen hoe het uitgepakt moet worden. De syntaxis van de veldwaarde is: een numerieke hoofdversie (\(lq0\-9\(rq), een punt (\(lq.\(rq), een numerieke onderversie (\(lq0\-9\(rq), en dan eventueel na witruimte (\(lq \et\(rq) een subtype dat, als het opgegeven wordt, bestaat uit een alfanumeriek (\(lqa\-z0\-9\(rq) woord tussen haakjes (\(lq()\(rq). Vanuit het oogpunt van syntaxis is het subtype optioneel, maar voor specifieke revisies van de indeling van broncodepakketten kan het een verplicht onderdeel zijn. .Sp De indelingen van de broncode die momenteel ondersteund worden door \fBdpkg\fR zijn \fB1.0\fR, \fB2.0\fR, \fB3.0 (native)\fR, \fB3.0 (quilt)\fR, \fB3.0 (git)\fR, \fB3.0 (bzr)\fR en \fB3.0 (custom)\fR. Raadpleeg \fBdpkg\-source\fR\|(1) voor de beschrijving ervan. .IP "\fBSource:\fR \fIbroncode-naam\fR (verplicht)" 4 .IX Item "Source: broncode-naam (verplicht)" De waarde van dit veld bepaalt de pakketnaam en wordt door de meeste installatiegereedschappen gebruikt om bestandsnamen te genereren. .IP "\fBBinary:\fR \fIlijst-van-binaire-pakketten\fR" 4 .IX Item "Binary: lijst-van-binaire-pakketten" Dit gevouwen veld somt, door komma's van elkaar gescheiden, de binaire pakketten op die door dit broncodepakket gebouwd kunnen worden. .Sp Dit veld is nu vervangen door het veld \fBPackage-List\fR dat voldoende informatie geeft over welke binaire pakketten op welke architecturen geproduceerd worden, over bouwprofielen en over andere restricties die van belang zijn. .IP "\fBArchitecture:\fR \fIarch-lijst\fR (aanbevolen)" 4 .IX Item "Architecture: arch-lijst (aanbevolen)" Een lijst van door spaties van elkaar gescheiden architecturen en architectuurjokertekens die aangeven voor welk type hardware dit pakket gecompileerd kan worden. Gebruikelijke architectuurnamen en architectuurjokertekens zijn \fBamd64\fR, \fBarmel\fR, \fBi386\fR, \fBlinux-any\fR, \fBany\-amd64\fR, enz. .Sp Merk op dat de waarde \fBall\fR bedoeld is voor pakketten die architectuuronafhankelijk zijn en \fBany\fR voor pakketten die architectuurafhankelijk zijn. De lijst mag de speciale waarde \fBall\fR bevatten (of er uitsluitend uit bestaan). Wanneer de lijst het architectuurjokerteken \fBany\fR bevat, is \fBall\fR de enige andere toegelaten waarde in de lijst. .Sp De waarde van dit veld wordt gewoonlijk gegenereerd op basis van de \fBArchitecture\fR\-velden in het bestand \fIdebian/control\fR van het broncodepakket. .IP "\fBVersion:\fR \fIversie-tekenreeks\fR (verplicht)" 4 .IX Item "Version: versie-tekenreeks (verplicht)" Gewoonlijk is dit het originele versienummer van het pakket, welke vorm de auteur van het programma er ook voor gebruikt. Het kan ook een Debian-revisienummer bevatten (voor niet uit Debian stammende pakketten). De exacte indeling en het sorteringsalgoritme worden beschreven in \fBdeb\-version\fR\|(7). .IP "\fBOrigin:\fR \fInaam\fR" 4 .IX Item "Origin: naam" De naam van de distributie waaruit dit pakket afkomstig is. .IP "\fBMaintainer:\fR \fIvolledige-naam-en-e-mail\fR (aanbevolen)" 4 .IX Item "Maintainer: volledige-naam-en-e-mail (aanbevolen)" Moet opgemaakt worden volgens de indeling \(lqJoe Bloggs \(rq, en is gewoonlijk de persoon die het pakket maakte, in tegenstelling tot de auteur van de verpakte software. .IP "\fBUploaders:\fR \fIlijst van volledige-namen-en-e-mailadressen\fR" 4 .IX Item "Uploaders: lijst van volledige-namen-en-e-mailadressen" Somt al de namen en de e\-mailadressen op van de personen die het pakket mee onderhouden volgens dezelfde indeling als van het veld \fBMaintainer\fR. Meerdere mede-beheerders moeten onderling door een komma gescheiden worden. .IP "\fBDescription:\fR \fIkorte-beschrijving\fR" 4 .IX Item "Description: korte-beschrijving" .PD 0 .IP "\ \fIuitgebreide-beschrijving\fR" 4 .IX Item " uitgebreide-beschrijving" .PD De indeling van een pakketbeschrijving bestaat uit een beknopte korte samenvatting op de eerste regel (na de veldmarkering \fBDescription\fR). De daaropvolgende regels moeten gebruikt worden voor een langere, meer gedetailleerde beschrijving. Elke regel van de uitgebreide beschrijving moet voorafgegaan worden door een spatie, en lege regels in de uitgebreide beschrijving moeten \('e\('en enkele \(oq\fB.\fR\(cq bevatten die volgt op de eraan voorafgaande spatie. .IP "\fBHomepage:\fR \fIURL\fR" 4 .IX Item "Homepage: URL" De \fIURL\fR van de homepage van het toeleverend project (upstream). .IP "\fBStandards-Version:\fR \fIversietekenreeks\fR (aanbevolen)" 4 .IX Item "Standards-Version: versietekenreeks (aanbevolen)" Dit documenteert de meest recente versie van de normen die vastgelegd werden in de richtlijnen van de distributie en waaraan dit pakket voldoet. .IP "\fBVcs-Browser:\fR \fIURL\fR" 4 .IX Item "Vcs-Browser: URL" De \fIurl\fR van een webinterface waarmee door de opslagruimte van het versiecontrolesysteem kan gebladerd worden. .IP "\fBVcs-Arch:\fR \fIURL\fR" 4 .IX Item "Vcs-Arch: URL" .PD 0 .IP "\fBVcs-Bzr:\fR \fIURL\fR" 4 .IX Item "Vcs-Bzr: URL" .IP "\fBVcs-Cvs:\fR \fIURL\fR" 4 .IX Item "Vcs-Cvs: URL" .IP "\fBVcs-Darcs:\fR \fIURL\fR" 4 .IX Item "Vcs-Darcs: URL" .IP "\fBVcs-Git:\fR \fIURL\fR" 4 .IX Item "Vcs-Git: URL" .IP "\fBVcs-Hg:\fR \fIURL\fR" 4 .IX Item "Vcs-Hg: URL" .IP "\fBVcs-Mtn:\fR \fIURL\fR" 4 .IX Item "Vcs-Mtn: URL" .IP "\fBVcs-Svn:\fR \fIURL\fR" 4 .IX Item "Vcs-Svn: URL" .PD Deze velden declareren de \fIurl\fR van de opslagruimte van het versiecontrolesysteem dat gebruikt wordt om dit pakket te onderhouden. Zie \fBdeb\-src\-control\fR\|(5) voor verdere informatie. .IP "\fBTestsuite:\fR \fInamenlijst\fR" 4 .IX Item "Testsuite: namenlijst" Dit veld declareert dat het broncodepakket de opgegeven testsuites bevat. De waarde is een lijst van onderling door komma's gescheiden testsuites. Indien de waarde \fBautopkgtest\fR bestaat, wordt verondersteld dat het bestand \fIdebian/tests/control\fR bestaat. Indien het bestand bestaat, maar de waarde niet, dan zal \fBdpkg-source\fR die automatisch toevoegen met behoud van de vroegere waarden. .IP "\fBTestsuite-Triggers:\fR \fIpakketlijst\fR" 4 .IX Item "Testsuite-Triggers: pakketlijst" Dit veld declareert de door komma's gescheiden unie van alle testvereisten (de velden \fBDepends\fR uit het bestand \fIdebian/tests/control\fR), waaruit alle restricties verwijderd en alle OR-vereisten uitgevlakt werden (dit betekent omgezet naar aparte AND-relaties), uitgezonderd voor de binaire pakketten, gegenereerd door dit broncodepakket en het equivalent van zijn meta-vereiste \fB@\fR. .Sp \&\fBMotivering\fR: dit veld is noodzakelijk omdat anders elk broncodepakket uitgepakt zou moeten worden om de testvereisten te kunnen achterhalen. .IP "\fBBuild-Depends:\fR \fIpakketlijst\fR" 4 .IX Item "Build-Depends: pakketlijst" .PD 0 .IP "\fBBuild-Depends-Arch:\fR \fIpakketlijst\fR" 4 .IX Item "Build-Depends-Arch: pakketlijst" .IP "\fBBuild-Depends-Indep:\fR \fIpakketlijst\fR" 4 .IX Item "Build-Depends-Indep: pakketlijst" .IP "\fBBuild-Conflicts:\fR \fIpakketlijst\fR" 4 .IX Item "Build-Conflicts: pakketlijst" .IP "\fBBuild-Conflicts-Arch:\fR \fIpakketlijst\fR" 4 .IX Item "Build-Conflicts-Arch: pakketlijst" .IP "\fBBuild-Conflicts-Indep:\fR \fIpakketlijst\fR" 4 .IX Item "Build-Conflicts-Indep: pakketlijst" .PD Deze velden declareren de relaties tussen het broncodepakket en de pakketten die gebruikt worden om het te bouwen. Zij worden besproken in de man-pagina \fBdeb\-src\-control\fR\|(5). .IP \fBPackage-List:\fR 4 .IX Item "Package-List:" .PD 0 .IP "\ \fIpakket\fR \fIpakkettype\fR \fIsectie\fR \fIprioriteit\fR \fItrefwoord-waarde-lijst\fR" 4 .IX Item " pakket pakkettype sectie prioriteit trefwoord-waarde-lijst" .PD Dit multiregel-veld bevat een lijst van binaire pakketten die door dit broncodepakket gegenereerd worden. .Sp Het element \fIpakket\fR is de naam van het binaire pakket. .Sp Het element \fIpakket-type\fR is het type van het binaire pakket, meestal \fBdeb\fR; een andere gebruikelijke waarde is \fBudeb\fR. .Sp De elementen \fIsectie\fR (section) en \fIprioriteit\fR (priority) komen overeen met de velden met dezelfde naam van het binaire pakket. .Sp Het element \fItrefwoord-waarde-lijst\fR is een lijst van door spaties gescheiden \fItrefwoord\fR\fB=\fR\fIwaarde\fR en de momenteel herkende optionele trefwoorden zijn: .RS 4 .IP \fBarch\fR 4 .IX Item "arch" De architectuurrestrictie uit het veld \fBArchitecture\fR van het binaire pakket, waarbij spaties naar \(oq,\(cq geconverteerd worden. .IP \fBprofile\fR 4 .IX Item "profile" De genormaliseerde bouwprofiel-restrictieformule uit het veld \fBBuild-Profile\fR van het binaire pakket, waarbij OR's omgezet worden naar \(oq+\(cq en AND's naar \(oq,\(cq. .IP \fBprotected\fR 4 .IX Item "protected" Indien het binaire pakket beschermd (protected) is, zal dit trefwoord de waarde hebben van het veld \fBProtected\fR, wat een waarde \fByes\fR is. .Sp Ondersteund sinds dpkg 1.20.1. .IP \fBessential\fR 4 .IX Item "essential" Indien het binaire pakket essentieel (essential) is, zal dit trefwoord de waarde hebben van het veld \fBEssential\fR en dat is de waarde \fByes\fR. .RE .RS 4 .RE .IP "\fBFiles:\fR (verplicht)" 4 .IX Item "Files: (verplicht)" .PD 0 .IP "\fBChecksums\-Sha1:\fR (verplicht)" 4 .IX Item "Checksums-Sha1: (verplicht)" .IP "\fBChecksums\-Sha256:\fR (verplicht)" 4 .IX Item "Checksums-Sha256: (verplicht)" .IP "\ \fIcontrolesom\fR \fIgrootte\fR \fIbestandsnaam\fR" 4 .IX Item " controlesom grootte bestandsnaam" .PD Deze multiregel-velden bevatten een lijst van bestanden met voor elk van hen een controlesom en een grootte. Deze velden hebben een identieke syntaxis en verschillen onderling enkel inzake het gebruikte algoritme voor de controlesom: MD5 voor \fBFiles\fR, SHA\-1 voor \fBChecksums\-Sha1\fR en SHA\-256 voor \fBChecksums\-Sha256\fR. .Sp De eerste regel van de veldwaarde (het deel dat op dezelfde regel staat als de door een dubbele punt gevolgde veldnaam) is steeds leeg. De inhoud van het veld wordt in de vervolgregels verwoord, \('e\('en regel per bestand. Elke regel bestaat uit de controlesom, een spatie, de bestandsgrootte, een spatie en de bestandsnaam. .Sp Deze velden sommen alle bestanden op die deel uitmaken van het broncodepakket. De lijst bestanden in deze velden moet overeenkomen met de lijst bestanden in de andere verwante velden. .SH BUGS .IX Header "BUGS" Het veld \fBFormat\fR combineert de indeling van het \fB.dsc\fR\-bestand zelf en de indeling van het uitgepakte broncodepakket. .SH "ZIE OOK" .IX Header "ZIE OOK" \&\fBdeb822\fR\|(5), \fBdeb\-src\-control\fR\|(5), \fBdeb\-version\fR\|(7), \fBdpkg\-source\fR\|(1).