/*
 Copyright 2005 Sun Microsystems, Inc. All rights reserved.
 Use is subject to license terms.
*/

#pragma ident "@(#)README.x86_64 1.4	05/01/18 SMI"


README.64 - SunVTS README file for 64 bit x86 (AMD64) Solaris support
---------

This README file carries information on 64 bit x86 Solaris support for the 
AMD64 based Sun platforms. By default, the 64 bit x86 diagnostics get installed
in the "/bin/64" directory under the base SunVTS install location. The SunVTS 
release for 64 bit x86 Solaris contains the following tests.

pmemtest 	- Physical Memory Test
ramtest  	- Memory DIMMs (RAM) Test  
vmemtest 	- Virtual Memory Test
cddvdtest	- Optical Disk Drive Test
cputest		- CPUtest
disktest	- Disk and Floppy Drives Test
dtlbtest	- Data Translation Look-aside Buffer Test
fputest		- Floating Point Unit Test
l1dcachetest	- Level 1 Data Cache Test
l2sramtest	- Level 2 Cache Test
netlbtest	- Net Loop Back Test
nettest		- Network Hardware Test
serialtest	- Serial Port Test
tapetest	- Tape Drive Test
usbtest		- USB Device Test
systest		- System Test
iobustest	- Test for the IO interconnects and the Components on the IObus on high end Machines


Command Line Options for pmemtest
=================================
Except for the "eccmon" and "threshold" options, all other options are 
supported for 64 bit pmemtest on x86 Solaris.

Test usage syntax
-----------------
./pmemtest -u

CLI Example
-----------
./pmemtest -vf  (runs with default options)


Command Line Options for ramtest
================================
Except for the "eccmonitor", "threshold" and "ssloops" options, all other 
options are supported for 64 bit ramtest on x86 Solaris.

Test usage syntax
-----------------
./ramtest -u

CLI Example
-----------
./ramtest -vx -o reserve=20,stride=Random,\
userstride=1,lock=Disabled,pass=1,dratio=50,\
ntaloops=1,laloops=1,lrloops=1,dev=ram


Command Line Options for vmemtest
=================================
Except for the "eccmon" and "threshold" options, all other options are 
supported for 64 bit vmemtest on x86 Solaris.

Test usage syntax
-----------------
./vmemtest -u

CLI Example
-----------
./vmemtest -vf  (runs with default options)

Command Line Options for cddvdtest
==================================
All the options are supported for 64 bit cddvdtest on x86 Solaris.

Test usage syntax
-----------------
./cddvdtest -u

CLI Example
-----------
	CDROM:
	-----
	dev=raw_device_name,mode=mode,read=random|sequential,\
	data=%_of_data,vol=volume,audio=enable|disable,type=CD_type

	DVDROM:
	------
	dev=device_name,read=random|sequential,data=%_of_data

	CDRW:
	----
	dev=cntndnsn,media=CD-RW,nosim,speed=n,nodata,noaudio,loop=n,\
	close,erase={none,all},eject

	DVDRW:
	-----
	dev=cntndnsn,media={DVD-RW,DVD+RW},nosim,speed=n,\
	imagesize={2MB,10MB,2GB,4GB},erase={none,fast,all},eject

Command Line Options for cputest
=================================
All the options are supported for 64 bit cputest on x86 Solaris.

Test usage syntax
-----------------
./cputest -u

CLI Example
-----------
./cputest -fv -o dev=device_name,count=count_number,test=testlist,size=file_size,retain=mode

Command Line Options for Disktest
==================================
All the options are supported for 64 bit Disktest on x86 Solaris.

Test usage syntax
-----------------
./disktest -u

CLI Example
-----------
	./disktest -sf -o partition=6,rawsub=Enable,rawrw=Readonly,\
	method=SyncIO+AsyncIO ,rawcover=30,rawiosize=32KB,rawpattern=P15,\
	seekpattern=S,seekpoint=I,fssub=Disable,dev=c1t6d0

Command Line Options for dtlbtest
==================================
All the options are supported for 64 bit dtlbtest on x86 Solaris.

Test usage syntax
-----------------
./dtlbtest -u

CLI Example
-----------
dtlbtest -xv (runs with default options)


Command Line Options for fputest
==================================
All the options are supported for 64 bit fputest on x86 Solaris.

Test usage syntax
-----------------
./fputest -u

CLI Example
-----------
./fputest -xv dev=cpu-unit3

Command Line Options for l1dcachetest
=====================================
The Supported options are
	M=0+1+2+3+.+N...   (N = Cpu-id of online CPUs to be tested)
        count=N         (N = Thrash Cycles {1...1024})

Test usage syntax
-----------------
./l1dcachetest -u

CLI Example
-----------
./l1dcachetest -x -o M=8,count=400

Command Line Options for l2sramtest
=====================================
The Supported options are
	dev=l2sram,count=[1..1024],cpc=[Enabled,Disabled]

Test usage syntax
-----------------
./l2sramtest -u

CLI Example
-----------
./l2sramtest -xv	(runs with default options)

Command Line Options for netlbtest
==================================
All the options are supported for 64 bit netlbtest on x86 Solaris.

Test usage syntax
-----------------
./netlbtest -u

CLI Example
-----------
./netlbtest -fv  dev=ge0 (runs with default options)

Command Line Options for Nettest
==================================
All the options are supported for 64 bit nettest on x86 Solaris.

Test usage syntax
-----------------
./nettest -u

CLI Example
-----------
nettest -f -o target=<target_machine>,dev=hme0,test=Random+Increment+Pattern,
                        packets=512,pattern=0xFF,timeout=100,retry=4,warn

Command Line Options for serialtest
===================================
All the options are supported for 64 bit serialtest on x86 Solaris.

Test usage syntax
-----------------
./serialtest -u

CLI Example
-----------
./serialtest -vf -o dev=asy0,T=b,L=P

Command Line Options for tapetest
=================================
All the options are supported for 64 bit tapetest on x86 Solaris.

Test usage syntax
-----------------
./tapetest -u

CLI Example
-----------
./tapetest -fv -o dev=<device name>,s=<block count>,d=<density>,m=<mode>,method=<Syncsync>,
l=<length>,ft=<file test>,ret=<retension>,dat=<dat type>,num=<mag size>,blocksize=<block size>

Command Line Options for usbtest
=================================
All the options are supported for 64 bit usbtest on x86 Solaris.

Test usage syntax
-----------------
./usbtest -u

CLI Example
-----------
./usbtest -cvf -o dev=dev-name, getdevid=Enable|Disable, printer=Enable|Disable, data=ascii,
  postscript, delay=0-86400, M=Enable|Disable, O=speaker|headphone|line-out,V=0-255, MF=musicfilename

Command Line Options for iobustest
=================================
All the options are supported for 64 bit iobustest on x86 Solaris.

Test usage syntax
-----------------
./iobustest -u

CLI Example
-----------
./iobustest -xv -o dev=iobus

Command Line Options for systest
=================================
systest not built in 64-bit mode but running in 64-it mode by pointing to the 32-bit test binaries

Test usage syntax
-----------------
./systest -u

CLI Example
-----------
./systest -xv   (runs with default options)

Please refer to the SunVTS test reference manual for details on each of these 
diagnostics. 
