1 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
2 .\" Copyright (c) 2004 Marius Strobl
3 .\" All rights reserved.
5 .\" This code is derived from software contributed to The NetBSD Foundation
6 .\" by Jason R. Thorpe.
8 .\" Redistribution and use in source and binary forms, with or without
9 .\" modification, are permitted provided that the following conditions
11 .\" 1. Redistributions of source code must retain the above copyright
12 .\" notice, this list of conditions and the following disclaimer.
13 .\" 2. Redistributions in binary form must reproduce the above copyright
14 .\" notice, this list of conditions and the following disclaimer in the
15 .\" documentation and/or other materials provided with the distribution.
16 .\" 3. All advertising materials mentioning features or use of this software
17 .\" must display the following acknowledgement:
18 .\" This product includes software developed by the NetBSD
19 .\" Foundation, Inc. and its contributors.
20 .\" 4. Neither the name of The NetBSD Foundation nor the names of its
21 .\" contributors may be used to endorse or promote products derived
22 .\" from this software without specific prior written permission.
24 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
25 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
26 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
27 .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
28 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
29 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
30 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
31 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
32 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
33 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
34 .\" POSSIBILITY OF SUCH DAMAGE.
36 .\" from: NetBSD: eeprom.8,v 1.11 2003/03/31 01:31:39 perry Exp
44 .Nd "display or modify contents of the EEPROM or NVRAM"
50 .Ar name Ns Op = Ns Ar value
55 utility provides an interface for displaying and changing the system's
56 configuration variables contained in EEPROM or NVRAM.
57 In the first synopsis form, all available configuration variables and their
58 current values are printed.
59 In the second form, only the variable selected by
61 and its value is printed or changed if
68 The following options are available:
69 .Bl -tag -width indent
71 Commands for displaying or changing variables are taken from stdin, allowing
79 The output is printed on stdout.
81 Print all available configuration variables and their current values.
83 .Sh VARIABLES AND VALUES
84 Below are variables and values that one is likely to find on a system equipped
85 with OpenBoot 3.x and Open Firmware respectively.
87 Note: the attempt to set a variable to an illegal value results in the
88 Open Firmware setting it to some legal value instead.
91 utility will detect this, try to recover the previous value of the variable
92 and issue a warning telling that the requested value could not be set.
93 .Bl -tag -width ".Va last-hardware-update"
97 the system will try to boot automatically from the devices listed in
101 respectively, using the command specified in
106 .It Va auto-boot-retry?
113 the system will try to boot from the specified boot devices forever.
116 .It Va ansi-terminal?
120 escape sequences are not interpreted by the terminal emulator.
124 Command executed when
131 Default device to boot from if
135 Takes one or more device aliases or device paths.
136 The boot devices are sequentially tried to boot from, beginning with the first
140 .It Va cpci-probe-list
143 specifying in which order to probe the devices on the CompactPCI bus at
145 Default: system-dependent.
147 Default arguments for boot when
151 When empty, the secondary boot loader will choose the file to boot.
152 Default: empty string.
169 Default: empty string.
171 Level of diagnostics to run when
181 (depending on the system model).
184 the Power-On Self Test (POST) is not run.
185 The other values are interpreted by the POST.
194 the system will boot and run in diagnostic mode.
201 Enables or disables the Advanced System Monitoring (ASM).
209 Used for debugging FCode programs.
212 names of additional FCodes are registered in the Forth dictionary.
215 .It Va hardware-revision
216 A string describing the system hardware version.
217 Default: system-dependent.
224 specifying the default console input device.
230 .It Va keyboard-click?
233 the keys click annoyingly.
237 Keymap for a custom keyboard.
238 Default: empty string.
239 .It Va last-hardware-update
241 .Va hardware-revision ,
242 describing when the hardware was last updated.
243 Default: system-dependent.
244 .It Va last-poweroff-cause
245 Cause of the last power-off.
246 Used internally by the OpenBoot PROM.
250 Default address where client programs are loaded to.
251 It is unlikely that this value should ever be changed.
254 .It Va local-mac-address?
257 all Ethernet devices with FCode will use the system default MAC address.
260 Ethernet devices with FCode that contains a unique MAC address will use it
261 rather than the system's default MAC address.
265 Ethernet devices with FCode include those supported by
270 Please see the respective manual page for further information.
272 Manufacture test mode interpreted by the POST.
282 manufacturing tests are repeated until stopped by pressing STOP-A.
288 the system will try to boot forever when the boot device used is a network
290 Any non-zero value is interpreted as minutes to try a network boot.
294 Contents of the NVRAMRC.
295 Default: empty string.
301 it is preferred to use
303 in the boot monitor instead.
305 A string displayed at power-up, rather than the default banner.
310 Default: system-dependent.
316 is displayed at power-up rather than the default banner.
317 Default: system-dependent.
319 A logo displayed at power-up when
323 rather than the default logo.
324 The logo has to be 512 bytes in size, containing a 64x64-bit monochrome image
325 in Sun Raster format without the leading 32-byte header.
326 Default: system-dependent.
330 give the pathname of the file containing the image as the
334 will remove the image.
340 is displayed at power-up rather than the default logo.
347 specifying the default console output device.
353 .It Va pcia-probe-list
356 specifying in which order to probe the devices on the PCI bus A.
357 Default: system-dependent.
358 .It Va pcib-probe-list
360 .Va pcia-probe-list ,
362 Default: system-dependent.
364 Number of power-cycles.
365 Automatically incremented on each power-cycle.
366 Default: system-dependent.
367 .It Va sbus-probe-list
370 specifying in which order to probe the SBus slots at power-up.
371 Default: system-dependent.
372 .It Va screen-#columns
373 An integer specifying the screen width in characters per line.
377 An integer specifying the screen height in lines.
380 .It Va scsi-initiator-id
381 The SCSI ID of SCSI controllers in the range of [0-7] or [0-f] (depending
383 A SCSI controller may or may not adhere to this setting, depending on its
384 FCode and device driver.
387 .It Va security-#badlogins
388 Number of incorrect password attempts when
397 Boot monitor security level.
398 One of the three possible values
405 all boot monitor commands except for
407 require the password.
410 all boot monitor commands except for
414 require the password.
417 no password is required.
429 you will be prompted for the password.
435 will clear the password.
436 .It Va security-password
437 The password used when
443 The maximum length for this password is 8 characters.
444 All characters exceeding this length will be ignored.
445 The value displayed for
446 .Va security-password
447 is always an empty string, even when a password is set.
448 Default: empty string.
457 can be used to enter a new password using any
460 .Va security-password
462 You will be prompted by
464 to type in the new password in this case.
466 .Va security-password
474 .It Va selftest-#megs
475 An integer specifying the number of megabytes of memory to test upon
482 .It Va shutdown-temperature
483 Temperature at which the ASM issues an over-temperature shutdown.
484 Default: system-dependent.
488 memory test messages will not be displayed at power-up.
491 .It Va sunmon-compat?
494 the old bootROM interface will be used while in the boot monitor,
495 rather than the OpenBoot PROM interface.
498 .It Va system-board-date
499 Manufacturing date of the system board.
500 Default: system-dependent.
501 .It Va system-board-serial#
502 Serial number of the system board.
503 Default: system-dependent.
504 .It Va tpe-link-test?
505 Enable link test on 10baseT and 100baseTX Ethernet devices.
509 A string of five comma separated fields in the format
510 .Dq Li 9600,8,n,1,- .
511 The first field is the baud rate.
512 The second field is the number of data bits.
513 The third field is the parity; acceptable values for parity are
524 The fourth field is the number of stop bits.
525 The fifth field is the
527 field; acceptable values are
535 .Dq Li 9600,8,n,1,- .
536 .It Va ttya-ignore-cd
539 the system will ignore carrier detect.
542 .It Va ttya-rts-dtr-off
545 the system will ignore RTS/DTR.
553 .Dq Li 9600,8,n,1,- .
554 .It Va ttyb-ignore-cd
560 .It Va ttyb-rts-dtr-off
562 .Va ttya-rts-dtr-off ,
566 .It Va use-boot-table?
567 Use boot table defined by the OEM.
568 Default: system-dependent.
574 will be executed during start-up.
577 .It Va warning-temperature
578 Temperature at which the ASM issues an over-temperature warning.
579 Default: system-dependent.
580 .It Va watchdog-enable?
581 Enables or disables the system watchdog timer.
584 .It Va watchdog-reboot?
587 the system will reboot upon terminal count of the system watchdog timer.
590 the system will fall into the boot monitor.
593 .It Va watchdog-timeout
594 Expiry limit for the system watchdog timer.
595 Range and unit depend on the system model.
596 Default: system-dependent.
599 Print all available configuration variables and their current values:
603 Print the current value of the
604 .Va local-mac-address?
607 .Dl "eeprom local-mac-address\e?"
610 .Va local-mac-address?
614 .Dl "eeprom local-mac-address\e?=true"
618 in the above examples is used to keep the shell from interpreting the
621 Write an image to the
625 .Dl "eeprom oem-logo=/path/to/image.raw"
627 Remove the image from the
631 .Dl "eeprom oem-logo="
637 and set the password:
638 .Bd -literal -offset indent
639 eeprom security-mode=full
644 Remember that the maximum length for the password is 8 characters.
645 All characters exceeding this length will be ignored.
647 Set a new password when the
653 .Bd -literal -offset indent
654 eeprom security-password=
666 utility first appeared in
668 It was adopted from there by
672 utility was removed from
676 because the utility was unused at that time.
677 The present implementation of the
679 utility first appeared in
681 It is inspired by the
691 utility uses base code from the
694 .An "Jason R. Thorpe" .
695 The handlers for the Open Firmware
698 .An "Marius Strobl" Aq marius@FreeBSD.org .
699 The code for accessing the Open Firmware device tree is shared with the
702 .An "Thomas Moestl" Aq tmm@FreeBSD.org .
706 only supports systems equipped with Open Firmware and is only tested on Sun
707 Microsystems sun4u machines.