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.
is-rootless
Checks whether the build tree can be built with no root privileges
(since dpkg 1.22.12).
This command can be used safely even with versions where the command
was not yet available as the default will then be the historic one
where root was required.
--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
1.22.21 2025-06-30 dpkg-buildtree(1)
Generated by dwww version 1.16 on Tue Dec 16 06:03:24 CET 2025.