PKGTOOLS

Installation.

You need to install the following ports to use these pkgtools:

• lang/ruby18 – Ruby 1.8 interpreter, or
• lang/ruby19 – Ruby 1.9 interpreter.

If you want to be able to run tests, you will also need to install
devel/ruby-testunit.

Tools included.

portupgrade

Portupgrade is a tool to upgrade installed packages via ports or
packages. It allows you to upgrade installed packages without having
to reinstall dependent/required packages by directly adjusting the
package database located under /var/db/pkg, while it can also upgrade
packages recursively.

Example: portupgrade gtk.

portinstall

Portinstall is equivalent to `portupgrade -N’, which means it tries to
install the latest version when a specified package is not installed.
Prior to the installation of a new package, all the required packages
are upgraded.

Example: portinstall shells/zsh.

portversion

Portversion is a tool to compare the versions of install packages with
those in the ports tree. It is a replacement for pkg_version(1)
cooperative with portupgrade, that is, the command output is optimized
for portupgrade. Besides, it runs much faster than pkg_version(1)
because it utilizes the prebuilt ports database. (See portsdb)

Example: portversion.

portsdb

Portsdb generates the ports database named INDEX.db from the ports
INDEX file. It is commonly used among the tool suite and
automatically updated on demand when it gets older than the ports
INDEX file.

Example: portsdb -Uu.

ports_glob

Ports_glob expands ports globs. It understands wildcards and is
capable of listing the required, dependent or master ports of a given
port. It would be handy to use from within a shell script.

Example: ports_glob '*/*firefox*'.

pkg_fetch

Pkg_fetch is a tool to download binary packages from remote sites. It
can optionally download packages recursively through dependencies.

Example: pkg_fetch -r sawfish.

pkg_glob

Pkg_glob expands package globs. It understands wildcards and is
capable of listing the required or dependent packages of a package.
It would be handy to use from within a shell script.

Example: pkg_glob -R gnome.

pkg_deinstall

Pkg_deinstall is a wrapper/replacement of pkg_delete(1), which
understands wildcards and is capable of recursing through
dependencies. It has an option to preserve shared libraries.

Example: pkg_deinstall -r xmms.

pkgdb

Pkgdb creates and updates the packages database which is commonly used
among the tool suite. It keeps a hash that maps an installed file to
a package name, a hash that maps a package to an origin, and a list of
installed packages. The database file is automatically updated on
demand when any package is installed or deinstalled after the database
was last updated.

Example: pkgdb -u.

Pkgdb also works as an interactive tool for fixing the package
registry database when -F is specified. It helps you resolve stale
dependencies, unlink cyclic dependencies, complete stale or missing
origins, and remove duplicates. You have to run this periodically so
that portupgrade and other tools can work effectively and unfailingly.

Example: pkgdb -Fv.

pkg_which

Pkg_which inquires of the packages database which package each given
file came from. If you do not have permission to update the database
although it is outdated, it delegates tasks to pkg_info(1).

Example: pkg_which patgen.

portsclean

Portsclean is a tool to clean ports working directories, no longer
referenced distfiles, outdated package files, and/or obsolete and
orphan shared libraries.

Example: portsclean -Di.

portcvsweb

Portcvsweb is a tool to instantly browse a history of a given file via
CVSweb. It may be more useful than you expect. Try it with src, www,
doc, NetBSD pkgsrc, and OpenBSD ports files. 😃

Example: portcvsweb sysutils/portupgrade.