1DEBCOINSTALL(1) DOSE Tools DEBCOINSTALL(1)
2
3
4
6 dose-debcoinstall - calculate a coinstallation set of a given set of
7 Debian binary packages
8
10 dose-debcoinstall [options] binary-repositories
11
13 dose-debcoinstall determines whether a set of foreground Debian binary
14 packages can be installed together given a set of background Debian
15 binary packages. If a valid coinstallation set exists, than it is
16 printed on standard output; else the application exists with exit code
17 1 and prints nothing.
18
19 If the --src option is given, then the associated source packages are
20 printed on standard output instead.
21
22 Packages are split into foreground and background: only packages in the
23 foreground are checked for coinstallability, but dependencies may be
24 satisfied by foreground packages and by background packages. By
25 default, all packages are in the foreground.
26
28 The binary-repositories argument is a list of filenames containing
29 stanzas in the format of deb-control(5), separated by one blank line.
30 For instance, the Packages files as found on a Debian mirror server, or
31 in the directory /var/lib/apt/lists/ of a Debian system, are suitable.
32
33 The --src option requires a file containing debian source control
34 stanzas, separated by one blank line. For instance, the Sources files
35 as found on a Debian mirror server, or in the directory
36 /var/lib/apt/lists/ of a Debian system, are suitable.
37
39 --deb-native-arch=name
40 Specify the native architecture. The default behavior is to
41 deduce the native architecture from the first package stanza in
42 the input that has an architecture different from all.
43
44 --deb-foreign-archs=name [,name] ...
45 Specify a comma-separated list of foreign architectures. The
46 default is an empty list of foreign architectures. If
47 --deb-host-arch is set, it is used as an implicit foreign
48 architecture.
49
50 --deb-host-arch=name...
51 Specify the host architecture. If this option is given,
52 --deb-native-arch must also be set.
53
54 -f --failures
55 Print a diagnostic in YAML format containing the list of
56 packages that were attempted to install together and the result
57 of the operation.
58
59 -v --successes
60 Only show packages that do not fail the installability check.
61
62 -e --explain
63 Explain the results in more detail providing the reason why
64 some packages cannot be installed together.
65
66 --src=source-repository
67 Instead of printing binary packages, print the associated
68 source packages as given in the debian Sources file source-
69 repository.
70
71 --dump=cudf-file
72 Dump the CUDF universe to cudf-file representing the encoding
73 of binary and source packages, plus the coinstallability
74 request.
75
76 --fg=binary-repository
77 Specify a foreground binary repository.
78
79 --bg=binary-repository
80 Specify a background binary repository.
81
82 --latest n
83 Consider only the latest -n most recent versions of each
84 package, older versions of packages are ignored.
85
86 -v Enable info / warnings / debug messages. This option may be
87 repeated up to three times in order to increase verbosity.
88
89 -h, --help
90 Display this list of options.
91
93 Exit codes 0-63 indicate a normal termination of the program, codes
94 64-127 indicate abnormal termination of the program (such as parse
95 errors, I/O errors).
96
97 In case of normal program termination:
98
99 - exit code 0 indicates that a valid coinstallation set exists
100
101 - exit code 1 indicates that at no coinstallation set exists
102
104 Compute the list of binary packages needed to install all packages
105 marked as essential:
106
107 grep-dctrl -X -FEssential yes \
108 /var/lib/apt/lists/ftp.fr.debian.org_debian_dists_sid_main_binary-amd64_Packages \
109 > essential
110
111 dose-debcoinstall --deb-native-arch=amd64 \
112 --bg /var/lib/apt/lists/ftp.fr.debian.org_debian_dists_sid_main_binary-amd64_Packages \
113 --fg essential > essential_coinstall
114
115 Compute the list of source packages needed to build these packages:
116
117 dose-debcoinstall --deb-native-arch=amd64 \
118 --src /var/lib/apt/lists/ftp.fr.debian.org_debian_dists_sid_main_source_Sources \
119 --bg /var/lib/apt/lists/ftp.fr.debian.org_debian_dists_sid_main_binary-amd64_Packages \
120 --fg essential > essential_coinstall_src
121
123 The current version has been rewritten on the basis of the dose3
124 library by Pietro Abate.
125
127 deb-control(5), dose3-distcheck(1)
128
129 <http://www.edos-project.org> is the home page of the EDOS project.
130 <http://www.mancoosi.org> is the home page of the Mancoosi project.
131
132
133
134 2020-04-09 DEBCOINSTALL(1)