resmgr(1M)

resmgr -- display and modify in-core Resource Manager Database

Synopsis

resmgr [-p "param1[ . . .]"]
resmgr -a -p "param1[ . . .]" -v "val1[ . . . ]" [-d delim]
resmgr -f file
resmgr -k key [-p "param1[ . . .]"]
resmgr -k key -p "param1[ . . .]" -v "val1[ . . . ]" [-d delim]
resmgr -m modname [-p "param1[ . . .]"] [-i brdinst]
resmgr -m modname -p "param1[ . . .]" -v "val1[ . . . ]" [-d delim] [-i brdinst]
resmgr -r -k key
resmgr -r -m modname [-i brdinst]

Description

The resmgr command displays and updates the Resource Manager database. The UnixWare kernel maintains the Resource Manager database that associates (key, param) pairs with sets of values. The autoconfiguration subsystem and other subsystems use the database to store and retrieve information.

Most users interact with the in-core Resource Manager database using the Device Configuration Utility (see dcu(1M)). The resmgr command is used primarily in shell scripts and for debugging.

Some of the display functions and behavior of resmgr are specific to the autoconfiguration system for AT architecture systems. Specifically, certain autoconfiguration parameter names (for example, IRQ and IOADDR) and associated types are known to resmgr. This affects what resmgr displays by default and allows use of these parameters without specifying their types.

For the -p and -v options, one or more parameters can be specified; multiple entries must be entered as a delimiter-separated list enclosed in double quotes. The default delimiter is space; the -d option overrides the default.

Only a privileged user can use the resmgr command.

Usage

The option combinations used with resmgr dictate its behavior and are the following:

resmgr [-p "param1[ . . . ]"]
When invoked with no options, resmgr displays the Resource Manager database. The parameters displayed are those of interest to the autoconfiguration system for AT architecture systems. When the -p flag is specified, the value for each of the selected parameters is displayed.
resmgr -a -p "param1[ . . . ]" -v "val1[ . . . ]" [-d delim]
Adds a new Resource Manager database entry and creates a new Resource Manager key. The list of parameters specified is assigned the list of values specified.
resmgr -f file
Converts file to readable format and displays it. file is the file output by idconfupdate and, by default, that is /stand/resmgr.
resmgr -r -k key
Removes the Resource Manager database entry that contains the specified key.
resmgr -k key -p "param1[ . . . ]" -v "val1[ . . . ]" [-d delim]
Adds one or more new parameters to an existing Resource Manager database entry that contains the specified key. Any values previously in that entry are deleted; the values specified are assigned. If a database parameter is to be assigned multiple values, its values are separated by the delimiter specified with the -d option. When the board instance (brdinst) is specified with the -i option, the additions are made to the brdinst-th entry. A brdinst of 0 selects the first board instance, the default.
resmgr -m modname [-p "param1[ . . . ]"] [-i brdinst]
Displays the Resource Manager database entries that contain a MODNAME database parameter with the value modname. When parameters are specified using the -p option, only the values for those parameters are displayed.
resmgr -m modname -p "param1[ . . .]" -v "val1[ . . . ]" [-d delim] [-i brdinst]
Adds one or more new parameters to an existing Resource Manager database entry that contain a MODNAME database parameter with the value modname. Any values previously in that entry are deleted; the values specified are assigned. If a database parameter is to be assigned multiple values, its values are separated by the delimiter specified with the -d option. When the board instance (brdinst) is specified with the -i option, the additions are made to the brdinst'th entry. A brdinst of 0, the default, selects the first board instance.
resmgr -r -m modname [-i brdinst]
Removes the Resource Manager database entry that contains a MODNAME database parameter with value modname. When the board instance (brdinst) is specified with the -i option, the brdinst-th entry is removed. A brdinst of 0, the default, removes the first board instance.

If the parameter is not one known to the resmgr (actually to the underlying Resource Manager access library), then its type must be specified along with its parameter name. The type is specified by a single type character separated from the parameter name with a comma, for example, ``cabletype,s'' is used for a parameter with the name cabletype and type string. The type characters recognized are:

s: for string
n: for single number
r: for number range

Exit codes

The resmgr command exits with one of the following values:

0: success
1: failure

Warnings

The resmgr command modifies only the in-core Resource Manager database. If the changes are to be permanently reflected (across reboots, for example), you must use the idconfupdate(1M) command to update the Resource Manager database.

Examples

To display the resource manager database:

resmgr

To remove the resource Manager database entry for the first asyc (asynchronous port driver) board instance:

resmgr -r -m asyc

To remove the Resource Manager database entry for the second asyc (asynchronous port driver) board instance:

resmgr -r -m asyc -i 1

To add a new parameter and value for the asyc entry:

resmgr -m asyc -p speed,s -v V32bis

To create a new Resource Manager database entry with multiple parameters:

resmgr -a -p "MODNAME IPL ITYPE IRQ" -v "lp 5 4 7"

References

dcu(1M), idconfupdate(1M)