PKG_MGR(1)

NAME
pkg_mgr - screen-oriented interactive package manager

DESCRIPTION
The pkg_mgr utility allows interactive browsing of the packages(7) database. It uses the Curses::UI(3p) package as its frontend and the databases/sqlports package as its backend.

It allows the user to:

-   browse installed and available packages by categories
-   see details on a selected package
-   search for a particular package by its name or associated comment
-   tag packages for changes (install/remove/update)
-   simulate package changes
-   actually perform package changes if the user has root credentials

pkg_mgr proposes various screens to the user:

  Categories list
This screen shows the list of available categories of packages, plus three extra categories:

All Shows all available packages in the database. This can be slow to load.

Installed
    Shows installed packages.

Orphaned
    Shows packages not required by any other packages. This is equivalent to the output of “pkg_info -t”.

On this screen, one can use the following keys:

u   Update all packages.

Enter/space/right/l
    Browse a category.

s   Search for a pattern in a package name or comment. Will show the list of packages that match this pattern.

q   Exit pkg_mgr.

Curses::UI(3p) binds j/k to down/up by default like in vi(1).

  Package list
This screen shows all package names and corresponding short comments in the selected category. Currently installed packages are highlighted. The checked packages are the ones installed (or to be installed).

On this screen, one can use the following keys:

space/l
    Change the status of a package. If installed, unchecking a package will tag it for removal, and rechecking it will tag it for update. If not installed, checking a package will tag it for installation.

s   Simulate package changes.

a   Apply package changes. Only possible if run with root credentials; will fallback to simulation otherwise.

Enter/right
    View selected package details.

left
    Go back to categories list.

/   Quickly find a package name in the list.

q   Exit pkg_mgr.

  Package details
This screen shows details on the selected package, such as its description, its dependencies, the maintainer of the package, its source website, and if it is installed, the packages which require it.

ENVIRONMENT

DEBUG
    If set, dump informational messages to ./out.log.

PKG_PATH
    The package repositories to be used. Defaults to /usr/ports/packages. The syntax is explained in pkg_add(1).

SEE ALSO
pkg_add(1), pkg_delete(1), pkg_info(1), packages(7)

Development happens in the http://rhaalovely.net/git/pkg_mgr git(1) repository.

HISTORY
A first version of pkg_mgr was released on April 15, 2008. At that time it was a simple wrapper around databases/sqlports and pkg_add(1).

Version 0.2 released on December 26, 2010 implements a clean integration with the OpenBSD package tools described in OpenBSD::Intro(3p).

AUTHORS
Landry Breuil <landry@openbsd.org>