test: Refactor ar handling into m4 macros
[dpkg.git] / man / dpkg-checkbuilddeps.pod
blob691d2524520a144bcaee2942f2d802f8d8377abd
1 # dpkg manual page - dpkg-checkbuilddeps(1)
3 # Copyright © 2001 Joey Hess <joeyh@debian.org>
4 # Copyright © 2007-2013, 2015 Guillem Jover <guillem@debian.org>
5 # Copyright © 2008-2011 Raphaël Hertzog <hertzog@debian.org>
7 # This is free software; you can redistribute it and/or modify
8 # it under the terms of the GNU General Public License as published by
9 # the Free Software Foundation; either version 2 of the License, or
10 # (at your option) any later version.
12 # This is distributed in the hope that it will be useful,
13 # but WITHOUT ANY WARRANTY; without even the implied warranty of
14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15 # GNU General Public License for more details.
17 # You should have received a copy of the GNU General Public License
18 # along with this program.  If not, see <https://www.gnu.org/licenses/>.
20 =encoding utf8
22 =head1 NAME
24 dpkg-checkbuilddeps - check build dependencies and conflicts
26 =head1 SYNOPSIS
28 B<dpkg-checkbuilddeps>
29 [I<option>...]
30 [I<control-file>]
32 =head1 DESCRIPTION
34 This program checks the installed packages in the system against the build
35 dependencies and build conflicts listed in the control file.
36 If any are
37 not met, it displays them and exits with a nonzero return code.
39 By default, B<debian/control> is read, but an alternate control filename
40 may be specified on the command line.
42 =head1 OPTIONS
44 =over
46 =item B<--admindir=>I<dir>
48 Change the location of the B<dpkg> database (since dpkg 1.14.0).
49 The default location is I<%ADMINDIR%>.
51 =item B<-A>
53 Ignore B<Build-Depends-Arch> and B<Build-Conflicts-Arch>
54 lines (since dpkg 1.16.4).
55 Use when only arch-indep packages will be built, or combine with
56 B<-B> when only a source package is to be built.
58 =item B<-B>
60 Ignore B<Build-Depends-Indep> and B<Build-Conflicts-Indep>
61 lines.
62 Use when only arch-dep packages will be built, or combine with
63 B<-A> when only a source package is to be built.
65 =item B<-I>
67 Ignore built-in build depends and conflicts (since dpkg 1.18.2).
68 These are implicit dependencies that are usually required on a specific
69 distribution, the so called Build-Essential package set.
71 =item B<-d> I<build-depends-string>
73 =item B<-c> I<build-conflicts-string>
75 Use the given build dependencies/conflicts instead of those contained in the
76 I<debian/control> file (since dpkg 1.14.17).
78 =item B<-a> I<arch>
80 Check build dependencies/conflicts assuming that the package described in
81 the control file is to be built for the given host architecture instead of
82 the architecture of the current system (since dpkg 1.16.2).
84 =item B<-P> I<profile>[B<,>...]
86 Check build dependencies/conflicts assuming that the package described
87 in the control file is to be built for the given build profile(s)
88 (since dpkg 1.17.2).
89 The argument is a comma-separated list of profile names.
91 =item B<-?>, B<--help>
93 Show the usage message and exit.
95 =item B<--version>
97 Show the version and exit.
99 =back
101 =head1 ENVIRONMENT
103 =over
105 =item B<DEB_HOST_ARCH>
107 Sets the host architecture.
108 This affects the dependency resolution logic,
109 which might then not match what the system dpkg considers satisfiable.
111 =item B<DEB_BUILD_PROFILES>
113 If set, it will be used as the active build profile(s) for the package
114 being built.
115 It is a space separated list of profile names.
116 Overridden
117 by the B<-P> option.
119 =item B<DPKG_COLORS>
121 Sets the color mode (since dpkg 1.18.5).
122 The currently accepted values are: B<auto> (default), B<always> and
123 B<never>.
125 =item B<DPKG_NLS>
127 If set, it will be used to decide whether to activate Native Language Support,
128 also known as internationalization (or i18n) support (since dpkg 1.19.0).
129 The accepted values are: B<0> and B<1> (default).
131 =back