NAME
pkg_info
—
display information on software
packages
SYNOPSIS
pkg_info |
[-AaCcdfIKLMmPqRSstUv ]
[-E filename]
[-e pkg-name]
[-l str]
[-Q query]
[-r pkgspec]
[pkg-name] [...] |
DESCRIPTION
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:
-A
- Show information for all currently installed packages, including internal packages.
-a
- Show information for all currently installed packages.
-C
- Show certificate information for signed packages.
-c
- Show the one-line comment field for each package.
-d
- Show the long-description field for each package.
-E
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.
-e
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. -e
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. -f
- Show the packing-list instructions for each package. See pkg_create(1) and package(5) for the various annotations.
-I
- Show the index entry for each package.
-K
- Prefix file names with category keyword (e.g., @file, @lib). Always used
together with
-L
. -L
- Show the files within each package. This is different from just viewing the packing-list, since full pathnames for everything are generated.
-l
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. -M
- Show the install-message file (if any) for each package.
-m
- Only show packages tagged as manual installations. It should omit anything installed automatically as a dependency.
-P
- Show the pkgpath(7) for each package. You can easily build a subdirlist with this.
-Q
query- Show all packages in $PKG_PATH which match the given query.
-q
- Be “quiet” in emitting report headers and such, just dump the raw info (basically, assume a non-human reading).
-R
- Show which packages require a given package.
-r
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.
-S
- Show the update signature for each package. The ‘update 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.
-s
- Show an estimate of the total size of each package.
-t
- Show packages which are not required by any other packages.
-U
- Show the deinstall-message file (if any) for each package.
-v
- Turn on verbose output.
ENVIRONMENT
PKG_DBDIR
- The standard package database directory,
/var/db/pkg, can be overridden by specifying an
alternative directory in the
PKG_DBDIR
environment variable. PKG_PATH
- 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. IfPKG_PATH
is used, the suffix “.tgz” is automatically appended to the pkg-name, whereas searching in the current directory uses pkg-name literally. PKG_TMPDIR
- Temporary area where package information files will be extracted, instead of /var/tmp.
TECHNICAL DETAILS
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>.
SEE ALSO
pkg_add(1), pkg_create(1), pkg_delete(1), bsd.port.mk(5), package(5), pkg.conf(5), packages-specs(7), pkgpath(7)
AUTHORS
- Jordan Hubbard
- initial design
- Marc Espie
- complete rewrite