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