.\" -*- nroff -*-
.\" Copyright 1999 by Jakub Jelinek.  All Rights Reserved.
.\" This file may be copied under the terms of the GNU Public License.
.\" 
.TH EEPROM 8 "October 1999" "Eeprom version 1.0"
.SH NAME
eeprom \- display and modify OpenPROM options
.SH SYNOPSIS
.B eeprom
[
.B -
]
[
.B -f
.I device
]
[
.B -d
.I device
]
[
.I parameter
[
.B =
.I value
]
]
[
.B -h
]
.SH DESCRIPTION
.BI eeprom
displays and/or modifies SPARC OpenPROM options.
.PP
.BI eeprom
is similar to Solaris
.BI eeprom
program.
.SH OPTIONS
Normally, unless
.B -d
option is given,
.BI eeprom
takes a list of option names and/or pairs
.I option
=
.I value
If
.B -
is given on the command line, these names and option/value
pairs are read from standard input, one per line.
For each option name without
.I =
character,
.BI eeprom
prints current setting of that option.
With
.I =
character,
.BI eeprom
sets the value of the specified option to the desired value
(or if there is nothing after the
.I =
character, sets it to empty string).
.BI eeprom
without arguments prints values of all the OpenPROM options.
.TP
.I -f device, -\-promdev device
Use
.I device
instead of default
.B /dev/openprom
to read PROM device tree.
.TP
.I -d device, -\-device device
Instead of dispaying and/or modifying PROM options, print
the PROM path for a SCSI or IDE device given by its block
.I device
and exit.
Example:
.B eeprom -d /dev/hda1
will print PROM path you could use to boot hda1 bootblock.
This is Linux extension.
.TP
.I -h, -\-help
Show usage.
.SH PROM OPTIONS
Following is a list of the usual OpenPROM options. Not all options may be
available on your system.
.TP
.I auto-boot?
boolean,
.B true
if system should automatically boot and not stay on PROM command line.
Default is
.B true.
.TP
.I ansi-terminal?
boolean
.B true
if PROM console should interpret ANSI sequences as control characters,
.B false
if it should pass them on unmodified.
Default is
.B true.
.TP
.I boot-command
PROM command to be issued when
.B auto-boot?
is
.B true.
Usually
.B boot.
.TP
.I boot-device
space separated lists of PROM device names or aliases of the devices
PROM should try to boot from, in order given.
Default is
.B disk net.
.TP
.I boot-file
image to boot from the device. If unset, boot loader will choose its
default. Default is empty.
.TP
.I boot-from
old PROM version of the above two variables. It should contain the
optional old style PROM name and optional file to boot. Default is
.B vmunix.
.TP
.I boot-from-diag
like the above, but for diagnostic boots.
.TP
.I com\fBX\fP-noprobe
disable device probe on serial port
.B X.
.TP
.I diag-device
like
.B boot-device
but for diagnostic boots. Defaults to
.B net.
.TP
.I diag-file
like
.B boot-file
but for diagnostic boots. Default is empty.
.TP
.I diag-level
Diagnostic level such as
.B off, min, max, menus.
.TP
.I diag-switch?
boolean,
.B true
if PROM should run in diagnostic mode. Default is
.B true.
.TP
.I input-device
device which should be used for PROM input. It can be
one of
.B keyboard, ttya, ttyb.
If keyboard is not probed in the system, it will default
to
.B ttya.
Note that Linux does not support yet mixed input/output device,
so you either have to use serial console for both input and output, or
keyboard and framebuffer.
Default is
.B keyboard.
.TP
.I keyboard-click?
boolean,
.B true
if keyboard click should be enabled.
Defaults to
.B false.
.TP
.I keymap
custom keyboard map.
.TP
.I local-mac-address?
boolean,
.B true
if MAC addresses are local to network adapters, otherwise they use system
default from NVRAM.
Default is
.B false.
.TP
.I nvramrc
forth script to be invoked on bootup if
.B use-nvramrc?
is
.B true.
Default is empty.
.TP
.I oem-banner
string to be used instead of the standard PROM banner if
.B oem-banner?
is
.B true.
Default is empty.
.TP
.I oem-banner?
boolean if OEM banner should be used. Default is
.B false.
.TP
.I oem-logo
black and white logo to be displayed instead of the standard one.
Shown in hexadecimal, currently impossible to set with
.BI eeprom.
.TP
.I oem-logo?
boolean if OEM logo should be used. Default is
.B false.
.TP
.I output-device
device which should be used for PROM output. It can be one of
.B screen, ttya, ttyb.
Note that Linux does not support yet mixed input/output device,
so you either have to use serial console for both input and output, or
keyboard and framebuffer.
Default is
.B screen.
.TP
.I sbus-probe-list
string with digit for each sbus device which should be probed, the order
of the digits is the order in which they are probed. Default is
.B 0123.
.TP
.I screen-#columns
number of screen columns. Default is
.B 80.
.TP
.I screen-#rows
number of lines on the screen. Default is
.B 34.
.TP
.I scsi-initiator-id
is SCSI initiator target id. Values 0-7. Default is
.B 7.
.TP
.I sd-targets
string for old PROM mapping between PROM notion of units and SCSI disk ids.
Defaults to
.B 31204567
which means SCSI target 3 will be unit 0, target 0 will be unit 3 and the
rest will be identity mapped.
.TP
.I security-#badlogins
number of unsuccessful attempts to enter PROM password.
.TP
.I security-mode
Either 
.B none, command
or
.B full.
.B None
means password is never required,
.B command
means password will be required only if the user wants to enter some PROM
command, with
.B full
password is required always, even to boot the machine.
If changing
.B security-mode
from
.B none
to some other mode, the user will be asked for the password (similar to
running
.B eeprom security-password=
), but the security mode will be changed only if setting the password up
succeeds.
.TP
.I security-password
Password for the chosen security mode, will be never displayed, on setting
it up the value is not used and the password is always read from the user.
.TP
.I selftest-#megs
Number of megabytes of memory to test on bootup, ignored for diagnostic
boots (where all memory is tested). Defaults to
.B 1.
.TP
.I skip-vme-loopback?
skips VME loopback tests. Defaults to
.B false.
.TP
.I st-targets
string for old PROM mapping between PROM notion of units and SCSI tape ids.
Defaults to
.B 45670123.
.TP
.I sunmon-compat?
for compatibility, display restricted monitor prompt on newer PROMs.
Defaults to
.B false.
.TP
.I tpe-link-test?
boolean if 10BaseT link test should be done. Defaults to
.B true.
.TP
.I ttya-mode
mode for ttya serial line. Comma separated list of baud rate (1200, 4800,
9600, ...), data bits (5-8), parity (\fBn\fPone, \fBe\fPven, \fBo\fPdd,
\fBm\fPark, \fBs\fPpace), stopbits (1, 1.5, 2) and handshaking (\fB-\fP for
none, \fBh\fPardware RTS/CTS, \fBs\fPoftware XON/XOFF).
Defaults to
.B 9600,8,n,1,-.
.TP
.I ttyb-mode
like
.B ttya-mode
but for ttyb serial line.
.TP
.I ttya-ignore-cd
boolean if carrier detect should be ignored on ttya serial line. Defaults to
.B true.
.TP
.I ttyb-ignore-cd
likewise.
.TP
.I ttya-rts-dtr-off
boolean if DTR/RTS should not be asserted. Defaults to
.B false.
.TP
.I ttyb-rts-dtr-off
likewise.
.TP
.I use-nvramrc?
boolean,
.B true
if
.B nvramrc
script should be executed on bootup.
.TP
.I watchdog-reboot?
boolean if watchdog reset should reboot the machine.
Defaults to
.B false.
.SH BUGS
Changing of
.B oem-logo
is not supported yet.
.SH AUTHOR
.B eeprom
has been written by Jakub Jelinek <jakub@redhat.com>.
.SH AVAILABILITY
.B eeprom
is available for anonymous download at
http://vger.samba.org/cgi-bin/cvsweb/prtconf/?cvsroot=vger.
.SH SEE ALSO
.B /proc/openprom/, /dev/openprom, prtconf(8)