255 lines
11 KiB
HTML
255 lines
11 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of dsc</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>dsc</H1>
|
|
Section: dpkg-suite (5)<BR>Updated: 2020-03-23<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAAM</H2>
|
|
|
|
dsc - Indeling van het controlebestand van Debian-broncodepakketten
|
|
<A NAME="lbAC"> </A>
|
|
<H2>OVERZICHT</H2>
|
|
|
|
<I>bestandsnaam</I><B>.dsc</B>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>BESCHRIJVING</H2>
|
|
|
|
Elk Debian broncodepakket bevat een .dsc-controlebestand dat uit een aantal
|
|
velden bestaat. Ieder veld begint met een markering, zoals <B>Source</B> of
|
|
<B>Binary</B> (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 <B>Package-List</B>, <B>Files</B>, <B>Checksums-Sha1</B> en
|
|
<B>Checksums-Sha256</B>; zie hierna)
|
|
<P>
|
|
|
|
De controle-data mogen ingesloten liggen in een OpenPGP-handtekening met
|
|
ASCII-harnas volgens de specificatie RFC4880.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>VELDEN</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>Format:</B> <I>indelingsversie</I> (verplicht)<DD>
|
|
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 ("0-9"), een punt ("."), een
|
|
numerieke onderversie ("0-9"), en dan eventueel na witruimte (" \t") een
|
|
subtype dat, als het opgegeven wordt, bestaat uit een alfanumeriek
|
|
("a-z0-9") 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.
|
|
<P>
|
|
De indelingen van de broncode die momenteel ondersteund worden door <B>dpkg</B>
|
|
zijn <B>1.0</B>, <B>2.0</B>, <B>3.0 (native)</B>, <B>3.0 (quilt)</B>, <B>3.0 (git)</B>, <B>3.0
|
|
(bzr)</B> en <B>3.0 (custom)</B>. Raadpleeg <B><A HREF="/cgi-bin/man/man2html?1+dpkg-source">dpkg-source</A></B>(1) voor de beschrijving
|
|
ervan.
|
|
<DT id="2"><B>Source:</B> <I>broncode-naam</I> (verplicht)<DD>
|
|
De waarde van dit veld bepaalt de pakketnaam en wordt door de meeste
|
|
installatiegereedschappen gebruikt om bestandsnamen te genereren.
|
|
<DT id="3"><B>Binary:</B><I> lijst-van-binaire-pakketten</I><DD>
|
|
Dit gevouwen veld somt, door komma's van elkaar gescheiden, de binaire
|
|
pakketten op die door dit broncodepakket gebouwd kunnen worden.
|
|
<P>
|
|
Dit veld is nu vervangen door het veld <B>Package-List</B> dat voldoende
|
|
informatie geeft over welke binaire pakketten op welke architecturen
|
|
geproduceerd worden, over bouwprofielen en over andere restricties die van
|
|
belang zijn.
|
|
<DT id="4"><B>Architecture:</B> <I>arch-lijst</I> (aanbevolen)<DD>
|
|
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 <B>amd64</B>, <B>armel</B>, <B>i386</B>, <B>linux-any</B>,
|
|
<B>any-amd64</B>, enz.
|
|
<P>
|
|
Merk op dat de waarde <B>all</B> bedoeld is voor pakketten die
|
|
architectuuronafhankelijk zijn en <B>any</B> voor pakketten die
|
|
architectuurafhankelijk zijn. De lijst mag de speciale waarde <B>all</B>
|
|
bevatten (of er uitsluitend uit bestaan). Wanneer de lijst het
|
|
architectuurjokerteken <B>any</B> bevat, is <B>all</B> de enige andere toegelaten
|
|
waarde in de lijst.
|
|
<P>
|
|
De waarde van dit veld wordt gewoonlijk gegenereerd op basis van de
|
|
<B>Architecture</B>-velden in het bestand <I>debian/control</I> van het
|
|
broncodepakket.
|
|
<DT id="5"><B>Version:</B> <I>versie-tekenreeks</I> (verplicht)<DD>
|
|
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
|
|
<B><A HREF="/cgi-bin/man/man2html?7+deb-version">deb-version</A></B>(7).
|
|
<DT id="6"><B>Origin:</B><I> naam</I><DD>
|
|
De naam van de distributie waaruit dit pakket afkomstig is.
|
|
<DT id="7"><B>Maintainer:</B> <I>volledige-naam-en-e-mail</I> (aanbevolen)<DD>
|
|
Moet opgemaakt worden volgens de indeling "Joe Bloggs
|
|
<<A HREF="mailto:jbloggs@foo.com">jbloggs@foo.com</A>>", en is gewoonlijk de persoon die het pakket
|
|
maakte, in tegenstelling tot de auteur van de verpakte software.
|
|
<DT id="8"><B>Uploaders:</B><I> lijst van volledige-namen-en-e-mailadressen</I><DD>
|
|
Somt al de namen en de e-mailadressen op van de personen die het pakket mee
|
|
onderhouden volgens dezelfde indeling als van het veld
|
|
<B>Maintainer</B>. Meerdere mede-onderhouders moeten onderling door een komma
|
|
gescheiden worden.
|
|
<DT id="9"><B>Description:</B> <I>korte-beschrijving</I><DD>
|
|
|
|
<B> </B><I>uitgebreide-beschrijving</I>
|
|
De indeling van een pakketbeschrijving bestaat uit een beknopte korte
|
|
samenvatting op de eerste regel (na de veldmarkering <B>Description</B>). 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 één enkele '<B>.</B>' bevatten die volgt op de eraan
|
|
voorafgaande spatie.
|
|
<DT id="10"><B>Homepage:</B><I> URL</I><DD>
|
|
De <I>URL</I> van de homepage van het toeleverend project (upstream).
|
|
<DT id="11"><B>Standards-Version:</B> <I>versietekenreeks</I> (aanbevolen)<DD>
|
|
Dit documenteert de meest recente versie van de normen die vastgelegd werden
|
|
in de richtlijnen van de distributie en waaraan dit pakket voldoet.
|
|
<DT id="12"><B>Vcs-Browser:</B><I> URL</I><DD>
|
|
De <I>url</I> van een webinterface waarmee door de opslagruimte van het
|
|
versiecontrolesysteem kan gebladerd worden.
|
|
<DT id="13"><B>Vcs-Arch:</B><I> URL</I><DD>
|
|
|
|
<B>Vcs-Bzr:</B><I> URL</I>
|
|
|
|
<B>Vcs-Cvs:</B><I> URL</I>
|
|
|
|
<B>Vcs-Darcs:</B><I> URL</I>
|
|
|
|
<B>Vcs-Git:</B><I> URL</I>
|
|
|
|
<B>Vcs-Hg:</B><I> URL</I>
|
|
|
|
<B>Vcs-Mtn:</B><I> URL</I>
|
|
|
|
<B>Vcs-Svn:</B><I> URL</I>
|
|
Deze velden declareren de <I>url</I> van de opslagruimte van het
|
|
versiecontrolesysteem dat gebruikt wordt om dit pakket te onderhouden. Zie
|
|
<B><A HREF="/cgi-bin/man/man2html?5+deb-src-control">deb-src-control</A></B>(5) voor verdere informatie.
|
|
<DT id="14"><B>Testsuite:</B><I> namenlijst</I><DD>
|
|
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 <B>autopkgtest</B> bestaat, wordt verondersteld dat het bestand
|
|
<I>debian/tests/control</I> bestaat. Indien het bestand bestaat, maar de waarde
|
|
niet, dan zal <B>dpkg-source</B> die automatisch toevoegen met behoud van de
|
|
vroegere waarden.
|
|
<DT id="15"><B>Testsuite-Triggers:</B><I> pakketlijst</I><DD>
|
|
Dit veld declareert de door komma's gescheiden unie van alle testvereisten
|
|
(de velden <B>Depends</B> uit het bestand <I>debian/tests/control</I>), 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
|
|
<B>@</B>.
|
|
<P>
|
|
Motivering: dit veld is noodzakelijk omdat anders elk broncodepakket
|
|
uitgepakt zou moeten worden om de testvereisten te kunnen achterhalen.
|
|
<DT id="16"><B>Build-Depends:</B><I> pakketlijst</I><DD>
|
|
|
|
<B>Build-Depends-Arch:</B><I> pakketlijst</I>
|
|
|
|
<B>Build-Depends-Indep:</B><I> pakketlijst</I>
|
|
|
|
<B>Build-Conflicts:</B><I> pakketlijst</I>
|
|
|
|
<B>Build-Conflicts-Arch:</B><I> pakketlijst</I>
|
|
|
|
<B>Build-Conflicts-Indep:</B><I> pakketlijst</I>
|
|
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
|
|
<B><A HREF="/cgi-bin/man/man2html?5+deb-src-control">deb-src-control</A></B>(5).
|
|
<DT id="17"><B>Package-List:</B><DD>
|
|
|
|
<BR> <I>pakket</I> <I>pakkettype</I> <I>sectie</I> <I>prioriteit</I> <I>trefwoord-waarde-lijst</I>
|
|
Dit multiregel-veld bevat een lijst van binaire pakketten die door dit
|
|
broncodepakket gegenereerd worden.
|
|
<P>
|
|
Het element <I>pakket</I> is de naam van het binaire pakket.
|
|
<P>
|
|
Het element <I>pakket-type</I> is het type van het binaire pakket, meestal
|
|
<B>deb</B>; een andere gebruikelijke waarde is <B>udeb</B>.
|
|
<P>
|
|
De elementen <I>sectie</I> (section) en <I>prioriteit</I> (priority) komen overeen
|
|
met de velden met dezelfde naam van het binaire pakket.
|
|
<P>
|
|
Het element <I>trefwoord-waarde-lijst</I> is een lijst van door spaties
|
|
gescheiden <I>trefwoord</I><B>=</B><I>waarde</I> en de momenteel herkende optionele
|
|
trefwoorden zijn:
|
|
<P>
|
|
<DL COMPACT><DT id="18"><DD>
|
|
<DL COMPACT>
|
|
<DT id="19"><B>arch</B><DD>
|
|
De architectuurrestrictie uit het veld <B>Architecture</B> van het binaire
|
|
pakket, waarbij spaties naar ',' geconverteerd worden.
|
|
<DT id="20"><B>profile</B><DD>
|
|
De genormaliseerde bouwprofiel-restrictieformule uit het veld
|
|
<B>Build-Profile</B> van het binaire pakket, waarbij OR's omgezet worden naar
|
|
'+' en AND's naar ','.
|
|
<DT id="21"><B>essential</B><DD>
|
|
Indien het binaire pakket essentieel (essential) is, zal dit trefwoord de
|
|
waarde hebben van het veld <B>Essential</B> en dat is de waarde <B>yes</B>.
|
|
</DL>
|
|
</DL>
|
|
|
|
<DT id="22"><B>Files:</B> (verplicht)<DD>
|
|
|
|
<B>Checksums-Sha1:</B> (verplicht)
|
|
|
|
<B>Checksums-Sha256:</B> (verplicht)
|
|
|
|
<BR> <I>controlesom</I> <I>grootte</I> <I>bestandsnaam</I>
|
|
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 <B>Files</B>, SHA-1 voor <B>Checksums-Sha1</B> en SHA-256 voor
|
|
<B>Checksums-Sha256</B>.
|
|
<P>
|
|
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.
|
|
<P>
|
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
Het veld <B>Format</B> combineert de indeling van het <B>.dsc</B>-bestand zelf en de
|
|
indeling van het uitgepakte broncodepakket.
|
|
<A NAME="lbAG"> </A>
|
|
<H2>ZIE OOK</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+deb-src-control">deb-src-control</A></B>(5), <B><A HREF="/cgi-bin/man/man2html?7+deb-version">deb-version</A></B>(7), <B><A HREF="/cgi-bin/man/man2html?1+dpkg-source">dpkg-source</A></B>(1).
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="23"><A HREF="#lbAB">NAAM</A><DD>
|
|
<DT id="24"><A HREF="#lbAC">OVERZICHT</A><DD>
|
|
<DT id="25"><A HREF="#lbAD">BESCHRIJVING</A><DD>
|
|
<DT id="26"><A HREF="#lbAE">VELDEN</A><DD>
|
|
<DT id="27"><A HREF="#lbAF">BUGS</A><DD>
|
|
<DT id="28"><A HREF="#lbAG">ZIE OOK</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:19 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|