Provided by: cupt_0.2.3_all bug

NAME

       cupt - console package management tool

SYNOPSIS

       cupt [ option... ] action [ { parameter | option } ... ]

ACTIONS

   Query actions
       config-dump
           If invoked without arguments, prints all configuration variables to
           standard output.

           If one argument is supplied, it is treaten as a configuration
           option and only the value of this option is printed (empty string
           in case of undefined value).  Note that only scalar (non-list)
           options can be retrieved in this mode.

           Examples:

           "cupt config-dump"

           "cupt config-dump acquire::http::timeout"

       show
           prints version info of specified packages

           This subcommand receives list of "Binary package version
           expression"’s, see below.

           Specific options:

           --all-versions,-a
               print all versions of the package, not selected one

               Corresponding configuration variable: apt::cache::allversions

           --no-all-versions
               don’t print all versions of the package, use only selected one

               Corresponding configuration variable: apt::cache::allversions

           --with-release-info
               also print information about release info where the version of
               the package live

           Examples:

           "cupt show qmmp"

           "cupt show --all-versions qmmp debianutils"

           "cupt show --with-release-info audacious/testing apt
           debianutils=2.3.38"

       search
           searches for packages that contains some string within package
           names and package descriptions

           This subcommand receives a list a Perl-compatible Regular
           Expressions (PCRE) to search. Only those packages will be printed
           that contain all of specified patterns.

           Specific options:

           --case-sensitive
               search case-sensitively

           --names-only,-n
               search only in package names

               Corresponding configuration variable: apt::cache::namesonly

           Examples:

           "cupt search nvidia driver"

           "cupt search --case-sensitive Vim"

           "cupt search -n vim"

           "cupt search "package manager""

       depends
           prints dependency relation expressions for given version of package

           By default prints ’Pre-Depends’, ’Depends’ and ’Recommends’ for the
           version.

           This subcommand receives list of "Binary package version
           expression"’s, see below.

           Specific options:

           --with-suggests
               take also ’Suggests’ dependencies into account

           --recurse
               process the dependencies recursively

               Corresponding configuration variable:
               apt::cache::recursedepends

           Examples:

           "cupt depends nlkt perl/stable"

           "cupt depends --important xserver-xorg-core"

           "cupt depends --recurse xmlto"

       rdepends
           same as depends, but prints reverse relations instead of forward
           ones

       policy
           prints available versions with pins and release info for each
           package name

           This subcommand receives the list of package names.

           Examples:

           "cupt policy dpkg"

           "cupt policy libpqxx-2.6.9ldbl libpqxx-3.0"

       pkgnames
           prints package names that start with a supplied suffix

           If no suffix is given, prints all package names

           Examples:

           "cupt pkgnames"

           "cupt pkgnames liba"

       changelog
           displays changelog for given versions of packages

           This subcommand receives list of "Binary package version
           expression"’s, see below.

           Works only with installed packages and official Debian and Ubuntu
           repositories.

           Examples:

           "cupt changelog dpkg/installed"

           "cupt changelog --installed-only dpkg nlkt lintian"

           "cupt changelog libqtcore4"

       copyright
           displays copyright for given versions of packages

           This subcommand receives list of "Binary package version
           expression"’s, see below.

           Works only with installed packages and official Debian and Ubuntu
           repositories.

           Examples:

           "cupt copyright dpkg/installed"

           "cupt copyright --installed-only dpkg nlkt lintian"

           "cupt copyright libqtcore4"

       screenshots
           open a browser window/tab with screenshots of given packages.

           This subcommand receives list of package names.

           Example:

           "cupt screenshots arora"

       query-specific options

       --important,-i
           don’t take ’Recommends’ dependencies into account

           Corresponding configuration variable: apt::cache::important

       --installed-only
           work only with installed versions of packages; valuable only for
           "show", "depends", "rdepends", "search", "pkgnames", "changelog"
           actions

   Management actions
       update
           updates package indexes

           This subcommand receives no arguments.

           Example:

           "cupt update"

       install
           installs, upgrades or downgrades specified packages

           This subcommand receives list of "Binary package version
           expression"’s, see below.

           If some version of package was already installed, this command will
           upgrade/downgrade it; otherwise, the package will be freshly
           installed.

           Examples:

           "cupt install nlkt"

           "cupt install devscripts xserver-xorg/experimental
           xfce4-mixer=4.6.0-2"

       remove
           removes specified packages

           This subcommand receives the list of package names.

           Examples:

           "cupt remove nlkt"

           "cupt remove devscripts kde4-minimal"

       full-upgrade
           performs as more upgrades of the installed packages as possible,
           the recommended way to do upgrades

           This subcommand is usually invoked without any further parameters:

           "cupt full-upgrade"

           List of "Binary package version expression"’s can be however
           specified as additional parameters.

           Example: the command "cupt full-upgrade xserver-xorg/installed"
           will try to upgrade your system, however preserving package
           ’xserver-xorg’ to be sticked with currently installed version.

       safe-upgrade
           the same as full-upgrade, 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’.

       markauto
           marks specified packages as automatically installed

           This subcommand receives the list of package names.

           Examples:

           "cupt markauto libstreamanalyzer0"

           "cupt markauto lsof gimp-data"

       unmarkauto
           marks specified packages as manually installed

           This subcommand receives the list of package names.

           Examples:

           "cupt unmarkauto kpogre"

           "cupt unmarkauto dpkg-dev"

       satisfy
           performs all needed operations to satisfy list of specified
           relations

           This subcommand receives the list of relations or relation lines.
           Relation and relation lines has the same syntax as defined in
           Debian Policy AX7.1.

           Examples:

           "cupt satisfy "kmail (>= 4:4.2)""

           "cupt satisfy "xserver-xorg (>> 1.6)" "xserver-common (<< 1.6.1~)""

           "cupt satisfy "nautilus (>= 2.16.0), libnautilus-extension1 (>=
           2.16.0), wget (>= 1.10.0)""

       clean
           removes all deb archives from cache on disk

           This subcommand receives no arguments.

           Example: "cupt clean"

       autoclean
           removes deb archives which are not available in package indexes
           from cache on disk

           This subcommand receives no arguments.

           Example: "cupt autoclean"

       query-specific options

       --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.

           Corresponding configuration option: cupt::resolver::no-remove

       --no-auto-remove
           don’t try to remove automatically installed packages after doing
           requested actions

           Corresponding configuration option: cupt::resolver::auto-remove

       --simulate,-s
           don’t modify anything in the system, just print supposed actions

           Doesn’t require root privileges.

           Corresponding configuration option: cupt::worker::simulate

       --resolver=
           string, determines type of resolver: can be

           fair
               medium-class resolver. It chooses best possible solution (by
               overall score) each time. This is a default resolver.

           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 RAM and
               speed penalties. Use it with caution.

           Corresponding configuration option: cupt::resolver::type

       --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 256.  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.

           Corresponding configuration option:
           cupt::resolver::max-solution-count

       --no-install-recommends,-R
           cupt installs recommended packages by default, this option cancels
           described behavior

           Corresponding configuration option: apt::install-recommends

       --show-versions,-V
           when displaying actions preview prompt, display also versions of
           packages

       --show-size-changes,-Z
           when displaying actions preview prompt, display also changes in
           disk space usage for each package

       --show-reasons,--show-deps,-D
           when displaying actions preview prompt, display also reasons why
           this action was considered to perform

           Corresponding configuration option: cupt::resolver::track-reasons

       --no-install-unpacked
           By default cupt will implicitly install all already unpacked
           packages, this is needed, for example, for proper continue of
           interrupted upgrades. This option cancels behavior described.

       --download-only,-d
           stop after download stage, don’t modify the system; not applicable
           for "markauto" and "markauto" actions

           Corresponding configuration option: cupt::worker::download-only

       management modifiers

       -   remove the package, can be used in non-remove actions

           Examples:

           "cupt install kde4 icewm-" - install the package ’kde4’ and remove
           the package ’icewm’ simultaneously.

           "cupt full-upgrade iceweasel- icedove-" - upgrade the system,
           deleting iceweasel and icedove

       +   install the package, can be used in remove actions

           Examples:

           "cupt remove kde konqueror+" - remove kde, but install/upgrade
           konqueror

           "cupt remove kde konqueror/installed+" - remove kde, but leave
           konqueror

EXPRESSIONS

       This section documents some common expressions used by actions.

   Binary package version expression
       package_name[modifier]

       selects one version of given binary package.

       Possible modifiers:

       <none>
           selects policy version of the package

           Example: "audacious".

       =<version string>
           selects specified version of the package

           Example: "audacious=1.5.1-2"

       /<distribution>
           selects a version from specified distribution (archive name or
           codename)

           Examples: "audacious/lenny" (by codename), "audacious/stable" (by
           archive name)

       /installed
           selects installed version of the package

           Example: "audacious/installed"

COMMON OPTIONS

       --option=,-o
           sets specified configuration option, syntax: "<name>=<value>"

           Examples:

           "cupt remove nlkt -o 'cupt::resolver::keep-recommends=0'" (regular
           option)

           "cupt remove nlkt -o 'apt::neverautoremove::=libcanberra0" (list
           option)

       --target-release=,--default-release=,-t
           sets preferred release to pick up packages from, you can specify
           codename or archive name

           Corresponding configuration option: apt::default-release

           Examples: "cupt install -t unstable xserver-xorg", "cupt -t squeeze
           full-upgrade"

       --purge
           when removing packages, also delete their configuration files

           Corresponding configuration option: cupt::worker::purge

       --quiet,-q
           don’t output anything to standard output

CONFIGURATION VARIABLES

       Firstly, Cupt uses following APT configuration variables:

       acquire::*::timeout, acquire::*::proxy, apt::cache::allversions,
       apt::cache::important, apt::cache::namesonly,
       apt::cache::recursedepends, apt::default-release,
       apt::install-recommends, apt::install-suggests, apt::neverautoremove,
       apt::get::allowunauthenticated, dir, dir::bin::dpkg, dir::cache,
       dir::cache::archives, dir::etc, dir::etc::sourcelist,
       dir::etc::sourceparts, dir::etc::parts, dir::etc::main,
       dir::etc::preferences, dir::state, dir::state::extendedstates,
       dir::state::lists, dir::state::status, dpkg::options, dpkg::pre-invoke,
       dpkg::post-invoke, dpkg::pre-install-pkgs, gpgv::trustedkeyring, quiet

       See apt.conf(5) for their meanings.

       Secondly, Cupt recognizes (but doesn’t use) following configuration
       variables:

       apt::cache-limit, rpm::pre-invoke, rpm::post-invoke

       Thirdly, Cupt introduces following cupt-specific configuration
       variables:

       acquire::http::allow-redirects
           boolean (0/1), specifies whether should downloader follow HTTP
           redirects.  True by default.

       cupt::downloader::max-simultaneous-downloads
           positive number, specifies maximum number of simultaneous downloads

       cupt::update::keep-bad-signatures
           boolean (0/1), specifies whether to keep signature files that
           failed GPG check when doing update. False by default. Setting this
           option to true will break compatibility with APT in area of
           signature checking.

       cupt::resolver::keep-recommends
           boolean (0/1), specifies whether should resolver try to keep
           already installed recommended packages or not. True by default.

       cupt::resolver::keep-suggests
           boolean (0/1), specifies whether should resolver try to keep
           already installed suggested packages or not. False by default.

       cupt::resolver::auto-remove
           see --no-auto-remove/

       cupt::resolver::max-solution-count
           see --max-solution-count

       cupt::resolver::external-command
           a preview-only, experimental option to use external resolver using
           CUDF protocol Don’t use it unless you know what you are doing.

           Example: "cupt -s safe-upgrade -o
           "cupt::resolver::external-command=cat > cudfout.txt""

       cupt::resolver::no-remove
           see --no-remove

       cupt::resolver::track-reasons
           see --show-reasons

       cupt::resolver::type
           see --resolver

       cupt::worker::defer-triggers
           boolean (0/1), specifies whether should worker defer dpkg trigger
           processing to the end of the whole operation or not. Being set to
           true, speeds up large-amount actions, but if the operation will
           somewhy interrupted, leaves system in the interim trigger state,
           which can be fixed by manual run of ’dpkg --triggers-only
           --pending’ command. True by default.

       cupt::worker::download-only
           see --download-only

       cupt::worker::purge
           boolean (0/1), specifies whether purge packages in addition to
           removing or not.  False by default.

       cupt::worker::simulate
           see --simulate

       debug::resolver
           boolean (0/1), if true, resolver will print a lot of debug
           information to the standard error

       debug::worker
           boolean (0/1), if true, worker will print some debug information to
           the standard error

       debug::gpgv
           boolean (0/1), if true, cache will print some debug information
           while verifying signatures to the standard error

       debug::downloader
           boolean (0/1), if true, the downloader manager will print some
           debug messages

DEFINITIONS

       TODO

REPORTING

       Please report all bugs in Cupt to Debian BTS using reportbug(1).

       The discussion channel about Cupt is irc://irc.debian.org#cupt.

SEE ALSO

       cupt_vs_apt(5), cupt_howto(7)

AUTHOR

       Eugene V. Lyubimkin <jackyf.devel@gmail.com>