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