xref: /illumos-gate/usr/src/man/man1/pkginfo.1 (revision e0731422366620894c16c1ee6515551c5f00733d)
te
Copyright 1989 AT&T Copyright (c) 2007 Sun Microsystems, Inc. All Rights Reserved
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]
PKGINFO 1 "Oct 30, 2007"
NAME
pkginfo - display software package information
SYNOPSIS

pkginfo [-q | -x | -l] [-p | -i] [-r] [-a arch]
 [-v version] [-c category]... [pkginst]...

pkginfo [-d device] [-R root_path] [-q | -x | -l] [-a arch]
 [-v version] [-c category]... [pkginst]...
DESCRIPTION

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

Without options, pkginfo 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.

OPTIONS

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

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

Specify the architecture of the package as arch.

-c category

Display packages that match category. Categories are defined with the CATEGORY parameter in the pkginfo(4) 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.

-d device

Defines a device, device, on which the software resides. device can be an absolute directory pathname or the identifiers for tape, floppy disk, removable disk, and so forth. The special token spool may be used to indicate the default installation spool directory (/var/spool/pkg).

-i

Display information for fully installed packages only.

-l

Specify long format, which includes all available information about the designated package(s).

-p

Display information for partially installed packages only.

-q

Do not list any information. Used from a program to check whether or not a package has been installed.

-r

List the installation base for relocatable packages.

-R root_path

Defines the full path name of a directory to use as the root_path. All files, including package system information files, are relocated to a directory tree starting in the specified root_path.

-v version

Specify the version of the package as version. The version is defined with the VERSION parameter in the pkginfo(4) file. All compatible versions can be requested by preceding the version name with a tilde (\(ap). Multiple white spaces are replaced with a single white space during version comparison.

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

OPERANDS
pkginst

A package designation by its instance. An instance can be the package abbreviation or a specific instance (for example, inst.1 or inst.2). All instances of a package can be requested by inst.*. The asterisk character (*) is a special character to some shells and may need to be escaped. In the C-Shell, "*" must be surrounded by single quotes (') or preceded by a backslash (\e).

EXIT STATUS
0

Successful completion.

>0

An error occurred.

FILES
/var/spool/pkg

default installation spool directory

SEE ALSO

pkgtrans(1), pkgadd(1M), pkgask(1M), pkgchk(1M), pkgrm(1M), pkginfo(4), attributes(5), largefile(5)

Application Packaging Developer's Guide

NOTES

Package commands are largefile(5)-aware. They handle files larger than 2 GB in the same way they handle smaller files. In their current implementations, pkgadd(1M), pkgtrans(1) and other package commands can process a datastream of up to 4 GB.