share/man/man4/txp.4

   1 .\"     $NetBSD: txp.4,v 1.3 2003/08/21 12:50:57 drochner 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 .Dd August 21, 2003
  28 .Dt TXP 4
  29 .Os
  30 .Sh NAME
  31 .Nm txp
  32 .Nd 3Com 3XP Typhoon/Sidewinder (3CR990) Ethernet interface
  33 .Sh SYNOPSIS
  34 .Cd "txp* at pci? dev ? function ?"
  35 .Sh DESCRIPTION
  36 The
  37 .Nm
  38 interface provides access to the 10Mb/s and 100Mb/s Ethernet networks via the
  39 .Tn 3Com
  40 .Tn Typhoon/Sidewinder
  41 chipset.
  42 This driver supports the following cards:
  43 .Pp
  44 .Bl -bullet -offset indent -compact
  45 .It
  46 3Com 3CR990-TX-95
  47 .It
  48 3Com 3CR990-TX-97
  49 .It
  50 3Com 3CR990SVR95
  51 .It
  52 3Com 3CR990SVR97
  53 .El
  54 .Pp
  55 Basic Ethernet functions are provided as well as support for
  56 .Xr vlan 4
  57 tag removal and insertion assistance,
  58 receive
  59 .Xr ip 4 ,
  60 .Xr tcp 4 ,
  61 and
  62 .Xr udp 4
  63 checksum offloading,
  64 and
  65 transmit
  66 .Xr ip 4
  67 checksum offloading.
  68 There is currently no support for
  69 transmit
  70 .Xr tcp 4
  71 or
  72 .Xr udp 4
  73 checksum offloading,
  74 .Xr tcp 4
  75 segmentation, nor
  76 .Xr ipsec 4
  77 acceleration.
  78 Note that hardware checksumming is only used when the interface is not
  79 in
  80 .Xr bridge 4
  81 mode.
  82 .Pp
  83 Each of the host's network addresses
  84 is specified at boot time with an
  85 .Dv SIOCSIFADDR
  86 .Xr ioctl 2 .
  87 The
  88 .Nm
  89 interface employs the address resolution protocol described in
  90 .Xr arp 4
  91 to dynamically map between Internet and Ethernet addresses on the local
  92 network.
  93 .Pp
  94 When a
  95 .Nm
  96 interface is brought up, by default, it will attempt to auto-negotiate the
  97 link speed and duplex mode.
  98 The speeds, in order of attempt, are: 100Mb/s Full Duplex, 100Mb/s Half Duplex,
  99 10 Mb/s Full Duplex, and 10 Mb/s Half Duplex.
 100 .Pp
 101 The
 102 .Nm
 103 supports several media types, which are selected via the
 104 .Xr ifconfig 8
 105 command.
 106 The supported media types are:
 107 .Bl -tag -width xxxxxxxxxxxxxx -offset indent
 108 .It media autoselect
 109 Attempt to autoselect the media type (default)
 110 .It media 100baseTX mediaopt full-duplex
 111 Use 100baseTX, full duplex
 112 .It media 100baseTX Op mediaopt half-duplex
 113 Use 100baseTX, half duplex
 114 .It media 10baseT mediaopt full-duplex
 115 Use 10baseT, full duplex
 116 .It media 10baseT Op mediaopt half-duplex
 117 Use 10baseT, half duplex
 118 .El
 119 .Sh SEE ALSO
 120 .Xr arp 4 ,
 121 .Xr ifmedia 4 ,
 122 .Xr inet 4 ,
 123 .Xr intro 4 ,
 124 .Xr ip 4 ,
 125 .Xr netintro 4 ,
 126 .Xr pci 4 ,
 127 .Xr tcp 4 ,
 128 .Xr udp 4 ,
 129 .Xr vlan 4 ,
 130 .Xr ifconfig 8
 131 .Sh HISTORY
 132 The
 133 .Nm
 134 driver first appeared in
 135 .Nx 2.0 .