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


Preface	xvii
...Ordering Sun Documents	xxi
1. Overview	1
...Features of OpenBoot	1
...The User Interface	2
...The Device Tree	3
......Device Path Names, Addresses, and Arguments	4
......Device Aliases	6
......Displaying the Device Tree	7
...Getting Help	10
...A Caution About Using Some OpenBoot Commands	11
2. Booting and Testing Your System	13
...Booting Your System	13
......Booting for the Casual User	15
......Booting for the Expert User	15


...Running Diagnostics	19
......Testing the SCSI Bus	20
......Testing Installed Devices	20
......Testing the Diskette Drive	21
......Testing Memory	21
......Testing the Clock	22
......Testing the Network Controller	22
......Monitoring the Network	23
...Displaying System Information	23
...Resetting the System	24
3. Setting Configuration Variables	25
...Displaying and Changing Variable Settings	27
...Setting Security Variables	30
......Command Security	30
...... Full Security	31
...Changing the Power-on Banner	32
...Input and Output Control	34
......Selecting Input and Output Device Options	35
......Serial Port Characteristics	36
...Selecting Boot Options	36
...Controlling Power-on Self-Test (POST)	36
...Using nvramrc	38
......Editing the Contents of the Script	39
......Activating the Script	40


4. Using Forth Tools	43
...Forth Commands	44
...Data Types	45
...Using Numbers	46
...The Stack	47
......Displaying Stack Contents	47
......The Stack Diagram	48
......Manipulating the Stack	51
...Creating Custom Definitions	52
...Using Arithmetic Functions	54
......Single-Precision Integer Arithmetic	54
......Double Number Arithmetic	55
......Data Type Conversion	56
......Address Arithmetic	57
...Accessing Memory	58
......Virtual Memory	58
......Device Registers	62
...Using Defining Words	63
...Searching the Dictionary	66
...Compiling Data Into the Dictionary	68
...Displaying Numbers	69
...Changing the Number Base	70
...Controlling Text Input and Output	71
...Redirecting Input and Output	74


...Command Line Editor	76
...Conditional Flags	78
...Control Commands	79
......The if...else...then Structure	79
......The case Statement	81
......The begin Loop	82
......The do Loop	83
......Additional Control Commands	86
5. Loading and Executing Programs	87
...Using boot	89
...Using dl to Load Forth Text Files Over Serial Port A	89
...Using load	90
...Using dlbin to Load FCode or Binary Executables Over Serial Port
......A	92
...Using dload to Load From Ethernet	93
......Forth Programs	93
......FCode Programs	94
......Binary Executables	94
...Using ?go	94
6. Debugging	95
...Using the Forth Language Decompiler	95
...Using the Disassembler	97
...Displaying Registers	97
......SPARC Registers	98


...Breakpoints	100
...The Forth Source-Level Debugger	101
...Using `patch` and `(patch)`	103
...Using ftrace	106
A. Setting Up a TIP Connection	107
...Common Problems With TIP	110
B. Building a Bootable Floppy Disk	111
C. Troubleshooting Guide	113
...Power-on Initialization Sequence	113
...Emergency Procedures	115
...Preserving Data After a System Crash	115
...Common Failures	116
......Blank Screen --No Output	116
......System Boots From the Wrong Device	117
......System Will Not Boot From Ethernet	118
......System Will Not Boot From Disk	118
......SCSI Problems	119
......Setting the Console to a Specific Monitor	119
D. Sun Ultra 30 UPA/PCI System	121
...PCI-Based System	121
...Generic Names	125
...`pcia` and `pcib` PCI Busses	125
E. Sun Ultra 450 UPA/PCI System	127
...Banner Command Output	127


...Generic Names	127
...SCSI Internal Busses	130
...`.properties` for a PCI Device	131
...`.speed` Command	133
...Probing of Slots For PCI Busses	133
...Probe SCSI Command	135
F. Forth Word Reference	137
Index	171