PREFACE

When using commands that modify a system, you have to either execute cupt with root priviledes or supply '--simulate' (or '-s') option.

BASIC USAGE

How do I:

upgrade the whole system?

cupt full-upgrade

upgrade the system without removing packages?

cupt safe-upgrade

install a package?

cupt install <package name>

install several packages at once?

cupt install <package name 1> <package name 2> .. <package name N>

remove a package?

cupt remove <package name>

remove several packages at once?

cupt remove <package name 1> <package name 2> .. <package name N>

remove a package along with its configuration files?

cupt purge <package name>

update repository metadata?

cupt update

print info about package?

cupt show <package name>

print only dependencies for a package?

cupt depends <package name>

print reverse dependencies for a package?

cupt rdepends <package name>

search for a package?

cupt search <keyword 1> <keyword2> .. <keyword N>

REPORTING PROBLEMS

with package dependency resolver

add '-o debug::resolver=1'

with scheduling dpkg actions

add '-o debug::worker=1'

with downloader

add '-o debug::downloader=1'

with gpg signatures

add '-o debug::gpgv=1'

ADVANCED USAGE

How do I:

print info about available releases?

cupt policy

print info about pins and available versions for a package?

cupt policy <package name>

print info about many packages?

cupt show <package name 1> <package name 2> .. <package name N>

print all configuration variables?

cupt config-dump

print a particular configuration variable?

cupt config-dump <variable>

see Debian changelog for a package?

cupt changelog <package name>

see copyright info for a package?

cupt copyright <package name>

specify a particular version for a package?

<package name>=<version string> (example: cupt install proxychains=3.1-2)

specify a particular acrhive/codename for a package?

<package name>/<archive> (example: cupt install libc6/experimental)

<package name>/<codename> (example: cupt install proxychains/lenny)

see versions of packages for install/remove/upgrade/etc. ?

use '--show-versions' option

see why cupt decided to do that particular action?

use '--show-reasons' option

install and remove packages simultaneously?

Examples:

cupt install <package name to install> <package name to remove>-

cupt remove <package name to remove> <package name to install>+

satisfy particular dependency relation expressions?

cupt satisfy

mark the package as automatically installed?

cupt markauto <package name>

mark the package as manually installed?

cupt unmarkauto <package name>