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