NAME

rzdisk − SCSI disk maintenance utility

SYNTAX

/etc/rzdisk /etc/rzdisk −f [ vendor | known ] special
/etc/rzdisk −h
/etc/rzdisk −r LBN special
/etc/rzdisk −s LBN length special

DESCRIPTION

The rzdisk utility, SCSI disk maintenance program, formats a SCSI disk, scans a SCSI disk for bad blocks, and reassigns bad blocks on a SCSI disk.

The special file argument is a raw device pathname.  When used with the −f, −r, or −s option, you should specify an unmounted c partition of a character device special file (/dev/rrz3c, for example). 

OPTIONS

−fUse this option to format a SCSI disk (see RESTRICTIONS).  Note that DIGITAL ships the SCSI disk already formatted; you need to use this option only if you have encountered a serious problem and must reformat the disk.  You can format a disk with the vendor (manufacturer) defect list or with the known (vendor and grown) defect list.  The grown defect list contains any blocks that may have been reassigned during the life of the SCSI disk drive.  When formatting a disk, you must specify the raw device pathname. 

The following example reformats the disk on drive 3 using the known defect list:

/etc/rzdisk −f known /dev/rrz3c

−hUse this option to call the HELP menu to the screen. 

−rUse this option to reassign a bad block on the disk (see RESTRICTIONS). 

When reassinging a bad block, you must specify the LBN, which is a unique number (decimal notation) that represents the disk block as reported in the errorlog file, and the raw device pathname. 

The following example reassigns block 222658 on the c partition of drive 3:

/etc/rzdisk −r 222658 /dev/rrz3c

−sUse this option to scan for bad blocks on a specified area of the disk. 

When scanning a disk, you must specify the LBN, which is a unique number (decimal notation) that represents the disk block relative to the start of the partition, the length, and the raw device pathname of the partition to scan. 

To start scanning from the first block of the specified partition, use the number 0 to represent the LBN.  When 0 is specified, the scan starts at the first block of the specified partition. 

The length is a decimal number that indicates how many 512-byte blocks to scan.  To scan up to and including the last block of the specified partition, use the number −l to represent the length.  By specifying the length, you define the scope of the scan within the identified partition. 

The following example scans the first ten blocks of the entire disk (c partition) on drive 3:

/etc/rzdisk −s /dev/rrz3c 0 10

The following example scans the entire disk (c partion) on drive 3:

/etc/rzdisk −s /dev/rrz3c 0 −1

DIAGNOSTICS

The rzdisk command generates messages when the user is not privileged, when the LBN is not in the specified partition, and when the length exceeds the size of the partition.

RESTRICTIONS

You must have superuser privileges to run the rzdisk program.

You should not format your system disk. 

The system should be in single-user mode when running the rzdisk program.

Use the −f option with caution and only if the disk drive seems corrupted.  Be aware that when you format a disk, all resident data is destroyed. 

The −r option is supported only with those SCSI disks that support the reassign block command. 

SEE ALSO

dkio(4), rz(4), chpt(8), mount(8), restore(8), uerf(8)
Guide to the Error Logger System
 

Maintenance