BUILD-RDEPS(1)

NAME
build-rdeps - find packages that depend on a specific package to build (reverse build depends)

SYNOPSIS
build-rdeps package [package ...]

DESCRIPTION
build-rdeps searches for all source packages that build-depend on any of the specified binary packages.

The default behaviour is to just `grep` for the given dependencies in the Build-Depends field of apt's Sources files.

If the package dose-extra >= 4.0 is installed, then a more complete reverse build dependency computation is carried out. In particular, with dose-extra installed, build-rdeps will find transitive reverse dependencies, respect architecture and build profile restrictions, take Provides relationships, Conflicts, Pre-Depends, Build-Depends-Arch and versioned dependencies into account and correctly resolve multiarch relationships for crossbuild reverse dependency resolution. This tends to be a slow process due to the complexity of the package interdependencies. If you need to find the reverse dependencies of more than one binary package, consider supplying all binary packages as additional arguments instead of calling build-rdeps multiple times.

OPTIONS

-u, --update
    Run apt-get update before searching for build-depends.

-s, --sudo
    Use sudo when running apt-get update. Has no effect if -u is omitted.

--distribution
    Select another distribution, which is searched for build-depends.

--only-main
    Ignore contrib, non-free and non-free-firmware.

--only-devel
    Consider only development distributions (e.g. unstable, sid).

--exclude-component
    Ignore the given component (e.g. main, contrib, non-free, non-free-firmware).

--origin
    Restrict the search to only the specified origin (such as "Debian").

-m, --print-maintainer
    Print the value of the maintainer field for each package.

--host-arch
    Explicitly set the host architecture. The default is the value of `dpkg-architecture -qDEB_HOST_ARCH`. This option only works if dose-extra >= 4.0 is installed.

--build-arch
    Explicitly set the build architecture. The default is the value of `dpkg-architecture -qDEB_BUILD_ARCH`. This option only works if dose-extra >= 4.0 is installed.

--no-arch-all, --no-arch-any
    Ignore Build-Depends-Indep or Build-Depends-Arch while looking for reverse dependencies.

--no-ftbfs
    Do not output source packages which have open FTBFS bugs in the selected distribution. This functionality uses the debftbfs utility.

--old
    Force the old simple behaviour without dose-ceve support even if dose-extra >= 4.0 is installed. (This tends to be faster.)

    Notice, that the old behaviour only finds direct dependencies, ignores virtual dependencies, does not find transitive dependencies and does not take version relationships, architecture restrictions, build profiles or multiarch relationships into account.

-q, --quiet
    Don't print meta information (header, counter). Making it easier to use in scripts.

-d, --debug
    Run the debug mode

--help
    Show the usage information.

--version
    Show the version information.

REQUIREMENTS
The tool requires apt Sources files to be around for the checked components. In the default case this means that in /var/lib/apt/lists files need to be around for main, contrib, non-free and non-free-firmware.

In practice this means one needs to add one deb-src line for each component, e.g.

deb-src http://<mirror>/debian <dist> main contrib non-free non-free-firmware

and run apt-get update afterwards or use the update option of this tool.

LICENSE
This code is copyright by Patrick Schoenfeld <schoenfeld@debian.org>, all rights reserved. This program comes with ABSOLUTELEY NO WARRANTY. You are free to redistribute this code under the terms of the GNU General Public License, version 2 or later.

AUTHOR
Patrick Schoenfeld <schoenfeld@debian.org>