NAME
pkg_summary —
summary of binary package
repository
DESCRIPTION
The file
pkg_summary contains information about each package
in a binary package repository as a list of variable-value pairs. The
variables describing different packages are separated by one empty line. Each
line has the format
VARIABLE=VALUE
. If the value
consists of more than one line, each line is prefixed with
VARIABLE=
. Multi-line variables are guaranteed to be
in consecutive lines.
The following variables are used:
-
-
BUILD_DATE
- (required) The date and time when the package was
built.
-
-
CATEGORIES
- (required) A list of categories which this package fits in,
separated by space.
-
-
COMMENT
- (required) A one-line description of the package.
-
-
CONFLICTS
- (optional) A list of dewey patterns of packages the package
conflicts with, one per line. If missing, this package has no
conflicts.
-
-
DEPENDS
- (optional) A list of dewey patterns of packages the package
depends on, one per line. If missing, this package has no
dependencies.
-
-
DESCRIPTION
- (required) A more detailed description of the package.
-
-
FILE_CKSUM
- (optional) A checksum type supported by
digest(1) and checksum
separated by space character.
-
-
FILE_NAME
- (optional) The name of the binary package file. If not
given, PKGNAME.tgz can be assumed.
-
-
FILE_SIZE
- (optional) The size of the binary package file, in
bytes.
-
-
HOMEPAGE
- (optional) A URL where more information about the package
can be found.
-
-
LICENSE
- (optional) The type of license this package is distributed
under. If empty or missing, it is OSI-approved.
-
-
MACHINE_ARCH
- (required) The architecture on which the package was
compiled.
-
-
OPSYS
- (required) The operating system on which the package was
compiled.
-
-
OS_VERSION
- (required) The version of the operating system on which the
package was compiled.
-
-
PKG_OPTIONS
- (optional) Any options selected to compile this package. If
missing, the package does not support options.
-
-
PKGNAME
- (required) The name of the package.
-
-
PKGPATH
- (required) The path of the package directory within
pkgsrc.
-
-
PKGTOOLS_VERSION
- (required) The version of the package tools used to create
the package.
-
-
PREV_PKGPATH
- (optional) The previous path of the package directory
within pkgsrc when a package was moved. (See
SUPERSEDES
below for a renamed package.)
-
-
PROVIDES
- (optional) A list of shared libraries provided by the
package, including major version number, one per line. If missing, this
package does not provide shared libraries.
-
-
REQUIRES
- (optional) A list of shared libraries needed by the
package, including major version number, one per line. If missing, this
package does not require shared libraries.
-
-
SIZE_PKG
- (required) The size of the package when installed, in
bytes.
-
-
SUPERSEDES
- (optional) A list of dewey patterns of previous packages
this package replaces, one per line. This is used for package
renaming.
The
pkg_summary file can be generated using the
pkg_info(1)
-X option. For example, the following will list this data
for all installed packages:
pkg_info -X -a
SEE ALSO
digest(1),
pkg_info(1)
HISTORY
The
pkg_summary format was first officially documented in
April 2006.