.\" -*- 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 "deb-changes 5" .TH deb-changes 5 2024-03-10 1.22.6 "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 BEZEICHNUNG .IX Header "BEZEICHNUNG" dpkg-genchanges \- Format der Upload-Changes-Datei von Debian .SH \(:UBERSICHT .IX Header "\(:UBERSICHT" \&\fIDateiname\fR\fB.changes\fR .SH BESCHREIBUNG .IX Header "BESCHREIBUNG" Jeder Debian-Upload besteht aus einer .changes\-Steuerdatei, die eine Reihe von Feldern im \fBdeb822\fR\|(5)\-Format enth\(:alt. .PP Jedes Feld beginnt mit einer Markierung wie \fBSource\fR oder \fBBinary\fR (Gro\(ss\-/Kleinschreibung ist egal), gefolgt von einem Doppelpunkt und dem Inhalt des Feldes (Gro\(ss\-/Kleinschreibung ist relevant, au\(sser anders angegeben). Felder werden nur durch Feldmarkierungen abgegrenzt. Mit anderen Worten: Der Feldtext kann sich \(:uber mehrere Zeilen erstrecken, wobei die Installationswerkzeuge die Zeilen bei der Verarbeitung des Feldinhaltes zusammenf\(:ugen werden (Ausnahmen sind die mehrzeiligen Felder \fBDescription\fR, \fBChanges\fR, \fBFiles\fR, \fBChecksums\-Sha1\fR und \fBChecksums\-Sha256\fR, siehe unten). .PP Die Steuerdaten k\(:onnen in eine Signatur mit einer wie in RFC4880 spezifizierten OpenPGP\-ASCII\-H\(:ulle eingeschlossen sein. .SH FELDER .IX Header "FELDER" .IP "\fBFormat:\fR \fIFormatversion\fR (verpflichtend)" 4 .IX Item "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\(:uckw\(:artsinkompatible \(:Anderungen im Format f\(:uhren zu einer Erh\(:ohung der Hauptversion und r\(:uckw\(:artskompatible \(:Anderungen (wie die Aufnahme neuer Felder) f\(:uhren zu einer Erh\(:ohung der Nebenversion. Die aktuelle Formatversion ist \fB1.8\fR. .IP "\fBDate:\fR \fIVer\(:offentlichungsdatum\fR (verpflichtend)" 4 .IX Item "Date: Ver\(:offentlichungsdatum (verpflichtend)" Das Datum, an dem das Paket letztmalig gebaut oder bearbeitet wurde. Es muss im gleichen Format wie in einem Eintrag bei \fBdeb\-changelog\fR\|(5) sein. .Sp Der Wert dieses Feldes wird normalerweise aus der Datei \fIdebian/changelog\fR entnommen. .IP "\fBSource:\fR \fIQuellname\fR [\fB(\fR\fIQuellversion\fR\fB)\fR] (verpflichtend)" 4 .IX Item "Source: Quellname [(Quellversion)] (verpflichtend)" Der Name des Quellpakets. Falls sich die Quellversion von der Bin\(:arversion unterscheidet, folgt dem \fIQuellname\fRn in Klammern eine \fIQuellversion\fR. Dies kann passieren, falls dies ein rein\-bin\(:arer nicht-Betreuer-Upload ist. .IP "\fBBinary:\fR \fIBin\(:arpaketliste\fR (verpflichtend im Kontext)" 4 .IX Item "Binary: Bin\(:arpaketliste (verpflichtend im Kontext)" Dieses gefaltete Feld ist eine durch Leerzeichen getrennte Liste von hochzuladenden bin\(:aren Paketen. Falls es sich um einen reinen Quell-Upload handelt, wird dieses Feld ausgelassen (seit Dpkg 1.19.3). .IP "\fBArchitecture:\fR \fIArchitekturliste\fR" 4 .IX Item "Architecture: Architekturliste" Listet die Architekturen der derzeit hochgeladenen Dateien auf. Gel\(:aufige Architekturen sind \fBamd64\fR, \fBarmel\fR, \fBi386\fR, usw. Beachten Sie, dass der Wert \fBall\fR f\(:ur Pakete gedacht ist, die Architektur\-unabh\(:angig sind. Falls die Quellen f\(:ur das Paket auch hochgeladen werden, ist der besondere Eintrag \fBsource\fR auch vorhanden. Architektur-Platzhalter d\(:urfen in der Liste niemals auftauchen. .IP "\fBVersion:\fR \fIVersionszeichenkette\fR (verpflichtend)" 4 .IX Item "Version: Versionszeichenkette (verpflichtend)" Typischerweise ist das die Original-Paketversionsnummer, in der Form, die der Programmautor verwendet. Es kann auch eine Debian-Revisionsnummer enthalten (f\(:ur nicht aus Debian stammende Pakete). Das genaue Format und der Sortieralgorithmus sind in \fBdeb\-version\fR\|(7) beschrieben. .IP "\fBDistribution:\fR \fIDistribution\fRen (verpflichtend)" 4 .IX Item "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. .IP "\fBUrgency:\fR \fIDringlichkeit\fR (empfohlen)" 4 .IX Item "Urgency: Dringlichkeit (empfohlen)" Die Dringlichkeit des Uploads. Die derzeit bekannten Werte, in aufsteigender Reihenfolge der Dringlichkeit, sind: \fBlow\fR, \fBmedium\fR, \fBhigh\fR, \fBcritical\fR und \fBemergency\fR. .IP "\fBMaintainer:\fR \fIVollst\(:andiger\-Name\-und\-E\-Mail\fR (verpflichtend)" 4 .IX Item "Maintainer: Vollst\(:andiger-Name-und-E-Mail (verpflichtend)" Sollte in dem Format \(BqJoe Bloggs \(lq sein und ist typischerweise die Person, die das Paket erstellt hat, im Gegensatz zum Autor der Software, die paketiert wurde. .IP "\fBChanged-By:\fR \fIVollst\(:andiger\-Name\-und\-E\-Mail\fR" 4 .IX Item "Changed-By: Vollst\(:andiger-Name-und-E-Mail" Sollte in dem Format \(BqJoe Bloggs \(lq sein und ist typischerweise die Person, die die \(:Anderungen f\(:ur die Ver\(:offentlichung am Paket vorgenommen hat. .IP "\fBDescription:\fR (empfohlen)" 4 .IX Item "Description: (empfohlen)" .PD 0 .IP "\ \fIBin\(:arpaketname\fR \fB\-\fR \fIBin\(:arpaketzusammenfassung\fR" 4 .IX Item " Bin\(:arpaketname - Bin\(:arpaketzusammenfassung" .PD Dieses mehrzeilige Feld enth\(:alt eine Liste von Bin\(:arpaketnamen, gefolgt von einem Leerzeichen, einem Bindestrich (\(bq\fB\-\fR\(cq) und ihren, m\(:oglicherweise abgeschnittenen, Kurzbeschreibungen. Falls es sich um einen reinen Quell-Upload handelt, wird dieses Feld ausgelassen (seit Dpkg 1.19.3). .IP "\fBCloses:\fR \fIFehlernummernliste\fR" 4 .IX Item "Closes: Fehlernummernliste" Eine durch Leerzeichen getrennte Liste von Fehlerberichtsnummern von Fehlerberichten, die mit diesem Upload behoben wurden. Die Software des Distributionsarchivs k\(:onnte dieses Feld benutzen, um automatisch die Nummern der referenzierten Fehler in der Fehlerdatenbank der Distribution zu schlie\(ssen. .IP "\fBBinary-Only: yes\fR" 4 .IX Item "Binary-Only: yes" Das Feld kennzeichnet, dass der Upload ein rein bin\(:arer, nicht-Betreuer-Upload ist. Er stammt aus dem Schl\(:ussel/Werte\-Paar \fBbinary\-only=yes\fR aus dem Metadateneintrag des Changelogs. .IP "\fBBuilt-For-Profiles:\fR \fIProfilliste\fR" 4 .IX Item "Built-For-Profiles: Profilliste" Das Feld gibt eine durch Leerraum getrennte Liste von Bauprofilen an, unter denen dieser Upload gebaut wurde. .IP "\fBChanges:\fR (verpflichtend)" 4 .IX Item "Changes: (verpflichtend)" .PD 0 .IP "\ \fIChangelog\-Eintr\(:age\fR" 4 .IX Item " Changelog-Eintr\(:age" .PD Das mehrzeilige Feld enth\(:alt den aneinandergeh\(:angten Text aller Changelog\-Eintr\(:age, die Teil dieses Uploads sind. Um ein g\(:ultiges mehrzeiliges Feld zu erhalten, werden leere Zeilen durch einen einzelnen Satzpunkt (\(bq.\(cq) ersetzt und alle Zeilen mit einem Leerzeichen einger\(:uckt. Der genaue Inhalt h\(:angt vom Changelog-Format ab. .IP "\fBFiles:\fR (verpflichtend)" 4 .IX Item "Files: (verpflichtend)" .PD 0 .IP "\ \fIMd5sum\fR \fIGr\(:o\(sse\fR \fISektion\fR \fIPriorit\(:at\fR \fIDateiname\fR" 4 .IX Item " Md5sum Gr\(:o\(sse Sektion Priorit\(:at Dateiname" .PD Das mehrzeilige Feld enth\(:alt eine Liste der Dateien mit Md5sum, Gr\(:o\(sse, Sektion und Priorit\(:at f\(:ur jede. .Sp 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\(:uckt, eine Zeile pro Datei. Jede Zeile besteht aus durch Leerzeichen getrennten Eintr\(:agen, die die Datei beschreiben: die Md5sum, die Dateigr\(:o\(sse, die Datei-Sektion, die Datei\-Priorit\(:at und der Dateiname. .Sp Dieses Feld f\(:uhrt alle Dateien, die den Upload bilden, auf. Die Liste der Dateien in diesem Feld muss auf die Liste der Dateien in den anderen zugeh\(:origen \fBChecksums\fR\-Feldern passen. .IP "\fBChecksums\-Sha1:\fR (verpflichtend)" 4 .IX Item "Checksums-Sha1: (verpflichtend)" .PD 0 .IP "\fBChecksums\-Sha256:\fR (verpflichtend)" 4 .IX Item "Checksums-Sha256: (verpflichtend)" .IP "\ \fIPr\(:ufsumme\fR \fIGr\(:o\(sse\fR \fIDateiname\fR" 4 .IX Item " Pr\(:ufsumme Gr\(:o\(sse Dateiname" .PD Diese mehrzeiligen Felder enthalten eine Liste von Dateien mit einer Pr\(:ufsumme und Gr\(:o\(sse f\(:ur jede. Diese Felder haben die gleiche Syntax und unterscheiden sich nur im verwandten Pr\(:ufsummenalgorithmus: SHA\-1 f\(:ur \fBChecksums\-Sha1\fR und SHA\-256 f\(:ur \fBChecksums\-Sha256\fR. .Sp 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\(:uckt, eine Zeile pro Datei. Jede Zeile besteht aus durch Leerzeichen getrennten Eintr\(:agen, die die Datei beschreiben: der Pr\(:ufsumme, der Dateigr\(:o\(sse und dem Dateinamen. .Sp Diese Felder f\(:uhren alle Dateien auf, aus denen der Upload besteht. Die Liste der Dateien in diesen Feldern muss zu der Liste in dem Feld \fBFiles\fR und den anderen zugeh\(:origen \fBChecksums\fR\-Feldern passen. .SH FEHLER .IX Header "FEHLER" Das Feld \fBFiles\fR ist inkonsistent gegen\(:uber den anderen \fBChecksums\fR\-Feldern. Die Felder \fBChanged-By\fR und \fBMaintainer\fR haben verwirrende Namen. Das Feld \fBDistribution\fR enth\(:alt Informationen dar\(:uber, was normalerweise als Suite bezeichnet wird. .SH "SIEHE AUCH" .IX Header "SIEHE AUCH" \&\fBdeb822\fR\|(5), \fBdeb\-src\-control\fR\|(5), \fBdeb\-version\fR\|(7). .SH \(:UBERSETZUNG .IX Header "\(:UBERSETZUNG" Die deutsche \(:Ubersetzung wurde 2004, 2006\-2023 von Helge Kreutzmann , 2007 von Florian Rehnisch und 2008 von Sven Joachim angefertigt. Diese \(:Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 2 oder neuer f\(:ur die Kopierbedingungen. Es gibt KEINE HAFTUNG.