pkginfo(ADM)                    19 June 1992                    pkginfo(ADM)


 Name

    pkginfo - display software package information

 Synopsis

    pkginfo [-q|x|l] [-p|i] [-a arch] [-v version]
    [-c category1, [category2 [, ... ]]]
    [pkginst [,pkginst [, ... ]]]

    pkginfo [-d device [-q|x|l] [-a arch] [-v version]
    [-c category1, [category2
    [, ... ]]] [pkginst [,pkginst[, ... ]]]

 Description

    The pkginfo command displays information about software packages which
    are installed on the system (with the first synopsis) or which reside on
    a particular device or directory (with the second synopsis).  No informa-
    tion will be displayed for packages installed using custom(ADM).  Only
    the package name and abbreviation will be included in the display for
    packages installed using installpkg(ADM).

    The options for this command are:

    -q        Does not list any information, but can be used from a program
              to check (that is, query) whether or not a package has been
              installed.

    -x        Designates an extracted listing of package information.  It
              contains the package abbreviation, package name, package archi-
              tecture (if available) and package version (if available).

    -l        Designates long format, which includes all available informa-
              tion about the designated package(s).

    -p        Designates that information should be presented only for par-
              tially installed packages.

    -i        Designates that information should be presented only for fully
              installed packages.

    -a        Specifies the architecture of the package as arch.

    -v        Specifies the version of the package as version.  All compati-
              ble versions can be requested by preceding the version name
              with a tilde (~).  The list produced by -v will include pack-
              ages installed using installpkg(ADM).  (with which no version
              numbers are associated).  Multiple white spaces are replaced
              with a single space during version comparison.

    -c        Selects packages to be displayed based on the category
              category.  (Categories are defined in the ``category'' field of
              the pkginfo file.) If more than one category is supplied, the
              package must only match one of the list of categories.  The
              match is not case specific.

    pkginst   Designates a package by its instance.  An instance can be the
              package abbreviation or a specific instance (for example,
              inst.1 or inst.beta).  All instances of package can be
              requested by inst.*.  When using this format, enclose the com-
              mand line in single quotes to prevent the shell from interpret-
              ing the * character.

    -d        Defines a device, device, on which the software resides.  de-
              vice can be a full pathname to a directory or the identifiers
              for tape, floppy disk, removable disk, and so on.  The special
              token ``spool'' may be used to indicate the default installa-
              tion spool directory.

 Notes

    Without options, pkginfo lists the primary category, package instance,
    and name of all completely installed and partially installed packages.
    One line per package selected is produced.

    The -p and -i options are meaningless if used in conjunction with the -d
    option.

    The options -q, -x, and -l are mutually exclusive.

    pkginfo cannot tell if a package installed using installpkg(ADM) is only
    partially installed.  It is assumed that all such packages are fully
    installed.

 See also

    pkgadd(ADM), pkgask(ADM), pkgchk(ADM), pkgrm(ADM), pkgtrans(ADM)