eeprom(1M)
NAME
eeprom − EEPROM display and load utility
SYNOPSIS
SUN-4 SYSTEMS
eeprom [−] [−c] [−i] [−f device ] [parameter[=value] ...]
Desktop SPARCsystems, SPARCsystem 600MP SERIES
eeprom [−] [−f device ] [parameter[=value] ...]
AVAILABILITY
SPARC
SUNWcsu
DESCRIPTION
eeprom displays or changes the values of parameters in the EEPROM. It processes parameters in the order given. When processing a parameter accompanied by a value, eeprom makes the indicated alteration to the EEPROM; otherwise it displays the parameter’s value. When given no parameter specifiers, eeprom displays the values of all EEPROM parameters. A ‘−’ (hyphen) flag specifies that parameters and values are to be read from the standard input (one parameter or parameter=value per line).
Only the super-user may alter the EEPROM contents.
eeprom verifies the EEPROM checksums and complains if they are incorrect; if the −i flag is specified, erroneous checksums are ignored. If the −c flag is specified, all incorrect checksums are recomputed and corrected in the EEPROM.
OPTIONS
−c Correct bad checksums. (Ignored on SPARCstation 1 systems.)
−i Ignore bad checksums. (Ignored on SPARCstation 1 systems.)
−f device Use device as the EEPROM device.
NVRAM CONFIGURATION PARAMETERS
SUN-4 SYSTEMS
bad_login number of bad login tries (16-bit unsigned integer, 0 if reset) The parameter bad_login maintains the count of bad login tries. It may be reset to zero (0) by specifying bad_login=reset.
banner banner string
bootdev charchar(hex-int, hex-int,hex-int) (with char a character, and hex-int a hexadecimal integer.)
columns number of columns on screen (8-bit integer)
console b&w or ttya or ttyb or color
custom_logo true or false
default_boot true or false
diagdev %c%c (%x,%x,%x) — diagnostic boot device
diagpath diagnostic boot path
hwupdate a valid date (including today and now)
kbdtype 8 bit integer (0 for all Sun keyboards)
keyclick true or false
memsize 8 bit integer (megabytes of memory on machine)
memtest 8 bit integer (megabytes of memory to test)
password PROM monitor password (8-bytes) The content of the password parameter is never displayed to any user. If the security mode is not none, the super-user may change the PROM monitor password by entering:
example# eeprom password=
eeprom prompts for a new password to be entered and re-entered.
rows number of rows on screen (8-bit integer)
scrsize 1024x1024, 1152x900, 1600x1280, or 1440x1440
secure none, command, or full If secure=none the PROM monitor runs in the non-secure mode. In this mode all PROM monitor commands are allowed with no password required. If secure=command the PROM monitor is in the command secure mode. In this mode, only the b (boot) command with no parameters and the c (continue) command with no parameters may be entered without a password being required. Any other command requires that the PROM monitor password be entered. If secure=full the PROM monitor is in the fully secure mode. In this mode, only the c (continue) command with no parameters may be entered without a password being required. Entry of any other command requires that the PROM monitor password be entered. Note: the system will not auto-reboot in fully secure mode. The PROM monitor password must be entered before the boot process will take place. When changing the security mode from non-secure to either command secure or fully secure, eeprom prompts for the entry and re-entry of a new PROM password as in the passwd(1) command. Changing from one secure mode to the other secure mode, or to the non-secure mode does not prompt for a password. Changing to non-secure mode erases the password.
ttya_baud baud rate (16-bit decimal integer)
ttyb_baud baud rate (16-bit decimal integer)
ttya_no_rtsdtr true or false
ttyb_no_rtsdtr true or false
ttya_use_baud true or false
ttyb_use_baud true or false
watchdog_reboot true or false
Desktop SPARCsystems, SPARCsystem 600MP SERIES
Not all OpenBoot systems support all parameters. Defaults may vary depending on the system and the PROM revision.
auto-boot? If true, boot automatically after power-on or reset. Defaults to true.
boot-device Device from which to boot. Defaults to disk.
boot-file File to boot (an empty string lets the secondary booter choose default). Defaults to empty string.
boot-from Boot device and file (OpenBoot PROM version 1.x only). Defaults to vmunix.
boot-from-diag Diagnostic boot device and file (OpenBoot PROM version 1.x only). Defaults to le()unix.
diag-device Diagnostic boot source device. Defaults to net.
diag-file File from which to boot in diagnostic mode. Defaults to empty string.
diag-switch? If true, run in diagnostic mode. Defaults to true.
fcode-debug? If true, include name parameter for plug-in device FCodes. Defaults to false.
hardware-revision System version information.
input-device Power-on input device (usually keyboard, ttya, or ttyb). Defaults to keyboard.
keyboard-click? If true enable keyboard click. Defaults to false.
keymap Keymap for custom keyboard.
last-hardware-update System update information.
local-mac-address? If true, network drivers use their own MAC address, not system’s. Defaults to false.
mfg-switch? If true, repeat system self-tests until interrupted with STOP-A. Defaults to false.
nvramrc Contents of NVRAMRC. Defaults to empty.
oem-banner Custom OEM banner (enabled by setting oem-banner? to true). Defaults to empty string.
oem-banner? If true, use custom OEM banner. Defaults to false.
oem-logo Byte array custom OEM logo (enabled by setting oem-logo? to true). Displayed in hexadecimal.
oem-logo? If true, use custom OEM logo (else, use Sun logo). Defaults to false.
output-device Power-on input device (usually screen, ttya, or ttyb). Defaults to screen.
sbus-probe-list Which SBus slots are probed and in what order. Defaults to 0123.
screen-#columns Number of on-screen columns (characters/line). Defaults to 80.
screen-#rows Number of on-screen rows (lines). Defaults to 34.
scsi-initiator-id SCSI bus address of host adapter, range 0-7. Defaults to 7.
sd-targets Map SCSI disk units (OpenBoot PROM version 1.x only). Defaults to 31204567, which means that unit 0 maps to target 3, unit 1 maps to target 1, and so on.
security-#badlogins Number of incorrect security password attempts.
security-mode Firmware security level (options: none, command, or full). If set to command or full, system will prompt for PROM security password. Defaults to none.
security-password Firmware security password (never displayed). Can be set only when security-mode is set to command or full.
example# eeprom security-password=
Changing PROM password:
New password:
Retype new password:
selftest-#megs Metabytes of RAM to test. Ignored if diag-switch? is true. Defaults to 1.
skip-vme-loopback? If true, POST does not do VMEbus loopback tests. Defaults to false.
st-targets Map SCSI tape units (OpenBoot PROM version 1.x only). Defaults to 45670123, which means that unit 0 maps to target 4, unit 1 maps to target 5, and so on.
sunmon-compat? If true, display Restricted Monitor prompt (>). Defaults to false.
testarea One-byte scratch field, available for read/write test. Defaults to 0.
tpe-link-test? Enable 10baseT link test for built-in twisted pair Ethernet. Defaults to true.
ttya-mode TTYA (baud rate, #bits, parity, #stop, handshake).
Defaults to 9600,8,n,1,−.
Fields, in left-to-right order, are:
baud rate: 110, 300, 1200, 4800, 9600...
data bits: 5, 6, 7, 8
parity: n(none), e(even), o(odd), m(mark), s(space)
stop bits: 1, 1.5, 2
handshake: −(none), h(hardware:rts/cts), s(software:xon/xoff)
ttyb-mode TTYB (baud rate, #bits, parity, #stop, handshake).
Defaults to 9600,8,n,1,−.
Fields, in left-to-right order, are:
baud rate: 110, 300, 1200, 4800, 9600...
data bits: 5, 6, 7, 8
stop bits: 1, 1.5, 2
parity: n(none), e(even), o(odd), m(mark), s(space)
handshake: −(none), h(hardware:rts/cts), s(software:xon/xoff)
ttya-ignore-cd If true, operating system ignores carrier-detect on TTYA. Defaults to true.
ttyb-ignore-cd If true, operating system ignores carrier-detect on TTYA. Defaults to true.
ttya-rts-dtr-off If true, operating system does not assert DTR and RTS on TTYA. Defaults to false.
ttyb-rts-dtr-off If true, operating system does not assert DTR and RTS on TTYB. Defaults to false.
use-nvramrc? If true, execute commands in NVRAMRC during system start-up. Defaults to false.
version2? If true, hybrid (1.x/2.x) PROM comes up in version 2.x. Defaults to true.
watchdog-reboot? If true, reboot after watchdog reset. Defaults to false.
EXAMPLES
The following example demonstrates the method for changing from one to two the number of megabytes of RAM that the system will test.
example# eeprom selftest-#megs
selftest-#megs=1
example# eeprom selftest-#megs=2
example# eeprom selftest-#megs
selftest-#megs=2
The following example demonstrates the method for setting the auto-boot? parameter to true.
example# eeprom auto-boot?=true
Note that on SunOS 4.x systems, when the eeprom command is executed in user mode, the parameters with a trailing question mark (?) need to be enclosed in double quotation marks (" ").
example% eeprom "auto-boot?"=true
FILES
/dev/openprom device file
SEE ALSO
SunOS 5.4 — Last change: 7 Oct 1993