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