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