steal manpages from mvme88k

9 files changed, 256 insertions, 22 deletions

diff --git a/share/man/man4/man4.aviion/Makefile b/share/man/man4/man4.aviion/Makefile
index a7a1562b95f..e0387f10b69 100644
--- a/share/man/man4/man4.aviion/Makefile
+++ b/share/man/man4/man4.aviion/Makefile
@@ -1,7 +1,6 @@
-#	$OpenBSD: Makefile,v 1.2 2013/10/15 01:41:44 miod Exp $
+#	$OpenBSD: Makefile,v 1.3 2013/10/15 18:13:53 miod Exp $
 
-# TODO: clock dart nvram syscon vme
-MAN=	autoconf.4 intro.4 le.4 mem.4 oaic.4
+MAN=	autoconf.4 dart.4 intro.4 le.4 mem.4 nvram.4 oaic.4 syscon.4 vme.4
 MANSUBDIR=aviion
 
 MLINKS+= mem.4 kmem.4
diff --git a/share/man/man4/man4.aviion/dart.4 b/share/man/man4/man4.aviion/dart.4
new file mode 100644
index 00000000000..d8481ceda74
--- /dev/null
+++ b/share/man/man4/man4.aviion/dart.4
@@ -0,0 +1,54 @@
+.\"	$OpenBSD: dart.4,v 1.1 2013/10/15 18:13:53 miod Exp $
+.\"
+.\" Copyright (c) 2013 Miodrag Vallat.
+.\"
+.\" Permission to use, copy, modify, and distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+.\"
+.Dd $Mdocdate: October 15 2013 $
+.Dt DART 4 aviion
+.Os
+.Sh NAME
+.Nm dart
+.Nd MC68681 or MC68692 dual UART
+.Sh SYNOPSIS
+.Cd "dart0 at syscon0 offset 0x82000"
+.Cd "dart1 at syscon0 offset 0x82c00"
+.Sh DESCRIPTION
+The MC68681 and MC68692 dual asynchronous receiver/transmitter
+.Pq Tn DUART
+component provides two serial ports, as well as a 16-bit programmable
+counter/timer.
+.Pp
+The
+.Nm
+driver provides support for the two serial ports found onboard all
+AViiON systems.
+.Pp
+The
+.Nm
+serial ports have a two character buffer on the transmit path, and a four
+character buffer on the receive path.
+.Pp
+The following link speeds are supported by the
+.Nm
+driver:
+50, 75, 110, 134.5, 150, 200, 300, 600, 1050, 1200, 1800, 200, 2400, 4800,
+7200, 9600, 19200 and 38400 bps.
+.Sh FILES
+.Bl -tag -width Pa -compact
+.It Pa /dev/tty[ab] dart0 serial ports
+.It Pa /dev/tty[cd] dart1 serial ports
+.El
+.Sh SEE ALSO
+.Xr intro 4 ,
+.Xr tty 4
diff --git a/share/man/man4/man4.aviion/intro.4 b/share/man/man4/man4.aviion/intro.4
index 97663abc0cd..bd92407e4c1 100644
--- a/share/man/man4/man4.aviion/intro.4
+++ b/share/man/man4/man4.aviion/intro.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: intro.4,v 1.6 2013/06/29 16:57:33 jmc Exp $
+.\"	$OpenBSD: intro.4,v 1.7 2013/10/15 18:13:53 miod Exp $
 .\" Copyright (c) 1990, 1991 Regents of the University of California.
 .\" All rights reserved.
 .\"
@@ -28,7 +28,7 @@
 .\"
 .\"     from: @(#)intro.4	5.2 (Berkeley) 3/27/91
 .\"
-.Dd $Mdocdate: June 29 2013 $
+.Dd $Mdocdate: October 15 2013 $
 .Dt INTRO 4 aviion
 .Os
 .Sh NAME
@@ -58,7 +58,7 @@ The networking support is introduced in
 .Xr netintro 4 .
 .Sh DEVICE SUPPORT
 This section describes the hardware supported on the
-aviion platform.
+AViiON platform.
 Software support for these devices comes in two forms.
 A hardware device may be supported with a character or block
 .Em device driver ,
@@ -92,12 +92,21 @@ Pseudo-devices are not listed.
 Devices are indicated by their functional interface.
 Not all supported devices are listed.
 .Pp
-.Bl -tag -compact -width "pcctwo(4)"
-.\" dart
+.Bl -tag -compact -width 9n
+.It Xr dart 4
+MC68681 or MC68692 dual UART
 .It Xr le 4
-AMD LANCE Ethernet device
-.\" syscon
-.\" vme
+AMD LANCE or ILACC Ethernet device
+.It Xr nvram 4
+Mostek MK48T0x battery-backed realtime clock
+.It Xr oaic 4
+Adaptec AIC-6250 SCSI interface
+.It Xr oosiop 4
+Symbios/NCR 53C700 SCSI driver
+.It Xr syscon 4
+VME system controller
+.Ir Xr vme 4
+VMEbus interface
 .El
 .Sh SEE ALSO
 .Xr autoconf 4 ,
diff --git a/share/man/man4/man4.aviion/le.4 b/share/man/man4/man4.aviion/le.4
index 44100e79bb5..2e4e92dec5f 100644
--- a/share/man/man4/man4.aviion/le.4
+++ b/share/man/man4/man4.aviion/le.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: le.4,v 1.5 2013/09/24 20:14:36 miod Exp $
+.\"	$OpenBSD: le.4,v 1.6 2013/10/15 18:13:53 miod Exp $
 .\"
 .\" Copyright (c) 2003 Paul Weissmann
 .\" All rights reserved.
@@ -25,12 +25,12 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: September 24 2013 $
+.Dd $Mdocdate: October 15 2013 $
 .Dt LE 4 aviion
 .Os
 .Sh NAME
 .Nm le
-.Nd AMD LANCE Ethernet device
+.Nd AMD LANCE or ILACC Ethernet device
 .Sh SYNOPSIS
 .Cd "le0 at syscon? offset 0x8c000              " Pq "on-board, AV4000 family"
 .Cd "le0 at syscon? offset 0xb0100              " Pq "on-board, AV530 family"
@@ -43,8 +43,8 @@
 .Sh DESCRIPTION
 The
 .Nm
-driver provides access to the on-board AMD 7990/LANCE interface,
-as well as the VME Interphase 3207 Hawk Ethernet boards.
+driver provides access to the on-board AMD 7990/LANCE or AMD 79900/ILACC
+interface, as well as the VME Interphase 3207 Hawk Ethernet boards.
 This in turn provides an interface to the
 .Tn Ethernet
 network.
@@ -81,6 +81,6 @@ network.
 .Xr inet 4 ,
 .Xr intro 4 ,
 .Xr netintro 4 ,
-.\" .Xr vme 4 ,
+.Xr vme 4 ,
 .Xr hostname.if 5 ,
 .Xr ifconfig 8
diff --git a/share/man/man4/man4.aviion/mem.4 b/share/man/man4/man4.aviion/mem.4
index 673ac5079f4..9d4df8c67d4 100644
--- a/share/man/man4/man4.aviion/mem.4
+++ b/share/man/man4/man4.aviion/mem.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: mem.4,v 1.2 2007/05/31 19:19:53 jmc Exp $
+.\"	$OpenBSD: mem.4,v 1.3 2013/10/15 18:13:53 miod Exp $
 .\" Copyright (c) 1992, 1993
 .\"	The Regents of the University of California.  All rights reserved.
 .\"
@@ -32,7 +32,7 @@
 .\"
 .\"     from: @(#)mem.4	8.1 (Berkeley) 6/5/93
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: October 15 2013 $
 .Dt MEM 4 aviion
 .Os
 .Sh NAME
@@ -57,7 +57,7 @@ in the same manner as
 .Pa /dev/mem .
 Only kernel virtual addresses that are currently mapped to memory are allowed.
 .Pp
-On the aviion, physical memory is always contiguous;
+On the AViiON, physical memory is always contiguous;
 kernel virtual memory begins at
 .Ad 0x00000000 .
 .Pp
diff --git a/share/man/man4/man4.aviion/nvram.4 b/share/man/man4/man4.aviion/nvram.4
new file mode 100644
index 00000000000..cb6d959f68f
--- /dev/null
+++ b/share/man/man4/man4.aviion/nvram.4
@@ -0,0 +1,52 @@
+.\"	$OpenBSD: nvram.4,v 1.1 2013/10/15 18:13:53 miod Exp $
+.\"
+.\" Copyright (c) 2013 Miodrag Vallat.
+.\"
+.\" Permission to use, copy, modify, and distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+.\"
+.Dd $Mdocdate: October 15 2013 $
+.Dt NVRAM 4 aviion
+.Os
+.Sh NAME
+.Nm nvram
+.Nd Mostek MK48T0x battery-backed realtime clock
+.Sh SYNOPSIS
+.Cd "nvram0  at syscon0 offset 0x80000"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for the
+Mostek MK48T02 realtime clocks chip.
+.Pp
+In addition to the clock itself, this chip embed 2KB
+of battery-backed memory, which is accessible through the special
+.Pa /dev/nvram0
+file.
+.Sh FILES
+.Bl -tag -width Pa -compact
+.It Pa /dev/nvram0
+.El
+.Sh SEE ALSO
+.Xr intro 4 ,
+.Xr syscon 4
+.Sh CAVEATS
+The last 8 bytes of the battery-backed memory contains the realtime clock
+registers.
+Writing to these locations will interfere with proper clock operation.
+.Pp
+Most, if not all, of the battery-backed memory is used by DG/UX to store
+some of its configuration data, and may be reinitialized by the PROM
+if it considers the memory contents as invalid.
+The
+.Nm
+driver does not prevent access to this reserved part.
diff --git a/share/man/man4/man4.aviion/oaic.4 b/share/man/man4/man4.aviion/oaic.4
index 363577cd4b2..c8fe2dbebbe 100644
--- a/share/man/man4/man4.aviion/oaic.4
+++ b/share/man/man4/man4.aviion/oaic.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: oaic.4,v 1.1 2013/10/15 01:41:45 miod Exp $
+.\"	$OpenBSD: oaic.4,v 1.2 2013/10/15 18:13:53 miod Exp $
 .\"	OpenBSD: aic.4,v 1.8 2012/08/14 01:08:19 dlg Exp
 .\"	$NetBSD: aic.4,v 1.5 1998/06/07 09:08:45 enami Exp $
 .\"
@@ -49,5 +49,5 @@ controller chips.
 .Xr scsi 4 ,
 .Xr sd 4 ,
 .Xr st 4 ,
-.\" .Xr syscon 4 ,
+.Xr syscon 4 ,
 .Xr uk 4
diff --git a/share/man/man4/man4.aviion/syscon.4 b/share/man/man4/man4.aviion/syscon.4
new file mode 100644
index 00000000000..b4641f5ebf7
--- /dev/null
+++ b/share/man/man4/man4.aviion/syscon.4
@@ -0,0 +1,63 @@
+.\"	$OpenBSD: syscon.4,v 1.1 2013/10/15 18:13:53 miod Exp $
+.\"
+.\" Copyright (c) 2008 Miodrag Vallat.
+.\"
+.\" Permission to use, copy, modify, and distribute this software for any
+.\" purpose with or without fee is hereby granted, provided that the above
+.\" copyright notice and this permission notice appear in all copies. And
+.\" I won't mind if you keep the disclaimer below.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+.\"
+.Dd $Mdocdate: October 15 2013 $
+.Dt SYSCON 4 aviion
+.Os
+.Sh NAME
+.Nm syscon
+.Nd VME system controller
+.Sh SYNOPSIS
+.Cd "syscon0 at mainbus0 addr 0xfff00000"
+.Cd "nvram0  at syscon0 offset 0x80000"
+.Cd "dart0   at syscon0 offset 0x82000"
+.Cd "dart1   at syscon0 offset 0x82c00"
+.Cd "vme0    at syscon0 offset 0x85000"
+.Cd "oaic0   at syscon0 offset 0x8a000"
+.Cd "le0     at syscon0 offset 0x8c000"
+.Cd "oosiop0 at syscon0 offset 0xb0000"
+.Cd "oosiop1 at syscon0 offset 0xb0080"
+.Cd "le0     at syscon0 offset 0xb0100"
+.Cd "le1     at syscon0 offset 0xb0140"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides an interface to the different local bus-attached I/O
+devices found on AViiON systems.
+.Pp
+The devices which may be connected to
+.Nm
+are:
+.Pp
+.Bl -tag -compact -width 9n -offset indent
+.It Xr dart 4
+MC68681 or MC68692 dual UART
+.It Xr le 4
+AMD LANCE or ILACC Ethernet device
+.It Xr nvram 4
+Mostek MK48T0x battery-backed realtime clock
+.It Xr oaic 4
+Adaptec AIC-6250 SCSI interface
+.It Xr oosiop 4
+Symbios/NCR 53C700 SCSI driver
+.It Xr syscon 4
+VME system controller
+.Ir Xr vme 4
+VMEbus interface
+.El
+.Sh SEE ALSO
+.Xr intro 4
diff --git a/share/man/man4/man4.aviion/vme.4 b/share/man/man4/man4.aviion/vme.4
new file mode 100644
index 00000000000..a3afb7a1931
--- /dev/null
+++ b/share/man/man4/man4.aviion/vme.4
@@ -0,0 +1,57 @@
+.\"	$OpenBSD: vme.4,v 1.1 2013/10/15 18:13:54 miod Exp $
+.\"
+.\" Copyright (c) 2003 Paul Weissmann
+.\" 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 REGENTS AND CONTRIBUTORS ``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 REGENTS OR CONTRIBUTORS 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 $Mdocdate: October 15 2013 $
+.Dt VME 4 aviion
+.Os
+.Sh NAME
+.Nm vme
+.Nd VMEbus interface
+.Sh SYNOPSIS
+.Cd "vme0   at syscon0    offset 0x85000"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides access to the VMEbus, operating the VMEbus part of the
+.Xr syscon 4
+device.
+.Pp
+The currently supported VMEbus drivers are:
+.Pp
+.Bl -tag -compact -width 10n -offset indent
+.It Xr le 4
+MVME376 AMD LANCE Ethernet device
+.\" .It Xr vs 4
+.\" MVME328, MVME328S and MVME328XT high performance SCSI controller
+.\" .It Xr vsbic 4
+.\" MVME327A SCSI and floppy controller
+.\" .It Xr vx 4
+.\" MVME332XT high performance serial I/O controller
+.El
+.Sh SEE ALSO
+.Xr intro 4 ,
+.Xr syscon 4