man page for tx... borrwed from hme and FreeBSD manpages

2 files changed, 127 insertions, 3 deletions

diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile
index 710d8e107d0..76f941aef01 100644
--- a/share/man/man4/Makefile
+++ b/share/man/man4/Makefile
@@ -1,4 +1,4 @@
-#	$OpenBSD: Makefile,v 1.43 1998/09/09 22:10:58 jason Exp $
+#	$OpenBSD: Makefile,v 1.44 1998/09/21 17:11:06 jason Exp $
 #	$NetBSD: Makefile,v 1.22.4.2 1996/07/18 00:51:10 jtc Exp $
 
 MAN=	atalk.4 audio.4 acd.4 ahc.4 bpf.4 ccd.4 cd.4 ch.4 clnp.4 cltp.4 ddb.4 \
@@ -7,8 +7,8 @@ MAN=	atalk.4 audio.4 acd.4 ahc.4 bpf.4 ccd.4 cd.4 ch.4 clnp.4 cltp.4 ddb.4 \
 	ksyms.4 lkm.4 lo.4 mtio.4 ncr.4 netintro.4 ns.4 \
 	nsip.4 null.4 options.4 pty.4 random.4 route.4 scsi.4 sd.4 sl.4 \
 	spp.4 st.4 sv.4 \
-	tb.4 tcp.4 termios.4 tty.4 tp.4 tun.4 udp.4 uk.4 unix.4 vnd.4 wd.4 \
-	xl.4 ym.4
+	tb.4 tcp.4 termios.4 tty.4 tp.4 tun.4 tx.4 udp.4 uk.4 unix.4 vnd.4 \
+	wd.4 xl.4 ym.4
 MLINKS+=fd.4 stderr.4 fd.4 stdin.4 fd.4 stdout.4
 MLINKS+=netintro.4 networking.4
 MLINKS+=random.4 srandom.4 random.4 urandom.4 random.4 prandom.4 
diff --git a/share/man/man4/tx.4 b/share/man/man4/tx.4
new file mode 100644
index 00000000000..aa2b5f9c13a
--- /dev/null
+++ b/share/man/man4/tx.4
@@ -0,0 +1,124 @@
+.\"     $OpenBSD: tx.4,v 1.1 1998/09/21 17:11:06 jason Exp $
+.\"
+.\" Copyright (c) 1998 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.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"      This product includes software developed by Jason L. Wright
+.\" 4. The name of the author may not be used to endorse or promote products
+.\"    derived from this software without specific prior written permission.
+.\"
+.\" 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 September 21, 1998
+.Dt TX 4
+.Os OpenBSD
+.Sh NAME
+.Nm tx
+.Nd
+SMC 9432 10/100 Mbps Ethernet device driver
+.Sh SYNOPSIS
+.Cd "tx* at pci? dev ? function ?"
+.Sh DESCRIPTION
+The 
+.Nm
+interface provides access to the 10Mb/s and 100Mb/s Ethernet networks via the
+.Tn SMC
+.Tn EPIC
+chipset.
+This driver provides support for the
+.Tn SMC
+.Tn EtherPower II 10/100
+Ethernet cards.
+.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.  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 100baseTX mediaopt loopback
+Put the interface into loopback mode
+.It media 10baseT mediaopt full-duplex
+Use 10baseT, full duplex
+.It media 10baseT Op mediaopt half-duplex
+Use 10baseT, half duplex
+.It media 10baseT mediaopt loopback
+Put the interface into loopback mode
+.El
+.Sh DIAGNOSTICS
+.Bl -diag
+.It "tx%d: device timeout %d packets"
+The device stopped responding. Device and driver reset follows this error.
+.It "tx%d: PCI fatal error occured (%s)"
+One of following errors occured: PCI Target Abort, PCI Master Abort, Data
+Parity Error or Address Parity Error. Device and driver reset follows
+this error.
+.It "tx%d: WARNING! no link established"
+No media connected. Displayed at startup only.
+.It "tx%d: cannot allocate mbuf header/cluster"
+Failed to allocate memory for a received packet. Packet was dropped.
+.It "tx%d: can't stop %s DMA"
+While resetting, the driver failed to stop the device correctly. 
+.El
+.Sh SEE ALSO
+.Xr ifconfig 8 ,
+.Xr ifmedia 4 ,
+.Xr intro 4 ,
+.Xr inet 4 ,
+.Xr arp 4
+.Sh BUGS
+.Pp
+The multicast packets filtering is not supported.
+Only one PHY has really been tested,
+.Tn Quality Semiconductor QS6612 .
+.Sh HISTORY
+.Ox
+support for the
+.Nm
+first appeared in
+.Ox 2.4 .