scsidisk(HW)


scsidisk: Sdsk -- SCSI hard disk (obsolete)

Description


NOTE: The information on this page is provided for compatibility with applications built on previous releases. See the sdi(HW) and sc01(HW) manual page for a description of the Release 6 interface, which also supports the functionality described on this page.

Sdsk is the peripheral device driver for SCSI hard disks.

SCSI hard disks, although very reliable, suffer from physical defects like any other magnetic media. These defects cause soft errors where data loss is recoverable, and hard errors where data loss is irrecoverable. SCSI disk controllers that support an error correction code (ECC) typically can correct at least 15 to 25 incorrect bits per sector; this is known as their correction span. A hard error is reported if the number of incorrect bits is greater than the correction span.

Most SCSI disk controllers allow bad blocks to be remapped to good blocks on the disk; note that these are SCSI logical blocks not filesystem logical blocks. (SCSI logical blocks can range from 48 to 4096 bytes in size depending on the manufacturer. The logical block size is usually set to 512 bytes when the disk is formatted.) The logical addresses of bad blocks are added to the disk's grown defect list (G-List). Whenever a bad block is accessed, the disk controller invisibly remaps the request to the good block. The manufacturer's defect list or primary defect list (P-List) is written to the disk during its manufacture and is unchangeable.

Depending on the disk controller, it may be possible to configure it to add defects to the G-List automatically using Automatic Write Relocation (AWR) and Automatic Read Relocation (ARR). These are SCSI-2 features that reallocate bad blocks on detecting any soft error. It is usually undesirable to reallocate soft errors since these may be as small as a single incorrect bit; if provided, the ECC should be capable of correcting such errors.

The driver cannot recover from hard errors that occur while reading from disk. Such errors mean that data has almost certainly been lost. The default action of the driver is to report these errors to the system administrator as a WARNING message (see messages(M) for more details).

Tuning error reporting

You can tune the system-wide level of soft and hard error reporting by editing the value of the variable Sdsk_verbosity defined in the file /etc/conf/pack.d/Sdsk/space.c. This is set to one of the following values defined in the header file /usr/include/sys/Sdsk.h:

Sdsk_verbosity values

Setting Errors reported
SDSK_V_NONE none
SDSK_V_HARD unrecoverable hard errors only
SDSK_V_WARN recoverable soft errors, and unrecoverable hard errors
SDSK_V_ALL all

 +------------+-------------------------------------------------+
 |Setting     | Errors reported                                 |
 +------------+-------------------------------------------------+
 |SDSK_V_NONE | none                                            |
 +------------+-------------------------------------------------+
 |SDSK_V_HARD | unrecoverable hard errors only                  |
 +------------+-------------------------------------------------+
 |SDSK_V_WARN | recoverable soft errors, and unrecoverable hard |
 |            | errors                                          |
 +------------+-------------------------------------------------+
 |SDSK_V_ALL  | all                                             |
 +------------+-------------------------------------------------+
The default setting of Sdsk_verbosity is SDSK_V_HARD which is applied to all spindles. You must relink and reboot a new kernel to make a new setting take effect.

Diagnostics

The following error messages may be displayed on the console. See the messages(M) manual page for general information about kernel error messages, including a list of generic device driver errors.

NOTICE: Sdsk, Spurious interrupt
No command was pending when an interrupt was received.
WARNING: Sdsk: Bad block size
         SDsk: Block size (n) must be between NBPSCTR and SBUFSIZE
The block size on the device has been found to be outside the allowed limits.

Limitations

In extreme cases, reallocation of bad blocks may take several tens of seconds. This is solely a function of the hardware being used.

See also

hd(HW), ioctl(S), messages(M), mscsi(F), scsi(HW)
© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 -- 03 June 2005