OpenBoot Command Reference 2550 Garcia Avenue Mountain View, CA 94043 U.S.A. Part No: 801-7042-10 Sun Microsystems Revision 1, August 1994 1994 Sun Microsystems, Inc. 2550 Garcia Avenue, Mountain View, California 94043-1100 U.S.A. All rights reserved. This product and related documentation are protected by copyright and distributed under licenses restricting its use, copying, distribution, and decompilation. No part of this product or related documentation may be reproduced in any form by any means without prior written authorization of Sun and its licensors, if any. Portions of this product may be derived from the UNIX® and Berkeley 4.3 BSD systems, licensed from UNIX System Laboratories, Inc., a wholly owned subsidiary of Novell, Inc., and the University of California, respectively. Third-party font software in this product is protected by copyright and licensed from Sun’s font suppliers. RESTRICTED RIGHTS LEGEND: Use, duplication, or disclosure by the United States Government is subject to the restrictions set forth in DFARS 252.227-7013 (c)(1)(ii) and FAR 52.227-19. The product described in this manual may be protected by one or more U.S. patents, foreign patents, or pending applications. TRADEMARKS Sun, Sun Microsystems, the Sun logo, Sun Microsystems Computer Corporation, the Sun Microsystems Computer Corporation logo, SunSoft, the SunSoft logo, Solaris, SunOS, OpenWindows, DeskSet, ONC, ONC+, and NFS are trademarks or registered trademarks of Sun Microsystems, Inc. UNIX and OPEN LOOK are registered trademarks of UNIX System Laboratories, Inc., a wholly owned subsidiary of Novell, Inc. All other product names mentioned herein are the trademarks of their respective owners. All SPARC trademarks, including the SCD Compliant Logo, are trademarks or registered trademarks of SPARC International, Inc. SPARCstation, SPARCserver, SPARCengine, SPARCstorage, SPARCware, SPARCcenter, SPARCclassic, SPARCcluster, SPARCdesign, SPARC811, SPARCprinter, UltraSPARC, microSPARC, SPARCworks, and SPARCompiler are licensed exclusively to Sun Microsystems, Inc. Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems, Inc. The OPEN LOOK® and Sun™ Graphical User Interfaces were developed by Sun Microsystems, Inc. for its users and licensees. Sun acknowledges the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry. Sun holds a non-exclusive license from Xerox to the Xerox Graphical User Interface, which license also covers Sun’s licensees who implement OPEN LOOK GUIs and otherwise comply with Sun’s written license agreements. X Window System is a product of the Massachusetts Institute of Technology. THIS PUBLICATION IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. THIS PUBLICATION COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THE PUBLICATION. SUN MICROSYSTEMS, INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN THIS PUBLICATION AT ANY TIME. Please Recycle Contents Preface. xv 1. Overview . 1 Features of OpenBoot . 1 The User Interface . 2 The Restricted Monitor . 3 The Forth Monitor . 3 The Default Mode . 4 The Device Tree . 4 Device Path Names, Addresses, and Arguments . 5 Device Aliases . 7 Displaying the Device Tree. 8 Getting Help . 10 A Caution About Using Some OpenBoot Commands . 11 2. Booting and Testing Your System . 13 Booting Your System . 13 iii Running Diagnostics . 16 Testing the SCSI Bus . 17 Testing Installed Devices . 17 Testing the Diskette Drive . 18 Testing Memory . 19 Testing the Ethernet Controller . 19 Testing the Clock . 20 Monitoring the Network. 20 Displaying System Information . 21 Resetting the System . 22 3. Setting Configuration Parameters . 23 Displaying and Changing Parameter Settings . 26 Setting Security Parameters . 29 Command Security . 30 Full Security . 31 Changing the Power-on Banner. 32 Input and Output Control. 34 Selecting Input and Output Device Options . 34 Setting Serial Port Characteristics . 35 Selecting Boot Options . 36 Controlling Power-on Self-test. 37 Using NVRAMRC . 38 Editing the Contents of NVRAMRC . 39 Activating an NVRAMRC File. 40 iv OpenBoot Command Reference—August 1994 4. Using Forth Tools . 43 Forth Commands . 44 Using Numbers . 45 The Stack. 46 Displaying Stack Contents . 46 The Stack Diagram. 48 Manipulating the Stack . 49 Creating Custom Definitions . 50 Using Arithmetic Functions . 52 Accessing Memory. 54 Using Defining Words . 60 Searching the Dictionary. 63 Compiling Data into the Dictionary . 64 Displaying Numbers . 65 Changing the Number Base . 65 Controlling Text Input and Output . 66 Redirecting Input and Output . 69 Keyboard Editor. 71 Conditional Flags. 73 Control Commands . 74 The if-then-else Structure . 74 The case Statement . 76 The begin Loop . 77 The do Loop . 78 Contents v Additional Control Commands . 80 5. Loading and Executing Programs. 81 Using dload to Load from Ethernet . 82 Using boot to Load from Hard Disk, Floppy Disk, or Ethernet 83 Using dl to Load Forth Over Serial Port A . 85 Using dlbin to Load FCode or Binary Over Serial Port A . 85 6. Debugging . 87 Using the Disassembler. 87 Displaying Registers . 88 Breakpoints. 89 The Forth Source-level Debugger . 91 Using ftrace. 92 A. Setting Up a TIP Connection . 93 Common Problems with TIP . 96 B. Building A Bootable Floppy Disk . 97 Procedure for the Pre-Solaris 2.0 Operating Environment . 98 Procedure for the Solaris 2.0 or 2.1 Operating Environment . 99 C. Unsupported Commands. 101 D. Troubleshooting Guide . 105 Power-on Initialization Sequence . 105 Emergency Procedures . 107 Preserving Data After a System Crash . 107 Common Failures. 108 Blank Screen - No Output. 108 vi OpenBoot Command Reference—August 1994 System Boots From the Wrong Device . 109 System Will Not Boot From Ethernet . 110 System Will Not Boot From Disk . 111 SCSI Problems . 111 Setting the Console to a Specific Monitor. 112 E. Forth Word Reference. 113 Index . ..