pkginfo(1) — USER COMMANDS

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

pkginfo displays information about software packages that are installed on the system (as requested in the first synopsis) or that reside on a particular device or directory (as requested in the second synopsis). A package is a collection of related files and executables that can be independently installed.

When run without options, pkginfo displays one line of information about every installed package (whether installed completely or partially). The information displayed includes the primary category, package instance, and name of the package. For UNIX software packages produced before UNIX System V Release 4, pkginfo displays only the package name and abbreviation. For XENIX software packages, pkginfo identifies the package as a XENIX software package and displays only the package name and abbreviation.

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

The options for this command are:

-q Do not list any information. This option overrides the -x, -l, -p, and -i options. (Can be invoked by a program to query whether or not a package has been installed.)

-x Extract and display the following information about the specified package: abbreviation, name, and, if available, architecture and version.

-l Display a “long format” report (that is, one that includes all available information) about the specified package(s).

-p Display information only for partially installed packages.

-i Display information only for fully installed packages.

-a arch Specify the architecture of the package as arch.

-v version Specify the version of the package as version. All compatible versions can be requested by preceding the version name with a tilde (~). The list produced by -v will include pre-Release 4 and XENIX software packages (with which no version numbers are associated). Multiple white spaces are replaced with a single space during version comparison.

-c category . . .
Display information about packages that belong to category category. (Categories are defined in the category field of the pkginfo file; see pkginfo(4) for details.) More than one category may be specified (as long as they are separated by white space). A package is required to belong to only one category, however, even when multiple categories are specified. The package-to-category match is case specific.

pkginst A short string used to designate a package. It is composed of one or two parts: pkg (an abbreviation for the package name) or, if more than one instance of that package exists, pkg plus inst (an instance identifier). (The term “package instance” is used loosely: it refers to all instantiations of pkginst, even those that do not include instance identifiers.)

The package name abbreviation (pkg) is the mandatory part of pkginst. [See pkginfo(4).]

The second part (inst), which is required only if you have more than one instance of the package in question, is a suffix that identifies the instance. This suffix is either a number (preceded by a period) or any short mnemonic string you choose. If you do not assign your own instance identifier when one is required, the system assigns a numeric one by default. For example, if you have three instances of the Software Distribution Service package and you do not create your own mnemonic identifiers (such as old and beta), the system adds the suffixes .2 and .3 to the second and third packages, automatically.

To indicate all instances of a package, specify inst.∗. (When using this format, enclose the command line in single quotes to prevent the shell from interpreting the ∗ character.) Use the token all to refer to all packages available on the source medium.

-d device Display information from packages that reside on device. device can be (a) the full pathname to a directory (such as /var/tmp), (b) the full pathname to a device (such as /dev/rmt/∗ or /dev/dsk/∗) [see intro(7)], or (c) a device alias. The default device is the installation spool directory (/var/spool/pkg).

An alias is the unique name by which a device is known. (For example, the alias for a cartridge tape drive might be ctape1.) The name must be limited in length to 64 characters (DDB_MAXALIAS) and may contain only alphanumeric characters and/or any of the following special characters: underscore (_), dollar sign ($), hyphen (-), and period (.). No two devices in the database may share the same alias.

NOTES

pkginfo cannot tell if a pre-UNIX System V Release 4 or XENIX software package is only partially installed. It is assumed that all pre-Release 4 and XENIX software packages are fully installed.

FILES

/var/spool/pkg default spool directory

Museum