share/man/man4/txp.4

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