:sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftargetB/translations/zh_CN/networking/device_drivers/ethernet/3com/vortexmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetB/translations/zh_TW/networking/device_drivers/ethernet/3com/vortexmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetB/translations/it_IT/networking/device_drivers/ethernet/3com/vortexmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetB/translations/ja_JP/networking/device_drivers/ethernet/3com/vortexmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetB/translations/ko_KR/networking/device_drivers/ethernet/3com/vortexmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftargetB/translations/sp_SP/networking/device_drivers/ethernet/3com/vortexmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhh\/var/lib/git/docbuild/linux/Documentation/networking/device_drivers/ethernet/3com/vortex.rsthKubhsection)}(hhh](htitle)}(h3Com Vortex device driverh]h3Com Vortex device driver}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh paragraph)}(h Andrew Mortonh]h Andrew Morton}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(h 30 April 2000h]h 30 April 2000}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hcThis document describes the usage and errata of the 3Com "Vortex" device driver for Linux, 3c59x.c.h]hgThis document describes the usage and errata of the 3Com “Vortex” device driver for Linux, 3c59x.c.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(h:The driver was written by Donald Becker h](h)The driver was written by Donald Becker <}(hhhhhNhNubh reference)}(hbecker@scyld.comh]hbecker@scyld.com}(hhhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:becker@scyld.comuh1hhhubh>}(hhhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hnDon is no longer the prime maintainer of this version of the driver. Please report problems to one or more of:h]hnDon is no longer the prime maintainer of this version of the driver. Please report problems to one or more of:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh bullet_list)}(hhh](h list_item)}(h Andrew Mortonh]h)}(hj0h]h Andrew Morton}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj.ubah}(h]h ]h"]h$]h&]uh1j,hj)hhhhhNubj-)}(h,Netdev mailing list h]h)}(hjGh](hNetdev mailing list <}(hjIhhhNhNubh)}(hnetdev@vger.kernel.orgh]hnetdev@vger.kernel.org}(hjPhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:netdev@vger.kernel.orguh1hhjIubh>}(hjIhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjEubah}(h]h ]h"]h$]h&]uh1j,hj)hhhhhNubj-)}(h9Linux kernel mailing list h]h)}(h8Linux kernel mailing list h](hLinux kernel mailing list <}(hjthhhNhNubh)}(hlinux-kernel@vger.kernel.orgh]hlinux-kernel@vger.kernel.org}(hj|hhhNhNubah}(h]h ]h"]h$]h&]refuri#mailto:linux-kernel@vger.kernel.orguh1hhjtubh>}(hjthhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjpubah}(h]h ]h"]h$]h&]uh1j,hj)hhhhhNubeh}(h]h ]h"]h$]h&]bullet-uh1j'hhhKhhhhubh)}(hTPlease note the 'Reporting and Diagnosing Problems' section at the end of this file.h]hXPlease note the ‘Reporting and Diagnosing Problems’ section at the end of this file.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hSince kernel 2.3.99-pre6, this driver incorporates the support for the 3c575-series Cardbus cards which used to be handled by 3c575_cb.c.h]hSince kernel 2.3.99-pre6, this driver incorporates the support for the 3c575-series Cardbus cards which used to be handled by 3c575_cb.c.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(h,This driver supports the following hardware:h]h,This driver supports the following hardware:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh block_quote)}(hX- 3c590 Vortex 10Mbps - 3c592 EISA 10Mbps Demon/Vortex - 3c597 EISA Fast Demon/Vortex - 3c595 Vortex 100baseTx - 3c595 Vortex 100baseT4 - 3c595 Vortex 100base-MII - 3c900 Boomerang 10baseT - 3c900 Boomerang 10Mbps Combo - 3c900 Cyclone 10Mbps TPO - 3c900 Cyclone 10Mbps Combo - 3c900 Cyclone 10Mbps TPC - 3c900B-FL Cyclone 10base-FL - 3c905 Boomerang 100baseTx - 3c905 Boomerang 100baseT4 - 3c905B Cyclone 100baseTx - 3c905B Cyclone 10/100/BNC - 3c905B-FX Cyclone 100baseFx - 3c905C Tornado - 3c920B-EMB-WNM (ATI Radeon 9100 IGP) - 3c980 Cyclone - 3c980C Python-T - 3cSOHO100-TX Hurricane - 3c555 Laptop Hurricane - 3c556 Laptop Tornado - 3c556B Laptop Hurricane - 3c575 [Megahertz] 10/100 LAN CardBus - 3c575 Boomerang CardBus - 3CCFE575BT Cyclone CardBus - 3CCFE575CT Tornado CardBus - 3CCFE656 Cyclone CardBus - 3CCFEM656B Cyclone+Winmodem CardBus - 3CXFEM656C Tornado+Winmodem CardBus - 3c450 HomePNA Tornado - 3c920 Tornado - 3c982 Hydra Dual Port A - 3c982 Hydra Dual Port B - 3c905B-T4 - 3c920B-EMB-WNM Tornado h]j()}(hhh](j-)}(h3c590 Vortex 10Mbpsh]h)}(hjh]h3c590 Vortex 10Mbps}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK!hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c592 EISA 10Mbps Demon/Vortexh]h)}(hjh]h3c592 EISA 10Mbps Demon/Vortex}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK"hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c597 EISA Fast Demon/Vortexh]h)}(hjh]h3c597 EISA Fast Demon/Vortex}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK#hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c595 Vortex 100baseTxh]h)}(hjh]h3c595 Vortex 100baseTx}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK$hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c595 Vortex 100baseT4h]h)}(hj5h]h3c595 Vortex 100baseT4}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK%hj3ubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c595 Vortex 100base-MIIh]h)}(hjLh]h3c595 Vortex 100base-MII}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK&hjJubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c900 Boomerang 10baseTh]h)}(hjch]h3c900 Boomerang 10baseT}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK'hjaubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c900 Boomerang 10Mbps Comboh]h)}(hjzh]h3c900 Boomerang 10Mbps Combo}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK(hjxubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c900 Cyclone 10Mbps TPOh]h)}(hjh]h3c900 Cyclone 10Mbps TPO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK)hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c900 Cyclone 10Mbps Comboh]h)}(hjh]h3c900 Cyclone 10Mbps Combo}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK*hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c900 Cyclone 10Mbps TPCh]h)}(hjh]h3c900 Cyclone 10Mbps TPC}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK+hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c900B-FL Cyclone 10base-FLh]h)}(hjh]h3c900B-FL Cyclone 10base-FL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK,hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c905 Boomerang 100baseTxh]h)}(hjh]h3c905 Boomerang 100baseTx}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK-hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c905 Boomerang 100baseT4h]h)}(hjh]h3c905 Boomerang 100baseT4}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK.hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c905B Cyclone 100baseTxh]h)}(hjh]h3c905B Cyclone 100baseTx}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK/hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c905B Cyclone 10/100/BNCh]h)}(hj2h]h3c905B Cyclone 10/100/BNC}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK0hj0ubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c905B-FX Cyclone 100baseFxh]h)}(hjIh]h3c905B-FX Cyclone 100baseFx}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK1hjGubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c905C Tornadoh]h)}(hj`h]h3c905C Tornado}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK2hj^ubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h$3c920B-EMB-WNM (ATI Radeon 9100 IGP)h]h)}(hjwh]h$3c920B-EMB-WNM (ATI Radeon 9100 IGP)}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK3hjuubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h 3c980 Cycloneh]h)}(hjh]h 3c980 Cyclone}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK4hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c980C Python-Th]h)}(hjh]h3c980C Python-T}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK5hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3cSOHO100-TX Hurricaneh]h)}(hjh]h3cSOHO100-TX Hurricane}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK6hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c555 Laptop Hurricaneh]h)}(hjh]h3c555 Laptop Hurricane}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK7hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c556 Laptop Tornadoh]h)}(hjh]h3c556 Laptop Tornado}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK8hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c556B Laptop Hurricaneh]h)}(hjh]h3c556B Laptop Hurricane}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK9hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h%3c575 [Megahertz] 10/100 LAN CardBush]h)}(hjh]h%3c575 [Megahertz] 10/100 LAN CardBus}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK:hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c575 Boomerang CardBush]h)}(hj/h]h3c575 Boomerang CardBus}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK;hj-ubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3CCFE575BT Cyclone CardBush]h)}(hjFh]h3CCFE575BT Cyclone CardBus}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjrubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h#3CCFEM656B Cyclone+Winmodem CardBush]h)}(hjh]h#3CCFEM656B Cyclone+Winmodem CardBus}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK?hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h#3CXFEM656C Tornado+Winmodem CardBush]h)}(hjh]h#3CXFEM656C Tornado+Winmodem CardBus}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK@hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c450 HomePNA Tornadoh]h)}(hjh]h3c450 HomePNA Tornado}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h 3c920 Tornadoh]h)}(hjh]h 3c920 Tornado}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKBhjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c982 Hydra Dual Port Ah]h)}(hjh]h3c982 Hydra Dual Port A}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKChjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c982 Hydra Dual Port Bh]h)}(hjh]h3c982 Hydra Dual Port B}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKDhjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h 3c905B-T4h]h)}(hjh]h 3c905B-T4}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKEhjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h3c920B-EMB-WNM Tornado h]h)}(h3c920B-EMB-WNM Tornadoh]h3c920B-EMB-WNM Tornado}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKFhj*ubah}(h]h ]h"]h$]h&]uh1j,hjubeh}(h]h ]h"]h$]h&]jjuh1j'hhhK!hjubah}(h]h ]h"]h$]h&]uh1jhhhK!hhhhubh)}(hhh](h)}(hModule parametersh]hModule parameters}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjNhhhhhKIubh)}(hThere are several parameters which may be provided to the driver when its module is loaded. These are usually placed in ``/etc/modprobe.d/*.conf`` configuration files. Example::h](hyThere are several parameters which may be provided to the driver when its module is loaded. These are usually placed in }(hj_hhhNhNubhliteral)}(h``/etc/modprobe.d/*.conf``h]h/etc/modprobe.d/*.conf}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jghj_ubh configuration files. Example:}(hj_hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKKhjNhhubh literal_block)}(h&options 3c59x debug=3 rx_copybreak=300h]h&options 3c59x debug=3 rx_copybreak=300}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKOhjNhhubh)}(hgIf you are using the PCMCIA tools (cardmgr) then the options may be placed in /etc/pcmcia/config.opts::h]hfIf you are using the PCMCIA tools (cardmgr) then the options may be placed in /etc/pcmcia/config.opts:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKQhjNhhubj)}(h.module "3c59x" opts "debug=3 rx_copybreak=300"h]h.module "3c59x" opts "debug=3 rx_copybreak=300"}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKThjNhhubh)}(hThe supported parameters are:h]hThe supported parameters are:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKWhjNhhubh)}(hdebug=Nh]hdebug=N}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKYhjNhhubj)}(hvWhere N is a number from 0 to 7. Anything above 3 produces a lot of output in your system logs. debug=1 is default. h]h)}(huWhere N is a number from 0 to 7. Anything above 3 produces a lot of output in your system logs. debug=1 is default.h]huWhere N is a number from 0 to 7. Anything above 3 produces a lot of output in your system logs. debug=1 is default.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK[hjubah}(h]h ]h"]h$]h&]uh1jhhhK[hjNhhubh)}(hoptions=N1,N2,N3,...h]hoptions=N1,N2,N3,...}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK^hjNhhubj)}(hX%Each number in the list provides an option to the corresponding network card. So if you have two 3c905's and you wish to provide them with option 0x204 you would use:: options=0x204,0x204 The individual options are composed of a number of bitfields which have the following meanings: Possible media type settings == ================================= 0 10baseT 1 10Mbs AUI 2 undefined 3 10base2 (BNC) 4 100base-TX 5 100base-FX 6 MII (Media Independent Interface) 7 Use default setting from EEPROM 8 Autonegotiate 9 External MII 10 Use default setting from EEPROM == ================================= When generating a value for the 'options' setting, the above media selection values may be OR'ed (or added to) the following: ====== ============================================= 0x8000 Set driver debugging level to 7 0x4000 Set driver debugging level to 2 0x0400 Enable Wake-on-LAN 0x0200 Force full duplex mode. 0x0010 Bus-master enable bit (Old Vortex cards only) ====== ============================================= For example:: insmod 3c59x options=0x204 will force full-duplex 100base-TX, rather than allowing the usual autonegotiation. h](h)}(hEach number in the list provides an option to the corresponding network card. So if you have two 3c905's and you wish to provide them with option 0x204 you would use::h]hEach number in the list provides an option to the corresponding network card. So if you have two 3c905’s and you wish to provide them with option 0x204 you would use:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK`hjubj)}(hoptions=0x204,0x204h]hoptions=0x204,0x204}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKdhjubh)}(h_The individual options are composed of a number of bitfields which have the following meanings:h]h_The individual options are composed of a number of bitfields which have the following meanings:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKfhjubh)}(hPossible media type settingsh]hPossible media type settings}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKihjubj)}(hXi== ================================= 0 10baseT 1 10Mbs AUI 2 undefined 3 10base2 (BNC) 4 100base-TX 5 100base-FX 6 MII (Media Independent Interface) 7 Use default setting from EEPROM 8 Autonegotiate 9 External MII 10 Use default setting from EEPROM == ================================= h]htable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j9hj6ubj:)}(hhh]h}(h]h ]h"]h$]h&]colwidthK!uh1j9hj6ubhtbody)}(hhh](hrow)}(hhh](hentry)}(hhh]h)}(h0h]h0}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKlhj[ubah}(h]h ]h"]h$]h&]uh1jYhjVubjZ)}(hhh]h)}(h10baseTh]h10baseT}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKlhjrubah}(h]h ]h"]h$]h&]uh1jYhjVubeh}(h]h ]h"]h$]h&]uh1jThjQubjU)}(hhh](jZ)}(hhh]h)}(h1h]h1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKmhjubah}(h]h ]h"]h$]h&]uh1jYhjubjZ)}(hhh]h)}(h 10Mbs AUIh]h 10Mbs AUI}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKmhjubah}(h]h ]h"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]uh1jThjQubjU)}(hhh](jZ)}(hhh]h)}(h2h]h2}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKnhjubah}(h]h ]h"]h$]h&]uh1jYhjubjZ)}(hhh]h)}(h undefinedh]h undefined}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKnhjubah}(h]h ]h"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]uh1jThjQubjU)}(hhh](jZ)}(hhh]h)}(h3h]h3}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKohjubah}(h]h ]h"]h$]h&]uh1jYhjubjZ)}(hhh]h)}(h 10base2 (BNC)h]h 10base2 (BNC)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKohjubah}(h]h ]h"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]uh1jThjQubjU)}(hhh](jZ)}(hhh]h)}(h4h]h4}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKphj7ubah}(h]h ]h"]h$]h&]uh1jYhj4ubjZ)}(hhh]h)}(h 100base-TXh]h 100base-TX}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKphjNubah}(h]h ]h"]h$]h&]uh1jYhj4ubeh}(h]h ]h"]h$]h&]uh1jThjQubjU)}(hhh](jZ)}(hhh]h)}(h5h]h5}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKqhjnubah}(h]h ]h"]h$]h&]uh1jYhjkubjZ)}(hhh]h)}(h 100base-FXh]h 100base-FX}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKqhjubah}(h]h ]h"]h$]h&]uh1jYhjkubeh}(h]h ]h"]h$]h&]uh1jThjQubjU)}(hhh](jZ)}(hhh]h)}(h6h]h6}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKrhjubah}(h]h ]h"]h$]h&]uh1jYhjubjZ)}(hhh]h)}(h!MII (Media Independent Interface)h]h!MII (Media Independent Interface)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKrhjubah}(h]h ]h"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]uh1jThjQubjU)}(hhh](jZ)}(hhh]h)}(h7h]h7}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKshjubah}(h]h ]h"]h$]h&]uh1jYhjubjZ)}(hhh]h)}(hUse default setting from EEPROMh]hUse default setting from EEPROM}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKshjubah}(h]h ]h"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]uh1jThjQubjU)}(hhh](jZ)}(hhh]h)}(h8h]h8}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKthjubah}(h]h ]h"]h$]h&]uh1jYhjubjZ)}(hhh]h)}(h Autonegotiateh]h Autonegotiate}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKthj*ubah}(h]h ]h"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]uh1jThjQubjU)}(hhh](jZ)}(hhh]h)}(h9h]h9}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKuhjJubah}(h]h ]h"]h$]h&]uh1jYhjGubjZ)}(hhh]h)}(h External MIIh]h External MII}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKuhjaubah}(h]h ]h"]h$]h&]uh1jYhjGubeh}(h]h ]h"]h$]h&]uh1jThjQubjU)}(hhh](jZ)}(hhh]h)}(h10h]h10}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKvhjubah}(h]h ]h"]h$]h&]uh1jYhj~ubjZ)}(hhh]h)}(hUse default setting from EEPROMh]hUse default setting from EEPROM}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKvhjubah}(h]h ]h"]h$]h&]uh1jYhj~ubeh}(h]h ]h"]h$]h&]uh1jThjQubeh}(h]h ]h"]h$]h&]uh1jOhj6ubeh}(h]h ]h"]h$]h&]colsKuh1j4hj1ubah}(h]h ]h"]h$]h&]uh1j/hj+ubah}(h]h ]h"]h$]h&]uh1jhhhKkhjubh)}(h}When generating a value for the 'options' setting, the above media selection values may be OR'ed (or added to) the following:h]hWhen generating a value for the ‘options’ setting, the above media selection values may be OR’ed (or added to) the following:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKyhjubj0)}(hhh]j5)}(hhh](j:)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j9hjubj:)}(hhh]h}(h]h ]h"]h$]h&]colwidthK-uh1j9hjubjP)}(hhh](jU)}(hhh](jZ)}(hhh]h)}(h0x8000h]h0x8000}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK}hjubah}(h]h ]h"]h$]h&]uh1jYhjubjZ)}(hhh]h)}(hSet driver debugging level to 7h]hSet driver debugging level to 7}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK}hj ubah}(h]h ]h"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]uh1jThjubjU)}(hhh](jZ)}(hhh]h)}(h0x4000h]h0x4000}(hj6 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK~hj3 ubah}(h]h ]h"]h$]h&]uh1jYhj0 ubjZ)}(hhh]h)}(hSet driver debugging level to 2h]hSet driver debugging level to 2}(hjM hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK~hjJ ubah}(h]h ]h"]h$]h&]uh1jYhj0 ubeh}(h]h ]h"]h$]h&]uh1jThjubjU)}(hhh](jZ)}(hhh]h)}(h0x0400h]h0x0400}(hjm hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjj ubah}(h]h ]h"]h$]h&]uh1jYhjg ubjZ)}(hhh]h)}(hEnable Wake-on-LANh]hEnable Wake-on-LAN}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jYhjg ubeh}(h]h ]h"]h$]h&]uh1jThjubjU)}(hhh](jZ)}(hhh]h)}(h0x0200h]h0x0200}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jYhj ubjZ)}(hhh]h)}(hForce full duplex mode.h]hForce full duplex mode.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jYhj ubeh}(h]h ]h"]h$]h&]uh1jThjubjU)}(hhh](jZ)}(hhh]h)}(h0x0010h]h0x0010}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jYhj ubjZ)}(hhh]h)}(h-Bus-master enable bit (Old Vortex cards only)h]h-Bus-master enable bit (Old Vortex cards only)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jYhj ubeh}(h]h ]h"]h$]h&]uh1jThjubeh}(h]h ]h"]h$]h&]uh1jOhjubeh}(h]h ]h"]h$]h&]colsKuh1j4hjubah}(h]h ]h"]h$]h&]uh1j/hjubh)}(h For example::h]h For example:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubj)}(hinsmod 3c59x options=0x204h]hinsmod 3c59x options=0x204}hj- sbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjubh)}(hRwill force full-duplex 100base-TX, rather than allowing the usual autonegotiation.h]hRwill force full-duplex 100base-TX, rather than allowing the usual autonegotiation.}(hj; hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubeh}(h]h ]h"]h$]h&]uh1jhhhK`hjNhhubh)}(hglobal_options=Nh]hglobal_options=N}(hjO hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjNhhubj)}(hSets the ``options`` parameter for all 3c59x NICs in the machine. Entries in the ``options`` array above will override any setting of this. h]h)}(hSets the ``options`` parameter for all 3c59x NICs in the machine. Entries in the ``options`` array above will override any setting of this.h](h Sets the }(hja hhhNhNubjh)}(h ``options``h]hoptions}(hji hhhNhNubah}(h]h ]h"]h$]h&]uh1jghja ubh= parameter for all 3c59x NICs in the machine. Entries in the }(hja hhhNhNubjh)}(h ``options``h]hoptions}(hj{ hhhNhNubah}(h]h ]h"]h$]h&]uh1jghja ubh/ array above will override any setting of this.}(hja hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj] ubah}(h]h ]h"]h$]h&]uh1jhhhKhjNhhubh)}(hfull_duplex=N1,N2,N3...h]hfull_duplex=N1,N2,N3...}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjNhhubj)}(hSimilar to bit 9 of 'options'. Forces the corresponding card into full-duplex mode. Please use this in preference to the ``options`` parameter. In fact, please don't use this at all! You're better off getting autonegotiation working properly. h](h)}(hSimilar to bit 9 of 'options'. Forces the corresponding card into full-duplex mode. Please use this in preference to the ``options`` parameter.h](hSimilar to bit 9 of ‘options’. Forces the corresponding card into full-duplex mode. Please use this in preference to the }(hj hhhNhNubjh)}(h ``options``h]hoptions}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jghj ubh parameter.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj ubh)}(hbIn fact, please don't use this at all! You're better off getting autonegotiation working properly.h]hfIn fact, please don’t use this at all! You’re better off getting autonegotiation working properly.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubeh}(h]h ]h"]h$]h&]uh1jhhhKhjNhhubh)}(hglobal_full_duplex=N1h]hglobal_full_duplex=N1}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjNhhubj)}(hSets full duplex mode for all 3c59x NICs in the machine. Entries in the ``full_duplex`` array above will override any setting of this. h]h)}(hSets full duplex mode for all 3c59x NICs in the machine. Entries in the ``full_duplex`` array above will override any setting of this.h](hISets full duplex mode for all 3c59x NICs in the machine. Entries in the }(hj hhhNhNubjh)}(h``full_duplex``h]h full_duplex}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jghj ubh/ array above will override any setting of this.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhhhKhjNhhubh)}(hflow_ctrl=N1,N2,N3...h]hflow_ctrl=N1,N2,N3...}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjNhhubj)}(hXLUse 802.3x MAC-layer flow control. The 3com cards only support the PAUSE command, which means that they will stop sending packets for a short period if they receive a PAUSE frame from the link partner. The driver only allows flow control on a link which is operating in full duplex mode. This feature does not appear to work on the 3c905 - only 3c905B and 3c905C have been tested. The 3com cards appear to only respond to PAUSE frames which are sent to the reserved destination address of 01:80:c2:00:00:01. They do not honour PAUSE frames which are sent to the station MAC address. h](h)}(hUse 802.3x MAC-layer flow control. The 3com cards only support the PAUSE command, which means that they will stop sending packets for a short period if they receive a PAUSE frame from the link partner.h]hUse 802.3x MAC-layer flow control. The 3com cards only support the PAUSE command, which means that they will stop sending packets for a short period if they receive a PAUSE frame from the link partner.}(hj) hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj% ubh)}(hUThe driver only allows flow control on a link which is operating in full duplex mode.h]hUThe driver only allows flow control on a link which is operating in full duplex mode.}(hj7 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj% ubh)}(h\This feature does not appear to work on the 3c905 - only 3c905B and 3c905C have been tested.h]h\This feature does not appear to work on the 3c905 - only 3c905B and 3c905C have been tested.}(hjE hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj% ubh)}(hThe 3com cards appear to only respond to PAUSE frames which are sent to the reserved destination address of 01:80:c2:00:00:01. They do not honour PAUSE frames which are sent to the station MAC address.h]hThe 3com cards appear to only respond to PAUSE frames which are sent to the reserved destination address of 01:80:c2:00:00:01. They do not honour PAUSE frames which are sent to the station MAC address.}(hjS hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj% ubeh}(h]h ]h"]h$]h&]uh1jhhhKhjNhhubh)}(hrx_copybreak=Mh]hrx_copybreak=M}(hjg hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjNhhubj)}(hXThe driver preallocates 32 full-sized (1536 byte) network buffers for receiving. When a packet arrives, the driver has to decide whether to leave the packet in its full-sized buffer, or to allocate a smaller buffer and copy the packet across into it. This is a speed/space tradeoff. The value of rx_copybreak is used to decide when to make the copy. If the packet size is less than rx_copybreak, the packet is copied. The default value for rx_copybreak is 200 bytes. h](h)}(hThe driver preallocates 32 full-sized (1536 byte) network buffers for receiving. When a packet arrives, the driver has to decide whether to leave the packet in its full-sized buffer, or to allocate a smaller buffer and copy the packet across into it.h]hThe driver preallocates 32 full-sized (1536 byte) network buffers for receiving. When a packet arrives, the driver has to decide whether to leave the packet in its full-sized buffer, or to allocate a smaller buffer and copy the packet across into it.}(hjy hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhju ubh)}(hThis is a speed/space tradeoff.h]hThis is a speed/space tradeoff.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhju ubh)}(hThe value of rx_copybreak is used to decide when to make the copy. If the packet size is less than rx_copybreak, the packet is copied. The default value for rx_copybreak is 200 bytes.h]hThe value of rx_copybreak is used to decide when to make the copy. If the packet size is less than rx_copybreak, the packet is copied. The default value for rx_copybreak is 200 bytes.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhju ubeh}(h]h ]h"]h$]h&]uh1jhhhKhjNhhubh)}(hmax_interrupt_work=Nh]hmax_interrupt_work=N}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjNhhubj)}(hXThe driver's interrupt service routine can handle many receive and transmit packets in a single invocation. It does this in a loop. The value of max_interrupt_work governs how many times the interrupt service routine will loop. The default value is 32 loops. If this is exceeded the interrupt service routine gives up and generates a warning message "eth0: Too much work in interrupt". h]h)}(hXThe driver's interrupt service routine can handle many receive and transmit packets in a single invocation. It does this in a loop. The value of max_interrupt_work governs how many times the interrupt service routine will loop. The default value is 32 loops. If this is exceeded the interrupt service routine gives up and generates a warning message "eth0: Too much work in interrupt".h]hXThe driver’s interrupt service routine can handle many receive and transmit packets in a single invocation. It does this in a loop. The value of max_interrupt_work governs how many times the interrupt service routine will loop. The default value is 32 loops. If this is exceeded the interrupt service routine gives up and generates a warning message “eth0: Too much work in interrupt”.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhhhKhjNhhubh)}(hhw_checksums=N1,N2,N3,...h]hhw_checksums=N1,N2,N3,...}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjNhhubj)}(hXXRecent 3com NICs are able to generate IPv4, TCP and UDP checksums in hardware. Linux has used the Rx checksumming for a long time. The "zero copy" patch which is planned for the 2.4 kernel series allows you to make use of the NIC's DMA scatter/gather and transmit checksumming as well. The driver is set up so that, when the zerocopy patch is applied, all Tornado and Cyclone devices will use S/G and Tx checksums. This module parameter has been provided so you can override this decision. If you think that Tx checksums are causing a problem, you may disable the feature with ``hw_checksums=0``. If you think your NIC should be performing Tx checksumming and the driver isn't enabling it, you can force the use of hardware Tx checksumming with ``hw_checksums=1``. The driver drops a message in the logfiles to indicate whether or not it is using hardware scatter/gather and hardware Tx checksums. Scatter/gather and hardware checksums provide considerable performance improvement for the sendfile() system call, but a small decrease in throughput for send(). There is no effect upon receive efficiency. h](h)}(hXRecent 3com NICs are able to generate IPv4, TCP and UDP checksums in hardware. Linux has used the Rx checksumming for a long time. The "zero copy" patch which is planned for the 2.4 kernel series allows you to make use of the NIC's DMA scatter/gather and transmit checksumming as well.h]hX$Recent 3com NICs are able to generate IPv4, TCP and UDP checksums in hardware. Linux has used the Rx checksumming for a long time. The “zero copy” patch which is planned for the 2.4 kernel series allows you to make use of the NIC’s DMA scatter/gather and transmit checksumming as well.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubh)}(hThe driver is set up so that, when the zerocopy patch is applied, all Tornado and Cyclone devices will use S/G and Tx checksums.h]hThe driver is set up so that, when the zerocopy patch is applied, all Tornado and Cyclone devices will use S/G and Tx checksums.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubh)}(hThis module parameter has been provided so you can override this decision. If you think that Tx checksums are causing a problem, you may disable the feature with ``hw_checksums=0``.h](hThis module parameter has been provided so you can override this decision. If you think that Tx checksums are causing a problem, you may disable the feature with }(hj hhhNhNubjh)}(h``hw_checksums=0``h]hhw_checksums=0}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jghj ubh.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj ubh)}(hIf you think your NIC should be performing Tx checksumming and the driver isn't enabling it, you can force the use of hardware Tx checksumming with ``hw_checksums=1``.h](hIf you think your NIC should be performing Tx checksumming and the driver isn’t enabling it, you can force the use of hardware Tx checksumming with }(hj hhhNhNubjh)}(h``hw_checksums=1``h]hhw_checksums=1}(hj% hhhNhNubah}(h]h ]h"]h$]h&]uh1jghj ubh.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj ubh)}(hThe driver drops a message in the logfiles to indicate whether or not it is using hardware scatter/gather and hardware Tx checksums.h]hThe driver drops a message in the logfiles to indicate whether or not it is using hardware scatter/gather and hardware Tx checksums.}(hj= hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubh)}(hScatter/gather and hardware checksums provide considerable performance improvement for the sendfile() system call, but a small decrease in throughput for send(). There is no effect upon receive efficiency.h]hScatter/gather and hardware checksums provide considerable performance improvement for the sendfile() system call, but a small decrease in throughput for send(). There is no effect upon receive efficiency.}(hjK hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubeh}(h]h ]h"]h$]h&]uh1jhhhKhjNhhubh)}(h1compaq_ioaddr=N, compaq_irq=N, compaq_device_id=Nh]h1compaq_ioaddr=N, compaq_irq=N, compaq_device_id=N}(hj_ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjNhhubj)}(h="Variables to work-around the Compaq PCI BIOS32 problem".... h]h)}(h<"Variables to work-around the Compaq PCI BIOS32 problem"....h]h@“Variables to work-around the Compaq PCI BIOS32 problem”....}(hjq hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjm ubah}(h]h ]h"]h$]h&]uh1jhhhKhjNhhubh)}(h watchdog=Nh]h watchdog=N}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjNhhubj)}(hX:Sets the time duration (in milliseconds) after which the kernel decides that the transmitter has become stuck and needs to be reset. This is mainly for debugging purposes, although it may be advantageous to increase this value on LANs which have very high collision rates. The default value is 5000 (5.0 seconds). h]h)}(hX9Sets the time duration (in milliseconds) after which the kernel decides that the transmitter has become stuck and needs to be reset. This is mainly for debugging purposes, although it may be advantageous to increase this value on LANs which have very high collision rates. The default value is 5000 (5.0 seconds).h]hX9Sets the time duration (in milliseconds) after which the kernel decides that the transmitter has become stuck and needs to be reset. This is mainly for debugging purposes, although it may be advantageous to increase this value on LANs which have very high collision rates. The default value is 5000 (5.0 seconds).}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhhhKhjNhhubh)}(henable_wol=N1,N2,N3,...h]henable_wol=N1,N2,N3,...}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjNhhubj)}(hEnable Wake-on-LAN support for the relevant interface. Donald Becker's ``ether-wake`` application may be used to wake suspended machines. Also enables the NIC's power management support. h](h)}(hEnable Wake-on-LAN support for the relevant interface. Donald Becker's ``ether-wake`` application may be used to wake suspended machines.h](hJEnable Wake-on-LAN support for the relevant interface. Donald Becker’s }(hj hhhNhNubjh)}(h``ether-wake``h]h ether-wake}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jghj ubh4 application may be used to wake suspended machines.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj ubh)}(h0Also enables the NIC's power management support.h]h2Also enables the NIC’s power management support.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubeh}(h]h ]h"]h$]h&]uh1jhhhKhjNhhubh)}(hglobal_enable_wol=Nh]hglobal_enable_wol=N}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjNhhubj)}(hSets enable_wol mode for all 3c59x NICs in the machine. Entries in the ``enable_wol`` array above will override any setting of this. h]h)}(hSets enable_wol mode for all 3c59x NICs in the machine. Entries in the ``enable_wol`` array above will override any setting of this.h](hHSets enable_wol mode for all 3c59x NICs in the machine. Entries in the }(hj hhhNhNubjh)}(h``enable_wol``h]h enable_wol}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jghj ubh/ array above will override any setting of this.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhhhKhjNhhubh)}(hhh](h)}(hMedia selectionh]hMedia selection}(hj, hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj) hhhhhKubh)}(h^A number of the older NICs such as the 3c590 and 3c900 series have 10base2 and AUI interfaces.h]h^A number of the older NICs such as the 3c590 and 3c900 series have 10base2 and AUI interfaces.}(hj: hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj) hhubh)}(hX-Prior to January, 2001 this driver would autoselect the 10base2 or AUI port if it didn't detect activity on the 10baseT port. It would then get stuck on the 10base2 port and a driver reload was necessary to switch back to 10baseT. This behaviour could not be prevented with a module option override.h]hX/Prior to January, 2001 this driver would autoselect the 10base2 or AUI port if it didn’t detect activity on the 10baseT port. It would then get stuck on the 10base2 port and a driver reload was necessary to switch back to 10baseT. This behaviour could not be prevented with a module option override.}(hjH hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj) hhubh)}(huLater (current) versions of the driver _do_ support locking of the media type. So if you load the driver module withh]huLater (current) versions of the driver _do_ support locking of the media type. So if you load the driver module with}(hjV hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj) hhubj)}(hmodprobe 3c59x options=0 h]h)}(hmodprobe 3c59x options=0h]hmodprobe 3c59x options=0}(hjh hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hjd ubah}(h]h ]h"]h$]h&]uh1jhhhM hj) hhubh)}(hfit will permanently select the 10baseT port. Automatic selection of other media types does not occur.h]hfit will permanently select the 10baseT port. Automatic selection of other media types does not occur.}(hj| hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hj) hhubeh}(h]media-selectionah ]h"]media selectionah$]h&]uh1hhjNhhhhhKubh)}(hhh](h)}(h%Transmit error, Tx status register 82h]h%Transmit error, Tx status register 82}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhMubh)}(hXThis is a common error which is almost always caused by another host on the same network being in full-duplex mode, while this host is in half-duplex mode. You need to find that other host and make it run in half-duplex mode or fix this host to run in full-duplex mode.h]hXThis is a common error which is almost always caused by another host on the same network being in full-duplex mode, while this host is in half-duplex mode. You need to find that other host and make it run in half-duplex mode or fix this host to run in full-duplex mode.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubh)}(hKAs a last resort, you can force the 3c59x driver into full-duplex mode withh]hKAs a last resort, you can force the 3c59x driver into full-duplex mode with}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubj)}(hoptions 3c59x full_duplex=1 h]h)}(hoptions 3c59x full_duplex=1h]hoptions 3c59x full_duplex=1}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1jhhhMhj hhubh)}(hbut this has to be viewed as a workaround for broken network gear and should only really be used for equipment which cannot autonegotiate.h]hbut this has to be viewed as a workaround for broken network gear and should only really be used for equipment which cannot autonegotiate.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubeh}(h]$transmit-error-tx-status-register-82ah ]h"]%transmit error, tx status register 82ah$]h&]uh1hhjNhhhhhMubh)}(hhh](h)}(hAdditional resourcesh]hAdditional resources}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhM"ubh)}(hNDetails of the device driver implementation are at the top of the source file.h]hNDetails of the device driver implementation are at the top of the source file.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM$hj hhubh)}(hIAdditional documentation is available at Don Becker's Linux Drivers site:h]hKAdditional documentation is available at Don Becker’s Linux Drivers site:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM&hj hhubj)}(h!http://www.scyld.com/vortex.html h]h)}(h http://www.scyld.com/vortex.htmlh]h)}(hj h]h http://www.scyld.com/vortex.html}(hj"hhhNhNubah}(h]h ]h"]h$]h&]refurij uh1hhjubah}(h]h ]h"]h$]h&]uh1hhhhM(hjubah}(h]h ]h"]h$]h&]uh1jhhhM(hj hhubh)}(h(Donald Becker's driver development site:h]h*Donald Becker’s driver development site:}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM*hj hhubj)}(h"http://www.scyld.com/network.html h]h)}(h!http://www.scyld.com/network.htmlh]h)}(hjPh]h!http://www.scyld.com/network.html}(hjRhhhNhNubah}(h]h ]h"]h$]h&]refurijPuh1hhjNubah}(h]h ]h"]h$]h&]uh1hhhhM,hjJubah}(h]h ]h"]h$]h&]uh1jhhhM,hj hhubh)}(hFDonald's vortex-diag program is useful for inspecting the NIC's state:h]hJDonald’s vortex-diag program is useful for inspecting the NIC’s state:}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM.hj hhubj)}(h)http://www.scyld.com/ethercard_diag.html h]h)}(h(http://www.scyld.com/ethercard_diag.htmlh]h)}(hjh]h(http://www.scyld.com/ethercard_diag.html}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurijuh1hhj~ubah}(h]h ]h"]h$]h&]uh1hhhhM0hjzubah}(h]h ]h"]h$]h&]uh1jhhhM0hj hhubh)}(hvDonald's mii-diag program may be used for inspecting and manipulating the NIC's Media Independent Interface subsystem:h]hzDonald’s mii-diag program may be used for inspecting and manipulating the NIC’s Media Independent Interface subsystem:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM2hj hhubj)}(h2http://www.scyld.com/ethercard_diag.html#mii-diag h]h)}(h1http://www.scyld.com/ethercard_diag.html#mii-diagh]h)}(hjh]h1http://www.scyld.com/ethercard_diag.html#mii-diag}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurijuh1hhjubah}(h]h ]h"]h$]h&]uh1hhhhM5hjubah}(h]h ]h"]h$]h&]uh1jhhhM5hj hhubh)}(hDonald's wake-on-LAN page:h]hDonald’s wake-on-LAN page:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM7hj hhubj)}(h$http://www.scyld.com/wakeonlan.html h]h)}(h#http://www.scyld.com/wakeonlan.htmlh]h)}(hjh]h#http://www.scyld.com/wakeonlan.html}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurijuh1hhjubah}(h]h ]h"]h$]h&]uh1hhhhM9hjubah}(h]h ]h"]h$]h&]uh1jhhhM9hj hhubh)}(h=3Com's DOS-based application for setting up the NICs EEPROMs:h]h?3Com’s DOS-based application for setting up the NICs EEPROMs:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM;hj hhubj)}(h.ftp://ftp.3com.com/pub/nic/3c90x/3c90xx2.exe h]h)}(h,ftp://ftp.3com.com/pub/nic/3c90x/3c90xx2.exeh]h)}(hjh]h,ftp://ftp.3com.com/pub/nic/3c90x/3c90xx2.exe}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurijuh1hhjubah}(h]h ]h"]h$]h&]uh1hhhhM=hj ubah}(h]h ]h"]h$]h&]uh1jhhhM=hj hhubeh}(h]additional-resourcesah ]h"]additional resourcesah$]h&]uh1hhjNhhhhhM"ubh)}(hhh](h)}(hAutonegotiation notesh]hAutonegotiation notes}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4hhhhhMAubj)}(hXThe driver uses a one-minute heartbeat for adapting to changes in the external LAN environment if link is up and 5 seconds if link is down. This means that when, for example, a machine is unplugged from a hubbed 10baseT LAN plugged into a switched 100baseT LAN, the throughput will be quite dreadful for up to sixty seconds. Be patient. Cisco interoperability note from Walter Wong : On a side note, adding HAS_NWAY seems to share a problem with the Cisco 6509 switch. Specifically, you need to change the spanning tree parameter for the port the machine is plugged into to 'portfast' mode. Otherwise, the negotiation fails. This has been an issue we've noticed for a while but haven't had the time to track down. Cisco switches (Jeff Busch ) My "standard config" for ports to which PC's/servers connect directly:: interface FastEthernet0/N description machinename load-interval 30 spanning-tree portfast If autonegotiation is a problem, you may need to specify "speed 100" and "duplex full" as well (or "speed 10" and "duplex half"). WARNING: DO NOT hook up hubs/switches/bridges to these specially-configured ports! The switch will become very confused. h](h)}(hXRThe driver uses a one-minute heartbeat for adapting to changes in the external LAN environment if link is up and 5 seconds if link is down. This means that when, for example, a machine is unplugged from a hubbed 10baseT LAN plugged into a switched 100baseT LAN, the throughput will be quite dreadful for up to sixty seconds. Be patient.h]hXRThe driver uses a one-minute heartbeat for adapting to changes in the external LAN environment if link is up and 5 seconds if link is down. This means that when, for example, a machine is unplugged from a hubbed 10baseT LAN plugged into a switched 100baseT LAN, the throughput will be quite dreadful for up to sixty seconds. Be patient.}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMChjEubh)}(h:h](h.Cisco interoperability note from Walter Wong <}(hjWhhhNhNubh)}(h wcw+@CMU.EDUh]h wcw+@CMU.EDU}(hj_hhhNhNubah}(h]h ]h"]h$]h&]refurimailto:wcw+@CMU.EDUuh1hhjWubh>:}(hjWhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMIhjEubh)}(hXLOn a side note, adding HAS_NWAY seems to share a problem with the Cisco 6509 switch. Specifically, you need to change the spanning tree parameter for the port the machine is plugged into to 'portfast' mode. Otherwise, the negotiation fails. This has been an issue we've noticed for a while but haven't had the time to track down.h]hXTOn a side note, adding HAS_NWAY seems to share a problem with the Cisco 6509 switch. Specifically, you need to change the spanning tree parameter for the port the machine is plugged into to ‘portfast’ mode. Otherwise, the negotiation fails. This has been an issue we’ve noticed for a while but haven’t had the time to track down.}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMKhjEubh)}(h0Cisco switches (Jeff Busch )h](hCisco switches (Jeff Busch <}(hjhhhNhNubh)}(hjbusch@deja.comh]hjbusch@deja.com}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:jbusch@deja.comuh1hhjubh>)}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMQhjEubj)}(hXMy "standard config" for ports to which PC's/servers connect directly:: interface FastEthernet0/N description machinename load-interval 30 spanning-tree portfast If autonegotiation is a problem, you may need to specify "speed 100" and "duplex full" as well (or "speed 10" and "duplex half"). WARNING: DO NOT hook up hubs/switches/bridges to these specially-configured ports! The switch will become very confused. h](h)}(hGMy "standard config" for ports to which PC's/servers connect directly::h]hLMy “standard config” for ports to which PC’s/servers connect directly:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMShjubj)}(hYinterface FastEthernet0/N description machinename load-interval 30 spanning-tree portfasth]hYinterface FastEthernet0/N description machinename load-interval 30 spanning-tree portfast}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhMUhjubh)}(hIf autonegotiation is a problem, you may need to specify "speed 100" and "duplex full" as well (or "speed 10" and "duplex half").h]hIf autonegotiation is a problem, you may need to specify “speed 100” and “duplex full” as well (or “speed 10” and “duplex half”).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMZhjubh)}(hxWARNING: DO NOT hook up hubs/switches/bridges to these specially-configured ports! The switch will become very confused.h]hxWARNING: DO NOT hook up hubs/switches/bridges to these specially-configured ports! The switch will become very confused.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM]hjubeh}(h]h ]h"]h$]h&]uh1jhhhMShjEubeh}(h]h ]h"]h$]h&]uh1jhhhMChj4hhubeh}(h]autonegotiation-notesah ]h"]autonegotiation notesah$]h&]uh1hhjNhhhhhMAubh)}(hhh](h)}(h!Reporting and diagnosing problemsh]h!Reporting and diagnosing problems}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMbubh)}(hMaintainers find that accurate and complete problem reports are invaluable in resolving driver problems. We are frequently not able to reproduce problems and must rely on your patience and efforts to get to the bottom of the problem.h]hMaintainers find that accurate and complete problem reports are invaluable in resolving driver problems. We are frequently not able to reproduce problems and must rely on your patience and efforts to get to the bottom of the problem.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMdhjhhubh)}(hTIf you believe you have a driver problem here are some of the steps you should take:h]hTIf you believe you have a driver problem here are some of the steps you should take:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMihjhhubj()}(hhh](j-)}(hIs it really a driver problem? Eliminate some variables: try different cards, different computers, different cables, different ports on the switch/hub, different versions of the kernel or of the driver, etc. h](h)}(hIs it really a driver problem?h]hIs it really a driver problem?}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMlhj)ubj)}(hEliminate some variables: try different cards, different computers, different cables, different ports on the switch/hub, different versions of the kernel or of the driver, etc. h]h)}(hEliminate some variables: try different cards, different computers, different cables, different ports on the switch/hub, different versions of the kernel or of the driver, etc.h]hEliminate some variables: try different cards, different computers, different cables, different ports on the switch/hub, different versions of the kernel or of the driver, etc.}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMnhj;ubah}(h]h ]h"]h$]h&]uh1jhhhMnhj)ubeh}(h]h ]h"]h$]h&]uh1j,hj&hhhhhNubj-)}(hOK, it's a driver problem. You need to generate a report. Typically this is an email to the maintainer and/or netdev@vger.kernel.org. The maintainer's email address will be in the driver source or in the MAINTAINERS file. h](h)}(hOK, it's a driver problem.h]hOK, it’s a driver problem.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMrhjYubj)}(hYou need to generate a report. Typically this is an email to the maintainer and/or netdev@vger.kernel.org. The maintainer's email address will be in the driver source or in the MAINTAINERS file. h]h)}(hYou need to generate a report. Typically this is an email to the maintainer and/or netdev@vger.kernel.org. The maintainer's email address will be in the driver source or in the MAINTAINERS file.h](hTYou need to generate a report. Typically this is an email to the maintainer and/or }(hjohhhNhNubh)}(hnetdev@vger.kernel.orgh]hnetdev@vger.kernel.org}(hjwhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:netdev@vger.kernel.orguh1hhjoubh\. The maintainer’s email address will be in the driver source or in the MAINTAINERS file.}(hjohhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMthjkubah}(h]h ]h"]h$]h&]uh1jhhhMthjYubeh}(h]h ]h"]h$]h&]uh1j,hj&hhhhhNubj-)}(hX The contents of your report will vary a lot depending upon the problem. If it's a kernel crash then you should refer to 'Documentation/admin-guide/reporting-issues.rst'. But for most problems it is useful to provide the following: - Kernel version, driver version - A copy of the banner message which the driver generates when it is initialised. For example: eth0: 3Com PCI 3c905C Tornado at 0xa400, 00:50:da:6a:88:f0, IRQ 19 8K byte-wide RAM 5:3 Rx:Tx split, autoselect/Autonegotiate interface. MII transceiver found at address 24, status 782d. Enabling bus-master transmits and whole-frame receives. NOTE: You must provide the ``debug=2`` modprobe option to generate a full detection message. Please do this:: modprobe 3c59x debug=2 - If it is a PCI device, the relevant output from 'lspci -vx', eg:: 00:09.0 Ethernet controller: 3Com Corporation 3c905C-TX [Fast Etherlink] (rev 74) Subsystem: 3Com Corporation: Unknown device 9200 Flags: bus master, medium devsel, latency 32, IRQ 19 I/O ports at a400 [size=128] Memory at db000000 (32-bit, non-prefetchable) [size=128] Expansion ROM at [disabled] [size=128K] Capabilities: [dc] Power Management version 2 00: b7 10 00 92 07 00 10 02 74 00 00 02 08 20 00 00 10: 01 a4 00 00 00 00 00 db 00 00 00 00 00 00 00 00 20: 00 00 00 00 00 00 00 00 00 00 00 00 b7 10 00 10 30: 00 00 00 00 dc 00 00 00 00 00 00 00 05 01 0a 0a - A description of the environment: 10baseT? 100baseT? full/half duplex? switched or hubbed? - Any additional module parameters which you may be providing to the driver. - Any kernel logs which are produced. The more the merrier. If this is a large file and you are sending your report to a mailing list, mention that you have the logfile, but don't send it. If you're reporting direct to the maintainer then just send it. To ensure that all kernel logs are available, add the following line to /etc/syslog.conf:: kern.* /var/log/messages Then restart syslogd with:: /etc/rc.d/init.d/syslog restart (The above may vary, depending upon which Linux distribution you use). - If your problem is reproducible then that's great. Try the following: 1) Increase the debug level. Usually this is done via: a) modprobe driver debug=7 b) In /etc/modprobe.d/driver.conf: options driver debug=7 2) Recreate the problem with the higher debug level, send all logs to the maintainer. 3) Download you card's diagnostic tool from Donald Becker's website . Download mii-diag.c as well. Build these. a) Run 'vortex-diag -aaee' and 'mii-diag -v' when the card is working correctly. Save the output. b) Run the above commands when the card is malfunctioning. Send both sets of output. Lh](h)}(hThe contents of your report will vary a lot depending upon the problem. If it's a kernel crash then you should refer to 'Documentation/admin-guide/reporting-issues.rst'.h]hThe contents of your report will vary a lot depending upon the problem. If it’s a kernel crash then you should refer to ‘Documentation/admin-guide/reporting-issues.rst’.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMxhjubh)}(h [disabled] [size=128K] Capabilities: [dc] Power Management version 2 00: b7 10 00 92 07 00 10 02 74 00 00 02 08 20 00 00 10: 01 a4 00 00 00 00 00 db 00 00 00 00 00 00 00 00 20: 00 00 00 00 00 00 00 00 00 00 00 00 b7 10 00 10 30: 00 00 00 00 dc 00 00 00 00 00 00 00 05 01 0a 0a - A description of the environment: 10baseT? 100baseT? full/half duplex? switched or hubbed? - Any additional module parameters which you may be providing to the driver. - Any kernel logs which are produced. The more the merrier. If this is a large file and you are sending your report to a mailing list, mention that you have the logfile, but don't send it. If you're reporting direct to the maintainer then just send it. To ensure that all kernel logs are available, add the following line to /etc/syslog.conf:: kern.* /var/log/messages Then restart syslogd with:: /etc/rc.d/init.d/syslog restart (The above may vary, depending upon which Linux distribution you use). - If your problem is reproducible then that's great. Try the following: 1) Increase the debug level. Usually this is done via: a) modprobe driver debug=7 b) In /etc/modprobe.d/driver.conf: options driver debug=7 2) Recreate the problem with the higher debug level, send all logs to the maintainer. 3) Download you card's diagnostic tool from Donald Becker's website . Download mii-diag.c as well. Build these. a) Run 'vortex-diag -aaee' and 'mii-diag -v' when the card is working correctly. Save the output. b) Run the above commands when the card is malfunctioning. Send both sets of output. h](j()}(hhh](j-)}(hKernel version, driver version h]h)}(hKernel version, driver versionh]hKernel version, driver version}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM~hjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(hXA copy of the banner message which the driver generates when it is initialised. For example: eth0: 3Com PCI 3c905C Tornado at 0xa400, 00:50:da:6a:88:f0, IRQ 19 8K byte-wide RAM 5:3 Rx:Tx split, autoselect/Autonegotiate interface. MII transceiver found at address 24, status 782d. Enabling bus-master transmits and whole-frame receives. NOTE: You must provide the ``debug=2`` modprobe option to generate a full detection message. Please do this:: modprobe 3c59x debug=2 h](h)}(h]A copy of the banner message which the driver generates when it is initialised. For example:h]h]A copy of the banner message which the driver generates when it is initialised. For example:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubh)}(heth0: 3Com PCI 3c905C Tornado at 0xa400, 00:50:da:6a:88:f0, IRQ 19 8K byte-wide RAM 5:3 Rx:Tx split, autoselect/Autonegotiate interface. MII transceiver found at address 24, status 782d. Enabling bus-master transmits and whole-frame receives.h]heth0: 3Com PCI 3c905C Tornado at 0xa400, 00:50:da:6a:88:f0, IRQ 19 8K byte-wide RAM 5:3 Rx:Tx split, autoselect/Autonegotiate interface. MII transceiver found at address 24, status 782d. Enabling bus-master transmits and whole-frame receives.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubh)}(hnNOTE: You must provide the ``debug=2`` modprobe option to generate a full detection message. Please do this::h](hNOTE: You must provide the }(hjhhhNhNubjh)}(h ``debug=2``h]hdebug=2}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jghjubhG modprobe option to generate a full detection message. Please do this:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjubj)}(hmodprobe 3c59x debug=2h]hmodprobe 3c59x debug=2}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhMhjubeh}(h]h ]h"]h$]h&]uh1j,hjubj-)}(hXIf it is a PCI device, the relevant output from 'lspci -vx', eg:: 00:09.0 Ethernet controller: 3Com Corporation 3c905C-TX [Fast Etherlink] (rev 74) Subsystem: 3Com Corporation: Unknown device 9200 Flags: bus master, medium devsel, latency 32, IRQ 19 I/O ports at a400 [size=128] Memory at db000000 (32-bit, non-prefetchable) [size=128] Expansion ROM at [disabled] [size=128K] Capabilities: [dc] Power Management version 2 00: b7 10 00 92 07 00 10 02 74 00 00 02 08 20 00 00 10: 01 a4 00 00 00 00 00 db 00 00 00 00 00 00 00 00 20: 00 00 00 00 00 00 00 00 00 00 00 00 b7 10 00 10 30: 00 00 00 00 dc 00 00 00 00 00 00 00 05 01 0a 0a h](h)}(hAIf it is a PCI device, the relevant output from 'lspci -vx', eg::h]hDIf it is a PCI device, the relevant output from ‘lspci -vx’, eg:}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj0ubj)}(hXp00:09.0 Ethernet controller: 3Com Corporation 3c905C-TX [Fast Etherlink] (rev 74) Subsystem: 3Com Corporation: Unknown device 9200 Flags: bus master, medium devsel, latency 32, IRQ 19 I/O ports at a400 [size=128] Memory at db000000 (32-bit, non-prefetchable) [size=128] Expansion ROM at [disabled] [size=128K] Capabilities: [dc] Power Management version 2 00: b7 10 00 92 07 00 10 02 74 00 00 02 08 20 00 00 10: 01 a4 00 00 00 00 00 db 00 00 00 00 00 00 00 00 20: 00 00 00 00 00 00 00 00 00 00 00 00 b7 10 00 10 30: 00 00 00 00 dc 00 00 00 00 00 00 00 05 01 0a 0ah]hXp00:09.0 Ethernet controller: 3Com Corporation 3c905C-TX [Fast Etherlink] (rev 74) Subsystem: 3Com Corporation: Unknown device 9200 Flags: bus master, medium devsel, latency 32, IRQ 19 I/O ports at a400 [size=128] Memory at db000000 (32-bit, non-prefetchable) [size=128] Expansion ROM at [disabled] [size=128K] Capabilities: [dc] Power Management version 2 00: b7 10 00 92 07 00 10 02 74 00 00 02 08 20 00 00 10: 01 a4 00 00 00 00 00 db 00 00 00 00 00 00 00 00 20: 00 00 00 00 00 00 00 00 00 00 00 00 b7 10 00 10 30: 00 00 00 00 dc 00 00 00 00 00 00 00 05 01 0a 0a}hjBsbah}(h]h ]h"]h$]h&]hhuh1jhhhMhj0ubeh}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h[A description of the environment: 10baseT? 100baseT? full/half duplex? switched or hubbed? h]h)}(hZA description of the environment: 10baseT? 100baseT? full/half duplex? switched or hubbed?h]hZA description of the environment: 10baseT? 100baseT? full/half duplex? switched or hubbed?}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjVubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(hKAny additional module parameters which you may be providing to the driver. h]h)}(hJAny additional module parameters which you may be providing to the driver.h]hJAny additional module parameters which you may be providing to the driver.}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjnubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(hXAny kernel logs which are produced. The more the merrier. If this is a large file and you are sending your report to a mailing list, mention that you have the logfile, but don't send it. If you're reporting direct to the maintainer then just send it. To ensure that all kernel logs are available, add the following line to /etc/syslog.conf:: kern.* /var/log/messages Then restart syslogd with:: /etc/rc.d/init.d/syslog restart (The above may vary, depending upon which Linux distribution you use). h](h)}(hAny kernel logs which are produced. The more the merrier. If this is a large file and you are sending your report to a mailing list, mention that you have the logfile, but don't send it. If you're reporting direct to the maintainer then just send it.h]hXAny kernel logs which are produced. The more the merrier. If this is a large file and you are sending your report to a mailing list, mention that you have the logfile, but don’t send it. If you’re reporting direct to the maintainer then just send it.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubh)}(hZTo ensure that all kernel logs are available, add the following line to /etc/syslog.conf::h]hYTo ensure that all kernel logs are available, add the following line to /etc/syslog.conf:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubj)}(hkern.* /var/log/messagesh]hkern.* /var/log/messages}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhMhjubh)}(hThen restart syslogd with::h]hThen restart syslogd with:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubj)}(h/etc/rc.d/init.d/syslog restarth]h/etc/rc.d/init.d/syslog restart}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhMhjubh)}(hF(The above may vary, depending upon which Linux distribution you use).h]hF(The above may vary, depending upon which Linux distribution you use).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubeh}(h]h ]h"]h$]h&]uh1j,hjubeh}(h]h ]h"]h$]h&]jjuh1j'hhhM~hjubj)}(hX- If your problem is reproducible then that's great. Try the following: 1) Increase the debug level. Usually this is done via: a) modprobe driver debug=7 b) In /etc/modprobe.d/driver.conf: options driver debug=7 2) Recreate the problem with the higher debug level, send all logs to the maintainer. 3) Download you card's diagnostic tool from Donald Becker's website . Download mii-diag.c as well. Build these. a) Run 'vortex-diag -aaee' and 'mii-diag -v' when the card is working correctly. Save the output. b) Run the above commands when the card is malfunctioning. Send both sets of output. h]j()}(hhh]j-)}(hXIf your problem is reproducible then that's great. Try the following: 1) Increase the debug level. Usually this is done via: a) modprobe driver debug=7 b) In /etc/modprobe.d/driver.conf: options driver debug=7 2) Recreate the problem with the higher debug level, send all logs to the maintainer. 3) Download you card's diagnostic tool from Donald Becker's website . Download mii-diag.c as well. Build these. a) Run 'vortex-diag -aaee' and 'mii-diag -v' when the card is working correctly. Save the output. b) Run the above commands when the card is malfunctioning. Send both sets of output. h](h)}(hFIf your problem is reproducible then that's great. Try the following:h]hHIf your problem is reproducible then that’s great. Try the following:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubhenumerated_list)}(hhh](j-)}(hIncrease the debug level. Usually this is done via: a) modprobe driver debug=7 b) In /etc/modprobe.d/driver.conf: options driver debug=7 h](h)}(h4Increase the debug level. Usually this is done via:h]h4Increase the debug level. Usually this is done via:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubj)}(hhh](j-)}(hmodprobe driver debug=7h]h)}(hjh]hmodprobe driver debug=7}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(h7In /etc/modprobe.d/driver.conf: options driver debug=7 h]h)}(h6In /etc/modprobe.d/driver.conf: options driver debug=7h]h6In /etc/modprobe.d/driver.conf: options driver debug=7}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj4ubah}(h]h ]h"]h$]h&]uh1j,hjubeh}(h]h ]h"]h$]h&]enumtype loweralphaprefixhsuffix)uh1jhjubeh}(h]h ]h"]h$]h&]uh1j,hjubj-)}(hSRecreate the problem with the higher debug level, send all logs to the maintainer. h]h)}(hRRecreate the problem with the higher debug level, send all logs to the maintainer.h]hRRecreate the problem with the higher debug level, send all logs to the maintainer.}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj]ubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(hXYDownload you card's diagnostic tool from Donald Becker's website . Download mii-diag.c as well. Build these. a) Run 'vortex-diag -aaee' and 'mii-diag -v' when the card is working correctly. Save the output. b) Run the above commands when the card is malfunctioning. Send both sets of output. h](h)}(hDownload you card's diagnostic tool from Donald Becker's website . Download mii-diag.c as well. Build these.h](hFDownload you card’s diagnostic tool from Donald Becker’s website <}(hjyhhhNhNubh)}(h(http://www.scyld.com/ethercard_diag.htmlh]h(http://www.scyld.com/ethercard_diag.html}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurijuh1hhjyubh->. Download mii-diag.c as well. Build these.}(hjyhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjuubj)}(hhh](j-)}(h`Run 'vortex-diag -aaee' and 'mii-diag -v' when the card is working correctly. Save the output. h]h)}(h_Run 'vortex-diag -aaee' and 'mii-diag -v' when the card is working correctly. Save the output.h]hgRun ‘vortex-diag -aaee’ and ‘mii-diag -v’ when the card is working correctly. Save the output.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1j,hjubj-)}(hSRun the above commands when the card is malfunctioning. Send both sets of output. h]h)}(hRRun the above commands when the card is malfunctioning. Send both sets of output.h]hRRun the above commands when the card is malfunctioning. Send both sets of output.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjubah}(h]h ]h"]h$]h&]uh1j,hjubeh}(h]h ]h"]h$]h&]jRjSjThjUjVuh1jhjuubeh}(h]h ]h"]h$]h&]uh1j,hjubeh}(h]h ]h"]h$]h&]jRarabicjThjUjVuh1jhjubeh}(h]h ]h"]h$]h&]uh1j,hjubah}(h]h ]h"]h$]h&]jjuh1j'hhhMhjubah}(h]h ]h"]h$]h&]uh1jhhhMhjubeh}(h]h ]h"]h$]h&]uh1jhhhM~hjubeh}(h]h ]h"]h$]h&]uh1j,hj&hhhhhNubeh}(h]h ]h"]h$]h&]jjuh1j'hhhMlhjhhubh)}(hXFinally, please be patient and be prepared to do some work. You may end up working on this problem for a week or more as the maintainer asks more questions, asks for more tests, asks for patches to be applied, etc. At the end of it all, the problem may even remain unresolved.h]hXFinally, please be patient and be prepared to do some work. You may end up working on this problem for a week or more as the maintainer asks more questions, asks for more tests, asks for patches to be applied, etc. At the end of it all, the problem may even remain unresolved.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]!reporting-and-diagnosing-problemsah ]h"]!reporting and diagnosing problemsah$]h&]uh1hhjNhhhhhMbubeh}(h]module-parametersah ]h"]module parametersah$]h&]uh1hhhhhhhhKIubeh}(h]com-vortex-device-driverah ]h"]3com vortex device driverah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksjYfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjLerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(j'j$jjj j j j j1j.jjjju nametypes}(j'jj j j1jjuh}(j$hjjNj j) j j j.j jj4jju footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages] transformerN include_log] decorationNhhub.