share/man/man4/txp.4

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