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