1DEB-BUILDCHECK(1)                 DOSE Tools                 DEB-BUILDCHECK(1)
2
3
4

NAME

6       dose-builddebcheck - Check if a package can be built on a Debian system
7

SYNOPSIS

9       dose-builddebcheck  --deb-native-arch=name [options] binary-
10       repositories source-repository
11

DESCRIPTION

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

INPUT FORMAT

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
42       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

OPTIONS

51   MISC OPTIONS
52       --version
53               Show program's version and exit.
54
55       -h, --help
56               This option displays the help message.
57
58       -v, --verbose
59               Enable info / warnings / debug messages. This option may be
60               repeated up to three times in order to increase verbosity.
61
62       --progress
63               Print progress bars.
64
65       --timers
66               Print timing information.
67
68       --quiet Do no print any messages.
69
70   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
78       -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
87       -c, --explain-condense
88               Compress explanation graph
89
90       -f --failures
91               Only show broken packages that fail the installability check.
92
93       -s --successes
94               Only show packages that do not fail the installability check.
95
96       --summary
97               Gives a more detailed summary of the findings.
98
99   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
108               Example: --checkonly "libc6 , 2ping (= 1.2.3-1)"
109
110       --latest n
111               Consider only the latest -n most recent versions of each
112               package, older versions of packages are ignored.
113
114   OUTPUT OPTIONS
115       -o, --outfile= file
116               Send output to file.
117
118       -d, --outdir= directory
119               Set the output directory (default current directory).
120
121       --dot   Save the explanation graph (one for each package) in dot
122               format.
123
124       --dump=file
125               Dump the cudf file.
126
127   DEBIAN OPTIONS
128       --deb-native-arch=name
129               Specify the native architecture. This argument is mandatory.
130
131       --deb-host-arch=name...
132               Specify the host architecture.
133
134       --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
140       --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
148       --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
153       --deb-tupletable=file
154               Path to an architecture tuple table like
155               /usr/share/dpkg/tupletable
156
157       --deb-cputable=file
158               Path to a cpu table like /usr/share/dpkg/cputable
159
160       --deb-defaulted-m-a-foreign
161               Convert Arch:all packages to Multi-Arch: foreign
162
163       --deb-drop-b-d-indep
164               Drop Build-Indep dependencies
165
166       --deb-drop-b-d-arch
167               Drop Build-Arch dependencies
168
169       --deb-include-extra-source
170               Include packages with Extra-Source-Only:yes (dropped by
171               default)
172
173       -P, --deb-profiles=name[,name...]
174               Comma separated list of activated build profiles.
175
176       --deb-emulate-sbuild
177               Replicate sbuild behaviour to only keep the first alternative
178               of build dependencies.
179

EXIT CODES

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
185       In case of normal program termination:
186
187       - exit code 0 indicates that all foreground packages are found
188       installable;
189
190       - exit code 1 indicates that at least one foreground package is found
191       uninstallable.
192

EXAMPLE

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
198        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
202       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
207        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

AUTHOR

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

SEE ALSO

218       deb-control(5), dose3-distcheck(1)
219
220       <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
223
224
225                                  2021-03-02                 DEB-BUILDCHECK(1)
Impressum