NAME    [Toc]    [Back]

     pkg_info - a utility for displaying information on  software
packages

SYNOPSIS    [Toc]    [Back]

     pkg_info   [-cDdfIikLmpqRrvh]   [-e   package]  [-l  prefix]
pkg-name [...]
     pkg_info [-a flags]

DESCRIPTION    [Toc]    [Back]

     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, or scp.  pkg_info will try to complete pkg-name with a
version number
 while looking through installed packages.

     The following command-line options are supported:

     -a       Show  information for all currently installed packages.

     -c      Show the one-line comment field for each package.

     -D      Show the install-message  file  (if  any)  for  each
package.

     -d      Show the long-description field for each 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 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.

             If the given pkg-name contains a shell  meta-character, it will be
             matched  against  all  installed  packages using fnmatch(3).  csh(1)
             style ``{,}'' alternates have also been  implemented
in addition
             to  this.   Package  version  numbers  can  also  be
matched in a relational
 manner using the ``>='', ``<='',  ``>'',  and
``<'' operators.
   For  example,  pkg_info  -e 'name>=1.3' will
match versions
             1.3 and later of the name package.

     -f      Show the packing list instructions for each package.

     -I      Show the index entry for each package.

     -i      Show the install script (if any) for each package.

     -k       Show  the de-install script (if any) for each package.

     -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 necessary 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 mtree file (if any) for each package.

     -p      Show the installation prefix for each package.

     -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      Show the requirements script (if any) for each package.

     -v      Turn on verbose output.

ENVIRONMENT    [Toc]    [Back]

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

     PKG_TMPDIR  Temporary area where package  information  files
will be extracted,
 instead of /var/tmp.

TECHNICAL DETAILS    [Toc]    [Back]

     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    [Toc]    [Back]

     pkg_add(1),    pkg_create(1),   pkg_delete(1),   mkstemp(3),
mtree(8)

AUTHORS    [Toc]    [Back]

     Jordan Hubbard
             initial design
     Marc Espie
             complete rewrite

OpenBSD     3.6                         August      22,      1998