radisk(8)radisk(8)NAMEradisk - Digital Storage Architecture (DSA) disk maintenance program
SYNOPSIS
/sbin/radisk -c LBN length special
/sbin/radisk -e special
/sbin/radisk -n special
/sbin/radisk -r LBN special
/sbin/radisk -s LBN length special
OPTIONS
The following options can be used with radisk: Clears a forced error
indicator on the range of specified LBNs. The forced error condition
indicates that the data in the disk block is bad. The disk block is
good, but the data can not be read without getting an error detection
code (EDC) error. This option causes the forced error condition to be
removed. After the forced error indicator is cleared, the EDC error is
not reported nor will the data be marked as bad. The data should be
restored either by manual methods or with the restore command. The
radisk command affects the integrity of the data on a disk and should
be followed by a file system restore if data is affected. Sets the
exclusive access attribute associated with the specified disk. This
attribute is provided by multihost controllers to restrict access to a
disk to one host. The radisk command returns a failure status if the
disk is already exclusively associated with another host or the under‐
lying controller does not provide multihost support. If the command is
issued to a disk that is currently mounted and the command fails, the
disk is no longer on line to this host. For this reason the -e option
should not be issued to a disk that is mounted. Clears the exclusive
access attribute associated with the specified disk. If the controller
provides multihost support and the exclusive access attribute is not
set for a particular disk, it would be possible for the disk to be
accessed by more than one host. The radisk command returns a failure
status if the disk is not currently and exclusively associated with
this host or the underlying controller does not provide multihost sup‐
port. Replaces a block on the disk specified by LBN. See RESTRICTIONS.
Starts a scan for bad blocks on the specified area on a disk. Bad
blocks are disk blocks that have data transfer errors to the extent
that they cannot be relied on. When a bad block is found, it is
replaced and the bad block's LBN is reported. The LBN specified with
the -s option can be 0 to indicate the first block in the specified
partition. If 0 is specified, however, the program starts searching
from the first block of the partition. The -s option accepts any valid
partition on the disk. This allows any partition to be scanned without
scanning the entire disk and ensures that the specified partition is
free of bad blocks. As an example, /dev/rdisk/dsk0h indicates the h
partition of the boot disk, 0.
DESCRIPTION
The radisk Digital Storage Architecture (DSA) disk maintenance program
allows you to maintain DSA disk devices. The radisk command must be
used on unmounted disk partitions to ensure correct results.
The LBN is a decimal number that represents the logical block number as
reported in the errorlog file. The LBN is the actual disk block number
starting from the beginning of the disk.
The length is a decimal number that indicates how many (512 byte)
blocks to process. The length specified can be -1 to indicate the last
block of the specified partition.
The special file specified is used with -c, -e, -n, and -r options and
indicates an unmounted c partition of a character device special file.
RESTRICTIONS
You must be in single-user mode when using the -c, -r, and -s options
of the radisk program. If you are in multiuser mode, radisk hangs the
system and cannot be killed. If this happens, you must reboot.
The -r option is supported only with those DSA disks which use host-
initiated dynamic bad block replacement.
The -e and -n options are only supported on controllers that provide
multi-host support. These options are only supported on HSC Version
5.00 or later.
ERRORS
The radisk program 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.
SEE ALSO
Commands: disklabel(8), mount(8), restore(8)
Networking: ra(7)radisk(8)
