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.\"
| 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: head/share/man/man4/txp.4 141580 2005-02-09 18:07:17Z ru $
| 27.\" $FreeBSD: head/share/man/man4/txp.4 148145 2005-07-19 00:26:30Z trhodes $
|
28.\"
| 28.\"
|
29.Dd July 4, 2004
| 29.Dd July 16, 2005
|
30.Dt TXP 4
31.Os
32.Sh NAME
33.Nm txp
| 30.Dt TXP 4
31.Os
32.Sh NAME
33.Nm txp
|
34.Nd 3Com 3XP Typhoon/Sidewinder (3CR990) Ethernet interface
| 34.Nd "3Com 3XP Typhoon/Sidewinder (3CR990) Ethernet interface"
|
35.Sh SYNOPSIS
| 35.Sh SYNOPSIS
|
| 36To compile support for the
37.Nm
38driver into your kernel, place the following line in your kernel configuration file:
39.Bd -ragged -offset indent
|
36.Cd "device txp"
| 40.Cd "device txp"
|
| 41.Ed
42.Pp
43Alternatively, to load the
44.Nm
45driver at boot time, place the following line in
46.Xr loader.conf 5 :
47.Bd -literal -offset indent
48if_txp_load="YES"
49.Ed
|
37.Sh DESCRIPTION
38The
39.Nm
40interface provides access to the 10Mb/s and 100Mb/s Ethernet networks via the
41.Tn 3Com
42.Tn Typhoon/Sidewinder
43chipset.
44.Pp
45Basic Ethernet functions are provided as well as support for
46.Xr vlan 4
47tag removal and insertion assistance, receive
48.Xr ip 4 ,
49.Xr tcp 4 ,
50and
51.Xr udp 4
52checksum offloading,
53and
54transmit
55.Xr ip 4
56checksum offloading.
57There is currently no support for
58transmit
59.Xr tcp 4
60or
61.Xr udp 4
62checksum offloading,
63.Xr tcp 4
64segmentation, nor
65.Xr ipsec 4
66acceleration.
67Note that hardware checksumming is only used when the interface is not
68in
69.Xr bridge 4
70mode.
71.Pp
72Each of the host's network addresses
73is specified at boot time with an
74.Dv SIOCSIFADDR
75.Xr ioctl 2 .
76The
77.Nm
78interface employs the address resolution protocol described in
79.Xr arp 4
80to dynamically map between Internet and Ethernet addresses on the local
81network.
82.Pp
83When a
84.Nm
85interface is brought up, by default, it will attempt to auto-negotiate the
86link speed and duplex mode.
87The speeds, in order of attempt, are:
88100Mb/s Full Duplex, 100Mb/s Half Duplex, 10 Mb/s Full Duplex, and
8910 Mb/s Half Duplex.
90.Pp
91The
92.Nm
93supports several media types, which are selected via the
94.Xr ifconfig 8
95command.
96The supported media types are:
97.Bl -tag -width indent
98.It Cm media autoselect
99Attempt to autoselect the media type (default)
100.It Cm media 100baseTX mediaopt full-duplex
101Use 100baseTX, full duplex
102.It Cm media 100baseTX Op Cm mediaopt half-duplex
103Use 100baseTX, half duplex
104.It Cm media 10baseT mediaopt full-duplex
105Use 10baseT, full duplex
106.It Cm media 10baseT Op Cm mediaopt half-duplex
107Use 10baseT, half duplex
108.El
109.Sh HARDWARE
110The
111.Nm
112driver supports the following cards:
113.Pp
114.Bl -bullet -offset indent -compact
115.It
1163Com 3CR990-TX-95
117.It
1183Com 3CR990-TX-97
119.It
1203Com 3cR990B-TXM
121.It
1223Com 3CR990SVR95
123.It
1243Com 3CR990SVR97
125.It
1263Com 3cR990B-SRV
127.El
128.Sh SEE ALSO
129.Xr arp 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
139The
140.Nm
141driver first appeared in
142.Ox 2.9 .
| 50.Sh DESCRIPTION
51The
52.Nm
53interface provides access to the 10Mb/s and 100Mb/s Ethernet networks via the
54.Tn 3Com
55.Tn Typhoon/Sidewinder
56chipset.
57.Pp
58Basic Ethernet functions are provided as well as support for
59.Xr vlan 4
60tag removal and insertion assistance, receive
61.Xr ip 4 ,
62.Xr tcp 4 ,
63and
64.Xr udp 4
65checksum offloading,
66and
67transmit
68.Xr ip 4
69checksum offloading.
70There is currently no support for
71transmit
72.Xr tcp 4
73or
74.Xr udp 4
75checksum offloading,
76.Xr tcp 4
77segmentation, nor
78.Xr ipsec 4
79acceleration.
80Note that hardware checksumming is only used when the interface is not
81in
82.Xr bridge 4
83mode.
84.Pp
85Each of the host's network addresses
86is specified at boot time with an
87.Dv SIOCSIFADDR
88.Xr ioctl 2 .
89The
90.Nm
91interface employs the address resolution protocol described in
92.Xr arp 4
93to dynamically map between Internet and Ethernet addresses on the local
94network.
95.Pp
96When a
97.Nm
98interface is brought up, by default, it will attempt to auto-negotiate the
99link speed and duplex mode.
100The speeds, in order of attempt, are:
101100Mb/s Full Duplex, 100Mb/s Half Duplex, 10 Mb/s Full Duplex, and
10210 Mb/s Half Duplex.
103.Pp
104The
105.Nm
106supports several media types, which are selected via the
107.Xr ifconfig 8
108command.
109The supported media types are:
110.Bl -tag -width indent
111.It Cm media autoselect
112Attempt to autoselect the media type (default)
113.It Cm media 100baseTX mediaopt full-duplex
114Use 100baseTX, full duplex
115.It Cm media 100baseTX Op Cm mediaopt half-duplex
116Use 100baseTX, half duplex
117.It Cm media 10baseT mediaopt full-duplex
118Use 10baseT, full duplex
119.It Cm media 10baseT Op Cm mediaopt half-duplex
120Use 10baseT, half duplex
121.El
122.Sh HARDWARE
123The
124.Nm
125driver supports the following cards:
126.Pp
127.Bl -bullet -offset indent -compact
128.It
1293Com 3CR990-TX-95
130.It
1313Com 3CR990-TX-97
132.It
1333Com 3cR990B-TXM
134.It
1353Com 3CR990SVR95
136.It
1373Com 3CR990SVR97
138.It
1393Com 3cR990B-SRV
140.El
141.Sh SEE ALSO
142.Xr arp 4 ,
143.Xr inet 4 ,
144.Xr intro 4 ,
145.Xr ip 4 ,
146.Xr miibus 4 ,
147.Xr tcp 4 ,
148.Xr udp 4 ,
149.Xr vlan 4 ,
150.Xr ifconfig 8
151.Sh HISTORY
152The
153.Nm
154driver first appeared in
155.Ox 2.9 .
|