deb-control - styrfilsformat för Debians
binärpaket
Varje Debianbinärpaket innehåller en fil
control i posten control, och dess deb822(5)-format
är en delmängd av debian/control-filen från
Debiankällkodspaketen, se deb-src-control(5).
Filen innehåller ett antal fält. Varje fält
börjar med en etikett, såsom Package eller
Version (skiftlägesoberoende), följt av ett kolontecken
och fältets kropp (skiftlägesberoende såvida inte annat
anges). Fält avdelas endast av fältetiketter. Med andra ord
kan texten i fälten spänna över flera rader, men
installationsverktygen kommer oftast att slå samman rader när
kroppen tolkas (förutom när det gäller fältet
Description, se nedan).
- Package:
paketnamn (krävs)
- Värdet på fältet bestämmer paketets namn, och
används av de flesta installationsverktygen för att generera
filnamnen.
- Package-Type:
deb|udeb|typ
- Detta fält anger paketets typ. udeb används
för storleksbegränsade paket som används av debians
installationsprogram. deb är standardvärdet, och
antas om fältet saknas. Fler typer kan komma att läggas till
i framtiden.
- Version:
versionssträng (krävs)
- Vanligtvis är detta det ursprungliga paketets versionsnummer
på den form programmets författare använder. Den kan
även innehålla ett Debianuppdateringsnummer (för
paket vars källa är utanför Debian). Exakt format och
sorteringsalgoritm beskrivs i deb-version(7).
- Maintainer:
fullt-namn-epost (rekommenderas)
- Ska vara på formatet ”Joe Bloggs
<jbloggs@foo.com>” och är normalt sett den person som
skapat paketet, till skillnad från författaren av den
programvara som paketerades.
- Description:
kort-beskrivning (rekommenderas)
- lång-beskrivning
- Formatet för paketbeskrivningen är en kortfattad
sammanfattning på den första raden (efter
Description-fältet). Följande rader bör
användas för en längre, mer detaljerad beskrivning.
Varje rad i den lägre beskrivningen måste inledas med ett
blanksteg, och blanka rader i den långa beskrivningen måste
innehålla en ensam punkt (”.”) efter det
inledande blanksteget.
- Section:
sektion
- Detta är ett generellt fält som ger paketet en kategori
baserat på programvara som det installerar. Några vanliga
sektioner är utils, net, mail, text,
x11, osv.
- Priority:
prioritet
- Ställer in hur viktigt paketet är jämfört med
systemet som helhet. Vanliga prioriteter är required
(nödvändig), standard (normal), optional
(valfritt), extra (extra), osv.
Gälten Section och Priority har vanligtvis en
definierad uppsättning accepterade värden baserade på
den specifika distributionens policy.
- Installed-Size:
storlek
- Ungefärlig total storlek för paketets installerade filer, i
KiB-enheter. Algoritmen för att beräkna storleken beskrivs i
deb-substvars(5).
- Protected:
yes|no
- Fältet krävs normalt sett endast om svaret är
yes (ja), och betecknar att paketet huvudsakligen krävs
för en korrekt start av systemet eller som används som
skräddarsydda systemlokala metapaket. dpkg(1) eller andra
installationsverktyg tillåter inte att ett paket märkt
Protected tas bort (åtminstone inte utan att använda
en av de tvingande flaggorna).
Stöds sedan dpkg 1.20.1.
- Essential:
yes|no
- Fältet krävs normalt sett endast om svaret är
yes (ja), och betecknar att paketet krävs av
pakethanteringssystemet, för att systemet generellt ska fungera
korrekt eller under start (även om det sistnämnda bör
skrivas om till att istället använda ett
Protected-fält). dpkg(1) eller andra
installationsverktyg tillåter inte att ett paket märkt
Essential tas bort (åtminstone inte utan att använda
en av de tvingande flaggorna).
- Build-Essential:
yes|no
- Fältet krävs normalt sett endast om svaret är
yes (ja), och sätts vanligtvis in av arkivprogramvaran. Det
betecknar ett paket som krävs för att bygga andra
paket.
- Architecture:
ark|all> (krävs)
- Arkitekturen anger vilken sorts maskinvara paketet kompilerades
för. Vanliga arkitekturer är amd64, armel,
i386, powerpc, osv. Observera att värdet all
är avsett för paket som är oberoende av arkitektur.
Exempel på detta är skal- eller Perlskript och
dokumentation.
- Origin:
namn
- Namnet på den distribution paketet härstammar
från.
- Bugs:
url
- URL:en till felrapporteringssystemet för detta paket. Det
nuvarande formatet är systemtyp://adress, till
exempel debbugs://bugs.debian.org.
- Homepage:
url
- URL till uppströmsprojektets hemside-url.
- Tag:
lista-med-märken
- Lista över märken som beskriver paketets egenskaper. En
beskrivningen och förteckning över kända
märken finns i paketet debtags.
- Multi-Arch:
no|same|foreign|allowed
- Det här fältet används för att ange hur
paketet ska bete sig på installationer där flera
arkitekturer stöds.
- no (nej)
- Det här är förval om fältet utesluts, i vilket
fall det normalt sett inte är nödvändligt att
lägga till fältet med ett explicit
no-värde.
- same (samma)
- Paketet kan installeras vid sidan av sig självt, men kan inte
användas för att tillfredsställa beroenden för
några paket på andra arkitekturer än sig
självt.
- foreign
(oegen)
- Paketet kan inte installeras vid sidan av sig självt, men
bör tillåtas att tillfredsställa beroenden som inte
anger en arkitektur för paket från en annan arkitektur
än sig självt (om en beroende har en specifik
arkitekturangivelse kommer värdet foreign att
ignoreras).
- allowed
(tillåtet)
- Detta tillåter omvända beroenden att ange i sitt
Depends-fält att de tillåter det här paketet
från en oegen arkitektur genom att kvalificera paketnamnet med
:any, men har annars ingen effekt.
- Source:
källkodsnamn
[(källkodsversion)]
- Namnet på källkodspaketet det här binärpaketet
kommer från, om det skiljer sig från namnet på
själva paketet. Om källkodsversionen skiljer sig från
binärversionen kommer källkodsnamn följas av
källkodsversion i parentes. Detta kan till exempel
uppstå när bygget är för en insändning
bestående av enbart binärer från någon annan
än den paketansvarige (”binary-only non-maintainer
upload”) eller när man anger en annan binärversion
genom ”dpkg-gencontrol -v”.
- Subarchitecture:
värde
- Kernel-Version:
värde
- Dessa fält används av debian-installer och behövs
normalt inte. För mer information om dem, se
<https://salsa.debian.org/installer-team/debian-installer/-/raw/master/doc/devel/modules.txt>.
- Depends:
paketlista
- Lista över paket som krävs för att paketet ska kunna
tillhandahålla en icke-trivial mängd funktionalitet.
Pakethanteringsprogramvaran kommer inte tillåta att ett paket
installeras om paketen som listas i Depends-fältet inte
är installerade (åtminstone inte utan att använda en
av de tvingande flaggorna). Vid en installation körs
postinst-skripten från paketen i Depends-fältet innan
de paket som beror på dem. Under det omvända
förhållandet, en borttagning, körs prerm-skriptet
från ett paket innan de som kommer från paketen i dess
Depends-fält.
- Pre-Depends:
paketlista
- Lista över paket som måste vara installerade och
konfigurerade innan paketet kan installeras. Detta används normalt
i de fall paketet kräver att ett annat paket är installerat
för sitt preinst-skript.
- Recommends:
paketlista
- Lista över paket som bör installeras tillsammans med paketet
i de allra flesta fall. Pakethanteringsprogramvaran kommer att varna
användaren om man installerar ett paket utan de som listas i
Recommends-fältet.
- Suggests:
paketlista
- Lista över paket som är relaterade till paketet och som
kanske kan göra det mer användbart, men utan vilka det
fortfarande är rimligt att installera paketet.
Syntaxen för fälten Depends,
Pre-Depends, Recommends och Suggests är en lista
med grupper av alternativa paket. Varje grupp innehåller en lista med
paket avdelade med ett vertikalstreck (”rör”),
”|”. Grupperna avdelas med kommatecken. Komma
utläses som ”OCH”, och vertikalstrecken som
”ELLER”, där vertikalstrecken binder hårdare.
Ett paketnamn kan möjligen följas av en arkitekturangivelse
efter ett kolontecken ”:”, möjligen
åtföljt av en versionsnummerangivelse inom parentes.
En arkitekturangivelse kan vara ett existerande
Debianarkitekturnamn (sedan dpkg 1.16.5) eller any (sedan dpkg
1.16.2). Om det utesluts är förvalet den aktuella
binärpaketarkitekturen. Ett existerande Debianarkitekturnamn
motsvarar exakt den arkitekturen för det paketnamnet, any
motsvarar valfri arkitektur för paketnamnet om paketet har markerats
som Multi-Arch: allowed.
Ett versionsnummer kan börja med
”>>”, vilket betyder att vilken som helst senare
version matchar, där det är valfritt att ange
Debianuppdateringen (avdelad med bindestreck). Tillåtna
versionrelationer är ”>>” för
större än, ”<<” för mindre
än, ”>=” för större än
eller lika med, ”<=” för mindre än
eller lika med, och ”=” för lika med.
- Breaks:
paketlista
- Listar paket som förstörs av detta, till exempel genom att
lyfta fram fel när det namngivna paketet beror på detta.
Pakethanteringsprogramvaran tillåter inte att
förstörda paket konfigureras; problemet löses
vanligtvis genom att uppgradera paketen som namnges i ett
Breaks-fält.
- Conflicts:
paketlista
- Listar paket som är i konflikt (krockar) med detta, till exempel
genom att innehålla filer med samma namn.
Pakethanteringsprogramvaran tillåter inte två sådana
paket att vara installerade samtidigt. Två paket med
inbördes konflikt bör innehålla en
Conflicts-rad med varandras namn.
- Replaces:
paketlista
- Lista över paket ersätts av filer från det här
paketet. Detta används för att möjliggöra
paket att skriva över filer från andra paket, och
används normalt sett tillsammans med Conflicts-fältet
för att tvinga fram borttagning av det andra paketet om även
det här har de filer som finns i paketet det står i konflikt
med.
Syntaxen för Breaks, Conflicts och
Replaces är en lista över paketnamn avdelade med komman
(och eventuella blanktecken). I fälten Breaks och
Conflicts läses kommatecknet som ”ELLER”. En
valfri arkitekturangivelse kan också läggas till paketnamnet
med samma syntax som över, men förvalet är any
istället för binärpaketets arkitektur. Ett eventuellt
versionsnummer kan också anges, med samma syntax som ovan för
fälten Breaks, Conflicts och Replaces.
- Enhances:
paketlista
- Detta är en lista över paket som förbättras av
detta. Det liknar Suggests men är i motsatt riktning.
- Provides:
paketlista
- Detta är en lista av virtuella paket som tillhandahålls av
detta. Normalt sett används detta i de fall flera paket
tillhandahåller samma tjänst. Till exempel kan både
sendmail och exim fungera som e-postserver, så de
tillhandahåller ett gemensamt paket
(”mail-transport-agent”) på vilket andra paket kan
bero, vilket gör det möjligt för sendmail eller exim
att fungera som ett alternativ som tillfredsställer beroendet.
Detta förhindrar att paket som beror på en e-postserver
måste känna till alla deras paketnamn och använda
”|” för att dela av listan.
Syntaxen för Provides är en lista över
paketnamn avdelade med komman (och eventuella blanktecken). En valfri
arkitekturangivelse kan också läggas till paketnamnet med
samma syntax som över. Om det inte anges är förvalet
binärpaketets arkitektur. Ett eventuellt exakt (lika med)
versionsnummer kan också anges, med samma syntax som ovan (sedan dpkg
1.17.11).
- Built-Using:
paketlista
- Beroendefältet visar ytterligare källkodspaket som
användes när binärpaketet byggdes för att
uppfylla licensvillkor. Detta anger för hanteringsprogramvaran
för arkivet att dessa ytterligare källkodspaket måste
behållas så länge binärpaketet finns i
arkivet. Fältet måste innehålla en kommaavdelad lista
med källkodspaket med strikta ”=”
versionsberoenden inom parentes. Observera att hanteringsprogramvaran
för arkivet troligen kommer att avvisa en insändning som
deklarerar en Built-Using-relation som inte kan uppfyllas inom
arkivet.
- Static-Built-Using:
paketlista
- Beroendefältet visar ytterligare källkodspaket som
användes när binärpaketet byggdes för att
bygga statiskt (till exempel länkning mot statiska bibliotek,
byggen för källkodscentrerade spårk såsom Go
eller Rust, användning av C/C++-bibliotek som enbart består
av filhuvuden, injicering av data-blobbar i kod, osv.). Detta är
användbart för att spåra huruvida paketet kan
behöva byggas om när källkodspaket som listas
här uppdateras, till exempel vid säkerhetsuppdateringar.
Fältet måste innehålla en kommaavdelad lista med
källkodspaket med strikta ”=”
versionsberoenden inom perentes.
Stöds sedan dpkg 1.21.3.
- Built-For-Profiles:
profillista (föråldrat)
- Det här fältet används för att ange en
blankstegsavdelad lista med byggprofiler som det binära paketet
byggdes med (sedan dpkg 1.17.2 fram till 1.18.18). Informationen som
tidigare fanns i det här fältet finns nu i filen
.buildinfo som ersätter det.
- Auto-Built-Package:
orsakslista
- Det här fältet innehåller en blankstegsavdelad lista
med orsaker till varför det här paketet autogenererades.
Binärpaket som markerats med det här fältet kommer
inta dyka upp i mall-källkodsstyrfilen debian/control. Den
enda orsak som används är för närvarande
debug-symbols (felsökningssymboler).
- Build-Ids:
elf-bygg-id-lista
- Det här fältet innehåller en blankstegsavdelad lista
med ELF-bygg-id:n. Det är unika identifierare för semantiskt
identiska ELF-objekt, för var av dessa i paketet.
Formatet och sättet på vilket varje bygg-id
beräknas är medvetet inte definierat.
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 and fgrep.
The GNU family of grep utilities may be the "fastest grep in the west".
GNU grep is based on a fast lazy-state deterministic matcher (about
twice as fast as stock Unix egrep) hybridized with a Boyer-Moore-Gosper
search for a fixed string that eliminates impossible text from being
considered by the full regexp matcher without necessarily having to
look at every character. The result is typically many times faster
than Unix grep or egrep. (Regular expressions containing backreferencing
will run more slowly, however).
Fältet Build-Ids använder ett ganska
allmänt namn utanför sitt ursprungliga sammanhang inuti ett
ELF-objekt, som gäller ett väldigt specifikt syfte och
exekverbart format.
deb822(5), deb-src-control(5), deb(5),
deb-version(7), debtags(1), dpkg(1),
dpkg-deb(1).
ÖVERSÄTTNING
Peter Krefting och Daniel Nylander.