NAME

monitor − system PROM monitor and command interpreter

SYNOPSIS

L1 -a

BREAK

DESCRIPTION

The CPU board of the Sun workstation contains a PROM (or set of PROMs), called the monitor, that controls the system during startup.  The monitor tests the system and then searches for and attempts to boot UNIX.  If you interrupt the boot procedure, or by typing either L1−a or BREAK, it issues the prompt:

>

and accepts commands interactively. 

COMMANDS

A[n] [action ...]
open A-register (cpu address register) n, and perform indicated actions. n can be from 0 to 7.  The default is 0.  action is a data value in hex; a non-hex character terminates command input. 

B [device[(c,u,p)]] [pathname]
boot.  Resets appropriate parts of the system, then bootstraps. This allows bootstrap loading of programs from various devices (such as a disk, tape, or Ethernet connection).

device is one of:

ieIntel Ethernet

leLance Ethernet

sdSCSI disk

stSCSI 1/4" tape

mtTape Master 9-track 1/2" tape

xtXylogics 1/2" tape

xyXylogics 440/450 disk

cis a controller number (0 if only one controller),

uis a unit number (0 if only one driver), and,

pis a partition. 

pathname
is a pathname for a program such as /stand/diag. /vmunix is the default. 

B with no arguments will cause a default boot, either from the disk, or from the Ethernet controller. 

B?  displays all boot devices and their device arguments. 

C[addr]
continue a program. When given, addr is the address at which execution will begin.  The default is the current PC.  Registers are restored to the values shown by A, D, and R commands. 

D[n][action ...]
open D-register (cpu data register) n, and perform indicated actions. n can be from 0 to 7.  The default is 0. 

E[addr][param]
open the 16 bit word at addr (default zero) in the address space defined by the S command. 

Faddr1 addr2 [pattern][size]          Sun 3 only.

Fill address space from (lower) addr1 to (higher) addr2 with the constant, pattern, specified by size:

bbyte format (the default),

wword format, or

llong word format. 

For example, the following command fills the address block from 0x1000 to 0x2000 with the word pattern, 0xABCD:

F 1000 2000 ABCD W

G[addr]
Start the program by executing a subroutine call to the address addr if given, or else to the current PC.  The values of the address and data registers are undefined.  The status register is set to 0x2700. 

G0When the monitor is running as a result of being interrupted, force a panic and produce a crash dump. 

G4When the monitor is running as a result of being interrupted, force a kernel stack trace. 

H          Sun 3 only

Display the menu of monitor commands, and their descriptions. 

K[number]
If number is:

0 cpu reset only.  This is the default. 

1reset cpu and mmu. 

2reboot.  Resets and clears memory, as with a power-on reset.  Runs the PROM-based diagnostic self test, which can take from 5 to 180 seconds depending upon how much memory is being tested. 

KBdisplay the system banner. 

L[addr][actions]
open the long (32 bit) word at memory address addr (default zero) in the address space defined by the S command (below). 

M[addr][actions]
open the segment map entry that maps virtual address addr (default zero) in the address space defined by the S command (below).  The segment map address is the virtual address field from address bit 27 thru bit 17 of the virtual address presented by the cpu to the mmu. 

O[addr][actions]
open the byte location specified  by addr (default zero) in the address space defined by the S command below. 

P[addr][actions]
open the page map entry that maps virtual address addr (default zero) in the address space defined by the S command. 

Q[addr][actions]          Sun 3 only. 

open the EEPROM address addr (default zero) in the EEPROM address space.  All addresses are referenced from the beginning or base of the EEPROM in physical address space, and a limit check is performed to insure that no address beyond the EEPROM physical space is accessed.  This command is used to examine/modify configuration parameters specifying such things as amount of memory to test during self test, whether to display a standard or custom banner, if a serial port (A or B) is to be the system console, etc. 

R[reg][actions]
open the miscellaneous registers. reg can be one of:

SS(68010 Supervisor Stack Pointer),

IS(68020 Interrupt Stack Pointer),

MS(68020 Master Stack Pointer),

US(User Stack Pointer),

SF(Source Function code),

DF(Destination Function code),

VB(Vector Base),

SC(System Context),

UC(User Context),

SR(Status Register), and

PC(Program Counter). 

Alterations to these registers (except SC and UC) do not take effect until the next C command. 

S[code]
set or query the address space to be used by subsequent memory access commands. code is one of:

0undefined. 

1user data space. 

2user program space. 

3user control space. 

4undefined. 

5supervisor data space. 

6supervisor program space. 

7supervisor control space. 

T[command]          Sun 3 only

trace command. Works with standalone programs that do not affect interrupt vectors.

U[arg]manipulate the serial ports and switches the current operator I/O device.  arg can have any of the following values ( [AB] indicates one of A or B):

[AB]select serial port A or B as input and output device

[AB]io
select serial port A or B as input and output device

[AB]iselect serial port A or B for input only

[AB]oselect serial port A or B for output only

kselect keyboard for input

kiselect keyboard for input

sselect screen for output

soselect screen for output

ks,skselect keyboard for input and screen for output

[AB]#
set speed of serial port A (or B) to # (such as 1200,9600,..)

eecho input to output

nedon’t echo input to output

u addrset virtual serial port address to addr . 

If no serial port is specified when changing speeds, the current input device is changed. 

At power-up, the following default settings are used: the default console input device is the Sun keyboard or if the keyboard is unavailable, serial port A.  The default console output device is the Sun screen or if the graphics board is unavailable, serial port A.  All serial ports are set to 9600 Baud. 

V addr1 addr2 [size]          Sun 3 only

display the contents of addresses from (lower) addr1 to (higher) address addr2 in the format specified by size:

bbyte format (the default),

wword format, or

llong word format. 

Enter return to pause for viewing; enter another return character resume the display.  To terminate the display at any time, press the space bar.  Or, you can use ^S and ^Q to stop and start the display. 

For example, the following command displays the contents of virtual address space from address 0x1000 to 0x2000 in word format:

V 1000 2000 W

W[addr][arg]          Sun 3 only. 

Vector to addr.  arg is one of:

printprints the contents of virtual address addr as a string. 

dumpinitiates a crash dump. 

traceproduces a stack trace. 

X          Sun 3 only

display a menu of extended tests to be presented, with loop and print options also selectable.  These test commands are provided to permit additional testing of such things as the I/O port connectors at the handle edge of the CPU board, Video memory, workstation memory and the workstation keyboard, as well as permit the boot device paths to be tested. 

Z[addr]          Sun 3 only. 

set a breakpoint at addr in the address space selected by the S command. 

Sun Release 3.2  —  Last change: 9 April 1986