6/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 July 16, 2005
  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 Note that hardware checksumming is only used when the interface is not
  80 in
  81 .Xr bridge 4
  82 mode.
  83 .Pp
  84 Each of the host's network addresses
  85 is specified at boot time with an
  86 .Dv SIOCSIFADDR
  87 .Xr ioctl 2 .
  88 The
  89 .Nm
  90 interface employs the address resolution protocol described in
  91 .Xr arp 4
  92 to dynamically map between Internet and Ethernet addresses on the local
  93 network.
  94 .Pp
  95 When a
  96 .Nm
  97 interface is brought up, by default, it will attempt to auto-negotiate the
  98 link speed and duplex mode.
  99 The speeds, in order of attempt, are:
 100 100Mb/s Full Duplex, 100Mb/s Half Duplex, 10 Mb/s Full Duplex, and
 101 10 Mb/s Half Duplex.
 102 .Pp
 103 The
 104 .Nm
 105 supports several media types, which are selected via the
 106 .Xr ifconfig 8
 107 command.
 108 The supported media types are:
 109 .Bl -tag -width indent
 110 .It Cm media autoselect
 111 Attempt to autoselect the media type (default)
 112 .It Cm media 100baseTX mediaopt full-duplex
 113 Use 100baseTX, full duplex
 114 .It Cm media 100baseTX Op Cm mediaopt half-duplex
 115 Use 100baseTX, half duplex
 116 .It Cm media 10baseT mediaopt full-duplex
 117 Use 10baseT, full duplex
 118 .It Cm media 10baseT Op Cm mediaopt half-duplex
 119 Use 10baseT, half duplex
 120 .El
 121 .Sh HARDWARE
 122 The
 123 .Nm
 124 driver supports the following cards:
 125 .Pp
 126 .Bl -bullet -offset indent -compact
 127 .It
 128 3Com 3CR990-TX-95
 129 .It
 130 3Com 3CR990-TX-97
 131 .It
 132 3Com 3cR990B-TXM
 133 .It
 134 3Com 3CR990SVR95
 135 .It
 136 3Com 3CR990SVR97
 137 .It
 138 3Com 3cR990B-SRV
 139 .El
 140 .Sh SEE ALSO
 141 .Xr arp 4 ,
 142 .Xr inet 4 ,
 143 .Xr intro 4 ,
 144 .Xr ip 4 ,
 145 .Xr miibus 4 ,
 146 .Xr tcp 4 ,
 147 .Xr udp 4 ,
 148 .Xr vlan 4 ,
 149 .Xr ifconfig 8
 150 .Sh HISTORY
 151 The
 152 .Nm
 153 driver first appeared in
 154 .Ox 2.9 .