1DOSE-CEVE(1) DOSE Tools DOSE-CEVE(1)
2
6 ceve - parse package metadata
7
9 ceve [-h] [-v] [-c pkgspec] [-r pkgspec] [--depth=n] [-T format] [-G
10 graph type] [-o filename] input-spec [input-spec...]
11
13 Ceve is a generalized metadata parser. It reads package specifications,
14 extracts package metadata from them, performs some manipulations, and
15 outputs the package metadata in one of several formats.
16 input-spec is a url specifying the input format and the file to get the
18 input from. For a possible list of schemes, see the -t parameter.
19 Some examples of URLs:
21 . deb://Packages.gz (the Debian file packages.gz in the current
23 directory)
24 . cudf:///home/examples/cudf/test.cudf (the CUDF file
26 /home/examples/cudf/test.cudf)
27
29 MISC OPTIONS
30 -h, --help
31 This option displays the help message.
32 -v, --verbose
34 Be verbose. This option can be repeated for more verbosity.
35 --version
37 Show program's version and exit.
38 --progress
40 Print progress bars.
41 --timers
43 Print timing information.
44 --quiet Do no print any messages.
46 INPUT OPTIONS
48 Dose3 accepts files compressed with gzip(1) or bzip2(1), depending on
49 compile-time options.
50 -t input-spec
52 Select the input type. Possible values are:
53 . cudf Cudf file format
55 . pef PEF file format. The PEF format (Package Exchange Format)
57 is a generic 822 file format used to encode package
58 dependencies. deb, opam, debsrc and edsp are all based on the
59 pef format
60 . csw OpenCSW Solaris packages binary format
62 . opam Opam Package universe in Opam/PEF format. This format is a
64 822 textual format encoding the opam universe.
65 . deb for Debian binary package files, also known as Packages
67 files.
68 . debsrc for Debian source package files, also knows as Sources
70 files.
71 . edsp apt-get External Dependency Solver Protocol
73 . hdlist RPM hdlists. Binary file format.
75 . synthesis urpmi synthesis hdlists. XML Based format
77 --trim Consider only installable packages.
79 --latest n
81 Consider only the latest -n most recent versions of each
82 package, older versions of packages are ignored.
83 -c, --cone=vpkglist
85 The match of an atomic dependency (a package name p possibly
86 together with a version constraint c) is the set of all
87 packages in the repository with name p, and a version that
88 satisfies the constraint c. The dependency cone of a package p
89 is the set of all matches of all atomic dependencies of p,
90 together with their respective dependency cones. The package
91 specification pkgspec is a list of packages (separated by a
92 semicolon), where each package is specified as follows:
93 (name,version).
94 This option extracts the union of the dependency cones of all
96 packages selected by vpkglist.
97 Example: =over 12
99 -c 'golang-golang-x-tools (=
101 1:0.0~git20150716.0.87156cb+dfsg1-4),golang-golang-x-tools-dev'
102 -r, --rcone=vpkglist
103 Using the same syntax as in -c, this option use the reverse
104 dependency relation to make the transitive closure.
105 --depth n
107 In combination with the -c or -r options, this specifies the
108 maximum depth for the transitive closure.
109 --request installation-request
111 Specifies an installation request of the form "install:
112 vpkglist" or "remove: vpkglist" or "upgrade: vpkglist" where
113 vpkglist is a list of (real) packages possibly associated with
114 a constraint. Ex.: bash (< 2.0), exim (= 3.1-debian1). This
115 option can be repeated to specify install, remove and upgrade
116 actions.
117 Examples:
119 --request "install: bash (< 2.0), exim (= 3.1-debian1)"
121 --request "upgrade: apt-cudf"
122 OUTPUT OPTIONS
124 -o, --outfile=filename
125 Instead of stdout, send output to the file filename.
126 -d, --outdir=directory
128 Set the output directory (default current directory)
129 --dot Save the explanation graph (one for each package) in dot
131 format.
132 -G graph type
134 Specifies the graph type format to compute. This option must be
135 used together with the option -T dot|gml|grml. Default is syn.
136 Possible values are:
137 . syn for the syntactic graph where disjunctions nodes and
139 conflicts are explicitly added to the graph.
140 . pkg for the package graph where all dependencies are threated
142 uniformly and conflicts are not added to the graph.
143 . strdeps the strong dependency graph. A package p strong depends
145 on q iff p cannot be installed if q is not installed.
146 . strcnf
148 . conj the conjunctive graph where only conjunctive dependencies
150 are considered.
151 . dom
153 -T format
155 Specifies the output format to use. Default is cnf. Possible
156 values are:
157 . cnf output in CNF format.
159 . dimacs output in DIMACS format for CNF formulae.
161 . cudf pretty-printed output in an RFC 822-like format
163 . deb binary packages in deb822 format.
165 . debsrc source packages in deb822 format.
167 . dot a graph in Dot/GraphViz format.
169 . gml a graph in GML format.
171 . grml a graph in GraphML format.
173 . table plain text output of three integer values: the universe
175 size, the number of edges in the dependency graph, the number
176 of conflicts in the universe.
177 DEBIAN SPECIFIC OPTIONS
179 Multi-arch annotations are handled by ceve. Packages whose's
180 architecture is neither the native architecture nor in the list of
181 foreign architectures (see below) are ignored.
182 --deb-native-arch=name
184 Specify the native architecture. The default behavior is to
185 deduce the native architecture from the first package stanza in
186 the input that has an architecture different from all.
187 --deb-foreign-archs=name [,name] ...
189 Specify a comma-separated list of foreign architectures. The
190 default is an empty list of foreign architectures.
191 --deb-ignore-essential
193 By default all essential package are considered as a dependency
194 of all packages in the universe. This option allows the user to
195 ignore essential packages.
196 --deb-host-arch=name
198 Native/cross compile host architecture, defaults to native
199 architecture.
200 --deb-builds-from
202 Add builds-from relationship of binary packages on source
203 packages as dependency. This allows one to create graphs for
204 bootstrapping purposes.
205 -P, --deb-profiles=name[,name...]
207 Comma separated list of activated build profiles.
208 --deb-drop-b-d-indep
210 Drop Build-Depends-Indep dependencies from Debian source
211 packages.
212 --deb-drop-b-d-arch
214 Drop Build-Depends-Arch dependencies from Debian source
215 packages.
216
218 Find all the reverse binary dependencies of the package patchutils:
219 dose-ceve --deb-native-arch amd64 -r patchutils -T deb \
221 deb:///var/lib/apt/lists/*_dists_sid_main_binary-amd64_Packages \
222 | grep-dctrl -n -s Package '' | sort -u
223 Find all the source packages that (directly or indirectly) build depend
225 on patchutils:
226 dose-ceve -T debsrc --deb-native-arch=amd64 -r patchutils \
228 debsrc:///var/lib/apt/lists/*_dists_sid_main_source_Sources \
229 deb:///var/lib/apt/lists/*_dists_sid_main_binary-amd64_Packages \
230 | grep-dctrl -n -s Package '' | sort -u
231 Find the source packages (-T debsrc) that have in a relation builds-
233 from with all the binary package in the reverse dependency cone of
234 libssl-dev (a specific version constraint).
235 dose-ceve --deb-builds-from --deb-native-arch=amd64 -T debsrc \
237 -r 'libssl-dev (>= 0.9.8)' deb://Sid-amd64-Packages-050812.bz2 \
238 debsrc://Sid-Sources-050812.bz2
239 2023-09-10 DOSE-CEVE(1)