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 October 24, 2018
  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 DEPRECATION NOTICE
  50 The
  51 .Nm
  52 driver is not present in
  53 .Fx 13.0
  54 and later.
  55 See https://github.com/freebsd/fcp/blob/master/fcp-0101.md for more
  56 information.
  57 .Sh DESCRIPTION
  58 The
  59 .Nm
  60 interface provides access to the 10Mb/s and 100Mb/s Ethernet networks via the
  61 .Tn 3Com
  62 .Tn Typhoon/Sidewinder
  63 chipset.
  64 .Pp
  65 Basic Ethernet functions are provided as well as support for
  66 .Xr vlan 4
  67 tag removal and insertion assistance, receive
  68 .Xr ip 4 ,
  69 .Xr tcp 4 ,
  70 and
  71 .Xr udp 4
  72 checksum offloading,
  73 and
  74 transmit
  75 .Xr ip 4
  76 checksum offloading.
  77 There is currently no support for
  78 transmit
  79 .Xr tcp 4
  80 or
  81 .Xr udp 4
  82 checksum offloading,
  83 .Xr tcp 4
  84 segmentation, nor
  85 .Xr ipsec 4
  86 acceleration.
  87 .Pp
  88 When a
  89 .Nm
  90 interface is brought up, by default, it will attempt to auto-negotiate the
  91 link speed and duplex mode.
  92 The speeds, in order of attempt, are:
  93 100Mb/s Full Duplex, 100Mb/s Half Duplex, 10 Mb/s Full Duplex, and
  94 10 Mb/s Half Duplex.
  95 .Pp
  96 The
  97 .Nm
  98 supports several media types, which are selected via the
  99 .Xr ifconfig 8
 100 command.
 101 The supported media types are:
 102 .Bl -tag -width indent
 103 .It Cm media autoselect
 104 Attempt to autoselect the media type (default)
 105 .It Cm media 100baseTX mediaopt full-duplex
 106 Use 100baseTX, full duplex
 107 .It Cm media 100baseTX Op Cm mediaopt half-duplex
 108 Use 100baseTX, half duplex
 109 .It Cm media 10baseT mediaopt full-duplex
 110 Use 10baseT, full duplex
 111 .It Cm media 10baseT Op Cm mediaopt half-duplex
 112 Use 10baseT, half duplex
 113 .El
 114 .Sh HARDWARE
 115 The
 116 .Nm
 117 driver supports the following cards:
 118 .Pp
 119 .Bl -bullet -offset indent -compact
 120 .It
 121 3Com 3CR990-TX-95
 122 .It
 123 3Com 3CR990-TX-97
 124 .It
 125 3Com 3cR990B-TXM
 126 .It
 127 3Com 3CR990SVR95
 128 .It
 129 3Com 3CR990SVR97
 130 .It
 131 3Com 3cR990B-SRV
 132 .El
 133 .Sh SEE ALSO
 134 .Xr altq 4 ,
 135 .Xr arp 4 ,
 136 .Xr inet 4 ,
 137 .Xr intro 4 ,
 138 .Xr ip 4 ,
 139 .Xr miibus 4 ,
 140 .Xr tcp 4 ,
 141 .Xr udp 4 ,
 142 .Xr vlan 4 ,
 143 .Xr ifconfig 8
 144 .Sh HISTORY
 145 The
 146 .Nm
 147 driver first appeared in
 148 .Ox 2.9 .