share/man/man4/wm.4

   1 .\"     $NetBSD: wm.4,v 1.19 2007/08/29 09:04:04 xtraeme Exp $
   2 .\"
   3 .\" Copyright 2002, 2003 Wasabi Systems, Inc.
   4 .\" All rights reserved.
   5 .\"
   6 .\" Written by Jason R. Thorpe for Wasabi Systems, Inc.
   7 .\"
   8 .\" Redistribution and use in source and binary forms, with or without
   9 .\" modification, are permitted provided that the following conditions
  10 .\" are met:
  11 .\" 1. Redistributions of source code must retain the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer.
  13 .\" 2. Redistributions in binary form must reproduce the above copyright
  14 .\"    notice, this list of conditions and the following disclaimer in the
  15 .\"    documentation and/or other materials provided with the distribution.
  16 .\" 3. All advertising materials mentioning features or use of this software
  17 .\"    must display the following acknowledgement:
  18 .\"     This product includes software developed for the NetBSD Project by
  19 .\"     Wasabi Systems, Inc.
  20 .\" 4. The name of Wasabi Systems, Inc. may not be used to endorse
  21 .\"    or promote products derived from this software without specific prior
  22 .\"    written permission.
  23 .\"
  24 .\" THIS SOFTWARE IS PROVIDED BY WASABI SYSTEMS, INC. ``AS IS'' AND
  25 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  26 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  27 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL WASABI SYSTEMS, INC
  28 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  29 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  30 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  31 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  32 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  33 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  34 .\" POSSIBILITY OF SUCH DAMAGE.
  35 .\"
  36 .Dd August 28, 2007
  37 .Dt WM 4
  38 .Os
  39 .Sh NAME
  40 .Nm wm
  41 .Nd Intel i8254x Gigabit Ethernet driver
  42 .Sh SYNOPSIS
  43 .Cd "wm* at pci? dev ? function ?"
  44 .Pp
  45 Configuration of PHYs may also be necessary.
  46 See
  47 .Xr mii 4 .
  48 .Sh DESCRIPTION
  49 The
  50 .Nm
  51 device driver supports Gigabit Ethernet interfaces based on the Intel
  52 i8254x family of Gigabit Ethernet chips.
  53 The interfaces supported by the
  54 .Nm
  55 driver include:
  56 .Bl -bullet
  57 .It
  58 Intel i82542 1000BASE-X Ethernet
  59 .It
  60 Intel i82543GC 1000BASE-X Ethernet
  61 .It
  62 Intel i82543GC 1000BASE-T Ethernet
  63 .It
  64 Intel i82544EI 1000BASE-T Ethernet
  65 .It
  66 Intel i82544EI 1000BASE-X Ethernet
  67 .It
  68 Intel i82544GC 1000BASE-T Ethernet
  69 .It
  70 Intel i82544GC (LOM) 1000BASE-T Ethernet
  71 .It
  72 Intel i82540EM 1000BASE-T Ethernet
  73 .It
  74 Intel i82540EM (LOM) 1000BASE-T Ethernet
  75 .It
  76 Intel i82540EP 1000BASE-T Ethernet
  77 .It
  78 Intel i82541EI 1000BASE-T Ethernet
  79 .It
  80 Intel i82541EI (Mobile) 1000BASE-T Ethernet
  81 .It
  82 Intel i82541ER 1000BASE-T Ethernet
  83 .It
  84 Intel i82541GI 1000BASE-T Ethernet
  85 .It
  86 Intel i82541PI 1000BASE-T Ethernet
  87 .It
  88 Intel i82545EM 1000BASE-T Ethernet
  89 .It
  90 Intel i82545EM 1000BASE-X Ethernet
  91 .It
  92 Intel i82545GB 1000BASE-T Ethernet
  93 .It
  94 Intel i82545GB 1000BASE-X Ethernet
  95 .It
  96 Intel i82546EB 1000BASE-T Ethernet
  97 .Pq dual-port
  98 .It
  99 Intel i82546EB 1000BASE-X Ethernet
 100 .Pq dual-port
 101 .It
 102 Intel i82546GB 1000BASE-T Ethernet
 103 .Pq dual-port
 104 .It
 105 Intel i82546GB 1000BASE-X Ethernet
 106 .Pq dual-port
 107 .It
 108 Intel i82547EI 1000BASE-T Ethernet
 109 .Pq CSA
 110 .It
 111 Intel i82547GI 1000BASE-T Ethernet
 112 .Pq CSA
 113 .It
 114 Intel i82571 1000BASE-T Ethernet
 115 .Pq dual-port
 116 .It
 117 Intel i82572 1000BASE-T Ethernet
 118 .It
 119 Intel i82573 1000BASE-T Ethernet
 120 .It
 121 Intel i82801H (ICH8 LAN) 1000BASE-T Ethernet
 122 .It
 123 Intel i82801I (ICH9 LAN) 1000BASE-T Ethernet
 124 .It
 125 Intel i80003 1000BASE-T Ethernet
 126 .El
 127 .Pp
 128 In addition to Intel's own
 129 .Dq PRO/1000
 130 line of Gigabit Ethernet interfaces, these chips also appear on
 131 some server systems, processor evaluation boards, and in embedded
 132 systems.
 133 .Pp
 134 The i8254x supports IPv4/TCP/UDP checksumming and TCP segmentation
 135 in hardware.
 136 The
 137 .Nm
 138 driver supports these features of the chip.
 139 See
 140 .Xr ifconfig 8
 141 for information on how to enable this feature.
 142 .\" .Sh DIAGNOSTICS
 143 .\" XXX to be done.
 144 .Sh SEE ALSO
 145 .Xr arp 4 ,
 146 .Xr ifmedia 4 ,
 147 .Xr mii 4 ,
 148 .Xr netintro 4 ,
 149 .Xr pci 4 ,
 150 .Xr ifconfig 8
 151 .Sh HISTORY
 152 The
 153 .Nm
 154 driver first appeared in
 155 .Nx 1.6 .
 156 .Sh AUTHORS
 157 The
 158 .Nm
 159 driver was written by
 160 .An Jason R. Thorpe Aq thorpej@wasabisystems.com .
 161 .Sh BUGS
 162 The Intel i82545GM and i82546GB controllers with internal SERDES are
 163 not currently supported.