dpkg (1.18.25) stretch; urgency=medium
[dpkg] / man / de / dsc.man
CommitLineData
1479465f
GJ
1.\" dpkg manual page - dsc(5)
2.\"
3.\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk>
4.\" Copyright © 2015 Guillem Jover <guillem@debian.org>
5.\"
6.\" This is free software; you can redistribute it and/or modify
7.\" it under the terms of the GNU General Public License as published by
8.\" the Free Software Foundation; either version 2 of the License, or
9.\" (at your option) any later version.
10.\"
11.\" This is distributed in the hope that it will be useful,
12.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
13.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14.\" GNU General Public License for more details.
15.\"
16.\" You should have received a copy of the GNU General Public License
17.\" along with this program. If not, see <https://www.gnu.org/licenses/>.
18.
19.\"*******************************************************************
20.\"
21.\" This file was generated with po4a. Translate the source file.
22.\"
23.\"*******************************************************************
24.TH dsc 5 %RELEASE_DATE% %VERSION% dpkg\-Programmsammlung
25.nh
26.SH BEZEICHNUNG
27dsc \- Format der Quellpaketsteuerdatei von Debian
28.
29.SH ÜBERSICHT
30\fIDateiname\fP\fB.dsc\fP
31.
32.SH BESCHREIBUNG
33Jedes Debian\-Quellpaket besteht aus einer .dsc\-Steuerdatei, die eine Reihe
34von Feldern enthält.Jedes Feld beginnt mit einer Markierung, wie \fBSource\fP
35oder \fBBinary\fP (Groß\-/Kleinschreibung egal), gefolgt von einem Doppelpunkt
36und dem Körper des Feldes. Felder werden nur durch die Feldmarkierungen
37abgegrenzt. Mit anderen Worten, Feldtexte können mehrere Zeilen überspannen,
38aber die Installationswerkzeuge werden im Allgemeinen die Zeilen bei der
39Verarbeitung des Feldkörpers zusammenfassen (mit Ausnahme der mehrzeiligen
40Felder \fBPackage\-List\fP, \fBFiles\fP, \fBChecksums\-Sha1\fP und \fBChecksums\-Sha256\fP,
41sehen Sie dazu unten).
42.PP
43Die Steuerdaten können in eine Signatur mit einer wie in RFC4880
44spezifizierten OpenPGP\-ASCII\-Hülle eingeschlossen sein.
45.
46.SH FELDER
47.TP
48\fBFormat:\fP \fIFormatversion\fP (verpflichtend)
49Der Wert des Feldes gibt die Formatversion des Quellpaketes an. Der Feldwert
50wird von Programmen, die mit Quellpaketen arbeiten, verwandt, um die Liste
51der Dateien in dem Quellpaket zu interpretieren und zu bestimmen, wie es
52entpackt wird. Die Syntax des Feldwertes ist eine numerische Hauptrevision,
53ein Satzpunkt, eine numerische Unterrevision und dann ein optionaler
54Untertyp nach einem Leerzeichen. Falls dieser spezifiziert wird, ist er ein
55alphanumerisches Wort in Anführungszeichen. Der Untertyp ist in der Syntax
56optional, kann aber für eine bestimmte Quellformatrevision verpflichtend
57sein.
58
59Die von \fBdpkg\fP derzeit unterstützten Quellformate sind \fB1.0\fP, \fB2.0\fP,
60\fB3.0 (native)\fP, \fB3.0 (quilt)\fP, \fB3.0 (git)\fP, \fB3.0 (bzr)\fP und \fB3.0
61(custom)\fP.
62.TP
63\fBSource:\fP \fIQuellname\fP (verpflichtend)
64Der Wert dieses Feldes bestimmt den Paketnamen und wird von den meisten
65Installationswerkzeugen verwendet, um Dateinamen zu erstellen.
66.TP
67\fBBinary:\fP\fI Binär\-Paketliste\fP
68Dieses gefaltete Feld führt durch Kommata getrennte Binärpakete auf, die
69dieses Quellpaket erstellen kann.
70
71Dieses Feld wurde jetzt durch das Feld \fBPackage\-List\fP ersetzt, das genug
72Informationen darüber, welche binären Pakete auf welcher Architektur
73erstellt werden sowie Bauprofile und andere zugehörige Einschränkungen,
74gibt.
75.TP
76\fBArchitecture:\fP \fIArchitekturliste\fP (empfohlen)
77Eine durch Leerzeichen getrennte Liste von Architekturen und
78Architekturplatzhaltern, die den Typ der Hardware festlegen, für die das
79Paket übersetzt werden kann. Typische Architekturnamen und
80Architekturplatzhalter sind \fBamd64\fP, \fBarmel\fP, \fBi386\fP, \fBlinux\-any\fP,
81\fBany\-amd64\fP usw.
82
83Beachten Sie, dass der Wert \fBall\fP für Pakete gedacht ist, die unabhängig
84von der Achitektur sind und \fBany\fP für Pakete, die architekturabhängig
85sind. Die Liste kann den Wert \fBall\fP enthalten oder aus ihm alleine
86bestehen. Wenn die Liste den Architekturplatzhalter \fBany\fP enthält, ist der
87einzig andere in der Liste erlaubte Wert \fBall\fP.
88
89Der Feldwert wird im Allgemeinen aus den \fBArchitecture\fP\-Feldern aus der
90\fIdebian/control\fP des Quellpaketes erstellt.
91.TP
92\fBVersion:\fP \fIVersionszeichenkette\fP (verpflichtend)
93Typischerweise ist das die Original\-Paketversionsnummer, in der Form, die
94der Programmautor verwendet. Es kann auch eine Debian\-Revisionsnummer
95enthalten (für nicht aus Debian stammende Pakete). Das genaue Format und der
96Sortieralgorithmus sind in \fBdeb\-version\fP(5) beschrieben.
97.TP
98\fBOrigin:\fP\fI Name\fP
99Der Name der Distribution, aus der dieses Paket ursprünglich stammt.
100.TP
101\fBMaintainer:\fP \fIVollständiger\-Name\-und\-E\-Mail\fP (empfohlen)
102Sollte in dem Format „Joe Bloggs <jbloggs@foo.com>“ sein und ist
103typischerweise die Person, die das Paket erstellt hat, im Gegensatz zum
104Autor der Software, die paketiert wurde.
105.TP
106\fBUploaders:\fP\fI Vollständiger\-Name\-und\-E\-Mail\-Liste\fP
107Listet die Namen und E\-Mail\-Adressen der Ko\-Betreuer des Pakets auf, im
108gleichen Format wie das Feld \fBMaintainer\fP. Mehrere Ko\-Betreuer sollten
109durch Kommata getrennt werden.
110.TP
111\fBHomepage:\fP\fI URL\fP
112Die \fIURL\fP des Original\- (Upstream\-)Projekts.
113.TP
114\fBStandards\-Version:\fP \fI Versionszeichenkette\fP (empfohlen)
115Dies dokumentiert die neuste Version der Standards der Distribution, an den
116sich das Paket hält.
117.TP
118\fBVcs\-Browser:\fP\fI URL\fP
119Die \fIURL\fP der Webschnittstelle, um das Versionskontrollsystem\-Depot
120anzuschauen.
121.TP
122\fBVcs\-Arch*:\fP\fI URL\fP
123.TQ
124\fBVcs\-Bzr:\fP\fI URL\fP
125.TQ
126\fBVcs\-Cvs:\fP\fI URL\fP
127.TQ
128\fBVcs\-Darcs:\fP\fI URL\fP
129.TQ
130\fBVcs\-Git:\fP\fI URL\fP
131.TQ
132\fBVcs\-Hg:\fP\fI URL\fP
133.TQ
134\fBVcs\-Mtn:\fP\fI URL\fP
135.TQ
136\fBVcs\-Svn:\fP\fI URL\fP
137Diese Felder verkünden die \fIURL\fP des Versionskontrollsystem\-Depots, das für
138die Betreuung des Pakets verwandt wird. Siehe \fBdeb\-src\-control\fP(5) für
139weitere Details.
140.TP
141\fBTestsuite:\fP\fI Namenliste\fP
142Dieses Feld verkündigt, dass das Quellpaket die angegebene Testsammlung
143enthält. Der Wert ist eine durch Leerzeichen getrennte Liste von
144Testsammlungen. Falls der Wert \fBautopkgtest\fP vorkommt, wird erwartet, dass
145\fIdebian/tests/control\fP vorhanden ist. Falls nur die Datei aber nicht der
146Wert vorhanden ist, wird \fBdpkg\-source\fP den Wert automatisch (unter
147Beibehaltung der vorherigen Werte) hinzufügen.
148.TP
149\fBTestsuite\-Triggers:\fP\fI Paketliste\fP
150This field declares the comma\-separated union of all test dependencies
151(\fBDepends\fP fields in \fIdebian/tests/control\fP file), with all restrictions
152removed, and OR dependencies flattened, except for binaries generated by
153this source package and meta\-dependencies such as \fB@\fP or \fB@builddeps@\fP.
154
155Hintergrund: Dieses Feld wird benötigt, da andernfalls jedes Quellpaket
156entpackt werden müsste, um die Testabhängigkeiten zu ermitteln.
157.TP
158\fBBuild\-Depends:\fP\fI Paketliste\fP
159.TQ
160\fBBuild\-Depends\-Arch:\fP\fI Paketliste\fP
161.TQ
162\fBBuild\-Depends\-Indep:\fP\fI Paketliste\fP
163.TQ
164\fBBuild\-Conflicts:\fP\fI Paketliste\fP
165.TQ
166\fBBuild\-Conflicts\-Arch:\fP\fI Paketliste\fP
167.TQ
168\fBBuild\-Conflicts\-Indep:\fP\fI Paketliste\fP
169Diese Felder verkünden die Beziehungen zwischen dem Quellpaket und Paketen,
170die daraus gebaut werden. Sie werden in der Handbuchseite \fBdeb\-control\fP(5)
171beschrieben.
172.TP
173\fBPackage\-List:\fP
174.TQ
175 \fIPaket\fP \fIPakettyp\fP \fISektion\fP \fIPriorität\fP \fISchlüssel\-Wert\-Liste\fP
176Dieses mehrzeilige Feld enthält eine Liste von Binärpaketen, die von diesem
177Quellpaket erstellt werden.
178
179Das \fIPaket\fP ist der Name des Binärpakets.
180
181Der \fIPakettyp\fP ist der binäre Pakettyp, normalerweise \fBdeb\fP, \fBudeb\fP ist
182ein anderer häufiger Wert.
183
184\fISektion\fP und \fIPriorität\fP entsprechen den Feldern \fIsection\fP und
185\fIpriority\fP des Binärpakets.
186
187Die \fISchlüssel\-Wert\-Liste\fP ist eine durch Leerzeichen getrennte
188\fISchlüssel\fP\fB=\fP\fIWert\fP\-Liste und die derzeit erkannten optionalen Schlüssel
189sind:
190
191.RS
192.TP
193\fBarch\fP
194Die Architektureinschränkungen aus dem Feld \fBArchitecture\fP des Binärpakets,
195wobei Leerzeichen zu ‚,’ konvertiert wurden.
196.TP
197\fBprofile\fP
198Die normalisierte Bauprofileinschränkungsformel aus dem Feld
199\fBBuild\-Profile\fP des Binärpakets, wobei »OR« in ‚+’ und »AND« in ‚,’
200umgewandelt wurden.
201.TP
202\fBessential\fP
203Falls das Binärpaket »essential« ist, wird der Schlüssel den Wert des Feldes
204\fBEssential\fP enthalten, der \fByes\fP lautet.
205.RE
206.TP
207\fBFiles:\fP (verpflichtend)
208.TQ
209\fBChecksums\-Sha1:\fP (verpflichtend)
210.TQ
211\fBChecksums\-Sha256:\fP (verpflichtend)
212.TQ
213 \fIPrüfsumme\fP \fIGröße\fP \fIDateiname\fP
214Diese mehrzeiligen Felder enthalten eine Liste von Dateien mit einer
215Prüfsumme und Größe für jede. Diese Felder haben die gleiche Syntax und
216unterscheiden sich nur im verwandten Prüfsummenalgorithmus: MD5 für
217\fBFiles\fP, SHA\-1 für \fBChecksums\-Sha1\fP und SHA\-256 für \fBChecksums\-Sha256\fP.
218
219Die erste Zeile des Feldwertes (der Teil auf dem durch ein Doppelpunkt
220gefolgten Feldnamen) ist immer leer. Der Inhalt des Feldes wird durch
221Fortsetzungszeilen ausgedrückt, eine Zeile pro Datei. Jede Zeile besteht aus
222der Prüfsumme, einem Leerzeichen, der Dateigröße, einem Leerzeichen und dem
223Dateinamen.
224
225Diese Felder führen alle Dateien auf, die das Quellpaket darstellen. Die
226Liste der Dateien in diesen Feldern muss auf die Liste der Dateien in den
227anderen dazugehörigen Feldern passen.
228.
229.\" .SH EXAMPLE
230.\" .RS
231.\" .nf
232.\" .fi
233.\" .RE
234.
235.SH FEHLER
236Das Feld \fBFormat\fP fügt das Format für die Datei \fB.dsc\fP und das Format des
237extrahierten Quellpakets zusammen.
238.SH "SIEHE AUCH"
239\fBdeb\-src\-control\fP(5), \fBdeb\-version\fP(5), \fBdpkg\-source\fP(1).
240.SH ÜBERSETZUNG
241Die deutsche Übersetzung wurde 2004, 2006-2017 von Helge Kreutzmann
242<debian@helgefjell.de>, 2007 von Florian Rehnisch <eixman@gmx.de> und
2432008 von Sven Joachim <svenjoac@gmx.de>
244angefertigt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die
245GNU General Public License Version 2 oder neuer für die Kopierbedingungen.
246Es gibt KEINE HAFTUNG.