221899b84e
(Also add a paragraph break.) I didn't specifically mention the platforms or what support is needed. At least someone reading the manpage will have some idea why the tool is missing from their system. (Some manual pages mention this in the BUGS section, but I didn't do that.)
356 lines
9.2 KiB
Groff
356 lines
9.2 KiB
Groff
.\" $NetBSD: eeprom.8,v 1.15 2008/09/25 22:44:51 reed Exp $
|
|
.\"
|
|
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" This code is derived from software contributed to The NetBSD Foundation
|
|
.\" by Jason R. Thorpe.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
|
|
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
|
|
.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
|
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
|
|
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
.\" POSSIBILITY OF SUCH DAMAGE.
|
|
.\"
|
|
.Dd February 27, 2007
|
|
.Dt EEPROM 8
|
|
.Os
|
|
.Sh NAME
|
|
.Nm eeprom
|
|
.Nd display or modify contents of the EEPROM or openprom
|
|
.Sh SUN 3 SYNOPSIS
|
|
.Nm
|
|
.Op Fl
|
|
.Op Fl c
|
|
.Op Fl f Ar device
|
|
.Op Fl i
|
|
.Oo
|
|
.Ar field Ns Oo
|
|
.Li = Ns Ar value
|
|
.Oc ...
|
|
.Oc
|
|
.Sh SPARC, SPARC64, MACPPC and PREP SYNOPSIS
|
|
.Nm
|
|
.Op Fl
|
|
.Op Fl c
|
|
.Op Fl f Ar device
|
|
.Op Fl i
|
|
.Op Fl v
|
|
.Oo
|
|
.Ar field Ns Oo
|
|
.Li = Ns Ar value
|
|
.Oc ...
|
|
.Oc
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
provides an interface for displaying and changing the contents of the
|
|
EEPROM or openprom.
|
|
The
|
|
.Nm
|
|
tool is only installed on supported platforms.
|
|
.Pp
|
|
Without any arguments,
|
|
.Nm
|
|
will list all of the known fields and their corresponding values.
|
|
When given the name of a specific field,
|
|
.Nm
|
|
will display that value or set it if the field name is followed by
|
|
.Sq =
|
|
and a value.
|
|
Only the super-user may modify the contents of the EEPROM or openprom.
|
|
.Pp
|
|
The options are as follows:
|
|
.Bl -tag -width indent
|
|
.It Fl
|
|
Commands are taken from stdin and displayed on stdout.
|
|
.It Fl c
|
|
.Nm
|
|
will fix incorrect checksum values and exit.
|
|
This flag is quietly ignored on systems with an openprom.
|
|
.It Fl f Ar device
|
|
On systems with an EEPROM, use
|
|
.Ar device
|
|
instead of the default
|
|
.Pa /dev/eeprom .
|
|
On systems with an openprom, use
|
|
.Ar device
|
|
instead of the default
|
|
.Pa /dev/openprom .
|
|
.It Fl i
|
|
If checksum values are incorrect,
|
|
.Nm
|
|
will ignore them and continue after displaying a warning.
|
|
This flag is quietly ignored on systems with an openprom.
|
|
.El
|
|
.Pp
|
|
The following options are valid only on the SPARC and will produce an
|
|
error when used on a Sun 3:
|
|
.Bl -tag -width indent
|
|
.It Fl v
|
|
On systems with an openprom, be verbose when setting a value.
|
|
Systems with an EEPROM are always verbose.
|
|
.El
|
|
.Pp
|
|
The
|
|
.Fl v
|
|
option is also present on sparc64, macppc, and prep systems.
|
|
.Sh FIELDS AND VALUES
|
|
The following fields and values are for systems with an EEPROM:
|
|
.Bl -tag -width "watchdog_reboot "
|
|
.It hwupdate
|
|
A valid date, such as
|
|
.Dq 7/12/95 .
|
|
The strings
|
|
.Dq today
|
|
and
|
|
.Dq now
|
|
are also acceptable.
|
|
.It memsize
|
|
How much memory, in megabytes, is installed in the system.
|
|
.It memtest
|
|
How much memory, in megabytes, is to be tested upon power-up.
|
|
.It scrsize
|
|
The size of the screen.
|
|
Acceptable values are
|
|
.Dq 1024x1024 ,
|
|
.Dq 1152x900 ,
|
|
.Dq 1600x1280 ,
|
|
and
|
|
.Dq 1440x1440 .
|
|
.It watchdog_reboot
|
|
If true, the system will reboot upon reset.
|
|
Otherwise, the system will fall into the monitor.
|
|
.It default_boot
|
|
If true, the system will use the boot device stored in
|
|
.Pa bootdev .
|
|
.It bootdev
|
|
Specifies the default boot device in the form cc(x,x,x), where
|
|
.Sq cc
|
|
is a combination of two letters such as
|
|
.Sq sd
|
|
or
|
|
.Sq le
|
|
and each
|
|
.Sq x
|
|
is a hexadecimal number between 0 and ff, less the prepending
|
|
.Sq 0x .
|
|
.It kbdtype
|
|
This value is
|
|
.Dq 0
|
|
for all Sun keyboards.
|
|
.It console
|
|
Specifies the console type.
|
|
Valid values are
|
|
.Dq b\*[Am]w ,
|
|
.Dq ttya ,
|
|
.Dq ttyb ,
|
|
.Dq color ,
|
|
and
|
|
.Dq p4opt .
|
|
.It keyclick
|
|
If true, the keys click annoyingly.
|
|
.It diagdev
|
|
This is a string very similar to that used by
|
|
.Pa bootdev .
|
|
It specifies the default boot device when the diagnostic switch is
|
|
turned on.
|
|
.It diagpath
|
|
A 40-character, NULL-terminated string specifying the kernel or standalone
|
|
program to load when the diagnostic switch is turned on.
|
|
.It columns
|
|
An 8-bit integer specifying the number of columns on the console.
|
|
.It rows
|
|
An 8-bit integer specifying the number of rows on the console.
|
|
.It ttya_use_baud
|
|
Use the baud rate stored in
|
|
.Pa ttya_baud
|
|
instead of the default 9600.
|
|
.It ttya_baud
|
|
A 16-bit integer specifying the baud rate to use on ttya.
|
|
.It ttya_no_rtsdtr
|
|
If true, disables RTS/DTR.
|
|
.It ttyb_use_baud
|
|
Similar to
|
|
.Pa ttya_use_baud ,
|
|
but for ttyb.
|
|
.It ttyb_baud
|
|
Similar to
|
|
.Pa ttya_baud ,
|
|
but for ttyb.
|
|
.It ttyb_no_rtsdtr
|
|
Similar to
|
|
.Pa ttya_no_rtsdtr ,
|
|
but for ttyb.
|
|
.It banner
|
|
An 80-character, NULL-terminated string to use at power-up instead
|
|
of the default Sun banner.
|
|
.El
|
|
.Pp
|
|
Note that the
|
|
.Pa secure ,
|
|
.Pa bad_login ,
|
|
and
|
|
.Pa password
|
|
fields are not currently supported.
|
|
.Pp
|
|
Since the openprom is designed such that the field names are arbitrary,
|
|
explaining them here is dubious.
|
|
Below are field names and values that
|
|
one is likely to see on a system with an openprom.
|
|
NOTE: this list may be incomplete or incorrect due to differences
|
|
between revisions of the openprom.
|
|
.Bl -tag -width "last-hardware-update "
|
|
.It sunmon-compat?
|
|
If true, the old EEPROM-style interface will be used while in the monitor,
|
|
rather than the openprom-style interface.
|
|
.It selftest-#megs
|
|
A 32-bit integer specifying the number of megabytes of memory to
|
|
test upon power-up.
|
|
.It oem-logo
|
|
A 64bitx64bit bitmap in Sun Iconedit format.
|
|
To set the bitmap, give the pathname of the file containing the
|
|
image.
|
|
NOTE: this property is not yet supported.
|
|
.It oem-logo?
|
|
If true, enables the use of the bitmap stored in
|
|
.Pa oem-logo
|
|
rather than the default Sun logo.
|
|
.It oem-banner
|
|
A string to use at power up, rather than the default Sun banner.
|
|
.It oem-banner?
|
|
If true, enables the use of the banner stored in
|
|
.Pa oem-banner
|
|
rather than the default Sun banner.
|
|
.It ttya-mode
|
|
A string of five comma separated fields in the format
|
|
.Dq 9600,8,n,1,- .
|
|
The first field is the baud rate.
|
|
The second field is the number of data bits.
|
|
The third field is the parity; acceptable values for parity are
|
|
.Sq n
|
|
(none),
|
|
.Sq e
|
|
(even),
|
|
.Sq o
|
|
(odd),
|
|
.Sq m
|
|
(mark), and
|
|
.Sq s
|
|
(space).
|
|
The fourth field is the number of stop bits.
|
|
The fifth field is the
|
|
.Sq handshake
|
|
field; acceptable values are
|
|
.Sq -
|
|
(none),
|
|
.Sq h
|
|
(RTS/CTS), and
|
|
.Sq s
|
|
(Xon/Xoff).
|
|
.It ttya-rts-dtr-off
|
|
If true, the system will ignore RTS/DTR.
|
|
.It ttya-ignore-cd
|
|
If true, the system will ignore carrier detect.
|
|
.It ttyb-mode
|
|
Similar to
|
|
.Pa ttya-mode ,
|
|
but for ttyb.
|
|
.It ttyb-rts-dtr-off
|
|
Similar to
|
|
.Pa ttya-rts-dtr-off ,
|
|
but for ttyb.
|
|
.It ttyb-ignore-cd
|
|
Similar to
|
|
.Pa ttya-ignore-cd ,
|
|
but for ttyb.
|
|
.It sbus-probe-list
|
|
Four digits in the format
|
|
.Dq 0123
|
|
specifying which order to probe the sbus at power-up.
|
|
It is unlikely that this value should ever be changed.
|
|
.It screen-#columns
|
|
An 8-bit integer specifying the number of columns on the console.
|
|
.It screen-#rows
|
|
An 8-bit integer specifying the number of rows on the console.
|
|
.It auto-boot?
|
|
If true, the system will boot automatically at power-up.
|
|
.It watchdog-reboot?
|
|
If true, the system will reboot upon reset.
|
|
Otherwise, system will fall into the monitor.
|
|
.It input-device
|
|
One of the strings
|
|
.Dq keyboard ,
|
|
.Dq ttya ,
|
|
or
|
|
.Dq ttyb
|
|
specifying the default console input device.
|
|
.It output-device
|
|
One of the strings
|
|
.Dq screen ,
|
|
.Dq ttya ,
|
|
or
|
|
.Dq ttyb
|
|
specifying the default console output device.
|
|
.It keyboard-click?
|
|
If true, the keys click annoyingly.
|
|
.It sd-targets
|
|
A string in the format
|
|
.Dq 31204567
|
|
describing the translation of physical to logical target.
|
|
.It st-targets
|
|
Similar to
|
|
.Pa sd-targets ,
|
|
but for tapes.
|
|
The default translation is
|
|
.Dq 45670123 .
|
|
.It scsi-initiator-id
|
|
The SCSI ID of the on-board SCSI controller.
|
|
.It hardware-revision
|
|
A 7-character string describing a date, such as
|
|
.Dq 25May95 .
|
|
.It last-hardware-update
|
|
Similar to
|
|
.Pa hardware-revision ,
|
|
describing when the CPU was last updated.
|
|
.It diag-switch?
|
|
If true, the system will boot and run in diagnostic mode.
|
|
.El
|
|
.Sh FILES
|
|
.Bl -tag -width "/dev/openprom "
|
|
.It /dev/eeprom
|
|
The EEPROM device on systems with an EEPROM.
|
|
.It /dev/openprom
|
|
The openprom device on systems with an openprom.
|
|
.It /dev/nvram
|
|
The nvram device on PReP systems.
|
|
.El
|
|
.Sh BUGS
|
|
The fields and their values are not necessarily well defined on
|
|
systems with an openprom.
|
|
Your mileage may vary.
|
|
.Pp
|
|
There are a few fields known to exist in some revisions of the EEPROM
|
|
and/or openprom that are not yet supported.
|
|
Most notable are those
|
|
relating to password protection of the EEPROM or openprom.
|
|
.Pp
|
|
Avoid gratuitously changing the contents of the EEPROM.
|
|
It has a limited number of write cycles.
|
|
.Pp
|
|
The date parser isn't very intelligent.
|