pkginfo(C)

pkginfo -- display software package and/or set information

Synopsis

/usr/bin/pkginfo [-q] [x|l] [-r] [-p|-i] [-a arch] [-v version] [-c category1,[category2[,...]]] [pkginst[,pkginst[,...]]]

/usr/bin/pkginfo [-d device [-q] [x|l] [-a arch] [-v version] [-c category1[,category2[,...]]] [pkginst[,pkginst[,...]]]

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(ADM)), 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:

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

-r

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

-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 SCO OpenServer 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(F) 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.

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

pkginst

A short string used to designate an abbreviation for the package/set name. (The term ``package instance'' is used loosely: it refers to all instantiations of pkginst, even those that do not include instance identifiers.)

See pkginfo(F).

To indicate all instances of a package, specify 'pkginst.', 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 pkginst 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 /usr/tmp), (b) the full pathname to a device (such as /dev/rmt/* or /dev/dsk/*), (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.

Differences between versions

For SCO OpenServer Release 5.0.5a and later releases, this command is identical to the UnixWare 7 command of the same name. For earlier SCO OpenServer releases, the -r option is not supported.

Files

/var/spool/pkg: default spool directory

References

pkgadd(ADM), pkgask(ADM), pkgchk(ADM), pkginfo(F), pkgrm(ADM), pkgtrans(C), setinfo(F), tape(HW)

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.