Provided by: dpkg-dev_1.19.0.5ubuntu2.4_all 
NAAM
dsc - Indeling van het controlebestand van Debian-broncodepakketten
OVERZICHT
bestandsnaam.dsc
BESCHRIJVING
Elk Debian broncodepakket bevat een .dsc-controlebestand dat uit een aantal velden
bestaat. Ieder veld begint met een markering, zoals Source of Binary (niet
hoofdlettergevoelig), gevolgd door een dubbele punt en de tekstinhoud van het veld. 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 Package-List, Files, Checksums-Sha1 en Checksums-Sha256; zie hierna)
De controle-data mogen ingesloten liggen in een OpenPGP-handtekening met ASCII-harnas
volgens de specificatie RFC4880.
VELDEN
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
bestandslijst in het broncodepakket te interpreteren en te bepalen hoe het
uitgepakt moet worden. De syntaxis van de veldwaarde is: een numerieke hoofdversie,
een punt, een numerieke onderversie, en dan eventueel na witruimte een subtype dat,
als het opgegeven wordt, bestaat uit een alfanumeriek woord tussen haakjes. Vanuit
het oogpunt van syntaxis is het subtype optioneel, maar voor specifieke revisies
van de indeling van broncodepakketten kan het een verplicht onderdeel zijn.
De indelingen van broncodepakketten die momenteel ondersteund worden door dpkg zijn
1.0, 2.0, 3.0 (native), 3.0 (quilt), 3.0 (git), 3.0 (bzr) en 3.0 (custom).
Source: broncodepakket-naam (verplicht)
De waarde van dit veld bepaalt de pakketnaam en wordt door de meeste
installatiegereedschappen gebruikt om bestandsnamen te genereren.
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.
Dit veld is nu vervangen door het veld Package-List dat voldoende informatie geeft
over welke binaire pakketten op welke architecturen geproduceerd worden, over
bouwprofielen en over andere restricties die van belang zijn.
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 amd64, armel, i386, linux-any, any-amd64, enz.
Merk op dat de waarde all bedoeld is voor pakketten die architectuuronafhankelijk
zijn en any voor pakketten die architectuurafhankelijk zijn. De lijst mag de
speciale waarde all bevatten (of er uitsluitend uit bestaan). Wanneer de lijst het
architectuurjokerteken any bevat, is all de enige andere toegelaten waarde in de
lijst.
De waarde van dit veld wordt gewoonlijk gegenereerd op basis van de
Architecture-velden in het bestand debian/control van het broncodepakket.
Version: versie-tekenreeks (verplicht)
Typically, this is the original package's version number in whatever form the
program's author uses. It may also include a Debian revision number (for
non-native packages). The exact format and sorting algorithm are described in
deb-version(7).
Origin: naam
De naam van de distributie waaruit dit pakket afkomstig is.
Maintainer: volledige-naam-en-e-mail (aanbevolen)
Moet opgemaakt worden volgens de indeling “Joe Bloggs <jbloggs@foo.com>”, en is
gewoonlijk de persoon die het pakket maakte, in tegenstelling tot de auteur van de
verpakte software.
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 Maintainer. Meerdere
mede-onderhouders moeten onderling door een komma gescheiden worden.
Description short-description
uitgebreide-beschrijving
The format for the source package description is a short brief summary on the first
line (after the Description field). The following lines should be used as a
longer, more detailed description. Each line of the long description must be
preceded by a space, and blank lines in the long description must contain a single
‘.’ following the preceding space.
Homepage: URL
De URL van de homepage van het toeleverend project (upstream).
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.
Vcs-Browser: URL
De url van een webinterface waarmee door de opslagruimte van het
versiecontrolesysteem kan gebladerd worden.
Vcs-Arch: URL
Vcs-Bzr: URL
Vcs-Cvs: URL
Vcs-Darcs: URL
Vcs-Git: URL
Vcs-Hg: URL
Vcs-Mtn: URL
Vcs-Svn: URL
Deze velden declareren de url van de opslagruimte van het versiecontrolesysteem dat
gebruikt wordt om dit pakket te onderhouden. Zie deb-src-control(5) voor verdere
informatie.
Testsuite: namenlijst
This field declares that the source package contains the specified test suites.
The value is a comma-separated list of test suites. If the autopkgtest value is
present, a debian/tests/control is expected to be present, if the file is present
but not the value, then dpkg-source will automatically add it, preserving previous
values.
Testsuite-Triggers: pakketlijst
Dit veld declareert de door komma's gescheiden unie van alle testvereisten (de
velden Depends uit het bestand debian/tests/control), waaruit alle restricties
verwijderd en alle OR-vereisten uitgevlakt werden, met uitzondering van die welke
gelden voor de binaire pakketten die dit broncodepakket genereert en van
meta-vereisten zoals @ of @builddeps@.
Motivering: dit veld is noodzakelijk omdat anders elk broncodepakket uitgepakt zou
moeten worden om de testvereisten te kunnen achterhalen.
Build-Depends: pakketlijst
Build-Depends-Arch: pakketlijst
Build-Depends-Indep: pakketlijst
Build-Conflicts: pakketlijst
Build-Conflicts-Arch: pakketlijst
Build-Conflicts-Indep: pakketlijst
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
deb-src-control(5).
Package-List:
pakket pakkettype sectie prioriteit trefwoord-waarde-lijst
Dit multiregel-veld bevat een lijst van binaire pakketten die door dit
broncodepakket gegenereerd worden.
Het element pakket is de naam van het binaire pakket.
Het element pakket-type is het type van het binaire pakket, meestal deb; een andere
gebruikelijke waarde is udeb.
De elementen sectie (section) en prioriteit (priority) komen overeen met de velden
met dezelfde naam van het binaire pakket.
Het element trefwoord-waarde-lijst is een lijst van door spaties gescheiden
trefwoord=waarde en de momenteel herkende optionele trefwoorden zijn:
arch De architectuurrestrictie uit het veld Architecture van het binaire pakket,
waarbij spaties naar ‘,’ geconverteerd worden.
profile
De genormaliseerde bouwprofiel-restrictieformule uit het veld Build-Profile
van het binaire pakket, waarbij OR's omgezet worden naar ‘+’ en AND's naar
‘,’.
essential
Indien het binaire pakket essentieel (essential) is, zal dit trefwoord de
waarde hebben van het veld Essential en dat is de waarde yes.
Files: (verplicht)
Checksums-Sha1: (verplicht)
Checksums-Sha256: (verplicht)
controlesom grootte bestandsnaam
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 Files, SHA-1 voor Checksums-Sha1 en SHA-256 voor Checksums-Sha256.
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, één regel per bestand. Elke regel bestaat uit de
controlesom, een spatie, de bestandsgrootte, een spatie en de bestandsnaam.
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.
BUGS
Het veld Format combineert de indeling van het .dsc-bestand zelf en de indeling van het
uitgepakte broncodepakket.
ZIE OOK
deb-src-control(5), deb-version(7), dpkg-source(1).