pkginfo(1)


pkginfo -- display software package and/or set information

Synopsis

pkginfo [-q] [-p|-i] [-x|-l] [-r] [options] [pkg ...]

pkginfo [-b bufsize] -d device [-q] [-x|-l] [options] [pkg ...]

Description

pkginfo displays information about software packages or sets 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. A set is made up of a special-purpose package, referred to as a Set Installation Package (SIP), and a collection of one or more packages that are members of the set. The SIP controls the installation of the set.

When run without options, pkginfo displays one line of information about every installed package (whether installed completely or partially) whose category is not the value ``set''. 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 SCO OpenServer software packages (installed using custom(1M)), pkginfo prints the heading ``Custom Installed Packages'', followed by a list of packages. The list shows 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:


-b bufsize
Specifies the buffer size passed to cpio to copy a package image from a device (such as a tape drive) to a temporary work area on disk. By default, the buffer size is taken from /etc/device.tab; and, if this value fails, the command is re-tried with a buffer size of 512. The -b option overrides the value in /etc/device.tab; if the buffer size you supply fails, the command is attempted again with a buffer size of 512.

-i
Display information only for fully installed packages.

-l
Display a ``long format'' report (that is, one that includes all available information) about the specified package(s). If no pkg(s) is/are specified, information is displayed for all installed packages, not including those "Custom Installed".

-p
Display information only for partially installed packages.

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

-r
List the installation base for the specified package if the package is relocatable.

-x
Extract and display the following information about the specified package: abbreviation, name, and, if available, architecture and version. If no pkg(s) is/are specified, this information is displayed for all installed packages, not including those "Custom Installed".

options
options may include the following:

-c category, [category...]
Display information about packages that belong to category category. (Categories are defined in the category field of the pkginfo file and can be one of the following: "application", "graphics", "system", "utilities", "set", "patch"; see pkginfo(4) for details.) More than one category may be specified in a comma-separated list. A package is required to belong to only one category, even when multiple categories are specified. The package-to-category match is not case-sensitive. For example, to list all installed packages of either category "graphics" or "application":

pkginfo -c graphics,application

If the category specified is ``set'', pkginfo will display information about Set Installation Packages (SIPs).


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

-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 SCO OpenServer software packages (with which no version numbers are associated). Multiple white spaces are replaced with a single space during version comparison.

pkg
A short string used to designate an abbreviation for the package/set name. For more information on pkg, see pkginfo(4).

To indicate all instances of a package, specify 'pkg.*', enclosing the command line in single quotes, as shown, to prevent the shell from interpreting the * character. Use the token all to refer to all packages available on the source medium.

If pkg is a SIP, information about the packages with which the SIP is associated will be displayed.


-d device
Display information from packages/sets 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 disk(7) and tape(7)], (c) a device alias; or (d) ``"-"'' which specifies packages in datastream format read from standard input. 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.

Exit codes


0
Successful completion of script.

1
Fatal error. Installation process is terminated at this point.

Files


/var/spool/pkg
default spool directory

References

disk(7), pkgadd(1M), pkgask(1M), pkgchk(1M), pkginfo(4), pkgrm(1M), pkgtrans(1), setinfo(4), tape(7)

Notices

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

If pkginfo is invoked to obtain information on packages that are members of sets located on tape media, all options to pkginfo are allowed since the information on these packages is readily available on the tape. In the case of diskettes, if the SIP and each of its member packages are on separate disks, not all information on these packages is available. In this case, the pkginfo command will only display a short listing. For this reason, the -a, -l and -v options will not work for sets whose packages span over several diskettes.


© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004