The OpenBoot trademark 4.x Command Reference Manual describes how to use Suntrademark systems that implement firmware that responds as those described by IEEE Standard 1275-1994., Standard For Boot Firmware .

This manual contains information on using the OpenBoot firmware to perform tasks such as:

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

The information in this manual is for a system that uses Version 4. x OpenBoot firmware. Other OpenBoot implementations may use different prompts or formatting, and may not support all of the tools and capabilities described in this manual.

Before You Read This Book

This manual is written for all users, including systems designers, systems administrators, and end users, who want to use OpenBoot to configure and debug their SBus and PCI-based systems.

How This Book Is Organized

Chapter 1 describes the user interface and other main features of OpenBoot firmware.

Chapter 2 explains the most common tasks for which OpenBoot firmware is used.

Chapter 3 details how to perform system administration tasks with NVRAM parameters.

Chapter 4 describes functions of the OpenBoot Forth language.

Chapter 5 describes how to load and execute programs from various sources (such as Ethernet, disk, or serial port).

Chapter 6 describes the debugging capabilities of the OpenBoot firmware, including decompiler, Forth source-level debugger, and breakpoints.

Appendix A describes how to set up a TIP connection.

Appendix B describes how to create a bootable floppy diskette from which you can load programs or files.

Appendix C discusses solutions for typical situations when you cannot boot the operating system.

Appendix D contains currently-supported OpenBoot Forth commands.

Typographic Conventions

Typeface or Symbol




The names of commands, files, and directories; on-screen computer output

Edit your .login file.
Use ls -a to list all files.
% You have mail.


What you type, when contrasted with on-screen computer output

% su


Book titles, new words or terms, words to be emphasized. Replace command-line variables with real names or values.

Read Chapter 6 in the User's Guide .
These are called class options.
To delete a file, type rm filename .

The following typographic conventions are specific to OpenBoot and are included in this manual:

Code Samples for OpenBoot

In this book, code samples are included in boxes and may display the following:

Typeface or Symbol




OpenBoot command prompt



UNIX C shell prompt



UNIX Bourne and Korn shell prompt



Superuser prompt, all shells



OpenBoot command prompt


Related Documentation

A companion document to this manual is:

For information on OpenBoot FCode, refer to:

For information about Open Firmware, refer to the:

IEEE Standard 1275-1994 Standard for Boot (Initialization, Configuration) Firmware, Core Requirements and Practices.

Also see .

For more information about Forth and Forth programming, refer to:

Accessing Sun Documentation Online

A broad selection of Sun system documentation is located at:

A complete set of Solaris documentation and many other titles are located at:

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. You can email your comments to Sun at:

Please include the part number (816-1177-10) of your document in the subject line of your email.