pkgparam(1)

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

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.