SYNOPSIS

SPARC

IA

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.

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.

IA

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 IA based systems typically implement password protection in the system 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 IA based systems, these properties have no special meaning or behavior on IA based systems.

OPTIONS

-f device

Use device as the EEPROM device.

IA Only

-I

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

OPERANDS

IA Only

acpi-user-options

A configuration variable that controls the use of ACPI. A value of 0x0 attempts to use ACPI if it is available on the system.
A value of 0x2 disables the use of ACPI. Defaults to 0x0.

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 IA
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 vary depending on the system and the PROM revision. See the output in the "Default Value" column of the printenv command, as entered at the ok (OpenBoot) prompt, to determine
the default for your system.

auto-boot?

If true, boots automatically after power-on or reset. Defaults to 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, echoes them to the
output device. Defaults to true.

boot-command

Command executed if auto-boot? is true. Defaults to 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 that opens successfully will be used as the device to boot from. Defaults to disk net.

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

diag-device

Diagnostic boot source device. Defaults to net.

diag-file

File from which to boot in diagnostic mode. Defaults to 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 interpreted by POST. Defaults to platform-dependent.

diag-switch?

If true, run in diagnostic mode. Defaults to false on most desktop systems, true on most servers.

error-reset-recovery

Recover after an error reset trap. Defaults to platform-specific setting.

On platforms supporting this variable, it replaces the watchdog-reboot?, watchdog-sync?, redmode-reboot?, redmode-sync?, sir-sync?, and xir-sync? parameters.

Number of incorrect security password attempts.This property has no special meaning or behavior on IA 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. Defaults to none.This property has no special meaning or behavior on IA 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 IA based systems.

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. Preceding the question mark with an escape character (\) will also prevent the shell from interpreting the question mark.

example% eeprom "auto-boot?"=true

Example 3 Enabling and Disabling PAE Mode

Certain IA machines support Physical Address Extension (PAE) mode. To enable and disable PAE mode on these machines, use commands such as those below.

To enable PAE mode:

example# eeprom mmu-modlist=mmu36

To disable PAE mode:

example# eeprom mmu-modlist=mmu32

These commands take effect following your next reboot.

FILES

/dev/openprom

Device file

/usr/platform/platform-name/sbin/eeprom

Platform-specific version of eeprom. Use uname -i to obtain platform-name.