Print this page
11622 clean up rarer mandoc lint warnings
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man1m/monitor.1m.man.txt
+++ new/usr/src/man/man1m/monitor.1m.man.txt
1 1 MONITOR(1M) Maintenance Commands MONITOR(1M)
2 2
3 3
4 4
5 5 NAME
6 6 monitor - SPARC system PROM monitor
7 7
8 8 SYNOPSIS
9 9 STOP-A
10 10
11 11
12 12 BREAK
13 13
14 14
15 15 initial system power-on
16 16
17 17
18 18 exit from a client program, e.g., the Operating System
19 19
20 20
21 21 DESCRIPTION
22 22 The CPU board of a workstation contains one or more EPROMs or EEPROMs.
23 23 The program which executes from the PROMs is referred to as "the
24 24 monitor". Among other things, the monitor performs system
25 25 initialization at power-on and provides a user interface.
26 26
27 27 Monitor Prompt
28 28 The monitor of earlier workstations was known as the SunMON monitor and
29 29 displayed the > for its prompt. See the SunMON MONITOR USAGE section
30 30 for further details.
31 31
32 32
33 33 Existing workstations use a monitor which is known as the OpenBoot
34 34 monitor. The OpenBoot monitor typically displays ok as its prompt, but
35 35 it may also display the > prompt under certain circumstances.
36 36
37 37
38 38 If the 'auto-boot?' NVRAM parameter is set to 'false' when the
39 39 workstation is powered on, the system does not attempt to boot and the
40 40 monitor issues its prompt. If 'auto-boot' is set to 'true', the system
41 41 initiates the boot sequence. The boot sequence can be aborted by
42 42 simultaneously pressing two keys on the system's keyboard: L1 and A (on
43 43 older keyboards), or Stop and A (on newer keyboards). Either a lower
44 44 case a or an upper case A works for the keyboard abort sequence. If a
45 45 console has been attached by way of one of the system's serial ports
46 46 then the abort sequence can be accomplished by sending a BREAK. See
47 47 tip(1).
48 48
49 49
50 50 When the NVRAM 'security-mode' parameter has been turned on, or when
51 51 the value of the 'sunmon-compat?' parameter is true, then the OpenBoot
52 52 monitor displays the message: Type b (boot), c (continue), or n (new
53 53 command mode)
54 54
55 55
56 56 and the > prompt appears.
57 57
58 58 OPENBOOT PROM USAGE
59 59 Some of the more useful commands that can be issued from OpenBoot's ok
60 60 prompt are described here. Refer to the book for a complete list of
61 61 commands.
62 62
63 63 Help
64 64 Help for various functional areas of the OpenBoot monitor can be
65 65 obtained by typing help. The help listing provides a number of other
66 66 key words which can then be used in the help command to provide further
67 67 details.
68 68
69 69 NVRAM Parameters
70 70 Each workstation contains one or more NVRAM devices which contains
71 71 unique system ID information, as well as a set of user-configurable
72 72 parameters. The NVRAM parameters allow the user a certain level of
73 73 flexibility in configuring the system to act in a given manner under a
74 74 specific set of circumstances.
75 75
76 76
77 77 See eeprom(1M) for a description of the parameters and information
78 78 regarding setting the parameters from the OS level.
79 79
80 80
81 81 The following commands can be used at the OpenBoot monitor to access
82 82 the NVRAM parameters.
83 83
84 84 printenv
85 85 Used to list the NVRAM parameters, along with their
86 86 default values and current values.
87 87
88 88
89 89 setenv pn pv
90 90 Used to set or modify a parameter. The pn represents
91 91 the parameter name, and pv represents the parameter
92 92 value.
93 93
94 94
95 95 set-default pn
96 96 Used to set an individual parameter back to its
97 97 default value.
98 98
99 99
100 100 set-defaults
101 101 Used to reset all parameters to their default values.
102 102 (Note that 'set-defaults' only affects parameters
103 103 that have assigned default values.)
104 104
105 105
106 106 Security Parameters
107 107 Newer OpenBoot monitors contain user interfaces that support the
108 108 storage and listing of keys for later use by client programs.
109 109
110 110 list-security-keys
111 111
112 112 Lists the names of keys currently stored on a machine.
113 113
114 114
115 115 set-security-key keyname [ keydata ]
116 116
117 117 Stores key data keydata in a key named keyname. Actual key data can
118 118 be up to 32 bytes in length. The maximum length of keyname is 64
119 119 bytes, which allows for the hex-formatted ASCII used to present the
120 120 key data. If keydata is not present, keyname and its corresponding
121 121 data is deleted.
122 122
123 123
124 124 Hardware Checks and Diagnostics
125 125 The following commands are available for testing or checking the
126 126 system's hardware. If the 'diag-switch?' NVRAM parameter is set to
127 127 true when the system is powered on, then a Power-On Self Test (POST)
128 128 diagnostic is run, if present, sending its results messages to the
129 129 system's serial port A. Not all of the commands shown are available on
130 130 all workstations.
131 131
132 132 test-all
133 133 Run the diagnostic tests on each device which has
134 134 provided a self-test.
135 135
136 136
137 137 test floppy
138 138 Run diagnostics on the system's floppy device.
139 139
140 140
141 141 test /memory
142 142 Run the main memory tests. If the NVRAM parameter
143 143 'diag-switch?' is set to true, then all of main memory
144 144 is tested. If the parameter is false then only the
145 145 amount of memory specified in the 'selftest-#megs'
146 146 NVRAM parameter is tested.
147 147
148 148
149 149 test net
150 150 Test the network connection for the on-board network
151 151 controller.
152 152
153 153
154 154 watch-net
155 155 Monitor the network attached to the on-board net
156 156 controller.
157 157
158 158
159 159 watch-net-all
160 160 Monitor the network attached to the on-board net
161 161 controller, as well as the network controllers
162 162 installed in SBus slots.
163 163
164 164
165 165 watch-clock
166 166 Test the system's clock function.
167 167
168 168
169 169 System Information
170 170 The following commands are available for displaying information about
171 171 the system. Not all commands are available on all workstations.
172 172
173 173 banner
174 174 Display the power-on banner.
175 175
176 176
177 177 .enet-addr
178 178 Display the system's Ethernet address.
179 179
180 180
181 181 .idprom
182 182 Display the formatted contents of the IDPROM.
183 183
184 184
185 185 module-info
186 186 Display information about the system's processor(s).
187 187
188 188
189 189 probe-scsi
190 190 Identify the devices attached to the on-board SCSI
191 191 controller.
192 192
193 193
194 194 probe-scsi-all
195 195 Identify the devices attached to the on-board SCSI
196 196 controller as well as those devices which are
197 197 attached to SBus SCSI controllers.
198 198
199 199
200 200 show-disks
201 201 Display a list of the device paths for installed SCSI
202 202 disk controllers.
203 203
204 204
205 205 show-displays
206 206 Display a list of the device paths for installed
207 207 display devices.
208 208
209 209
210 210 show-nets
211 211 Display a list of the device paths for installed
212 212 Ethernet controllers.
213 213
214 214
215 215 show-sbus
216 216 Display list of installed SBus devices.
217 217
218 218
219 219 show-tapes
220 220 Display a list of the device paths for installed SCSI
221 221 tape controllers.
222 222
223 223
224 224 show-ttys
225 225 Display a list of the device paths for tty devices.
226 226
227 227
228 228 .traps
229 229 Display a list of the SPARC trap types.
230 230
231 231
232 232 .version
233 233 Display the version and date of the OpenBoot PROM.
234 234
235 235
236 236 Emergency Commands
237 237 These commands must be typed from the keyboard, they do not work from a
238 238 console which is attached by way of the serial ports. With the
239 239 exception of the Stop-A command, these commands are issued by pressing
240 240 and holding down the indicated keys on the keyboard immediately after
241 241 the system has been powered on. The keys must be held down until the
242 242 monitor has checked their status. The Stop-A command can be issued at
243 243 any time after the console display begins, and the keys do not need to
244 244 be held down once they've been pressed. The Stop-D, Stop-F and Stop-N
245 245 commands are not allowed when one of the security modes has been set.
246 246 Not all commands are available on all workstations.
247 247
248 248 Stop (L1)
249 249 Bypass the Power-On Self Test (POST). This is only
250 250 effective if the system has been placed into the
251 251 diagnostic mode.
252 252
253 253
254 254 Stop-A (L1-A)
255 255 Abort the current operation and return to the
256 256 monitor's default prompt.
257 257
258 258
259 259 Stop-D (L1-D)
260 260 Set the system's 'diag-switch?' NVRAM parameter to
261 261 'true', which places the system in diagnostic mode.
262 262 POST diagnostics, if present, are run, and the
263 263 messages are displayed by way of the system's serial
264 264 port A.
265 265
266 266
267 267 Stop-F (L1-F)
268 268 Enter the OpenBoot monitor before the monitor has
269 269 probed the system for devices. Issue the 'fexit'
270 270 command to continue with system initialization.
271 271
272 272
273 273 Stop-N (L1-N)
274 274 Causes the NVRAM parameters to be reset to their
275 275 default values. Note that not all parameters have
276 276 default values.
277 277
278 278
279 279 Line Editor Commands
280 280 The following commands can be used while the monitor is displaying the
281 281 ok prompt. Not all of these editing commands are available on all
282 282 workstations.
283 283
284 284 CTRL-A
285 285 Place the cursor at the start of line.
286 286
287 287
288 288 CTRL-B
289 289 Move the cursor backward one character.
290 290
291 291
292 292 ESC-B
293 293 Move the cursor backward one word.
294 294
295 295
296 296 CTRL-D
297 297 Erase the character that the cursor is currently
298 298 highlighting.
299 299
300 300
301 301 ESC-D
302 302 Erase the portion of word from the cursor's present position
303 303 to the end of the word.
304 304
305 305
306 306 CTRL-E
307 307 Place the cursor at the end of line.
308 308
309 309
310 310 CTRL-F
311 311 Move the cursor forward one character.
312 312
313 313
314 314 ESC-F
315 315 Move the cursor forward one word.
316 316
317 317
318 318 CTRL-H
319 319 Erase the character preceding the cursor (also use Delete or
320 320 Back Space)
321 321
322 322
323 323 ESC-H
324 324 Erase the portion of the word which precedes the cursor (use
325 325 also CTRL-W)
326 326
327 327
328 328 CTRL-K
329 329 Erase from the cursor's present position to the end of the
330 330 line.
331 331
332 332
333 333 CTRL-L
334 334 Show the command history list.
335 335
336 336
337 337 CTRL-N
338 338 Recall the next command from the command history list
339 339
340 340
341 341 CTRL-P
342 342 Recall a previous command from the command history list.
343 343
344 344
345 345 CTRL-Q
346 346 Quote the next character (used to type a control character).
347 347
348 348
349 349 CTRL-R
350 350 Retype the current line.
351 351
352 352
353 353 CTRL-U
354 354 Erase from the cursor's present position to the beginning of
355 355 the line.
356 356
357 357
358 358 CTRL-Y
359 359 Insert the contents of the memory buffer into the line, in
360 360 front (to the left) of the cursor.
361 361
362 362
363 363 nvramrc
364 364 The nvramrc is an area of the system's NVRAM where users may store
365 365 Forth programs. The programs which are stored in the nvramrc are
366 366 executed each time the system is reset, provided that the 'use-
367 367 nvramrc?' NVRAM parameter has been set to 'true'. Refer to the book for
368 368 information on how to edit and use the nvramrc.
369 369
370 370 Restricted Monitor
371 371 The command 'old-mode' is used to move OpenBoot into a restricted
372 372 monitor mode, causing the > prompt to be displayed. Only three
373 373 commands are allowed while in the restricted monitor; the 'go' command
374 374 (to resume a program which was interrupted with the Stop-A command),
375 375 the 'n' command (to return to the normal OpenBoot monitor), and boot
376 376 commands. The restricted monitor's boot commands approximate the older
377 377 SunMON monitor's boot command syntax. If a 'security-mode' has been
378 378 turned on then the restricted monitor becomes the default monitor
379 379 environment. The restricted monitor may also become the default
380 380 environment if the 'sunmon-compat?' NVRAM parameter is set to true.
381 381 Not all workstations have the 'sunmon-compat?' parameter.
382 382
383 383 SUNMON PROM USAGE
384 384 The following commands are available systems with older SunMON-based
385 385 PROM:
386 386
387 387 +|-
388 388
389 389 Increment or decrement the current address and display the contents
390 390 of the new location.
391 391
392 392
393 393 ^C source destination n
394 394
395 395 (caret-C) Copy, byte-by-byte, a block of length n from the source
396 396 address to the destination address.
397 397
398 398
399 399 ^I program
400 400
401 401 (caret-I) Display the compilation date and location of program.
402 402
403 403
404 404 ^T virtual_address
405 405
406 406 (caret-T) Display the physical address to which virtual_address is
407 407 mapped.
408 408
409 409
410 410 b [ ! ] [ device [ (c,u,p) ] ] [ pathname ] [ arguments_list ]
411 411
412 412
413 413
414 414
415 415 b[?]
416 416
417 417 Reset appropriate parts of the system and bootstrap a program. A
418 418 `!' (preceding the device argument) prevents the system reset from
419 419 occurring. Programs can be loaded from various devices (such as a
420 420 disk, tape, or Ethernet). `b' with no arguments causes a default
421 421 boot, either from a disk, or from an Ethernet controller. `b?'
422 422 displays all boot devices and their devices.
423 423
424 424 device
425 425 one of
426 426
427 427 le
428 428 Lance Ethernet
429 429
430 430
431 431 ie
432 432 Intel Ethernet
433 433
434 434
435 435 sd
436 436 SCSI disk, CDROM
437 437
438 438
439 439 st
440 440 SCSI 1/4" or 1/2" tape
441 441
442 442
443 443 fd
444 444 Diskette
445 445
446 446
447 447 id
448 448 IPI disk
449 449
450 450
451 451 mt
452 452 Tape Master 9-track 1/2" tape
453 453
454 454
455 455 xd
456 456 Xylogics 7053 disk
457 457
458 458
459 459 xt
460 460 Xylogics 1/2" tape
461 461
462 462
463 463 xy
464 464 Xylogics 440/450 disk
465 465
466 466
467 467
468 468 c
469 469 A controller number (0 if only one controller),
470 470
471 471
472 472 u
473 473 A unit number (0 if only one driver), and
474 474
475 475
476 476 p
477 477 A partition.
478 478
479 479
480 480 pathname
481 481 A pathname for a program such as /stand/diag.
482 482
483 483
484 484 arguments_list
485 485 A list of up to seven arguments to pass to the
486 486 program being booted.
487 487
488 488
489 489
490 490 c [virtual_address]
491 491
492 492 Resume execution of a program. When given, virtual_address is the
493 493 address at which execution resumes. The default is the current PC.
494 494 Registers are restored to the values shown by the d, and r
495 495 commands.
496 496
497 497
498 498 d [window_number]
499 499
500 500 Display (dump) the state of the processor. The processor state is
501 501 observable only after:
502 502
503 503 o An unexpected trap was encountered.
504 504
505 505 o A user program dropped into the monitor (by calling
506 506 abortent).
507 507
508 508 o The user manually entered the monitor by typing L1-A or
509 509 BREAK.
510 510 The display consists of the following:
511 511
512 512 o The special registers: PSR, PC, nPC, TBR, WIM, and Y
513 513
514 514 o Eight global registers
515 515
516 516 o 24 window registers (8 in, 8 local, and 8 out),
517 517 corresponding to one of the 7 available windows. If a
518 518 Floating-Point Unit is on board, its status register
519 519 along with 32 floating-point registers are also shown.
520 520
521 521 window_number
522 522 Display the indicated window_number, which can be
523 523 any value between 0 and 6, inclusive. If no
524 524 window is specified and the PSR's current window
525 525 pointer contains a valid window number, registers
526 526 from the window that was active just prior to
527 527 entry into the monitor are displayed. Otherwise,
528 528 registers from window 0 are displayed.
529 529
530 530
531 531
532 532 e [virtual_address][action] ...
533 533
534 534 Open the 16-bit word at virtual_address (default zero). The
535 535 address is interpreted in the address space defined by the s
536 536 command. See the a command for a description of action.
537 537
538 538
539 539 f virtual_address1 virtual_address2 pattern [size]
540 540
541 541 Fill the bytes, words, or long words from virtual_address1 (lower)
542 542 to virtual_address2 (higher) with the constant, pattern. The size
543 543 argument can take one of the following values:
544 544
545 545 b
546 546 byte format (the default)
547 547
548 548
549 549 w
550 550 word format
551 551
552 552
553 553 l
554 554 long word format
555 555
556 556 For example, the following command fills the address block from
557 557 0x1000 to 0x2000 with the word pattern, 0xABCD:
558 558
559 559 f 1000 2000 ABCD W
560 560
561 561
562 562 g [vector] [argument]
563 563 g [virtual_address] [argument]
564 564
565 565 Goto (jump to) a predetermined or default routine (first form), or
566 566 to a user-specified routine (second form). The value of argument
567 567 is passed to the routine. If the vector or virtual_address
568 568 argument is omitted, the value in the PC is used as the address to
569 569 jump to.
570 570
571 571 To set up a predetermined routine to jump to, a user program must,
572 572 prior to executing the monitor's g command, set the variable
573 573 *romp->v_vector_cmd to be equal to the virtual address of the
574 574 desired routine. Predetermined routines need not necessarily return
575 575 control to the monitor.
576 576
577 577 The default routine, defined by the monitor, prints the user-
578 578 supplied vector according to the format supplied in argument. This
579 579 format can be one of:
580 580
581 581 %x
582 582 hexadecimal
583 583
584 584
585 585 %d
586 586 decimal
587 587
588 588
589 589
590 590 g0
591 591
592 592 Force a panic and produce a crash dump when the monitor is running
593 593 as a result of the system being interrupted,
594 594
595 595
596 596 g4
597 597
598 598 (Sun-4 systems only) Force a kernel stack trace when the monitor
599 599 is running as a result of the system being interrupted,
600 600
601 601
602 602 h
603 603
604 604 Display the help menu for monitor commands and their descriptions.
605 605 To return to the monitor's basic command level, press ESCAPE or q
606 606 before pressing RETURN.
607 607
608 608
609 609 i [cache_data_offset] [action]...
610 610
611 611 Modify cache data RAM command. Display and/or modify one or more
612 612 of the cache data addresses. See the a command for a description
613 613 of action.
614 614
615 615
616 616 j [cache_tag_offset] [action]...
617 617
618 618 Modify cache tag RAM command. Display and/or modify the contents
619 619 of one or more of the cache tag addresses. See the a command for a
620 620 description of action.
621 621
622 622
623 623 k [reset_level]
624 624
625 625 Reset the system, where reset_level is:
626 626
627 627 0
628 628 Reset VMEbus, interrupt registers, video monitor (Sun-4
629 629 systems). This is the default.
630 630
631 631
632 632 1
633 633 Software reset.
634 634
635 635
636 636 2
637 637 Power-on reset. Resets and clears the memory. Runs the EPROM-
638 638 based diagnostic self test, which can take several minutes,
639 639 depending upon how much memory is being tested.
640 640
641 641
642 642
643 643 kb
644 644
645 645 Display the system banner.
646 646
647 647
648 648 l [virtual_address][action]...
649 649
650 650 Open the long word (32 bit) at memory address virtual_address
651 651 (default zero). The address is interpreted in the address space
652 652 defined by the s command (below). See the a command for a
653 653 description of action.
654 654
655 655
656 656 m [virtual_address][action]...
657 657
658 658 Open the segment map entry that maps virtual_address (default
659 659 zero). The address is interpreted in the address space defined by
660 660 the s command. See the a command for a description of action.
661 661
662 662
663 663 ne
664 664
665 665
666 666
667 667
668 668 ni
669 669
670 670 Disable, enable, or invalidate the cache, respectively.
671 671
672 672
673 673 o [virtual_address][action]...
674 674
675 675 Open the byte location specified by virtual_address (default
676 676 zero). The address is interpreted in the address space defined by
677 677 the s command. See the a command for a description of action.
678 678
679 679
680 680 p [virtual_address][action]...
681 681
682 682 Open the page map entry that maps virtual_address (default zero) in
683 683 the address space defined by the s command. See the a command for a
684 684 description of action.
685 685
686 686
687 687 q [eeprom_offset][action]...
688 688
689 689 Open the EEPROM eeprom_offset (default zero) in the EEPROM address
690 690 space. All addresses are referenced from the beginning or base of
691 691 the EEPROM in physical address space, and a limit check is
692 692 performed to insure that no address beyond the EEPROM physical
693 693 space is accessed. This command is used to display or modify
694 694 configuration parameters, such as: the amount of memory to test
695 695 during self test, whether to display a standard or custom banner,
696 696 if a serial port (A or B) is to be the system console, etc. See the
697 697 a command for a description of action.
698 698
699 699
700 700 r [register_number]
701 701 r [register_type]
702 702 r [w window_number]
703 703
704 704 Display and/or modify one or more of the IU or FPU registers. A
705 705 hexadecimal register_number can be one of:
706 706
707 707 0x00-0x0f
708 708 window(0,i0)-window(0,i7),
709 709 window(0,i0)--window(0,i7)
710 710
711 711
712 712 0x16-0x1f
713 713 window(1,i0)-window(1,i7),
714 714 window(1,i0)--window(1,i7)
715 715
716 716
717 717 0x20-0x2f
718 718 window(2,i0)-window(2,i7),
719 719 window(2,i0)--window(2,i7)
720 720
721 721
722 722 0x30-0x3f
723 723 window(3,i0)-window(3,i7),
724 724 window(3,i0)--window(3,i7)
725 725
726 726
727 727 0x40-0x4f
728 728 window(4,i0)-window(4,i7),
729 729 window(4,i0)--window(4,i7)
730 730
731 731
732 732 0x50-0x5f
733 733 window(5,i0)-window(5,i7),
734 734 window(5,i0)--window(5,i7)
735 735
736 736
737 737 0x60-0x6f
738 738 window(6,i0)-window(6,i7),
739 739 window(6,i0)--window(6,i7)
740 740
741 741
742 742 0x70-0x77
743 743 g0, g1, g2, g3, g4, g5, g6, g7
744 744
745 745
746 746 0x78-0x7d
747 747 PSR, PC, nPC, WIM, TBR, Y.
748 748
749 749
750 750 0x7e-0x9e
751 751 FSR, f0-f31
752 752
753 753 Register numbers can only be displayed after an unexpected trap, a
754 754 user program has entered the monitor using the abortent function,
755 755 or the user has entered the monitor by manually typing L1-A or
756 756 BREAK.
757 757
758 758 If a register_type is given, the first register of the indicated
759 759 type is displayed. register_type can be one of:
760 760
761 761 f
762 762 floating-point
763 763
764 764
765 765 g
766 766 global
767 767
768 768
769 769 s
770 770 special
771 771
772 772 If w and a window_number (0--6) are given, the first in-register
773 773 within the indicated window is displayed. If window_number is
774 774 omitted, the window that was active just prior to entering the
775 775 monitor is used. If the PSR's current window pointer is invalid,
776 776 window 0 is used.
777 777
778 778
779 779 s [asi])
780 780
781 781 Set or display the Address Space Identifier. With no argument, s
782 782 displays the current Address Space Identifier. The asi value can
783 783 be one of:
784 784
785 785 0x2
786 786 control space
787 787
788 788
789 789 0x3
790 790 segment table
791 791
792 792
793 793 0x4
794 794 Page table
795 795
796 796
797 797 0x8
798 798 user instruction
799 799
800 800
801 801 0x9
802 802 supervisor instruction
803 803
804 804
805 805 0xa
806 806 user data
807 807
808 808
809 809 0xb
810 810 supervisor data
811 811
812 812
813 813 0xc
814 814 flush segment
815 815
816 816
817 817 0xd
818 818 flush page
819 819
820 820
821 821 0xe
822 822 flush context
823 823
824 824
825 825 0xf
826 826 cache data
827 827
828 828
829 829
830 830 u [ echo ]
831 831
832 832
833 833
834 834
835 835 u [ port ] [ options ] [ baud_rate ]
836 836
837 837
838 838
839 839
840 840 u [ u ] [ virtual_address ]
841 841
842 842 With no arguments, display the current I/O device characteristics
843 843 including: current input device, current output device, baud rates
844 844 for serial ports A and B, an input-to-output echo indicator, and
845 845 virtual addresses of mapped UART devices. With arguments, set or
846 846 configure the current I/O device. With the u argument (uu...), set
847 847 the I/O device to be the virtual_address of a UART device currently
848 848 mapped.
849 849
850 850 echo
851 851 Can be either e to enable input to be echoed to the
852 852 output device, or ne, to indicate that input is not
853 853 echoed.
854 854
855 855
856 856 port
857 857 Assign the indicated port to be the current I/O
858 858 device. port can be one of:
859 859
860 860 a
861 861 serial port A
862 862
863 863
864 864 b
865 865 serial port B
866 866
867 867
868 868 k
869 869 the workstation keyboard
870 870
871 871
872 872 s
873 873 the workstation screen
874 874
875 875
876 876
877 877 baud_rate
878 878 Any legal baud rate.
879 879
880 880
881 881 options
882 882 can be any combination of:
883 883
884 884 i
885 885 input
886 886
887 887
888 888 o
889 889 output
890 890
891 891
892 892 u
893 893 UART
894 894
895 895
896 896 e
897 897 echo input to output
898 898
899 899
900 900 ne
901 901 do not echo input
902 902
903 903
904 904 r
905 905 reset indicated serial port (a and b ports only)
906 906
907 907 If either a or b is supplied, and no options are given,
908 908 the serial port is assigned for both input and output.
909 909 If k is supplied with no options, it is assigned for
910 910 input only. If s is supplied with no options, it is
911 911 assigned for output only.
912 912
913 913
914 914
915 915 v virtual_address1 virtual_address2 [size]
916 916
917 917 Display the contents of virtual_address1 (lower) virtual_address2
918 918 (higher) in the format specified by size:
919 919
920 920 b
921 921 byte format (the default)
922 922
923 923
924 924 w
925 925 word format
926 926
927 927
928 928 l
929 929 long word format
930 930
931 931 Enter return to pause for viewing; enter another return character
932 932 to resume the display. To terminate the display at any time, press
933 933 the space bar.
934 934
935 935 For example, the following command displays the contents of virtual
936 936 address space from address 0x1000 to 0x2000 in word format:
937 937
938 938 v 1000 2000 W
939 939
940 940
941 941 w [virtual_address][argument]
942 942
943 943 Set the execution vector to a predetermined or default routine.
944 944 Pass virtual_address and argument to that routine.
945 945
946 946 To set up a predetermined routine to jump to, a user program must,
947 947 prior to executing the monitor's w command, set the variable
948 948 *romp->v_vector_cmd to be equal to the virtual address of the
949 949 desired routine. Predetermined routines need not necessarily return
950 950 control to the monitor.
951 951
952 952 The default routine, defined by the monitor, prints the user-
953 953 supplied vector according to the format supplied in argument. This
954 954 format can be one of:
955 955
956 956 %x
957 957 hexadecimal
958 958
959 959
960 960 %d
961 961 decimal
962 962
963 963
964 964
965 965 x
966 966
967 967 Display a menu of extended tests. These diagnostics permit
968 968 additional testing of such things as the I/O port connectors, video
969 969 memory, workstation memory and keyboard, and boot device paths.
970 970
971 971
972 972 yc context_number
973 973
974 974
975 975
976 976
977 977 yp|s context_number virtual_address
978 978
979 979 Flush the indicated context, context page, or context segment.
980 980
981 981 c
982 982 flush context context_number
983 983
984 984
985 985 p
986 986 flush the page beginning at virtual_address within context
987 987 context_number
988 988
989 989
990 990 s
991 991 flush the segment beginning at virtual_address within context
992 992 context_number
993 993
994 994
995 995
996 996 ATTRIBUTES
997 997 See attributes(5) for descriptions of the following attributes:
998 998
999 999
1000 1000
1001 1001
1002 1002 +---------------+-----------------+
|
↓ open down ↓ |
1002 lines elided |
↑ open up ↑ |
1003 1003 |ATTRIBUTE TYPE | ATTRIBUTE VALUE |
1004 1004 +---------------+-----------------+
1005 1005 |Architecture | SPARC |
1006 1006 +---------------+-----------------+
1007 1007
1008 1008 SEE ALSO
1009 1009 tip(1), boot(1M), eeprom(1M), attributes(5)
1010 1010
1011 1011
1012 1012
1013 -
1014 1013 July 24, 2003 MONITOR(1M)
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX