dpkg-buildtree(1) — Linux manual page

NAME \| SYNOPSIS \| DESCRIPTION \| COMMANDS \| ENVIRONMENT \| FILES \| EXAMPLES \| COLOPHON

dpkg-buildtree(1)               dpkg suite              dpkg-buildtree(1)

NAME top

       dpkg-buildtree - helper for build tree operations during package
       builds

SYNOPSIS top

       dpkg-buildtree [option...] [command]

DESCRIPTION top

       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 top

       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 top

       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 top

   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 top

   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 top

       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 2025-02-02.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2025-01-16.)  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

1.22.12-10-g32fee               2025-01-01              dpkg-buildtree(1)