1DEB-BUILDCHECK(1) DOSE Tools DEB-BUILDCHECK(1)
2
6 dose-builddebcheck - Check if a package can be built on a Debian system
7
9 dose-builddebcheck --deb-native-arch=name [options] binary-
10 repositories source-repository
11
13 dose-builddebcheck determines, for a set of debian source package
14 control stanzas, called the source repository, whether a build
15 environment for the packages of the source repository can be installed
16 on the specified native architecture by using packages from the binary
17 repository. For this, only package meta-information is taken into
18 account: build-dependencies and build-conflicts in the source package,
19 and inter-package relationsships expressed in the binary repository.
20 The constraint solving algorithm is complete, that is it finds a
21 solution whenever there exists one, even for multiple disjunctive
22 dependencies and deep package conflicts. This problem is
23 computationally infeasible in theory (that is, NP-complete), but can be
24 solved very efficiently for package repositories that actually occur in
25 practice. Installability of binary packages is analyzed according to
26 their Depends, Conflicts, and Provides fields with their meaning as of
27 Debian policy version 3.9.0. Pre-depends are treated like Depends, and
28 Breaks are treated like Conflicts.
29
31 The binary-repositories argument is a list of filenames containing
32 stanzas in the format of deb-control(5), separated by one blank line.
33 For instance, the Packages files as found on a Debian mirror server, or
34 in the directory /var/lib/apt/lists/ of a Debian system, are suitable.
35 The source-repository argument is the name of a file containing debian
36 source control stanzas, separated by one blank line. For instance, the
37 Sources files as found on a Debian mirror server, or in the directory
38 /var/lib/apt/lists/ of a Debian system, are suitable. binary-
39 repositories and source-repository can be passed in compresssed format
40 (.gz , .bz2).
41 Multi-arch annotations are correctly considered by dose-builddebcheck.
43 Packages whose's architecture is neither the native architecture nor in
44 the list of foreign architectures (see below) are ignored. Here, native
45 and foreign refers at the same time to the architecture on which the
46 compilation will be run, and to the host architecture of the
47 compilation. Cross-compilation is supported by specifying the host
48 architecture.
49
51 MISC OPTIONS
52 --version
53 Show program's version and exit.
54 -h, --help
56 This option displays the help message.
57 -v, --verbose
59 Enable info / warnings / debug messages. This option may be
60 repeated up to three times in order to increase verbosity.
61 --progress
63 Print progress bars.
64 --timers
66 Print timing information.
67 --quiet Do no print any messages.
69 DISTCHECK OPTIONS
71 -e, --explain
72 Give explanations. If used together with --failures then the
73 explanation consists of dependency chains leading to a conflict
74 or a dependency on a missing package. If used together with
75 --successes then the explanation consists of an installation
76 set.
77 -m, --explain-minimal
79 For all packages P that are found installable, and when used in
80 conjunction with --successes, prints a reduced installation set
81 containing only those packages in the dependency cone of P.
82 When used with Debian repositories, all essential packages and
83 their dependencies that are not in the cone of P are omitted.
84 When used in conjunction with --failures, and --explain, all
85 dependencies chains are not printed.
86 -c, --explain-condense
88 Compress explanation graph
89 -f --failures
91 Only show broken packages that fail the installability check.
92 -s --successes
94 Only show packages that do not fail the installability check.
95 --summary
97 Gives a more detailed summary of the findings.
98 INPUT OPTIONS
100 --checkonly package [,package] ...
101 Takes a comma-separated list of package names, each of them
102 possibly with a version constraint, as argument. The foreground
103 is constituted of all packages that match any of the
104 expressions, all other packages are pushed into the background.
105 The initial distinction between foreground and background is
106 ignored. This option must not be combined with --coinst.
107 Example: --checkonly "libc6 , 2ping (= 1.2.3-1)"
109 --latest n
111 Consider only the latest -n most recent versions of each
112 package, older versions of packages are ignored.
113 OUTPUT OPTIONS
115 -o, --outfile= file
116 Send output to file.
117 -d, --outdir= directory
119 Set the output directory (default current directory).
120 --dot Save the explanation graph (one for each package) in dot
122 format.
123 --dump=file
125 Dump the cudf file.
126 DEBIAN OPTIONS
128 --deb-native-arch=name
129 Specify the native architecture. This argument is mandatory.
130 --deb-host-arch=name...
132 Specify the host architecture.
133 --deb-foreign-archs=name [,name] ...
135 Specify a comma-separated list of foreign architectures. The
136 default is an empty list of foreign architectures. If
137 --deb-host-arch is set, it is used as an implicit foreign
138 architecture.
139 --deb-ignore-essential
141 Do not consider essential packages as part of the installation
142 problem. By default all essential package are considered as
143 part of the installation problem for all packages, that is a
144 package is installable if and only if it is co-installable with
145 all essential packages. This option allows the user to test the
146 installability with no essential packages installed.
147 --deb-builds-from
149 Add builds-from relationship of binary packages on source
150 packages as dependency. This allows one to create graphs for
151 bootstrapping purposes.
152 --deb-tupletable=file
154 Path to an architecture tuple table like
155 /usr/share/dpkg/tupletable
156 --deb-cputable=file
158 Path to a cpu table like /usr/share/dpkg/cputable
159 --deb-defaulted-m-a-foreign
161 Convert Arch:all packages to Multi-Arch: foreign
162 --deb-drop-b-d-indep
164 Drop Build-Indep dependencies
165 --deb-drop-b-d-arch
167 Drop Build-Arch dependencies
168 --deb-include-extra-source
170 Include packages with Extra-Source-Only:yes (dropped by
171 default)
172 -P, --deb-profiles=name[,name...]
174 Comma separated list of activated build profiles.
175 --deb-emulate-sbuild
177 Replicate sbuild behaviour to only keep the first alternative
178 of build dependencies.
179
181 Exit codes 0-63 indicate a normal termination of the program, codes
182 64-127 indicate abnormal termination of the program (such as parse
183 errors, I/O errors).
184 In case of normal program termination:
186 - exit code 0 indicates that all foreground packages are found
188 installable;
189 - exit code 1 indicates that at least one foreground package is found
191 uninstallable.
192
194 Compute the list of source packages in Sources for which it is not
195 possible to install a build environment on i386, assuming that the
196 binary packages described in file Packages are available:
197 dose-builddebcheck -v -f -e --deb-native-arch=amd64 \
199 /var/lib/apt/lists/ftp.fr.debian.org_debian_dists_sid_main_binary-amd64_Packages\
200 /var/lib/apt/lists/ftp.fr.debian.org_debian_dists_sid_main_source_Sources
201 Compute the list of source packages for armel in Sources for which it
203 is not possible to install a mix build environment on amd64 plus armel,
204 assuming that the binary packages described in file Packages are
205 available:
206 deb-builddebcheck --failures --successes --deb-native-arch=amd64 \
208 --deb-foreign-archs=armel,linux-any --deb-host-arch=armel \
209 DebianPackages/Sid-amd64-armel-Packages-050812.bz2
210 DebianPackages/Sid-Sources-single-version-050812.bz2
211
213 The current version has been rewritten on the basis of the dose3
214 library by Pietro Abate; it replaces an earlier version that was
215 simply a wrapper for edos-distcheck.
216
218 deb-control(5), dose3-distcheck(1)
219 <http://www.edos-project.org> is the home page of the EDOS project.
221 <http://www.mancoosi.org> is the home page of the Mancoosi project.
222 2021-03-02 DEB-BUILDCHECK(1)