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 January 26, 2012
  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 When a
  81 .Nm
  82 interface is brought up, by default, it will attempt to auto-negotiate the
  83 link speed and duplex mode.
  84 The speeds, in order of attempt, are:
  85 100Mb/s Full Duplex, 100Mb/s Half Duplex, 10 Mb/s Full Duplex, and
  86 10 Mb/s Half Duplex.
  87 .Pp
  88 The
  89 .Nm
  90 supports several media types, which are selected via the
  91 .Xr ifconfig 8
  92 command.
  93 The supported media types are:
  94 .Bl -tag -width indent
  95 .It Cm media autoselect
  96 Attempt to autoselect the media type (default)
  97 .It Cm media 100baseTX mediaopt full-duplex
  98 Use 100baseTX, full duplex
  99 .It Cm media 100baseTX Op Cm mediaopt half-duplex
 100 Use 100baseTX, half duplex
 101 .It Cm media 10baseT mediaopt full-duplex
 102 Use 10baseT, full duplex
 103 .It Cm media 10baseT Op Cm mediaopt half-duplex
 104 Use 10baseT, half duplex
 105 .El
 106 .Sh HARDWARE
 107 The
 108 .Nm
 109 driver supports the following cards:
 110 .Pp
 111 .Bl -bullet -offset indent -compact
 112 .It
 113 3Com 3CR990-TX-95
 114 .It
 115 3Com 3CR990-TX-97
 116 .It
 117 3Com 3cR990B-TXM
 118 .It
 119 3Com 3CR990SVR95
 120 .It
 121 3Com 3CR990SVR97
 122 .It
 123 3Com 3cR990B-SRV
 124 .El
 125 .Sh SEE ALSO
 126 .Xr altq 4 ,
 127 .Xr arp 4 ,
 128 .Xr inet 4 ,
 129 .Xr intro 4 ,
 130 .Xr ip 4 ,
 131 .Xr miibus 4 ,
 132 .Xr tcp 4 ,
 133 .Xr udp 4 ,
 134 .Xr vlan 4 ,
 135 .Xr ifconfig 8
 136 .Sh HISTORY
 137 The
 138 .Nm
 139 driver first appeared in
 140 .Ox 2.9 .