OpenBSD manual page server

Manual Page Search Parameters

PKG_INFO(1) General Commands Manual PKG_INFO(1)

pkg_infodisplay information on software packages

pkg_info [-AaCcdfIKLMmPqRSstUv] [-E filename] [-e pkg-name] [-l str] [-Q query] [-r pkgspec] [pkg-name] [...]

The pkg_info command is used to dump out information for packages, as created by pkg_create(1), which may be still packed up or already installed on the system with the pkg_add(1) command.

The pkg-name may be the name of an installed package, the pathname to a package distribution file, or a URL to a package available through FTP, HTTP, HTTPS, or SCP. pkg_info will try to complete pkg-name with a version number while looking through installed packages.

When browsing through uninstalled packages, running pkg_info -I *.tgz will report a summary line for each package, so that it is possible to run pkg_info pkgname.tgz to obtain a longer package description, and pkg_add -n pkgname.tgz to check that the installation would proceed cleanly, including dependencies.

The following command-line options are supported:

Show information for all currently installed packages, including internal packages.
Show information for all currently installed packages.
Show certificate information for signed packages.
Show the one-line comment field for each package.
Show the long-description field for each package.
filename
Look for the package(s) that contains the given filename. As a faster alternative, note that there is a package, pkglocatedb, that contains a locate(1) database of every file in every package.
pkg-name
This option allows you to test for the presence of another (perhaps prerequisite) package from a script. If the package identified by pkg-name is not currently installed, return 0, otherwise return 1. In addition, the names of any package(s) found installed are printed to stdout unless turned off using the -q option.

The given pkg-name is actually a package specification, as described in packages-specs(7). For example, pkg_info -e 'name->=1.3' will match versions 1.3 and later of the name package.

pkgpath
Another variant of this option that uses a pkgpath instead. A pkgpath is a location within the ports tree, as described in pkgpath(7). For example, pkg_info -e x11/kde/base3 will match any package that was compiled according to ${PORTSDIR}/x11/kde/base3.
Show the packing-list instructions for each package.
Show the index entry for each package.
Prefix file names with category keyword (e.g., @file, @lib). Always used together with -L.
Show the files within each package. This is different from just viewing the packing-list, since full pathnames for everything are generated.
str
Prefix each information category header (see -q) shown with str. This is primarily of use to front-end programs that want to request a lot of different information fields at once for a package, but don't necessarily want the output intermingled in such a way that they can't organize it. This lets you add a special token to the start of each field.
Show the install-message file (if any) for each package.
Only show packages tagged as manual installations. It should omit anything installed automatically as a dependency.
Show the pkgpath(7) for each package. You can easily build a subdirlist with this.
query
Show all packages in $PKG_PATH which match the given query.
Be “quiet” in emitting report headers and such, just dump the raw info (basically, assume a non-human reading).
Show which packages require a given package.
pkgspec
Check a list for a given pkgspec. The following arguments are names of packages to verify. Exit status will be augmented by 2 if none of the packages do match.
Show the package signature for each package. This signature is a unique tag showing the package name, and the version number of every run time dependency and shared library used to build this package.
Show an estimate of the total size of each package.
Show packages which are not required by any other packages.
Show the deinstall-message file (if any) for each package.
Turn on verbose output.

The standard package database directory, /var/db/pkg, can be overridden by specifying an alternative directory in the PKG_DBDIR environment variable.
This can be used to specify a colon-separated list of paths to search for package files. The current directory is always searched first, even if PKG_PATH is set. If PKG_PATH is used, the suffix “.tgz” is automatically appended to the pkg-name, whereas searching in the current directory uses pkg-name literally.
Temporary area where package information files will be extracted, instead of /var/tmp.

Package info is either extracted from package files named on the command line, or from already installed package information in /var/db/pkg/<pkg-name>.

pkg_add(1), pkg_create(1), pkg_delete(1), bsd.port.mk(5), package(5), pkg.conf(5), packages-specs(7), pkgpath(7)

Jordan Hubbard
initial design
Marc Espie
complete rewrite
November 25, 2011 OpenBSD-5.4