radisk(8)						      System Manager's Manual							 radisk(8)

NAME

       radisk - 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
       underlying 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  pro-
       vide  multihost	support.   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)