dpkg-buildtree(1) — Linux manual page
dpkg-buildtree(1) dpkg suite dpkg-buildtree(1)
NAME
dpkg-buildtree - helper for build tree operations during package
builds
SYNOPSIS
dpkg-buildtree [option...] [command]
DESCRIPTION
dpkg-buildtree is a tool to perform common operations on the
build tree for a source package.
This program was introduced in dpkg 1.22.3.
COMMANDS
clean
Removes all artifacts generated during a build by the various
dpkg tools, and pathnames used or controlled by dpkg tools
that are safe to clean. These files are used to track state
between package build runs, and are in many cases internal
implementation details the packager should not be concerned
about, or are staging directories containing build artifacts.
--help
Show the usage message and exit.
--version
Show the version and exit.
ENVIRONMENT
DPKG_COLORS
Sets the color mode. The currently accepted values are: auto
(default), always and never.
DPKG_NLS
If set, it will be used to decide whether to activate Native
Language Support, also known as internationalization (or
i18n) support. The accepted values are: 0 and 1 (default).
FILES
Cleaned files
debian/files
debian/files.new
Files generated by dpkg-distaddfile(1).
debian/substvars
debian/substvars.new
Files generated by dpkg-shlibdeps(1).
debian/tmp
Staging directory containing the contents to be used when
creating a package. Both dpkg-gencontrol(1) and
dpkg-gensymbols(1) generate files within.
EXAMPLES
Usage in debian/rules
You can call dpkg-buildtree clean from the debian/rules clean
target, after having performed other necessary cleanups.
For example for an autoconf-like build system:
clean:
[ ! -f Makefile ] || $(MAKE) distclean
dpkg-buildtree clean
COLOPHON
This page is part of the dpkg (Debian Package Manager) project.
Information about the project can be found at
⟨https://wiki.debian.org/Teams/Dpkg/⟩. If you have a bug report
for this manual page, see
⟨http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=dpkg⟩. This
page was obtained from the project's upstream Git repository ⟨git
clone https://git.dpkg.org/git/dpkg/dpkg.git⟩ on 2024-06-14. (At
that time, the date of the most recent commit that was found in
the repository was 2024-05-21.) If you discover any rendering
problems in this HTML version of the page, or you believe there
is a better or more up-to-date source for the page, or you have
corrections or improvements to the information in this COLOPHON
(which is not part of the original manual page), send a mail to
man-pages@man7.org