1 '\" te
   2 .\" Copyright (c) 2003, Sun Microsystems, Inc.
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH MONITOR 1M "Jul 24, 2003"
   7 .SH NAME
   8 monitor \- SPARC system PROM monitor
   9 .SH SYNOPSIS
  10 .nf
  11 \fBSTOP\(miA\fR
  12 .fi
  13 
  14 .LP
  15 .nf
  16 \fBBREAK\fR
  17 .fi
  18 
  19 .LP
  20 .nf
  21 \fBinitial system power-on\fR
  22 .fi
  23 
  24 .LP
  25 .nf
  26 \fBexit from a client program, e.g., the Operating System\fR
  27 .fi
  28 
  29 .SH DESCRIPTION
  30 The \fBCPU\fR board of a workstation contains one or more \fBEPROMs\fR or
  31 \fBEEPROMs.\fR The program which executes from the \fBPROMs\fR is referred to
  32 as "the monitor". Among other things, the monitor performs system
  33 initialization at power-on and provides a user interface.
  34 .SS "Monitor Prompt"
  35 The monitor of earlier workstations was known as the \fBSunMON\fR monitor and
  36 displayed the \fB>\fR for its prompt. See the \fBSunMON MONITOR USAGE\fR
  37 section for further details.
  38 .sp
  39 .LP
  40 Existing workstations use a monitor which is known as the OpenBoot monitor.
  41 The OpenBoot monitor typically displays \fBok\fR as its prompt, but it may also
  42 display the \fB>\fR prompt under certain circumstances.
  43 .sp
  44 .LP
  45 If the \fB\&'auto-boot?'\fR \fBNVRAM\fR parameter is set to \fB\&'false'\fR
  46 when the workstation is powered on, the system does not attempt to boot and the
  47 monitor issues its prompt. If \fB\&'auto-boot'\fR is set to \fB\&'true'\fR, the
  48 system initiates the boot sequence. The boot sequence can be aborted by
  49 simultaneously pressing two keys on the system's keyboard: \fBL1\fR and \fBA\fR
  50 (on older keyboards), or \fBStop\fR and \fBA\fR (on newer keyboards).  Either a
  51 lower case \fBa\fR or an upper case \fBA\fR works for the keyboard abort
  52 sequence.  If a console has been attached by way of one of the system's serial
  53 ports then the abort sequence can be accomplished by sending a \fBBREAK\fR. See
  54 \fBtip\fR(1).
  55 .sp
  56 .LP
  57 When the \fBNVRAM\fR \fB\&'security-mode'\fR parameter has been turned on, or
  58 when the value of the \fB\&'sunmon-compat?'\fR parameter is true, then the
  59 OpenBoot monitor displays the message: \fBType b (boot), c (continue), or n
  60 (new command mode)\fR
  61 .sp
  62 .LP
  63 and the \fB>\fR prompt appears.
  64 .SH OPENBOOT PROM USAGE
  65 Some of the more useful commands that can be issued from OpenBoot's \fBok \fR
  66 prompt are described here.  Refer to the   book for a complete list of
  67 commands.
  68 .SS "Help"
  69 Help for various functional areas of the OpenBoot monitor can be obtained by
  70 typing \fBhelp\fR. The help listing provides a number of other key words which
  71 can then be used in the help command to provide further details.
  72 .SS "NVRAM Parameters"
  73 Each workstation contains one or more \fBNVRAM\fR devices which contains unique
  74 system ID information, as well as a set of user-configurable parameters.  The
  75 \fBNVRAM\fR parameters allow the user a certain level of flexibility in
  76 configuring the system to act in a given manner under a specific set of
  77 circumstances.
  78 .sp
  79 .LP
  80 See \fBeeprom\fR(1M) for a description of the parameters and information
  81 regarding setting the parameters from the OS level.
  82 .sp
  83 .LP
  84 The following commands can be used at the OpenBoot monitor to access the
  85 \fBNVRAM\fR parameters.
  86 .sp
  87 .ne 2
  88 .na
  89 \fB\fBprintenv\fR\fR
  90 .ad
  91 .RS 18n
  92 Used to list the \fBNVRAM\fR parameters, along with their default values and
  93 current values.
  94 .RE
  95 
  96 .sp
  97 .ne 2
  98 .na
  99 \fB\fBsetenv\fR\fI pn pv\fR\fR
 100 .ad
 101 .RS 18n
 102 Used to set or modify a parameter.  The \fIpn\fR represents the parameter name,
 103 and \fIpv\fR represents the parameter value.
 104 .RE
 105 
 106 .sp
 107 .ne 2
 108 .na
 109 \fB\fBset-default\fR \fIpn\fR\fR
 110 .ad
 111 .RS 18n
 112 Used to set an individual parameter back to its default value.
 113 .RE
 114 
 115 .sp
 116 .ne 2
 117 .na
 118 \fB\fBset-defaults\fR\fR
 119 .ad
 120 .RS 18n
 121 Used to reset all parameters to their default values.  (Note that
 122 \fB\&'set-defaults'\fR only affects parameters that have assigned default
 123 values.)
 124 .RE
 125 
 126 .SS "Security Parameters"
 127 Newer OpenBoot monitors contain user interfaces that support the storage and
 128 listing of keys for later use by client programs.
 129 .sp
 130 .ne 2
 131 .na
 132 \fB\fBlist-security-keys\fR\fR
 133 .ad
 134 .sp .6
 135 .RS 4n
 136 Lists the names of keys currently stored on a machine.
 137 .RE
 138 
 139 .sp
 140 .ne 2
 141 .na
 142 \fB\fBset-security-key\fR \fIkeyname\fR [ \fIkeydata\fR ]\fR
 143 .ad
 144 .sp .6
 145 .RS 4n
 146 Stores key data \fIkeydata\fR in a key named \fIkeyname\fR. Actual key data can
 147 be up to 32 bytes in length. The maximum length of \fIkeyname\fR is 64 bytes,
 148 which allows for the hex-formatted ASCII used to present the key data. If
 149 \fIkeydata\fR is not present, \fIkeyname\fR and its corresponding data is
 150 deleted.
 151 .RE
 152 
 153 .SS "Hardware Checks and Diagnostics"
 154 The following commands are available for testing or checking the system's
 155 hardware.  If the \fB\&'diag-switch?'\fR \fBNVRAM\fR parameter is set to true
 156 when the system is powered on, then a Power-On Self Test (POST) diagnostic is
 157 run, if present, sending its results messages to the system's serial port A.
 158 Not all of the commands shown are available on all workstations.
 159 .sp
 160 .ne 2
 161 .na
 162 \fB\fBtest-all\fR\fR
 163 .ad
 164 .RS 17n
 165 Run the diagnostic tests on each device which has provided a self-test.
 166 .RE
 167 
 168 .sp
 169 .ne 2
 170 .na
 171 \fB\fBtest\fR \fBfloppy\fR\fR
 172 .ad
 173 .RS 17n
 174 Run diagnostics on the system's floppy device.
 175 .RE
 176 
 177 .sp
 178 .ne 2
 179 .na
 180 \fB\fBtest\fR \fB/memory\fR\fR
 181 .ad
 182 .RS 17n
 183 Run the main memory tests.  If the \fBNVRAM\fR parameter \fB\&'diag-switch?'\fR
 184 is set to true, then all of main memory is tested.  If the parameter is false
 185 then only the amount of memory specified in the \fB\&'selftest-#megs'\fR
 186 \fBNVRAM\fR parameter is tested.
 187 .RE
 188 
 189 .sp
 190 .ne 2
 191 .na
 192 \fB\fBtest\fR \fBnet\fR\fR
 193 .ad
 194 .RS 17n
 195 Test the network connection for the on-board network controller.
 196 .RE
 197 
 198 .sp
 199 .ne 2
 200 .na
 201 \fB\fBwatch-net\fR\fR
 202 .ad
 203 .RS 17n
 204 Monitor the network attached to the on-board net controller.
 205 .RE
 206 
 207 .sp
 208 .ne 2
 209 .na
 210 \fB\fBwatch-net-all\fR\fR
 211 .ad
 212 .RS 17n
 213 Monitor the network attached to the on-board net controller, as well as the
 214 network controllers installed in SBus slots.
 215 .RE
 216 
 217 .sp
 218 .ne 2
 219 .na
 220 \fB\fBwatch-clock\fR\fR
 221 .ad
 222 .RS 17n
 223 Test the system's clock function.
 224 .RE
 225 
 226 .SS "System Information"
 227 The following commands are available for displaying information about the
 228 system.  Not all commands are available on all workstations.
 229 .sp
 230 .ne 2
 231 .na
 232 \fB\fBbanner\fR\fR
 233 .ad
 234 .RS 18n
 235 Display the power-on banner.
 236 .RE
 237 
 238 .sp
 239 .ne 2
 240 .na
 241 \fB\fB\&.enet-addr\fR\fR
 242 .ad
 243 .RS 18n
 244 Display the system's Ethernet address.
 245 .RE
 246 
 247 .sp
 248 .ne 2
 249 .na
 250 \fB\fB\&.idprom\fR\fR
 251 .ad
 252 .RS 18n
 253 Display the formatted contents of the \fBIDPROM.\fR
 254 .RE
 255 
 256 .sp
 257 .ne 2
 258 .na
 259 \fB\fBmodule-info\fR\fR
 260 .ad
 261 .RS 18n
 262 Display information about the system's processor(s).
 263 .RE
 264 
 265 .sp
 266 .ne 2
 267 .na
 268 \fB\fBprobe-scsi\fR\fR
 269 .ad
 270 .RS 18n
 271 Identify the devices attached to the on-board \fBSCSI\fR controller.
 272 .RE
 273 
 274 .sp
 275 .ne 2
 276 .na
 277 \fB\fBprobe-scsi-all\fR\fR
 278 .ad
 279 .RS 18n
 280 Identify the devices attached to the on-board \fBSCSI\fR controller as well as
 281 those devices which are attached to SBus \fBSCSI\fR controllers.
 282 .RE
 283 
 284 .sp
 285 .ne 2
 286 .na
 287 \fB\fBshow-disks\fR\fR
 288 .ad
 289 .RS 18n
 290 Display a list of the device paths for installed \fBSCSI\fR disk controllers.
 291 .RE
 292 
 293 .sp
 294 .ne 2
 295 .na
 296 \fB\fBshow-displays\fR\fR
 297 .ad
 298 .RS 18n
 299 Display a list of the device paths for installed display devices.
 300 .RE
 301 
 302 .sp
 303 .ne 2
 304 .na
 305 \fB\fBshow-nets\fR\fR
 306 .ad
 307 .RS 18n
 308 Display a list of the device paths for installed Ethernet controllers.
 309 .RE
 310 
 311 .sp
 312 .ne 2
 313 .na
 314 \fB\fBshow-sbus\fR\fR
 315 .ad
 316 .RS 18n
 317 Display list of installed SBus devices.
 318 .RE
 319 
 320 .sp
 321 .ne 2
 322 .na
 323 \fB\fBshow-tapes\fR\fR
 324 .ad
 325 .RS 18n
 326 Display a list of the device paths for installed \fBSCSI\fR tape controllers.
 327 .RE
 328 
 329 .sp
 330 .ne 2
 331 .na
 332 \fB\fBshow-ttys\fR\fR
 333 .ad
 334 .RS 18n
 335 Display a list of the device paths for tty devices.
 336 .RE
 337 
 338 .sp
 339 .ne 2
 340 .na
 341 \fB\fB\&.traps\fR\fR
 342 .ad
 343 .RS 18n
 344 Display a list of the SPARC trap types.
 345 .RE
 346 
 347 .sp
 348 .ne 2
 349 .na
 350 \fB\fB\&.version\fR\fR
 351 .ad
 352 .RS 18n
 353 Display the version and date of the OpenBoot PROM.
 354 .RE
 355 
 356 .SS "Emergency Commands"
 357 These commands must be typed from the keyboard, they do not work from a console
 358 which is attached by way of the serial ports.  With the exception of the
 359 \fBStop-A\fR command, these commands are issued by pressing and holding down
 360 the indicated keys on the keyboard immediately after the system has been
 361 powered on.  The keys must be held down until the monitor has checked their
 362 status.  The \fBStop-A\fR command can be issued at any time after the console
 363 display begins, and the keys do not need to be held down once they've been
 364 pressed. The \fBStop-D,\fR \fBStop-F\fR and \fBStop-N\fR commands are not
 365 allowed when one of the security modes has been set.  Not all commands are
 366 available on all workstations.
 367 .sp
 368 .ne 2
 369 .na
 370 \fB\fBStop (L1)\fR\fR
 371 .ad
 372 .RS 17n
 373 Bypass the Power-On Self Test (POST).  This is only effective if the system has
 374 been placed into the diagnostic mode.
 375 .RE
 376 
 377 .sp
 378 .ne 2
 379 .na
 380 \fB\fBStop-A (L1-A)\fR\fR
 381 .ad
 382 .RS 17n
 383 Abort the current operation and return to the monitor's default prompt.
 384 .RE
 385 
 386 .sp
 387 .ne 2
 388 .na
 389 \fB\fBStop-D (L1-D)\fR\fR
 390 .ad
 391 .RS 17n
 392 Set the system's \fB\&'diag-switch?'\fR \fBNVRAM\fR parameter to
 393 \fB\&'true'\fR, which places the system in diagnostic mode.  POST diagnostics,
 394 if present, are run, and the messages are displayed by way of the system's
 395 serial port A.
 396 .RE
 397 
 398 .sp
 399 .ne 2
 400 .na
 401 \fB\fBStop-F (L1-F)\fR\fR
 402 .ad
 403 .RS 17n
 404 Enter the OpenBoot monitor before the monitor has probed the system for
 405 devices.  Issue the \fB\&'fexit'\fR command to continue with system
 406 initialization.
 407 .RE
 408 
 409 .sp
 410 .ne 2
 411 .na
 412 \fB\fBStop-N (L1-N)\fR\fR
 413 .ad
 414 .RS 17n
 415 Causes the \fBNVRAM\fR parameters to be reset to their default values.  Note
 416 that not all parameters have default values.
 417 .RE
 418 
 419 .SS "Line Editor Commands"
 420 The following commands can be used while the monitor is displaying the \fBok\fR
 421 prompt.  Not all of these editing commands are available on all workstations.
 422 .sp
 423 .ne 2
 424 .na
 425 \fB\fBCTRL-A\fR\fR
 426 .ad
 427 .RS 10n
 428 Place the cursor at the start of line.
 429 .RE
 430 
 431 .sp
 432 .ne 2
 433 .na
 434 \fB\fBCTRL-B\fR\fR
 435 .ad
 436 .RS 10n
 437 Move the cursor backward one character.
 438 .RE
 439 
 440 .sp
 441 .ne 2
 442 .na
 443 \fB\fBESC-B\fR\fR
 444 .ad
 445 .RS 10n
 446 Move the cursor backward one word.
 447 .RE
 448 
 449 .sp
 450 .ne 2
 451 .na
 452 \fB\fBCTRL-D\fR\fR
 453 .ad
 454 .RS 10n
 455 Erase the character that the cursor is currently highlighting.
 456 .RE
 457 
 458 .sp
 459 .ne 2
 460 .na
 461 \fB\fBESC-D\fR\fR
 462 .ad
 463 .RS 10n
 464 Erase the portion of word from the cursor's present position to the end of the
 465 word.
 466 .RE
 467 
 468 .sp
 469 .ne 2
 470 .na
 471 \fB\fBCTRL-E\fR\fR
 472 .ad
 473 .RS 10n
 474 Place the cursor at the end of line.
 475 .RE
 476 
 477 .sp
 478 .ne 2
 479 .na
 480 \fB\fBCTRL-F\fR\fR
 481 .ad
 482 .RS 10n
 483 Move the cursor forward one character.
 484 .RE
 485 
 486 .sp
 487 .ne 2
 488 .na
 489 \fB\fBESC-F\fR\fR
 490 .ad
 491 .RS 10n
 492 Move the cursor forward one word.
 493 .RE
 494 
 495 .sp
 496 .ne 2
 497 .na
 498 \fB\fBCTRL-H\fR\fR
 499 .ad
 500 .RS 10n
 501 Erase the character preceding the cursor (also use Delete or Back Space)
 502 .RE
 503 
 504 .sp
 505 .ne 2
 506 .na
 507 \fB\fBESC-H\fR\fR
 508 .ad
 509 .RS 10n
 510 Erase the portion of the word which precedes the cursor (use also \fBCTRL-W)\fR
 511 .RE
 512 
 513 .sp
 514 .ne 2
 515 .na
 516 \fB\fBCTRL-K\fR\fR
 517 .ad
 518 .RS 10n
 519 Erase from the cursor's present position to the end of the line.
 520 .RE
 521 
 522 .sp
 523 .ne 2
 524 .na
 525 \fB\fBCTRL-L\fR\fR
 526 .ad
 527 .RS 10n
 528 Show the command history list.
 529 .RE
 530 
 531 .sp
 532 .ne 2
 533 .na
 534 \fB\fBCTRL-N\fR\fR
 535 .ad
 536 .RS 10n
 537 Recall the next command from the command history list
 538 .RE
 539 
 540 .sp
 541 .ne 2
 542 .na
 543 \fB\fBCTRL-P\fR\fR
 544 .ad
 545 .RS 10n
 546 Recall a previous command from the command history list.
 547 .RE
 548 
 549 .sp
 550 .ne 2
 551 .na
 552 \fB\fBCTRL-Q\fR\fR
 553 .ad
 554 .RS 10n
 555 Quote the next character (used to type a control character).
 556 .RE
 557 
 558 .sp
 559 .ne 2
 560 .na
 561 \fB\fBCTRL-R\fR\fR
 562 .ad
 563 .RS 10n
 564 Retype the current line.
 565 .RE
 566 
 567 .sp
 568 .ne 2
 569 .na
 570 \fB\fBCTRL-U\fR\fR
 571 .ad
 572 .RS 10n
 573 Erase from the cursor's present position to the beginning of the line.
 574 .RE
 575 
 576 .sp
 577 .ne 2
 578 .na
 579 \fB\fBCTRL-Y\fR\fR
 580 .ad
 581 .RS 10n
 582 Insert the contents of the memory buffer into the line, in front (to the left)
 583 of the cursor.
 584 .RE
 585 
 586 .SS "nvramrc"
 587 The \fBnvramrc\fR is an area of the system's \fBNVRAM\fR where users may store
 588 Forth programs. The programs which are stored in the \fBnvramrc\fR are executed
 589 each time the system is reset, provided that the \fB\&'use-nvramrc?'\fR
 590 \fBNVRAM\fR parameter has been set to \fB\&'true'\fR. Refer to the book for
 591 information on how to edit and use the \fBnvramrc\fR.
 592 .SS "Restricted Monitor"
 593 The command \fB\&'old-mode'\fR is used to move OpenBoot into a restricted
 594 monitor mode, causing the \fB> \fR prompt to be displayed.  Only three commands
 595 are allowed while in the restricted monitor; the \fB\&'go'\fR command (to
 596 resume a program which was interrupted with the \fBStop-A\fR command), the
 597 \fB\&'n'\fR command (to return to the normal OpenBoot monitor), and boot
 598 commands.  The restricted monitor's boot commands approximate the older
 599 \fBSunMON\fR monitor's boot command syntax. If a \fB\&'security-mode'\fR has
 600 been turned on then the restricted monitor becomes the default monitor
 601 environment.  The restricted monitor may also become the default environment if
 602 the \fB\&'sunmon-compat?' \fR \fBNVRAM\fR parameter is set to true.  Not all
 603 workstations have the \fB\&'sunmon-compat?'\fR parameter.
 604 .SH SUNMON PROM USAGE
 605 The following commands are available systems with older  \fBSunMON\fR-based
 606 PROM:
 607 .sp
 608 .ne 2
 609 .na
 610 \fB\fB+\fR|\fB\(mi\fR\fR
 611 .ad
 612 .sp .6
 613 .RS 4n
 614 Increment or decrement the current address and display the contents of the new
 615 location.
 616 .RE
 617 
 618 .sp
 619 .ne 2
 620 .na
 621 \fB\fB^C\fR\fI source destination n\fR\fR
 622 .ad
 623 .sp .6
 624 .RS 4n
 625 (caret-C) Copy, byte-by-byte, a block of length \fIn\fR from the \fBsource\fR
 626 address to the \fIdestination\fR address.
 627 .RE
 628 
 629 .sp
 630 .ne 2
 631 .na
 632 \fB\fB^I \fR\fIprogram\fR\fR
 633 .ad
 634 .sp .6
 635 .RS 4n
 636 (caret-I) Display the compilation date and location of \fIprogram\fR.
 637 .RE
 638 
 639 .sp
 640 .ne 2
 641 .na
 642 \fB\fB^T \fR\fIvirtual_address\fR\fR
 643 .ad
 644 .sp .6
 645 .RS 4n
 646 (caret-T) Display the physical address to which \fIvirtual_address\fR is
 647 mapped.
 648 .RE
 649 
 650 .sp
 651 .ne 2
 652 .na
 653 \fB\fBb\fR [ \fB!\fR ] [ \fIdevice\fR [
 654 \fB(\fR\fIc\fR\fB,\fR\fIu\fR\fB,\fR\fIp\|\fR\fB)\fR\fI\fR ] ] [ \fIpathname\fR
 655 ] [ \fIarguments_list\fR ]\fR
 656 .ad
 657 .sp .6
 658 .RS 4n
 659 
 660 .RE
 661 
 662 .sp
 663 .ne 2
 664 .na
 665 \fB\fBb\fR[\fB?\fR]\fR
 666 .ad
 667 .sp .6
 668 .RS 4n
 669 Reset appropriate parts of the system and bootstrap a program.  A `\fB!\fR'
 670 (preceding the \fIdevice\fR argument) prevents the system reset from occurring.
 671 Programs can be loaded from various devices (such as a disk, tape, or
 672 Ethernet). `\fBb\fR' with no arguments causes a default boot, either from a
 673 disk, or from an Ethernet controller. `\fBb?\fR' displays all boot devices and
 674 their \fIdevice\fRs.
 675 .sp
 676 .ne 2
 677 .na
 678 \fB\fIdevice\fR\fR
 679 .ad
 680 .RS 18n
 681 one of
 682 .sp
 683 .ne 2
 684 .na
 685 \fB\fBle\fR\fR
 686 .ad
 687 .RS 6n
 688 Lance Ethernet
 689 .RE
 690 
 691 .sp
 692 .ne 2
 693 .na
 694 \fB\fBie\fR\fR
 695 .ad
 696 .RS 6n
 697 Intel Ethernet
 698 .RE
 699 
 700 .sp
 701 .ne 2
 702 .na
 703 \fB\fBsd\fR\fR
 704 .ad
 705 .RS 6n
 706 \fBSCSI\fR disk, CDROM
 707 .RE
 708 
 709 .sp
 710 .ne 2
 711 .na
 712 \fB\fBst\fR\fR
 713 .ad
 714 .RS 6n
 715 \fBSCSI\fR 1/4" or 1/2" tape
 716 .RE
 717 
 718 .sp
 719 .ne 2
 720 .na
 721 \fB\fBfd\fR\fR
 722 .ad
 723 .RS 6n
 724 Diskette
 725 .RE
 726 
 727 .sp
 728 .ne 2
 729 .na
 730 \fB\fBid\fR\fR
 731 .ad
 732 .RS 6n
 733 IPI disk
 734 .RE
 735 
 736 .sp
 737 .ne 2
 738 .na
 739 \fB\fBmt\fR\fR
 740 .ad
 741 .RS 6n
 742 Tape Master 9-track 1/2" tape
 743 .RE
 744 
 745 .sp
 746 .ne 2
 747 .na
 748 \fB\fBxd\fR\fR
 749 .ad
 750 .RS 6n
 751 Xylogics 7053 disk
 752 .RE
 753 
 754 .sp
 755 .ne 2
 756 .na
 757 \fB\fBxt\fR\fR
 758 .ad
 759 .RS 6n
 760 Xylogics 1/2" tape
 761 .RE
 762 
 763 .sp
 764 .ne 2
 765 .na
 766 \fB\fBxy\fR\fR
 767 .ad
 768 .RS 6n
 769 Xylogics 440/450 disk
 770 .RE
 771 
 772 .RE
 773 
 774 .sp
 775 .ne 2
 776 .na
 777 \fB\fIc\fR\fR
 778 .ad
 779 .RS 18n
 780 A controller number (\fB0\fR if only one controller),
 781 .RE
 782 
 783 .sp
 784 .ne 2
 785 .na
 786 \fB\fIu\fR\fR
 787 .ad
 788 .RS 18n
 789 A unit number (\fB0\fR if only one driver), and
 790 .RE
 791 
 792 .sp
 793 .ne 2
 794 .na
 795 \fB\fIp\fR\fR
 796 .ad
 797 .RS 18n
 798 A partition.
 799 .RE
 800 
 801 .sp
 802 .ne 2
 803 .na
 804 \fB\fIpathname\fR\fR
 805 .ad
 806 .RS 18n
 807 A pathname for a program such as \fB/stand/diag\fR.
 808 .RE
 809 
 810 .sp
 811 .ne 2
 812 .na
 813 \fB\fIarguments_list\fR\fR
 814 .ad
 815 .RS 18n
 816 A list of up to seven arguments to pass to the program being booted.
 817 .RE
 818 
 819 .RE
 820 
 821 .sp
 822 .ne 2
 823 .na
 824 \fB\fBc [\fR\fIvirtual_address\fR\fB]\fR\fR
 825 .ad
 826 .sp .6
 827 .RS 4n
 828 Resume execution of a program. When given, \fIvirtual_address\fR is the address
 829 at which execution resumes. The default is the current \fBPC.\fR Registers are
 830 restored to the values shown by the \fBd\fR, and \fBr\fR commands.
 831 .RE
 832 
 833 .sp
 834 .ne 2
 835 .na
 836 \fB\fBd [\fR\fIwindow_number\fR\fB]\fR\fR
 837 .ad
 838 .sp .6
 839 .RS 4n
 840 Display (dump) the state of the processor. The processor state is observable
 841 only after:
 842 .RS +4
 843 .TP
 844 .ie t \(bu
 845 .el o
 846 An unexpected trap was encountered.
 847 .RE
 848 .RS +4
 849 .TP
 850 .ie t \(bu
 851 .el o
 852 A user program dropped into the monitor (by calling \fIabortent\fR).
 853 .RE
 854 .RS +4
 855 .TP
 856 .ie t \(bu
 857 .el o
 858 The user manually entered the monitor by typing \fBL1\(miA\fR or \fBBREAK.\fR
 859 .RE
 860 The display consists of the following:
 861 .RS +4
 862 .TP
 863 .ie t \(bu
 864 .el o
 865 The special registers: \fBPSR,\fR \fBPC,\fR nPC, \fBTBR,\fR \fBWIM,\fR and Y
 866 .RE
 867 .RS +4
 868 .TP
 869 .ie t \(bu
 870 .el o
 871 Eight global registers
 872 .RE
 873 .RS +4
 874 .TP
 875 .ie t \(bu
 876 .el o
 877 24 window registers (8 \fIin\fR, 8 \fIlocal\fR, and 8 \fIout\fR), corresponding
 878 to one of the 7 available windows.  If a Floating-Point Unit is on board, its
 879 status register along with 32 floating-point registers are also shown.
 880 .RE
 881 .sp
 882 .ne 2
 883 .na
 884 \fB\fIwindow_number\fR\fR
 885 .ad
 886 .RS 17n
 887 Display the indicated \fIwindow_number\fR, which can be any value between
 888 \fB0\fR and \fB6\fR, inclusive.  If no window is specified and the \fBPSR's\fR
 889 current window pointer contains a valid window number, registers from the
 890 window that was active just prior to entry into the monitor are displayed.
 891 Otherwise, registers from window 0 are displayed.
 892 .RE
 893 
 894 .RE
 895 
 896 .sp
 897 .ne 2
 898 .na
 899 \fB\fBe\fR [\fIvirtual_address\fR]\|[\fIaction\fR] .\|.\|.\fR
 900 .ad
 901 .sp .6
 902 .RS 4n
 903 Open the 16-bit word at \fIvirtual_address\fR (default zero).  The address is
 904 interpreted in the address space defined by the \fBs\fR command. See the
 905 \fBa\fR command for a description of \fIaction\fR.
 906 .RE
 907 
 908 .sp
 909 .ne 2
 910 .na
 911 \fB\fBf\fR\fI virtual_address1 virtual_address2 pattern \fR [\fIsize\|\fR]\fR
 912 .ad
 913 .sp .6
 914 .RS 4n
 915 Fill the bytes, words, or long words from \fIvirtual_address1\fR (lower) to
 916 \fIvirtual_address2\fR (higher) with the constant, \fIpattern\fR. The
 917 \fBsize\fR argument can take one of the following values:
 918 .sp
 919 .ne 2
 920 .na
 921 \fB\fBb\fR\fR
 922 .ad
 923 .RS 5n
 924 byte format (the default)
 925 .RE
 926 
 927 .sp
 928 .ne 2
 929 .na
 930 \fB\fBw\fR\fR
 931 .ad
 932 .RS 5n
 933 word format
 934 .RE
 935 
 936 .sp
 937 .ne 2
 938 .na
 939 \fB\fBl\fR\fR
 940 .ad
 941 .RS 5n
 942 long word format
 943 .RE
 944 
 945 For example, the following command fills the address block from \fB0x1000\fR to
 946 \fB0x2000\fR with the word pattern, \fB0xABCD\fR:
 947 .sp
 948 \fBf 1000 2000 ABCD W\fR
 949 .RE
 950 
 951 .sp
 952 .ne 2
 953 .na
 954 \fB\fBg\fR [\fIvector\|\fR] [\fIargument\|\fR]\fR
 955 .ad
 956 .br
 957 .na
 958 \fB\fBg\fR [\fIvirtual_address\|\fR] [\fIargument\fR\|]\fR
 959 .ad
 960 .sp .6
 961 .RS 4n
 962 Goto (jump to) a predetermined or default routine (first form), or to a
 963 user-specified routine (second form).  The value of \fIargument\fR is passed to
 964 the routine.  If the \fIvector\fR or \fIvirtual_address\fR argument is omitted,
 965 the value in the \fBPC\fR is used as the address to jump to.
 966 .sp
 967 To set up a predetermined routine to jump to, a user program must, prior to
 968 executing the monitor's \fBg\fR command, set the variable
 969 \fB*romp->v_vector_cmd\fR to be equal to the virtual address of the desired
 970 routine. Predetermined routines need not necessarily return control to the
 971 monitor.
 972 .sp
 973 The default routine, defined by the monitor, prints the user-supplied
 974 \fIvector\fR according to the format supplied in \fIargument\fR. This format
 975 can be one of:
 976 .sp
 977 .ne 2
 978 .na
 979 \fB\fB%x\fR\fR
 980 .ad
 981 .RS 6n
 982 hexadecimal
 983 .RE
 984 
 985 .sp
 986 .ne 2
 987 .na
 988 \fB\fB%d\fR\fR
 989 .ad
 990 .RS 6n
 991 decimal
 992 .RE
 993 
 994 .RE
 995 
 996 .sp
 997 .ne 2
 998 .na
 999 \fB\fBg0\fR\fR
1000 .ad
1001 .sp .6
1002 .RS 4n
1003 Force a panic and produce a crash dump  when the monitor is running as a result
1004 of the system being interrupted,
1005 .RE
1006 
1007 .sp
1008 .ne 2
1009 .na
1010 \fB\fBg4\fR\fR
1011 .ad
1012 .sp .6
1013 .RS 4n
1014 (Sun-4 systems only) Force a kernel stack trace  when the monitor is running as
1015 a result of the system being interrupted,
1016 .RE
1017 
1018 .sp
1019 .ne 2
1020 .na
1021 \fB\fBh\fR\fR
1022 .ad
1023 .sp .6
1024 .RS 4n
1025 Display the help menu for monitor commands and their descriptions. To return to
1026 the monitor's basic command level, press \fBESCAPE\fR or \fBq\fR before
1027 pressing \fBRETURN.\fR
1028 .RE
1029 
1030 .sp
1031 .ne 2
1032 .na
1033 \fB\fBi \fR[\fIcache_data_offset\fR\|] [\fIaction\fR\|]\|.\|.\|.\fR
1034 .ad
1035 .sp .6
1036 .RS 4n
1037 Modify cache data \fBRAM\fR command.  Display and/or modify one or more of the
1038 cache data addresses.  See the \fBa\fR command for a description of
1039 \fIaction\fR.
1040 .RE
1041 
1042 .sp
1043 .ne 2
1044 .na
1045 \fB\fBj\fR [\fIcache_tag_offset\fR\|] [\fIaction\|\fR]\|.\|.\|.\fR
1046 .ad
1047 .sp .6
1048 .RS 4n
1049 Modify cache tag \fBRAM\fR command.  Display and/or modify the contents of one
1050 or more of the cache tag addresses.  See the \fBa\fR command for a description
1051 of \fIaction\fR.
1052 .RE
1053 
1054 .sp
1055 .ne 2
1056 .na
1057 \fB\fBk [\fR\fIreset_level\fR\fB]\fR\fR
1058 .ad
1059 .sp .6
1060 .RS 4n
1061 Reset the system, where \fIreset_level\fR is:
1062 .sp
1063 .ne 2
1064 .na
1065 \fB\fB0\fR\fR
1066 .ad
1067 .RS 5n
1068 Reset \fBVMEbus,\fR interrupt registers, video monitor (Sun-4 systems). This is
1069 the default.
1070 .RE
1071 
1072 .sp
1073 .ne 2
1074 .na
1075 \fB\fB1\fR\fR
1076 .ad
1077 .RS 5n
1078 Software reset.
1079 .RE
1080 
1081 .sp
1082 .ne 2
1083 .na
1084 \fB\fB2\fR\fR
1085 .ad
1086 .RS 5n
1087 Power-on reset. Resets and clears the memory. Runs the \fBEPROM-based\fR
1088 diagnostic self test, which can take several minutes, depending upon how much
1089 memory is being tested.
1090 .RE
1091 
1092 .RE
1093 
1094 .sp
1095 .ne 2
1096 .na
1097 \fB\fBkb\fR\fR
1098 .ad
1099 .sp .6
1100 .RS 4n
1101 Display the system banner.
1102 .RE
1103 
1104 .sp
1105 .ne 2
1106 .na
1107 \fB\fBl\|\fR [\fIvirtual_address\fR\|]\|[\fIaction\fR]\|.\|.\|.\fR
1108 .ad
1109 .sp .6
1110 .RS 4n
1111 Open the long word (32 bit) at memory address \fIvirtual_address\fR (default
1112 zero).  The address is interpreted in the address space defined by the \fBs\fR
1113 command (below).  See the \fBa\fR command for a description of \fIaction\fR.
1114 .RE
1115 
1116 .sp
1117 .ne 2
1118 .na
1119 \fB\fBm\|\fR [\fIvirtual_address\fR\|]\|[\fIaction\fR\|]\|.\|.\|.\fR
1120 .ad
1121 .sp .6
1122 .RS 4n
1123 Open the segment map entry that maps \fIvirtual_address\fR (default zero). The
1124 address is interpreted in the address space defined by the \fBs\fR command. See
1125 the \fBa\fR command for a description of \fIaction\fR.
1126 .RE
1127 
1128 .sp
1129 .ne 2
1130 .na
1131 \fB\fBne\fR\fR
1132 .ad
1133 .sp .6
1134 .RS 4n
1135 
1136 .RE
1137 
1138 .sp
1139 .ne 2
1140 .na
1141 \fB\fBni\fR\fR
1142 .ad
1143 .sp .6
1144 .RS 4n
1145 Disable, enable, or invalidate the cache, respectively.
1146 .RE
1147 
1148 .sp
1149 .ne 2
1150 .na
1151 \fB\fBo\|\fR [\fIvirtual_address\fR\|]\|[action\fI]\|.\|.\|.\fR\fR
1152 .ad
1153 .sp .6
1154 .RS 4n
1155 Open the byte location specified  by \fIvirtual_address\fR (default zero).  The
1156 address is interpreted in the address space defined by the \fBs\fR command. See
1157 the \fBa\fR command for a description of \fIaction\fR.
1158 .RE
1159 
1160 .sp
1161 .ne 2
1162 .na
1163 \fB\fBp\|\fR [\fIvirtual_address\fR\|]\|[\fIaction\fR].\|.\|.\fR
1164 .ad
1165 .sp .6
1166 .RS 4n
1167 Open the page map entry that maps \fIvirtual_address\fR (default zero) in the
1168 address space defined by the \fBs\fR command. See the \fBa\fR command for a
1169 description of \fIaction\fR.
1170 .RE
1171 
1172 .sp
1173 .ne 2
1174 .na
1175 \fB\fBq\|\fR [\fIeeprom_offset\fR\|]\|[\fIaction\fR\|].\|.\|.\fR
1176 .ad
1177 .sp .6
1178 .RS 4n
1179 Open the \fBEEPROM\fR \fIeeprom_offset\fR (default zero) in the \fBEEPROM\fR
1180 address space. All addresses are referenced from the beginning or base of the
1181 \fBEEPROM\fR in physical address space, and a limit check is performed to
1182 insure that no address beyond the \fBEEPROM\fR physical space is accessed. This
1183 command is used to display or modify configuration parameters, such as: the
1184 amount of memory to test during self test, whether to display a standard or
1185 custom banner, if a serial port (A or B) is to be the system console, etc. See
1186 the \fBa\fR command for a description of \fIaction\fR.
1187 .RE
1188 
1189 .sp
1190 .ne 2
1191 .na
1192 \fB\fBr\|\fR [\fIregister_number\|\fR]\fR
1193 .ad
1194 .br
1195 .na
1196 \fB\fBr\|\fR [\fIregister_type\|\fR]\fR
1197 .ad
1198 .br
1199 .na
1200 \fB\fBr\|\fR [\fIw window_number\|\fR]\fR
1201 .ad
1202 .sp .6
1203 .RS 4n
1204 Display and/or modify one or more of the \fBIU\fR or \fBFPU\fR registers. A
1205 hexadecimal \fIregister_number\fR can be one of:
1206 .sp
1207 .ne 2
1208 .na
1209 \fB\fB0x00\fR\(mi\fB0x0f\fR\fR
1210 .ad
1211 .RS 16n
1212 window(0,i0)\(miwindow(0,i7), window(0,i0)\(emwindow(0,i7)
1213 .RE
1214 
1215 .sp
1216 .ne 2
1217 .na
1218 \fB\fB0x16\fR\(mi\fB0x1f\fR\fR
1219 .ad
1220 .RS 16n
1221 window(1,i0)\(miwindow(1,i7), window(1,i0)\(emwindow(1,i7)
1222 .RE
1223 
1224 .sp
1225 .ne 2
1226 .na
1227 \fB\fB0x20\fR\(mi\fB0x2f\fR\fR
1228 .ad
1229 .RS 16n
1230 window(2,i0)\(miwindow(2,i7), window(2,i0)\(emwindow(2,i7)
1231 .RE
1232 
1233 .sp
1234 .ne 2
1235 .na
1236 \fB\fB0x30\fR\(mi\fB0x3f\fR\fR
1237 .ad
1238 .RS 16n
1239 window(3,i0)\(miwindow(3,i7), window(3,i0)\(emwindow(3,i7)
1240 .RE
1241 
1242 .sp
1243 .ne 2
1244 .na
1245 \fB\fB0x40\fR\(mi\fB0x4f\fR\fR
1246 .ad
1247 .RS 16n
1248 window(4,i0)\(miwindow(4,i7), window(4,i0)\(emwindow(4,i7)
1249 .RE
1250 
1251 .sp
1252 .ne 2
1253 .na
1254 \fB\fB0x50\fR\(mi\fB0x5f\fR\fR
1255 .ad
1256 .RS 16n
1257 window(5,i0)\(miwindow(5,i7), window(5,i0)\(emwindow(5,i7)
1258 .RE
1259 
1260 .sp
1261 .ne 2
1262 .na
1263 \fB\fB0x60\fR\(mi\fB0x6f\fR\fR
1264 .ad
1265 .RS 16n
1266 window(6,i0)\(miwindow(6,i7), window(6,i0)\(emwindow(6,i7)
1267 .RE
1268 
1269 .sp
1270 .ne 2
1271 .na
1272 \fB\fB0x70\fR\(mi\fB0x77\fR\fR
1273 .ad
1274 .RS 16n
1275 \fBg0, g1, g2, g3, g4, g5, g6, g7\fR
1276 .RE
1277 
1278 .sp
1279 .ne 2
1280 .na
1281 \fB\fB0x78\fR\(mi\fB0x7d\fR\fR
1282 .ad
1283 .RS 16n
1284 \fBPSR,\fR \fBPC,\fR \fBnPC,\fR \fBWIM,\fR \fBTBR,\fR \fBY.\fR
1285 .RE
1286 
1287 .sp
1288 .ne 2
1289 .na
1290 \fB\fB0x7e\fR\(mi\fB0x9e\fR\fR
1291 .ad
1292 .RS 16n
1293 \fBFSR,\fR f0\(mif31
1294 .RE
1295 
1296 Register numbers can only be displayed after an unexpected trap, a user program
1297 has entered the monitor using the \fIabortent\fR function, or the user has
1298 entered the monitor by manually typing \fBL1\(miA\fR or \fBBREAK.\fR
1299 .sp
1300 If a \fIregister_type\fR is given, the first register of the indicated type is
1301 displayed. \fIregister_type\fR can be one of:
1302 .sp
1303 .ne 2
1304 .na
1305 \fB\fBf\fR\fR
1306 .ad
1307 .RS 5n
1308 floating-point
1309 .RE
1310 
1311 .sp
1312 .ne 2
1313 .na
1314 \fB\fBg\fR\fR
1315 .ad
1316 .RS 5n
1317 global
1318 .RE
1319 
1320 .sp
1321 .ne 2
1322 .na
1323 \fB\fBs\fR\fR
1324 .ad
1325 .RS 5n
1326 special
1327 .RE
1328 
1329 If \fBw\fR and a \fIwindow_number\fR (\fB0\fR\(em\fB6\fR) are given, the first
1330 \fIin\fR-register within the indicated window is displayed.  If
1331 \fIwindow_number\fR is omitted, the window that was active just prior to
1332 entering the monitor is used.  If the \fBPSR's\fR current window pointer is
1333 invalid, window 0 is used.
1334 .RE
1335 
1336 .sp
1337 .ne 2
1338 .na
1339 \fB\fBs [\fR\fIasi\fR\fB])\fR\fR
1340 .ad
1341 .sp .6
1342 .RS 4n
1343 Set or display the Address Space Identifier.  With no argument, \fBs\fR
1344 displays the current Address Space Identifier.  The \fIasi\fR value can be one
1345 of:
1346 .sp
1347 .ne 2
1348 .na
1349 \fB\fB0x2\fR\fR
1350 .ad
1351 .RS 7n
1352 control space
1353 .RE
1354 
1355 .sp
1356 .ne 2
1357 .na
1358 \fB\fB0x3\fR\fR
1359 .ad
1360 .RS 7n
1361 segment table
1362 .RE
1363 
1364 .sp
1365 .ne 2
1366 .na
1367 \fB\fB0x4\fR\fR
1368 .ad
1369 .RS 7n
1370 Page table
1371 .RE
1372 
1373 .sp
1374 .ne 2
1375 .na
1376 \fB\fB0x8\fR\fR
1377 .ad
1378 .RS 7n
1379 user instruction
1380 .RE
1381 
1382 .sp
1383 .ne 2
1384 .na
1385 \fB\fB0x9\fR\fR
1386 .ad
1387 .RS 7n
1388 supervisor instruction
1389 .RE
1390 
1391 .sp
1392 .ne 2
1393 .na
1394 \fB\fB0xa\fR\fR
1395 .ad
1396 .RS 7n
1397 user data
1398 .RE
1399 
1400 .sp
1401 .ne 2
1402 .na
1403 \fB\fB0xb\fR\fR
1404 .ad
1405 .RS 7n
1406 supervisor data
1407 .RE
1408 
1409 .sp
1410 .ne 2
1411 .na
1412 \fB\fB0xc\fR\fR
1413 .ad
1414 .RS 7n
1415 flush segment
1416 .RE
1417 
1418 .sp
1419 .ne 2
1420 .na
1421 \fB\fB0xd\fR\fR
1422 .ad
1423 .RS 7n
1424 flush page
1425 .RE
1426 
1427 .sp
1428 .ne 2
1429 .na
1430 \fB\fB0xe\fR\fR
1431 .ad
1432 .RS 7n
1433 flush context
1434 .RE
1435 
1436 .sp
1437 .ne 2
1438 .na
1439 \fB\fB0xf\fR\fR
1440 .ad
1441 .RS 7n
1442 cache data
1443 .RE
1444 
1445 .RE
1446 
1447 .sp
1448 .ne 2
1449 .na
1450 \fB\fBu\fR [ \fBecho\fR ]\fR
1451 .ad
1452 .sp .6
1453 .RS 4n
1454 
1455 .RE
1456 
1457 .sp
1458 .ne 2
1459 .na
1460 \fB\fBu\fR [ \fIport\fR ] [ \fIoptions\fR ] [ \fIbaud_rate\fR ]\fR
1461 .ad
1462 .sp .6
1463 .RS 4n
1464 
1465 .RE
1466 
1467 .sp
1468 .ne 2
1469 .na
1470 \fB\fBu\fR [ \fBu\fR ] [ \fIvirtual_address\fR ]\fR
1471 .ad
1472 .sp .6
1473 .RS 4n
1474 With no arguments, display the current I/O device characteristics including:
1475 current input device, current output device, baud rates for serial ports A and
1476 B, an input-to-output echo indicator, and virtual addresses of mapped
1477 \fBUART\fR devices. With arguments, set or configure the current I/O device.
1478 With the \fBu\fR argument (\fBuu\fR.\|.\|.), set the I/O device to be the
1479 \fIvirtual_address\fR of a \fBUART\fR device currently mapped.
1480 .sp
1481 .ne 2
1482 .na
1483 \fB\fBecho\fR\fR
1484 .ad
1485 .RS 13n
1486  Can be either \fBe\fR to enable input to be echoed to the output device, or
1487 \fBne\fR, to indicate that input is not echoed.
1488 .RE
1489 
1490 .sp
1491 .ne 2
1492 .na
1493 \fB\fIport\fR\fR
1494 .ad
1495 .RS 13n
1496 Assign the indicated \fIport\fR to be the current I/O device. \fIport\fR can be
1497 one of:
1498 .sp
1499 .ne 2
1500 .na
1501 \fB\fBa\fR\fR
1502 .ad
1503 .RS 5n
1504 serial port A
1505 .RE
1506 
1507 .sp
1508 .ne 2
1509 .na
1510 \fB\fBb\fR\fR
1511 .ad
1512 .RS 5n
1513 serial port B
1514 .RE
1515 
1516 .sp
1517 .ne 2
1518 .na
1519 \fB\fBk\fR\fR
1520 .ad
1521 .RS 5n
1522 the workstation keyboard
1523 .RE
1524 
1525 .sp
1526 .ne 2
1527 .na
1528 \fB\fBs\fR\fR
1529 .ad
1530 .RS 5n
1531 the workstation screen
1532 .RE
1533 
1534 .RE
1535 
1536 .sp
1537 .ne 2
1538 .na
1539 \fB\fIbaud_rate\fR\fR
1540 .ad
1541 .RS 13n
1542 Any legal baud rate.
1543 .RE
1544 
1545 .sp
1546 .ne 2
1547 .na
1548 \fB\fIoptions\fR\fR
1549 .ad
1550 .RS 11n
1551 can be any combination of:
1552 .sp
1553 .ne 2
1554 .na
1555 \fB\fBi\fR\fR
1556 .ad
1557 .RS 6n
1558 input
1559 .RE
1560 
1561 .sp
1562 .ne 2
1563 .na
1564 \fB\fBo\fR\fR
1565 .ad
1566 .RS 6n
1567 output
1568 .RE
1569 
1570 .sp
1571 .ne 2
1572 .na
1573 \fB\fBu\fR\fR
1574 .ad
1575 .RS 6n
1576 \fBUART\fR
1577 .RE
1578 
1579 .sp
1580 .ne 2
1581 .na
1582 \fB\fBe\fR\fR
1583 .ad
1584 .RS 6n
1585 echo input to output
1586 .RE
1587 
1588 .sp
1589 .ne 2
1590 .na
1591 \fB\fBne\fR\fR
1592 .ad
1593 .RS 6n
1594 do not echo input
1595 .RE
1596 
1597 .sp
1598 .ne 2
1599 .na
1600 \fB\fBr\fR\fR
1601 .ad
1602 .RS 6n
1603 reset indicated serial port (\fBa\fR and \fBb\fR ports only)
1604 .RE
1605 
1606 If either \fBa\fR or \fBb\fR is supplied, and no \fIoptions\fR are given, the
1607 serial port is assigned for both input and output.  If \fBk\fR is supplied with
1608 no options, it is assigned for input only.  If \fBs\fR is supplied with no
1609 options, it is assigned for output only.
1610 .RE
1611 
1612 .RE
1613 
1614 .sp
1615 .ne 2
1616 .na
1617 \fB\fBv\fR\fI virtual_address1 virtual_address2 \fR [\fBsize\fR]\fR
1618 .ad
1619 .sp .6
1620 .RS 4n
1621 Display the contents of \fIvirtual_address1\fR (lower) \fIvirtual_address2\fR
1622 (higher) in the format specified by \fBsize\fR:
1623 .sp
1624 .ne 2
1625 .na
1626 \fB\fBb\fR\fR
1627 .ad
1628 .RS 5n
1629 byte format (the default)
1630 .RE
1631 
1632 .sp
1633 .ne 2
1634 .na
1635 \fB\fBw\fR\fR
1636 .ad
1637 .RS 5n
1638 word format
1639 .RE
1640 
1641 .sp
1642 .ne 2
1643 .na
1644 \fB\fBl\fR\fR
1645 .ad
1646 .RS 5n
1647 long word format
1648 .RE
1649 
1650 Enter return to pause for viewing; enter another return character to resume the
1651 display.  To terminate the display at any time, press the space bar.
1652 .sp
1653 For example, the following command displays the contents of virtual address
1654 space from address  \fB0x1000\fR to  \fB0x2000\fR in word format:
1655 .sp
1656 \fBv\fR \fB1000\fR \fB2000\fR \fBW\fR
1657 .RE
1658 
1659 .sp
1660 .ne 2
1661 .na
1662 \fB\fBw\|\fR [\fIvirtual_address\|\fR]\|[\fIargument\|\fR]\fR
1663 .ad
1664 .sp .6
1665 .RS 4n
1666 Set the execution vector to a predetermined or default routine. Pass
1667 \fIvirtual_address\fR and \fIargument\fR to that routine.
1668 .sp
1669 To set up a predetermined routine to jump to, a user program must, prior to
1670 executing the monitor's \fBw\fR command, set the variable
1671 \fB*romp->v_vector_cmd\fR to be equal to the virtual address of the desired
1672 routine. Predetermined routines need not necessarily return control to the
1673 monitor.
1674 .sp
1675 The default routine, defined by the monitor, prints the user-supplied
1676 \fIvector\fR according to the format supplied in \fIargument\fR. This format
1677 can be one of:
1678 .sp
1679 .ne 2
1680 .na
1681 \fB\fB%x\fR\fR
1682 .ad
1683 .RS 6n
1684 hexadecimal
1685 .RE
1686 
1687 .sp
1688 .ne 2
1689 .na
1690 \fB\fB%d\fR\fR
1691 .ad
1692 .RS 6n
1693 decimal
1694 .RE
1695 
1696 .RE
1697 
1698 .sp
1699 .ne 2
1700 .na
1701 \fB\fBx\fR\fR
1702 .ad
1703 .sp .6
1704 .RS 4n
1705 Display a menu of extended tests. These diagnostics permit additional testing
1706 of such things as the I/O port connectors, video memory, workstation memory and
1707 keyboard, and boot device paths.
1708 .RE
1709 
1710 .sp
1711 .ne 2
1712 .na
1713 \fB\fBy\|c\fR\fI context_number\fR\fR
1714 .ad
1715 .sp .6
1716 .RS 4n
1717 
1718 .RE
1719 
1720 .sp
1721 .ne 2
1722 .na
1723 \fB\fBy\|p|s\|\fR\fI context_number virtual_address\fR\fR
1724 .ad
1725 .sp .6
1726 .RS 4n
1727 Flush the indicated context, context page, or context segment.
1728 .sp
1729 .ne 2
1730 .na
1731 \fB\fBc\fR\fR
1732 .ad
1733 .RS 5n
1734 flush context \fIcontext_number\fR
1735 .RE
1736 
1737 .sp
1738 .ne 2
1739 .na
1740 \fB\fBp\fR\fR
1741 .ad
1742 .RS 5n
1743 flush the page beginning at \fIvirtual_address\fR within context
1744 \fIcontext_number\fR
1745 .RE
1746 
1747 .sp
1748 .ne 2
1749 .na
1750 \fB\fBs\fR\fR
1751 .ad
1752 .RS 5n
1753 flush the segment beginning at \fIvirtual_address\fR within context
1754 \fIcontext_number\fR
1755 .RE
1756 
1757 .RE
1758 
1759 .SH ATTRIBUTES
1760 See \fBattributes\fR(5) for descriptions of the following attributes:
1761 .sp
1762 
1763 .sp
1764 .TS
1765 box;
1766 c | c
1767 l | l .
1768 ATTRIBUTE TYPE  ATTRIBUTE VALUE
1769 _
1770 Architecture    SPARC
1771 .TE
1772 
1773 .SH SEE ALSO
1774 \fBtip\fR(1), \fBboot\fR(1M), \fBeeprom\fR(1M), \fBattributes\fR(5)