vxr5check

NAME

vxr5check - verify RAID-5 volume parity

SYNOPSIS

DESCRIPTION

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

-g diskgroup

Specifies the VERITAS Volume Manager (VxVM) disk group name for the RAID-5 volume name for verification. If this option is not specified, the default disk group is determined using the rules given in the vxdg(1M) manual page.

-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

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

/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

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 prevented further execution of the utility.

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

NOTES

Do not run vxr5check on a volume that is in degraded mode.

SEE ALSO

vxevac (1M), vxintro (1M), vxmend (1M), vxvol (1M)