Print this page
11244 Some man pages still refer to E10K
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man1m/eeprom.1m
+++ new/usr/src/man/man1m/eeprom.1m
1 1 '\" te
2 +.\" Copyright 2019 Peter Tribble.
2 3 .\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved
3 4 .\" 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 5 .\" 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 6 .\" 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 EEPROM 1M "Oct 27, 2018"
7 +.TH EEPROM 1M "Jun 13, 2019"
7 8 .SH NAME
8 9 eeprom \- EEPROM display and load utility
9 10 .SH SYNOPSIS
10 11 .LP
11 12 .nf
12 13 \fB/usr/sbin/eeprom\fR [\fB-\fR] [\fB-f\fR \fIdevice\fR] [\fIparameter\fR[=\fIvalue\fR]]
13 14 .fi
14 15
15 16 .SH DESCRIPTION
16 17 .LP
17 18 \fBeeprom\fR displays or changes the values of parameters in the \fBEEPROM.\fR
18 19 It processes parameters in the order given. When processing a \fIparameter\fR
19 20 accompanied by a \fIvalue\fR, \fBeeprom\fR makes the indicated alteration to
20 21 the \fBEEPROM;\fR otherwise, it displays the \fIparameter\fR's value. When
21 22 given no parameter specifiers, \fBeeprom\fR displays the values of all
22 23 \fBEEPROM\fR parameters. A `\|\(mi\fB\&'\fR (hyphen) flag specifies that
23 24 parameters and values are to be read from the standard input (one
24 25 \fIparameter\fR or \fIparameter\fR\fB=\fR\fIvalue\fR per line).
25 26 .sp
26 27 .LP
27 28 Only the super-user may alter the \fBEEPROM\fR contents.
28 29 .sp
29 30 .LP
30 31 \fBeeprom\fR verifies the \fBEEPROM\fR checksums and complains if they are
31 32 incorrect.
32 33 .sp
33 34 .LP
34 35 \fIplatform-name\fR is the name of the platform implementation and can be found
35 36 using the \fB-i\fR option of \fBuname\fR(1).
36 37 .SS "SPARC"
37 38 .LP
38 39 \fBSPARC\fR based systems implement firmware password protection with
39 40 \fBeeprom\fR, using the \fBsecurity-mode\fR, \fBsecurity-password\fR and
40 41 \fBsecurity-#badlogins\fR properties.
41 42 .SS "x86"
42 43 .LP
43 44 \fBEEPROM\fR storage is simulated using a file residing in the
44 45 platform-specific boot area. The \fB/boot/solaris/bootenv.rc\fR file simulates
45 46 \fBEEPROM\fR storage.
46 47 .sp
47 48 .LP
48 49 Because x86 based systems typically implement password protection in the system
49 50 \fBBIOS,\fR there is no support for password protection in the \fBeeprom\fR
50 51 program. While it is possible to set the \fBsecurity-mode\fR,
51 52 \fBsecurity-password\fR and \fBsecurity-#badlogins\fR properties on x86 based
52 53 systems, these properties have no special meaning or behavior on x86 based
53 54 systems.
54 55 .SH OPTIONS
55 56 .ne 2
56 57 .na
57 58 \fB\fB-f\fR \fIdevice\fR\fR
58 59 .ad
59 60 .sp .6
60 61 .RS 4n
61 62 Use \fIdevice\fR as the \fBEEPROM\fR device.
62 63 .RE
63 64
64 65 .SH OPERANDS
65 66 .SS "x86 Only"
66 67 .ne 2
67 68 .na
68 69 \fB\fIacpi-user-options\fR\fR
69 70 .ad
70 71 .sp .6
71 72 .RS 4n
72 73 A configuration variable that controls the use of Advanced Configuration and
73 74 Power Interface (ACPI), a power management specification. The acceptable values
74 75 for this variable depend on the release of the Solaris operating system you are
75 76 using.
76 77 .sp
77 78 For all releases of Solaris 10 and Solaris 11, a value of of \fB0x0\fR means
78 79 that there will be an attempt to use ACPI if it is available on the system. A
79 80 value of \fB0x2\fR disables the use of ACPI.
80 81 .sp
81 82 For the Solaris 10 1/06 release, a value of \fB0x8\fR means that there will be
82 83 an attempt to use ACPI in a mode compatible with previous releases of Solaris
83 84 10 if it is available on the system. The default for Solaris 10 1/06 is
84 85 \fB0x8\fR.
85 86 .sp
86 87 For releases of Solaris 10 after the 1/06 release and for Solaris 11, the
87 88 default is \fB0x0\fR.
88 89 .sp
89 90 Most users can safely accept the default value, which enables ACPI if
90 91 available. If issues related to the use of ACPI are suspected on releases of
91 92 Solaris after Solaris 1/06, it is suggested to first try a value of \fB0x8\fR
92 93 and then, if you do not obtain satisfactory results, \fB0x02\fR.
93 94 .RE
94 95
95 96 .sp
96 97 .ne 2
97 98 .na
98 99 \fB\fIconsole\fR\fR
99 100 .ad
100 101 .sp .6
101 102 .RS 4n
102 103 Specifies the console device.
103 104 Possible values are \fBttya\fR, \fBttyb\fR, \fBttyc\fR, \fBttyd\fR, and
104 105 \fBtext\fR. In \fBtext\fR mode, console output goes to the frame buffer and
105 106 input comes from the keyboard. For SPARC, when this property is not present,
106 107 the console device falls back to the device specified by \fBinput-device\fR and
107 108 \fBoutput-device\fR. When neither the console property or the
108 109 \fBinput-device\fR and \fBoutput-device\fR property pair are present, the
109 110 console defaults to the frame buffer and keyboard.
110 111 .RE
111 112
112 113 .ne 2
113 114 .na
114 115 \fB\fIos_console\fR\fR
115 116 .ad
116 117 .sp .6
117 118 .RS 4n
118 119 While \fBconsole\fR controls both boot loader and kernel console, setting
119 120 \fBos_console\fR allows setting console device only for kernel. Values
120 121 are the same as for \fBconsole\fR.
121 122 .RE
122 123
123 124 .ne 2
124 125 .na
125 126 \fB\fIdiag-device\fR\fR
126 127 .ad
127 128 .sp .6
128 129 .RS 4n
129 130 The \fBdiag-device\fR is currently implemented to support serial port
130 131 as output for system early boot diagnostic messages and input and output
131 132 for \fBkmdb\fR debugger. For early boot, all the console messages are mirrored
132 133 to \fBdiag-device\fR, until the console drivers are loaded.
133 134 After that, only \fBkmdb\fR will continue to use the \fBdiag-device\fR.
134 135 .RE
135 136
136 137 .SH NVRAM CONFIGURATION PARAMETERS
137 138 .LP
138 139 Not all OpenBoot systems support all parameters. Defaults vary depending on the
139 140 system and the \fBPROM\fR revision. See the output in the "Default Value"
140 141 column of the \fBprintenv\fR command, as entered at the \fBok\fR (OpenBoot)
141 142 prompt, to determine the default for your system.
142 143 .sp
143 144 .ne 2
144 145 .na
145 146 \fBauto-boot?\fR
146 147 .ad
147 148 .sp .6
148 149 .RS 4n
149 150 If \fBtrue\fR, boots automatically after power-on or reset. Defaults to
150 151 \fBtrue\fR.
151 152 .RE
152 153
153 154 .sp
154 155 .ne 2
155 156 .na
156 157 \fBansi-terminal?\fR
157 158 .ad
158 159 .sp .6
159 160 .RS 4n
160 161 Configuration variable used to control the behavior of the terminal emulator.
161 162 The value \fBfalse\fR makes the terminal emulator stop interpreting \fBANSI\fR
162 163 escape sequences; instead, echoes them to the output device. Defaults to
163 164 \fBtrue\fR.
164 165 .RE
165 166
166 167 .sp
167 168 .ne 2
168 169 .na
169 170 \fBboot-args\fR
170 171 .ad
171 172 .sp .6
172 173 .RS 4n
173 174 Holds a string of arguments that are passed to the boot subsystem. For example,
174 175 you can use \fBboot-args=' - install dhcp'\fR to request a customer jumpstart
175 176 installation. See \fBboot\fR(1M), \fBkadb\fR(1M) and \fBkernel\fR(1M).
176 177 .RE
177 178
178 179 .sp
179 180 .ne 2
180 181 .na
181 182 \fBboot-command\fR
182 183 .ad
183 184 .sp .6
184 185 .RS 4n
185 186 Command executed if \fBauto-boot?\fR is \fBtrue\fR. Defaults to \fBboot\fR.
186 187 .RE
187 188
188 189 .sp
189 190 .ne 2
190 191 .na
191 192 \fBboot-device\fR
192 193 .ad
193 194 .sp .6
194 195 .RS 4n
195 196 Device from which to boot. \fIboot-device\fR may contain 0 or more device
196 197 specifiers separated by spaces. Each device specifier may be either a prom
197 198 device alias or a prom device path. The boot prom will attempt to open each
198 199 successive device specifier in the list beginning with the first device
199 200 specifier. The first device specifier that opens successfully will be used as
200 201 the device to boot from. Defaults to \fBdisk net\fR.
201 202 .RE
202 203
203 204 .sp
204 205 .ne 2
205 206 .na
206 207 \fBboot-file\fR
207 208 .ad
208 209 .sp .6
209 210 .RS 4n
210 211 File to boot (an empty string lets the secondary booter choose default).
211 212 Defaults to empty string.
212 213 .RE
213 214
214 215 .sp
215 216 .ne 2
216 217 .na
217 218 \fBboot-from\fR
218 219 .ad
219 220 .sp .6
220 221 .RS 4n
221 222 Boot device and file (OpenBoot PROM version 1.\fIx\fR only). Defaults to
222 223 \fBvmunix\fR.
223 224 .RE
224 225
225 226 .sp
226 227 .ne 2
227 228 .na
228 229 \fBboot-from-diag\fR
229 230 .ad
230 231 .sp .6
231 232 .RS 4n
232 233 Diagnostic boot device and file (OpenBoot PROM version 1.\fIx\fR only).
233 234 Defaults to \fBle(\|)unix\fR.
234 235 .RE
235 236
236 237 .sp
237 238 .ne 2
238 239 .na
239 240 \fBboot-ncpus\fR
240 241 .ad
241 242 .sp .6
242 243 .RS 4n
243 244 Configuration variable that controls the number of processors with which the
244 245 system should boot. By default, the system boots with maximum supported number
245 246 of processors.
246 247 .RE
247 248
248 249 .sp
249 250 .ne 2
250 251 .na
251 252 \fBcom\fIX\fR-noprobe\fR
252 253 .ad
253 254 .sp .6
254 255 .RS 4n
255 256 Where \fIX\fR is the number of the serial port, prevents device probe on serial
256 257 port \fIX.\fR
257 258 .RE
258 259
259 260 .sp
260 261 .ne 2
261 262 .na
262 263 \fBdiag-device\fR
263 264 .ad
264 265 .sp .6
265 266 .RS 4n
266 267 Diagnostic boot source device. Defaults to \fBnet\fR.
267 268 .RE
268 269
269 270 .sp
270 271 .ne 2
271 272 .na
272 273 \fBdiag-file\fR
273 274 .ad
274 275 .sp .6
275 276 .RS 4n
276 277 File from which to boot in diagnostic mode. Defaults to empty string.
277 278 .RE
278 279
279 280 .sp
280 281 .ne 2
281 282 .na
282 283 \fBdiag-level\fR
283 284 .ad
284 285 .sp .6
285 286 .RS 4n
286 287 Diagnostics level. Values include \fBoff\fR, \fBmin\fR, \fBmax\fR and
287 288 \fBmenus\fR. There may be additional platform-specific values. When set to
288 289 \fBoff\fR, \fBPOST\fR is not called. If \fBPOST\fR is called, the value is made
289 290 available as an argument to, and is interpreted by \fBPOST.\fR Defaults to
290 291 \fBplatform-dependent\fR.
291 292 .RE
292 293
293 294 .sp
294 295 .ne 2
295 296 .na
296 297 \fBdiag-switch?\fR
297 298 .ad
298 299 .sp .6
299 300 .RS 4n
300 301 If \fBtrue\fR, run in diagnostic mode. Defaults to \fBfalse\fR on most desktop
301 302 systems, \fBtrue\fR on most servers.
302 303 .RE
303 304
304 305 .sp
305 306 .ne 2
306 307 .na
307 308 \fBerror-reset-recovery\fR
308 309 .ad
309 310 .sp .6
310 311 .RS 4n
311 312 Recover after an error reset trap. Defaults to platform-specific setting.
312 313 .sp
313 314 On platforms supporting this variable, it replaces the \fBwatchdog-reboot?\fR,
314 315 \fBwatchdog-sync?\fR, \fBredmode-reboot?\fR, \fBredmode-sync?\fR,
315 316 \fBsir-sync?\fR, and \fBxir-sync?\fR parameters.
316 317 .sp
317 318 The options are:
318 319 .sp
319 320 .ne 2
320 321 .na
321 322 \fBnone\fR
322 323 .ad
323 324 .sp .6
324 325 .RS 4n
325 326 Print a message describing the reset trap and go to OpenBoot PROM's user
326 327 interface, \fBaka\fR \fBOK\fR prompt.
327 328 .RE
328 329
329 330 .sp
330 331 .ne 2
331 332 .na
332 333 \fBsync\fR
333 334 .ad
334 335 .sp .6
335 336 .RS 4n
336 337 Invoke OpenBoot PROM's \fBsync\fR word after the reset trap. Some platforms may
337 338 treat this as \fBnone\fR after an externally initiated reset (\fBXIR\fR) trap.
338 339 .RE
339 340
340 341 .sp
341 342 .ne 2
342 343 .na
343 344 \fBboot\fR
344 345 .ad
345 346 .sp .6
346 347 .RS 4n
347 348 Reboot after the reset trap. Some platforms may treat this as \fBnone\fR after
348 349 an \fBXIR\fR trap.
349 350 .RE
350 351
351 352 .RE
352 353
353 354 .sp
354 355 .ne 2
355 356 .na
356 357 \fBfcode-debug?\fR
357 358 .ad
358 359 .sp .6
359 360 .RS 4n
360 361 If \fBtrue\fR, include name parameter for plug-in device FCodes. Defaults to
361 362 \fBfalse\fR.
362 363 .RE
363 364
364 365 .sp
365 366 .ne 2
366 367 .na
367 368 \fBhardware-revision\fR
368 369 .ad
369 370 .sp .6
370 371 .RS 4n
371 372 System version information.
372 373 .RE
373 374
374 375 .sp
375 376 .ne 2
376 377 .na
377 378 \fBinput-device\fR
378 379 .ad
379 380 .sp .6
380 381 .RS 4n
381 382 Input device used at power-on (usually \fBkeyboard\fR, \fBttya\fR,
382 383 \fBttyb\fR, \fBttyc\fR, or \fBttyd\fR). Defaults to \fBkeyboard\fR.
383 384 .RE
384 385
385 386 .sp
386 387 .ne 2
387 388 .na
388 389 \fBkeyboard-click?\fR
389 390 .ad
390 391 .sp .6
391 392 .RS 4n
|
↓ open down ↓ |
375 lines elided |
↑ open up ↑ |
392 393 If \fBtrue\fR, enable keyboard click. Defaults to \fBfalse\fR.
393 394 .RE
394 395
395 396 .sp
396 397 .ne 2
397 398 .na
398 399 \fBkeyboard-layout\fR
399 400 .ad
400 401 .sp .6
401 402 .RS 4n
402 -A string that specifies the layout name for non-self-identifying keyboards
403 -(type 7c). Invoke \fBkbd\fR \fB-s\fR to obtain a list of acceptable layout
403 +A string that specifies the layout name for non-self-identifying keyboards
404 +(type 7c). Invoke \fBkbd\fR \fB-s\fR to obtain a list of acceptable layout
404 405 names. See \fBkbd\fR(1).
405 406 .RE
406 407
407 408 .sp
408 409 .ne 2
409 410 .na
410 411 \fBkeymap\fR
411 412 .ad
412 413 .sp .6
413 414 .RS 4n
414 415 Keymap for custom keyboard.
415 416 .RE
416 417
417 418 .sp
418 419 .ne 2
419 420 .na
420 421 \fBlast-hardware-update\fR
421 422 .ad
422 423 .sp .6
423 424 .RS 4n
424 425 System update information.
425 426 .RE
426 427
427 428 .sp
428 429 .ne 2
429 430 .na
430 431 \fBload-base\fR
431 432 .ad
432 433 .sp .6
433 434 .RS 4n
434 435 Default load address for client programs. Default value is \fB16384\fR.
435 436 .RE
436 437
437 438 .sp
438 439 .ne 2
439 440 .na
440 441 \fBlocal-mac-address?\fR
441 442 .ad
442 443 .sp .6
443 444 .RS 4n
444 445 If true, network drivers use their own MAC address, not the system's. Defaults
445 446 to \fBfalse\fR.
446 447 .RE
447 448
448 449 .sp
449 450 .ne 2
450 451 .na
451 452 \fBmfg-mode\fR
452 453 .ad
453 454 .sp .6
454 455 .RS 4n
455 456 Manufacturing mode argument for \fBPOST.\fR Possible values include \fBoff\fR
456 457 or \fBchamber\fR. The value is passed as an argument to \fBPOST.\fR Defaults to
457 458 \fBoff\fR.
458 459 .RE
459 460
460 461 .sp
461 462 .ne 2
462 463 .na
463 464 \fBmfg-switch?\fR
464 465 .ad
465 466 .sp .6
466 467 .RS 4n
467 468 If true, repeat system self-tests until interrupted with STOP-A. Defaults to
468 469 \fBfalse\fR.
469 470 .RE
470 471
471 472 .sp
472 473 .ne 2
473 474 .na
474 475 \fBnvramrc\fR
475 476 .ad
476 477 .sp .6
477 478 .RS 4n
478 479 Contents of NVRAMRC. Defaults to empty.
479 480 .RE
480 481
481 482 .sp
482 483 .ne 2
483 484 .na
484 485 \fBnetwork-boot-arguments\fR
485 486 .ad
486 487 .sp .6
487 488 .RS 4n
488 489 Arguments to be used by the PROM for network booting. Defaults to an empty
489 490 string. \fBnetwork-boot-arguments\fR can be used to specify the boot protocol
490 491 (RARP/DHCP) to be used and a range of system knowledge to be used in the
491 492 process.
492 493 .sp
493 494 The syntax for arguments supported for network booting is:
494 495 .sp
495 496 .in +2
496 497 .nf
497 498 [\fIprotocol\fR,] [\fIkey\fR=\fIvalue\fR,]*
498 499 .fi
499 500 .in -2
500 501 .sp
501 502
502 503 All arguments are optional and can appear in any order. Commas are required
503 504 unless the argument is at the end of the list. If specified, an argument takes
504 505 precedence over any default values, or, if booting using DHCP, over
505 506 configuration information provided by a DHCP server for those parameters.
506 507 .sp
507 508 \fIprotocol\fR, above, specifies the address discovery protocol to be used.
508 509 .sp
509 510 Configuration parameters, listed below, are specified as \fIkey\fR=\fIvalue\fR
510 511 attribute pairs.
511 512 .sp
512 513 .ne 2
513 514 .na
514 515 \fB\fBtftp-server\fR\fR
515 516 .ad
516 517 .sp .6
517 518 .RS 4n
518 519 IP address of the TFTP server
519 520 .RE
520 521
521 522 .sp
522 523 .ne 2
523 524 .na
524 525 \fB\fBfile\fR\fR
525 526 .ad
526 527 .sp .6
527 528 .RS 4n
528 529 file to download using TFTP or URL for WAN boot
529 530 .RE
530 531
531 532 .sp
532 533 .ne 2
533 534 .na
534 535 \fB\fBhost-ip\fR\fR
535 536 .ad
536 537 .sp .6
537 538 .RS 4n
538 539 IP address of the client (in dotted-decimal notation)
539 540 .RE
540 541
541 542 .sp
542 543 .ne 2
543 544 .na
544 545 \fB\fBrouter-ip\fR\fR
545 546 .ad
546 547 .sp .6
547 548 .RS 4n
548 549 IP address of the default router (in dotted-decimal notation)
549 550 .RE
550 551
551 552 .sp
552 553 .ne 2
553 554 .na
554 555 \fB\fBsubnet-mask\fR\fR
555 556 .ad
556 557 .sp .6
557 558 .RS 4n
558 559 subnet mask (in dotted-decimal notation)
559 560 .RE
560 561
561 562 .sp
562 563 .ne 2
563 564 .na
564 565 \fB\fBclient-id\fR\fR
565 566 .ad
566 567 .sp .6
567 568 .RS 4n
568 569 DHCP client identifier
569 570 .RE
570 571
571 572 .sp
572 573 .ne 2
573 574 .na
574 575 \fB\fBhostname\fR\fR
575 576 .ad
576 577 .sp .6
577 578 .RS 4n
578 579 hostname to use in DHCP transactions
579 580 .RE
580 581
581 582 .sp
582 583 .ne 2
583 584 .na
584 585 \fB\fBhttp-proxy\fR\fR
585 586 .ad
586 587 .sp .6
587 588 .RS 4n
588 589 HTTP proxy server specification (IPADDR[:PORT])
589 590 .RE
590 591
591 592 .sp
592 593 .ne 2
593 594 .na
594 595 \fB\fBtftp-retries\fR\fR
595 596 .ad
596 597 .sp .6
597 598 .RS 4n
598 599 maximum number of TFTP retries
599 600 .RE
600 601
601 602 .sp
602 603 .ne 2
603 604 .na
604 605 \fB\fBdhcp-retries\fR\fR
605 606 .ad
606 607 .sp .6
607 608 .RS 4n
608 609 maximum number of DHCP retries
609 610 .RE
610 611
611 612 If no parameters are specified (that is, \fBnetwork-boot-arguments\fR is an
612 613 empty string), the PROM will use the platform-specific default address
613 614 discovery protocol.
614 615 .sp
615 616 Absence of the protocol parameter when other configuration parameters are
616 617 specified implies manual configuration.
617 618 .sp
618 619 Manual configuration requires that the client be provided with all the
619 620 information necessary for boot. If using manual configuration, information
620 621 required by the PROM to load the second-stage boot program must be provided in
621 622 \fBnetwork-boot-arguments\fR while information required for the second-stage
622 623 boot program can be specified either as arguments to the \fBboot\fR program or
623 624 by means of the \fBboot\fR program's interactive command interpreter.
624 625 .sp
625 626 Information required by the PROM when using manual configuration includes the
626 627 booting client's IP address, name of the boot file, and the address of the
627 628 server providing the boot file image. Depending on network configuration, it
628 629 might be required that the subnet mask and address of the default router to use
629 630 also be specified.
630 631 .RE
631 632
632 633 .sp
633 634 .ne 2
634 635 .na
635 636 \fBoem-banner\fR
636 637 .ad
637 638 .sp .6
638 639 .RS 4n
639 640 Custom OEM banner (enabled by setting \fBoem-banner?\fR to \fBtrue\fR).
640 641 Defaults to empty string.
641 642 .RE
642 643
643 644 .sp
644 645 .ne 2
645 646 .na
646 647 \fBoem-banner?\fR
647 648 .ad
648 649 .sp .6
649 650 .RS 4n
650 651 If \fBtrue\fR, use custom \fBOEM\fR banner. Defaults to \fBfalse\fR.
651 652 .RE
652 653
653 654 .sp
654 655 .ne 2
655 656 .na
656 657 \fBoem-logo\fR
657 658 .ad
658 659 .sp .6
659 660 .RS 4n
660 661 Byte array custom OEM logo (enabled by setting \fBoem-logo?\fR to \fBtrue\fR).
661 662 Displayed in hexadecimal.
662 663 .RE
663 664
664 665 .sp
665 666 .ne 2
666 667 .na
667 668 \fBoem-logo?\fR
668 669 .ad
669 670 .sp .6
670 671 .RS 4n
671 672 If \fBtrue\fR, use custom OEM logo (else, use Sun logo). Defaults to
672 673 \fBfalse\fR.
673 674 .RE
674 675
675 676 .sp
676 677 .ne 2
677 678 .na
678 679 \fBpci-mem64?\fR
679 680 .ad
680 681 .sp .6
681 682 .RS 4n
682 683 If true, the OpenBoot PROM allocates 64-bit PCI memory addresses to a PCI
683 684 device that can support 64-bit addresses.
684 685 .sp
685 686 This variable is available on SPARC platforms only and is optional. Some
686 687 versions of SunOS do not support PCI \fBMEM64\fR addresses and will fail in
687 688 unexpected ways if the OpenBoot PROM allocates PCI \fBMEM64\fR addresses.
688 689 .sp
689 690 The default value is system-dependent. If the variable exists, the default
690 691 value is appropriate to the lowest version of the SunOS that shipped with a
691 692 specific platform.
692 693 .RE
693 694
694 695 .sp
695 696 .ne 2
696 697 .na
697 698 \fBoutput-device\fR
|
↓ open down ↓ |
284 lines elided |
↑ open up ↑ |
698 699 .ad
699 700 .sp .6
700 701 .RS 4n
701 702 Output device used at power-on (usually \fBscreen\fR, \fBttya\fR,
702 703 \fBttyb\fR, \fBttyc\fR, or \fBttyd\fR). Defaults to \fBscreen\fR.
703 704 .RE
704 705
705 706 .sp
706 707 .ne 2
707 708 .na
708 -\fBredmode-reboot?\fR
709 -.ad
710 -.sp .6
711 -.RS 4n
712 -Specify \fBtrue\fR to reboot after a redmode reset trap. Defaults to
713 -\fBtrue\fR. (Sun Enterprise 10000 only.)
714 -.RE
715 -
716 -.sp
717 -.ne 2
718 -.na
719 -\fBredmode-sync?\fR
720 -.ad
721 -.sp .6
722 -.RS 4n
723 -Specify \fBtrue\fR to invoke OpenBoot PROM's \fBsync\fR word after a redmode
724 -reset trap. Defaults to \fBfalse\fR. (Sun Enterprise 10000 only.)
725 -.RE
726 -
727 -.sp
728 -.ne 2
729 -.na
730 709 \fBrootpath\fR
731 710 .ad
732 711 .sp .6
733 712 .RS 4n
734 713 Specifies the root device of the operating system.
735 714 .RE
736 715
737 716 .sp
738 717 .ne 2
739 718 .na
740 719 \fBsbus-probe-list\fR
741 720 .ad
742 721 .sp .6
743 722 .RS 4n
744 723 Designate which SBus slots are probed and in what order. Defaults to
745 724 \fB0123\fR.
746 725 .RE
747 726
748 727 .sp
749 728 .ne 2
750 729 .na
751 730 \fBscreen-#columns\fR
752 731 .ad
753 732 .sp .6
754 733 .RS 4n
755 734 Number of on-screen columns (characters/line). Defaults to \fB80\fR.
756 735 .RE
757 736
758 737 .sp
759 738 .ne 2
760 739 .na
761 740 \fBscreen-#rows\fR
762 741 .ad
763 742 .sp .6
764 743 .RS 4n
765 744 Number of on-screen rows (lines). Defaults to \fB34\fR.
766 745 .RE
767 746
768 747 .sp
769 748 .ne 2
770 749 .na
771 750 \fBscsi-initiator-id\fR
772 751 .ad
773 752 .sp .6
774 753 .RS 4n
775 754 \fBSCSI\fR bus address of host adapter, range 0-7. Defaults to \fB7\fR.
776 755 .RE
777 756
778 757 .sp
779 758 .ne 2
780 759 .na
781 760 \fBsd-targets\fR
782 761 .ad
783 762 .sp .6
784 763 .RS 4n
785 764 Map \fBSCSI\fR disk units (OpenBoot PROM version 1.\fIx\fR only). Defaults to
786 765 \fB31204567\fR, which means that unit 0 maps to target \fB3\fR, unit 1 maps to
787 766 target \fB1\fR, and so on.
788 767 .RE
789 768
790 769 .sp
791 770 .ne 2
792 771 .na
793 772 \fBsecurity-#badlogins\fR
794 773 .ad
795 774 .sp .6
796 775 .RS 4n
797 776 Number of incorrect security password attempts.This property has no special
798 777 meaning or behavior on x86 based systems.
799 778 .RE
800 779
801 780 .sp
802 781 .ne 2
803 782 .na
804 783 \fBsecurity-mode\fR
805 784 .ad
806 785 .sp .6
807 786 .RS 4n
808 787 Firmware security level (options: \fBnone\fR, \fBcommand\fR, or \fBfull\fR). If
809 788 set to \fBcommand\fR or \fBfull\fR, system will prompt for \fBPROM\fR security
810 789 password. Defaults to \fBnone\fR.This property has no special meaning or
811 790 behavior on x86 based systems.
812 791 .RE
813 792
814 793 .sp
815 794 .ne 2
816 795 .na
817 796 \fBsecurity-password\fR
818 797 .ad
819 798 .sp .6
820 799 .RS 4n
821 800 Firmware security password (never displayed). Can be set only when
822 801 \fBsecurity-mode\fR is set to \fBcommand\fR or \fBfull\fR.This property has no
823 802 special meaning or behavior on x86 based systems.
824 803 .sp
825 804 .in +2
826 805 .nf
827 806 example# eeprom security-password=
828 807 Changing PROM password:
829 808 New password:
830 809 Retype new password:
831 810 .fi
832 811 .in -2
833 812 .sp
834 813
835 814 .RE
836 815
837 816 .sp
838 817 .ne 2
839 818 .na
840 819 \fBselftest-#megs\fR
|
↓ open down ↓ |
101 lines elided |
↑ open up ↑ |
841 820 .ad
842 821 .sp .6
843 822 .RS 4n
844 823 Megabytes of \fBRAM\fR to test. Ignored if \fBdiag-switch?\fR is \fBtrue\fR.
845 824 Defaults to \fB1\fR.
846 825 .RE
847 826
848 827 .sp
849 828 .ne 2
850 829 .na
851 -\fBsir-sync?\fR
852 -.ad
853 -.sp .6
854 -.RS 4n
855 -Specify \fBtrue\fR to invoke OpenBoot PROM's \fBsync\fR word after a
856 -software-initiated reset (\fBSIR\fR) trap. Defaults to \fBfalse\fR. (Sun
857 -Enterprise 10000 only.)
858 -.RE
859 -
860 -.sp
861 -.ne 2
862 -.na
863 830 \fBskip-vme-loopback?\fR
864 831 .ad
865 832 .sp .6
866 833 .RS 4n
867 834 If \fBtrue\fR, POST does not do VMEbus loopback tests. Defaults to \fBfalse\fR.
868 835 .RE
869 836
870 837 .sp
871 838 .ne 2
872 839 .na
873 840 \fBst-targets\fR
874 841 .ad
875 842 .sp .6
876 843 .RS 4n
877 844 Map \fBSCSI\fR tape units (OpenBoot PROM version 1.\fIx\fR only). Defaults to
878 845 \fB45670123\fR, which means that unit 0 maps to target \fB4\fR, unit 1 maps to
879 846 target \fB5\fR, and so on.
880 847 .RE
881 848
882 849 .sp
883 850 .ne 2
884 851 .na
885 852 \fBsunmon-compat?\fR
886 853 .ad
887 854 .sp .6
888 855 .RS 4n
889 856 If \fBtrue\fR, display Restricted Monitor prompt (\|>). Defaults to
890 857 \fBfalse\fR.
891 858 .RE
892 859
893 860 .sp
894 861 .ne 2
895 862 .na
896 863 \fBtestarea\fR
897 864 .ad
898 865 .sp .6
899 866 .RS 4n
900 867 One-byte scratch field, available for read/write test. Defaults to \fB0\fR.
901 868 .RE
902 869
903 870 .sp
904 871 .ne 2
905 872 .na
906 873 \fBtpe-link-test?\fR
907 874 .ad
908 875 .sp .6
909 876 .RS 4n
910 877 Enable 10baseT link test for built-in twisted pair Ethernet. Defaults to
911 878 \fBtrue\fR.
912 879 .RE
913 880
914 881 .sp
915 882 .ne 2
916 883 .na
917 884 \fBttya-mode\fR
918 885 .ad
919 886 .sp .6
920 887 .RS 4n
921 888 \fBTTYA\fR (baud rate, #bits, parity, #stop, handshake). Defaults to
922 889 \fB9600,8,n,1,\(mi\fR.
923 890 .sp
924 891 Fields, in left-to-right order, are:
925 892 .sp
926 893 .ne 2
927 894 .na
928 895 \fBBaud rate:\fR
929 896 .ad
930 897 .sp .6
931 898 .RS 4n
932 899 110, 300, 1200, 4800, 9600\|.\|.\|.
933 900 .RE
934 901
935 902 .sp
936 903 .ne 2
937 904 .na
938 905 \fBData bits:\fR
939 906 .ad
940 907 .sp .6
941 908 .RS 4n
942 909 5, 6, 7, 8
943 910 .RE
944 911
945 912 .sp
946 913 .ne 2
947 914 .na
948 915 \fBParity:\fR
949 916 .ad
950 917 .sp .6
951 918 .RS 4n
952 919 n(none), e(even), o(odd), m(mark), s(space)
953 920 .RE
954 921
955 922 .sp
956 923 .ne 2
957 924 .na
958 925 \fBStop bits:\fR
959 926 .ad
960 927 .sp .6
961 928 .RS 4n
962 929 1, 1.5, 2
963 930 .RE
964 931
965 932 .sp
966 933 .ne 2
967 934 .na
968 935 \fBHandshake:\fR
969 936 .ad
970 937 .sp .6
971 938 .RS 4n
972 939 \(mi(none), h(hardware:rts/cts), s(software:xon/xoff)
973 940 .RE
974 941
975 942 .RE
976 943
977 944 .sp
978 945 .ne 2
979 946 .na
980 947 \fBtty\fIX\fR-mode\fR
981 948 .ad
982 949 .sp .6
983 950 .RS 4n
984 951 \fBTTYB, TTYC, or TTYD\fR (baud rate, #bits, parity, #stop, handshake). Defaults to
985 952 \fB9600,8,n,1,\(mi\fR.
986 953 .sp
987 954 Fields, in left-to-right order, are:
988 955 .sp
989 956 .ne 2
990 957 .na
991 958 \fBBaud rate:\fR
992 959 .ad
993 960 .sp .6
994 961 .RS 4n
995 962 110, 300, 1200, 4800, 9600\|.\|.\|.
996 963 .RE
997 964
998 965 .sp
999 966 .ne 2
1000 967 .na
1001 968 \fBData bits:\fR
1002 969 .ad
1003 970 .sp .6
1004 971 .RS 4n
1005 972 5, 6, 7, 8
1006 973 .RE
1007 974
1008 975 .sp
1009 976 .ne 2
1010 977 .na
1011 978 \fBStop bits:\fR
1012 979 .ad
1013 980 .sp .6
1014 981 .RS 4n
1015 982 1, 1.5, 2
1016 983 .RE
1017 984
1018 985 .sp
1019 986 .ne 2
1020 987 .na
1021 988 \fBParity:\fR
1022 989 .ad
1023 990 .sp .6
1024 991 .RS 4n
1025 992 n(none), e(even), o(odd), m(mark), s(space)
1026 993 .RE
1027 994
1028 995 .sp
1029 996 .ne 2
1030 997 .na
1031 998 \fBHandshake:\fR
1032 999 .ad
1033 1000 .sp .6
1034 1001 .RS 4n
1035 1002 \(mi(none), h(hardware:rts/cts), s(software:xon/xoff)
1036 1003 .RE
1037 1004
1038 1005 .RE
1039 1006
1040 1007 .sp
1041 1008 .ne 2
1042 1009 .na
1043 1010 \fBttya-ignore-cd\fR
1044 1011 .ad
1045 1012 .sp .6
1046 1013 .RS 4n
1047 1014 If \fBtrue\fR, operating system ignores carrier-detect on TTYA. Defaults to
1048 1015 \fBtrue\fR.
1049 1016 .RE
1050 1017
1051 1018 .sp
1052 1019 .ne 2
1053 1020 .na
1054 1021 \fBtty\fIX\fR-ignore-cd\fR
1055 1022 .ad
1056 1023 .sp .6
1057 1024 .RS 4n
1058 1025 If \fBtrue\fR, operating system ignores carrier-detect on TTYB, TTYC, or TTYD.
1059 1026 Defaults to \fBtrue\fR.
1060 1027 .RE
1061 1028
1062 1029 .sp
1063 1030 .ne 2
1064 1031 .na
1065 1032 \fBttya-rts-dtr-off\fR
1066 1033 .ad
1067 1034 .sp .6
1068 1035 .RS 4n
1069 1036 If \fBtrue\fR, operating system does not assert DTR and RTS on TTYA. Defaults
1070 1037 to \fBfalse\fR.
1071 1038 .RE
1072 1039
1073 1040 .sp
1074 1041 .ne 2
1075 1042 .na
1076 1043 \fBtty\fIX\fR-rts-dtr-off\fR
1077 1044 .ad
1078 1045 .sp .6
1079 1046 .RS 4n
1080 1047 If \fBtrue\fR, operating system does not assert DTR and RTS on TTYB, TTYC,
1081 1048 or TTYD. Defaults to \fBfalse\fR.
1082 1049 .RE
1083 1050
1084 1051 .sp
1085 1052 .ne 2
1086 1053 .na
1087 1054 \fBuse-nvramrc?\fR
1088 1055 .ad
1089 1056 .sp .6
1090 1057 .RS 4n
1091 1058 If \fBtrue\fR, execute commands in \fBNVRAMRC\fR during system start-up.
1092 1059 Defaults to \fBfalse\fR.
1093 1060 .RE
1094 1061
1095 1062 .sp
1096 1063 .ne 2
1097 1064 .na
1098 1065 \fBverbosity\fR
1099 1066 .ad
1100 1067 .sp .6
1101 1068 .RS 4n
1102 1069 Controls the level of verbosity of PROM messages. Can be one of \fBdebug\fR,
1103 1070 \fBmax\fR, \fBnormal\fR, \fBmin\fR, or \fBnone\fR. Defaults to \fBnormal\fR.
1104 1071 .RE
1105 1072
1106 1073 .sp
1107 1074 .ne 2
1108 1075 .na
1109 1076 \fBversion2?\fR
1110 1077 .ad
1111 1078 .sp .6
1112 1079 .RS 4n
1113 1080 If \fBtrue\fR, hybrid (1.\fIx\fR/2.\fIx\fR) PROM comes up in version 2.\fIx\fR.
1114 1081 Defaults to \fBtrue\fR.
1115 1082 .RE
1116 1083
|
↓ open down ↓ |
244 lines elided |
↑ open up ↑ |
1117 1084 .sp
1118 1085 .ne 2
1119 1086 .na
1120 1087 \fBwatchdog-reboot?\fR
1121 1088 .ad
1122 1089 .sp .6
1123 1090 .RS 4n
1124 1091 If \fBtrue\fR, reboot after watchdog reset. Defaults to \fBfalse\fR.
1125 1092 .RE
1126 1093
1127 -.sp
1128 -.ne 2
1129 -.na
1130 -\fBwatchdog-sync?\fR
1131 -.ad
1132 -.sp .6
1133 -.RS 4n
1134 -Specify \fBtrue\fR to invoke OpenBoot PROM's \fBsync\fR word after a watchdog
1135 -reset trap. Defaults to \fBfalse\fR. ( Sun Enterprise 10000 only.)
1136 -.RE
1137 -
1138 -.sp
1139 -.ne 2
1140 -.na
1141 -\fBxir-sync?\fR
1142 -.ad
1143 -.sp .6
1144 -.RS 4n
1145 -Specify \fBtrue\fR to invoke OpenBoot PROM's \fBsync\fR word after an \fBXIR\fR
1146 -trap. Defaults to \fBfalse\fR. (Sun Enterprise 10000 only.)
1147 -.RE
1148 -
1149 1094 .SH EXAMPLES
1150 1095 .LP
1151 1096 \fBExample 1 \fRChanging the Number of Megabytes of RAM.
1152 1097 .sp
1153 1098 .LP
1154 1099 The following example demonstrates the method for changing from one to two the
1155 1100 number of megabytes of \fBRAM\fR that the system will test.
1156 1101
1157 1102 .sp
1158 1103 .in +2
1159 1104 .nf
1160 1105 example# \fBeeprom selftest-#megs\fR
1161 1106 selftest-#megs=1
1162 1107
1163 1108 example# eeprom selftest-#megs=2
1164 1109
1165 1110 example# \fBeeprom selftest-#megs\fR
1166 1111 selftest-#megs=2
1167 1112 .fi
1168 1113 .in -2
1169 1114 .sp
1170 1115
1171 1116 .LP
1172 1117 \fBExample 2 \fRSetting the \fBauto-boot?\fR Parameter to \fBtrue\fR.
1173 1118 .sp
1174 1119 .LP
1175 1120 The following example demonstrates the method for setting the \fBauto-boot?\fR
1176 1121 parameter to \fBtrue\fR.
1177 1122
1178 1123 .sp
1179 1124 .in +2
1180 1125 .nf
1181 1126 example# \fBeeprom auto-boot?=true\fR
1182 1127 .fi
1183 1128 .in -2
1184 1129 .sp
1185 1130
1186 1131 .sp
1187 1132 .LP
1188 1133 When the \fBeeprom\fR command is executed in user mode, the parameters with a
1189 1134 trailing question mark (?) need to be enclosed in double quotation marks (" ")
1190 1135 to prevent the shell from interpreting the question mark. Preceding the
1191 1136 question mark with an escape character (\fB\e\fR) will also prevent the shell
1192 1137 from interpreting the question mark.
1193 1138
1194 1139 .sp
1195 1140 .in +2
1196 1141 .nf
1197 1142 \fBexample% eeprom "auto-boot?"=true\fR
1198 1143 .fi
1199 1144 .in -2
1200 1145 .sp
1201 1146
1202 1147 .LP
1203 1148 \fBExample 3 \fRUsing \fBnetwork-boot-arguments\fR
1204 1149 .sp
1205 1150 .LP
1206 1151 To use DHCP as the boot protocol and a hostname of \fBabcd.example.com\fR for
1207 1152 network booting, set these values in \fBnetwork-boot-arguments\fR as:
1208 1153
1209 1154 .sp
1210 1155 .in +2
1211 1156 .nf
1212 1157 example# \fBeeprom network-boot-arguments="dhcp,hostname=abcd.example.com"\fR
1213 1158 .fi
1214 1159 .in -2
1215 1160 .sp
1216 1161
1217 1162 .sp
1218 1163 .LP
1219 1164 \&...then boot using the command:
1220 1165
1221 1166 .sp
1222 1167 .in +2
1223 1168 .nf
1224 1169 ok \fBboot net\fR
1225 1170 .fi
1226 1171 .in -2
1227 1172 .sp
1228 1173
1229 1174 .sp
1230 1175 .LP
1231 1176 Note that network boot arguments specified from the PROM command line cause the
1232 1177 contents of \fBnetwork-boot-arguments\fR to be ignored. For example, with
1233 1178 \fBnetwork-boot-arguments\fR set as shown above, the \fBboot\fR command:
1234 1179
1235 1180 .sp
1236 1181 .in +2
1237 1182 .nf
1238 1183 ok \fBboot net:dhcp\fR
1239 1184 .fi
1240 1185 .in -2
1241 1186 .sp
1242 1187
1243 1188 .sp
1244 1189 .LP
1245 1190 \&...causes DHCP to be used, but the \fBhostname\fR specified in
1246 1191 \fBnetwork-boot-arguments\fR will not be used during network boot.
1247 1192
1248 1193 .LP
1249 1194 \fBExample 4 \fRSetting System Console to Auxiliary Device
1250 1195 .sp
1251 1196 .LP
1252 1197 The command below assigns the device \fB/dev/term/a\fR as the system console
1253 1198 device. You would make such an assignment prior to using \fBtip\fR(1) to
1254 1199 establish a \fBtip\fR connection to a host.
1255 1200
1256 1201 .sp
1257 1202 .LP
1258 1203 On a SPARC machine:
1259 1204
1260 1205 .sp
1261 1206 .in +2
1262 1207 .nf
1263 1208 # \fBeeprom output-device=/dev/term/a\fR
1264 1209 .fi
1265 1210 .in -2
1266 1211 .sp
1267 1212
1268 1213 .sp
1269 1214 .LP
1270 1215 On an x86 machine:
1271 1216
1272 1217 .sp
1273 1218 .in +2
1274 1219 .nf
1275 1220 # \fBeeprom console=ttya\fR
1276 1221 .fi
1277 1222 .in -2
1278 1223 .sp
1279 1224
1280 1225 .sp
1281 1226 .LP
1282 1227 On a SPARC machine, the preceding command would be sufficient for assigning the
1283 1228 console to an auxiliary device. For an x86 machine, you might, in addition,
1284 1229 need to set the characteristics of the serial line, for which you would have to
1285 1230 consult the BIOS documentation for that machine. Also, on some x86 machines,
1286 1231 you might use a device other than device \fBa\fR, as shown above. For example,
1287 1232 you could set console to \fBttyb\fR if the second serial port is present.
1288 1233
1289 1234 .SH FILES
1290 1235 .ne 2
1291 1236 .na
1292 1237 \fB\fB/boot/solaris/bootenv.rc\fR\fR
1293 1238 .ad
1294 1239 .sp .6
1295 1240 .RS 4n
1296 1241 File storing \fBeeprom\fR values on x86 machines.
1297 1242 .RE
1298 1243
1299 1244 .sp
1300 1245 .ne 2
1301 1246 .na
1302 1247 \fB\fB/dev/openprom\fR\fR
1303 1248 .ad
1304 1249 .sp .6
1305 1250 .RS 4n
1306 1251 Device file
1307 1252 .RE
1308 1253
1309 1254 .sp
1310 1255 .ne 2
1311 1256 .na
|
↓ open down ↓ |
153 lines elided |
↑ open up ↑ |
1312 1257 \fB\fB/usr/platform/\fR\fIplatform-name\fR\fB/sbin/eeprom\fR\fR
1313 1258 .ad
1314 1259 .sp .6
1315 1260 .RS 4n
1316 1261 Platform-specific version of \fBeeprom\fR. Use \fBuname\fR \fB-i\fR to obtain
1317 1262 \fIplatform-name\fR.
1318 1263 .RE
1319 1264
1320 1265 .SH SEE ALSO
1321 1266 .LP
1322 -\fBpasswd\fR(1), \fBsh\fR(1), \fBsvcs\fR(1), \fBtip\fR(1), \fBuname\fR(1),
1267 +\fBpasswd\fR(1), \fBsh\fR(1), \fBsvcs\fR(1), \fBtip\fR(1), \fBuname\fR(1),
1323 1268 \fBboot\fR(1M), \fBkadb\fR(1M), \fBkernel\fR(1M), \fBinit\fR(1M),
1324 1269 \fBsvcadm\fR(1M), \fBattributes\fR(5), \fBsmf\fR(5)
1325 1270 .sp
1326 1271 .LP
1327 1272 \fIOpenBoot 3.x Command Reference Manual\fR
1328 1273 .sp
1329 1274 .LP
1330 1275 \fI\fR
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX