.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "BUILD-RDEPS 1" .TH BUILD-RDEPS 1 "2021-08-18" "Debian Utilities" " " .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" build\-rdeps \- find packages that depend on a specific package to build (reverse build depends) .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBbuild-rdeps\fR \fIpackage\fR .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBbuild-rdeps\fR searches for all packages that build-depend on the specified package. .PP The default behaviour is to just `grep` for the given dependency in the Build-Depends field of apt's Sources files. .PP If the package dose-extra >= 4.0 is installed, then a more complete reverse build dependency computation is carried out. In particular, with that package 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.) .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-u\fR, \fB\-\-update\fR" 4 .IX Item "-u, --update" Run apt-get update before searching for build-depends. .IP "\fB\-s\fR, \fB\-\-sudo\fR" 4 .IX Item "-s, --sudo" Use sudo when running apt-get update. Has no effect if \-u is omitted. .IP "\fB\-\-distribution\fR" 4 .IX Item "--distribution" Select another distribution, which is searched for build-depends. .IP "\fB\-\-only\-main\fR" 4 .IX Item "--only-main" Ignore contrib and non-free .IP "\fB\-\-exclude\-component\fR" 4 .IX Item "--exclude-component" Ignore the given component (e.g. main, contrib, non-free). .IP "\fB\-\-origin\fR" 4 .IX Item "--origin" Restrict the search to only the specified origin (such as \*(L"Debian\*(R"). .IP "\fB\-m\fR, \fB\-\-print\-maintainer\fR" 4 .IX Item "-m, --print-maintainer" Print the value of the maintainer field for each package. .IP "\fB\-\-host\-arch\fR" 4 .IX Item "--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. .IP "\fB\-\-build\-arch\fR" 4 .IX Item "--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. .IP "\fB\-\-no\-arch\-all\fR, \fB\-\-no\-arch\-any\fR" 4 .IX Item "--no-arch-all, --no-arch-any" Ignore Build-Depends-Indep or Build-Depends-Arch while looking for reverse dependencies. .IP "\fB\-\-old\fR" 4 .IX Item "--old" Force the old simple behaviour without dose-ceve support even if dose-extra >= 4.0 is installed. (This tends to be faster.) .Sp 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. .IP "\fB\-\-quiet\fR" 4 .IX Item "--quiet" Don't print meta information (header, counter). Making it easier to use in scripts. .IP "\fB\-d\fR, \fB\-\-debug\fR" 4 .IX Item "-d, --debug" Run the debug mode .IP "\fB\-\-help\fR" 4 .IX Item "--help" Show the usage information. .IP "\fB\-\-version\fR" 4 .IX Item "--version" Show the version information. .SH "REQUIREMENTS" .IX Header "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 and non-free. .PP In practice this means one needs to add one deb-src line for each component, e.g. .PP deb-src http:///debian main contrib non-free .PP and run apt-get update afterwards or use the update option of this tool. .SH "LICENSE" .IX Header "LICENSE" This code is copyright by Patrick Schoenfeld , all rights reserved. This program comes with \s-1ABSOLUTELEY NO WARRANTY.\s0 You are free to redistribute this code under the terms of the \&\s-1GNU\s0 General Public License, version 2 or later. .SH "AUTHOR" .IX Header "AUTHOR" Patrick Schoenfeld