Man Pages (1M): Maintenance and Administration Commands

eeprom(1M)

NAME

eeprom- EEPROM Display and Load Utility

SYNOPSIS

SPARC

/usr/platform/

platform-name

-

-f

device

parameter

value

x86

/usr/platform/

platform-name

-

-f

device

-I

mmu-modlist

parameter

value

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).

eeprom verifies the EEPROM checksums and complains if they are incorrect.

platform-name is the name of the platform implementation and can be found using the -i option of uname(1).

SPARC

SPARC based systems implement firmware password protection with eeprom using the security-mode, security-password, and security-#badlogins properties.

x86

EEPROM storage is simulated using a file residing in the platform specific boot area. The /platform/platform-name/boot/solaris/bootenv.rc file simulates EEPROM storage.

Because x86 based systems typically implement password protection in the sytem BIOS, there is no support for password protection in the eeprom program. While it is possible to set the security-mode, security-password, and security-#badlogins properties on x86 based systems, these properties have no special meaning or behavior on x86 based systems.

OPTIONS

-f device: Use device as the EEPROM device.

x86 Only

-I: Initialize boot properties on an x86 based system. Only init(1M) run-level initialization scripts should use this option.

OPERANDS

x86 Only

mmu-modlist: A colon-separated list of candidate modules that implement memory management. If mmu-modlist is defined, it overrides the default list derived from the memory configuration on x86 based systems. Instead, the first module in the list that is found in /platform/platform-name/kernel/mmu is used.

NVRAM CONFIGURATION PARAMETERS

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. The default value is true.

ansi-terminal?

Configuration variable used to control the behavior of the terminal emulator. The value false makes the terminal emulator stop interpreting ANSI escape sequences, instead just echoing them to the output device. The default value is true.

boot-command

Command executed if auto-boot? is true. The default value is boot.

boot-device

Device from which to boot. boot-device may contain 0 or more device specifiers separated by spaces. Each device specifier may be either a prom device alias or a prom device path. The boot prom will attempt to open each successive device specifier in the list beginning with the first device specifier. The first device specifier which opens successfully will be used as the device to boot from. The default value is disk net.

boot-file

File to boot (an empty string lets the secondary booter choose default). The default is an empty string.

boot-from

Boot device and file (OpenBoot PROM version 1.x only). The default value is vmunix.

boot-from-diag

Diagnostic boot device and file (OpenBoot PROM version 1.x only). The default value is le()unix.

comX-noprobe

Where X is the number of the serial port, prevents device probe on serial port X.

diag-device

Diagnostic boot source device. The default value is net.

diag-file

File from which to boot in diagnostic mode. The default is an empty string.

diag-level

Diagnostics level. Values include off, min, max, and menus. There may be additional platform-specific values. When set to off, POST is not called. If POST is called, the value is made available as an argument to, and is interpretted by POST. The default value is platform-dependent.

diag-switch?

If true, run in diagnostic mode. The default value is true.

fcode-debug?

If true, include name parameter for plug-in device FCodes. The default value is false.

hardware-revision

System version information.

input-device

Input device used at power-on (usually keyboard, ttya, or ttyb). The default is keyboard.

keyboard-click?

If true enable keyboard click. The default value is false.

keymap

Keymap for custom keyboard.

last-hardware-update

System update information.

load-base

Default load address for client programs. The default value is 16384.

local-mac-address?

If true, network drivers use their own MAC address, not system's. The default value is false.

mfg-mode

Manufacturing mode argument for POST. Possible values include off or chamber. The value is passed as an argument to POST. The default value is off.

mfg-switch?

If true, repeat system self-tests until interrupted with STOP-A. The default value is false.

nvramrc

Contents of NVRAMRC. The default value is empty.

oem-banner

Custom OEM banner (enabled by setting oem-banner? to true). The default is an empty string.

oem-banner?

If true, use custom OEM banner. The default value is 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). The default value is false.

output-device

Output device used at power-on (usually screen, ttya, or ttyb). The default value is screen.

sbus-probe-list

Which SBus slots are probed and in what order. The default is 0123.

screen-#columns

Number of on-screen columns (characters/line). The default is 80.

screen-#rows

Number of on-screen rows (lines). The default is 34.

scsi-initiator-id

SCSI bus address of host adapter, range 0-7. The default is 7.

sd-targets

Map SCSI disk units (OpenBoot PROM version 1.x only). The default is 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.

This property has no special meaning or behavior on x86 based systems.

security-mode

Firmware security level (options: none, command, or full). If set to command or full, system will prompt for PROM security password. The default is none.

This property has no special meaning or behavior on x86 based systems.

security-password

Firmware security password (never displayed). Can be set only when security-mode is set to command or full.

This property has no special meaning or behavior on x86 based systems.

example# eeprom security-password=
Changing PROM password:
New password:
Retype new password:

selftest-#megs

Megabytes of RAM to test. Ignored if diag-switch? is true. The default is 1.

skip-vme-loopback?

If true, POST does not do VMEbus loopback tests. The default is false.

st-targets

Map SCSI tape units (OpenBoot PROM version 1.x only). The default is 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 (>). The default is false.

testarea

One-byte scratch field, available for read/write test. The default is 0.

tpe-link-test?

Enable 10baseT link test for built-in twisted pair Ethernet. The default is true.

ttya-mode

TTYA (baud rate, #bits, parity, #stop, handshake). The default is 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). The default is 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. The default is true.

ttyb-ignore-cd

If true, operating system ignores carrier-detect on TTYA. The default is true.

ttya-rts-dtr-off

If true, operating system does not assert DTR and RTS on TTYA. The default is false.

ttyb-rts-dtr-off

If true, operating system does not assert DTR and RTS on TTYB. The default is false.

use-nvramrc?

If true, execute commands in NVRAMRC during system start-up. The default is false.

version2?

If true, hybrid (1.x/2.x) PROM comes up in version 2.x. The default is true.

watchdog-reboot?

If true, reboot after watchdog reset. The default is false.

EXAMPLES

Example 1 Changing the number of megabytes of RAM.

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

Example 2 Setting the `auto-boot?` parameter to `true`.

The following example demonstrates the method for setting the auto-boot? parameter to true.

example# eeprom auto-boot?=true

When the eeprom command is executed in user mode, the parameters with a trailing question mark (?) need to be enclosed in double quotation marks (" ") to prevent the shell from interpreting the question mark.

example% eeprom "auto-boot?"=true

Preceding the question mark with an escape character (\) will also prevent the shell from interpreting the question mark.

SUMMARY OF TRUSTED SOLARIS CHANGES

For administrative users who alter the EEPROM contents, this command must be invoked with effective user ID of 0.

FILES

/dev/openprom: device file
/usr/platform/platform-name/sbin/eeprom: Platform-specific version of eeprom. Use uname -i. to obtain platform-name.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWcsu

Trusted Solaris 7 Reference Manual

uname(2)

SunOS 5.7 Reference Manual

passwd(1), sh(1), attributes(5)

Trusted Solaris 7 Last Revised 13 Mar 1998

eeprom(1M)

NAME

SYNOPSIS

SPARC

x86

DESCRIPTION

SPARC

x86

OPTIONS

x86 Only

OPERANDS

x86 Only

NVRAM CONFIGURATION PARAMETERS

EXAMPLES

Example 1 Changing the number of megabytes of RAM.

Example 2 Setting the auto-boot? parameter to true.

SUMMARY OF TRUSTED SOLARIS CHANGES

FILES

ATTRIBUTES

SEE ALSO

Trusted Solaris 7 Reference Manual

SunOS 5.7 Reference Manual

Example 2 Setting the `auto-boot?` parameter to `true`.