cha(HW)

cha -- Compaq 32-Bit Fast-SCSI-2 Controller driver

Description

This driver supports the Compaq 32-Bit Fast-SCSI-2 Controller. These controllers are high-end SCSI host adapters based on NCR SCSI I/O Processors. The driver supports full 32-bit addressing, scatter-gather command lists, and queue-tagging. It supplies drive status to the Compaq ProLiant Storage System Driver.

Support is included for the Integrated 32-Bit Fast-SCSI-2 Controller in Compaq ProSignia and Compaq ProLiant servers. Support is also included for the Compaq 32-Bit Fast-SCSI-2 Controller Option Board which may be installed in any Compaq EISA system.

Diagnostics

The following list gives definitions of parameters used by the cha driver in many of the following messages.

slot

The unique physical or virtual slot number in which a controller is located. This number is used for physical identification of a particular CSI controller.

ha

The unique host adapter number which was set during System Configuration for each 32-Bit Fast-SCSI-2 Controller in your system. This is the number UNIX uses to distinguish among multiple controllers of the same type. The first SCSI controller of each type is number 0. The ha displayed identifies a particular SCSI bus is associated with this message.

id

The unique SCSI id of a peripheral connected to a SCSI bus. The id displayed identifies a particular SCSI peripheral on a SCSI bus associated with this message. When id is displayed, ha is also be displayed to identify the SCSI bus.

lun

The logical unit number used to identify a logical portion of a SCSI peripheral. This number is typically 0.

cmd

A SCSI command code sent from a peripheral driver to a SCSI peripheral. The cmd is displayed as two hexadecimal digits. This is the contents of the first byte of the SCSI command block. The cmd displayed identifies a SCSI command associated with this message. When cmd is displayed, ha and id are also displayed to identify the SCSI bus and peripheral.

blk

A logical block address on the SCSI peripheral device. The blk displayed identifies an address (if applicable) on the SCSI peripheral associated with this message. When blk is displayed, ha, id, and cmd are also displayed. blk may not be meaningful for some SCSI peripheral types. For SCSI hard drives, blk is the sector number.

len

The length of the data transfer buffer associated with this message. The len is displayed in decimal. When len is displayed, ha, id, cmd, and blk are also displayed.

NOTE: If you are unsure of which SCSI peripheral is configured on which bus or at which id, the utility cpqsmu displays peripherals discovered on the SCSI bus. Also, the kernel configuration file /etc/conf/cf.d/mscsi is an ASCII file which may be displayed to show all SCSI peripherals configured into the UNIX kernel.

req

The kernel memory address of the request sent from a peripheral driver to the host adapter driver. The req is displayed in hexadecimal. It is used in the trace to associate start messages with done messages. Each done message in the trace is associated with the most recent start message for the same req.

stat

The SCSI peripheral completion status for the command associated with this message. The stat is displayed as two hexadecimal digits. SCSI peripherals use the completion status to inform the host of conditions which require attention or further action by the host. A stat of zero means OK or no further action.

err

The host adapter error code. This code identifies the type of error detected by the host adapter driver. When err is non-zero the host adapter has detected an error.

ht

The host adapter type. It is displayed as an ASCII string. The string contains the name of the host adapter driver for the host adapter controlling this SCSI bus. For example ht=cha. More than one type of SCSI host adapter can be present in a single system. Each type of host adapter has its own adapter numbering scheme beginning at 0. ht identifies the controller type.

Messages which may be produced by the 32-Bit Fast-SCSI-2 Controller driver (cha) and causes for the messages are listed below.

   %adapter addr1-addr2 irq - type=cha ha=ha id=id class slot=slot geo=g
   wid=w Compaq Fast-SCSI-2 (rev 1.9.0)

This message indicates that the Compaq 32-Bit Fast-SCSI-2 Controller driver has successfully initialized a controller. The controller initialized is using I/O addresses addr1 through addr2, handling interrupts using IRQ irq, and will not use DMA. The host adapter type is cha, the host adapter number is ha, the host adapter is using SCSI ID id. The controller class is EISA or PCI, the slot number is s, the default hard drive geometry algorithm for drives connected to this controller is g, and the width of the SCSI bus on the controller is w bits. This message may be used to determine the physical location given the host adapter number.

Panics

During driver initialization, when severe errors are detected, the driver will issue one or more warnings. Then the word PANIC will be followed by the message:

   cha: The SCSI adapter driver detected an unrecoverable error
   Correct earlier errors and reboot

One of the previous warning messages from the cha driver will indicate a condition which would prevent successful system boot. The system is stopped to prevent subsequent secondary error messages from causing messages about the primary problem to quickly scroll off the console screen.

Warnings

These messages indicate serious problems which may prevent the driver from operating correctly. They appear on the system console preceded by the word WARNING.

   cha: Unable to allocate memory (x bytes)
   One or more configured SCSI host adapters will be unavailable
   The system needs more memory available to boot this kernel (chaW01)

x is the requested amount of memory in bytes. This message indicates that a request for memory at initialization time has been refused by the kernel. The kernel you are booting is too large to run correctly with the amount of memory detected by the kernel. Be sure your system has sufficient RAM memory and that this memory is configured so that the UNIX kernel can detect it.

   cha: The SCSI controller for the root drive must be host adapter ha=0
   Use Compaq System Configuration Utility
   Change the SCSI Controller from ha=ha to ha=0 slot=slot (chaW09)

The host adapter in this slot was selected during System Configuration to be the hard disk boot controller, but it was not also set to host adapter number 0. UNIX expects the SCSI boot device to be attached to host adapter number 0.

   cha: Compaq SCSI Adapter Failed  slot=slot
   Use Compaq Diagnostics to confirm a hardware failure (chaW11)

The driver has detected failure of the SCSI controller in this slot. Follow standard procedures to locate and repair the failed component.

   cha: Compaq SCSI Adapter detected cabling error  slot=slot
   Check for proper attachment and termination of SCSI cables (chaW12)

A cabling error has caused the driver to detect a SCSI bus termination error. Communication between this host adapter and SCSI peripherals is not permitted.

   cha: Host adapter number ha=ha conflict detected  slot=slot
   This controller will not be enabled
   Use Compaq System Configuration Utility to set host adapter number
   (chaW15)

The host adapter number for this controller is set to the same value as the host adapter number for another controller in this system. UNIX uses this number to uniquely identify a single controller to the driver. The host adapter number for one of these controllers must be changed so that both may be used. Both controllers are currently set to host adapter ha. The controllers is in this slot has been disabled due to the conflict.

Notices

The following messages inform you of conditions which the driver has encountered and handled. They appear on the system console preceded by the word NOTICE.

Although these conditions are abnormal, the driver continues to function normally. The commands may have been retried and completed successfully. If the same message appears multiple times, this may be due to the same command being retried several times with the same result.

If the command was not retried successfully, another driver may subsequently report a related error. All of these conditions are unexpected. Although they may be recoverable, you should attempt to determine their root cause and correct it.

   cha: SCSI data overrun  ha=ha id=id lun=lun cmd=cmd blk=blk len=len
   Data arriving from a SCSI peripheral over-filled storage (chaN00)

A peripheral on the SCSI bus has attempted to send the host more data than was requested.

   cha: Unexpected SCSI disconnect  ha=ha id=id lun=lun cmd=cmd blk=blk
   len=len
   A SCSI peripheral unexpectedly stopped communicating with the host
   (chaN01)

A peripheral on the SCSI bus has disconnected unexpectedly.

   cha: Unexpected SCSI phase  ha=ha id=id lun=lun cmd=cmd blk=blk
   len=len
   A SCSI peripheral behaved unexpectedly
   Use Compaq Diagnostics to confirm a hardware failure (chaN02)

A peripheral on the SCSI bus has made an unexpected phase transition.

   cha: SCSI device has been reset  ha=ha id=id lun=lun
   A SCSI peripheral driver requested this action (chaN03)

A reset command has been sent to a peripheral on the SCSI bus. This host initiated action is usually a response to some other abnormal condition.

   cha: SCSI bus has been reset  ha=ha
   Attached SCSI peripherals will return to power up state (chaN04)

A reset has been sent to the SCSI bus. This host initiated action is usually a response to some other abnormal condition. Each peripheral on the SCSI bus will perform power-on initialization in response to bus reset. SCSI tape devices will immediately rewind.

   cha: SCSI command timed out  ha=ha id=id lun=lun cmd=cmd blk=blk
   len=len
   A SCSI peripheral failed to report completion status in time (chaN05)

A peripheral on the SCSI bus accepted a command from the host but the host did not receive completion status from the peripheral within the maximum time permitted for this command on this class of peripheral.

   cha: SCSI bus parity error  ha=ha id=id lun=lun cmd=cmd blk=blk
   len=len
   The host detected a single bit error on the SCSI bus (chaN06)

A parity error was detected by the host during a transfer over the SCSI bus.

   cha: SCSI data underrun  ha=ha id=id lun=lun cmd=cmd blk=blk len=len
   Data arriving from a SCSI peripheral under-filled storage (chaN07)

A peripheral on the SCSI bus sent the host less data than was requested.

   cha: No host adapter number ha=0 found
   Check your configuration (chaN09)

This may be a configuration error. A SCSI controller may have been disabled or removed. UNIX configures host adapters consecutively starting with 0.

   cha: Some host adapter numbers between ha=ha and ha=ha2 were not found
   Check your configuration (chaN10)

This may be a configuration error. A SCSI controller may have been disabled or removed. UNIX configures host adapters consecutively. The lowest host adapter number detected and enabled by the driver is ha, the highest is ha2.

Files

/etc/conf/pack.d/cha/*
/usr/lib/compaq/cha/*
/dev/cha