279 lines
9.2 KiB
HTML
279 lines
9.2 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of deb-buildinfo</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>deb-buildinfo</H1>
|
|
Section: dpkg suite (5)<BR>Updated: 2020-03-23<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
deb-buildinfo - Debian build information file format
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<I>filename</I><B>.buildinfo</B>
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
Each Debian source package build can record the build information in
|
|
a <B>.buildinfo</B> control file, which contains a number of fields.
|
|
Each field begins with a tag, such as
|
|
<B>Source</B>
|
|
|
|
or
|
|
<B>Binary</B>
|
|
|
|
(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
|
|
<B>Binary-Only-Changes</B>, <B>Installed-Build-Depends</B>, <B>Environment</B>,
|
|
|
|
<B>Checksums-Md5</B>, <B>Checksums-Sha1</B>
|
|
|
|
and
|
|
<B>Checksums-Sha256</B>,
|
|
|
|
see below).
|
|
<P>
|
|
|
|
The control data might be enclosed in an OpenPGP ASCII Armored signature,
|
|
as specified in RFC4880.
|
|
<P>
|
|
|
|
The name of the <B>.buildinfo</B> file will depend on the type of build and
|
|
will be as specific as necessary but not more;
|
|
for a build that includes <B>any</B> the name will be
|
|
<I>source-name</I><B>_</B><I>binary-version</I><B>_</B><I>arch</I><B>.buildinfo</B>,
|
|
or otherwise for a build that includes <B>all</B> the name will be
|
|
<I>source-name</I><B>_</B><I>binary-version</I><B>_</B><B>all.buildinfo</B>,
|
|
or otherwise for a build that includes <B>source</B> the name will be
|
|
<I>source-name</I><B>_</B><I>source-version</I><B>_</B><B>source.buildinfo</B>.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>FIELDS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>Format:</B> <I>format-version</I> (required)
|
|
|
|
<DD>
|
|
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 <B>1.0</B>.
|
|
<DT id="2"><B>Source:</B> <I>source-name</I> [<B>(</B><I>source-version</I><B>)</B>] (required)
|
|
|
|
<DD>
|
|
The name of the source package.
|
|
If the source version differs from the binary version, then the
|
|
<I>source-name</I> will be followed by a <I>source-version</I> in parenthesis.
|
|
This can happen when the build is for a binary-only non-maintainer upload.
|
|
<DT id="3"><B>Binary:</B> <I>binary-package-list</I> (required)
|
|
|
|
<DD>
|
|
This folded field is a space-separated list of binary packages built.
|
|
<DT id="4"><B>Architecture:</B> <I>arch-list</I> (required)
|
|
|
|
<DD>
|
|
This space-separated field lists the architectures of the files currently
|
|
being built.
|
|
Common architectures are <B>amd64</B>, <B>armel</B>, <B>i386</B>, etc.
|
|
Note that the <B>all</B> value is meant for packages that are architecture
|
|
independent.
|
|
If the source for the package is also being built, the special entry
|
|
<B>source</B> is also present.
|
|
Architecture wildcards must never be present in the list.
|
|
<DT id="5"><B>Version:</B> <I>version-string</I> (required)
|
|
|
|
<DD>
|
|
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
|
|
<B><A HREF="/cgi-bin/man/man2html?7+deb-version">deb-version</A></B>(7).
|
|
|
|
<DT id="6"><B>Binary-Only-Changes:</B>
|
|
|
|
<DD>
|
|
|
|
<I> changelog-entry</I>
|
|
|
|
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.
|
|
<DT id="7"><B>Checksums-Md5:</B> (required)
|
|
|
|
<DD>
|
|
|
|
<B>Checksums-Sha1:</B> (required)
|
|
|
|
|
|
<B>Checksums-Sha256:</B> (required)
|
|
|
|
|
|
<I>checksum</I> <I>size</I> <I>filename</I>
|
|
|
|
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 <B>Checksums-Md5</B>, SHA-1 for <B>Checksums-Sha1</B> and
|
|
SHA-256 for <B>Checksums-Sha256</B>.
|
|
<P>
|
|
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.
|
|
<P>
|
|
These fields list all files that make up the build.
|
|
<DT id="8"><B>Build-Origin:</B> <I>name</I>
|
|
|
|
<DD>
|
|
The name of the distribution this package is originating from.
|
|
<DT id="9"><B>Build-Architecture:</B> <I>arch</I> (required)
|
|
|
|
<DD>
|
|
The Debian architecture for the installation the packages is being built in.
|
|
Common architectures are <B>amd64</B>, <B>armel</B>, <B>i386</B>, etc.
|
|
<DT id="10"><B>Build-Date:</B> <I>build-date</I>
|
|
|
|
<DD>
|
|
The date the package was built.
|
|
It must be in the same format as the date in a <B><A HREF="/cgi-bin/man/man2html?5+deb-changelog">deb-changelog</A></B>(5)
|
|
entry.
|
|
<DT id="11"><B>Build-Kernel-Version:</B> <I>build-kernel-version</I>
|
|
|
|
<DD>
|
|
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.
|
|
<DT id="12"><B>Build-Path:</B> <I>build-path</I>
|
|
|
|
<DD>
|
|
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.
|
|
<P>
|
|
On Debian and derivatives only build paths starting with <I>/build/</I>
|
|
will emit this field.
|
|
<DT id="13"><B>Build-Tainted-By:</B>
|
|
|
|
<DD>
|
|
|
|
<I> taint-reason-list</I>
|
|
|
|
This folded field contains a space-separated list of non-exhaustive reason
|
|
tags (formed by alphanumeric and dash characters) which identify why the
|
|
current build has been tainted (since dpkg 1.19.5).
|
|
<DT id="14"><DD>
|
|
On Debian and derivatives the following reason tags can be emitted:
|
|
<DL COMPACT><DT id="15"><DD>
|
|
<DL COMPACT>
|
|
<DT id="16"><B>merged-usr-via-symlinks</B>
|
|
|
|
<DD>
|
|
The system has a merged <I>/usr</I> via symlinks.
|
|
This will confuse <B>dpkg-query</B>, <B>dpkg-statoverride</B>,
|
|
<B>dpkg-trigger</B>, <B>update-alternatives</B> 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
|
|
<B>dpkg</B> 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.
|
|
<DT id="17"><B>usr-local-has-configs</B>
|
|
|
|
<DD>
|
|
The system has configuration files under <I>/usr/local/etc</I>.
|
|
<DT id="18"><B>usr-local-has-includes</B>
|
|
|
|
<DD>
|
|
The system has header files under <I>/usr/local/include</I>.
|
|
<DT id="19"><B>usr-local-has-programs</B>
|
|
|
|
<DD>
|
|
The system has programs under <I>/usr/local/bin</I> or <I>/usr/local/sbin</I>.
|
|
<DT id="20"><B>usr-local-has-libraries</B>
|
|
|
|
<DD>
|
|
The system has libraries, either static or shared under <I>/usr/local/lib</I>.
|
|
</DL>
|
|
</DL>
|
|
|
|
<DT id="21"><B>Installed-Build-Depends:</B> (required)
|
|
|
|
<DD>
|
|
|
|
<I> package-list</I>
|
|
|
|
The list of installed and configured packages that might affect the package
|
|
build process.
|
|
<P>
|
|
The list consists of each package name, optionally arch-qualified for foreign
|
|
architectures, with an exact version restriction, separated by commas.
|
|
<P>
|
|
The list includes all essential packages, packages listed in
|
|
<B>Build-Depends</B>, <B>Build-Depends-Arch</B>, <B>Build-Depends-Indep</B>
|
|
source control fields, any vendor specific builtin dependencies, and all
|
|
their recursive dependencies.
|
|
On Debian and derivatives the dependency builtin is <B>build-essential</B>.
|
|
<P>
|
|
For dependencies coming from the source control fields, all dependency
|
|
alternatives and all providers of virtual packages depended on will be
|
|
included.
|
|
<DT id="22"><B>Environment:</B>
|
|
|
|
<DD>
|
|
|
|
<I> variable-list</I>
|
|
|
|
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 ('\\').
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+deb-changes">deb-changes</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?7+deb-version">deb-version</A></B>(7),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+dpkg-genbuildinfo">dpkg-genbuildinfo</A></B>(1).
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="23"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="24"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="25"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="26"><A HREF="#lbAE">FIELDS</A><DD>
|
|
<DT id="27"><A HREF="#lbAF">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:02 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|