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.
© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 -- 03 June 2005