Provided by: dpkg-dev_1.22.18ubuntu3_all 
BEZEICHNUNG
dsc - Format der Quellpaketsteuerdatei von Debian
ÜBERSICHT
Dateiname.dsc
BESCHREIBUNG
Jedes Debian-Quellpaket besteht aus einer .dsc-Steuerdatei, die eine Reihe von Feldern im
deb822(5)-Format enthält.
Jedes Feld beginnt mit einer Markierung, wie Source oder Binary (Groß-/Kleinschreibung egal), gefolgt von
einem Doppelpunkt und dem Inhalt des Feldes (Groß-/Kleinschreibung ist relevant, außer anders angegeben).
Felder werden nur durch die Feldmarkierungen abgegrenzt. Mit anderen Worten, Feldtexte können mehrere
Zeilen überspannen, aber die Installationswerkzeuge werden im Allgemeinen die Zeilen bei der Verarbeitung
des Feldinhaltes zusammenfassen (mit Ausnahme der mehrzeiligen Felder Package-List, Files, Checksums-Sha1
und Checksums-Sha256, sehen Sie dazu unten).
Die Steuerdaten können in eine Signatur mit einer wie in RFC 9580 spezifizierten OpenPGP-ASCII-Hülle
eingeschlossen sein.
FELDER
Format: Formatversion (verpflichtend)
Der Wert des Feldes gibt die Formatversion des Quellpaketes an. Der Feldwert wird von Programmen, die
mit Quellpaketen arbeiten, verwandt, um die Liste der Dateien in dem Quellpaket zu interpretieren und
zu bestimmen, wie es entpackt wird. Die Syntax des Feldwertes ist eine numerische Hauptrevision
(„0-9“), ein Satzpunkt („.“), eine numerische Unterrevision („0-9“) und dann ein optionaler Untertyp
nach Leerraum („ \t“). Falls dieser angegeben wird, ist er ein klein geschriebenes alphanumerisches
(„a-z0-9“) Wort in Klammern („()“). Der Untertyp ist in der Syntax optional, kann aber für eine
bestimmte Quellformatrevision verpflichtend sein.
Die von dpkg derzeit unterstützten Quellformate sind 1.0, 2.0, 3.0 (native), 3.0 (quilt), 3.0 (git),
3.0 (bzr) und 3.0 (custom). Siehe dpkg-source(1) für ihre Beschreibung.
Source: Quellname (verpflichtend)
Der Wert dieses Feldes bestimmt den Paketnamen und wird von den meisten Installationswerkzeugen
verwendet, um Dateinamen zu erstellen.
Binary: Binär-Paketliste
Dieses gefaltete Feld führt durch Kommata getrennte Binärpakete auf, die dieses Quellpaket erstellen
kann.
Dieses Feld wurde jetzt durch das Feld Package-List ersetzt, das genug Informationen darüber gibt,
welche binären Pakete auf welcher Architektur erstellt werden sowie Bauprofile und andere zugehörige
Einschränkungen.
Architecture: Architekturliste (empfohlen)
Eine durch Leerzeichen getrennte Liste von Architekturen und Architekturplatzhaltern, die den Typ der
Hardware festlegen, für die das Paket übersetzt werden kann. Typische Architekturnamen und
Architekturplatzhalter sind amd64, armel, i386, linux-any, any-amd64 usw.
Beachten Sie, dass der Wert all für Pakete gedacht ist, die unabhängig von der Architektur sind und
any für Pakete, die architekturabhängig sind. Die Liste kann den Wert all enthalten oder aus ihm
alleine bestehen. Wenn die Liste den Architekturplatzhalter any enthält, ist der einzig andere in der
Liste erlaubte Wert all.
Der Feldwert wird im Allgemeinen aus den Architecture-Feldern aus der debian/control des Quellpaketes
erstellt.
Version: Versionszeichenkette (verpflichtend)
Typischerweise ist das die Original-Paketversionsnummer, in der Form, die der Programmautor
verwendet. Es kann auch eine Debian-Revisionsnummer enthalten (für nicht aus Debian stammende
Pakete). Das genaue Format und der Sortieralgorithmus sind in deb-version(7) beschrieben.
Origin: Name
Der Name der Distribution, aus der dieses Paket ursprünglich stammt.
Maintainer: Vollständiger-Name-und-E-Mail (empfohlen)
Sollte in dem Format „Joe Bloggs <jbloggs@foo.com>“ sein und ist typischerweise die Person, die das
Paket erstellt hat, im Gegensatz zum Autor der Software, die paketiert wurde.
Uploaders: Vollständiger-Name-und-E-Mail-Liste
Listet die Namen und E-Mail-Adressen der Ko-Betreuer des Pakets auf, im gleichen Format wie das Feld
Maintainer. Mehrere Ko-Betreuer sollten durch Kommata getrennt werden.
Description Kurzbeschreibung
Langbeschreibung
Das Format der Quellpaketbeschreibung ist eine kurze knappe Zusammenfassung auf der ersten Zeile
(nach dem Feld Description). Die folgenden Zeilen sollten als längere, detailliertere Beschreibung
verwendet werden. Jede Zeile der Langbeschreibung muss von einem Leerzeichen begonnen werden, und
Leerzeilen in der Langbeschreibung müssen einen einzelnen ‚.’ hinter dem einleitenden Leerzeichen
enthalten.
Homepage: URL
Die URL des Original- (Upstream-)Projekts.
Standards-Version: Versionszeichenkette (empfohlen)
Dies dokumentiert die neuste Version der Standards der Distribution, an die sich das Paket hält.
Vcs-Browser: URL
Die URL der Webschnittstelle, um das Versionskontrollsystem-Depot anzuschauen.
Vcs-Arch*: URL
Vcs-Bzr: URL
Vcs-Cvs: URL
Vcs-Darcs: URL
Vcs-Git: URL
Vcs-Hg: URL
Vcs-Mtn: URL
Vcs-Svn: URL
Diese Felder geben die URL des Versionskontrollsystem-Depots, das für die Betreuung des Pakets
verwandt wird, an. Siehe deb-src-control(5) für weitere Details.
Testsuite: Namenliste
Dieses Feld gibt an, dass das Quellpaket die angegebene Testsammlung enthält. Der Wert ist eine durch
Kommata getrennte Liste von Testsammlungen. Falls der Wert autopkgtest vorkommt, wird erwartet, dass
debian/tests/control vorhanden ist. Falls nur die Datei, aber nicht der Wert vorhanden ist, wird
dpkg-source den Wert automatisch (unter Beibehaltung der vorherigen Werte) hinzufügen.
Testsuite-Triggers: Paketliste
Dieses Feld gibt die Vereinigung aller Testabhängigkeiten (Felder Depends in der Datei
debian/tests/control) an, wobei alle Einschränkungen entfernt und ODER-Abhängigkeiten verflacht (d.h.
in separate UND-Beziehungen umgewandelt) sind. Das betrifft keine Programme, die vom Quellpaket und
dessen Meta-Abhängigkeiten wie @ oder @builddeps@ erstellt wurden.
Hintergrund: Dieses Feld wird benötigt, da andernfalls jedes Quellpaket entpackt werden müsste, um
die Testabhängigkeiten zu ermitteln.
Build-Depends: Paketliste
Build-Depends-Arch: Paketliste
Build-Depends-Indep: Paketliste
Build-Conflicts: Paketliste
Build-Conflicts-Arch: Paketliste
Build-Conflicts-Indep: Paketliste
Diese Felder geben die Beziehungen zwischen dem Quellpaket und Paketen, die daraus gebaut werden, an.
Sie werden in der Handbuchseite deb-src-control(5) beschrieben.
Package-List:
Paket Pakettyp Sektion Priorität Schlüssel-Wert-Liste
Dieses mehrzeilige Feld enthält eine Liste von Binärpaketen, die von diesem Quellpaket erstellt
werden.
Das Paket ist der Name des Binärpakets.
Der Pakettyp ist der binäre Pakettyp, normalerweise deb, udeb ist ein anderer häufig vorkommender
Wert.
Sektion und Priorität entsprechen den Feldern section und priority des Binärpakets; falls sie fehlen,
ist die Vorgabe unknown bzw. optional (seit Dpkg 1.22.13).
Die Schlüssel-Wert-Liste ist eine durch Leerzeichen getrennte Schlüssel=Wert-Liste und die derzeit
erkannten optionalen Schlüssel sind:
arch
Die Architektureinschränkungen aus dem Feld Architecture des Binärpakets, wobei Leerzeichen zu
‚,’ konvertiert wurden.
profile
Die normalisierte Bauprofileinschränkungsformel aus dem Feld Build-Profile des Binärpakets, wobei
„OR“ in ‚+’ und „AND“ in ‚,’ umgewandelt wurden.
protected
Falls das Binärpaket „protected“ ist, wird der Schlüssel den Wert des Feldes Protected enthalten,
der yes lautet.
Unterstützt seit Dpkg 1.20.1.
essential
Falls das Binärpaket „essential“ ist, wird der Schlüssel den Wert des Feldes Essential enthalten,
der yes lautet.
Files: (verpflichtend, schwach)
Checksums-Sha1: (verpflichtend, schwach)
Checksums-Sha256: (verpflichtend, stark)
Prüfsumme Größe Dateiname
Diese mehrzeiligen Felder enthalten eine Liste von Dateien mit einer Prüfsumme und Größe für jede.
Diese Felder haben die gleiche Syntax und unterscheiden sich nur im verwandten Prüfsummenalgorithmus:
MD5 für Files, SHA-1 für Checksums-Sha1 und SHA-256 für Checksums-Sha256.
Die erste Zeile des Feldwertes (der Teil auf dem durch einen Doppelpunkt gefolgten Feldnamen) ist
immer leer. Der Inhalt des Feldes wird durch Fortsetzungszeilen ausgedrückt, eine Zeile pro Datei.
Jede Zeile besteht aus der Prüfsumme, einem Leerzeichen, der Dateigröße, einem Leerzeichen und dem
Dateinamen.
Diese Felder führen alle Dateien auf, die das Quellpaket darstellen. Die Liste der Dateien in diesen
Feldern muss auf die Liste der Dateien in den anderen dazugehörigen Feldern passen.
Hinweis: Die MD5- und SHA-1-Prüfsummen werden als schwach betrachtet und sollten niemals für die
sichere Überprüfung als ausreichend betrachtet werden.
FEHLER
Das Feld Format fügt das Format für die Datei .dsc und das Format des entpackten Quellpakets zusammen.
SIEHE AUCH
deb822(5), deb-src-control(5), deb-version(7), dpkg-source(1).
ÜBERSETZUNG
Die deutsche Übersetzung wurde 2004, 2006-2025 von Helge Kreutzmann <debian@helgefjell.de>, 2007 von
Florian Rehnisch <eixman@gmx.de> und 2008 von Sven Joachim <svenjoac@gmx.de> angefertigt. Diese
Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 2 oder neuer für
die Kopierbedingungen. Es gibt KEINE HAFTUNG.
1.22.18 2025-04-28 dsc(5)