PKG_SUMMARY(5)            NetBSD File Formats Manual            PKG_SUMMARY(5)

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, sepa-
             rated by space.

     COMMENT
             (required) A one-line description of the package.

     CONFLICTS
             (optional) A list of dewey patterns of packages the package con-
             flicts with, one per line.  If missing, this package has no con-
             flicts.

     DEPENDS
             (optional) A list of dewey patterns of packages the package
             depends on, one per line.  If missing, this package has no depen-
             dencies.

     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 com-
             piled.

     OS_VERSION
             (required) The version of the operating system on which the pack-
             age 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 renam-
             ing.

     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 pack-
     ages:

           pkg_info -X -a

SEE ALSO
     pkg_info(1)

HISTORY
     The pkg_summary format was first officially documented in April 2006.

NetBSD 5.0_STABLE               April 11, 2009               NetBSD 5.0_STABLE
