deb-buildinfo

Section: dpkg suite (5)
Updated: 1970-01-01
Page Index

NOM

deb-buildinfo - Format des fichiers d'information de construction de Debian

SYNOPSIS

nom-du-fichier.buildinfo

DESCRIPTION

Each Debian source package build can record the build information in a .buildinfo control file, which contains a number of fields in deb822(5) format.

Each field begins with a tag, such as Source or Binary (case insensitive), followed by a colon, and the body of the field (case sensitive unless stated otherwise). Fields are delimited only by field tags. In other words, field text may be multiple lines in length, but the installation tools will generally join lines when processing the body of the field (except in case of the multiline fields Binary-Only-Changes, Installed-Build-Depends, Environment, Checksums-Md5, Checksums-Sha1 and Checksums-Sha256, see below).

Les données de contrôle pourraient être incluses dans une signature OpenPGP « ASCII Armored », comme spécifié dans RFC4880.

Le nom du fichier .buildinfo dépendra du type de construction et sera aussi spécifique que nécessaire mais pas plus ; lorsque la construction inclut any, le nom sera nom-source_version-binaire_arch.buildinfo, ou sinon pour une construction all le nom sera nom-source_binary-version_all.buildinfo ou encore pour une construction qui inclut source le nom sera nom-source_version-source_source.buildinfo.

LES CHAMPS

Format: version-format (requis)

La valeur de ce champ déclare la version du format du fichier. La syntaxe de la valeur du champ est un numéro de version avec un composant majeur et mineur. Les modifications incompatibles avec les versions précédentes du format incrémenteront la version majeure, tandis que les modifications compatibles (telles que les ajouts de champ) incrémenteront la version mineure. La version de format actuelle est 1.0.

Source: nom-source [(version-source)] (requis)

Le nom du paquet source. Si la version du source diffère de la version binaire, alors le nom-source sera suivi par une version-source entre parenthèses. Cela peut arriver quand la construction concerne un envoi seulement binaire NMU (« non-maintainer upload »).

Binary: liste-paquets-binaires (requis selon le contexte)

This folded field is a space-separated list of binary packages built. If the build is source-only, then the field is omitted (since dpkg 1.20.0).

Architecture: liste-architectures (requis)

Ce champ, séparé par des espaces, liste les architectures des fichiers actuellement en construction. Voici quelques architectures habituelles : amd64, armel, i386, etc. Remarquez que l'option all signifie que le paquet est indépendant de toute architecture. Si le source du paquet est aussi en construction, l'entrée spéciale source est aussi présente. Les architectures joker ne doivent jamais être présentes dans la liste.

Version: chaîne-de-la-version (requis)

C'est classiquement le numéro de version du paquet d'origine dans la forme choisie par l'auteur du programme. Il peut y avoir aussi un numéro de révision Debian (pour les paquets non natifs). Le format exact et l'algorithme de tri sont décrits dans deb-version(7).

Binary-Only-Changes:

changelog-entry

Ce champ à lignes multiples contient le texte concaténé des entrées de changelog pour un envoi seulement binaire (binNMU), si c'est le cas. Pour faire de ce champ un champ à lignes multiples valable, les lignes vides sont remplacées par un point « . » et toutes les lignes sont indentées par une seule espace. Le contenu exact dépend du format du changelog.

Checksums-Md5: (requis)

Checksums-Sha1: (requis)

Checksums-Sha256: (requis)

checksum size filename

Ces champs à lignes multiples contiennent la liste des fichiers avec la somme de contrôle et la taille de chacun. Ces champs ont la même syntaxe et ne diffèrent que par l'algorithme de somme de contrôle utilisé : MD5 pour Checksums-Md5, SHA-1 pour Checksums-Sha1 et SHA-256 pour Checksums-Sha256.

La première ligne de la valeur du champ (la partie sur la même ligne que le nom du champ suivi par deux-points) est toujours vide. Le contenu du champ est exprimé par des lignes de continuation, une ligne par fichier. Chaque ligne consiste en des entrées séparées par des espaces décrivant le fichier :la somme de contrôle, la taille du fichier et le nom du fichier.

Ces champs listent tous les fichiers qui composent la construction.

Build-Origin: nom

Nom de la distribution dont ce paquet provient.

Build-Architecture: arch (requis)

L'architecture Debian pour l'installation des paquets en construction. Les architectures habituelles sont amd64, armel, i386, etc.

Build-Date: date-construction

La date à laquelle le paquet a été construit. Elle peut être au même format que la date dans les entrées dans deb-changelog(5).

Build-Kernel-Version: version-du-noyau-de-construction

La publication et la version (dans un format non spécifié) du noyau exécuté dans le système de construction. Ce champ va seulement être présent si le constructeur l'a demandé explicitement, pour éviter de révéler des informations potentiellement sensibles.

Build-Path: chemin-de-construction

The absolute build path, which correspond to the unpacked source tree. This field is only going to be present if the vendor has allowed it via some pattern match to avoid leaking possibly sensitive information.

Dans Debian et ses dérivés, seuls les chemins de construction débutant par /build/ émettront ce champ.

Build-Tainted-By:

taint-reason-list

Ce champ coupé est une liste, séparée par des espaces, non exhaustive des étiquettes de raison (formées de caractères alphanumériques et de tirets) qui définissent pourquoi la construction actuelle a été souillée (depuis dpkg 1.19.5).

Dans Debian et ses dérivées, les étiquettes de raisons suivantes peuvent être émises.

merged-usr-via-aliased-dirs: The system has a merged /usr via aliased directories (previously known as merged-usr-via-symlinks). This will confuse dpkg-query, dpkg-statoverride, dpkg-trigger, update-alternatives and any other tool using pathnames as keys into their databases, as it creates filesystem aliasing problems, and messes with the understanding of the filesystem that dpkg has recorded in its database. For build systems that hardcode pathnames to specific binaries or libraries on the resulting artifacts, it can also produce packages that will be incompatible with non-/usr-merged filesystems.
usr-local-has-configs: Le système a des fichiers de configuration dans /usr/local/etc.
usr-local-has-includes: Le système a des fichiers d'en-tête dans /usr/local/include.
usr-local-has-programs: Le système a des programmes dans /usr/local/bin ou /usr/local/sbin.
usr-local-has-libraries: Le système a des bibliothèques statiques ou partagées dans /usr/local/lib.

Installed-Build-Depends: (requis)

package-list

La liste des paquets installés et configurés que pourrait affecter le processus de construction du paquet.

La liste contient le nom de chaque paquet, éventuellement avec une qualification d'architecture pour celles différentes, avec une restriction de version précise, séparés par des virgules.

La liste inclut tous les paquets essentiels, les paquets listés dans les champs de contrôle des sources Build-Depends, Build-Depends-Arch, Build-Depends-Indep, chaque dépendance interne spécifique au distributeur, et toutes leurs dépendances récursives. Dans Debian et ses dérivés, une dépendance interne est build-essential.

Pour les dépendances provenant des champs de contrôle des sources, toutes les alternatives de dépendance et tous les fournisseurs de paquets virtuels dépendants seront inclus.

Environment:

variable-list

La liste des variables d'environnement qui sont connues pour affecter le processus de construction du paquet. Chaque variable d'environnement est suivie d'un signe égal (« = ») et de la valeur de la variable protégée avec des guillemets doubles (« " ») et des barres obliques inverses (« \\ »).

VOIR AUSSI

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

TRADUCTION

Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. Philippe Batailler, 2006. Nicolas François, 2006. Veuillez signaler toute erreur à <debian-l10n-french@lists.debian.org>.