.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
.    if \nF \{
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "CEVE 1"
.TH CEVE 1 "2014-12-12" " " "DOSE Tools"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
dose\-ceve \- parse package metadata
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.IP "\fBdose-ceve\fR [\-h] [\-v] [\-e \fIpkgspec\fR] [\-c \fIpkgspec\fR] [\-r \fIpkgspec\fR] [\-\-depth=\fIn\fR]\fI\fR [\-T \fIformat\fR] [\-G \fIgraph type\fR] [\-o \fIfilename\fR] \fIinput-spec\fR" 4
.IX Item "dose-ceve [-h] [-v] [-e pkgspec] [-c pkgspec] [-r pkgspec] [--depth=n] [-T format] [-G graph type] [-o filename] input-spec"
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Dose-ceve is a generalized metadata parser. It reads package specifications,
extracts package metadata from them, performs some manipulations, and outputs
the package metadata in one of several formats.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-h\fR" 4
.IX Item "-h"
This option displays the help message. Can also be specified as \fB\-\-help\fR.
.IP "\fB\-v\fR" 4
.IX Item "-v"
Be verbose. This option can be repeated for more verbosity.
.IP "\fB\-e \fR\fIpkgspec\fR" 4
.IX Item "-e pkgspec"
(Option Not Implemented Yet) Extract the transitive closure of packages connected (by conflict or
dependency) to any of the packages that satisfy \fIpkgspec\fR. Such a package
specification is a list of packages (separated by a semicolon), where each
package is specified as follows: (\fIname\fR,\fIversion\fR).\fI\fR This option can also
be specified as \-\-extract=\fIpkgspec\fR.\fI\fR
.IP "\fB\-c \fR\fIpkgspec\fR" 4
.IX Item "-c pkgspec"
Similar to the \fB\-c\fR option, but only uses the dependency relation to make
the transitive closure. This option can also be specified as \-\-cone=\fIpkgspec\fR.\fI\fR
.IP "\fB\-r \fR\fIpkgspec\fR" 4
.IX Item "-r pkgspec"
Similar to the \fB\-e\fR and \fB\-c\fR options, but uses the reverse dependency
relation to make the transitive closure. This option can also be specified
as \-\-rcone=\fIpkgspec\fR.\fI\fR
.IP "\fB\-\-depth \fR\fIn\fR" 4
.IX Item "--depth n"
In combination with the \fB\-e\fR, \fB\-c\fR or \fB\-r\fR options, this
specifies the maximum depth for the transitive closure.
.IP "\fB\-T \fR\fIformat\fR" 4
.IX Item "-T format"
Specifies the output format to use. Possible values are \fBdot\fR for a graph
output in Dot/GraphViz format, \fBcnf\fR for an output in \s-1CNF\s0 format, \fBdimacs\fR
for an output in the \s-1DIMACS\s0 format for \s-1CNF\s0 formulae, and \fBcudf\fR for a
pretty-print output in an \s-1RFC\s0 822\-like format.
.IP "\fB\-t \fR\fIinput-spec\fR" 4
.IX Item "-t input-spec"
Select the input type.
.IP "\fB\-\-request \fR\fIinstallation-request\fR" 4
.IX Item "--request installation-request"
Specifies an installation request of the form "\fBinstall:\fR \fIvpkglist\fR\*(L" or
\&\*(R"\fBremove:\fR \fIvpkglist\fR\*(L" or \*(R"\fBupgrade:\fR \fIvpkglist\fR" where \fIvpkglist\fR is a list of (real)
packages possibly associated with a constraint. Ex.: bash (< 2.0), exim (=
3.1\-debian1). This option can be repeated to specify install, remove and
upgrade actions.
.Sp
Examples:
.ie n .IP "\-\-request ""install: bash (< 2.0), exim (= 3.1\-debian1)"" \-\-request ""upgrade: apt-cudf""" 4
.el .IP "\-\-request ``install: bash (< 2.0), exim (= 3.1\-debian1)'' \-\-request ``upgrade: apt-cudf''" 4
.IX Item "--request install: bash (< 2.0), exim (= 3.1-debian1) --request upgrade: apt-cudf"
.PD 0
.IP "\fB\-G \fR\fIgraph type\fR" 4
.IX Item "-G graph type"
.PD
Specifies the graph type format to compute. This option must be used together
with the option \fB\-T \fR\fIdot|gml|grml\fR. Possible values are:
.IP "." 4
\&\fBsyn\fR for the syntactic graph where disjunctions nodes and conflicts are
explicitly added to the graph.
.IP "." 4
\&\fBpkg\fR for the package graph where all dependencies are threated uniformely and
conflicts are not added to the graph.
.IP "." 4
\&\fBstrong\fR the strong dependency graph.
.IP "." 4
\&\fBconj\fR the conjunctive graph where only conjunctive dependencies are
considered.
.IP "\fB\-o \fR\fIfilename\fR" 4
.IX Item "-o filename"
Instead of stdout, send output to the file \fIfilename\fR.
.IP "\fIinput-spec\fR" 4
.IX Item "input-spec"
This is a \s-1URL\s0 specifying both the input format and the file to get the input
from. Possible schemes are:
.IP "." 4
\&\fBcudf\fR for cudf files
.IP "." 4
\&\fBdeb\fR for Debian package files (possibly compressed with \fIgzip\fR\|(1) or
\&\fIbzip2\fR\|(1), depending on compile-time options for dose3)
.IP "." 4
\&\fBdebstdin\fR for Debian package files read from standard input
.IP "." 4
\&\fBedsp\fR for apt-get External Dependency Solver Protocol
.IP "." 4
\&\fBeclipse\fR for Eclipse (p2) package files
.IP "." 4
\&\fBhdlist\fR for \s-1RPM\s0 hdlists
.IP "." 4
\&\fBsynth\fR for urpmi synthesis hdlists
.Sp
Some examples of URLs:
.IP "." 4
deb://Packages.gz (the Debian file packages.gz in the current directory)
.IP "." 4
cudf:///home/examples/cudf/test.cudf (the \s-1CUDF\s0 file /home/examples/cudf/test.cudf)