deb822(5)

BEZEICHNUNG
deb - Debian-RFC822-Steuerdatenformat

BESCHREIBUNG
Die in einem gemeinsamen Format dargestellten Daten des Paketverwaltungssystems, gespeichert in Steuerdateien. Steuerdateien werden für Quellpakete, Binärpakete und die .changes-Dateien, die die Installation von hochgeladenen Dateien steuern, verwandt (die internen Datenbanken von dpkg sind in einem ähnlichen Format).

SYNTAX
A control file consists of one or more stanzas of fields (the stanzas sometimes used to be referred to as paragraphs). The stanzas are separated by empty lines. Parsers may accept lines consisting solely of U+0020 SPACE and U+0009 TAB as stanza separators, but control files should use empty lines. Some control files allow only one stanza; others allow several, in which case each stanza usually refers to a different package. (For example, in source packages, the first stanza refers to the source package, and later stanzas refer to binary packages generated from the source.) The ordering of the stanzas in control files is significant.

Each stanza consists of a series of data fields. Each field consists of the field name followed by a colon (U+003A ‘:’), and then the data/value associated with that field. The field name is composed of US-ASCII characters excluding control characters, space, and colon (i.e., characters in the ranges U+0021 ‘!’ through U+0039 ‘9’, and U+003B ‘;’ through U+007E ‘~’, inclusive). Field names must not begin with the comment character (U+0023 ‘#’), nor with the hyphen character (U+002D ‘-’).

Das Feld endet am Zeilenende oder am Ende der letzten Fortsetzungszeile (siehe unten). Horizontaler Leerraum (U+0020 LEERZEICHEN und U+0009 TABULATOR) kann sofort nach oder vor dem Wert vorkommen und wird dort ignoriert; als Konvention wird ein einzelnes Leerzeichen nach dem Doppelpunkt gesetzt. Ein Feld könnte beispielsweise sein:

 Package: dpkg

Der Feldname lautet Package und der Feldwert dpkg.

Leere Feldwerte sind nur in Quellpaket-Steuerdateien (debian/control) erlaubt. Solche Felder werden ignoriert.

A stanza must not contain more than one instance of a particular field name.

Es gibt drei Arten von Feldern:

    simple
        Ein Feld, einschließlich des Wertes, muss eine einzelne Zeile sein. Falten (Umbrechen) des Feldes ist nicht erlaubt. Dies ist der Standardtyp, falls die Definition des Feldes nicht einen anderen Typ spezifiziert.

    folded
        Der Wert des gefalteten Feldes ist eine logische Zeile, die sich über mehrere Zeilen erstrecken kann. Die Zeilen nach der ersten werden Fortsetzungszeilen genannt und müssen mit einem U+0020 LEERZEICHEN oder U+0009 TABULATOR beginnen. Leerraum, darunter Zeilenumbrüche, ist für die Feldwerte gefalteter Zeilen nicht signifikant.

        This folding method is similar to RFC5322, allowing control files that contain only one stanza and no multiline fields to be read by parsers written for RFC5322.

    multiline
        Der Wert eines mehrzeiligen Feldes darf mehrere Fortsetzungszeilen enthalten. Die erste Zeile des Wertes, der Teil der auf der gleichen Zeile wie der Feldname ist, hat oft eine spezielle Bedeutung oder könnte leer sein müssen. Weitere Zeilen werden hinzugefügt und folgen der gleichen Syntax wie die Fortsetzungszeilen von anderen gefalteten Feldern. Leerraum, inklusive Zeilenumbrüchen, ist im Wert von mehrzeiligen Feldern signifikant.

    Leerraum darf nicht innerhalb von Namen (von Paketen, Architekturen, Dateien oder sonstigem) oder Versionsnummern oder zwischen den Zeichen einer Mehrzeichenversionsbeziehung auftauchen.

    Die Existenz und der Zweck eines Feldes und die Syntax seines Wertes können zwischen den Arten der Steuerdateien variieren.

    Die Groß-/Kleinschreibung ist bei Feldnamen nicht relevant, aber normalerweise wird die Großschreibung eines Feldes in der nachfolgend gezeigten gemischten Weise vorgenommen. Bei den Feldwerten ist die Groß-/Kleinschreibung relevant, außer die Beschreibung sagt etwas anderes.

    Stanza separators (empty lines) and lines consisting only of U+0020 SPACE and U+0009 TAB, are not allowed within field values or between fields. Empty lines in field values are usually escaped by representing them by a U+0020 SPACE followed by a dot (U+002E ‘.’).

    Zeilen, die mit U+0023 ‚#’ ohne einen vorangestellten Leerraum beginnen, sind Kommentarzeilen, die nur in Quellpaketsteuerdateien (debian/control) und in deb-origin(5)-Dateien erlaubt sind. Diese Kommentarzeilen werden ignoriert, selbst zwischen zwei Fortsetzungszeilen. Sie beenden keine logischen Zeilen.

    Alle Steuerdateien müssen in UTF-8 kodiert sein.

SIEHE AUCH
RFC822, RFC5322.

ÜBERSETZUNG
Die deutsche Übersetzung wurde 2004, 2006-2022 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.