---
name: "cupt_howto"
section: "7"
platform: "linux"
package: "cupt"
version: "1.5.14.1"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/cupt_howto"
---

# cupt\_howto(7)

how to use cupt(1) package manager

## NAME

cupt\_howto - how to use [*cupt*(1)](/cupt/1.md) package manager

## 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\>

## SEE ALSO

[*cupt*(1)](/cupt/1.md)