EFSETUP(8) BSD System Manager's Manual EFSETUP(8)NAMEefsetup - manipulate eeprom settings on 3COM 3C59x ethernet cards
SYNOPSISefsetup [-vsS] [-m type] [-p ratio] interface-name
DESCRIPTION
The efsetup program displays information regarding adapter configuration
and allows options to be changed and stored in adapter EEPROM. This pro-
gram will display the contents of the EEPROM from any adapter recognized
by the ef(4) driver, however only newer adapters (3c59x) may be pro-
grammed. Display of older adapter options may not correctly decode some
options, allowing such displays is intended primary for debugging purpos-
es.
-v This displays the adapter configuration state before any
changes are applied.
-s Enable 100baseTX start of stream delimiter corruption check-
ing.
-S Disable 100baseTX start of stream delimiter corruption check-
ing.
-m type Set default media type. This media type is used by the hard-
ware when the card is first powered on and is used by the
ef(4) driver to set default link flags at boot time. Avail-
able media types are:
tp 10baseT
aui 10base5 (DB15 AUI connector)
bnc 10base2 (Thinnet)
tx 100baseTX
fx 100baseFX
mii Media independent interface (daughter card)
t4 100-VgAnyLan via MII daughter card
It is only possible to select a media type supported by the
card.
It is very important to set the media type correctly on cards
that support 100Mbps operation, a card set for 100Mbit will
jam a 10Mbit network (as soon as the workstation is powered
up), the same is true of a card configured for 10Mbit on a
100Mbit network. To be safe: always configure a new style
(3c59x) card before attaching the network cable.
-p ratio Set ram buffer partitioning. This determines how much of the
adapter ram is allocated to the receive FIFO vs. the transmit
FIFO. Possible settings are 5:3, 3:1, and 1:1. Not all combi-
nations of adapter ram size, width, and partition ratios are
supported, an error will be generated if an attempt is made
to select an unsupported ratio.
The 'media autoselect' option does not work correctly (in hardware) and
may cause a connected network to be jammed when the machine is powered
up; if this option is set via the 3COM DOS based diagnostic, efsetup will
turn it off automatically when run (a warning will be issued).
The EEPROM is only programmed if some option has changed, this is to pre-
vent unneeded programming cycles (which can wear the part out).
Changing options only affects the EEPROM, not the current settings being
used by the driver. Ifconfig(8) can be used to change media while run-
ning via manipulation of link flags (see ef(4) ), changes to other op-
tions require a reboot to take effect.
EXAMPLES
# efsetup-v ef2
Product ID : 3C597-TX (0x7059)
Media supported : 10BaseT, 100BaseTX
Media select on reset : 10BaseT
Ram size : 64 Kb
Ram width : word
Ram wait states : 1
Rom size : 8 Kb
BadSSD detect : on
Buffer ratio : 3:1
Read FIFO size : 48 Kb
Write FIFO size : 16 Kb
Media autoselect : off
EEPROM dump:
00: 0020 afee f58a 7059 bf6d 0036 5841 6d50
08: 0000 3000 0020 afee f58a 3f10 0000 0000
10: 11c6 0000 001b 0001 0000 0000 0000 007b
18: 0000 0000 0000 0000 0000 0000 0000 0000
20: 0000 0000 0000 0000 0000 0000 0000 0000
28: 0000 0000 0000 0000 0000 0000 0000 0000
30: 0000 0000 0000 0000 0000 0000 0000 0000
38: 0000 0000 0000 0000 0000 0000 0000 0000
# efsetup-m tx ef2
EEPROM programmed.
# efsetup-m tx ef2
No changes made to ef2
SEE ALSOef(4), ifconfig(8), rc(8)HISTORY
The efsetup command first appeared in BSD/OS 3.0.
BSDI BSD/OS March 21, 1996 2