dpkg/doc/sv/deb-control.5

.\" Hey, Emacs!  This is an -*- nroff -*- source file.
.\" Author: Raul Miller
.\" Includes text from the debian Guidelines by Ian Jackson, Ian Murdock
.\" Translation of CVS revision 1.6
.TH DEB-CONTROL 5 "Januari 2000" "Debianprojektet" "Debian GNU/Linux"
.SH NAMN
deb\-control \- Debian GNU/Linux filformat för paketkontrollfiler
.SH SYNOPS
control
.SH BESKRIVNING
Varje Debianpaket innehåller huvudkontrollfilen "control", vilken i sig
innehåller ett antal fält.
Varje fält börjar med en etikett, såsom
.B Package
eller
.B Version
(skiftlägesoberoende), följt av ett kolontecken, och fältets kropp.
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 i fallet för
.BR Description -fältet,
se nedan).
.SH KRÄVDA FÄLT
.TP
.BR "Package: " "<paketnamn>"
Värdet på detta fält bestämmer paketets namn, och används av de flesta
installationsverktygen för att generera filnamnen.
.TP
.BR "Version: " "<versionssträng>"
Vanligtvis är detta det ursprungliga paketets versionsnummer på den form
programmets författare använder.
Den kan även innehålla ett Debianrevisionsnummer (för paket med källa
utanför Debian).
Om både versionsnummer och revisionsnummer finns delas de med ett
bindestreck ("-"), varför det ursprungliga versionsnumret inte får innehålla
bindestreck.
.TP
.BR "Maintainer: " "<fullt-namn e-post>"
Skall 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.
.TP
.BR "Description: " "<kort beskrivning>"
.BR " " "<lång beskrivning>"
.br
Formatet för paketbeskrivningen är en kortfattad sammanfattning på den
första raden (efter "Description"-fältet).
Följande rader kan användas som 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.
.SH VALFRIA FÄLT
.TP
.BR "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" etc.
.TP
.BR "Priority: " "<prioritet>"
Ställer in hur viktigt paketet är jämfört med systemet som enhet.
Vanliga prioriteter är "required" (krävd), "standard" (normal(, "optional"
(valfritt), "extra" (extra) osv.
.LP
I Debian har fälten
.B Section
och
.B Priority
fördefinierade accepterade värden baserade på policymanualen, vilka används
för att bestämma hur paketen placeras i arkivet.
En lista över dessa finns i den senaste versionen av
.BR debian-policy -paketet.
.TP
.BR "Essential: " "<yes|no>"
Detta fältet krävs normalt sett endast om svaret är "yes" (ja), och
betecknar att paketet krävs för en korrekt installation av systemet.
Dpkg och andra installationsverktyg tillåter inte att ett paket märkt
.B Essential
tas bort (åtminstone inte utan att använda en av de tvingande flaggorna).
.TP
.BR "Architecture: " "<arkitektur|all>"
Arkitekturen anger vilken sorts maskinvara paketet kompilerades för.
Vanliga arkitekturer är "i386", "m68k", "sparc", "alpha", "powerpc" osv.
Observera att värdet
.B all
är avsett för paket som är oberoende av maskinvaruarkitektur.
Exempel på detta är skal- eller Perlskript, eller dokumentation.
.TP
.BR "Source: " "<källkodsnamn>"
Namnet på det källkodspaket som detta binärpaket kommer från, om det skiljer
sig från namnet på själva paketet.
.TP
.BR "Depends: " "<paketlista>"
Lista över paket som krävs för att detta paket för att tillhandahålla en
icke-trivial mängd funktionalitet.
Pakethanteringsprogramvaran kommer inte tillåta att ett paket installeras om
paketen som listas i
.BR Depends -fältet
inte är installerade (åtminstone inte utan att använda en av de tvingande
flaggorna), och kommer inte att utföra postinst-skript i paket som listas i
Depends:-fältet före de paket som beror på det, och kör prerm-skript före.
.TP
.BR "Pre-Depends: " "<paketlista>"
Lista över paket som måste vara installerade
.B och
konfigurerade innan detta kan installeras.
Detta används normalt i de fall paketet kräver att ett annat paket är
installerat för sitt preinst-skript.
.TP
.BR "Recommends: " "<paketlista>"
Lista över paket som bör installeras tillsammans med detta i de allra flesta
fall.
Pakethanteringsprogramvaran kommer att varna användaren om hen installerar
ett paket utan de som listas i
.BR Recommends -fältet.
.TP
.BR "Suggests: " "<paketlista>"
Lista över paket som är relaterade till detta och som kanske kan göra det
mer användbart, men utan vilka det fortfarande är rimligt att installera
detta paket.
.LP
Syntaxen för
.BR Depends ,
.BR Pre-Depends ,
.BR Recommends
och
.BR Suggests -fälten
är en lista över grupper av alternativa paket.
Varje grupp innehåller en lista av paket avdelade med ett vertikalstreck
(rör) ("|").
Grupperna avdelas med komman.
Komman utläses som "OCH", och vertikalstrecken som "ELLER", där
vertikalstrecken binder hårdare.
Varje post är ett paket namn, eventuellt följt av en versionsnummerangivelse
inom parenteser.
.LP
Ett versionsnummer kan börja med ">>", vilket betyder att vilken som helst
senare version matchar, där det är valfritt att ange Debianrevisionen
(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.
.TP
.BR "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
.BR Conflicts -rad
med varandras namn.
.TP
.BR "Replaces: " "<paketlista>"
Lista över paket som filer från denna ersätter.
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
.BR Conflicts -fältet
för att tvinga fram borttagning av det andra paketet om även detta har de
filer som finns i paketet det står i konflikt med.
.TP
.BR "Provides: " "<paketlista>"
Detta är en lista av virtuella paket som detta tillhandahåller.
Normalt sett används detta i de fall flera paket tillhandahåller samma
service.
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.
.LP
Syntaxen för
.BR Conflicts ,
.B Replaces
och
.B Provides
är en lista över paketnamn avdelade med komman (och eventuella blanktecken).
I
.BR Conflicts -fältet
läses kommatecknet som "ELLER".
En eventuellt versionsnumret kan även anges, med samma syntax som ovan för
.B Conflicts
och
.BR Replaces -fälten.
.SH EXEMPEL
.\" .RS
.nf
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.)
.fi
.\" .RE
.SH SE ÄVEN
.BR deb (5),
.BR dpkg (8),
.BR dpkg-deb (1).