Preface

Th e OpenBoot 2.x Command Reference manual describes the OpenBoot 2.x firmware that is part of the boot PROM in Sun systems.

---

Audience

The features of the OpenBoot firmware allow it to be used by end users as well as by system administrators and developers. This manual is for all such users who want to use the OpenBoot 2.x firmware to configure and debug their systems.

---

Contents

In this manual, you will find information about using the OpenBoot firmware to perform tasks such as:

• Booting the operating system

• Running diagnostics

• Modifying system start-up configuration parameters

• Loading and executing programs

• Troubleshooting

If you want to write Forth programs or use the more advanced features of this firmware (such as its debugging capabilities), this manual also describes the commands of the OpenBoot Forth Interpreter.

---

Assumptions

This manual assumes that you are working on a SPARC® system with a version 2. x OpenBoot PROM. Some of the tools and capabilities described in this manual do not exist on the pre-2. x PROM SPARC systems. If you are using a SPARCstation 1, SPARCstation IPC, or other system with a pre-2. x version PROM, refer to an earlier version of this manual: Open Boot PROM Toolkit User's Guide, part number 800-5279-10. Also see Appendix C in this manual for a list of unsupported commands.

---

Organization

Th e OpenBoot 2.x Command Reference is organized as follows:

"Invalid Cross-Reference" , describes the user interface and other main features of the firmware.

"Invalid Cross-Reference" , explains the most common tasks for which the OpenBoot firmware is used.

"Invalid Cross-Reference" , details how to perform system administration tasks with NVRAM parameters.

"Invalid Cross-Reference" , describes both basic and advanced functions of the OpenBoot Forth language.

"Invalid Cross-Reference" , describes how to load and execute programs from various sources (such as Ethernet, disk, or a serial port).

"Invalid Cross-Reference" , describes the firmware's debugging capabilities, including the Disassembler, the Forth Source-level Debugger, and breakpoints.

"Invalid Cross-Reference" , describes how to connect your system to another Sun system using serial ports.

"Invalid Cross-Reference" , tells you how to create a bootable floppy diskette from which you can load programs or files.

"Invalid Cross-Reference" , lists commands that may not be available in earlier OpenBoot systems and possible workarounds for them.

"Invalid Cross-Reference" , discusses solutions for typical situations where you cannot boot the operating system.

"Invalid Cross-Reference" , contains all currently-supported OpenBoot Forth commands.

---

Related Documentation

Companion documents to this manual:

• OpenBoot 2.x Quick Reference

This fold-out card is a summary of often-used OpenBoot Forth commands.

• For information about FCode, the version of Forth implemented in the OpenBoot 2.x firmware for using SBus cards, refer to the Sun manual:

• Writing FCode 2.x Programs

• For more information on the Forth language, read:

• Starting Forth

• Leo Brodie/Forth, Inc.
  Prentice-Hall Software Series
  Englewood Cliffs, New Jersey 07632

The second edition of Starting Forth describes the current Forth standard dialect, Forth 83.

---

Note - There are several differences between the versions of Forth described in the above document and the version described in this manual. Specifically, the boot PROM Forth Monitor uses 32-bit numbers instead of 16-bit numbers. Also, the text editor described in the referenced book is not the same as the Forth Monitor editor.

---

---

Sun Welcomes Your Comments

You can email your comments to us. Please include the part number of your document in the subject line of your email.

• Email: docfeedback@sun.com