'\"macro stdmacro
.if n .pH g1.pkginfo @(#)pkginfo	40.9 of 10/10/89
.\" Copyright 1989 AT&T
.nr X
.if \nX=0 .ds x} pkginfo 1 "Essential Utilities" "\&"
.if \nX=1 .ds x} pkginfo 1 "Essential Utilities"
.if \nX=2 .ds x} pkginfo 1 "Essential Utilities" "\&"
.if \nX=3 .ds x} pkginfo 1 "Essential Utilities" "\&"
.TH \*(x}
.SH NAME
\f4pkginfo\f1 \- display software package information
.SH SYNOPSIS
.ft CW
.ta .5i
.nf
pkginfo [\-q|x|l] [\-p|i] [\-a \f2arch\f(CW] [\-v \f2version\f(CW]
.br
	\f(CW[\-c \f2category1\f(CW,[\f2category2\f(CW[, ...]\|]\|] [\f2pkginst\f(CW[,\f2pkginst\f(CW[, ...]\|]\|]
.sp .5
\f(CWpkginfo\f1 [\f(CW\-d \f2device\f(CW [\-q|x|l] [\-a \f2arch\f(CW] [\-v \f2version\f(CW]
.br
	\f(CW[\-c \f2category1\f(CW,[\f2category2\f(CW[, ...]\|]\|] [\f2pkginst\f(CW[,\f2pkginst\f(CW[, ...]\|]\|]
.fi
.ft
.SH DESCRIPTION
\f(CWpkginfo\f1
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).
Only the package name and abbreviation for pre-SVR4 
packages will be included in the display.
.PP
The options for this command are:
.TP 10
\f(CW\-q\f1
Does not list any information,
but can be used from a program to check (\f2i.e.\f1, query)
whether or not a package has been installed.
.TP 10
\f(CW\-x\f1
Designates an extracted listing of package information.
It contains the
package abbreviation, package name, package architecture (if available) and
package version (if available). 
.TP 10
\f(CW\-l\f1
Designates long format,
which includes all available information
about the designated package(s).
.TP 10
\f(CW\-p\f1
Designates that information should be presented only for partially installed
packages.
.TP 10
\f(CW\-i\f1
Designates that information should be presented only for fully installed
packages. 
.TP 10
\f(CW\-a\f1
Specifies the architecture of the package as \f2arch\f1.
.TP 10
\f(CW\-v\f1
Specifies the version of the package as \f2version\f1.
"All compatible versions" can be requested by preceding the version
name with a tilde (~).
Multiple white space is replaced with a single space
during version comparison.
.TP 10
\f(CW\-c\f1
Selects packages to be display based on the 
category \f2category\f1.
(Categories
are defined in the category field of the \f4pkginfo\fP 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.
.TP 10
\f2pkginst\f1
Designates a package by its instance.
An instance can be the package
abbreviation or a specific instance (for example,
\f(CWinst.1\f1 or \f(CWinst.beta\f1).
All instances of package can be requested by \f(CWinst.*\f1.
.TP 10
\f(CW\-d\f1
Defines a device, \f2device\f1, on which the software resides.
\f2device\f1
can be a directory pathname or the identifiers for tape, floppy disk, removable
disk, \f2\f2etc.\f1\f1
The special token "spool" may be used to indicate the default
installation spool directory.
.SH NOTES
Without options, \f(CWpkginfo\f1 lists the primary category,
package instance, and
name of all completely installed and partially installed
packages.
One line per package selected is produced.
.PP
The \f(CW\-p\f1 and \f(CW\-i\f1 options are meaningless if used in conjunction
with the \f(CW\-d\f1 option.
.PP
The options \f(CW\-q\f1, \f(CW\-x\f1, and \f(CW\-l\f1 are mutually exclusive.
.PP
\f(CWpkginfo\f1 cannot tell if a pre-SVR4 package is only partially installed.
It is assumed that all pre-SVR4 packages are fully installed.
.SH SEE ALSO
.na
\f4pkgadd\fP(1M),
\f4pkgask\fP(1M),
\f4pkgchk\fP(1M),
\f4pkgrm\fP(1M),
\f4pkgtrans\fP(1).
.ad
