resmgr(1M) resmgr(1M)
NAME
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:
Copyright 1994 Novell, Inc. Page 1
resmgr(1M) resmgr(1M)
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, then only the values for those parameters are
displayed.
[-i brdinst]
resmgr -m modname -p "param1[ . . .]" -v "val1[ . . . ]" [-
Copyright 1994 Novell, Inc. Page 2
resmgr(1M) resmgr(1M)
d delim]
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
EXAMPLES
Display the resource manager database:
resmgr
Remove the Resource Manager database entry for the first asyc
(asynchronous port driver) board instance:
Copyright 1994 Novell, Inc. Page 3
resmgr(1M) resmgr(1M)
resmgr -r -m asyc
Remove the Resource Manager database entry for the second asyc
(asynchronous port driver) board instance:
resmgr -r -m asyc -i 1
Add a new parameter and value for the asyc entry:
resmgr -m asyc -p speed,s -v V32bis
Create a new Resource Manager database entry with multiple
parameters:
resmgr -a -p "MODNAME IPL ITYPE IRQ" -v "lp 5 4 7"
Warnings
The resmgr command modifies only the in-core Resource Manager
database. If the changes are to be permanently reflected
(across reboots, for example), then you must use the
idconfupdate(1M) command to update the Resource Manager
database.
REFERENCES
dcu(1M), idconfupdate(1M)
Copyright 1994 Novell, Inc. Page 4