NAME

nvutil - RAID controller NVSRAM validation and modification utility

SYNOPSIS

nvutil -v [ -q ] [ -f ] [ -s ] [ device ]

nvutil -o [ -q ] offset_range1 [ , offset_range2 ... ] [ device ]

nvutil -o [ -q ] offset1=value1 [ , offset2=value2 ... ] [ device ]

DESCRIPTION

nvutil is a utility for RAID controller NVSRAM management. It will: (1) validate that controllers are set up in accordance with the requirements of the RAID management software,

(2) "fix" any NVSRAM settings that don't meet the requirements, (3) display the value of an arbitrary NVSRAM offset, and

(4) modify the value at an arbitrary NVSRAM offset.

The optional device argument is the (system)name of a particular RAID controller to which the command applies; if ommitted, the command applies to all attached RAID devices.

COMMAND LINE PARAMETERS

-f

Fix any NVSRAM settings that are not in accordance with the requirements; always done before any -o options are executed.

-o

The argument can be in the form offset_range or offset=value. In the former case, nvutil displays all NVSRAM values in the range, which can be a single decimal number or two decimal numbers separated by a hyphen. The display output is one line per offset, per controller, formatted in this manner: <device>

<offset>

<value>

Offsets for the same controller are listed together in ascending order, with a newline character separating different controllers.

The second form of the -o argument means that the device's NVSRAM should be modified at the decimal offset to contain the indicated value, also in decimal.

-q

Operate in "quiet" mode, which generally suppresses output to stdout, without affecting notification to logs, console, etc.

-s

Send a status change notice if invalid NVSRAM settings are found.

-v

Validate that the controller(s) have the proper NVSRAM settings; always done before any -o options are executed.

EXIT STATUSES

0 - Error-free termination

1 - Error termination (event log will contain error)

NOTES

Invoking

nvutil with no arguments or with an unrecognized function key letter will cause usage information to be displayed.

EXAMPLES

1. nvutil -v c0t1d0s0

   Validate NVSRAM settings of controller "c0t1".

2. nvutil -vfq c1t5d0s0

   Validate and fix if necessary NVSRAM settings of controller "c1t5". (operate in "quiet" mode)

3. nvutil -vf

   Validate and fix NVSRAM settings of all attached controllers.

4. nvutil -o 4,6,2,60-63 c2t2d0s0

   Display NVSRAM values at offset 2, 4, 6 and in the range 60-63 of controler "c2t2".

5. nvutil -o 2=3, 4=0, 45=2

   Set NVSRAM bytes at offset 2 to the value 3, at offset 4 to the value 0, and at offset 45 to the value 2 on all controllers.