Update man page for LMC1200 support

1 files changed, 29 insertions, 15 deletions

diff --git a/share/man/man4/lmc.4 b/share/man/man4/lmc.4
index 775eb2594c1..02618eb35b6 100644
--- a/share/man/man4/lmc.4
+++ b/share/man/man4/lmc.4
@@ -23,26 +23,38 @@
 .\" (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 July 1, 1999
+.Dd October 15th, 1999
 .Dt LMC 4
 .Os
 .Sh NAME
 .Nm lmc
 .Nd
-Lan Media Corporation SSI/HSSI/DS3 card device driver
+Lan Media Corporation SSI/DS1/HSSI/DS3 card device driver
 .Sh SYNOPSIS
 .Cd "lmc* at pci? dev ? function ?"
+.Cd "pseudo-device sppp"
 .Sh DESCRIPTION
 The
 .Nm
-driver provides support for the Lan Media Corporation SSI, HSSI, and DS3 PCI
-WAN adapters based on the DEC 21140 ethernet chip (with supporting
-chips to handle the HDLC framing, and synchronous serial interface.)  The intent
-is to provide a synchronous serial link with HDLC framing at speeds
-of up to 10Mbps (for the SSI card), 52Mbps (for the HSSI card) and DSX jacks
-for 45Mbps operation without a CSU/DSU (DS3 card).
+driver provides support for the Lan Media Corporation SSI, DS1, HSSI, and DS3
+PCI WAN adapters based on the DEC 21140 ethernet chip.  The adapters use
+a DEC 21140 ethernet chip for the PCI bus interface.  Leaving the bus
+interface chip, the data path goes through a field programmable gate array,
+where HDLC processing is accomplished.  Leaving the FPGA, there are FIFO
+buffers and the DS1, DS3, and V.35 drive circuitry.
 .Pp
-The card will automatically use HDLC framing and defaults to external clock source.  It should be configured as any point-to-point link.
+The intent is to provide a synchronous serial link with HDLC framing at speeds
+of up to 10Mbps (for the SSI card), 52Mbps (for the HSSI card), BNC connectors
+for 45Mbps operation without a CSU/DSU (DS3 card), and an RJ45 jack for
+T1/E1 operation without a CSU/DSU (DS1 card).
+.Pp
+The card will automatically use HDLC framing and defaults to external clock
+source.  For the DS1 and DS3 cards with built in CSU/DSU functionality,
+the clock source is always external (from CSU/DSU).  The ability to set cable
+length is not currently implemented.
+.Pp
+Using the sppp driver, you can also use the ppp protocol.  In either
+case, the lmc interface should be configured as a point-to-point link.
 .Pp
 .Sh DIAGNOSTICS
 .Bl -diag
@@ -63,11 +75,12 @@ The card is sending DTR and RTS signals on the line
 .It "lmc%d: deasserting DTR and RTS"
 The card is not sending DTR and RTS signals on the line
 .It "lmc%d: Abormal interrupt"
-The card received an incomplete request
+The card received an incomplete request.  This may be a sign of a hardware
+fault.
 .It "lmc%d: tx_intr: failed to dequeue mbuf?!?"
 Only available if compiled with LMC_DEBUG
 .It "lmc%d: txput: tx not running"
-Problem from tulip
+Problem from tulip,
 Only available if compiled with LMC_DEBUG
 .El
 .Sh SEE ALSO
@@ -75,6 +88,7 @@ Only available if compiled with LMC_DEBUG
 .Xr netintro 4 ,
 .Xr sppp 4 ,
 .Xr ifconfig 8
+.Pp
 Lan Media Corporation has a web site with data, descriptions, and pictures
 of their cards at www.lanmedia.com.
 .Sh HISTORY
@@ -85,8 +99,8 @@ and was later included in NetBSD 1.4.
 .Sh AUTHORS
 The
 .Nm
-device driver was written by Michael Graff.  It was initially
-derived from Matt Thomas'
+device driver was written by Michael Graff, and was derived in part from
+Matt Thomas'
 .Xr de 4
-driver.
-The OpenBSD port and manual page are from Chris Cappuccio.
+driver.  The OpenBSD port and manual page are from Chris Cappuccio.  Later
+enhancements to support the LMC1200 card are based on LMC's Linux driver.