NAME

eeprom - EEPROM display and load utility

SYNOPSIS

/usr/platform/platform-name/sbin/eeprom [ - ] [ -f device ] [ parameter [=value] . . .]

AVAILABILITY

SPARC

SUNWcsu

eeprom is only available on OpenBoot-compatible SPARC systems

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

OPTIONS

-f device

Use device as the EEPROM device.

NVRAM CONFIGURATION

Not all OpenBoot systems support all parameters. Defaults may vary depending on the system and the PROM revision.

PARAMETERS

auto-boot?

If true, boot 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 just

echoing them to the output device. Default value: true.

boot-command

Command executed if auto-boot? is true. Default value is

boot.

boot-device

Device from which to boot. Defaults to disk net.

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

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

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.

load-base

Default load address for client programs. Default value is

16384 .

local-mac-address?

If true, network drivers use their own MAC address, not

system's. Defaults to false.

mfg-mode

Manufacturing mode argument for POST. Possible values

include off or chamber. The value is passed as an argument to POST. Default value: off.

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

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

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

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

FILES

/dev/openprom

device file

/usr/platform/platform-name/sbin/eeprom
                           platform-specific version of eeprom. To obtain platform-
                           name, use uname -i.

SEE ALSO

passwd(1), sh(1), uname(1)