pkgparam(C)

pkgparam -- displays package parameter values

Synopsis

/usr/bin/pkgparam [-v] [-d device] pkginst [param ...]

/usr/bin/pkgparam -d device [-v] [param ...]

/usr/bin/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/*), (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.

Differences between versions

SCO OpenServer Release 5.0.5a and later releases, support the UnixWare 7 command of the same name. There are no known syntactical differences for the version of the command supported on earlier SCO OpenServer releases.

Files

/var/spool/pkg: default spool directory
/usr/lib/locale/locale/LC_MESSAGES/uxpkg: language-specific message file; see LANG on environ(M).

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

pkginfo(F), pkgmk(C), pkgproto(C), pkgtrans(C), tape(HW)

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.