ÜBERSICHT
Dateiname.changesBESCHREIBUNG
Jedes Debian-Quellpaket besteht aus einer .dsc-Steuerdatei, die eine Reihe von Feldern enthält. Jedes Feld beginnt mit einer Markierung wie Source oder Binary (Groß-/Kleinschreibung ist egal), gefolgt von einem Doppelpunkt und dem Inhalt des Feldes. Felder werden nur durch Feldmarkierungen abgegrenzt. Mit anderen Worten: Der Feldtext kann über mehrere Zeilen gehen, wobei die Installationswerkzeuge die Zeilen bei der Verarbeitung des Feldinhaltes zusammenfügen werden (Ausnahmen sind die mehrzeiligen Felder Description, Changes, Files, Checksums-Sha1 und Checksums-Sha256, siehe unten).Die Steuerdaten können in eine Signatur mit einer wie in RFC4880 spezifizierten OpenPGP-ASCII-Hülle eingeschlossen sein.
FELDER
- Format: Formatversion (verpflichtend)
- Das Wert dieses Feldes legt die Formatversion der Datei fest. Die Syntax des Feldwertes ist eine Versionsnummer mit einer Haupt- und einer Nebenkomponente. Rückwärtsinkompatible Änderungen im Format führen zu einer Erhöhung der Hauptversion und rückwärtskompatible Änderungen (wie die Aufnahme neuer Felder) führen zu einer Erhöhung der Nebenversion. Die aktuelle Formatversion ist 1.8.
- Date: Veröffentlichungsdatum (verpflichtend)
-
Das Datum, an dem das Paket letztmalig gebaut oder bearbeitet wurde. Es muss
im gleichen Format wie in einem Eintrag bei deb-changelog(5) sein.
Der Wert dieses Feldes wird normalerweise aus der Datei debian/changelog ausgelesen.
- Source: Quellname [(Quellversion)] (verpflichtend)
- Der Name des Quellpakets. Falls sich die Quellversion von der Binärversion unterscheidet folgt dem Quellnamen in Klammern eine Quellversion. Dies kann passieren, falls dies ein rein-binärer-nicht-Betreuer-Upload ist.
- Binary: Binärpaketliste (verpflichtend)
- Dieses gefaltete Feld ist eine durch Leerzeichen getrennte Liste von hochzuladenen binären Paketen.
- Architecture: Architekturliste
- Listet die Architekturen der derzeit hochgeladenen Dateien auf. Geläufige Architekturen sind amd64, armel, i386, usw. Beachten Sie, dass der Wert all für Pakete gedacht ist, die Architektur-unabhängig sind. Falls die Quellen für das Paket auch hochgeladen werden, ist der besondere Eintrag source auch vorhanden. Architektur-Platzhalter dürfen in der Liste niemals auftauchen.
- 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(5) beschrieben.
- Distribution: Distributionen (verpflichtend)
- Listet eine oder mehrere durch Leerzeichen getrennte Distributiionen auf, bei denen diese Version installiert werden sollte, wenn es in das Archiv hochgeladen wird.
- Urgency: Dringlichkeit (empfohlen)
- Die Dringlichkeit des Uploads. Die derzeit bekannten Werte, in aufsteigender Reihenfolge der Dringlichkeit, sind: low, medium, high, critical und emergency.
- Maintainer: Vollständiger-Name-und-E-Mail (verpflichtend)
- Sollte in dem Format "Joe Bloggs <[email protected]>" sein und ist typischerweise die Person, die das Paket erstellt hat, im Gegensatz zum Autor der Software, die paketiert wurde.
- Changed-By: Vollständiger-Name-und-E-Mail
- Sollte in dem Format "Joe Bloggs <[email protected]>" sein und ist typischerweise die Person, die die Änderungen für die Veröffentlichung am Paket vorgenommen hat.
- Description: (empfohlen)
-
Binärpaketname - Binärpaketzusammenfassung Dieses mehrzeilige Feld enthält eine Liste von Binärpaketnamen, gefolgt von einem Leerzeichen, einem Gedankenstrich ('-') und ihren, möglicherweise abgeschnittenen, Kurzbeschreibungen. - Closes: Fehlernummernliste
- Eine durch Leerzeichen getrennte Liste von Fehlerberichtsnummern, die mit diesem Upload behoben wurden. Die Software des Distributionsarchivs könnte dieses Feld benutzen, um automatisch die referenzierten Fehlernummern in der Fehlerdatenbank der Distribution zu schließen.
- Binary-Only: yes
- Das Feld kennzeichnet, dass der Upload ein rein binärer, nicht-Betreuer-Upload ist. Er stammt aus dem Schlüssel/Werte-Paar binary-only=yes aus dem Metadateneintrag des Changelogs.
- Changes: (verpflichtend)
- Changelog-Einträge Das mehrzeilige Feld enthält den aneinandergehängten Text aller Changelog-Einträge, die Teil dieses Uploads sind. Um ein gültiges mehrzeiliges Feld zu erhalten, werden leere Zeilen durch ein einzelnen Satzpunkt ('.') ersetzt und alle Zeilen mit einem Leerzeichen eingerückt. Der genaue Inhalt hängt vom Changelog-Format ab.
- Files: (verpflichtend)
-
Md5sum Größe Sektion Priorität Dateiname Das mehrzeilige Feld enthält eine Liste der Dateien mit Md5sum, Größe, Sektion und Priorität für jede.Die erste Zeile des Feldwertes (dem Teil auf der gleichen Zeile wie der von einem Doppelpunkt gefolgte Feldname) ist immer leer. Der Inhalt des Feldes wird durch Fortsetzungszeilen ausgedrückt, eine Zeile pro Datei. Jede Zeile besteht aus Leerzeichen-getrennten Einträgen, die die Datei beschreiben: die Md5sum, die Dateigröße, die Datei-Sektion, die Datei-Priorität und der Dateiname.
Dieses Feld führt alle Dateien, die den Upload bilden, auf. Die Liste der Dateien in diesem Feld muss auf die Liste der Dateien in den anderen zugehörigen Checksums-Feldern passen.
- Checksums-Sha1: (verpflichtend)
-
Checksums-Sha256: (verpflichtend)
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: SHA-1 für Checksums-Sha1 und SHA-256 für Checksums-Sha256.Die erste Zeile des Feldwertes (der Teil auf dem durch ein Doppelpunkt gefolgten Namen) ist immer leer. Der Inhalt des Feldes wird durch Fortsetzungszeilen ausgedrückt, eine Zeile pro Datei. Jede Zeile besteht aus durch Leerzeichen getrennten Einträgen, die die Datei beschreiben: der Prüfsumme, der Dateigröße und dem Dateinamen.
Diese Felder führen alle Dateien auf, aus denen der Upload besteht. Die Liste der Dateien in diesen Feldern muss zu der Liste in dem Feld Files und den anderen zugehörigen Checksums-Feldern passen.