Provided by: dpkg-dev_1.19.0.5ubuntu2.4_all bug

NAAM

       deb-control - Indeling van het hoofdcontrolebestand van de Debian binaire pakketten

OVERZICHT

       control

BESCHRIJVING

       Elk Debian binair pakket bevat een hoofdcontrolebestand control, dat uit een aantal velden bestaat. Ieder
       veld  begint  met  een  markering,  zoals Package of Version (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 voor het veld Description; zie hierna)

VELDEN

       Package: pakketnaam (verplicht)
              De  waarde  van  dit  veld bepaalt de pakketnaam en wordt door de meeste installatiegereedschappen
              gebruikt om bestandsnamen te genereren.

       Package-Type: deb|udeb|type
              Dit veld definieert het pakkettype. udeb is voor  pakketten  waarvan  de  omvang  aan  beperkingen
              onderworpen  is  en  die  door  het  installatieprogramma  van  Debian  gebruikt worden. deb is de
              standaardwaarde, die verondersteld wordt als het veld ontbreekt. In de toekomst kunnen nog  andere
              types toegevoegd worden.

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

       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.

       Description: korte-beschrijving (aanbevolen)
        uitgebreide-beschrijving
              De  indeling  van  een pakketbeschrijving bestaat uit een beknopte korte samenvatting op de eerste
              regel (na de veldmarkering Description) en een langere  meer  gedetailleerde  beschrijving  op  de
              volgende  regels.  Elke  regel  van  de uitgebreide beschrijving moet voorafgegaan worden door een
              spatie, en lege regels in de uitgebreide beschrijving moeten één enkele ‘.’ bevatten die volgt  op
              de eraan voorafgaande spatie.

       Section: sectie
              Dit  is  een  veld  van  algemene aard dat het pakket in een categorie onderbrengt op basis van de
              software die het installeert. Enkele gebruikelijke secties zijn utils, net, mail, text, x11, enz.

       Priority: prioriteit
              Duidt het belang  van  dit  pakket  aan  in  verhouding  tot  het  gehele  systeem.  Gebruikelijke
              prioriteiten zijn required, standard, optional, extra, enz.

       De velden Section en Priority hebben gewoonlijk een welbepaalde set mogelijke waarden, afhankelijk van de
       richtlijnen van de distributie.

       Installed-Size: grootte
              Bij  benadering  de  totale grootte van de door het pakket geïnstalleerde bestanden, uitgedrukt in
              KiB.

       Essential: yes|no
              Meestal is dit veld enkel nodig als het antwoord yes is. Het duidt een pakket aan dat  vereist  is
              opdat   het   systeem   behoorlijk   zou   functioneren.   Dpkg   of   om   het  even  welk  ander
              installatiegereedschap zal niet toestaan dat een pakket van het type  Essential  verwijderd  wordt
              (tenminste niet zonder dat één van de forceeropties gebruikt wordt).

       Build-Essential: yes|no
              Meestal  is dit veld enkel nodig als het antwoord yes is en het wordt gewoonlijk ingevoegd door de
              archiefsoftware. Het duidt een pakket aan dat vereist is voor het bouwen van andere pakketten.

       Architecture: arch|all (aanbevolen)
              De architectuur geeft aan voor welk type hardware  dit  pakket  gecompileerd  werd.  Gebruikelijke
              architecturen  zijn  amd64,  armel,  i386, powerpc, enz. Merk op dat de waarde all bedoeld is voor
              pakketten  die  architectuuronafhankelijk  zijn.  Enkele  voorbeelden  hiervan  zijn   shell-   en
              Perl-scripts en documentatie.

       Origin: naam
              De naam van de distributie waaruit dit pakket afkomstig is.

       Bugs: URL
              De  URL  van  het  opvolgingssysteem  voor bugs van dit pakket. De indeling die momenteel gebruikt
              wordt is bts-type://bts-adres, zoals debbugs://bugs.debian.org.

       Homepage: URL
              De URL van de homepage van het toeleverend project (upstream).

       Tag: lijst-van-markeringen
              Lijst van markeringen (tags) die de eigenschappen van het pakket beschrijven. De  beschrijving  en
              de lijst van ondersteunde markeringen/tags is te vinden in het pakket debtags.

       Multi-Arch: no|same|foreign|allowed
              Dit  veld  wordt  gebruikt  om  aan  te  geven hoe dit pakket zich moet gedragen op een multi-arch
              installatie.

              no     Dit is de standaardwaarde als  dit  veld  weggelaten  werd.  Dit  veld  toevoegen  met  een
                     expliciete waarde no is over het algemeen niet nodig.

              same   Dit  pakket  is  co-installeerbaar  met  zichzelf,  maar het kan niet gebruikt worden om te
                     voldoen aan een vereiste van een pakket dat tot een andere architectuur behoort.

              foreign
                     Dit pakket is niet co-installeerbaar met zichzelf, maar het mag wel de toestemming  krijgen
                     om  te  voldoen  aan  een  architectuurkwalificatieloze vereiste van een pakket dat tot een
                     andere    architectuur    behoort    (indien    een    vereiste    wel    een    expliciete
                     architectuurkwalificatie heeft, wordt de waarde foreign genegeerd).

              allowed
                     Dit  laat pakketten die dit pakket als vereiste hebben (reverse-dependencies) toe om in hun
                     Depends-veld aan te geven dat ze dit pakket ook van een andere architectuur aanvaarden door
                     bij de pakketnaam de kwalificatie :any te vermelden. Anders blijft dit zonder effect.

       Source: broncode-naam [(broncode-versie)]
              De naam van het broncodepakket waaruit dit binaire pakket afkomstig is, indien die verschillend is
              van de naam van het pakket zelf. Indien de versie van het broncodepakket verschilt van  de  versie
              van  het  binaire  pakket, dan zal de broncode-naam gevolgd worden door een broncode-versie tussen
              haakjes. Dit kan het geval zijn als de upload een uitsluitend binaire upload is die niet  door  de
              onderhouder  uitgevoerd  wordt,  of  wanneer  via «dpkg-gencontrol -v» voor het binaire pakket een
              verschillend versienummer ingesteld wordt.

       Subarchitecture: waarde
       Kernel-Version: waarde
       Installer-Menu-Item: waarde
              Deze velden worden door het installatieprogramma van Debian gebruikt en zijn meestal  niet  nodig.
              Zie  voor  meer details over deze velden /usr/share/doc/debian-installer/devel/modules.txt uit het
              pakket debian-installer.

       Depends: pakketlijst
              Lijst van de pakketten die dit pakket nodig heeft om meer dan een onbeduidende functionaliteit  te
              kunnen  bieden.  Software  voor  pakketbeheer zal niet toelaten dat een pakket geïnstalleerd wordt
              zonder dat de pakketten die in zijn veld Depends vermeld worden, geïnstalleerd  worden  (tenminste
              niet  zonder het gebruik van forceeropties). Tijdens een installatie wordt het postinst-script van
              pakketten die in het veld Depends vermeld worden, uitgevoerd voor dat van het pakket dat  van  hen
              afhankelijk  is.  Bij  het verwijderen van een dergelijk pakket daarentegen wordt het prerm-script
              van dat pakket uitgevoerd voor die van pakketten die in zijn veld Depends vermeld staan.

       Pre-Depends: pakketlijst
              Lijst van de pakketten die geïnstalleerd  en  geconfigureerd  moeten  zijn  vooraleer  dit  pakket
              geïnstalleerd  kan  worden.  Dit  wordt  meestal gebruikt in een geval waarin dit pakket een ander
              pakket nodig heeft om zijn preinst-script te kunnen uitvoeren.

       Recommends: pakketlijst
              Bevat een lijst van pakketten die samen  met  dit  pakket  aangetroffen  worden  op  alle  behalve
              ongewone  installaties. Software voor pakketbeheer zal de gebruiker waarschuwen als die een pakket
              installeert zonder die welke vermeld worden in zijn veld Recommends.

       Suggests: pakketlijst
              Bevat een lijst van pakketten die gerelateerd zijn aan dit pakket en mogelijks  de   bruikbaarheid
              ervan  kunnen  vergroten,  hoewel  het  perfect  acceptabel  is  om  het  zonder  die pakketten te
              installeren.

       De syntaxis van de velden Depends, Pre-Depends, Recommends en Suggests  is  een  lijst  van  groepen  van
       alternatieve  pakketten.  Elke  groep  is  een lijst van pakketten die onderling gescheiden zijn door het
       symbool verticale streep (of “pijp”), ‘|’. De groepen worden onderling gescheiden door komma's. Een komma
       moet geïnterpreteerd worden als een “AND” en een pijp als een “OR”, waarbij pijpen  de  sterkste  binding
       hebben.  Elke pakketnaam kan facultatief gevolgd worden door een architectuurkwalificatie, die toegevoegd
       wordt na een dubbele punt ‘:’, facultatief  gevolgd  door  de  aanduiding  van  een  versienummer  tussen
       haakjes.

       De  naam  van  een architectuurkwalificatie kan echte Debian-architectuurnaam zijn (sinds dpkg 1.16.5) of
       any (sinds dpkg 1.16.2). Indien ze weggelaten is, is ze standaard de architectuur van het huidige binaire
       pakket. Een echte Debian-architectuurnaam komt exact overeen met die architectuur  voor  die  pakketnaam;
       any  komt  overeen  met om het even welke architectuur voor die pakketnaam als het pakket gemarkeerd werd
       als Multi-Arch: allowed.

       Een versienummer kan beginnen met een ‘>>’.  In  dat  geval  levert  dit  met  alle  latere  versies  een
       overeenkomst  op.  Een  versienummer  kan  al  dan  niet  ook  een Debian-pakketrevisie bevatten (met een
       koppelteken tussen versienummer en Debian-pakketrevisie). Toegestane versierelaties zijn ‘>>’ voor  hoger
       dan, ‘<<’ voor lager dan, ‘>=’ voor hoger of gelijk aan, ‘<=’ voor lager of gelijk aan en ‘=’ voor gelijk
       aan.

       Breaks: pakketlijst
              Bevat  een  lijst  van  pakketten  die door dit pakket defect gemaakt worden, bijvoorbeeld door ze
              bloot te stellen aan bugs indien de vermelde pakketten op dit pakket zouden rekenen. Software voor
              pakketonderhoud zal het configureren van defecte  pakketten  niet  toestaan.  Meestal  bestaat  de
              oplossing erin de pakketten die in het veld Breaks vermeld worden, op te waarderen.

       Conflicts: pakketlijst
              Bevat  een lijst van pakketten die in tegenstrijd/conflict zijn met dit pakket, bijvoorbeeld omdat
              ze bestanden met eenzelfde naam bevatten. Software voor  pakketonderhoud  zal  niet  toestaan  dat
              tegenstrijdige  pakketten  tegelijkertijd geïnstalleerd zijn. Twee tegenstrijdige pakketten moeten
              elk een Conflicts-regel bevatten met daarin de vermelding van het andere pakket.

       Replaces: pakketlijst
              Lijst van pakketbestanden die door dit pakket vervangen worden. Dit wordt gebruikt om  dit  pakket
              de  toelating  te  geven  om bestanden uit een ander pakket te overschrijven. Het wordt gewoonlijk
              gebruikt samen met het veld Conflicts om het verwijderen van het andere pakket af te  dwingen  als
              dit pakket dezelfde bestanden bevat als het pakket waarmee dit pakket in tegenstrijd is.

       De  syntaxis  van  Breaks, Conflicts en Replaces is een lijst van met komma's (en facultatieve witruimte)
       gescheiden pakketnamen. In de velden Breaks en Conflicts moet de komma  geïnterpreteerd  worden  als  een
       “OR”.  Facultatief  kan  ook  een  architectuurkwalificatie  toegevoegd  worden aan de pakketnaam volgens
       dezelfde syntaxis als hierboven beschreven werd,  maar  de  standaardwaarde  is  any  in  plaats  van  de
       architectuur  van het binaire pakket. Ook kan bij de velden Breaks, Conflicts en Replaces facultatief een
       versienummer toegevoegd worden volgens dezelfde syntaxis als hierboven werd beschreven.

       Enhances: pakketlijst
              This is a list of packages that this one enhances.  It is similar to Suggests but in the  opposite
              direction.

       Provides: pakketlijst
              Dit  is  een  lijst van virtuele pakketten waarin door dit pakket voorzien wordt. Gewoonlijk wordt
              dit gebruikt in het geval meerdere pakketten dezelfde dienst leveren. Bijvoorbeeld kunnen sendmail
              en exim beide als mailserver fungeren en daarom  voorzien  zij  in  een  gemeenschappelijk  pakket
              (“mail-transport-agent”)  waarvan  andere  pakketten afhankelijk kunnen zijn. Dit laat sendmail of
              exim toe om te fungeren als een geldige optie om aan die vereiste te voldoen. Hierdoor is het voor
              pakketten die een mailserver nodig hebben niet nodig om van  alle  mailservers  de  pakketnaam  te
              kennen en ze, gescheiden door een ‘|’, allemaal te vermelden in een lijst.

       De syntaxis van Provides is een lijst van pakketnamen door komma's (en facultatieve witruimte) van elkaar
       gescheiden.  Facultatief kan ook een architectuurkwalificatie toegevoegd worden aan de pakketnaam volgens
       dezelfde syntaxis als  hierboven  beschreven  werd.  Indien  dit  weggelaten  werd,  wordt  standaard  de
       architectuur  genomen  van  het  huidige  binaire  pakket.  Facultatief kan ook een exact (is gelijk aan)
       versienummer opgegeven worden volgens dezelfde syntaxis als hierboven beschreven werd (gehonoreerd  sinds
       dpkg 1.17.11).

       Built-Using: pakketlijst
              Dit  veld  vermeldt  extra  broncodepakketten  die  gebruikt werden bij het bouwen van dit binaire
              pakket.  Dit  is  een  indicatie  voor  de  software  voor   archiefonderhoud   dat   deze   extra
              broncodepakketten  behouden  moeten  blijven zolang dit binaire pakket gehandhaafd wordt. Dit veld
              moet bestaan uit een lijst van namen van broncodepakketten met een strikte ‘=’ versierelatie. Merk
              op dat de software voor archiefonderhoud niet geneigd zal zijn om een upload te aanvaarden van een
              pakket dat verklaart een Built-Using-relatie te hebben waaraan in het  archief  niet  voldaan  kan
              worden.

       Built-For-Profiles: profiel-lijst (verouderd)
              Dit  veld  werd vroeger gebruikt om een lijst van door spaties van elkaar gescheiden bouwprofielen
              op te sommen waarmee deze binaire pakketten gebouwd werden (sinds dpkg  1.17.2  tot  1.18.18).  De
              informatie die vroeger in dit veld te vinden was, kan nu gevonden worden in het bestand .buildinfo
              dat het vervangt.

       Auto-Built-Package: lijst-met-redenen
              Dit  veld  somt  een  lijst  van  onderling  door  spaties gescheiden redenen op waarom dit pakket
              automatisch gegenereerd werd. Binaire pakketten die met dit veld gemarkeerd werden, zullen niet te
              vinden zijn in het hoofdcontrolebestand  debian/control  van  de  broncode.  De  enige  reden  die
              momenteel gebruikt wordt, is debug-symbols.

VOORBEELD

       # Commentaar
       Package: grep
       Essential: yes
       Priority: required
       Section: base
       Maintainer: Wichert Akkerman <wakkerma@debian.org>
       Architecture: sparc
       Version: 2.4-1
       Pre-Depends: libc6 (>= 2.0.105)
       Provides: rgrep
       Conflicts: rgrep
       Description: GNU grep, egrep en fgrep.
        De GNU familie van grep-hulpprogramma's is misschien wel de "fastest grep in
        the west". GNU grep is gebaseerd op een snel `lazy-state deterministic
        matcher' (ongeveer twee keer zo snel als een gewone Unix grep), gekruist met
        een Boyer-Moore-Gosper zoekalgoritme voor een vaste tekenreeks, hetgeen
        voorkomt dat niet-voorkomende tekst wordt meegenomen in de volledige regexp
        zoekopdracht, zonder naar ieder teken te hoeven kijken. Het resultaat is
        gewoonlijk vele malen sneller dan Unix grep of egrep. (Maar reguliere
        expressies met terugverwijzingen zullen trager zijn.

ZIE OOK

       deb(5), deb-version(7), debtags(1), dpkg(1), dpkg-deb(1).

1.19.0.5                                           2022-05-25                                     deb-control(5)