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_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
pkg_info(1)
HISTORY
The
pkg_summary
format was first officially documented in April 2006.