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