.\"
.\" CDDL HEADER START
.\"
.\" The contents of this file are subject to the terms of the
.\" Common Development and Distribution License (the "License").
.\" You may not use this file except in compliance with the License.
.\"
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
.\" or http://www.opensolaris.org/os/licensing.
.\" See the License for the specific language governing permissions
.\" and limitations under the License.
.\"
.\" When distributing Covered Code, include this CDDL HEADER in each
.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
.\" If applicable, add the following below this CDDL HEADER, with the
.\" fields enclosed by brackets "[]" replaced with your own identifying
.\" information: Portions Copyright [yyyy] [name of copyright owner]
.\"
.\" CDDL HEADER END
.\"  Copyright 1989 AT&T  Copyright (c) 1996 Sun Microsystems, Inc.  All Rights Reserved
.\" Portions Copyright (c) 2007 Gunnar Ritter, Freiburg i. Br., Germany
.\"
.\" Sccsid @(#)pkginfo.1	1.8 (gritter) 2/25/07
.\"
.\" from OpenSolaris pkginfo 1 "6 Nov 2000" "SunOS 5.11" "User Commands"
.TH PKGINFO 1 "2/25/07" "Heirloom Packaging Tools" "User Commands"
.SH NAME
pkginfo \- display software package information
.SH SYNOPSIS
.HP
.PD 0
.ad l
.nh
\fBpkginfo\fR [\fB\-q\fR | \fB\-x\fR | \fB\-l\fR] [\fB\-p\fR | \fB\-i\fR] [\fB\-r\fR] [\fB\-a\fR \fIarch\fR]
[\fB\-v\fR \fIversion\fR] [\fB\-c\fR \fIcategory\fR]... [\fIpkginst\fR]...
.HP
.PD 0
.ad l
\fBpkginfo\fR [\fB\-d\fR \fIdevice\fR] [\fB\-R\fR \fIroot_path\fR] [\fB\-q\fR | \fB\-x\fR | \fB\-l\fR] [\fB\-a\fR \fIarch\fR]
[\fB\-v\fR \fIversion\fR] [\fB\-c\fR \fIcategory\fR]... [\fIpkginst\fR]...
.br
.PD
.ad b
.hy 1
.SH DESCRIPTION
\fBpkginfo\fR displays information about software packages that are installed on the system (with the first synopsis) or that reside on a particular device or directory (with the second
synopsis).
.PP
Without options, \fBpkginfo\fR lists the primary category, package instance, and the names of all completely installed and partially installed packages.
It displays one line for each
package selected.
.PP
The \fB\-p\fR and \fB\-i\fR options are meaningless if used in conjunction with the \fB\-d\fR option.
The options \fB\-q\fR, \fB\-x\fR, and \fB\-l\fR are mutually exclusive.
.TP 12
\fB\-a\fR\fI arch\fR
Specify the architecture of the package as \fBarch\fR.
.TP
\fB\-c\fR\fI category\fR
Display packages that match \fIcategory\fR.
Categories are defined with the \fBCATEGORY\fR parameter in the
.IR pkginfo (5)
file.
If more than one category is supplied, the package needs to match only one category in the list.
The match is not case specific.
.TP
\fB\-d\fR\fI device\fR
Defines a device, \fIdevice\fR, on which the software resides.
\fIdevice\fR
can be an absolute directory pathname or the identifiers for tape, floppy disk, removable disk, and so forth.
The special token \fBspool\fR may be used to indicate the default installation
spool directory (\fB/var/spool/pkg\fR).
.TP
.B \-i
Display information for fully installed packages only.
.TP
.B \-l
Specify long format, which includes all available information about the designated package(s).
.TP
.B \-p
Display information for partially installed packages only.
.TP
.B \-q
Do not list any information.
Used from a program to check whether or not a package has been installed.
.TP
.B \-r
List the installation base for relocatable packages.
.TP
\fB\-R\fR\fI root_path\fR
Defines the full path name of a directory to use as the \fIroot_path\fR.
All files,
including package system information files, are relocated to a directory tree starting in the specified \fIroot_path\fR.
.TP
\fB\-v\fR\fI version\fR
Specify the version of the package as \fIversion\fR.
The version is defined with the \fBVERSION\fR parameter in the
.IR pkginfo (5)
file.
All compatible versions can be requested by preceding the version name with a tilde (\fB\(ap\fR).
Multiple white spaces are replaced with a single white space during version comparison.
.TP
.B \-x
Designate an extracted listing of package information.
The listing contains the package abbreviation, package name, package architecture (if
available) and package version (if available).
.TP 12
\fB\fIpkginst\fR
A package designation by its instance.
An instance can be the package abbreviation
or a specific instance (for example, \fBinst.1\fR or \fBinst.2\fR).
All instances of a package can be requested by \fBinst.*\fR.
The asterisk character (\fB*\fR) is a special character to some shells and may need to be escaped.
In the C-Shell, "*" must be surrounded by single quotes (\fB'\fR) or preceded by a backslash (\e).
.SH FILES
.TP 14
.B /var/spool/pkg
default installation spool directory
.SH SEE ALSO
.IR pkgtrans (1),
.IR pkgadd (1M),
.IR pkgask (1M),
.IR pkgchk (1M),
.IR pkgrm (1M),
.IR pkginfo (5)