debcoinstall(1)

1DEBCOINSTALL(1)                   DOSE Tools                   DEBCOINSTALL(1)
2
3
4

NAME

6       dose-debcoinstall - calculate a coinstallation set of a given set of
7       Debian binary packages
8

SYNOPSIS

10       dose-debcoinstall [options] binary-repositories
11

DESCRIPTION

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

INPUT FORMAT

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

OPTIONS

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

EXIT CODES

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

EXAMPLE

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

AUTHOR

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