pkginfo(1) pkginfo(1)
NAME
pkginfo - display software package and/or set information
SYNOPSIS
pkginfo [-q] [x|l] [-r] [-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 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
XENIX software packages, pkginfo prints the heading ``Custom
Installed Packages,'' followed by a list of XENIX packages.
The list identifies the package name and abbreviation, with
the word yes in place of the package instance, to indicate
that the package is installed.
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.)
Copyright 1994 Novell, Inc. Page 1
pkginfo(1) pkginfo(1)
-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 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 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're separated by white
space). 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 a package/set. It
is composed of one or two parts: pkg (an
abbreviation for the package/set name) or, if more
Copyright 1994 Novell, Inc. Page 2
pkginfo(1) pkginfo(1)
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 don't 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 Advanced Commands package and you don't
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
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 /var/tmp), (b) the full pathname
to a device (such as /dev/rmt/* or /dev/dsk/*) [see
intro(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 (_),
Copyright 1994 Novell, Inc. Page 3
pkginfo(1) pkginfo(1)
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.
NOTICES
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.
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.
FILES
/var/spool/pkg default spool directory
REFERENCES
intro(7), pkgadd(1M), pkgask(1M), pkgchk(1M), pkginfo(4),
pkgrm(1M), pkgtrans(1), setinfo(4)
Copyright 1994 Novell, Inc. Page 4