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


..Ordering Sun Documents	xvii
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	29
....Command Security	30
.... Full Security	31
..Changing the Power-on Banner	32
..Input and Output Control	34
....Selecting Input and Output Device Options	35
....Setting Serial Port Characteristics	35
..Selecting Boot Options	36
..Controlling Power-on Self-test	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	70
..Changing the Number Base	70
..Controlling Text Input and Output	71
..Redirecting Input and Output	74
..Command Line Editor	77


..Conditional Flags	79
..Control Commands	80
....The if...else...then Structure	80
....The case Statement	82
....The begin Loop	83
....The do Loop	84
....Additional Control Commands	87
5. Loading and Executing Programs	89
..Using boot	91
..Using dl to Load Forth Text Files Over Serial Port A	91
..Using load	92
..Using dlbin to Load FCode or Binary Executables Over Serial Port
....A	94
..Using dload to Load from Ethernet	95
....Forth Programs	95
....FCode Programs	96
....Binary Executables	96
..Using ?go	96
6. Debugging	99
..Using the Forth Language Decompiler	99
..Using the Disassembler	101
..Displaying Registers	101
....SPARC Registers	102
..Breakpoints	104


..The Forth Source-level Debugger	105
..Using `patch` and `(patch)`	107
..Using ftrace	110
A. Setting Up a TIP Connection	111
..Common Problems with TIP	114
B. Building A Bootable Floppy Disk	115
C. Troubleshooting Guide	117
..Power-on Initialization Sequence	117
..Emergency Procedures	119
..Preserving Data After a System Crash	119
..Common Failures	120
.....Blank Screen - No Output	120
.....System Boots From the Wrong Device	121
.....System Will Not Boot From Ethernet	122
.....System Will Not Boot From Disk	122
.....SCSI Problems	123
.....Setting the Console to a Specific Monitor	123
D. Forth Word Reference	125