apr(1M)                                                             apr(1M)

NAME
     apr - array parity repair

SYNOPSIS
     apr -z hw-addr [-f file]

DESCRIPTION
     apr provides a means for repairing parity inconsistencies in the array
     that may have come about due to unrecovered power failures, system
     crashes, or controller failures.

     The input to apr is a list of SCSI logical block addresses which were
     found to have parity inconsistencies.

     The argument hw-addr is a string of characters giving the hardware
     address of the LUN to be repaired. hw-addr has the following form:

          iosb/sraidppull

     The naming conventions are as follows:

     b    RM400: 0 (on-board iobus) or 1 (peripheral bus)

          RM600: always 0

     pp   RM400: the SCSI Host Adaptor port number

          RM600: the logical controller number

     u    the device's unit number

     l    the logical unit name; this may range from 0 to 7

     Some examples of valid hardware address notation:

     ios0/sraid041l0
          system bus 0, host controller 04, unit number 1, LUN 0

     ios0/sraid043l0
          system bus 0, host controller 04, unit number 3, LUN 0

OPTIONS
     -f file
          Name of the input file from which the list of blocks to be
          repaired is read. If this option is omitted, the list is read
          from standard input.









Page 1                       Reliant UNIX 5.44                Printed 11/98

apr(1M)                                                             apr(1M)

EXIT STATUS
     0 =  Error-free termination

     1 =  Command line syntax error

     2 =  Argument not in acceptable range

     3 =  Error opening a file or device

     4 =  SCSI-bus or SCSI-device-related error condition

     5 =  Non-specific error

     6 =  Insufficient memory

     8 =  Inappropriate device or system state

NOTES
     Invoking apr with invalid arguments will cause usage information to be
     displayed.

     With release 3.0 of the array controller software, it is not necessary
     for apr to acquire exclusive access to the logical unit to be
     repaired, meaning parity repairs can be done without requiring that
     filesystems be unmounted. If the array controller is running an ear-
     lier version of software, it will still be necessary to unmount
     filesystems before attempting to repair parity.

     When fixing parity by the method of reading and re-writing the data,
     apr will go ahead and re-write the data even if an error was returned
     on the read.

SEE ALSO
     acf(1M), apc(1M), arc(1M), can(1M), lad(1M).




















Page 2                       Reliant UNIX 5.44                Printed 11/98