dose-debcoinstall [options] binary-repositories


dose-debcoinstall determines whether a set of foreground Debian binary packages can be installed together given a set of background Debian binary packages. If yes, then a valid coinstallation set is printed on standard output. If the --src option is given, then the associated source packages are printed on standard output instead.

Packages are split into foreground and background: only packages in the foreground are checked for coinstallability, but dependencies may be satisfied by foreground packages and by background packages. By default, all packages are in the foreground.

Input format

The binary-repositories argument is a list of filenames containing stanzas in the format of deb-control(5), separated by one blank line. For instance, the Packages files as found on a Debian mirror server, or in the directory /var/lib/apt/lists/ of a Debian system, are suitable.

The --src option requires a file containing debian source control stanzas, separated by one blank line. For instance, the Sources files as found on a Debian mirror server, or in the directory /var/lib/apt/lists/ of a Debian system, are suitable.



Specify the native architecture. The default behavior is to deduce the native architecture from the first package stanza in the input that has an architecture different from all.

--deb-foreign-archs=name [,name] ...

Specify a comma-separated list of foreign architectures. The default is an empty list of foreign architectures. If --deb-host-arch is set, it is used as an implicit foreign architecture.


Specify the host architecture. If this option is given, --deb-native-arch must also be set.

-f --failures

Only show broken packages that fail the installability check.

-v --successes

Only show packages that do not fail the installability check.

-e --explain

Explain the results in more detail.


Instead of printing binary packages, print the associated source packages as given in the debian Sources file source-repository.


Dump the calculated CUDF universe to cudf-file.


Specify a foreground binary repository.


Specify a background binary repository.


Enable info / warnings / debug messages. This option may be repeated up to three times in order to increase verbosity.

-h, --help

Display this list of options.

Exit codes

If a coinstallation set exists, the program returns a zero exit status. If no coinstallation set exists, the exit code is one.


Compute the list of binary packages needed to install all packages marked as essential:

 grep-dctrl -X -FEssential yes \
 /var/lib/apt/lists/ \
 > essential

 dose-debcoinstall --deb-native-arch=amd64 \
 --bg /var/lib/apt/lists/ \
 --fg essential > essential_coinstall

Compute the list of source packages needed to build these packages:

 dose-debcoinstall --deb-native-arch=amd64 \
 --src /var/lib/apt/lists/ \
 --bg /var/lib/apt/lists/ \
 --fg essential > essential_coinstall_src


The current version has been rewritten on the basis of the dose3 library by Pietro Abate.

See also

deb-control(5), dose3-distcheck(1)

<> is the home page of the EDOS project. <> is the home page of the Mancoosi project.