dcu(1M) dcu(1M)
NAME
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/change the
device driver settings for these hardware devices. A
device driver is a software program that enables
UnixWare to communicate with a hardware device. The
hardware parameters for a hardware device must be
assigned to the device driver in order for UnixWare 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 (that is, disable
UnixWare's access to the hardware device).
Assign hardware devices to device drivers.
The dcu command provides a menu interface for you to view
and/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 UnixWare 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
Copyright 1994 Novell, Inc. Page 1
dcu(1M) dcu(1M)
device driver parameters to match the hardware
device parameters.
Typically, UnixWare automatically detects the
hardware devices 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 set-up 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 and/or arrow keys to highlight the particular
hardware device and then press F6.
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 (that is, to define
the hardware parameters for a new hardware
device to UnixWare), use the TAB and/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 F5.
For additional device driver-specific
information, use the TAB and/or arrow keys
to highlight the particular device driver
and then press F6.
Apply Changes and Exit DCU
This option lets you save the changes you selected
through the Hardware Device Configuration and/or
Software Device Driver screens. The changes
requested through the DCU do not take effect until
you select this option.
Copyright 1994 Novell, Inc. Page 2
dcu(1M) dcu(1M)
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
may not take effect until the kernel is rebuilt with
idbuild(1M).
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 and/or Software
Device Drivers menus. If you select this option
then 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 and/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 UNKOWN when no device driver has yet
been mapped to it.
Files
/stand/resmgr
/dev/resmgr
/etc/conf/sdevice.d/*
Copyright 1994 Novell, Inc. Page 3
dcu(1M) dcu(1M)
/etc/conf/drvmap.d/*
Environment Variables
The DCU uses the following environmental variables:
ROOT The directory where UnixWare 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(4) file; the default is
${ROOT}/usr/share/lib/terminfo.
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.
Failure. Illegal option given.
3 Failure. A hardware conflict was detected.
4 Failure. The idconfupdate command failed.
USAGE
Examples
If a non-SCSI CD-ROM is no longer supported on your system, do
the following to deactivate the ictha device driver:
Type dcu to invoke the DCU.
Copyright 1994 Novell, Inc. Page 4
dcu(1M) dcu(1M)
When prompted for a password, enter the root password.
The DCU Main Menu is displayed.
Select the Hardware Device Configuration option.
Navigate to the line corresponding to the device driver
you want to deconfigure.
Type in N in the first column (or press F2 to toggle to
N).
Press F10 to return to the DCU Main Menu.
Press TAB to move the cursor to the Apply Changes and
Exit DCU.
Press ENTER to apply the ictha device driver change and
exit the DCU.
Warnings
Do not modify the /stand/resmgr file. Use the dcu command to
make any changes that you want to the system resource
database. UnixWare may not function or boot if the
/stand/resmgr file is corrupted.
REFERENCES
idconfupdate(1M)
Copyright 1994 Novell, Inc. Page 5