EEPROM(8)               OpenBSD System Manager's Manual              EEPROM(8)

NAME
     eeprom - display or modify contents of the EEPROM or OpenProm

SUN 3 SYNOPSIS
     eeprom [-] [-c] [-f device] [-i] [field[=value] ...]

SPARC SYNOPSIS
     eeprom [-] [-c] [-f device] [-i] [-v] [-N system] [field[=value] ...]

DESCRIPTION
     eeprom provides an interface for displaying and changing the contents of
     the EEPROM or OpenProm.  Without any arguments, eeprom will list all of
     the known fields and their corresponding values.  When given the name of
     a specific field, eeprom will display that value or set it if the field
     name is followed by ``='' and a value.  Only the superuser may modify the
     contents of the EEPROM or OpenProm.

     The options are as follows:

     -       Commands are taken from stdin and displayed on stdout.

     -c      eeprom will fix incorrect checksum values and exit.  This flag is
             quietly ignored on systems with an OpenProm.

     -f device
             On systems with an EEPROM, use device instead of the default
             /dev/eeprom. On systems with an OpenProm, use device instead of
             the default /dev/openprom.

     -i      If checksum values are incorrect, eeprom will ignore them and
             continue after displaying a warning.  This flag is quietly ig-
             nored on systems with an OpenProm.

     The following options are valid only on the SPARC and will produce an er-
     ror when used on a Sun 3:

     -v      On systems with an OpenProm, be verbose when setting a value.
             Systems with an EEPROM are always verbose.

     -N system
             Use the system image system instead of the default /bsd.

FIELDS AND VALUES
     The following fields and values are for systems with an EEPROM:

     hwupdate           A valid date, such as ``7/12/95''. The strings
                        ``today'' and ``now'' are also acceptable.

     memsize            How much memory, in megabytes, is installed in the
                        system.

     memtest            How much memory, in megabytes, is to be tested upon
                        power-up.

     scrsize            The size of the screen.  Acceptable values are
                        ``1024x1024'', ``1152x900'', ``1600x1280'', and
                        ``1440x1440''.

     watchdog_reboot    If true, the system will reboot upon reset.  Other-
                        wise, the system will fall into the monitor.

     default_boot       If true, the system will use the boot device stored in

                        bootdev.

     bootdev            Specifies the default boot device in the form
                        cc(x,x,x), where ``cc'' is a combination of two let-
                        ters such as ``sd'' or ``le'' and each ``x'' is a hex-
                        adecimal number between 0 and ff, less the prepending
                        ``0x''.

     kbdtype            This value is ``0'' for all Sun keyboards.

     console            Specifies the console type.  Valid values are ``b&w'',
                        ``ttya'', ``ttyb'', ``color'', and ``p4opt''.

     keyclick           If true, the keys click annoyingly.

     diagdev            This is a string very similar to that used by bootdev.
                        It specifies the default boot device when the diagnos-
                        tic switch is turned on.

     diagpath           A 40-character, NULL-terminated string specifying the
                        kernel or standalone program to load when the diagnos-
                        tic switch is turned on.

     columns            An 8-bit integer specifying the number of columns on
                        the console.

     rows               An 8-bit integer specifying the number of rows on the
                        console.

     ttya_use_baud      Use the baud rate stored in ttya_baud instead of the
                        default 9600.

     ttya_baud          A 16-bit integer specifying the baud rate to use on
                        ttya.

     ttya_no_rtsdtr     If true, disables RTS/DTR.

     ttyb_use_baud      Similar to ttya_use_baud, but for ttyb.

     ttyb_baud          Similar to ttya_baud, but for ttyb.

     ttyb_no_rtsdtr     Similar to ttya_no_rtsdtr, but for ttyb.

     banner             An 80-character, NULL-terminated string to use at pow-
                        er-up instead of the default Sun banner.

     Note that the secure, bad_login, and password fields are not currently
     supported.

     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.

     sunmon-compat?          If true, the old EEPROM-style interface will be
                             used while in the monitor, rather than the Open-
                             Prom-style interface.

     selftest-#megs          A 32-bit integer specifying the number of
                             megabytes of memory to test upon power-up.

     oem-logo                A 64bitx64bit bitmap in Sun Iconedit format.  To
                             set the bitmpa, give the pathname of the file
                             containing the image.  NOTE: this property is not

                             yet supported.

     oem-logo?               If true, enables the use of the bitmap stored in
                             oem-logo rather than the default Sun logo.

     oem-banner              A string to use at power-up, rather than the de-
                             fault Sun banner.

     oem-banner?             If true, enables the use of the banner stored in
                             oem-banner rather than the default Sun banner.

     ttya-mode               A string of five comma separated fields in the
                             format ``9600,8,n,1,-''. The first field is the
                             baud rate.  The second field is the number of da-
                             ta bits.  The third field is the parity; accept-
                             able values for parity are ``n'' (none), ``e''
                             (even), ``o'' (odd), ``m'' (mark), and ``s''
                             (space).  The fourth field is the number of stop
                             bits.  The fifth field is the ``handshake''
                             field; acceptable values are ``-'' (none), ``h''
                             (RTS/CTS), and ``s'' (XON/XOFF).

     ttya-rts-dtr-off        If true, the system will ignore RTS/DTR.

     ttya-ignore-cd          If true, the system will ignore carrier detect.

     ttyb-mode               Similar to ttya-mode, but for ttyb.

     ttyb-rts-dtr-off        Similar to ttya-rts-dtr-off, but for ttyb.

     ttyb-ignore-cd          Similar to ttya-ignore-cd, but for ttyb.

     sbus-probe-list         Four digits in the format ``0123'' specifying
                             which order to probe the sbus at power-up.  It is
                             unlikely that this value should ever be changed.

     screen-#columns         An 8-bit integer specifying the number of columns
                             on the console.

     screen-#rows            An 8-bit integer specifying the number of rows on
                             the console.

     auto-boot?              If true, the system will boot automatically at
                             power-up.

     watchdog-reboot?        If true, the system will reboot upon reset.  Oth-
                             erwise, system will fall into the monitor.

     input-device            One of the strings ``keyboard'', ``ttya'', or
                             ``ttyb'' specifying the default console input de-
                             vice.

     output-device           One of the strings ``screen'', ``ttya'', or
                             ``ttyb'' specifying the default console output
                             device.

     keyboard-click?         If true, the keys click annoyingly.

     sd-targets              A string in the format ``31204567'' describing
                             the translation of physical to logical target.

     st-targets              Similar to sd-targets, but for tapes.  The de-
                             fault translation is ``45670123''.



     scsi-initiator-id       The SCSI ID of the on-board SCSI controller.

     hardware-revision       A 7-character string describing a date, such as
                             ``25May95''.

     last-hardware-update    Similar to hardware-revision, describing when the
                             CPU was last updated.

     diag-switch?            If true, the system will boot and run in diagnos-
                             tic mode.

     local-mac-address?      When set to false all Ethernet devices will use
                             same system default MAC address.  When true, Eth-
                             ernet devices which have a unique MAC address
                             will use it rather than the system default MAC
                             address.

WARNINGS
     The fields and their values are not necessarily well defined on systems
     with an OpenProm.  Your mileage may vary.

     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 re-
     lating to password protection of the EEPROM or OpenProm.

     Avoid gratuitously changing the contents of the EEPROM.  It has a limited
     number of write cycles.

     The date parser isn't very intelligent.

FILES
     /dev/eeprom      the EEPROM device on systems with an EEPROM

     /dev/openprom    the OpenProm device on systems with an OpenProm

OpenBSD 2.9                      May 25, 1995                                4
