deb822(5)

NAMN
deb822 - Debians RFC822-styrdataformat

BESKRIVNING
Pakethanteringssystemet manipulerar data som anges i ett vanligt format, känt som styrinformation, lagrat i styrfiler. Styrfiler används för källkodspaket, binärpaket och filen .changes som styr installationen av insända filer (dpkg:s interna databaser är i ett liknande 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 ‘-’).

Fältet slutar på slutet av raden eller på slutet av den sista fortsättningraden (se nedan). Horisontella blanksteg (U+0020 SPACE och U+0009 TAB) kan förekomma direkt före eller efter värdet och ignoreras där; det är vanligt att sätta ett ensamt blanksteg efter kolontecknet. Ett fält kan till exempel vara:

 Package: dpkg

fältnamnet är Package och fältvardet dpkg.

Tomma fältvärden tillåts bara i källkodspaketets styrfiler (debian/control). Sådana fält ignoreras.

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

Det finns tre typer fält:

    enkelt
        Fältet, och dess värde, måste vara en enkel rad. Det är inte tillåtet att dela fältet i flera delar. Det här är den förvalda fälttypen om definitionen av fältet inte anger en annan typ.

    flerdelat
        Värdet för ett flerdelat fält är en logisk rad som kan spänna över flera rader. Raderna efter den första kallas fortsättningsrader och måste börja med ett U+0020 SPACE eller en U+0009 TAB. Blanktecken, inklusive nyradstecken, har ingen betydelse i fältvärden för flerdelade fält.

        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.

    flerradigt
        Värdet för ett flerradigt fält kan bestå av flera fortsättningsrader. Den första delen av värdet, delen på samma rad som fältnamnet, har ofta en speciell betydelse eller måste vara tom. Andra rader läggs till på samma syntax som fortsättningsrader för flerdelade fält. Blanktecken, inklusive nyradstecken, har betydelse i värdet för flerradiga fält.

    Blanktecken får inte förekomma inuti namn (på paket, arkitekturer, filer eller något annat) eller versionsnummer, eller mellan tecknen i versionsberoenden bestående av flera tecken.

    Närvaron och betydelsen av ett fält, och syntaxen för dess värde kan skilja mellan olika sorters styrfiler.

    Fältnamn är inte skiftlägeskänsliga, men det är vanligt använda både stora och små bokstäver i fältnamnet så som visas nedan. Fältvärden är skiftlägeskänsliga såvida inte beskrivningen av fältet anger något annat.

    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 ‘.’).

    Rader som inleds med U+0023 ”#”, utan något tidigare blanktecken är kommentarsrader och tillåts bara i källkodspaketets styrfiler (debian/control) och i deb-origin(5)-filer. Dessa kommentarsrader ignoreras, också mellan två fortsättningsrader. De avslutar inte logiska rader.

    Alla styrfiler måste använda teckenkodningen UTF-8.

SE ÄVEN
RFC822, RFC5322.

ÖVERSÄTTNING
Peter Krefting och Daniel Nylander.