pkgparam(1)

pkgparam -- displays package parameter values

Synopsis

pkgparam [-v] [-d device] pkginst [param [param ...]]

pkgparam [-v] -f file [param [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 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 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 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 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.

Files

/var/spool/pkg: default spool directory
/usr/lib/locale/locale/LC_MESSAGES/uxpkg: language-specific message file [See LANG on environ(5).]

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.

References

disk(7), pkginfo(4), pkgmk(1), pkgproto(1), pkgtrans(1), tape(7)

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.