.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "dsc 5"
.TH dsc 5 2024-01-24 1.22.4 "dpkg suite"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAMN
.IX Header "NAMN"
dsc \- styrfilformat f\(:or Debians k\(:allkodspaket
.SH SYNOPS
.IX Header "SYNOPS"
\&\fIfilnamn\fR\fB.dsc\fR
.SH BESKRIVNING
.IX Header "BESKRIVNING"
Alla Debian\-k\(:allkodspaket best\(oar av en .dsc\-styrfil, vilken best\(oar av ett antal f\(:alt i \fBdeb822\fR\|(5)\-format.
.PP
Varje f\(:alt b\(:orjar med en etikett, s\(oasom \fBSource\fR eller \fBBinary\fR (skiftl\(:agesoberoende), f\(:oljt av ett kolontecken och f\(:altets kropp (skiftl\(:agesberoende s\(oavida inte annat anges). F\(:alt avdelas endast av f\(:altetiketter. Med andra ord kan texten i f\(:alten sp\(:anna \(:over flera rader, men installationsverktygen kommer oftast att sl\(oa samman rader n\(:ar kroppen tolkas (f\(:orutom n\(:ar det g\(:aller flerradsf\(:alten \fBPackage-List\fR, \fBFiles\fR, \fBChecksums\-Sha1\fR and \fBChecksums\-Sha256\fR, se nedan).
.PP
Styrinformationen kan omges av en OpenPGP-signatur i ASCII-skal, s\(oasom beskrivs i RFC4880.
.SH F\(:ALT
.IX Header "F\(:ALT"
.IP "\fBFormat:\fR \fIformatversion\fR (kr\(:avs)" 4
.IX Item "Format: formatversion (kr\(:avs)"
V\(:ardet p\(oa det h\(:ar f\(:altet deklarerar formatversionen f\(:or k\(:allkodspaketet. F\(:altv\(:ardet anv\(:ands av program som arbetar p\(oa k\(:allkodspaket f\(:or att tolka listan \(:over filer i k\(:allkodspaketet och best\(:amma hur det ska pakcas upp. Syntaxen f\(:or f\(:altet \(:ar ett huvudversionsnummer (\(rq0\-9\(rq), en punkt (\(rq.\(rq), ett numeriskt underversionsnummer (\(rq0\-9\(rq), och d\(:arefter en valfri undertyp efter ett blanksteg (\(rq \et\(rq), vilket, om det anges, \(:ar ett ord med sm\(oa alfanumeriska (\(rqa\-z0\-9\(rq) tecken i paranteser (\(rq()\(rq). Undetypen \(:ar valfri i syntaxen men kan kr\(:avas f\(:or specifika k\(:allkodsformatversioner.
.Sp
De k\(:allkodsformat som f\(:or n\(:arvarande st\(:ods av \fBdpkg\fR \(:ar \fB1.0\fR, \fB2.0\fR, \fB3.0 (native)\fR, \fB3.0 (quilt)\fR, \fB3.0 (git)\fR, \fB3.0 (bzr)\fR och \fB3.0 (custom)\fR. Se \fBdpkg\-source\fR\|(1) f\(:or beskrivningar.
.IP "\fBSource:\fR \fIk\(:allkodsnamn\fR (kr\(:avs)" 4
.IX Item "Source: k\(:allkodsnamn (kr\(:avs)"
V\(:ardet p\(oa f\(:altet best\(:ammer paketets namn, och anv\(:ands av de flesta installationsverktygen f\(:or att generera filnamnen.
.IP "\fBBinary:\fR \fIbin\(:arpaketlista\fR" 4
.IX Item "Binary: bin\(:arpaketlista"
Det h\(:ar flerdelade f\(:altet listar bin\(:arpaket som detta k\(:allkodspaket kan producera, avdelade med kommatecken.
.Sp
F\(:altet har nu ersatts av f\(:altet \fBPackage-List\fR, som ger tillr\(:acklig information om vilka bin\(:arpaket som skapas p\(oa vilka arkitekturer, byggprofiler och andra inverkande begr\(:ansningar.
.IP "\fBArchitecture:\fR \fIarkitekturlista\fR (rekommenderas)" 4
.IX Item "Architecture: arkitekturlista (rekommenderas)"
En lista \(:over arkitekturer och arkitekturm\(:onster avdelade med blanksteg som anger vilken typ av maskinvara paketet kan kompileras f\(:or. Vanliga arkitekturnamn och arkitekturm\(:onster \(:ar \fBamd64\fR, \fBarmel\fR, \fBi386\fR, \fBlinux-any\fR, \fBany\-amd64\fR, osv.
.Sp
Observar att v\(:ardet \fBall\fR \(:ar t\(:ankt f\(:or paket som \(:ar plattformsoberoende, och \fBany\fR f\(:or paket som \(:ar arkitekturberoende. Listan kan inneh\(oalla (eller enbart best\(oa av) specialv\(:ardet \fBall\fR. N\(:ar listan inneh\(oaller arkitekturm\(:onstret \fBany\fR \(:ar det enda andra till\(oatna v\(:ardet i listan \fBall\fR.
.Sp
F\(:altv\(:ardet genereras normalt fr\(oan f\(:alten \fBArchitecture\fR i filen \fIdebian/control\fR i k\(:allkodspaketet.
.IP "\fBVersion:\fR \fIversionsstr\(:ang\fR (kr\(:avs)" 4
.IX Item "Version: versionsstr\(:ang (kr\(:avs)"
Vanligtvis \(:ar detta det ursprungliga paketets versionsnummer p\(oa den form programmets f\(:orfattare anv\(:ander. Den kan \(:aven inneh\(oalla ett Debianuppdateringsnummer (f\(:or paket vars k\(:alla \(:ar utanf\(:or Debian). Exakt format och sorteringsalgoritm beskrivs i \fBdeb\-version\fR\|(7).
.IP "\fBOrigin:\fR \fInamn\fR" 4
.IX Item "Origin: namn"
Namnet p\(oa den distribution paketet h\(:arstammar fr\(oan.
.IP "\fBMaintainer:\fR \fIfullt-namn-epost\fR (rekommenderas)" 4
.IX Item "Maintainer: fullt-namn-epost (rekommenderas)"
Ska vara p\(oa formatet \(rqJoe Bloggs <jbloggs@foo.com>\(rq och \(:ar normalt sett den person som skapat paketet, till skillnad fr\(oan f\(:orfattaren av den programvara som paketerades.
.IP "\fBUploaders:\fR \fIfullt-namn-epost-lista\fR" 4
.IX Item "Uploaders: fullt-namn-epost-lista"
R\(:aknar upp namn och e\-postadresser till med\-underh\(oallare av paketet, i samma format som f\(:altet \fBMaintainer\fR. Flera med\-underh\(oallare b\(:or avdelas med kommatecken.
.IP "\fBDescription:\fR \fIkort-beskrivning\fR)" 4
.IX Item "Description: kort-beskrivning)"
.PD 0
.IP "\ \fIl\(oang\-beskrivning\fR" 4
.IX Item " l\(oang-beskrivning"
.PD
Formatet f\(:or k\(:allkodspaketbeskrivningen \(:ar en kortfattad sammanfattning p\(oa den f\(:orsta raden (efter f\(:altet \fBDescription\fR). F\(:oljande rader b\(:or anv\(:andas f\(:or en l\(:angre, mer detaljerad beskrivning. Varje rad i den l\(:agre beskrivningen m\(oaste inledas med ett blanksteg, och blanka rader i den l\(oanga beskrivningen m\(oaste inneh\(oalla en ensam \(rq\fB.\fR\(rq efter det inledande blanksteget.
.IP "\fBHomepage:\fR \fIurl\fR" 4
.IX Item "Homepage: url"
URL till uppstr\(:omsprojektets hemside\-\fIurl\fR.
.IP "\fBStandards-Version:\fR \fIversionsstr\(:ang\fR (rekommenderas)" 4
.IX Item "Standards-Version: versionsstr\(:ang (rekommenderas)"
Dokumenterar den senaste versionen av distributionens policystandard som paketet uppfyller.
.IP "\fBVcs-Browser:\fR \fIurl\fR" 4
.IX Item "Vcs-Browser: url"
\&\fIUrl\fR:en till ett webbgr\(:anssnitt f\(:or att bl\(:addra i versionshanteringsarkivet.
.IP "\fBVcs-Arch:\fR \fIurl\fR" 4
.IX Item "Vcs-Arch: url"
.PD 0
.IP "\fBVcs-Bzr:\fR \fIurl\fR" 4
.IX Item "Vcs-Bzr: url"
.IP "\fBVcs-Cvs:\fR \fIurl\fR" 4
.IX Item "Vcs-Cvs: url"
.IP "\fBVcs-Darcs:\fR \fIurl\fR" 4
.IX Item "Vcs-Darcs: url"
.IP "\fBVcs-Git:\fR \fIurl\fR" 4
.IX Item "Vcs-Git: url"
.IP "\fBVcs-Hg:\fR \fIurl\fR" 4
.IX Item "Vcs-Hg: url"
.IP "\fBVcs-Mtn:\fR \fIurl\fR" 4
.IX Item "Vcs-Mtn: url"
.IP "\fBVcs-Svn:\fR \fIurl\fR" 4
.IX Item "Vcs-Svn: url"
.PD
Dessa f\(:alt anger \fIurl\fR till det versionshanteringssystemakriv som anv\(:ands f\(:or att underh\(oalla paketet. Se \fBdeb\-src\-control\fR\|(5) f\(:or ytterligare detaljer.
.IP "\fBTestsuite:\fR \fInamnlist\fR" 4
.IX Item "Testsuite: namnlist"
F\(:altet anger att k\(:allkodspaketet inneh\(oaller de angivna testsviterna. V\(:ardet \(:ar en kommaavdelad lista med testsviter. Om v\(:arder \fBautopkttest\fR finns, f\(:orv\(:antas det att \fIdebian/test/control\fR finns, om filen finns men inte v\(:ardet kommer \fBdpkg-source\fR automatiskt l\(:agga till p\(oa det och bibeh\(oalla tidigare v\(:arden.
.IP "\fBTestsuite-Triggers:\fR \fIpaketlista\fR" 4
.IX Item "Testsuite-Triggers: paketlista"
F\(:altet anger den kommaavdelade unionen av alla testberoenden (f\(:altet \fBDepends\fR i filen \fIdebian/tests/control\fR), med alla begr\(:ansningar borttagna, och ELLER-beroenden tillplattade (det vill s\(:aga, konverterade till separata OCH-relationer), med undantag f\(:or bin\(:arar som skapas av detta k\(:allkodspaket och dess metaberoende-motsvarighet \fB@\fR.
.Sp
\&\fBGrund\fR: f\(:altet beh\(:ovs eftersom man annars f\(:or att kunna h\(:amta testbeorenden m\(oaste packa upp alla k\(:allkodspaketen.
.IP "\fBBuild-Depends:\fR \fIpaketlista\fR" 4
.IX Item "Build-Depends: paketlista"
.PD 0
.IP "\fBBuild-Depends-Arch:\fR \fIpaketlista\fR" 4
.IX Item "Build-Depends-Arch: paketlista"
.IP "\fBBuild-Depends-Indep:\fR \fIpaketlista\fR" 4
.IX Item "Build-Depends-Indep: paketlista"
.IP "\fBBuild-Conflicts:\fR \fIpaketlista\fR" 4
.IX Item "Build-Conflicts: paketlista"
.IP "\fBBuild-Conflicts-Arch:\fR \fIpaketlista\fR" 4
.IX Item "Build-Conflicts-Arch: paketlista"
.IP "\fBBuild-Conflicts-Indep:\fR \fIpaketlista\fR" 4
.IX Item "Build-Conflicts-Indep: paketlista"
.PD
Dessa f\(:alt anger relationer mellan k\(:allkodspaket och de paket som anv\(:ands f\(:or att bygga det. De diskuteras i manualsidan \fBdeb\-src\-control\fR\|(5).
.IP \fBPackage-List:\fR 4
.IX Item "Package-List:"
.PD 0
.IP "\ \fIpaket\fR \fIpakettyp\fR \fIsektion\fR \fIprioritet\fR \fInyckel\-v\(:arde\-lista\fR" 4
.IX Item " paket pakettyp sektion prioritet nyckel-v\(:arde-lista"
.PD
Det h\(:ar flerradiga f\(:altet inneh\(oaller en lista \(:over bin\(:arpaket som skapas av detta k\(:allkodspaket.
.Sp
\&\fIpaket\fR \(:ar namnet p\(oa bin\(:arpaketet.
.Sp
\&\fIpakettyp\fR \(:ar typen p\(oa det bin\(:ara paketet, vanligtvis \fBdeb\fR, ett annat vanligt v\(:arde \(:ar \fBudeb\fR.
.Sp
\&\fIsektion\fR och \fIprioritet\fR motsvarar f\(:alten med samma namn i bin\(:arpaketet.
.Sp
\&\fInyckel\-v\(:arde\-lista\fR \(:ar en blankstegsavdelad lista p\(oa formen \fInyckel\fR\fB=\fR\fIv\(:arde\fR, och de f\(:or n\(:arvarande k\(:anda valfria nycklarna \(:ar:
.RS 4
.IP \fBarch\fR 4
.IX Item "arch"
Arkitekturbegr\(:ansning fr\(oan bin\(:arpaketets f\(:alt \fBArchitecture\fR, med blanksteg ersatta med \(rq,\(rq.
.IP \fBprofile\fR 4
.IX Item "profile"
Den normaliserade byggprofil\-begr\(:ansningsformeln fr\(oan bin\(:arpaketets f\(:alt \fBBuild-Profile\fR, med OR (eller) ersatt med \(rq+\(rq och AND (och) med \(rq,\(rq.
.IP \fBprotected\fR 4
.IX Item "protected"
Om bin\(:arpaketet \(:ar skyddat kommer den h\(:ar nyckeln inneh\(oalla v\(:ardet p\(oa f\(:altet \fBProtected\fR, det vill s\(:aga v\(:ardet \fByes\fR.
.Sp
St\(:ods sedan dpkg 1.20.1.
.IP \fBessential\fR 4
.IX Item "essential"
Om bin\(:arpaketet \(:ar systemkritiskt kommer den h\(:ar nyckeln inneh\(oalla v\(:ardet p\(oa f\(:altet \fBEssential\fR, det vill s\(:aga v\(:ardet \fByes\fR.
.RE
.RS 4
.RE
.IP "\fBFiles:\fR (kr\(:avs)" 4
.IX Item "Files: (kr\(:avs)"
.PD 0
.IP "\fBChecksums\-Sha1:\fR (kr\(:avs)" 4
.IX Item "Checksums-Sha1: (kr\(:avs)"
.IP "\fBChecksums\-Sha256:\fR (kr\(:avs)" 4
.IX Item "Checksums-Sha256: (kr\(:avs)"
.IP "\ \fIkontrollsumma\fR \fIstorlek\fR \fIfilnamn\fR" 4
.IX Item " kontrollsumma storlek filnamn"
.PD
De h\(:ar flerradsf\(:alteten inneh\(oaller en lista med filer med en kontrollsumma och storlek f\(:or var och en. F\(:alten har samma syntax och skiljer sig bara vad g\(:aller vilken kontrollsummealgoritm som anv\(:ands: MD5 f\(:or \fBFiles\fR, SHA\-1 f\(:or \fBChecksums\-Sha1\fR och SHA\-256 f\(:or \fBChecksums\-Sha256\fR.
.Sp
F\(:orsta raden i f\(:altv\(:ardet (delen av p\(oa samma rad som f\(:altnamnet f\(:oljt av kolon) \(:ar alltid tom. Inneh\(oallet i f\(:altet anges som forts\(:attningsrader, en rad per fil. Varje rad best\(oar av kontrollsumman, ett blanksteg, filstorleken, ett blanksteg och filnamnet.
.Sp
De h\(:ar f\(:alten visar alla filer k\(:allkodspaketet best\(oar av. Listan \(:over filer i dessa f\(:alt m\(oaste motsvara listan \(:over filer i de andra relaterade f\(:alten.
.SH PROGRAMFEL
.IX Header "PROGRAMFEL"
F\(:altet \fBFormat\fR blandar formatet p\(oa sj\(:alva \fB.dsc\fR\-filen och formatet p\(oa det extraherade k\(:allkodspaketet.
.SH "SE \(:AVEN"
.IX Header "SE \(:AVEN"
\&\fBdeb822\fR\|(5), \fBdeb\-src\-control\fR\|(5), \fBdeb\-version\fR\|(7), \fBdpkg\-source\fR\|(1).
.SH \(:OVERS\(:ATTNING
.IX Header "\(:OVERS\(:ATTNING"
Peter Krefting och Daniel Nylander.