addbadsec(1M) System Administration Commands addbadsec(1M)NAMEaddbadsec - map out defective disk blocks
SYNOPSISaddbadsec [-p] [ -a blkno [blkno...]] [-f filename] raw_device
DESCRIPTIONaddbadsec is used by the system administrator to map out bad disk
blocks. Normally, these blocks are identified during surface analysis,
but occasionally the disk subsystem reports unrecoverable data errors
indicating a bad block. A block number reported in this way can be fed
directly into addbadsec, and the block will be remapped. addbadsec will
first attempt hardware remapping. This is supported on SCSI drives and
takes place at the disk hardware level. If the target is an IDE drive,
then software remapping is used. In order for software remapping to
succeed, the partition must contain an alternate slice and there must
be room in this slice to perform the mapping.
It should be understood that bad blocks lead to data loss. Remapping a
defective block does not repair a damaged file. If a bad block occurs
to a disk-resident file system structure such as a superblock, the
entire slice might have to be recovered from a backup.
OPTIONS
The following options are supported:
-a Adds the specified blocks to the hardware or software map. If
more than one block number is specified, the entire list
should be quoted and block numbers should be separated by
white space.
-f Adds the specified blocks to the hardware or software map. The
bad blocks are listed, one per line, in the specified file.
-p Causes addbadsec to print the current software map. The output
shows the defective block and the assigned alternate. This
option cannot be used to print the hardware map.
OPERANDS
The following operand is supported:
raw_device The address of the disk drive (see FILES).
FILES
The raw device should be /dev/rdsk/c?[t?]d?p0. See disks(1M) for an
explanation of SCSI and IDE device naming conventions.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Architecture │x86 │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWcsu │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOdisks(1M), diskscan(1M), fdisk(1M), fmthard(1M), format(1M),
attributes(5)NOTES
The format(1M) utility is available to format, label, analyze, and
repair SCSI disks. This utility is included with the addbadsec,
diskscan(1M), fdisk(1M), and fmthard(1M) commands available for x86. To
format an IDE disk, use the DOS "format" utility; however, to label,
analyze, or repair IDE disks on x86 systems, use the Solaris format(1M)
utility.
SunOS 5.10 24 Feb 1998 addbadsec(1M)
