deb-changes(5) dpkg suite deb-changes(5)
BEZEICHNUNG
dpkg-genchanges - Format der Debian-Changes-Datei
ÜBERSICHT
Dateiname.changes
BESCHREIBUNG
Jeder Debian-Upload besteht aus einer .changes-Steuerdatei, die eine
Reihe von Feldern im deb822(5)-Format 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 (Groß-/Kleinschreibung ist relevant, außer anders
angegeben). Felder werden nur durch Feldmarkierungen abgegrenzt. Mit
anderen Worten: Der Feldtext kann sich über mehrere Zeilen erstrecken,
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)
Der Wert dieses Feldes gibt die Formatversion der Datei an. 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 entnommen.
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 im Kontext)
Dieses gefaltete Feld ist eine durch Leerzeichen getrennte Liste
von hochzuladenden binären Paketen. Falls es sich um einen reinen
Quell-Upload handelt, wird dieses Feld ausgelassen (seit Dpkg
1.19.3).
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(7)
beschrieben.
Distribution: Distributionen (verpflichtend)
Listet eine oder mehrere durch Leerzeichen getrennte Distributionen
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 <jbloggs@example.org>“ 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 <jbloggs@example.org>“ 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 Bindestrich (‚-’) und ihren,
möglicherweise abgeschnittenen, Kurzbeschreibungen. Falls es sich
um einen reinen Quell-Upload handelt, wird dieses Feld ausgelassen
(seit Dpkg 1.19.3).
Closes: Fehlernummernliste
Eine durch Leerzeichen getrennte Liste von Fehlerberichtsnummern
von Fehlerberichten, die mit diesem Upload behoben wurden. Die
Software des Distributionsarchivs könnte dieses Feld benutzen, um
automatisch die Nummern der referenzierten Fehler 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.
Built-For-Profiles: Profilliste
Das Feld gibt eine durch Leerraum getrennte Liste von Bauprofilen
an, unter denen dieser Upload gebaut wurde.
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 einen
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 durch 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 der gleichen Zeile wie
der durch einen Doppelpunkt gefolgte Feldname) 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.
FEHLER
Das Feld Files ist inkonsistent gegenüber den anderen
Checksums-Feldern. Die Felder Changed-By und Maintainer haben
verwirrende Namen. Das Feld Distribution enthält Informationen darüber,
was normalerweise als Suite bezeichnet wird.
SIEHE AUCH
deb822(5), deb-src-control(5), deb-version(7).
ÜBERSETZUNG
Die deutsche Übersetzung wurde 2004, 2006-2023 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.21.22 2023-05-11 deb-changes(5)
Generated by dwww version 1.15 on Sat Jun 29 01:53:49 CEST 2024.