OpenBoot 2.x Command Reference Manual

806-2906-10



Contents

Preface

1. Overview

OpenBoot Features

The User Interface

The Restricted Monitor

The Forth Monitor

The Default Mode

The Device Tree

Device Path Names, Addresses, and Arguments

Device Aliases

Displaying the Device Tree

Getting Help

A Caution About Using Some OpenBoot Commands

2. Booting and Testing Your System

Booting Your System

Running Diagnostics

Testing the SCSI Bus

Testing Installed Devices

Testing the Diskette Drive

Testing Memory

Testing the Ethernet Controller

Testing the Clock

Monitoring the Network

Displaying System Information

Resetting the System

3. Setting Configuration Parameters

Displaying and Changing Parameter Settings

Setting Security Parameters

Command Security

Full Security

Changing the Power-on Banner

Input and Output Control

Selecting Input and Output Device Options

Setting Serial Port Characteristics

Selecting Boot Options

Controlling Power-on Self-test

Using NVRAMRC

Editing the Contents of NVRAMRC

Activating an NVRAMRC File

4. Using Forth Tools

Forth Commands

Using Numbers

The Stack

Displaying Stack Contents

The Stack Diagram

Manipulating the Stack

Creating Custom Definitions

Using Arithmetic Functions

Accessing Memory

Mapping An SBus Device

Using Defining Words

Searching the Dictionary

Compiling Data into the Dictionary

Displaying Numbers

Changing the Number Base

Controlling Text Input and Output

Redirecting Input and Output

Command Line Editor

Conditional Flags

Control Commands

The if-else-then Structure

The case Statement

The begin Loop

The do Loop

Additional Control Commands

5. Loading and Executing Programs

Using dload to Load from Ethernet

Forth Programs

FCode Programs

Binary Executables

Using boot to Load from Hard Disk, Floppy Disk, or Ethernet

Forth Programs

FCode Programs

Binary Executables

Using dl to Load Forth Over a Serial Port

Using dlbin to Load FCode or Binary Over a Serial Port

6. Debugging

Using the Disassembler

Displaying Registers

Breakpoints

The Forth Source-level Debugger

Using ftrace

A. Testing with a Terminal Emulator

Common Problems with tip

B. Building A Bootable Floppy Disk

Procedure for the Pre-Solaris 2.0 Operating Environment

Procedure for the Solaris 2.0 or 2.1 Operating Environment

C. Unsupported Commands

D. Troubleshooting Guide

Power-on Initialization Sequence

Emergency Procedures

Preserving Data After a System Crash

Common Failures

Blank Screen - No Output

System Boots From the Wrong Device

System Will Not Boot From Ethernet

System Will Not Boot From Disk

SCSI Problems

Setting the Console to a Specific Monitor

E. Forth Word Reference

Copyright © 2001, Sun Microsystems, Inc. All rights reserved.