NAME

envdiag − Environment Monitor Board Diagnostic Tests

SYNOPSIS

envdiag [−s] [−h] [−i] [−t seconds]

DESCRIPTION

envdiag provides diagnostic tests for the Environment Monitor Board (ENVMON).  These tests are used by the GOLD tests.  Each of these is executed by invoking a particular option to the envdiag executable.  Multiple options may be given on the command line.  Once a particular request fails, no others are attempted.  If the −t option is given, the test loop is not entered if the board is determined to be unhealthy.  Once the loop is entered, the tests continue until the time period expires and the number of failures and iterations is printed.  envdiag prints "TEST PASSED" if all tests pass, and "TEST FAILED" if any test fails.  If the −s option is the only option given on the command line, then the PASS/FAIL message is not printed. 

The −s option is run prior to any of the tests if it is given on the command line.  Beyond that, the user may make no assumption about the order of execution of the various tests. 

At least one option must be given.  If the −t option is given, then the −h or −i option must be given. 

Use of this command is restricted to the superuser. 

OPTIONS

−h This option checks for ENVMON board health.  If the test can successfully open the device (all chassis), and the transition board is properly connected (Delta chassis), then the board is healthy.  This test returns 0 if the ENVMON board is healthy, 1 if it is unhealthy, 2 if the ENVMON board is nonexistent, and 3 if an unexpected error occurs. 

−i This option causes a test interrupt to be generated and received.  If the test interrupt is not received within a period of 20 seconds, then the test fails.  If multiple successive interrupt tests are performed, each test after the first will take around 10 seconds to complete as it waits for the ENVMON driver to complete the 10 second interrupt timeout.  This test returns 0 if the test interrupt passes, 1 if the ENVMON board is unhealthy or the test interrupt times out, 2 if the ENVMON board is nonexistent, and 3 if an unexpected error occurs. 

−s This option displays the current state and configuration of the ENVMON board.  The information is displayed prior to running any test.  This test returns 0 if the ENVMON board is healthy, 1 if it is unhealthy, 2 if the ENVMON board is nonexistent, and 3 if an unexpected error occurs. 

−t <seconds>
This option runs the requested tests for the given number of seconds. A failure in any test at any time causes a failed return value.  The test prints the number of iterations and the number of failures for each test at the end of the time period. Negative values of seconds are not allowed. This test returns 0 if all tests were successful, 1 if any failed, 2 if the ENVMON board is nonexistent, and 3 if an unexpected error occurs.

FILES

/dev/envmon_c0
/etc/master.d/envmon
/usr/include/sys/envmon.h

SEE ALSO

envctl(1M), envmon(1M), envmon(7)

Delta chassis: Environment Monitor Board Set User Guide (ENVMON/D1)
Series 900 chassis: Series 900 Reference Guide (S900RF/D2)

DIAGNOSTICS

The envdiag command exits with one of the following values. 

0 The command was executed successfully. 

1 The ENVMON board is not healthy. 

2 The ENVMON board is nonexistent. 

3 An unexpected error occurred.  The failure is described by the printed message.