dcu(1M)

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 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 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(1M) 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 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.

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(1M)

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.