From 603807f849156062247cca4405c2394fae45d574 Mon Sep 17 00:00:00 2001 From: drochner Date: Fri, 4 Jul 2003 16:05:47 +0000 Subject: [PATCH] add a manpage for the "txp" driver (3c990), from OpenBSD --- share/man/man4/Makefile | 4 +- share/man/man4/txp.4 | 135 ++++++++++++++++++++++++++++++++++++++++ 2 files changed, 137 insertions(+), 2 deletions(-) create mode 100644 share/man/man4/txp.4 diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile index 284e8308624b..6d90c44b0e81 100644 --- a/share/man/man4/Makefile +++ b/share/man/man4/Makefile @@ -1,4 +1,4 @@ -# $NetBSD: Makefile,v 1.288 2003/06/02 04:00:25 gmcgarry Exp $ +# $NetBSD: Makefile,v 1.289 2003/07/04 16:05:47 drochner Exp $ # @(#)Makefile 8.1 (Berkeley) 6/18/93 MAN= aac.4 acphy.4 adv.4 adw.4 agp.4 ahb.4 ahc.4 amdpm.4 \ @@ -32,7 +32,7 @@ MAN= aac.4 acphy.4 adv.4 adw.4 agp.4 ahb.4 ahc.4 amdpm.4 \ speaker.4 spp.4 sqphy.4 ss.4 st.4 ste.4 stge.4 sv.4 strip.4 systrace.4 \ tb.4 tc.4 tcds.4 tcp.4 \ termios.4 tfb.4 ti.4 tl.4 tlp.4 tlphy.4 tp.4 tr.4 trm.4 tty.4 tun.4 \ - tqphy.4 twe.4 \ + tqphy.4 twe.4 txp.4 \ udp.4 uha.4 uk.4 ukphy.4 unix.4 userconf.4 verifiedexec.4 vga.4 \ vlan.4 vmmon.4 vmnet.4 vnd.4 \ vr.4 wd.4 wdc.4 wi.4 wm.4 \ diff --git a/share/man/man4/txp.4 b/share/man/man4/txp.4 new file mode 100644 index 000000000000..bd72cf1373ee --- /dev/null +++ b/share/man/man4/txp.4 @@ -0,0 +1,135 @@ +.\" $NetBSD: txp.4,v 1.1 2003/07/04 16:05:47 drochner Exp $ +.\" +.\" Copyright (c) 2001 Jason L. Wright (jason@thought.net) +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +.\" DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, +.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES +.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, +.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN +.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +.\" POSSIBILITY OF SUCH DAMAGE. +.\" +.Dd April 15, 2001 +.Dt TXP 4 +.Os +.Sh NAME +.Nm txp +.Nd 3Com 3XP Typhoon/Sidewinder (3CR990) Ethernet interface +.Sh SYNOPSIS +.Cd "txp* at pci? dev ? function ?" +.Sh DESCRIPTION +The +.Nm +interface provides access to the 10Mb/s and 100Mb/s Ethernet networks via the +.Tn 3Com +.Tn Typhoon/Sidewinder +chipset. +This driver supports the following cards: +.Pp +.Bl -bullet -offset indent -compact +.It +3Com 3CR990-TX-95 +.It +3Com 3CR990-TX-97 +.It +3Com 3CR990SVR95 +.It +3Com 3CR990SVR97 +.El +.Pp +Basic Ethernet functions are provided as well as support for +.\" .Xr vlan 4 +.\" tag removal and insertion assistance, +receive +.Xr ip 4 , +.Xr tcp 4 , +and +.Xr udp 4 +checksum offloading, +and +transmit +.Xr ip 4 +checksum offloading. +There is currently no support for +transmit +.Xr tcp 4 +or +.Xr udp 4 +checksum offloading, +.Xr tcp 4 +segmentation, nor +.Xr ipsec 4 +acceleration. +Note that hardware checksumming is only used when the interface is not +in +.Xr bridge 4 +mode. +.Pp +Each of the host's network addresses +is specified at boot time with an +.Dv SIOCSIFADDR +.Xr ioctl 2 . +The +.Nm +interface employs the address resolution protocol described in +.Xr arp 4 +to dynamically map between Internet and Ethernet addresses on the local +network. +.Pp +When a +.Nm +interface is brought up, by default, it will attempt to auto-negotiate the +link speed and duplex mode. +The speeds, in order of attempt, are: 100Mb/s Full Duplex, 100Mb/s Half Duplex, +10 Mb/s Full Duplex, and 10 Mb/s Half Duplex. +.Pp +The +.Nm +supports several media types, which are selected via the +.Xr ifconfig 8 +command. +The supported media types are: +.Bl -tag -width xxxxxxxxxxxxxx -offset indent +.It media autoselect +Attempt to autoselect the media type (default) +.It media 100baseTX mediaopt full-duplex +Use 100baseTX, full duplex +.It media 100baseTX Op mediaopt half-duplex +Use 100baseTX, half duplex +.It media 10baseT mediaopt full-duplex +Use 10baseT, full duplex +.It media 10baseT Op mediaopt half-duplex +Use 10baseT, half duplex +.El +.Sh SEE ALSO +.Xr arp 4 , +.Xr ifmedia 4 , +.Xr inet 4 , +.Xr intro 4 , +.Xr ip 4 , +.Xr netintro 4 , +.Xr pci 4 , +.Xr tcp 4 , +.Xr udp 4 , +.Xr vlan 4 , +.Xr ifconfig 8 +.Sh HISTORY +The +.Nm +driver first appeared in +.Nx 2.0 .