Scroll to navigation

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

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.
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.

Show the usage message and exit.
Show the version and exit.

ENVIRONMENT

Sets the color mode. The currently accepted values are: auto (default), always and never.
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

Files generated by dpkg-distaddfile(1).
Files generated by dpkg-shlibdeps(1).
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
2025-02-03 1.22.15