pkgparam(1) pkgparam(1)
NAME
pkgparam - displays package parameter values
SYNOPSIS
pkgparam [-v] [-d device] pkginst [param . . . ]
pkgparam -d device [-v] [param . . . ]
pkgparam -f file [-v] [param . . . ]
DESCRIPTION
pkgparam displays the value associated with the parameter or
parameters requested on the command line. The values are
located in one of the following places: (a) in the pkginfo
file for pkginst, (b) on the device named with the -d option,
or (c) on the specific file named with the -f option. When a
device is given, but a pkginst is not (as shown in the second
synopsis), parameter information for all packages residing on
device is shown.
One parameter value is shown per line. Only the value of a
parameter is given unless the -v option is used. With this
option, the output of the command is in this format:
parameter1='value1'
parameter2='value2'
parameter3='value3'
If no parameters are specified on the command line, values for
all parameters associated with the package are shown.
Options and arguments for this command are:
-v Specifies verbose mode. Displays name of parameter
and its value.
-d device Specifies the device on which a pkginst is stored.
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
Copyright 1994 Novell, Inc. Page 1
pkgparam(1) pkgparam(1)
length to 64 characters (DDB_MAXALIAS) and can
contain only alphanumeric characters and/or any of
the following special characters: underscore (_),
dollar sign ($), hyphen (-), and period (.). No two
devices in the database can share the same alias.
-f Requests that the command read file for parameter
values.
pkginst Defines a specific package instance for which
parameter values should be displayed. The format
pkginst.* can be used to indicate all instances of a
package. When using this format, enclose the
command line in single quotes to prevent the shell
from interpreting the * character.
param Defines a specific parameter whose value should be
displayed.
EXIT CODES
If parameter information is not available for the indicated
package, the command exits with a non-zero status.
0 Successful completion of script.
1 Fatal error. Installation process is terminated at this
point.
NOTICES
The -f synopsis allows you to specify the file from which
parameter values should be extracted. This file should be in
the same format as a pkginfo file. As an example, such a file
might be created during package development and used while
testing software during this stage.
FILES
/var/spool/pkg default spool directory
/usr/lib/locale/locale/LC_MESSAGES/uxpkg
language-specific message file
[See LANG on environ(5).]
REFERENCES
intro(7), pkginfo(4), pkgmk(1), pkgproto(1), pkgtrans(1)
Copyright 1994 Novell, Inc. Page 2