share/man/man4/stge.4

   1 .\"     $NetBSD: stge.4,v 1.7 2003/02/14 15:20:20 grant Exp $
   2 .\"
   3 .\" Copyright (c) 2001 The NetBSD Foundation, Inc.
   4 .\" All rights reserved.
   5 .\"
   6 .\" This code is derived from software contributed to The NetBSD Foundation
   7 .\" by Jason R. Thorpe.
   8 .\"
   9 .\" Redistribution and use in source and binary forms, with or without
  10 .\" modification, are permitted provided that the following conditions
  11 .\" are met:
  12 .\" 1. Redistributions of source code must retain the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer.
  14 .\" 2. Redistributions in binary form must reproduce the above copyright
  15 .\"    notice, this list of conditions and the following disclaimer in the
  16 .\"    documentation and/or other materials provided with the distribution.
  17 .\" 3. All advertising materials mentioning features or use of this software
  18 .\"    must display the following acknowledgement:
  19 .\"        This product includes software developed by the NetBSD
  20 .\"        Foundation, Inc. and its contributors.
  21 .\" 4. Neither the name of The NetBSD Foundation nor the names of its
  22 .\"    contributors may be used to endorse or promote products derived
  23 .\"    from this software without specific prior written permission.
  24 .\"
  25 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  26 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  27 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  28 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  29 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  30 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  31 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  32 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  33 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  34 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  35 .\" POSSIBILITY OF SUCH DAMAGE.
  36 .\"
  37 .\" $FreeBSD$
  38 .\"
  39 .Dd July 25, 2006
  40 .Dt STGE 4
  41 .Os
  42 .Sh NAME
  43 .Nm stge
  44 .Nd Sundance/Tamarack TC9021 Gigabit Ethernet adapter driver
  45 .Sh SYNOPSIS
  46 To compile this driver into the kernel,
  47 place the following lines in your
  48 kernel configuration file:
  49 .Bd -ragged -offset indent
  50 .Cd "device miibus"
  51 .Cd "device stge"
  52 .Ed
  53 .Pp
  54 Alternatively, to load the driver as a
  55 module at boot time, place the following line in
  56 .Xr loader.conf 5 :
  57 .Bd -literal -offset indent
  58 if_stge_load="YES"
  59 .Ed
  60 .Sh DESCRIPTION
  61 The
  62 .Nm
  63 device driver provides support for various NICs based on the
  64 Sundance/Tamarack TC9021 Gigabit Ethernet controller chip.
  65 .Pp
  66 The Sundance/Tamarack TC9021 is found on the D-Link DGE-550T
  67 and the Antares Microsystems Gigabit Ethernet board.
  68 It uses an external PHY or an external 10-bit interface.
  69 .Pp
  70 All NICs supported by the
  71 .Nm
  72 driver have TCP/UDP/IP checksum offload for both receive and
  73 transmit, hardware VLAN tag stripping/insertion features, and
  74 receive interrupt moderation mechanism as well as a 64-bit
  75 multicast hash filter.
  76 The Sundance/Tamarack TC9021 supports TBI (ten bit interface)
  77 and GMII transceivers, which means it can be used with either
  78 copper or 1000baseX fiber applications.
  79 .Pp
  80 The Sundance/Tamarack TC9021 also support jumbo frames, which can be
  81 configured via the interface MTU setting.
  82 Selecting an MTU larger than 1500 bytes with the
  83 .Xr ifconfig 8
  84 utility configures the adapter to receive and transmit jumbo frames.
  85 .Pp
  86 The
  87 .Nm
  88 driver supports the following media types:
  89 .Bl -tag -width ".Cm 10baseT/UTP"
  90 .It Cm autoselect
  91 Enable autoselection of the media type and options.
  92 The user can manually override
  93 the autoselected mode by adding media options to
  94 .Xr rc.conf 5 .
  95 .It Cm 10baseT/UTP
  96 Set 10Mbps operation.
  97 The
  98 .Xr ifconfig 8
  99 .Cm mediaopt
 100 option can also be used to select either
 101 .Cm full-duplex
 102 or
 103 .Cm half-duplex
 104 modes.
 105 .It Cm 100baseTX
 106 Set 100Mbps (Fast Ethernet) operation.
 107 The
 108 .Xr ifconfig 8
 109 .Cm mediaopt
 110 option can also be used to select either
 111 .Cm full-duplex
 112 or
 113 .Cm half-duplex
 114 modes.
 115 .It Cm 1000baseTX
 116 Set 1000baseTX operation over twisted pair.
 117 The Sundance/Tamarack supports 1000Mbps in
 118 .Cm autoselect
 119 mode only.
 120 .\" .It Cm 1000baseSX
 121 .\" Set 1000Mbps (Gigabit Ethernet) operation.
 122 .\" Both
 123 .\" .Cm full-duplex
 124 .\" and
 125 .\" .Cm half-duplex
 126 .\" modes are supported.
 127 .El
 128 .Pp
 129 The
 130 .Nm
 131 driver supports the following media options:
 132 .Bl -tag -width ".Cm full-duplex"
 133 .It Cm full-duplex
 134 Force full duplex operation.
 135 .It Cm half-duplex
 136 Force half duplex operation.
 137 .El
 138 .Pp
 139 The
 140 .Nm
 141 driver also supports one special link option for 1000baseTX cards:
 142 .Pp
 143 .Bl -tag -width ".Cm link0"
 144 .It Cm link0
 145 With 1000baseTX cards, establishing a link between two ports requires
 146 that one port is configured as master and the other one as slave.
 147 With autonegotiation,
 148 the master/slave settings will be chosen automatically.
 149 However when manually selecting the link state, it is necessary to
 150 force one side of the link to be a master and the other a slave.
 151 The
 152 .Nm
 153 driver configures the ports as slaves by default.
 154 Setting the
 155 .Ar link0
 156 flag with
 157 .Xr ifconfig 8
 158 will set a port as a master instead.
 159 .El
 160 .Pp
 161 For more information on configuring this device, see
 162 .Xr ifconfig 8 .
 163 .Sh HARDWARE
 164 The
 165 .Nm
 166 driver provides support for various NICs based on the Sundance/Tamarack
 167 TC9021 based Gigabit Ethernet controller chips, including:
 168 .Pp
 169 .Bl -bullet -compact
 170 .It
 171 Antares Microsystems Gigabit Ethernet
 172 .It
 173 ASUS NX1101 Gigabit Ethernet
 174 .It
 175 D-Link DL-4000 Gigabit Ethernet
 176 .It
 177 IC Plus IP1000A Gigabit Ethernet
 178 .It
 179 Sundance ST-2021 Gigabit Ethernet
 180 .It
 181 Sundance ST-2023 Gigabit Ethernet
 182 .It
 183 Sundance TC9021 Gigabit Ethernet
 184 .It
 185 Tamarack TC9021 Gigabit Ethernet
 186 .El
 187 .Sh SYSCTL VARIABLES
 188 The following variables are available as both
 189 .Xr sysctl 8
 190 variables and
 191 .Xr loader 8
 192 tunables:
 193 .Bl -tag -width indent
 194 .It Va dev.stge.%d.rxint_nframe
 195 Number of frames between RxDMAComplete interrupt.
 196 The accepted range is 1 to 255, default value is 8 frames.
 197 The interface has to be brought down and up again before a change takes effect.
 198 .It Va dev.stge.%d.rxint_dmawait
 199 Maximum amount of time to wait in 1us increments before issuing
 200 a Rx interrupt if number of frames received is less than rxint_nframe.
 201 The accepted range is 0 to 4194, default value is 30 microseconds.
 202 The interface has to be brought down and up again before a change takes effect.
 203 .El
 204 .Sh SEE ALSO
 205 .Xr arp 4 ,
 206 .Xr miibus 4 ,
 207 .Xr netintro 4 ,
 208 .Xr ng_ether 4 ,
 209 .Xr polling 4 ,
 210 .Xr vlan 4 ,
 211 .Xr ifconfig 8
 212 .Sh HISTORY
 213 The
 214 .Nm
 215 driver was ported from
 216 .Nx
 217 and first appeared in
 218 .Fx 6.2 .
 219 The
 220 .Nx
 221 version was written by
 222 .An Jason R. Thorpe
 223 .Aq thorpej@NetBSD.org .
 224 .Sh AUTHORS
 225 The
 226 .Nm
 227 driver was ported by
 228 .An Pyun YongHyeon
 229 .Aq yongari@FreeBSD.org .