.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" 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 >0, 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
.\" ========================================================================
.\"
.IX Title "CUPT 1"
.TH CUPT 1 "2020-12-27" "perl v5.32.0" "User Contributed Perl Documentation"
.\" 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"
cupt \- console package management tool
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Cupt is a high-level package manager for Debian and Debian-based systems.
.PP
You might want to read \fBcupt_tutorial\fR\|(7) (or its \s-1HTML\s0 version at
/usr/share/doc/cupt/tutorial.html) before.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
cupt [ \fIoption\fR... ] \fIaction\fR [ { \fIparameter\fR | \fIoption\fR } ... ]
.SH "ACTIONS"
.IX Header "ACTIONS"
.SS "Query actions"
.IX Subsection "Query actions"
.IP "version,\-v,\-\-version" 4
.IX Item "version,-v,--version"
prints versions of packages 'cupt' and 'libcupt\-perl'
.IP "help,\-h,\-\-help" 4
.IX Item "help,-h,--help"
prints the short help for available actions
.IP "config-dump" 4
.IX Item "config-dump"
prints all configuration variables to standard output
.Sp
Example:
.Sp
\&\f(CW\*(C`cupt config\-dump\*(C'\fR
.IP "show" 4
.IX Item "show"
prints version info of specified binary packages
.Sp
This subcommand receives list of \*(L"Binary package version expression\*(R"'s, see below.
.Sp
Specific options:
.RS 4
.IP "\-\-all\-versions,\-a" 4
.IX Item "--all-versions,-a"
print all versions of the package, not selected one
.Sp
Corresponding configuration variable: apt::cache::allversions
.IP "\-\-no\-all\-versions" 4
.IX Item "--no-all-versions"
don't print all versions of the package, use only selected one
.Sp
Corresponding configuration variable: apt::cache::allversions
.IP "\-\-with\-release\-info" 4
.IX Item "--with-release-info"
also print information about release info where the version of the package live
.RE
.RS 4
.Sp
Examples:
.Sp
\&\f(CW\*(C`cupt show qmmp\*(C'\fR
.Sp
\&\f(CW\*(C`cupt show \-\-all\-versions qmmp debianutils\*(C'\fR
.Sp
\&\f(CW\*(C`cupt show \-\-with\-release\-info audacious/testing apt debianutils=2.3.38\*(C'\fR
.RE
.IP "showsrc" 4
.IX Item "showsrc"
The same as show, only for source packages.
.Sp
Examples:
.Sp
\&\f(CW\*(C`cupt showsrc \-\-all\-versions qmmp\*(C'\fR
.Sp
\&\f(CW\*(C`cupt showsrc \-\-with\-release\-info audacious/testing apt\*(C'\fR
.Sp
\&\f(CW\*(C`cupt showsrc libxine1\*(C'\fR
.IP "search" 4
.IX Item "search"
searches for packages that contains some string within package names and package descriptions
.Sp
This subcommand receives a list a Perl-compatible Regular Expressions (\s-1PCRE\s0) to
search. Only those packages will be printed that contain all of specified
patterns.
.Sp
Specific options:
.RS 4
.IP "\-\-case\-sensitive" 4
.IX Item "--case-sensitive"
search case-sensitively
.IP "\-\-names\-only,\-n" 4
.IX Item "--names-only,-n"
search only in package names
.Sp
Corresponding configuration variable: apt::cache::namesonly
.IP "\-\-fse,\-f" 4
.IX Item "--fse,-f"
Turns on functional selector expression mode. In that mode, instead of
specifying one or more regular expressions, exactly one \s-1FSE\s0 (see
\&\fBcupt_functionalselectors\fR\|(7)) should be specified.
.RE
.RS 4
.Sp
Examples:
.Sp
\&\f(CW\*(C`cupt search nvidia driver\*(C'\fR
.Sp
\&\f(CW\*(C`cupt search \-\-case\-sensitive Vim\*(C'\fR
.Sp
\&\f(CW\*(C`cupt search \-n vim\*(C'\fR
.Sp
\&\f(CW\*(C`cupt search "package manager"\*(C'\fR
.Sp
\&\f(CW\*(C`cupt search \-\-fse \*(AqZbd(Pn(cupt))\*(Aq\*(C'\fR
.RE
.IP "showauto" 4
.IX Item "showauto"
prints list of automatically/manually installed packages, one package name per
line
.Sp
\&\*(L"cupt showauto\*(R": prints list of automatically installed packages
.Sp
\&\*(L"cupt showauto \-\-invert\*(R": prints list of manually installed packages
.IP "depends" 4
.IX Item "depends"
prints dependency relation expressions for given version of package
.Sp
By default prints 'Pre\-Depends', 'Depends' and 'Recommends' for the version.
.Sp
This subcommand receives list of \*(L"Binary package version expression\*(R"'s, see below.
.Sp
Specific options:
.RS 4
.IP "\-\-with\-suggests" 4
.IX Item "--with-suggests"
take also 'Suggests' dependencies into account
.IP "\-\-recurse" 4
.IX Item "--recurse"
process the dependencies recursively
.Sp
Corresponding configuration variable: apt::cache::recursedepends
.IP "\-\-all\-versions,\-a" 4
.IX Item "--all-versions,-a"
when \-\-recurse is specified, pick up all versions for the
relation expression, not the \*(L"best\*(R" one
.Sp
Corresponding configuration variable: apt::cache::allversions
.RE
.RS 4
.Sp
Examples:
.Sp
\&\f(CW\*(C`cupt depends nlkt perl/stable\*(C'\fR
.Sp
\&\f(CW\*(C`cupt depends \-\-important xserver\-xorg\-core\*(C'\fR
.Sp
\&\f(CW\*(C`cupt depends \-\-recurse xmlto\*(C'\fR
.RE
.IP "rdepends" 4
.IX Item "rdepends"
same as depends, but prints reverse relations instead of forward ones
.IP "why" 4
.IX Item "why"
prints one of available dependency paths between package(s)/system and the
package.
.Sp
This subcommand receives a list of binary package expressions (which can be
empty), then one binary package expression without wildcards.
.Sp
If the list of binary package expressions is empty (i.e. subcommand received
only one argument), then the list is build of manually installed packages in
the system.
.Sp
If no dependency paths found, prints nothing.
.Sp
Uses configuration variables
cupt::resolver::keep\-recommends and
cupt::resolver::keep\-suggests to determine
whether to honor Recommends and Suggests respectively when building dependency
paths.
.Sp
Examples:
.Sp
\&\f(CW\*(C`cupt why kmail libgnutls26\*(C'\fR
.Sp
\&\f(CW\*(C`cupt why libgnutls26\*(C'\fR
.Sp
\&\f(CW\*(C`cupt why icedove kmail libgnutls26\*(C'\fR
.IP "policy" 4
.IX Item "policy"
Given arguments, prints available versions with pins and release info for each binary package
.Sp
Arguments: list of binary package names.
.Sp
Given no arguments, prints available Release info for binary packages.
.Sp
Specific options:
.RS 4
.IP "\-\-show\-dates" 4
.IX Item "--show-dates"
Show also publish and expiration dates for each record. Works only for a second
form (i.e. no arguments).
.RE
.RS 4
.Sp
Examples:
.Sp
\&\f(CW\*(C`cupt policy\*(C'\fR
.Sp
\&\f(CW\*(C`cupt policy \-\-show\-dates\*(C'\fR
.Sp
\&\f(CW\*(C`cupt policy dpkg\*(C'\fR
.Sp
\&\f(CW\*(C`cupt policy libpqxx\-2.6.9ldbl libpqxx\-3.0\*(C'\fR
.RE
.IP "policysrc" 4
.IX Item "policysrc"
Given arguments, prints available versions with pins and release info for each source package.
.Sp
Arguments: list of source package names.
.Sp
Given no arguments, prints available Release info for source packages.
.Sp
Same specific options as for \*(L"policy\*(R" subcommand.
.Sp
Examples:
.Sp
\&\f(CW\*(C`cupt policysrc\*(C'\fR
.Sp
\&\f(CW\*(C`cupt policysrc \-\-show\-dates\*(C'\fR
.Sp
\&\f(CW\*(C`cupt policysrc dpkg\*(C'\fR
.Sp
\&\f(CW\*(C`cupt policysrc libpqxx libpqxx3\*(C'\fR
.IP "pkgnames" 4
.IX Item "pkgnames"
prints package names that start with a supplied prefix
.Sp
If no prefix is given, prints all package names
.Sp
Examples:
.Sp
\&\f(CW\*(C`cupt pkgnames\*(C'\fR
.Sp
\&\f(CW\*(C`cupt pkgnames liba\*(C'\fR
.IP "changelog" 4
.IX Item "changelog"
displays changelog for given versions of packages
.Sp
This subcommand receives list of \*(L"Binary package version expression\*(R"'s, see below.
.Sp
Works only with installed packages and official Debian and Ubuntu repositories.
.Sp
Examples:
.Sp
\&\f(CW\*(C`cupt changelog dpkg/installed\*(C'\fR
.Sp
\&\f(CW\*(C`cupt changelog \-\-installed\-only dpkg nlkt lintian\*(C'\fR
.Sp
\&\f(CW\*(C`cupt changelog libqtcore4\*(C'\fR
.IP "copyright" 4
.IX Item "copyright"
displays copyright for given versions of packages
.Sp
This subcommand receives list of \*(L"Binary package version expression\*(R"'s, see below.
.Sp
Works only with installed packages and official Debian and Ubuntu repositories.
.Sp
Examples:
.Sp
\&\f(CW\*(C`cupt copyright dpkg/installed\*(C'\fR
.Sp
\&\f(CW\*(C`cupt copyright \-\-installed\-only dpkg nlkt lintian\*(C'\fR
.Sp
\&\f(CW\*(C`cupt copyright libqtcore4\*(C'\fR
.IP "screenshots" 4
.IX Item "screenshots"
open a browser window/tab with screenshots of given packages.
.Sp
This subcommand receives list of package names.
.Sp
Example:
.Sp
\&\f(CW\*(C`cupt screenshots arora\*(C'\fR
.IP "snapshot list" 4
.IX Item "snapshot list"
list names of the available system snapshots, one per line
.Sp
This subcommand receives no arguments.
.Sp
Example: \f(CW\*(C`cupt snapshot list\*(C'\fR
.IP "tar-metadata" 4
.IX Item "tar-metadata"
This subcommand is experimental. Its name and functionality are unstable.
.Sp
Packs all cupt configuration files and repository metadata to a tar stream and
outputs it to standard output.
.Sp
Example: \f(CW\*(C`cupt tar\-metadata | xz \-\-verbose \-c > cupt\-metadata.tar.xz\*(C'\fR
.PP
\fIquery-specific options\fR
.IX Subsection "query-specific options"
.IP "\-\-important,\-i" 4
.IX Item "--important,-i"
don't take 'Recommends' dependencies into account
.Sp
Corresponding configuration variable: apt::cache::important
.IP "\-\-installed\-only" 4
.IX Item "--installed-only"
work only with installed versions of packages; valuable only for \*(L"show\*(R",
\&\*(L"depends\*(R", \*(L"rdepends\*(R", \*(L"search\*(R", \*(L"pkgnames\*(R", \*(L"changelog\*(R" actions
.SS "Management actions"
.IX Subsection "Management actions"
.IP "update" 4
.IX Item "update"
updates package indexes
.Sp
This subcommand receives no arguments.
.Sp
Example:
.Sp
\&\f(CW\*(C`cupt update\*(C'\fR
.IP "install" 4
.IX Item "install"
installs, upgrades or downgrades specified packages
.Sp
This subcommand receives list of \*(L"Binary package version expression\*(R"'s, see below.
.Sp
If some version of package was already installed, this command will
upgrade/downgrade it; otherwise, the package will be freshly installed.
.Sp
Examples:
.Sp
\&\f(CW\*(C`cupt install nlkt\*(C'\fR
.Sp
\&\f(CW\*(C`cupt install devscripts xserver\-xorg/experimental xfce4\-mixer=4.6.0\-2\*(C'\fR
.IP "remove" 4
.IX Item "remove"
removes specified packages
.Sp
This subcommand receives the list of package names.
.Sp
Examples:
.Sp
\&\f(CW\*(C`cupt remove nlkt\*(C'\fR
.Sp
\&\f(CW\*(C`cupt remove devscripts kde4\-minimal\*(C'\fR
.IP "purge" 4
.IX Item "purge"
removes specified packages along with their configuration files.  Also this
command can purge the configuration files when the packages are removed
already.
.Sp
This subcommand receives the list of package names.
.Sp
Examples:
.Sp
\&\f(CW\*(C`cupt purge nlkt\*(C'\fR
.Sp
\&\f(CW\*(C`cupt purge devscripts kde4\-minimal\*(C'\fR
.Sp
See also the configuration option cupt::worker::purge.
.IP "full-upgrade" 4
.IX Item "full-upgrade"
performs as more upgrades of the installed packages as possible, the
recommended way to do upgrades
.Sp
This subcommand is usually invoked without any further parameters:
.Sp
\&\f(CW\*(C`cupt full\-upgrade\*(C'\fR
.Sp
List of \*(L"Binary package version expression\*(R"'s can be however specified as additional parameters.
.Sp
Example: the command \f(CW\*(C`cupt full\-upgrade xserver\-xorg/installed\*(C'\fR will try to upgrade
your system, however preserving package 'xserver\-xorg' to be sticked with
currently installed version.
.IP "safe-upgrade" 4
.IX Item "safe-upgrade"
the same as \*(L"full-upgrade\*(R", but with the change that problem resolver won't
try to remove non-automatically installed packages in order to upgrade more
packages, equivalent of 'full\-upgrade \-\-no\-remove'.
.IP "dist-upgrade" 4
.IX Item "dist-upgrade"
the same as \*(L"full-upgrade\*(R", but firstly upgrades the package management tools,
then upgrades the whole system.
.Sp
Recommended over \*(L"full-upgrade\*(R" for major upgrades.
.Sp
This subcommand cannot be run under the Cupt shell.
.IP "reinstall" 4
.IX Item "reinstall"
reinstalls specified binary packages
.Sp
This subcommand receives list of binary package names.
.Sp
Examples:
.Sp
\&\f(CW\*(C`cupt reinstall libc6\*(C'\fR
.IP "iii" 4
.IX Item "iii"
"\*(L"install\*(R" if installed"
.Sp
Same as \*(L"install\*(R", but silently ignores packages which are not installed.
.Sp
Examples:
.Sp
\&\f(CW\*(C`cupt iii gnash\*(C'\fR
.Sp
\&\f(CW\*(C`cupt iii xserver* *cupt*\*(C'\fR
.IP "markauto" 4
.IX Item "markauto"
marks specified packages as automatically installed
.Sp
This subcommand receives the list of package names.
.Sp
Examples:
.Sp
\&\f(CW\*(C`cupt markauto libstreamanalyzer0\*(C'\fR
.Sp
\&\f(CW\*(C`cupt markauto lsof gimp\-data\*(C'\fR
.IP "unmarkauto" 4
.IX Item "unmarkauto"
marks specified packages as manually installed
.Sp
This subcommand receives the list of package names.
.Sp
Examples:
.Sp
\&\f(CW\*(C`cupt unmarkauto kpogre\*(C'\fR
.Sp
\&\f(CW\*(C`cupt unmarkauto dpkg\-dev\*(C'\fR
.IP "satisfy" 4
.IX Item "satisfy"
performs all needed operations to satisfy list of specified relations
.Sp
This subcommand receives the list of relations or relation lines. Relation and
relation lines has the same syntax as defined in Debian Policy §7.1.
.Sp
The minus sign can be appended to some of relation expression lines to make
relation expressions unsatisfied instead.
.Sp
Examples:
.Sp
\&\f(CW\*(C`cupt satisfy "kmail (>= 4:4.2), wget (>= 1.10.0)"\*(C'\fR
.Sp
\&\f(CW\*(C`cupt satisfy "gettext (= 0.17\-7)" "mail\-transport\-agent\-"\*(C'\fR
.IP "build-dep" 4
.IX Item "build-dep"
performs all needed operations to satisfy list of build-dependencies of
specified source packages
.Sp
This subcommand receives the list of \*(L"Source package version expression\*(R"'s.
.Sp
Examples:
.Sp
\&\f(CW\*(C`cupt build\-dep qt4\-x11\*(C'\fR
.Sp
\&\f(CW\*(C`cupt build\-dep unetbootin/unstable libcdio/experimental\*(C'\fR
.IP "source" 4
.IX Item "source"
fetches Debian source files needed to build a Debian binary package
.Sp
This subcommand receives the list of \*(L"Source package version expression\*(R"'s.
.Sp
Parameters:
.RS 4
.IP "\-\-tar\-only" 4
.IX Item "--tar-only"
download only original tarball
.IP "\-\-diff\-only" 4
.IX Item "--diff-only"
download only Debian diff
.IP "\-\-dsc\-only" 4
.IX Item "--dsc-only"
download only Debian dsc
.IP "\-\-download\-only" 4
.IX Item "--download-only"
don't unpack downloaded source files
.RE
.RS 4
.Sp
Examples:
.Sp
\&\f(CW\*(C`cupt source libsort\-fields\-perl\*(C'\fR
.Sp
\&\f(CW\*(C`cupt source \-\-diff\-only libpqxx cupt/unstable\*(C'\fR
.Sp
\&\f(CW\*(C`cupt source libxine1\*(C'\fR
.RE
.IP "clean" 4
.IX Item "clean"
removes all deb archives and partially downloaded archive files from the cache on a disk
.Sp
This subcommand receives no arguments.
.Sp
Example: \f(CW\*(C`cupt clean\*(C'\fR
.IP "autoclean" 4
.IX Item "autoclean"
removes deb archives which are not available in package indexes and partially
downloaded archive files from the cache on a disk
.Sp
This subcommand receives no arguments.
.Sp
Example: \f(CW\*(C`cupt autoclean\*(C'\fR
.IP "snapshot save" 4
.IX Item "snapshot save"
saves a snapshot of the current packages state
.Sp
This subcommand receives one argument \- desired snapshot name.
.Sp
Example: \f(CW\*(C`cupt snapshot save old\-udev\*(C'\fR
.IP "snapshot load" 4
.IX Item "snapshot load"
returns the system (as set of installed packages) to the previously saved
state
.Sp
This subcommand receives one argument \- snapshot name to load.
.Sp
Example: \f(CW\*(C`cupt snapshot load old\-udev\*(C'\fR
.IP "snapshot remove" 4
.IX Item "snapshot remove"
removes the system snapshot
.Sp
This subcommand receives one argument \- snapshot name to remove.
.Sp
Example: \f(CW\*(C`cupt snapshot remove old\-libgtk\*(C'\fR
.IP "snapshot rename" 4
.IX Item "snapshot rename"
renames the system snapshot
.Sp
This subcommand receives two arguments \- old snapshot name and new snapshot
name.
.Sp
Example: \f(CW\*(C`cupt snapshot rename old\-libgtk 20091005\*(C'\fR
.IP "shell" 4
.IX Item "shell"
starts interactive shell-like environment
.Sp
This subcommand receives no arguments.
.Sp
This subcommand can receive all common options which will be preserved
across all session. You can override them for any subcommand in a usual way.
.Sp
On every shell prompt you can supply any valid subcommand from this manual
page, using all allowed parameters, just if it was command line. Simple shell
quotes around arguments are also allowed.
.Sp
You can use 'quit', 'exit', ':q' or 'q' command to exit cupt shell.
.PP
\fImanagement-specific options\fR
.IX Subsection "management-specific options"
.IP "\-\-no\-remove" 4
.IX Item "--no-remove"
disallow problem resolver to remove manually installed packages. Packages that are marked to remove/purge in the command line will be remove/purged as usual.
.Sp
Corresponding configuration option: cupt::resolver::no\-remove
.IP "\-\-no\-auto\-remove" 4
.IX Item "--no-auto-remove"
don't try to remove automatically installed packages after doing requested
actions
.Sp
Corresponding configuration option: cupt::resolver::auto\-remove
.IP "\-\-simulate,\-s" 4
.IX Item "--simulate,-s"
don't modify anything in the system, just print supposed actions
.Sp
Doesn't require root privileges.
.Sp
Corresponding configuration option: cupt::worker::simulate
.IP "\-\-summary\-only" 4
.IX Item "--summary-only"
Show only summary of actions without details.
.Sp
Corresponding configuration options: cupt::console::actions\-preview::show\-summary,
cupt::console::actions\-preview::show\-details.
.IP "\-\-no\-summary" 4
.IX Item "--no-summary"
Show only details of actions without a summary.
.Sp
Corresponding configuration options: cupt::console::actions\-preview::show\-summary,
cupt::console::actions\-preview::show\-details.
.IP "\-\-resolver=" 4
.IX Item "--resolver="
string, determines type of resolver: can be
.RS 4
.IP "fair" 4
.IX Item "fair"
medium-class resolver. It chooses best possible solution (by overall score)
each time. This is a default resolver.
.IP "full" 4
.IX Item "full"
full resolver. Guaranteed to suggest solution in precise order from the best to
the worst result score (by the resolver's opinion). Latter means that resolver
builds full resolve tree before suggesting the solutions, which means large \s-1RAM\s0
and speed penalties. Use it with caution.
.RE
.RS 4
.Sp
Corresponding configuration option: cupt::resolver::type
.RE
.IP "\-\-max\-solution\-count=" 4
.IX Item "--max-solution-count="
number, determines how many maximum solutions will resolver store in memory. This
option prevents large memory grows by purging away solutions with worst scores.
Defaults to 32000.  Note that very complex requests or requests on
multi-repository system will increase size of solution tree dramatically, so
prepare to play with increasing this option accordingly.
.Sp
Corresponding configuration option: cupt::resolver::max\-solution\-count
.IP "\-\-no\-install\-recommends,\-R" 4
.IX Item "--no-install-recommends,-R"
cupt installs recommended packages by default, this option cancels described behavior
.Sp
Corresponding configuration option: apt::install\-recommends
.IP "\-\-show\-archives,\-A" 4
.IX Item "--show-archives,-A"
when displaying actions preview prompt, display also release archives for each package
.Sp
Corresponding configuration option: cupt::console::actions\-preview::show\-archives
.IP "\-\-show\-codenames,\-N" 4
.IX Item "--show-codenames,-N"
when displaying actions preview prompt, display also release codenames for each package
.Sp
This option cannot be used together with \-\-show\-archives.
.Sp
Corresponding configuration option: cupt::console::actions\-preview::show\-codenames
.IP "\-\-show\-components,\-C" 4
.IX Item "--show-components,-C"
when displaying actions preview prompt, display also release components for each package
.Sp
Corresponding configuration option: cupt::console::actions\-preview::show\-components
.IP "\-\-show\-versions,\-V" 4
.IX Item "--show-versions,-V"
when displaying actions preview prompt, display also versions of packages
.Sp
Corresponding configuration option: cupt::console::actions\-preview::show\-versions
.IP "\-\-show\-vendors,\-O" 4
.IX Item "--show-vendors,-O"
when displaying actions preview prompt, display also vendors of packages
.Sp
Corresponding configuration option: cupt::console::actions\-preview::show\-vendors
.IP "\-\-show\-size\-changes,\-Z" 4
.IX Item "--show-size-changes,-Z"
when displaying actions preview prompt, display also changes in disk space
usage for each package
.Sp
Corresponding configuration option: cupt::console::actions\-preview::show\-size\-changes
.IP "\-\-show\-reasons,\-\-show\-deps,\-D" 4
.IX Item "--show-reasons,--show-deps,-D"
when displaying actions preview prompt, display also reasons why this action was
considered to perform
.Sp
Corresponding configuration option: cupt::console::actions\-preview::show\-reasons
.IP "\-\-show\-not\-preferred" 4
.IX Item "--show-not-preferred"
when displaying actions preview prompt, display also packages which will have a
not preferred version after the proposed changes
.Sp
Corresponding configuration option: cupt::console::actions\-preview::show\-not\-preferred
.IP "\-\-download\-only,\-d" 4
.IX Item "--download-only,-d"
stop after download stage, don't modify the system
.Sp
Corresponding configuration option: cupt::worker::download\-only
.IP "\-\-assume\-yes,\-\-yes,\-y" 4
.IX Item "--assume-yes,--yes,-y"
don't ask for solution confirmation, assume the answer is 'y' (\*(L"yes\*(R"), except
for dangerous actions, where assume 'q' (\*(L"decline and exit\*(R")
.Sp
Corresponding configuration options: apt::get::assume\-yes, cupt::console::assume\-yes
.PP
\fImanagement modifiers: action override options\fR
.IX Subsection "management modifiers: action override options"
.PP
Unlike all the other options, these ones are positional and are effective only
for the rest of parameters (and before next override option if any). One can
specify as many action override options as needed.
.IP "\-\-install" 4
.IX Item "--install"
install the rest of packages
.IP "\-\-remove" 4
.IX Item "--remove"
remove rest of packages
.IP "\-\-purge" 4
.IX Item "--purge"
purge the rest of packages
.IP "\-\-satisfy" 4
.IX Item "--satisfy"
satisfy the rest of relation expressions
.IP "\-\-unsatisfy" 4
.IX Item "--unsatisfy"
unsatisfy the rest of relation expressions
.IP "\-\-iii" 4
.IX Item "--iii"
\&\*(L"install if installed\*(R" (see \*(L"iii\*(R" subcommand) the rest of packages
.IP "\-\-reinstall" 4
.IX Item "--reinstall"
reinstall the rest of packages
.IP "\-\-markauto" 4
.IX Item "--markauto"
mark as automatically installed (see \*(L"markauto\*(R" subcommand) the rest of packages
.IP "\-\-unmarkauto" 4
.IX Item "--unmarkauto"
mark as manually installed (see \*(L"unmarkauto\*(R") subcommand the rest of packages
.IP "\-\-asauto=yes" 4
.IX Item "--asauto=yes"
in addition to following actions, also mark packages as automatically installed
.IP "\-\-asauto=no" 4
.IX Item "--asauto=no"
in addition to following actions, also mark packages as manually installed
.IP "\-\-asauto=default" 4
.IX Item "--asauto=default"
reset any previous \f(CW\*(C`\-\-asauto\*(C'\fR switches (to default mode, which is: mark newly
installed packages (except for satisfy-type actions) as manually installed and
preserve auto-status otherwise)
.PP
\fImanagement modifiers: request type options\fR
.IX Subsection "management modifiers: request type options"
.IP "\-\-select=traditional,\-\-st" 4
.IX Item "--select=traditional,--st"
for install-type actions, request installing the best of chosen versions for
each package; for remove-type actions, request removing the whole package. This
is the default.
.IP "\-\-select=flexible,\-\-sf" 4
.IX Item "--select=flexible,--sf"
for install-type actions, request installing any of chosen versions for each
package; for remove-type actions, request removing only chosen versions for
each package.
.PP
\fImanagement modifiers: request importance options\fR
.IX Subsection "management modifiers: request importance options"
.IP "\-\-importance=must,\-\-must" 4
.IX Item "--importance=must,--must"
the following actions must be unconditionally performed, in other words,
mandatory. This is the default.
.IP "\-\-importance=try,\-\-try" 4
.IX Item "--importance=try,--try"
the following actions are optional, but relatively big
(cupt::resolver::score::unsatisfied\-try) penalty will be applied for each
non-satisfied request
.IP "\-\-importance=wish,\-\-wish" 4
.IX Item "--importance=wish,--wish"
the following actions are optional, but relatively small
(cupt::resolver::score::unsatisfied\-wish) penalty will be applied for each
non-satisfied request
.IP "\-\-importance=<value>" 4
.IX Item "--importance=<value>"
(where <value> is a positive integer) the following actions are optional, but
exact penalty of <value> will be applied for each non-satisfied request
.PP
\fImanagement modifiers: package name suffixes\fR
.IX Subsection "management modifiers: package name suffixes"
.IP "\-" 4
remove the package, can be used in non-remove actions
.Sp
Examples:
.Sp
\&\f(CW\*(C`cupt install kde4 icewm\-\*(C'\fR \- install the package
\&'kde4' and remove the package 'icewm' simultaneously.
.Sp
\&\f(CW\*(C`cupt full\-upgrade iceweasel\- icedove\-\*(C'\fR \- upgrade the system, deleting iceweasel and icedove
.IP "+" 4
install the package, can be used in remove actions
.Sp
Examples:
.Sp
\&\f(CW\*(C`cupt remove kde konqueror+\*(C'\fR \- remove kde, but install/upgrade konqueror
.Sp
\&\f(CW\*(C`cupt remove kde konqueror/installed+\*(C'\fR \- remove kde, but leave konqueror
.SH "EXPRESSIONS"
.IX Header "EXPRESSIONS"
This section documents some common expressions used by actions.
.SS "Binary package version expression"
.IX Subsection "Binary package version expression"
\&\fIpackage_name\fR[\fImodifier\fR]
.PP
selects one version of given binary package.
.PP
Possible modifiers:
.IP "<none>" 4
.IX Item "<none>"
selects policy version of the package
.Sp
Example: \f(CW\*(C`audacious\*(C'\fR.
.IP "=<version string>" 4
.IX Item "=<version string>"
selects specified version of the package
.Sp
Example: \f(CW\*(C`audacious=1.5.1\-2\*(C'\fR
.IP "/<distribution>" 4
.IX Item "/<distribution>"
selects a version from specified distribution (archive name or codename)
.Sp
Examples: \f(CW\*(C`audacious/lenny\*(C'\fR (by codename), \f(CW\*(C`audacious/stable\*(C'\fR (by archive name)
.IP "/installed" 4
.IX Item "/installed"
selects installed version of the package
.Sp
Example: \f(CW\*(C`audacious/installed\*(C'\fR
.PP
Also, you may specify shell wildcars '*' and '?' in the package names.
.PP
Examples: \f(CW\*(C`xfce4\-*\*(C'\fR, \f(CW\*(C`python2.5\-*/unstable\*(C'\fR, \f(CW\*(C`?aff*/installed\*(C'\fR
.PP
For all management subcommands, there is also '@<path\-to\-file>' syntax. In this
case this construction will be substituted by binary package expressions listed
in the specified file one by line.
.SS "Source package version expression"
.IX Subsection "Source package version expression"
\&\fIpackage_name\fR[\fImodifier\fR]
.PP
selects one version of given source package.
.PP
Possible modifiers are identical to those defined in \*(L"Binary package version
expression\*(R", except for '/installed'.
.PP
Also, you can specify \*(L"Binary package version expression\*(R" as
\&\*(L"Source package version expression\*(R", then binary-to-source mapping
will be performed.
.SS "Functional selectors"
.IX Subsection "Functional selectors"
You can also use functional selectors (\fBcupt_functionalselectors\fR\|(7))
whereever \*(L"Binary package version expression\*(R" or \*(L"Source package version
expression\*(R" is expected.
.SH "COMMON OPTIONS"
.IX Header "COMMON OPTIONS"
.IP "\-\-option=,\-o" 4
.IX Item "--option=,-o"
sets specified configuration option, syntax: \*(L"<name>=<value>\*(R"
.Sp
Examples:
.Sp
\&\f(CW\*(C`cupt remove nlkt \-o \*(Aqcupt::resolver::keep\-recommends=0\*(Aq\*(C'\fR (regular option)
.Sp
\&\f(CW\*(C`cupt remove nlkt \-o \*(Aqapt::neverautoremove::=libcanberra0\*(C'\fR (list option)
.IP "\-\-target\-release=,\-\-default\-release=,\-t" 4
.IX Item "--target-release=,--default-release=,-t"
sets preferred release to pick up packages from, you can specify codename or archive name
.Sp
Corresponding configuration option: apt::default\-release
.Sp
Examples: \f(CW\*(C`cupt install \-t unstable xserver\-xorg\*(C'\fR, \f(CW\*(C`cupt \-t squeeze full\-upgrade\*(C'\fR
.IP "\-\-include\-archives=" 4
.IX Item "--include-archives="
Use only repositories with specified archive names (comma-separated).
.Sp
Corresponding configuration options:
cupt::cache::limit\-releases::by\-archive,
cupt::cache::limit\-releases::by\-archive::type.
.Sp
Example:
.Sp
\&\f(CW\*(C`cupt safe\-upgrade \-\-include\-archives=stable,stable\-updates\*(C'\fR
.IP "\-\-exclude\-archives=" 4
.IX Item "--exclude-archives="
Ignore repositories with specified archive names (comma-separated).
.Sp
Corresponding configuration options:
cupt::cache::limit\-releases::by\-archive,
cupt::cache::limit\-releases::by\-archive::type.
.Sp
Example:
.Sp
\&\f(CW\*(C`cupt rdepends libcomerr2 \-\-exclude\-archives=experimental,unstable\*(C'\fR
.IP "\-\-include\-codenames=" 4
.IX Item "--include-codenames="
Use only repositories with specified codenames (comma-separated).
.Sp
Corresponding configuration options:
cupt::cache::limit\-releases::by\-codename,
cupt::cache::limit\-releases::by\-codename::type.
.Sp
Example:
.Sp
\&\f(CW\*(C`cupt safe\-upgrade \-\-include\-codenames=squeeze,squeeze\-updates\*(C'\fR
.IP "\-\-exclude\-codenames=" 4
.IX Item "--exclude-codenames="
Ignore repositories with specified codenames (comma-separated).
.Sp
Corresponding configuration options:
cupt::cache::limit\-releases::by\-codename,
cupt::cache::limit\-releases::by\-codename::type.
.Sp
Example:
.Sp
\&\f(CW\*(C`cupt rdepends libcomerr2 \-\-exclude\-codenames=experimental,sid\*(C'\fR
.IP "\-\-quiet,\-q" 4
.IX Item "--quiet,-q"
don't output anything to standard output
.SH "CONFIGURATION VARIABLES"
.IX Header "CONFIGURATION VARIABLES"
See \fBcupt.conf\fR\|(5).
.SH "REPORTING"
.IX Header "REPORTING"
Please report all bugs in Cupt to Debian \s-1BTS\s0 using \fBreportbug\fR\|(1).
.PP
The user support mailing list is cupt\-user@lists.alioth.debian.org. The
discussion channel about Cupt is irc://irc.debian.org#cupt.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBcupt_vs_apt\fR\|(5), \fBcupt_tutorial\fR\|(7), \fBcupt.conf\fR\|(5), \fBcupt_functionalselectors\fR\|(7)
.SH "AUTHOR"
.IX Header "AUTHOR"
Eugene V. Lyubimkin <jackyf@debian.org>