share/man/man4/txp.4

   1 .\"     $OpenBSD: txp.4,v 1.8 2001/06/26 02:09:11 pjanzen Exp $
   2 .\"
   3 .\" Copyright (c) 2001 Jason L. Wright (jason@thought.net)
   4 .\" All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\"
  15 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  16 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  17 .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  18 .\" DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
  19 .\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  20 .\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  21 .\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  22 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  23 .\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
  24 .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  25 .\" POSSIBILITY OF SUCH DAMAGE.
  26 .\"
  27 .\" $FreeBSD$
  28 .\"
  29 .Dd March 12, 2009
  30 .Dt TXP 4
  31 .Os
  32 .Sh NAME
  33 .Nm txp
  34 .Nd "3Com 3XP Typhoon/Sidewinder (3CR990) Ethernet interface"
  35 .Sh SYNOPSIS
  36 To compile this driver into the kernel,
  37 place the following line in your
  38 kernel configuration file:
  39 .Bd -ragged -offset indent
  40 .Cd "device txp"
  41 .Ed
  42 .Pp
  43 Alternatively, to load the driver as a
  44 module at boot time, place the following line in
  45 .Xr loader.conf 5 :
  46 .Bd -literal -offset indent
  47 if_txp_load="YES"
  48 .Ed
  49 .Sh DESCRIPTION
  50 The
  51 .Nm
  52 interface provides access to the 10Mb/s and 100Mb/s Ethernet networks via the
  53 .Tn 3Com
  54 .Tn Typhoon/Sidewinder
  55 chipset.
  56 .Pp
  57 Basic Ethernet functions are provided as well as support for
  58 .Xr vlan 4
  59 tag removal and insertion assistance, receive
  60 .Xr ip 4 ,
  61 .Xr tcp 4 ,
  62 and
  63 .Xr udp 4
  64 checksum offloading,
  65 and
  66 transmit
  67 .Xr ip 4
  68 checksum offloading.
  69 There is currently no support for
  70 transmit
  71 .Xr tcp 4
  72 or
  73 .Xr udp 4
  74 checksum offloading,
  75 .Xr tcp 4
  76 segmentation, nor
  77 .Xr ipsec 4
  78 acceleration.
  79 .Pp
  80 Each of the host's network addresses
  81 is specified at boot time with an
  82 .Dv SIOCSIFADDR
  83 .Xr ioctl 2 .
  84 The
  85 .Nm
  86 interface employs the address resolution protocol described in
  87 .Xr arp 4
  88 to dynamically map between Internet and Ethernet addresses on the local
  89 network.
  90 .Pp
  91 When a
  92 .Nm
  93 interface is brought up, by default, it will attempt to auto-negotiate the
  94 link speed and duplex mode.
  95 The speeds, in order of attempt, are:
  96 100Mb/s Full Duplex, 100Mb/s Half Duplex, 10 Mb/s Full Duplex, and
  97 10 Mb/s Half Duplex.
  98 .Pp
  99 The
 100 .Nm
 101 supports several media types, which are selected via the
 102 .Xr ifconfig 8
 103 command.
 104 The supported media types are:
 105 .Bl -tag -width indent
 106 .It Cm media autoselect
 107 Attempt to autoselect the media type (default)
 108 .It Cm media 100baseTX mediaopt full-duplex
 109 Use 100baseTX, full duplex
 110 .It Cm media 100baseTX Op Cm mediaopt half-duplex
 111 Use 100baseTX, half duplex
 112 .It Cm media 10baseT mediaopt full-duplex
 113 Use 10baseT, full duplex
 114 .It Cm media 10baseT Op Cm mediaopt half-duplex
 115 Use 10baseT, half duplex
 116 .El
 117 .Sh HARDWARE
 118 The
 119 .Nm
 120 driver supports the following cards:
 121 .Pp
 122 .Bl -bullet -offset indent -compact
 123 .It
 124 3Com 3CR990-TX-95
 125 .It
 126 3Com 3CR990-TX-97
 127 .It
 128 3Com 3cR990B-TXM
 129 .It
 130 3Com 3CR990SVR95
 131 .It
 132 3Com 3CR990SVR97
 133 .It
 134 3Com 3cR990B-SRV
 135 .El
 136 .Sh SEE ALSO
 137 .Xr altq 4 ,
 138 .Xr arp 4 ,
 139 .Xr inet 4 ,
 140 .Xr intro 4 ,
 141 .Xr ip 4 ,
 142 .Xr miibus 4 ,
 143 .Xr tcp 4 ,
 144 .Xr udp 4 ,
 145 .Xr vlan 4 ,
 146 .Xr ifconfig 8
 147 .Sh HISTORY
 148 The
 149 .Nm
 150 driver first appeared in
 151 .Ox 2.9 .