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