/* 
* Copyright (c) 2001 by Sun Microsystems, Inc.
# All rights reserved.
#
#
*/ 

TEST NAME 

      mpflip - flip processors on and off

SYNOPSIS 

      sh mpflip.sh PAUSE

DESCRIPTION 

      This test repeatedly flips additional processors in a system on and off.

OPERANDS 

      PAUSE   Length of time (in seconds) between which processors in the 
              sytem are flipped on and off. If you do not specify PAUSE, the 
              length of time between which processors are flipped is 1 second, 
	      by default.

USAGE VARIABLES 

      RUNTIME   This environment variable specifies, in seconds, the duration 
                of the test.

OUTPUT 

      This test lists the processors as they are toggled.

DURATION 

      As long as the other concurrent tests run

POSSIBLE CONCURRENT TESTS 

      * This test should be run alongside a stress/functional test to further
        the stress placed on the driver.

      * This test runs with other tests without conflict.

NOTES 

      * To run this test, you must be logged in as root. 

      * All processors are returned to ON state when interrupted. 

EXAMPLES 

      # RUNTIME=30
      # export RUNTIME
      # ./mpflip.sh 2
      2

      Using inter-flip pause of 2 seconds.
      Running time: 30 seconds

      Starting to loop thru processors...

      Found 4 processor(s) on-line.
      Found 4 processor(s) in the system.

      Taking processor #1 off-line:Done
      Taking processor #2 off-line:Done
      Taking processor #3 off-line:Done
      Putting processor #3 on-line:Done
      Putting processor #2 on-line:Done
      Putting processor #1 on-line:Done
      Taking processor #1 off-line:Done
      Taking processor #2 off-line:Done
      Taking processor #3 off-line:Done
      Putting processor #3 on-line:Done
      Putting processor #2 on-line:Done
      Putting processor #1 on-line:Done
      Taking processor #1 off-line:Done
      Taking processor #2 off-line:Done
      Taking processor #3 off-line:Done
      PASS: no problems in mpflip

      Resetting processors...
      #

REFERENCES 

      mpstat(1M), psradm(1M), psrinfo(1M)
