BEZEICHNUNG

       deb-buildinfo - Format der Bauinformationsdateien von Debian

ÜBERSICHT

       Dateiname.buildinfo

BESCHREIBUNG

       Jeder    Bau    eines    Debian-Quellpakets    kann    die   Bauinformationen   in   einer
       .buildinfo-Steuerdatei aufzeichnen. Diese enthält  eine  Reihe  von  Feldern.  Jedes  Feld
       beginnt  mit  einer  Markierung,  wie Source oder Binary (Groß-/Kleinschreibung ist egal),
       gefolgt von einem Doppelpunkt  und  dem  Inhalt  des  Feldes.  Felders  werden  nur  durch
       Feldmarkierungen  begrenzt.  Mit  anderen  Worten, Felder können mehrere Zeilen umfasssen,
       aber die Installationswerkzeuge werden im Allgemeinen die Zeilen bei der Verarbeitung  des
       Feldinhaltes  zusammenfassen  (außer im Falle der mehrzeiligen Felder Binary-Only-Changes,
       Installed-Build-Depends, Environment, Checksums-Md5, 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.

       Der Name der .buildinfo-Datei wird von der Art des Baus abhängen und  wird  so  spezifisch
       wie  notwendig  sein,  aber  nicht  mehr;  für  einen  Bau, der any enthält, wird der Name
       Quellname_Binärversion_Arch.buildinfo oder andernfalls für einen  Bau,  der  all  enthält,
       wird  der  Name  Quellname_Quellversion_all.buildinfo  oder andernfalls für einen Bau, der
       source enthält, wird der Name Quellname_Binärversion_source.buildinfo lauten.

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.0.

       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 der Bau für einen rein-binärern, nicht-Betreuer-Upload ist.

       Binary: Binärpaketliste (verpflichtend)
              Dieses gefaltete Feld ist eine  durch  Leerzeichen  getrennte  Liste  von  gebauten
              binären Paketen.

       Architecture: Architekturliste (verpflichtend)
              Dieses,  durch  Leerzeichen  getrennte  Feld  führt  die  Architekturen der derzeit
              gebauten Dateien auf. Typische Architekturen sind amd64, armel, i386 usw.  Beachten
              Sie,  dass  der  Wert  all für architekturunabhängige Pakete gedacht ist. Falls die
              Quelle für das Paket auch gebaut  wird,  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.

       Binary-Only-Changes:
       Changelog-Eintrag
              Das mehrzeilige Feld enthält den aneinandergehängten Text  des  Changelog-Eintrages
              eines  rein  binären,  nicht-Betreuer-Uploads (binNMU), falls dies der Fall ist. 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.

       Checksums-Md5: (verpflichtend)
       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: MD5 für Checksums-Md5, 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 Datei führt alle Dateien auf, aus denen der Bau besteht.

       Build-Origin: Name
              Der Name der Distribution, aus der dieses Paket ursprünglich stammt.

       Build-Architecture: Arch (verpflichtend)
              Die  Debian-Architektur  für  die  Installation,  unter der das Paket gebaut wurde.
              Typische Architekturen sind amd64, armel, i386, usw.

       Build-Date: Baudatum
              Das Datum, an dem das Paket letztmalig gebaut wurde. Es muss im gleichen Format wie
              in einem Eintrag bei deb-changelog(5) sein.

       Build-Kernel-Version: build-kernel-version
              The  release  and  version  (in an unspecified format) of the kernel running on the
              build system. This field is only going to be present if the builder has  explicitly
              requested it, to avoid leaking possibly sensitive information.

       Build-Path: Baupfad
              Der  absolute Baupfad, der dem entpackten Quellbaum entspricht. Dieses Feld ist nur
              vorhanden, falls der Lieferant das Feld über ein Muster freigeschaltet hat,  um  zu
              verhindern, dass vertrauliche Informationen versehentlich veröffentlicht werden.

              Unter  Debian  und abgeleiteten Distributionen werden nur Baupfade, die mit /build/
              beginnen, dieses Feld ausgeben.

       Installed-Build-Depends: (verpflichtend)
       Paketliste
              Die Liste der installierten und  konfigurierten  Pakete,  die  den  Bauprozess  des
              Pakets beeinflussen könnten.

              Die Liste besteht aus jedem Paketnamen, optional architekturqualifiziert für fremde
              Architekturen, mit einer genauen Versionseinschränkung, getrennt durch Kommata.

              Die  Liste  enthält  alle   essenziellen   Pakete,   die   in   Quell-Steuerfeldern
              Build-Depends,  Build-Depends-Arch,  Build-Depends-Indep  aufgeführten Pakete, alle
              Lieferanten-spezifischen  eingebauten  Abhängigkeiten  und  alle  ihre   rekursiven
              Abhängigkeiten.  Unter  Debian  und  abgeleiteten Distributionen ist die eingebaute
              Abhängigkeit build-essential.

              Für Abhängigkeiten aus den Quellsteuerfeldern werden alle Abhängigkeitsalternativen
              und alle Anbieter abhängiger virtueller Pakete mit aufgenommen.

       Umgebung
       Variablenliste
              Die   Liste   der   Umgebungsvariablen,   die  bekanntermaßen  den  Paketbauprozess
              beeinflussen, wobei jede Umgebungsvariable von einem Gleichheitszeichen  (,=’)  und
              dem    mit    Rückwärtsschrägstrichen    (,\\’)   maskierte   Wert   in   doppelten
              Anführungszeichen (,=’) gefolgt wird.

SIEHE AUCH

       deb-changes(5), deb-version(7), dpkg-genbuildinfo(1).

ÜBERSETZUNG

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