$NetBSD: eeprom.8,v 1.2 1996/02/28 01:13:24 thorpej Exp $
Copyright (c) 1996 The NetBSD Foundation, Inc.
All rights reserved.
This code is derived from software contributed to The NetBSD Foundation
by Jason R. Thorpe.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
.Dd $Mdocdate: November 8 2022 $ .Dt EEPROM 8 .Os .Sh NAME .Nm eeprom .Nd display or modify contents of the OpenPROM .Sh SYNOPSIS .Nm eeprom .Op Fl pv .Op Fl f Ar device .Oo .Ar field Ns Op = Ns Ar value .Ar ... .Oc .Sh DESCRIPTION .Nm eeprom provides an interface for displaying and changing the contents of the OpenPROM. Without any arguments, .Nm eeprom will list all of the known fields and their corresponding values. When given the name of a specific field, .Nm eeprom will display that value or set it if the field name is followed by .Sq = and a value. Only the superuser may modify the contents of the OpenPROM.
p The options are as follows: l -tag -width Ds t Fl Commands are taken from stdin and displayed on stdout. t Fl f Ar device Use .Ar device instead of the default
a /dev/openprom . t Fl p Display the tree derived from the OpenPROM and exit. t Fl v Be verbose when setting a value. .El .Sh FIELDS AND VALUES Since the OpenPROM is designed such that the field names are arbitrary, explaining them here is dubious. Below are field names and values that one is likely to see. NOTE: this list may be incomplete or incorrect due to differences between revisions of the OpenPROM. l -tag -width "network-boot-arguments " t Ar sunmon-compat? If true, the old EEPROM-style interface will be used while in the monitor, rather than the OpenPROM-style interface. t Ar selftest-#megs A 32-bit integer specifying the number of megabytes of memory to test upon power-up. t Ar oem-logo A 64bitx64bit bitmap in Sun Iconedit format. To set the bitmap, give the pathname of the file containing the image. NOTE: this property is not yet supported. t Ar oem-logo? If true, enables the use of the bitmap stored in .Ar oem-logo rather than the default Sun logo. t Ar oem-banner A string to use at power-up, rather than the default Sun banner. t Ar oem-banner? If true, enables the use of the banner stored in .Ar oem-banner rather than the default Sun banner. t Ar ttya-mode A string of five comma separated fields in the format .Dq 9600,8,n,1,- . The first field is the baud rate. The second field is the number of data bits. The third field is the parity; acceptable values for parity are .Dq n (none), .Dq e (even), .Dq o (odd), .Dq m (mark), and .Dq s (space). The fourth field is the number of stop bits. The fifth field is the .Dq handshake field; acceptable values are .Dq - (none), .Dq h (RTS/CTS), and .Dq s (XON/XOFF). t Ar ttya-rts-dtr-off If true, the system will ignore RTS/DTR. t Ar ttya-ignore-cd If true, the system will ignore carrier detect. t Ar ttyb-mode Similar to .Ar ttya-mode , but for ttyb. t Ar ttyb-rts-dtr-off Similar to .Ar ttya-rts-dtr-off , but for ttyb. t Ar ttyb-ignore-cd Similar to .Ar ttya-ignore-cd , but for ttyb. t Ar sbus-probe-list Four digits in the format .Dq 0123 specifying which order to probe the SBus at power-up. It is unlikely that this value should ever be changed. t Ar screen-#columns An 8-bit integer specifying the number of columns on the console. t Ar screen-#rows An 8-bit integer specifying the number of rows on the console. t Ar boot-device Space separated list of device aliases or device paths to boot from, in the given order. t Ar boot-file File to boot. The empty string lets the second-stage boot program .Sy ofwboot choose the default. t Ar auto-boot? If true, the system will boot automatically at power-up. t Ar watchdog-reboot? If true, the system will reboot upon reset. Otherwise, the system will fall into the monitor. t Ar input-device One of the strings .Dq keyboard , .Dq ttya , or .Dq ttyb specifying the default console input device. t Ar output-device One of the strings .Dq screen , .Dq ttya , or .Dq ttyb specifying the default console output device. t Ar keyboard-click? If true, the keys click annoyingly. t Ar network-boot-arguments Comma separated list of arguments for booting over RARP or BOOTP/DHCP and TFTP. t Ar sd-targets A string in the format .Dq 31204567 describing the translation of physical to logical target. t Ar st-targets Similar to .Ar sd-targets , but for tapes. The default translation is .Dq 45670123 . t Ar scsi-initiator-id The SCSI ID of the on-board SCSI controller. t Ar hardware-revision A 7-character string describing a date, such as .Dq 25May95 . t Ar last-hardware-update Similar to .Ar hardware-revision , describing when the CPU was last updated. t Ar diag-switch? If true, the system will boot and run in diagnostic mode. t Ar local-mac-address? When set to .Em false , all Ethernet devices will use the same system default MAC address. When .Em true , Ethernet devices which have a unique MAC address will use it rather than the system default MAC address. This option only really affects FCode-based Ethernet devices. On Sparc64, all on-board devices, as well as plug-in .Xr hme 4 boards, will respect this setting; other hardware will not. .El .Sh FILES l -tag -width "/dev/openprom" -compact t /dev/openprom the OpenPROM device .El .Sh SEE ALSO .Xr openprom 4 .Sh CAVEATS The fields and their values are not necessarily well defined on systems with an OpenPROM. Your mileage may vary.
p There are a few fields known to exist in some revisions of the OpenPROM that are not yet supported. Most notable are those relating to password protection of the OpenPROM.
p The date parser isn't very intelligent.