vxr5check(1M)                    VxVM 3.5                     vxr5check(1M)
                                 1 Jun 2002



 NAME    [Toc]    [Back]
      vxr5check - verify RAID-5 volume parity

 SYNOPSIS    [Toc]    [Back]
      /etc/vx/bin/vxr5check [-i | -v] [-g diskgroup] volume

 DESCRIPTION    [Toc]    [Back]
      The vxr5check utility compares the parity of each stripe of a RAID-5
      volume specified by volume.  vxr5check reads the data for each stripe,
      generates the parity for this stripe, and compares this parity with
      the existing parity.

      vxr5check can be run against the entire RAID-5 volume, or
      incrementally on RAID-5 stripe boundaries, by specifying the -i
      option.

 OPTIONS    [Toc]    [Back]
      -g diskgroup
                Specifies the VERITAS Volume Manager (VxVM) disk group name
                for the RAID-5 volume name for verification.  If a disk
                group name is not specified, the rootdg disk group is
                assumed as the default.

      -i        Verifies the RAID-5 volume incrementally per stripes.  If a
                parity mismatch is found, that stripe location is displayed.

      -v        Verbose output for the incremental vxr5check verification.
                The verbose option outputs each stripe number that is being
                verified.

 OUTPUT FORMAT    [Toc]    [Back]
      In verbose mode and incremental mode, summary reports for each stripe
      of the RAID-5 volume are printed in output records.  If an error is
      returned for a stripe, then an error message and stripe number are
      displayed.  In non-verbose mode, if an error is returned, an error
      message is displayed.

      If a parity mismatch error is determined on a stripe, vxr5check exits
      on that stripe and does not continue for the remaining stripes in the
      RAID-5 volume.

 FILES    [Toc]    [Back]
      /usr/lib/vxvm/bin/vxr5vrfy    The utility that vxr5check calls to
                                    perform RAID-5 parity verification
                                    operations for the specified RAID-5
                                    volume.

 EXIT CODES    [Toc]    [Back]
      The vxr5check utility exits with a non-zero status if the attempted
      operation fails.  A non-zero exit code is not a complete indicator of
      the problems encountered, but rather denotes the first condition that



                                    - 1 -       Formatted:  January 24, 2005






 vxr5check(1M)                    VxVM 3.5                     vxr5check(1M)
                                 1 Jun 2002



      prevented further execution of the utility.

      See vxintro(1M) for a list of standard exit codes.

 NOTES    [Toc]    [Back]
      Do not run vxr5check on a volume that is in degraded mode.

 SEE ALSO    [Toc]    [Back]
      vxevac(1M), vxintro(1M), vxmend(1M), vxvol(1M)


                                    - 2 -       Formatted:  January 24, 2005