............................Contents


*Part 1--Running SunDiag*
1. Introducing the SunDiag System Exerciser	1-1
....1.1 Overview	1-1
....1.2 Hardware and Software Requirements	1-3
......1.2.1 OpenWindows Software Requirements	1-3
......1.2.2 Special Note on Testing Multiple Framebuffers	1-4
......1.2.3 Volume Management	1-5
......1.2.4 Booting and New Device Drivers	1-6
......1.2.5 Swap Space Requirements	1-7
......1.2.6 Setting the Maximum Number of Processes	1-8
......1.2.7 Loopback Connectors	1-10
......1.2.8 Scratch CDs, Tapes, Diskettes	1-10
......1.2.9 TTY Terminals	1-10
....1.3 Preparing to Start the SunDiag Exerciser	1-11
....1.4 Starting the SunDiag Exerciser	1-12


....1.5 Stopping the SunDiag Exerciser	1-13
....1.6 Using Batch Files	1-14
....1.7 Running the SunDiag Exerciser on a Remote System	1-15
....1.8 Running the SunDiag Exerciser on a Stand-alone System	1-16
....1.9 Adding Your Own Tests in `.usertest`	1-17
......1.9.1 Setting up a `.usertest` file	1-17
......1.9.2 Test Writing Precautions	1-18
...1.10 SunDiag Exit Status Codes	1-19
2. The SunDiag OPEN LOOK Interface	2-1
....2.1 SunDiag Main Window	2-3
......2.1.1 System Status Panel	2-3
......2.1.2 Console Window	2-5
......2.1.3 Performance Monitor Panel	2-6
......2.1.4 Control Panel	2-7
....2.2 Setting SunDiag Options	2-10
......2.2.1 Start/Stop Button	2-10
......2.2.2 Reset/Suspend/Resume Button	2-10
......2.2.3 Print Button	2-10
......2.2.4 Log Files Window Button	2-11
....2.3 Changing Individual Test Options	2-25
......2.3.1 Options Menu Buttons	2-26
....2.4 Running the SunDiag Program from an Icon	2-28
3. The SunDiag TTY Interface	3-1
....3.1 Using the SunDiag Program from a Terminal	3-2


......3.1.1 Starting TTY Mode from a Shell Tool	3-2
......3.1.2 Executing Commands in TTY Mode --
...........Use the Abbreviations	3-2
......3.1.3 Navigating the Screens	3-3
......3.1.4 Main Display Commands	3-4
......3.1.5 Scrolling	3-6
......3.1.6 Redrawing the Screen	3-6
......3.1.7 Running the SunDiag Exerciser in the Background	3-7
......3.1.8 Enabling and Disabling Individual Tests	3-7
....3.2 Options Menu	3-8
....3.3 System Status Display	3-11
......3.3.1 Status View Equivalents	3-12
....3.4 Option Files Menu	3-13
....3.5 Log Files Menu	3-15
....3.6 Setting Individual Test Options in TTY Mode	3-18
....3.7 Setting Processor Affinity Masks in TTY Mode	3-20
4. Scaling SunDiag Hardware Tests	4-1
....4.1 Scalability Options	4-1
......4.1.1 Scalable Tests	4-1
......4.1.2 Non-scalable Tests	4-2
......4.1.3 Setting Scalable Test Options	4-2
......4.1.4 Setting Your Own Scalable Tests	4-2
......4.1.5 Test Instances	4-3
......4.1.6 Processor Affinity Mask	4-3


....4.2 A Scalability Example	4-4
........· How to Set up Scalable Testing	4-7
5. Running Individual SunDiag Tests
...from the Command Line	5-1
....5.1 Standard Arguments	5-1
......5.1.1 Tests Supported by the Command Line Interface	5-3
....5.2 Running SunDiag Tests - Overview	5-4
*Part 2--SunDiag Tests*
6. SunDiag Test Descriptions	6-1
....6.1 Physical Memory Test (`pmem`)	6-2
......6.1.1 `pmem` Test Description	6-2
......6.1.2 `pmem` Option Menu	6-2
......6.1.3 `pmem` Configurations	6-3
......6.1.4 `pmem` Command Line Syntax	6-3
......6.1.5 `pmem` Quick Test Description	6-3
....6.2 Virtual Memory Test (`vmem`)	6-3
......6.2.1 Swap Space Considerations	6-3
......6.2.2 `vmem` Test Description	6-4
......6.2.3 `vmem` Option Menu	6-4
......6.2.4 `vmem` Configurations	6-5
......6.2.5 `vmem` Options	6-5
......6.2.6 `vmem` Command Line Syntax	6-5
......6.2.7 `vmem` Quick Test Description	6-6
....6.3 Floating Point Unit Test (`fputest`)	6-6


......6.3.1 `fputest` Command Line Syntax	6-7
......6.3.2 `fputest` Quick Test Description	6-7
....6.4 Network Hardware Test (`nettest`)	6-7
......6.4.1 `nettest` Test Description	6-7
......6.4.2 `nettest` Option Menu	6-9
......6.4.3 `nettest` Configurations	6-10
......6.4.4 `nettest` Options	6-10
......6.4.5 `nettest` Command Line Syntax	6-11
......6.4.6 `nettest` Quick Test Description	6-11
......6.4.7 `nettest` Error Messages	6-12
....6.5 Audio Hardware Test (`autest`)	6-13
......6.5.1 `autest` Option Menu	6-13
......6.5.2 `autest` Command Line Syntax	6-14
......6.5.3 `autest` Quick Test Description	6-14
....6.6 Multiprocessing Test (`mptest`)	6-14
......6.6.1 `mptest` Test Description	6-14
......6.6.2 `mptest` Option Menu	6-15
......6.6.3 `mptest` Options	6-16
......6.6.4 `mptest` Command Line Syntax	6-18
......6.6.5 `mptest` Quick Test Description	6-19
......6.6.6 `mptest` Error Messages	6-19
....6.7 Disk Test (`rawtest`)	6-20
......6.7.1 `rawtest` Test Description	6-21
......6.7.2 `rawtest` Option Menu	6-22


......6.7.3 `rawtest` Options	6-23
......6.7.4 `rawtest` Command Line Syntax	6-23
......6.7.5 `rawtest` Quick Test Description	6-24
....6.8 File-system Test (`fstest`)	6-24
......6.8.1 `fstest` Test Description	6-24
......6.8.2 `fstest` Option Menu	6-25
......6.8.3 `fstest` Options	6-26
......6.8.4 `fstest` Command Line Syntax	6-27
......6.8.5 `fstest` Quick Test Description	6-27
....6.9 Compact Disc Test (`cdtest`)	6-28
......6.9.1 `cdtest` Option Menu	6-29
......6.9.2 `cdtest` Options	6-30
......6.9.3 `cdtest` Command Line Syntax	6-31
......6.9.4 `cdtest` Quick Test Description	6-31
...6.10 Tape Drive Test (`tapetest`)	6-32
......6.10.1 `tapetest` Options	6-36
......6.10.2 `tapetest` Command Line Syntax	6-38
......6.10.3 `tapetest` Quick Test Description	6-39
...6.11 Framebuffer Test (`fbtest`)	6-39
......6.11.1 `fbtest` Command Line Syntax	6-39
......6.11.2 `fbtest` Error Messages	6-40
......6.11.3 `fbtest` Quick Test Description	6-40
...6.12 Serial Ports Test (`sptest`)	6-40
......6.12.1 `sptest` Test Description	6-40


......6.12.2 `sptest` Syncloop Testing	6-40
......6.12.3 `sptest` Option Menus	6-42
......6.12.4 `sptest` Options	6-43
......6.12.5 `sptest` Command Line Syntax	6-45
......6.12.6 `sptest` Quick Test description	6-46
A. Developing Your Own Tests	A-1
...A.1 How to Use This Appendix	A-1
...A.2 Test Design Guidelines	A-2
...A.3 Test Implementation Guidelines	A-4
......A.3.1 The SunDiag Programming Environment	A-4
...A.4 Requirements	A-8
...A.5 Standard Library Routines	A-11
......A.5.1 Standard Command Line Arguments	A-15
......A.5.2 Standard Formats Display	A-16
...A.6 A Sample Test File	A-17
...A.7 A Sample Makefile	A-22
B. Loopback Connectors	B-1
....B.1 25-Pin RS-232 Loopback Plug	B-4
....B.2 25-pin RS-232 Port-to-Port Loopback Cable	B-5
....B.3 8-Pin to 8-Pin Loopback Cable	B-6
....B.4 8-Pin Loopback Plug	B-7
....B.5 25-pin Port A-to-Port B Loopback Plug	B-8
....B.6 25-pin Port A-to-A Port B-to-B Loopback Plug	B-9
C. The `what_rev` Utility	C-1