dcu(ADM)
dcu --
Device Configuration Utility
Synopsis
dcu [-C | -S]
Description
The Device Configuration Utility (DCU) allows you to:
-
List the hardware devices (controllers) that are configured on your system
and define, view, or change the device driver settings for
these hardware devices.
A device driver is a software program
that enables the operating system to communicate
with a hardware device.
The hardware parameters for a hardware device
must be assigned to the device driver
for the operating system to access the hardware device.
For each configured hardware device,
the DCU lists the associated device driver
and the hardware parameters
that are currently assigned to this device driver.
These parameters include the interrupt vector (IRQ),
I/O address range,
memory address range,
DMA channel, IPL value,
ITYPE value, board ID,
bind CPU value, and device name.
-
Configure/unconfigure a device driver.
-
Deactivate a hardware device
(disable the kernel's access to the hardware device).
-
Assign hardware devices to device drivers.
The dcu command provides a menu interface
for you to view or change the hardware configuration information.
On-line help for this interface is available
by pressing the <F1> function key.
Navigation and choice information is provided
at the bottom of each DCU screen.
The DCU can also be invoked
from the Desktop by selecting
Hardware_Setup from the Admin Tools window and,
when prompted,
entering the password for root.
The major DCU options
(available on the DCU main menu) are:
Hardware Device Configuration-
This option lets you view the hardware devices that are configured on your
system and modify the device driver parameters to match the hardware
device parameters.
In most cases, the operating system
automatically detects the hardware devices
that are attached to your system
and lists each hardware component.
However, some hardware cannot be detected automatically;
for example,
some hardware devices are manually configured
and do not have software setup utilities
that define the hardware parameter settings to your system
NVRAM (non-volatile random access memory).
For such hardware, you need to use
the Software Device Drivers option
to define a new hardware device instance
for the appropriate device driver.
For additional board-specific information,
from the Hardware Device Configuration menu,
use the <TAB> or arrow keys
to highlight the particular hardware device
and then press the <F6> key.
Software Device Drivers-
This option lets you view device drivers configured on your system and to
assign hardware devices to device drivers.
-
To add a hardware device
(to define the hardware parameters for a new hardware device),
use the <TAB> or arrow keys
to highlight the appropriate device driver,
enable it by toggling the value for the enabled field
(the first field) to ``Y'',
and then press the <F5> key.
-
For additional device driver-specific information,
use the <TAB> or arrow keys
to highlight the particular device driver
and then press the <F6> key.
Apply Changes and Exit DCU-
This option lets you save the changes
you selected through the Hardware Device Configuration
or Software Device Driver windows.
The changes requested through the DCU
do not take effect until you select this option.
NOTE:
Changes made to most auto-configurable drivers
supplied with UnixWare
will take effect the next time the driver is loaded.
Changes made to any other drivers might not take effect until the kernel
is rebuilt with the
idbuild(ADM)
command.
Exit DCU and Cancel Changes-
This option lets you exit the DCU
without applying any of the changes you selected
through the Hardware Device Configuration
or Software Device Drivers menus.
If you select this option,
all the changes requested using the DCU are lost
and do not take effect.
The DCU allows you to view or change
the device driver settings for your hardware devices.
If you need to change the hardware parameters for a hardware device,
first shut down your system.
Then, change the jumper pins or run the configuration utility
provided with the hardware.
When the system reboots,
invoke the DCU and define
the new hardware parameter settings to the
appropriate device driver.
Flags
-C-
Checks the hardware configuration for conflicts.
A report, in the full-screen style of the interactive
DCU, is displayed for each conflict detected.
The dcu -C command exits with an
exit code of 3 when conflicts are found.
-S-
silently maps UNKOWN entries in the
resmgr database to the appropriate device drivers.
It does so by comparing the board ID parameter
and board bus type parameter of the UNKNOWN
entry to the information in each device driver's
/etc/conf/drvmap.d file.
When a match is found, the entry is mapped to that device driver.
A resmgr entry is considered UNKNOWN
when no device driver has yet been mapped to it.
Environment variables
The DCU uses the following environment variables:
ROOT-
The directory where unix is installed;
the default is /.
DCUDIR-
The location of the dcu scripts;
the default is ${ROOT}/etc/dcu.d.
LANG-
The internationalization language;
the default is C.
TERM-
The terminal type;
the default is at386.
TERMINFO-
The location for the
terminfo(F)
file;
the default is ${ROOT}/usr/share/lib/terminfo.
Files
/stand/resmgr-
/dev/resmgr-
/etc/conf/sdevice.d/*-
/etc/conf/drvmap.d/*-
Exit codes
The dcu command exits with one of the following values:
0-
Success.
1-
Failure.
The DCU was unable to access the /dev/resmgr file.
Failure.
The terminfo type is not supported.
2-
Failure.
Option requires an argument or
illegal option given.
3-
Failure.
A hardware conflict was detected.
4-
Failure.
The idconfupdate command failed.
5-
Failure.
The idbuild -n command failed to create the loadable module.
Warnings
Do not modify the /stand/resmgr file.
Use the dcu command to make any changes
to the system resource database.
The system might not function or boot
if the /stand/resmgr file is corrupted.
References
idconfupdate(ADM)
Examples
To deactivate a non-SCSI tape device,
the following procedure will deactivate the ictha device driver:
-
Enter dcu to invoke the DCU.
-
When prompted,
enter the root password.
The DCU main menu is displayed.
-
Select Hardware Device Configuration.
-
Navigate to the line corresponding to the device driver
you want to deconfigure.
-
Type ``N'' in the first column
(or press the <F2> key
to toggle to ``N'').
-
Press the <F10> key
to return to the DCU main menu.
-
Use the arrow keys
to select Apply Changes and Exit DCU.
-
Press the <Esc> key
to apply the ictha device driver change
and exit the DCU.
© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 - 02 June 2005