1monitor(1M) System Administration Commands monitor(1M)
2
6 monitor - SPARC system PROM monitor
7
9 STOP−A
10 BREAK
13 initial system power-on
16 exit from a client program, e.g., the Operating System
19
22 The CPU board of a workstation contains one or more EPROMs or EEPROMs.
23 The program which executes from the PROMs is referred to as "the moni‐
24 tor". Among other things, the monitor performs system initialization at
25 power-on and provides a user interface.
26 Monitor Prompt
28 The monitor of earlier workstations was known as the SunMON monitor and
29 displayed the > for its prompt. See the SunMON MONITOR USAGE section
30 for further details.
31 Existing workstations use a monitor which is known as the OpenBoot mon‐
34 itor. The OpenBoot monitor typically displays ok as its prompt, but it
35 may also display the > prompt under certain circumstances.
36 If the 'auto-boot?' NVRAM parameter is set to 'false' when the worksta‐
39 tion is powered on, the system does not attempt to boot and the monitor
40 issues its prompt. If 'auto-boot' is set to 'true', the system initi‐
41 ates the boot sequence. The boot sequence can be aborted by simultane‐
42 ously pressing two keys on the system's keyboard: L1 and A (on older
43 keyboards), or Stop and A (on newer keyboards). Either a lower case a
44 or an upper case A works for the keyboard abort sequence. If a console
45 has been attached by way of one of the system's serial ports then the
46 abort sequence can be accomplished by sending a BREAK. See tip(1).
47 When the NVRAM 'security-mode' parameter has been turned on, or when
50 the value of the 'sunmon-compat?' parameter is true, then the OpenBoot
51 monitor displays the message: Type b (boot), c (continue), or n (new
52 command mode)
53 and the > prompt appears.
56
58 Some of the more useful commands that can be issued from OpenBoot's ok
59 prompt are described here. Refer to the book for a complete list of
60 commands.
61 Help
63 Help for various functional areas of the OpenBoot monitor can be
64 obtained by typing help. The help listing provides a number of other
65 key words which can then be used in the help command to provide further
66 details.
67 NVRAM Parameters
69 Each workstation contains one or more NVRAM devices which contains
70 unique system ID information, as well as a set of user-configurable
71 parameters. The NVRAM parameters allow the user a certain level of
72 flexibility in configuring the system to act in a given manner under a
73 specific set of circumstances.
74 See eeprom(1M) for a description of the parameters and information
77 regarding setting the parameters from the OS level.
78 The following commands can be used at the OpenBoot monitor to access
81 the NVRAM parameters.
82 printenv Used to list the NVRAM parameters, along with their
84 default values and current values.
85 setenv pn pv Used to set or modify a parameter. The pn represents
88 the parameter name, and pv represents the parameter
89 value.
90 set-default pn Used to set an individual parameter back to its
93 default value.
94 set-defaults Used to reset all parameters to their default values.
97 (Note that 'set-defaults' only affects parameters
98 that have assigned default values.)
99 Security Parameters
102 Newer OpenBoot monitors contain user interfaces that support the stor‐
103 age and listing of keys for later use by client programs.
104 list-security-keys
106 Lists the names of keys currently stored on a machine.
108 set-security-key keyname [ keydata ]
111 Stores key data keydata in a key named keyname. Actual key data can
113 be up to 32 bytes in length. The maximum length of keyname is 64
114 bytes, which allows for the hex-formatted ASCII used to present the
115 key data. If keydata is not present, keyname and its corresponding
116 data is deleted.
117 Hardware Checks and Diagnostics
120 The following commands are available for testing or checking the sys‐
121 tem's hardware. If the 'diag-switch?' NVRAM parameter is set to true
122 when the system is powered on, then a Power-On Self Test (POST) diag‐
123 nostic is run, if present, sending its results messages to the system's
124 serial port A. Not all of the commands shown are available on all
125 workstations.
126 test-all Run the diagnostic tests on each device which has pro‐
128 vided a self-test.
129 test floppy Run diagnostics on the system's floppy device.
132 test /memory Run the main memory tests. If the NVRAM parameter
135 'diag-switch?' is set to true, then all of main memory
136 is tested. If the parameter is false then only the
137 amount of memory specified in the 'selftest-#megs'
138 NVRAM parameter is tested.
139 test net Test the network connection for the on-board network
142 controller.
143 watch-net Monitor the network attached to the on-board net con‐
146 troller.
147 watch-net-all Monitor the network attached to the on-board net con‐
150 troller, as well as the network controllers installed
151 in SBus slots.
152 watch-clock Test the system's clock function.
155 System Information
158 The following commands are available for displaying information about
159 the system. Not all commands are available on all workstations.
160 banner Display the power-on banner.
162 .enet-addr Display the system's Ethernet address.
165 .idprom Display the formatted contents of the IDPROM.
168 module-info Display information about the system's processor(s).
171 probe-scsi Identify the devices attached to the on-board SCSI
174 controller.
175 probe-scsi-all Identify the devices attached to the on-board SCSI
178 controller as well as those devices which are
179 attached to SBus SCSI controllers.
180 show-disks Display a list of the device paths for installed SCSI
183 disk controllers.
184 show-displays Display a list of the device paths for installed dis‐
187 play devices.
188 show-nets Display a list of the device paths for installed Eth‐
191 ernet controllers.
192 show-sbus Display list of installed SBus devices.
195 show-tapes Display a list of the device paths for installed SCSI
198 tape controllers.
199 show-ttys Display a list of the device paths for tty devices.
202 .traps Display a list of the SPARC trap types.
205 .version Display the version and date of the OpenBoot PROM.
208 Emergency Commands
211 These commands must be typed from the keyboard, they do not work from a
212 console which is attached by way of the serial ports. With the excep‐
213 tion of the Stop-A command, these commands are issued by pressing and
214 holding down the indicated keys on the keyboard immediately after the
215 system has been powered on. The keys must be held down until the moni‐
216 tor has checked their status. The Stop-A command can be issued at any
217 time after the console display begins, and the keys do not need to be
218 held down once they've been pressed. The Stop-D, Stop-F and Stop-N com‐
219 mands are not allowed when one of the security modes has been set. Not
220 all commands are available on all workstations.
221 Stop (L1) Bypass the Power-On Self Test (POST). This is only
223 effective if the system has been placed into the diag‐
224 nostic mode.
225 Stop-A (L1-A) Abort the current operation and return to the moni‐
228 tor's default prompt.
229 Stop-D (L1-D) Set the system's 'diag-switch?' NVRAM parameter to
232 'true', which places the system in diagnostic mode.
233 POST diagnostics, if present, are run, and the mes‐
234 sages are displayed by way of the system's serial port
235 A.
236 Stop-F (L1-F) Enter the OpenBoot monitor before the monitor has
239 probed the system for devices. Issue the 'fexit' com‐
240 mand to continue with system initialization.
241 Stop-N (L1-N) Causes the NVRAM parameters to be reset to their
244 default values. Note that not all parameters have
245 default values.
246 Line Editor Commands
249 The following commands can be used while the monitor is displaying the
250 ok prompt. Not all of these editing commands are available on all
251 workstations.
252 CTRL-A Place the cursor at the start of line.
254 CTRL-B Move the cursor backward one character.
257 ESC-B Move the cursor backward one word.
260 CTRL-D Erase the character that the cursor is currently highlight‐
263 ing.
264 ESC-D Erase the portion of word from the cursor's present position
267 to the end of the word.
268 CTRL-E Place the cursor at the end of line.
271 CTRL-F Move the cursor forward one character.
274 ESC-F Move the cursor forward one word.
277 CTRL-H Erase the character preceding the cursor (also use Delete or
280 Back Space)
281 ESC-H Erase the portion of the word which precedes the cursor (use
284 also CTRL-W)
285 CTRL-K Erase from the cursor's present position to the end of the
288 line.
289 CTRL-L Show the command history list.
292 CTRL-N Recall the next command from the command history list
295 CTRL-P Recall a previous command from the command history list.
298 CTRL-Q Quote the next character (used to type a control character).
301 CTRL-R Retype the current line.
304 CTRL-U Erase from the cursor's present position to the beginning of
307 the line.
308 CTRL-Y Insert the contents of the memory buffer into the line, in
311 front (to the left) of the cursor.
312 nvramrc
315 The nvramrc is an area of the system's NVRAM where users may store
316 Forth programs. The programs which are stored in the nvramrc are exe‐
317 cuted each time the system is reset, provided that the 'use-nvramrc?'
318 NVRAM parameter has been set to 'true'. Refer to the book for informa‐
319 tion on how to edit and use the nvramrc.
320 Restricted Monitor
322 The command 'old-mode' is used to move OpenBoot into a restricted moni‐
323 tor mode, causing the > prompt to be displayed. Only three commands
324 are allowed while in the restricted monitor; the 'go' command (to
325 resume a program which was interrupted with the Stop-A command), the
326 'n' command (to return to the normal OpenBoot monitor), and boot com‐
327 mands. The restricted monitor's boot commands approximate the older
328 SunMON monitor's boot command syntax. If a 'security-mode' has been
329 turned on then the restricted monitor becomes the default monitor envi‐
330 ronment. The restricted monitor may also become the default environ‐
331 ment if the 'sunmon-compat?' NVRAM parameter is set to true. Not all
332 workstations have the 'sunmon-compat?' parameter.
333
335 The following commands are available systems with older SunMON-based
336 PROM:
337 +|−
339 Increment or decrement the current address and display the contents
341 of the new location.
342 ^C source destination n
345 (caret-C) Copy, byte-by-byte, a block of length n from the source
347 address to the destination address.
348 ^I program
351 (caret-I) Display the compilation date and location of program.
353 ^T virtual_address
356 (caret-T) Display the physical address to which virtual_address is
358 mapped.
359 b [ ! ] [ device [ (c,u,p) ] ] [ pathname ] [ arguments_list ]
362 b[?]
367 Reset appropriate parts of the system and bootstrap a program. A
369 `!' (preceding the device argument) prevents the system reset from
370 occurring. Programs can be loaded from various devices (such as a
371 disk, tape, or Ethernet). `b' with no arguments causes a default
372 boot, either from a disk, or from an Ethernet controller. `b?' dis‐
373 plays all boot devices and their devices.
374 device one of
376 le Lance Ethernet
378 ie Intel Ethernet
381 sd SCSI disk, CDROM
384 st SCSI 1/4" or 1/2" tape
387 fd Diskette
390 id IPI disk
393 mt Tape Master 9-track 1/2" tape
396 xd Xylogics 7053 disk
399 xt Xylogics 1/2" tape
402 xy Xylogics 440/450 disk
405 c A controller number (0 if only one controller),
409 u A unit number (0 if only one driver), and
412 p A partition.
415 pathname A pathname for a program such as /stand/diag.
418 arguments_list A list of up to seven arguments to pass to the
421 program being booted.
422 c [virtual_address]
426 Resume execution of a program. When given, virtual_address is the
428 address at which execution resumes. The default is the current PC.
429 Registers are restored to the values shown by the d, and r com‐
430 mands.
431 d [window_number]
434 Display (dump) the state of the processor. The processor state is
436 observable only after:
437 o An unexpected trap was encountered.
439 o A user program dropped into the monitor (by calling
441 abortent).
442 o The user manually entered the monitor by typing L1−A or
444 BREAK.
445 The display consists of the following:
446 o The special registers: PSR, PC, nPC, TBR, WIM, and Y
448 o Eight global registers
450 o 24 window registers (8 in, 8 local, and 8 out), corre‐
452 sponding to one of the 7 available windows. If a Float‐
453 ing-Point Unit is on board, its status register along
454 with 32 floating-point registers are also shown.
455 window_number Display the indicated window_number, which can be
457 any value between 0 and 6, inclusive. If no win‐
458 dow is specified and the PSR's current window
459 pointer contains a valid window number, registers
460 from the window that was active just prior to
461 entry into the monitor are displayed. Otherwise,
462 registers from window 0 are displayed.
463 e [virtual_address][action] ...
467 Open the 16-bit word at virtual_address (default zero). The
469 address is interpreted in the address space defined by the s com‐
470 mand. See the a command for a description of action.
471 f virtual_address1 virtual_address2 pattern [size]
474 Fill the bytes, words, or long words from virtual_address1 (lower)
476 to virtual_address2 (higher) with the constant, pattern. The size
477 argument can take one of the following values:
478 b byte format (the default)
480 w word format
483 l long word format
486 For example, the following command fills the address block from
488 0x1000 to 0x2000 with the word pattern, 0xABCD:
489 f 1000 2000 ABCD W
491 g [vector] [argument]
494 g [virtual_address] [argument]
495 Goto (jump to) a predetermined or default routine (first form), or
497 to a user-specified routine (second form). The value of argument
498 is passed to the routine. If the vector or virtual_address argu‐
499 ment is omitted, the value in the PC is used as the address to jump
500 to.
501 To set up a predetermined routine to jump to, a user program must,
503 prior to executing the monitor's g command, set the variable
504 *romp->v_vector_cmd to be equal to the virtual address of the
505 desired routine. Predetermined routines need not necessarily return
506 control to the monitor.
507 The default routine, defined by the monitor, prints the user-sup‐
509 plied vector according to the format supplied in argument. This
510 format can be one of:
511 %x hexadecimal
513 %d decimal
516 g0
520 Force a panic and produce a crash dump when the monitor is running
522 as a result of the system being interrupted,
523 g4
526 (Sun-4 systems only) Force a kernel stack trace when the monitor
528 is running as a result of the system being interrupted,
529 h
532 Display the help menu for monitor commands and their descriptions.
534 To return to the monitor's basic command level, press ESCAPE or q
535 before pressing RETURN.
536 i [cache_data_offset] [action]...
539 Modify cache data RAM command. Display and/or modify one or more
541 of the cache data addresses. See the a command for a description
542 of action.
543 j [cache_tag_offset] [action]...
546 Modify cache tag RAM command. Display and/or modify the contents
548 of one or more of the cache tag addresses. See the a command for a
549 description of action.
550 k [reset_level]
553 Reset the system, where reset_level is:
555 0 Reset VMEbus, interrupt registers, video monitor (Sun-4 sys‐
557 tems). This is the default.
558 1 Software reset.
561 2 Power-on reset. Resets and clears the memory. Runs the EPROM-
564 based diagnostic self test, which can take several minutes,
565 depending upon how much memory is being tested.
566 kb
570 Display the system banner.
572 l [virtual_address][action]...
575 Open the long word (32 bit) at memory address virtual_address
577 (default zero). The address is interpreted in the address space
578 defined by the s command (below). See the a command for a descrip‐
579 tion of action.
580 m [virtual_address][action]...
583 Open the segment map entry that maps virtual_address (default
585 zero). The address is interpreted in the address space defined by
586 the s command. See the a command for a description of action.
587 ne
590 ni
595 Disable, enable, or invalidate the cache, respectively.
597 o [virtual_address][action]...
600 Open the byte location specified by virtual_address (default
602 zero). The address is interpreted in the address space defined by
603 the s command. See the a command for a description of action.
604 p [virtual_address][action]...
607 Open the page map entry that maps virtual_address (default zero) in
609 the address space defined by the s command. See the a command for a
610 description of action.
611 q [eeprom_offset][action]...
614 Open the EEPROM eeprom_offset (default zero) in the EEPROM address
616 space. All addresses are referenced from the beginning or base of
617 the EEPROM in physical address space, and a limit check is per‐
618 formed to insure that no address beyond the EEPROM physical space
619 is accessed. This command is used to display or modify configura‐
620 tion parameters, such as: the amount of memory to test during self
621 test, whether to display a standard or custom banner, if a serial
622 port (A or B) is to be the system console, etc. See the a command
623 for a description of action.
624 r [register_number]
627 r [register_type]
628 r [w window_number]
629 Display and/or modify one or more of the IU or FPU registers. A
631 hexadecimal register_number can be one of:
632 0x00−0x0f window(0,i0)−window(0,i7), window(0,i0)—win‐
634 dow(0,i7)
635 0x16−0x1f window(1,i0)−window(1,i7), window(1,i0)—win‐
638 dow(1,i7)
639 0x20−0x2f window(2,i0)−window(2,i7), window(2,i0)—win‐
642 dow(2,i7)
643 0x30−0x3f window(3,i0)−window(3,i7), window(3,i0)—win‐
646 dow(3,i7)
647 0x40−0x4f window(4,i0)−window(4,i7), window(4,i0)—win‐
650 dow(4,i7)
651 0x50−0x5f window(5,i0)−window(5,i7), window(5,i0)—win‐
654 dow(5,i7)
655 0x60−0x6f window(6,i0)−window(6,i7), window(6,i0)—win‐
658 dow(6,i7)
659 0x70−0x77 g0, g1, g2, g3, g4, g5, g6, g7
662 0x78−0x7d PSR, PC, nPC, WIM, TBR, Y.
665 0x7e−0x9e FSR, f0−f31
668 Register numbers can only be displayed after an unexpected trap, a
670 user program has entered the monitor using the abortent function,
671 or the user has entered the monitor by manually typing L1−A or
672 BREAK.
673 If a register_type is given, the first register of the indicated
675 type is displayed. register_type can be one of:
676 f floating-point
678 g global
681 s special
684 If w and a window_number (0—6) are given, the first in-register
686 within the indicated window is displayed. If window_number is
687 omitted, the window that was active just prior to entering the mon‐
688 itor is used. If the PSR's current window pointer is invalid, win‐
689 dow 0 is used.
690 s [asi])
693 Set or display the Address Space Identifier. With no argument, s
695 displays the current Address Space Identifier. The asi value can
696 be one of:
697 0x2 control space
699 0x3 segment table
702 0x4 Page table
705 0x8 user instruction
708 0x9 supervisor instruction
711 0xa user data
714 0xb supervisor data
717 0xc flush segment
720 0xd flush page
723 0xe flush context
726 0xf cache data
729 u [ echo ]
733 u [ port ] [ options ] [ baud_rate ]
738 u [ u ] [ virtual_address ]
743 With no arguments, display the current I/O device characteristics
745 including: current input device, current output device, baud rates
746 for serial ports A and B, an input-to-output echo indicator, and
747 virtual addresses of mapped UART devices. With arguments, set or
748 configure the current I/O device. With the u argument (uu...), set
749 the I/O device to be the virtual_address of a UART device currently
750 mapped.
751 echo Can be either e to enable input to be echoed to the
753 output device, or ne, to indicate that input is not
754 echoed.
755 port Assign the indicated port to be the current I/O
758 device. port can be one of:
759 a serial port A
761 b serial port B
764 k the workstation keyboard
767 s the workstation screen
770 baud_rate Any legal baud rate.
774 options can be any combination of:
777 i input
779 o output
782 u UART
785 e echo input to output
788 ne do not echo input
791 r reset indicated serial port (a and b ports only)
794 If either a or b is supplied, and no options are given,
796 the serial port is assigned for both input and output.
797 If k is supplied with no options, it is assigned for
798 input only. If s is supplied with no options, it is
799 assigned for output only.
800 v virtual_address1 virtual_address2 [size]
804 Display the contents of virtual_address1 (lower) virtual_address2
806 (higher) in the format specified by size:
807 b byte format (the default)
809 w word format
812 l long word format
815 Enter return to pause for viewing; enter another return character
817 to resume the display. To terminate the display at any time, press
818 the space bar.
819 For example, the following command displays the contents of virtual
821 address space from address 0x1000 to 0x2000 in word format:
822 v 1000 2000 W
824 w [virtual_address][argument]
827 Set the execution vector to a predetermined or default routine.
829 Pass virtual_address and argument to that routine.
830 To set up a predetermined routine to jump to, a user program must,
832 prior to executing the monitor's w command, set the variable
833 *romp->v_vector_cmd to be equal to the virtual address of the
834 desired routine. Predetermined routines need not necessarily return
835 control to the monitor.
836 The default routine, defined by the monitor, prints the user-sup‐
838 plied vector according to the format supplied in argument. This
839 format can be one of:
840 %x hexadecimal
842 %d decimal
845 x
849 Display a menu of extended tests. These diagnostics permit addi‐
851 tional testing of such things as the I/O port connectors, video
852 memory, workstation memory and keyboard, and boot device paths.
853 yc context_number
856 yp|s context_number virtual_address
861 Flush the indicated context, context page, or context segment.
863 c flush context context_number
865 p flush the page beginning at virtual_address within context
868 context_number
869 s flush the segment beginning at virtual_address within context
872 context_number
873
877 See attributes(5) for descriptions of the following attributes:
878 ┌─────────────────────────────┬─────────────────────────────┐
883 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
884 ├─────────────────────────────┼─────────────────────────────┤
885 │Architecture │SPARC │
886 └─────────────────────────────┴─────────────────────────────┘
887
889 tip(1), boot(1M), eeprom(1M), attributes(5)
890SunOS 5.11 24 Jul 2003 monitor(1M)