| blob | d5c58aa8c1c68b9b93851c432f706b465793eece |
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
15 .LP
16 .nf
17 \fBBREAK\fR
18 .fi
20 .LP
21 .nf
22 \fBinitial system power-on\fR
23 .fi
25 .LP
26 .nf
27 \fBexit from a client program, e.g., the Operating System\fR
28 .fi
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
687 .RE
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
718 .sp
719 .ne 2
720 .na
721 \fB\fBie\fR\fR
722 .ad
723 .RS 6n
724 Intel Ethernet
725 .RE
727 .sp
728 .ne 2
729 .na
730 \fB\fBsd\fR\fR
731 .ad
732 .RS 6n
733 \fBSCSI\fR disk, CDROM
734 .RE
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
745 .sp
746 .ne 2
747 .na
748 \fB\fBfd\fR\fR
749 .ad
750 .RS 6n
751 Diskette
752 .RE
754 .sp
755 .ne 2
756 .na
757 \fB\fBid\fR\fR
758 .ad
759 .RS 6n
760 IPI disk
761 .RE
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
772 .sp
773 .ne 2
774 .na
775 \fB\fBxd\fR\fR
776 .ad
777 .RS 6n
778 Xylogics 7053 disk
779 .RE
781 .sp
782 .ne 2
783 .na
784 \fB\fBxt\fR\fR
785 .ad
786 .RS 6n
787 Xylogics 1/2" tape
788 .RE
790 .sp
791 .ne 2
792 .na
793 \fB\fBxy\fR\fR
794 .ad
795 .RS 6n
796 Xylogics 440/450 disk
797 .RE
799 .RE
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
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
819 .sp
820 .ne 2
821 .na
822 \fB\fIp\fR\fR
823 .ad
824 .RS 18n
825 A partition.
826 .RE
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
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
846 .RE
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
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
921 .RE
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
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
954 .sp
955 .ne 2
956 .na
957 \fB\fBw\fR\fR
958 .ad
959 .RS 5n
960 word format
961 .RE
963 .sp
964 .ne 2
965 .na
966 \fB\fBl\fR\fR
967 .ad
968 .RS 5n
969 long word format
970 .RE
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
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
1012 .sp
1013 .ne 2
1014 .na
1015 \fB\fB%d\fR\fR
1016 .ad
1017 .RS 6n
1018 decimal
1019 .RE
1021 .RE
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
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
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
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
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
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
1099 .sp
1100 .ne 2
1101 .na
1102 \fB\fB1\fR\fR
1103 .ad
1104 .RS 5n
1105 Software reset.
1106 .RE
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
1119 .RE
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
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
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
1155 .sp
1156 .ne 2
1157 .na
1158 \fB\fBne\fR\fR
1159 .ad
1160 .sp .6
1161 .RS 4n
1163 .RE
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
1338 .sp
1339 .ne 2
1340 .na
1341 \fB\fBg\fR\fR
1342 .ad
1343 .RS 5n
1344 global
1345 .RE
1347 .sp
1348 .ne 2
1349 .na
1350 \fB\fBs\fR\fR
1351 .ad
1352 .RS 5n
1353 special
1354 .RE
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
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
1382 .sp
1383 .ne 2
1384 .na
1385 \fB\fB0x3\fR\fR
1386 .ad
1387 .RS 7n
1388 segment table
1389 .RE
1391 .sp
1392 .ne 2
1393 .na
1394 \fB\fB0x4\fR\fR
1395 .ad
1396 .RS 7n
1397 Page table
1398 .RE
1400 .sp
1401 .ne 2
1402 .na
1403 \fB\fB0x8\fR\fR
1404 .ad
1405 .RS 7n
1406 user instruction
1407 .RE
1409 .sp
1410 .ne 2
1411 .na
1412 \fB\fB0x9\fR\fR
1413 .ad
1414 .RS 7n
1415 supervisor instruction
1416 .RE
1418 .sp
1419 .ne 2
1420 .na
1421 \fB\fB0xa\fR\fR
1422 .ad
1423 .RS 7n
1424 user data
1425 .RE
1427 .sp
1428 .ne 2
1429 .na
1430 \fB\fB0xb\fR\fR
1431 .ad
1432 .RS 7n
1433 supervisor data
1434 .RE
1436 .sp
1437 .ne 2
1438 .na
1439 \fB\fB0xc\fR\fR
1440 .ad
1441 .RS 7n
1442 flush segment
1443 .RE
1445 .sp
1446 .ne 2
1447 .na
1448 \fB\fB0xd\fR\fR
1449 .ad
1450 .RS 7n
1451 flush page
1452 .RE
1454 .sp
1455 .ne 2
1456 .na
1457 \fB\fB0xe\fR\fR
1458 .ad
1459 .RS 7n
1460 flush context
1461 .RE
1463 .sp
1464 .ne 2
1465 .na
1466 \fB\fB0xf\fR\fR
1467 .ad
1468 .RS 7n
1469 cache data
1470 .RE
1472 .RE
1474 .sp
1475 .ne 2
1476 .na
1477 \fB\fBu\fR [ \fBecho\fR ]\fR
1478 .ad
1479 .sp .6
1480 .RS 4n
1482 .RE
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
1492 .RE
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
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
1534 .sp
1535 .ne 2
1536 .na
1537 \fB\fBb\fR\fR
1538 .ad
1539 .RS 5n
1540 serial port B
1541 .RE
1543 .sp
1544 .ne 2
1545 .na
1546 \fB\fBk\fR\fR
1547 .ad
1548 .RS 5n
1549 the workstation keyboard
1550 .RE
1552 .sp
1553 .ne 2
1554 .na
1555 \fB\fBs\fR\fR
1556 .ad
1557 .RS 5n
1558 the workstation screen
1559 .RE
1561 .RE
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
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
1588 .sp
1589 .ne 2
1590 .na
1591 \fB\fBo\fR\fR
1592 .ad
1593 .RS 6n
1594 output
1595 .RE
1597 .sp
1598 .ne 2
1599 .na
1600 \fB\fBu\fR\fR
1601 .ad
1602 .RS 6n
1603 \fBUART\fR
1604 .RE
1606 .sp
1607 .ne 2
1608 .na
1609 \fB\fBe\fR\fR
1610 .ad
1611 .RS 6n
1612 echo input to output
1613 .RE
1615 .sp
1616 .ne 2
1617 .na
1618 \fB\fBne\fR\fR
1619 .ad
1620 .RS 6n
1621 do not echo input
1622 .RE
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
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
1639 .RE
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
1659 .sp
1660 .ne 2
1661 .na
1662 \fB\fBw\fR\fR
1663 .ad
1664 .RS 5n
1665 word format
1666 .RE
1668 .sp
1669 .ne 2
1670 .na
1671 \fB\fBl\fR\fR
1672 .ad
1673 .RS 5n
1674 long word format
1675 .RE
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
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
1714 .sp
1715 .ne 2
1716 .na
1717 \fB\fB%d\fR\fR
1718 .ad
1719 .RS 6n
1720 decimal
1721 .RE
1723 .RE
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
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
1745 .RE
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
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
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
1784 .RE
1786 .SH ATTRIBUTES
1787 .sp
1788 .LP
1789 See \fBattributes\fR(5) for descriptions of the following attributes:
1790 .sp
1792 .sp
1793 .TS
1794 box;
1795 c | c
1796 l | l .
1797 ATTRIBUTE TYPE ATTRIBUTE VALUE
1798 _
1799 Architecture SPARC
1800 .TE
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