OpenBood 3.x Command Reference Manual

806-1377-10

Contents

Preface

1. Overview

Features of OpenBoot

Plug-in Device Drivers

FCode Interpreter

Device Tree

Programmable User Interface

The User Interface

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

Booting for the Casual User

Booting for the Expert User

Running Diagnostics

Testing the SCSI Bus

Testing Installed Devices

Testing the Diskette Drive

Testing Memory

Testing the Clock

Testing the Network Controller

Monitoring the Network

Displaying System Information

Resetting the System

3. Setting Configuration Variables

Displaying and Changing Variable Settings

Setting Security Variables

Command Security

Full Security

Changing the Power-on Banner

Input and Output Control

Selecting Input and Output Device Options

Serial Port Characteristics

Selecting Boot Options

Controlling Power-on Self-Test (POST)

Using nvramrc

Editing the Contents of the Script

Activating the Script

4. Using Forth Tools

Forth Commands

Data Types

Using Numbers

The Stack

Displaying Stack Contents

The Stack Diagram

Manipulating the Stack

Creating Custom Definitions

Using Arithmetic Functions

Single-Precision Integer Arithmetic

Double Number Arithmetic

Data Type Conversion

Address Arithmetic

Accessing Memory

Virtual Memory

Device Registers

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 boot

Using dl to Load Forth Text Files Over Serial Port A

Using load

Using dlbin to Load FCode or Binary Executables Over Serial Port A

Using dload to Load From Ethernet

Forth Programs

FCode Programs

Binary Executables

Using ?go

6. Debugging

Using the Forth Language Decompiler

Using the Disassembler

Displaying Registers

SPARC Registers

Breakpoints

The Forth Source-Level Debugger

Using patch and (patch)

Using ftrace

A. Setting Up a TIP Connection

Common Problems With TIP

B. Building a Bootable Floppy Disk

C. Troubleshooting Guide

Power-on Initialization Sequence

Emergency Procedures

Preserving Data After a System Crash

Common Failures

D. Sun Ultra 5/10 UPA/PCI System

PCI-Based System

pcia and pcib PCI Busses

E. Sun Ultra 30 UPA/PCI System

PCI-Based System

Generic Names

pcia and pcib PCI Busses

F. Sun Ultra 60 UPA/PCI System

PCI-Based System

Generic Names

pcia and pcib PCI Busses

G. Sun Ultra 250 UPA/PCI System

Banner Command Output

Generic Names

SCSI Internal Busses

.properties for a PCI Device

.speed Command

Probing of Slots For PCI Busses

Probe SCSI Command

H. Sun Ultra 450 UPA/PCI System

Banner Command Output

Generic Names

SCSI Internal Busses

.properties for a PCI Device

.speed Command

Probing of Slots For PCI Busses

Probe SCSI Command

I. Forth Word Reference

Stack Item Notation

Commands for Browsing the Device Tree

Common Options for the boot Command

System Information Display Commands

Viewing or Changing Configuration Variables

NVRAMRC Editor Commands

NVRAM Script Editor Keystroke Commands

Stack Manipulation Commands

Single-Precision Arithmetic Functions

Bit-wise Logical Operators

Double Number Arithmetic Functions

32-Bit Data Type Conversion Functions

64-Bit Data Type Conversion Functions

Address Arithmetic Functions

64-Bit Address Arithmetic Functions

Memory Access Commands

64-Bit Memory Access Functions

Memory Mapping Commands

Defining Words

Dictionary Searching Commands

Dictionary Compilation Commands

Assembly Language Programming

Basic Number Display

Changing the Number Base

Numeric Output Word Primitives

Controlling Text Input

Displaying Text Output

Formatted Output

Manipulating Text Strings

I/O Redirection Commands

ASCII Constants

Command Line Editor Keystroke Commands

Command Completion Keystroke Commands

Comparison Commands

if-else-then Commands

case Statement Commands

begin (Conditional) Loop Commands

do (Counted) Loop Commands

Program Execution Control Commands

File Loading Commands

Disassembler Commands

Breakpoint Commands

Forth Source-level Debugger Commands

Time Utilities

Miscellaneous Operations

Multiprocessor Commands

Memory Mapping Commands

Memory Mapping Primitives

Cache Manipulation Commands

Reading/Writing Machine Registers in Sun-4u Machines

Alternate Address Space Access Commands

SPARC Register Commands

SPARC V9 Register Commands

Emergency Keyboard Commands