  Copyright(c) 1999 Sun Microsystems, Inc.
  All rights reserved.

  "@(#)cpudatatest.txt  1.2  99/01/27  SMI"



CPU Data Test (cpudatatest)
---------------------------

cpudatatest checks a processor's ability to 
to correctly execute a compress/uncompress
command sequence on machines with the SPARC V9 
based architecture.

It was developed to augment the existing sunvts
test suite in response to:
	Service Order:		5146606
	Escalation:		515948
	BugId:			4159925

Related documentation: 
	patch README file:	README.107237-01

cpudatatest Test Parameter Options 
----------------------------------

	none (unless run from command line, see below)

cpudatatest Test Modes
---------------------- 

	Test Mode	# of Iterations
	------------    --------------
	Connectivity 		    64
	Online      		   128
	Offline     		   256
 

cpudatatest Command Line Syntax
-------------------------------

general syntax:	/opt/SUNWvts/bin/cpudatatest [standard arguments] -o cpuid=n

	cpuid=n	n: bind test to processor n where n={0..31} 

example:	/opt/SUNWvts/bin/cpudatatest -o cpuid=5

	runs/binds cpudatatest to processor 5. Note: it will
	exit with an error if processor 5 is not active or non-
	existent OR if the user is not superuser.


cpudatatest Error Messages
--------------------------

Error Message			Probable Cause		Recommended Action
-----------------------------  ----------------------   ------------------
6001	Data Test failed	Faulty CPU Module	Contact your Sun 
	iteration value;				service provider.
	          ----- 
	Processor whose 
	cpu_id = value is
		 ----- 
	suspected cause.
 
8000	Please enter an 	An incorrect parameter	Enter correct value.
	appropriate value, 	value was enter for
	string=?		parameter named
	------			string.
				------

8002	unable to bind to 	value cpu may be offline 
	cpu=value: string	-----
	    -----  ------	or non-existent. string
					         ------
				may offer addtional
				explanation.

8004	system call string 	
	           -------
	failed with : string
		      ------

8005	exec'd program string	
		       ------
	failed with code value
			 -----

8007	bin_probe: argument 	An internal program	
	error			error.

8008	bin_probe() string	Required command not 	Make sure that compress,
		    ------	in /usr/bin or access	uncompress, cmp, and rm
	unavailable because: 	permission issue.	are in /usr/bin. Also,
	string						Check permissions.
	------

8010	Unable to create file	/tmp is full or access	Check that /tmp is
	string			permission issue.	not full and that
	------						it is writeable.

8011	Unable to allocate 	A memory resource issue.
	value byte buffer for 
	-----
	string
	------

8012	Unable to write value	A disk resource or	See 8010 above.
			-----	access issue.
	bytes to string
		 ------

8013	NOT Superuser; MUST be 				Become superuser.
	superuser to run this 
	program"


Note: If error message 6001 occurs then cpudatatest has detected a
      faulty module with the kind of failure which cpudatatest was
      designed to detect. All of the 80xx failures are fatal to 
      cpudatatest operation, but are not neccessarily indicative of
      of a faulty module.


