.\" 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 "DEBCOINSTALL 1" .TH DEBCOINSTALL 1 "2014-10-19" " " "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\-debcoinstall \- calculate a coinstallation set of a given set of Debian binary packages .SH "SYNOPSIS" .IX Header "SYNOPSIS" .IP "\fBdose-debcoinstall\fR [options] \fIbinary-repositories\fR" 4 .IX Item "dose-debcoinstall [options] binary-repositories" .SH "DESCRIPTION" .IX Header "DESCRIPTION" dose-debcoinstall determines whether a set of foreground Debian binary packages can be installed together given a set of background Debian binary packages. If a valid coinstallation set exists, than it is printed on standard output; else the application exists with exit code 1 and prints nothing. .PP If the \fB\-\-src\fR option is given, then the associated source packages are printed on standard output instead. .PP 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. .SH "INPUT FORMAT" .IX Header "INPUT FORMAT" The \fBbinary-repositories\fR argument is a list of filenames containing stanzas in the format of \fIdeb\-control\fR\|(5), separated by one blank line. For instance, the Packages files as found on a Debian mirror server, or in the directory \&\fI/var/lib/apt/lists/\fR of a Debian system, are suitable. .PP The \fB\-\-src\fR 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 \fI/var/lib/apt/lists/\fR of a Debian system, are suitable. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-\-deb\-native\-arch=\fR\fIname\fR" 8 .IX Item "--deb-native-arch=name" 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. .IP "\fB\-\-deb\-foreign\-archs=\fR\fIname\fR [,\fIname\fR] ..." 8 .IX Item "--deb-foreign-archs=name [,name] ..." Specify a comma-separated list of foreign architectures. The default is an empty list of foreign architectures. If \fB\-\-deb\-host\-arch\fR is set, it is used as an implicit foreign architecture. .IP "\fB\-\-deb\-host\-arch=\fR\fIname\fR..." 8 .IX Item "--deb-host-arch=name..." Specify the host architecture. If this option is given, \fB\-\-deb\-native\-arch\fR must also be set. .IP "\fB\-f \-\-failures\fR" 8 .IX Item "-f --failures" Print a diagnostic in \s-1YAML\s0 format containing the list of packages that were attempted to install together and the result of the operation. .IP "\fB\-v \-\-successes\fR" 8 .IX Item "-v --successes" Only show packages that do not fail the installability check. .IP "\fB\-e \-\-explain\fR" 8 .IX Item "-e --explain" Explain the results in more detail providing the reason why some packages cannot be installed together. .IP "\fB\-\-src=\fR\fIsource-repository\fR" 8 .IX Item "--src=source-repository" Instead of printing binary packages, print the associated source packages as given in the debian Sources file \fBsource-repository\fR. .IP "\fB\-\-dump=\fR\fIcudf-file\fR" 8 .IX Item "--dump=cudf-file" Dump the \s-1CUDF\s0 universe to \fBcudf-file\fR representing the encoding of binary and source packages, plus the coinstallability request. .IP "\fB\-\-fg=\fR\fIbinary-repository\fR" 8 .IX Item "--fg=binary-repository" Specify a foreground binary repository. .IP "\fB\-\-bg=\fR\fIbinary-repository\fR" 8 .IX Item "--bg=binary-repository" Specify a background binary repository. .IP "\fB\-v\fR" 8 .IX Item "-v" Enable info / warnings / debug messages. This option may be repeated up to three times in order to increase verbosity. .IP "\fB\-h, \-\-help\fR" 8 .IX Item "-h, --help" Display this list of options. .SH "EXIT CODES" .IX Header "EXIT CODES" Exit codes 0\-63 indicate a normal termination of the program, codes 64\-127 indicate abnormal termination of the program (such as parse errors, I/O errors). .PP In case of normal program termination: .PP \&\- exit code 0 indicates that a valid coinstallation set exists .PP \&\- exit code 1 indicates that at no coinstallation set exists .SH "EXAMPLE" .IX Header "EXAMPLE" Compute the list of binary packages needed to install all packages marked as essential: .PP .Vb 3 \& grep\-dctrl \-X \-FEssential yes \e \& /var/lib/apt/lists/ftp.fr.debian.org_debian_dists_sid_main_binary\-amd64_Packages \e \& > essential \& \& dose\-debcoinstall \-\-deb\-native\-arch=amd64 \e \& \-\-bg /var/lib/apt/lists/ftp.fr.debian.org_debian_dists_sid_main_binary\-amd64_Packages \e \& \-\-fg essential > essential_coinstall .Ve .PP Compute the list of source packages needed to build these packages: .PP .Vb 4 \& dose\-debcoinstall \-\-deb\-native\-arch=amd64 \e \& \-\-src /var/lib/apt/lists/ftp.fr.debian.org_debian_dists_sid_main_source_Sources \e \& \-\-bg /var/lib/apt/lists/ftp.fr.debian.org_debian_dists_sid_main_binary\-amd64_Packages \e \& \-\-fg essential > essential_coinstall_src .Ve .SH "AUTHOR" .IX Header "AUTHOR" The current version has been rewritten on the basis of the dose3 library by Pietro Abate. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBdeb-control\fR(5), \&\fBdose3\-distcheck\fR(1) .PP is the home page of the \s-1EDOS\s0 project. is the home page of the Mancoosi project.