deb-buildinfo

deb-buildinfo(5)                  dpkg suite                  deb-buildinfo(5)

NAME
       deb-buildinfo - Debian build information file format

SYNOPSIS
       filename.buildinfo

DESCRIPTION
       Each  Debian source package build can record the build information in a
       .buildinfo control file, which contains a number of fields.  Each field
       begins  with  a  tag,  such  as  Source  or  Binary (case insensitive),
       followed by a colon, and the body of the field.  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).

       The  control  data  might  be  enclosed  in  an  OpenPGP  ASCII Armored
       signature, as specified in RFC4880.

       The name of the .buildinfo file will depend on the type  of  build  and
       will  be  as  specific  as  necessary  but  not  more; for a build that
       includes    any    the     name     will     be     source-name_binary-
       version_arch.buildinfo,  or otherwise for a build that includes all the
       name will be source-name_binary-version_all.buildinfo, or otherwise for
       a  build  that  includes  source  the  name will be source-name_source-
       version_source.buildinfo.

FIELDS
       Format: format-version (required)
              The value of this field declares the format version of the file.
              The  syntax  of the field value is a version number with a major
              and minor  component.   Backward  incompatible  changes  to  the
              format  will  bump  the  major  version, and backward compatible
              changes (such as field additions) will bump the  minor  version.
              The current format version is 1.0.

       Source: source-name [(source-version)] (required)
              The  name  of the source package.  If the source version differs
              from the binary version, then the source-name will  be  followed
              by  a  source-version  in parenthesis.  This can happen when the
              build is for a binary-only non-maintainer upload.

       Binary: binary-package-list (required)
              This folded field is a space-separated list of  binary  packages
              built.

       Architecture: arch-list (required)
              This  space-separated field lists the architectures of the files
              currently being built.  Common architectures are  amd64,  armel,
              i386,  etc.   Note that the all value is meant for packages that
              are architecture independent.  If the source for the package  is
              also  being  built,  the  special  entry source is also present.
              Architecture wildcards must never be present in the list.

       Version: version-string (required)
              Typically, this is the  original  package's  version  number  in
              whatever  form the program's author uses.  It may also include a
              Debian revision number (for  non-native  packages).   The  exact
              format and sorting algorithm are described in deb-version(7).

       Binary-Only-Changes:
        changelog-entry
              This  multiline  field  contains  the  concatenated  text of the
              changelog entry for a binary-only non-maintainer upload (binNMU)
              if that is the case.  To make this a valid multiline field empty
              lines are replaced with a single full stop ('.') and  all  lines
              are  indented by one space character.  The exact content depends
              on the changelog format.

       Checksums-Md5: (required)
       Checksums-Sha1: (required)
       Checksums-Sha256: (required)
        checksum size filename
              These multiline fields contain a list of files with  a  checksum
              and  size  for  each one.  These fields have the same syntax and
              differ  only  in  the   checksum   algorithm   used:   MD5   for
              Checksums-Md5,   SHA-1   for   Checksums-Sha1  and  SHA-256  for
              Checksums-Sha256.

              The first line of the field value (the part on the same line  as
              the  field  name  followed  by  a  colon)  is always empty.  The
              content of the field is expressed  as  continuation  lines,  one
              line  per  file.   Each line consists of space-separated entries
              describing the file: the checksum, the file size, and  the  file
              name.

              These fields list all files that make up the build.

       Build-Origin: name
              The name of the distribution this package is originating from.

       Build-Architecture: arch (required)
              The  Debian  architecture  for  the installation the packages is
              being built in.  Common architectures are  amd64,  armel,  i386,
              etc.

       Build-Date: build-date
              The  date  the package was built.  It must be in the same format
              as the date in a deb-changelog(5) entry.

       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: build-path
              The absolute build path, which correspond to the unpacked source
              tree.  This field is only going to be present if the vendor  has
              whitelisted  it via some pattern match to avoid leaking possibly
              sensitive information.

              On Debian and derivatives only build paths starting with /build/
              will emit this field.

       Installed-Build-Depends: (required)
        package-list
              The  list of installed and configured packages that might affect
              the package build process.

              The  list  consists  of  each  package  name,  optionally  arch-
              qualified  for  foreign  architectures,  with  an  exact version
              restriction, separated by commas.

              The list includes all essential  packages,  packages  listed  in
              Build-Depends,  Build-Depends-Arch,  Build-Depends-Indep  source
              control fields, any vendor specific  builtin  dependencies,  and
              all their recursive dependencies.  On Debian and derivatives the
              dependency builtin is build-essential.

              For dependencies coming from  the  source  control  fields,  all
              dependency  alternatives  and  all providers of virtual packages
              depended on will be included.

       Environment:
        variable-list
              The list of environment variables that are known to  affect  the
              package  build  process, with each environment variable followed
              by an equal sign ('=') and the variable's  quoted  value,  using
              double quotes ('"'), and backslashes escaped ('\\').

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

1.19.0.5                          2022-05-25                  deb-buildinfo(5)