dsc(5)

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