dsc - styrfilformat för Debians källkodspaket
Alla Debian-källkodspaket består av en .dsc-styrfil,
vilken består av ett antal fält i deb822(5)-format.
Varje fält börjar med en etikett, såsom
Source eller Binary (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 flerradsfälten Package-List, Files,
Checksums-Sha1 and Checksums-Sha256, se nedan).
Styrinformationen kan omges av en OpenPGP-signatur i ASCII-skal,
såsom beskrivs i RFC4880.
- Format:
formatversion (krävs)
- Värdet på det här fältet deklarerar
formatversionen för källkodspaketet.
Fältvärdet används av program som arbetar på
källkodspaket för att tolka listan över filer i
källkodspaketet och bestämma hur det ska pakcas upp.
Syntaxen för fältet är ett huvudversionsnummer
(”0-9”), en punkt (”.”), ett numeriskt
underversionsnummer (”0-9”), och därefter en valfri
undertyp efter ett blanksteg (” \t”), vilket, om det anges,
är ett ord med små alfanumeriska (”a-z0-9”)
tecken i paranteser (”()”). Undetypen är valfri i
syntaxen men kan krävas för specifika
källkodsformatversioner.
De källkodsformat som för närvarande
stöds av dpkg är 1.0, 2.0, 3.0
(native), 3.0 (quilt), 3.0 (git), 3.0 (bzr) och
3.0 (custom). Se dpkg-source(1) för
beskrivningar.
- Source:
källkodsnamn (krävs)
- Värdet på fältet bestämmer paketets namn, och
används av de flesta installationsverktygen för att generera
filnamnen.
- Binary:
binärpaketlista
- Det här flerdelade fältet listar binärpaket som detta
källkodspaket kan producera, avdelade med kommatecken.
Fältet har nu ersatts av fältet
Package-List, som ger tillräcklig information om vilka
binärpaket som skapas på vilka arkitekturer, byggprofiler
och andra inverkande begränsningar.
- Architecture:
arkitekturlista (rekommenderas)
- En lista över arkitekturer och arkitekturmönster avdelade
med blanksteg som anger vilken typ av maskinvara paketet kan kompileras
för. Vanliga arkitekturnamn och arkitekturmönster är
amd64, armel, i386, linux-any,
any-amd64, osv.
Observar att värdet all är tänkt
för paket som är plattformsoberoende, och any
för paket som är arkitekturberoende. Listan kan
innehålla (eller enbart bestå av) specialvärdet
all. När listan innehåller
arkitekturmönstret any är det enda andra
tillåtna värdet i listan all.
Fältvärdet genereras normalt från
fälten Architecture i filen debian/control i
källkodspaketet.
- 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).
- Origin:
namn
- Namnet på den distribution paketet härstammar
från.
- 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.
- Uploaders:
fullt-namn-epost-lista
- Räknar upp namn och e-postadresser till med-underhållare av
paketet, i samma format som fältet Maintainer. Flera
med-underhållare bör avdelas med kommatecken.
- Description:
kort-beskrivning)
- lång-beskrivning
- Formatet för källkodspaketbeskrivningen är en
kortfattad sammanfattning på den första raden (efter
fältet Description). 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 ”.” efter det inledande
blanksteget.
- Homepage:
url
- URL till uppströmsprojektets hemside-url.
- Standards-Version:
versionssträng (rekommenderas)
- Dokumenterar den senaste versionen av distributionens policystandard som
paketet uppfyller.
- Vcs-Browser:
url
- Url:en till ett webbgränssnitt för att bläddra
i versionshanteringsarkivet.
- Vcs-Arch:
url
- Vcs-Bzr:
url
- Vcs-Cvs:
url
- Vcs-Darcs:
url
- Vcs-Git:
url
- Vcs-Hg:
url
- Vcs-Mtn:
url
- Vcs-Svn:
url
- Dessa fält anger url till det versionshanteringssystemakriv
som används för att underhålla paketet. Se
deb-src-control(5) för ytterligare detaljer.
- Testsuite:
namnlist
- Fältet anger att källkodspaketet innehåller de
angivna testsviterna. Värdet är en kommaavdelad lista med
testsviter. Om värder autopkttest finns,
förväntas det att debian/test/control finns, om filen
finns men inte värdet kommer dpkg-source automatiskt
lägga till på det och bibehålla tidigare
värden.
- Testsuite-Triggers:
paketlista
- Fältet anger den kommaavdelade unionen av alla testberoenden
(fältet Depends i filen debian/tests/control), med
alla begränsningar borttagna, och ELLER-beroenden tillplattade (det
vill säga, konverterade till separata OCH-relationer), med undantag
för binärar som skapas av detta källkodspaket och
dess metaberoende-motsvarighet @.
Grund: fältet behövs eftersom man annars
för att kunna hämta testbeorenden måste packa upp
alla källkodspaketen.
- Build-Depends:
paketlista
- Build-Depends-Arch:
paketlista
- Build-Depends-Indep:
paketlista
- Build-Conflicts:
paketlista
- Build-Conflicts-Arch:
paketlista
- Build-Conflicts-Indep:
paketlista
- Dessa fält anger relationer mellan källkodspaket och de
paket som används för att bygga det. De diskuteras i
manualsidan deb-src-control(5).
- Package-List:
- paket pakettyp sektion prioritet
nyckel-värde-lista
- Det här flerradiga fältet innehåller en lista
över binärpaket som skapas av detta källkodspaket.
paket är namnet på
binärpaketet.
pakettyp är typen på det binära
paketet, vanligtvis deb, ett annat vanligt värde är
udeb.
sektion och prioritet motsvarar fälten
med samma namn i binärpaketet.
nyckel-värde-lista är en
blankstegsavdelad lista på formen
nyckel=värde, och de för
närvarande kända valfria nycklarna är:
- arch
- Arkitekturbegränsning från binärpaketets fält
Architecture, med blanksteg ersatta med ”,”.
- profile
- Den normaliserade byggprofil-begränsningsformeln från
binärpaketets fält Build-Profile, med OR (eller)
ersatt med ”+” och AND (och) med ”,”.
- protected
- Om binärpaketet är skyddat kommer den här nyckeln
innehålla värdet på fältet Protected,
det vill säga värdet yes.
Stöds sedan dpkg 1.20.1.
- essential
- Om binärpaketet är systemkritiskt kommer den här
nyckeln innehålla värdet på fältet
Essential, det vill säga värdet yes.
- Files:
(krävs)
- Checksums-Sha1:
(krävs)
- Checksums-Sha256:
(krävs)
- kontrollsumma storlek filnamn
- De här flerradsfälteten innehåller en lista med filer
med en kontrollsumma och storlek för var och en. Fälten har
samma syntax och skiljer sig bara vad gäller vilken
kontrollsummealgoritm som används: MD5 för Files,
SHA-1 för Checksums-Sha1 och SHA-256 för
Checksums-Sha256.
Första raden i fältvärdet (delen av
på samma rad som fältnamnet följt av kolon)
är alltid tom. Innehållet i fältet anges som
fortsättningsrader, en rad per fil. Varje rad består av
kontrollsumman, ett blanksteg, filstorleken, ett blanksteg och
filnamnet.
De här fälten visar alla filer
källkodspaketet består av. Listan över filer i
dessa fält måste motsvara listan över filer i de
andra relaterade fälten.
Fältet Format blandar formatet på
själva .dsc-filen och formatet på det extraherade
källkodspaketet.
ÖVERSÄTTNING
Peter Krefting och Daniel Nylander.