summaryrefslogtreecommitdiff
path: root/static/netbsd/man4/man4.sun3
diff options
context:
space:
mode:
authorJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 15:32:58 -0400
committerJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 15:32:58 -0400
commit5cb84ec742fd33f78c8022863fadaa8d0d93e176 (patch)
tree1a81ca3665e6153923e40db7b0d988f8573ab59c /static/netbsd/man4/man4.sun3
parenta59214f344567c037d5776879bcfc5fcc1d4d5f6 (diff)
feat: Added NetBSD man pages
Diffstat (limited to 'static/netbsd/man4/man4.sun3')
-rw-r--r--static/netbsd/man4/man4.sun3/Makefile4
-rw-r--r--static/netbsd/man4/man4.sun3/autoconf.468
-rw-r--r--static/netbsd/man4/man4.sun3/bwtwo.452
-rw-r--r--static/netbsd/man4/man4.sun3/cgfour.452
-rw-r--r--static/netbsd/man4/man4.sun3/cgtwo.454
-rw-r--r--static/netbsd/man4/man4.sun3/fd.4117
-rw-r--r--static/netbsd/man4/man4.sun3/ie.469
-rw-r--r--static/netbsd/man4/man4.sun3/intro.4174
-rw-r--r--static/netbsd/man4/man4.sun3/kbd.4180
-rw-r--r--static/netbsd/man4/man4.sun3/leds.4107
-rw-r--r--static/netbsd/man4/man4.sun3/mem.475
-rw-r--r--static/netbsd/man4/man4.sun3/ms.498
12 files changed, 1050 insertions, 0 deletions
diff --git a/static/netbsd/man4/man4.sun3/Makefile b/static/netbsd/man4/man4.sun3/Makefile
new file mode 100644
index 00000000..67434962
--- /dev/null
+++ b/static/netbsd/man4/man4.sun3/Makefile
@@ -0,0 +1,4 @@
+MAN = $(wildcard *.4)
+
+include ../../../mandoc.mk
+
diff --git a/static/netbsd/man4/man4.sun3/autoconf.4 b/static/netbsd/man4/man4.sun3/autoconf.4
new file mode 100644
index 00000000..8f70fb27
--- /dev/null
+++ b/static/netbsd/man4/man4.sun3/autoconf.4
@@ -0,0 +1,68 @@
+.\" $NetBSD: autoconf.4,v 1.10 2024/09/07 19:13:28 rillig Exp $
+.\"
+.\" Copyright (c) 1994 Christopher G. Demetriou
+.\" 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 for the
+.\" NetBSD Project. See https://www.NetBSD.org/ for
+.\" information about NetBSD.
+.\" 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.
+.\"
+.\" <<Id: LICENSE,v 1.2 2000/06/14 15:57:33 cgd Exp>>
+.\"
+.Dd February 17, 2017
+.Dt AUTOCONF 4 sun3
+.Os
+.Sh NAME
+.Nm autoconf
+.Nd diagnostics from the autoconfiguration code
+.Sh DESCRIPTION
+When
+.Nx
+bootstraps it probes the innards of the machine
+on which it is running
+and locates controllers, drives, and other devices, printing out
+what it finds on the console. This procedure is driven by a system
+configuration table which is processed by
+.Xr config 1
+and compiled into each kernel.
+Devices which exist in the machine but are not configured into the
+kernel are not detected.
+.Sh DIAGNOSTICS
+.Bl -diag
+.It CPU class not configured.
+You tried to boot
+.Nx
+on a class of
+.Tn CPU
+type which it doesn't
+(or at least this compiled version of
+.Nx
+doesn't) understand.
+.El
+.Sh SEE ALSO
+.Xr config 1 ,
+.Xr sun3/intro 4 ,
+.Xr boot 8
diff --git a/static/netbsd/man4/man4.sun3/bwtwo.4 b/static/netbsd/man4/man4.sun3/bwtwo.4
new file mode 100644
index 00000000..a4b1c91b
--- /dev/null
+++ b/static/netbsd/man4/man4.sun3/bwtwo.4
@@ -0,0 +1,52 @@
+.\" Copyright (c) 1992, 1993
+.\" The Regents of the University of California. All rights reserved.
+.\"
+.\" This software was developed by the Computer Systems Engineering group
+.\" at Lawrence Berkeley Laboratory under DARPA contract BG 91-66 and
+.\" contributed to Berkeley.
+.\"
+.\" 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. Neither the name of the University nor the names of its contributors
+.\" may be used to endorse or promote products derived from this software
+.\" without specific prior written permission.
+.\"
+.\" 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.
+.\"
+.\" from: Header: bwtwo.4,v 1.3 94/02/03 20:42:13 leres Exp
+.\" from: @(#)bwtwo.4 8.2 (Berkeley) 2/16/94
+.\" $NetBSD: bwtwo.4,v 1.7 2017/02/17 22:24:47 christos Exp $
+.\"
+.Dd February 17, 2017
+.Dt BWTWO 4 sun3
+.Os
+.Sh NAME
+.Nm bwtwo
+.Nd Sun monochromatic frame buffer
+.Sh SYNOPSIS
+.Cd "bwtwo0 at obmem0 addr ?"
+.Sh DESCRIPTION
+The
+.Nm
+is a memory based black and white frame buffer.
+It supports the minimal ioctl's needed to run
+.Ic X .
+.Sh SEE ALSO
+.Xr sun3/cgfour 4 ,
+.Xr sun3/cgtwo 4
diff --git a/static/netbsd/man4/man4.sun3/cgfour.4 b/static/netbsd/man4/man4.sun3/cgfour.4
new file mode 100644
index 00000000..05ca0818
--- /dev/null
+++ b/static/netbsd/man4/man4.sun3/cgfour.4
@@ -0,0 +1,52 @@
+.\" Copyright (c) 1992, 1993
+.\" The Regents of the University of California. All rights reserved.
+.\"
+.\" This software was developed by the Computer Systems Engineering group
+.\" at Lawrence Berkeley Laboratory under DARPA contract BG 91-66 and
+.\" contributed to Berkeley.
+.\"
+.\" 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. Neither the name of the University nor the names of its contributors
+.\" may be used to endorse or promote products derived from this software
+.\" without specific prior written permission.
+.\"
+.\" 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.
+.\"
+.\" from: Header: cgthree.4,v 1.3 94/02/03 20:49:52 leres Exp
+.\" from: @(#)cgthree.4 8.2 (Berkeley) 2/16/94
+.\" $NetBSD: cgfour.4,v 1.6 2017/02/17 22:24:47 christos Exp $
+.\"
+.Dd February 17, 2017
+.Dt CGFOUR 4 sun3
+.Os
+.Sh NAME
+.Nm cgfour
+.Nd Sun 8-bit color frame buffer
+.Sh SYNOPSIS
+.Cd "cgfour0 at obmem0 addr ?"
+.Sh DESCRIPTION
+The
+.Nm
+is a memory based color frame buffer.
+It supports the minimal ioctl's needed to run
+.Ic X .
+.Sh SEE ALSO
+.Xr sun3/bwtwo 4 ,
+.Xr sun3/cgtwo 4
diff --git a/static/netbsd/man4/man4.sun3/cgtwo.4 b/static/netbsd/man4/man4.sun3/cgtwo.4
new file mode 100644
index 00000000..b155cc02
--- /dev/null
+++ b/static/netbsd/man4/man4.sun3/cgtwo.4
@@ -0,0 +1,54 @@
+.\" Copyright (c) 1992, 1993
+.\" The Regents of the University of California. All rights reserved.
+.\"
+.\" This software was developed by the Computer Systems Engineering group
+.\" at Lawrence Berkeley Laboratory under DARPA contract BG 91-66 and
+.\" contributed to Berkeley.
+.\"
+.\" 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. Neither the name of the University nor the names of its contributors
+.\" may be used to endorse or promote products derived from this software
+.\" without specific prior written permission.
+.\"
+.\" 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.
+.\"
+.\" from: Header: cgthree.4,v 1.3 94/02/03 20:49:52 leres Exp
+.\" from: @(#)cgthree.4 8.2 (Berkeley) 2/16/94
+.\" $NetBSD: cgtwo.4,v 1.6 2017/02/17 22:24:47 christos Exp $
+.\"
+.Dd February 17, 2017
+.Dt CGTWO 4 sun3
+.Os
+.Sh NAME
+.Nm cgtwo
+.Nd Sun 8-bit VME bus color frame buffer
+.Sh SYNOPSIS
+.Cd "cgtwo0 at vme2 addr 0x400000 ipl 4 vect 0xA8"
+.Sh DESCRIPTION
+The
+.Nm
+is a memory based,
+.Tn VME
+bus, color frame buffer.
+It supports the minimal ioctl's needed to run
+.Ic X .
+.Sh SEE ALSO
+.Xr sun3/bwtwo 4 ,
+.Xr sun3/cgfour 4
diff --git a/static/netbsd/man4/man4.sun3/fd.4 b/static/netbsd/man4/man4.sun3/fd.4
new file mode 100644
index 00000000..6ce938d6
--- /dev/null
+++ b/static/netbsd/man4/man4.sun3/fd.4
@@ -0,0 +1,117 @@
+.\" $NetBSD: fd.4,v 1.11 2010/03/22 18:58:31 joerg Exp $
+.\"
+.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Paul Kranenburg.
+.\"
+.\" 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 NETBSD FOUNDATION, INC. 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 FOUNDATION 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 June 23, 1996
+.Dt FD 4 sun3
+.Os
+.Sh NAME
+.Nm fd
+.Nd Sun 3/80 i82027 floppy disk drive controller driver
+.Sh SYNOPSIS
+.Cd "fdc0 at obio0" Pq sun3x
+.Cd "fd* at fdc0"
+.Sh DESCRIPTION
+The
+.Nm
+driver is for the built-in floppy diskette drive run by the
+.Tn Intel
+i82027 controller found on the Sun 3/80.
+.Pp
+Bits
+.Bq 0-3
+of the minor device number of the special files referring to this
+device encode the floppy density as follows:
+.Bl -tag -width indent -offset indent
+.It 0
+3.5'' 1.44MB floppy diskettes.
+.It 1
+3.5'' 720KB floppy diskettes.
+.It 2
+3.5'' 360KB floppy diskettes.
+.It 3
+3.5'' 1.2MB/NEC Japanese format floppy diskettes.
+.El
+.Sh FORMATTING
+The driver supports floppy disk formatting using the interfaces in
+.In sys/fdio.h :
+.Pp
+.Bl -tag -width FDIOCFORMAT_TRACK -compact
+.It Dv FDIOCGETFORMAT Fa struct fdformat_parms
+Fetch current formatting parameters.
+This gets the default parameters
+for the open device if no parameters have been set during the session.
+.Pp
+.It Dv FDIOCSETFORMAT Fa struct fdformat_parms
+Set formatting parameters.
+The driver saves this state and it persists while the device is open.
+.Pp
+.It Dv FDIOCFORMAT_TRACK Fa struct fdformat_cmd
+Format a track on the medium.
+If this call returns
+.Er EINVAL ,
+the track formatting parameters were out of range for the medium.
+If it returns
+.Er EIO ,
+there was a medium error while formatting the track.
+.Pp
+.It Dv FDIOCSETOPTS Fa int
+Set driver options which persist until the device is closed.
+The
+options should be the logical OR of the desired values below:
+.Pp
+.Bl -tag -width FDOPT_NORETRY -compact
+.It Dv FDOPT_NORETRY
+Do not retry operations on failure
+.It Dv FDOPT_SILENT
+Do not print error messages to the console
+.El
+.Pp
+.It Dv FDIOCGETOPTS Fa int
+Fetch drive options.
+.El
+.Pp
+A typical use of the formatting facilities would be to open the device,
+call
+.Dv FDIOCGETFORMAT
+to fetch the current format parameters, perhaps
+change a parameter or two, display the formatting details to the user,
+and then call
+.Dv FDIOCSETFORMAT
+followed by a series of calls to
+.Dv FDIOCFORMAT_TRACK .
+.Sh SEE ALSO
+.Xr eject 1 ,
+.Xr fdformat 1
+.Sh HISTORY
+The
+.Nm
+formatting support appeared in
+.Nx 1.3 .
+.Sh BUGS
+Formatting appears to not work reliably on all machines.
diff --git a/static/netbsd/man4/man4.sun3/ie.4 b/static/netbsd/man4/man4.sun3/ie.4
new file mode 100644
index 00000000..50cc7f33
--- /dev/null
+++ b/static/netbsd/man4/man4.sun3/ie.4
@@ -0,0 +1,69 @@
+.\" Copyright (c) 1992, 1993
+.\" The Regents of the University of California. All rights reserved.
+.\"
+.\" This software was developed by the Computer Systems Engineering group
+.\" at Lawrence Berkeley Laboratory under DARPA contract BG 91-66 and
+.\" contributed to Berkeley.
+.\"
+.\" 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. Neither the name of the University nor the names of its contributors
+.\" may be used to endorse or promote products derived from this software
+.\" without specific prior written permission.
+.\"
+.\" 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.
+.\"
+.\" from: Header: le.4,v 1.2 92/10/13 05:31:33 leres Exp
+.\" from: @(#)le.4 8.1 (Berkeley) 6/9/93
+.\" $NetBSD: ie.4,v 1.7 2017/02/18 22:39:01 wiz Exp $
+.\"
+.Dd February 17, 2017
+.Dt IE 4 sun3
+.Os
+.Sh NAME
+.Nm ie
+.Nd Intel 82586 Ethernet interface driver
+.Sh SYNOPSIS
+.Cd "ie0 at obio0 addr 0x0C0000 ipl 3"
+.Cd "ie1 at vme2 addr 0xe88000 ipl 3 vect 0x75"
+.Cd "ie* at sebuf?"
+.Sh DESCRIPTION
+The
+.Nm
+interface provides access to the 10 Mb/s
+.Tn Ethernet
+network via the
+.Tn Intel
+82586 Ethernet chip set.
+.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
+.Tn Ethernet
+addresses on the local network.
+.Sh SEE ALSO
+.Xr arp 4 ,
+.Xr inet 4 ,
+.Xr le 4 ,
+.Xr sun3/intro 4
diff --git a/static/netbsd/man4/man4.sun3/intro.4 b/static/netbsd/man4/man4.sun3/intro.4
new file mode 100644
index 00000000..897231cf
--- /dev/null
+++ b/static/netbsd/man4/man4.sun3/intro.4
@@ -0,0 +1,174 @@
+.\"
+.\" Copyright (c) 1996 Jonathan Stone.
+.\" 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 Jonathan Stone.
+.\" 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.
+.\"
+.\" $NetBSD: intro.4,v 1.12 2017/02/18 22:39:01 wiz Exp $
+.\"
+.Dd February 17, 2017
+.Dt INTRO 4 sun3
+.Os
+.Sh NAME
+.Nm intro
+.Nd introduction to sun3 special files and hardware support
+.Sh DESCRIPTION
+This section describes the special files, related driver functions,
+and networking support
+available in the system.
+In this part of the manual, the
+.Tn SYNOPSIS
+section of
+each configurable device gives a sample specification
+for use in constructing a system description for the
+.Xr config 1
+program.
+The
+.Tn DIAGNOSTICS
+section lists messages which may appear on the console
+and/or in the system error log
+.Pa /var/log/messages
+due to errors in device operation;
+see
+.Xr syslogd 8
+for more information.
+.Pp
+This section contains both devices
+which may be configured into the system
+and network related information.
+The networking support is introduced in
+.Xr netintro 4 .
+.Sh DEVICE SUPPORT
+This section describes the hardware supported on the Sun3
+platform.
+Software support for these devices comes in two forms. A hardware
+device may be supported with a character or block
+.Em device driver ,
+or it may be used within the networking subsystem and have a
+.Em network interface driver .
+Block and character devices are accessed through files in the file
+system of a special type; see
+.Xr mknod 8 .
+Network interfaces are indirectly accessed through the interprocess
+communication facilities provided by the system; see
+.Xr socket 2 .
+.Pp
+A hardware device is identified to the system at configuration time
+and the appropriate device or network interface driver is then compiled
+into the system. When the resultant system is booted, the
+autoconfiguration facilities in the system probe for the device
+and, if found, enable the software support for it.
+If a device does not respond at autoconfiguration
+time it is not accessible at any time afterwards.
+To enable a device which did not autoconfigure,
+the system must be rebooted.
+.Pp
+The autoconfiguration system is described in
+.Xr sun3/autoconf 4 .
+A list of the supported devices is given below.
+.Sh SEE ALSO
+.Xr config 1 ,
+.Xr cd 4 ,
+.Xr sd 4 ,
+.Xr ss 4 ,
+.Xr st 4 ,
+.Xr sun3/autoconf 4
+.Sh SUPPORTED SYSTEMS
+The following Sun3 system architectures and models are supported:
+.Bl -tag -width eeprom
+.It sun3
+Sun3 systems: (MC68020)
+.br
+Sun 3/50 (16 MHz)
+.br
+Sun 3/60 (20 MHz)
+.br
+Sun 3/100 series (16.67 MHz)
+.br
+Sun 3/200 series (25 MHz)
+.br
+.It sun3x
+Sun3X systems: (MC68030)
+.br
+Sun 3/80 (20 MHz)
+.br
+Sun 3/470 (33 MHz)
+.br
+.El
+.Sh LIST OF DEVICES
+The devices listed below are supported in this incarnation of
+the system. Devices are indicated by their functional interface.
+Not all supported devices are listed.
+.Pp
+.Bl -tag -width eeprom
+.It bwtwo
+black and white obio frame buffer
+.It cgtwo
+8 bit VMEbus color frame buffer
+.It cgfour
+8 bit obio color graphics frame buffer
+.It eeprom
+Sun non-volatile configuration RAM driver
+.It esp
+NCR53C90 ESP100 (Sun 3/80) SCSI controller
+.It fd
+Intel 82072 obio (Sun 3/80) floppy disk drive controller
+.It ie
+Intel 82586 Ethernet controller (Sun 3/100, 3/200, 3/470)
+.It kbd
+Sun type 2, type 3, type 4, and type 5 keyboards (on zs)
+.It le/lebuffer
+AMD 7990 LANCE Ethernet controller (Sun 3/50, 3/60, 3/80)
+.It ms
+Sun mouse (on zs)
+.It si
+NCR5380 "SCSI-3" VMEbus SCSI controller
+.It vme
+VMEbus support (Sun 3/100, 3/200, 3/470)
+.It xd
+Xylogics 753/7053 VMEbus SMD disk controller
+.It xy
+Xylogics 450/451 VMEbus SMD disk controller
+.It zs
+Zilog 8530 serial controller
+.El
+.Sh UNSUPPORTED DEVICES
+The following devices are not supported, due to unavailability of
+either documentation or sample hardware:
+.Bl -tag -width eeprom
+.It sc
+Sun "SCSI-2" VMEbus SCSI controller
+.El
+.Sh HISTORY
+This
+.Tn sun3
+.Nm intro
+appeared in
+.Nx 1.3 .
+Large chunks of text carefully recycled (shamelessly appropriated)
+from
+.Nx Ns /pmax
+.Xr sun3/intro 4 .
diff --git a/static/netbsd/man4/man4.sun3/kbd.4 b/static/netbsd/man4/man4.sun3/kbd.4
new file mode 100644
index 00000000..4a0f7f60
--- /dev/null
+++ b/static/netbsd/man4/man4.sun3/kbd.4
@@ -0,0 +1,180 @@
+.\" $NetBSD: kbd.4,v 1.11 2017/02/17 22:24:47 christos Exp $
+.\"
+.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Paul Kranenburg.
+.\"
+.\" 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 NETBSD FOUNDATION, INC. 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 FOUNDATION 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 February 17, 2017
+.Dt KBD 4 sun3
+.Os
+.Sh NAME
+.Nm kbd
+.Nd Sun workstation keyboard
+.Sh SYNOPSIS
+.Cd "pseudo-device kbd"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides an interface to the workstation console keyboard.
+.Qq type 2 ,
+.Qq type 3 ,
+.Qq type 4 ,
+and
+.Qq type 5
+keyboards are supported.
+The
+.Qq type 5
+keyboard is treated as if it were a
+.Qq type 4 .
+All types generate keycodes encoding the
+key identity and motion (up or down) as the keys are pressed and released.
+The
+.Nm
+driver either passes the keycodes to an application as they come in, or
+translates them into
+.Tn ASCII
+characters first according to a set of built-in tables.
+.Pp
+If the keyboard is configured as the device
+to be used for system console input
+.Pq see Xr eeprom 8 ,
+it will be internally connected to the
+.Pa /dev/console
+device special file, which can be used as a
+.Xr tty 4
+device.
+.Pp
+The device special file
+.Pa /dev/kbd
+is used to get direct access to the keyboard input stream.
+The following
+ioctl's are supported (mostly just enough to keep the
+.Ic X
+server going):
+.Bl -tag -width KIOCSDIRECT
+.It KIOCTRANS
+Set translation mode.
+The argument is of type
+.Fa "int *" ,
+the only value supported is
+.Dv TR_UNTRANS_EVENT .
+.It KIOCGTRANS
+Get translation mode.
+The argument is of type
+.Fa "int *" .
+.Dv TR_UNTRANS_EVENT
+is always returned.
+.It KIOCGETKEY
+Fill in old-style key station translation.
+The argument is of type
+.Fa "struct okiockey *" .
+.It KIOCCMD
+Send a command to the keyboard.
+The argument is of type
+.Fa "int *" ,
+and can have one of the following values:
+.Bl -tag -width KBD_CMD_NOCLICK
+.It KBD_CMD_BELL
+Start the keyboard beeper.
+.It KBD_CMD_NOBELL
+Stop the keyboard beeper.
+.It KBD_CMD_CLICK
+Instruct the keyboard to make extra noise when touching keys.
+.It KBD_CMD_NOCLICK
+Instruct the keyboard to stop making extra noise when touching keys.
+.El
+.It KIOCTYPE
+Get keyboard type.
+The argument is of type
+.Fa "int *" ,
+in which one of the values
+.Dv KB_SUN2 ,
+.Dv KB_SUN3
+or
+.Dv KB_SUN4
+will be returned.
+.It KIOCSDIRECT
+Route the keyboard input stream through the
+.Tn SunOS
+compatible event module.
+The argument is of type
+.Fa "int *" ,
+a non-zero value will put the driver into
+.Dq event
+mode, while a value of zero will make it return to
+.Dq ASCII translation
+mode.
+.It KIOCSKEY
+Set key station translation.
+The argument is of type
+.Fa "struct kiockey *"
+.Pq see Pa /usr/include/machine/kbio.h No for more details .
+.It KIOCGKEY
+Get key station translation.
+The argument is of type
+.Fa "struct kiockey *" .
+.It KIOCLAYOUT
+Get keyboard layout
+.Pq Do type 4 Dc only .
+The argument is of type
+.Fa "int *" ,
+in which the uninterpreted result of the
+.Dv KBD_CMD_GLAYOUT
+keyboard command is returned
+.Po on Dv KBDUN4
+type keyboards this will be the setting of a DIP switch bank
+.Pc .
+.It KIOCSLED
+Set LED state
+.Pq Do type 4 Dc only .
+The argument is of type
+.Fa "char *" ,
+and is the inclusive OR of the following flags:
+.Pp
+.Bl -tag -width LED_SCROLL_LOCK -compact
+.It LED_NUM_LOCK
+.It LED_COMPOSE
+.It LED_SCROLL_LOCK
+.It LED_CAPS_LOCK
+.El
+.Pp
+Each of these flags turn on the LED in the obvious key.
+.It KIOCGLED
+Get LED state
+.Pq Do type 4 Dc only .
+The argument is of type
+.Fa "char *" ,
+in which the current LED state is returned.
+.El
+.Sh SEE ALSO
+.Xr eeprom 4 ,
+.Xr sun3/ms 4 ,
+.Xr eeprom 8
+.Sh BUGS
+.Nm
+is hardwired to the built-in
+.Em zs1
+serial port at 1200 bps.
diff --git a/static/netbsd/man4/man4.sun3/leds.4 b/static/netbsd/man4/man4.sun3/leds.4
new file mode 100644
index 00000000..8a642f83
--- /dev/null
+++ b/static/netbsd/man4/man4.sun3/leds.4
@@ -0,0 +1,107 @@
+.\" $NetBSD: leds.4,v 1.14 2022/08/28 10:48:16 hgutch Exp $
+.\"
+.\" Copyright (c) 1997 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by der Mouse and Jeremy Cooper.
+.\"
+.\" 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 NETBSD FOUNDATION, INC. 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 FOUNDATION 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 March 2, 1996
+.Dt LEDS 4 sun3
+.Os
+.Sh NAME
+.Nm leds
+.Nd sun3 diagnostic Light Emitting Diodes driver
+.Sh SYNOPSIS
+.In machine/leds.h
+.Sh DESCRIPTION
+With the exception of the Sun 3/80, all sun3 machines are equipped
+a diagnostic display of eight Light Emitting Diodes (LEDs), located
+on the back of the system unit.
+The Sun 3/80 has a single LED, which is located on the front panel.
+.Pp
+The kernel changes the display during periods of idle processor activity
+according to a stored sequential pattern list.
+The
+.Pa /dev/leds
+interface provides a way of manipulating the pattern list via simple file I/O.
+.Pp
+The structure of the file is as follows:
+.Bd -literal
+struct led_patterns {
+ u_char divisor;
+ u_char patlen;
+ u_char pat[256];
+};
+.Ed
+.Bl -tag -width divisor
+.It Sy divisor
+The number of idle periods to wait before switching to the next pattern in
+the array.
+.It Sy patlen
+The number of patterns stored in the array.
+.It Sy pat
+The array of patterns to display.
+.El
+.Pp
+When a clock interrupt occurs while the processor is idle, a pattern
+countdown timer is decremented.
+When the countdown timer reaches zero
+it is reset with the
+.Sy divisor
+value and the next pattern in the array is selected and displayed.
+.Pp
+Each 8-bit pattern describes the state of the diagnostic LEDs.
+With the exception of the 3/80, a set bit in a pattern indicates that its
+corresponding LED should be extinguished,
+while a reset bit indicates an LED to be illuminated.
+On the 3/80 the polarity of the bits is reversed and only the lowest order bit
+is used.
+.Sh FILES
+.Bl -tag -width /dev/leds -compact
+.It Pa /dev/leds
+.El
+.Sh EXAMPLES
+The following example uses
+.Xr awk 1
+to display the repeating animation of a single lit LED scrolling from one end
+of the display to the other, using six clock ticks between each update.
+.Bd -ragged -offset indent
+# echo 5 8 254 253 251 247 239 223 191 127 |
+ awk '{ for (i=1;i<=NF;i++) printf("%c",$i+0); }' > /dev/leds
+.Ed
+.Sh ERRORS
+An I/O transfer to
+.Pa /dev/leds
+will complete successfully unless:
+.Bl -tag -width Er
+.It Bq Er EIO
+A read or write starting beyond the end of the file was attempted.
+.El
+.Sh SEE ALSO
+.Xr ppt 6
+.Sh HISTORY
+.Pa /dev/leds
+first appeared in
+.Nx 1.2 .
diff --git a/static/netbsd/man4/man4.sun3/mem.4 b/static/netbsd/man4/man4.sun3/mem.4
new file mode 100644
index 00000000..e6d80d15
--- /dev/null
+++ b/static/netbsd/man4/man4.sun3/mem.4
@@ -0,0 +1,75 @@
+.\" Copyright (c) 1992, 1993
+.\" The Regents of the University of California. All rights reserved.
+.\"
+.\" This software was developed by the Computer Systems Engineering group
+.\" at Lawrence Berkeley Laboratory under DARPA contract BG 91-66 and
+.\" contributed to Berkeley.
+.\"
+.\" 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. Neither the name of the University nor the names of its contributors
+.\" may be used to endorse or promote products derived from this software
+.\" without specific prior written permission.
+.\"
+.\" 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.
+.\"
+.\" from: @(#)mem.4 8.1 (Berkeley) 6/5/93
+.\" $NetBSD: mem.4,v 1.4 2003/08/07 10:31:09 agc Exp $
+.\"
+.Dd June 5, 1993
+.Dt MEM 4 sun3
+.Os
+.Sh NAME
+.Nm mem ,
+.Nm kmem
+.Nd main memory
+.Sh DESCRIPTION
+The file
+.Pa /dev/mem
+is an interface to the physical memory of the
+computer.
+Byte offsets in this file are interpreted as physical memory addresses.
+Reading and writing this file is equivalent to reading and writing
+memory itself.
+An error will be returned if an attempt is made to reference
+an offset outside of
+.Pa /dev/mem .
+.Pp
+Kernel virtual memory is accessed via the file
+.Pa /dev/kmem
+in the same manner as
+.Pa /dev/mem .
+Only kernel virtual addresses that are currently mapped to memory are allowed.
+.Pp
+On the
+.Tn Sun3 ,
+kernel virtual memory begins at
+.Ad 0x0E000000 .
+.Sh FILES
+.Bl -tag -width /dev/kmem -compact
+.It Pa /dev/mem
+.It Pa /dev/kmem
+.El
+.Sh HISTORY
+The files
+.Nm mem
+and
+.Nm kmem
+appeared in
+.At v6 .
diff --git a/static/netbsd/man4/man4.sun3/ms.4 b/static/netbsd/man4/man4.sun3/ms.4
new file mode 100644
index 00000000..5bcc8ec1
--- /dev/null
+++ b/static/netbsd/man4/man4.sun3/ms.4
@@ -0,0 +1,98 @@
+.\" $NetBSD: ms.4,v 1.10 2017/02/17 22:24:47 christos Exp $
+.\"
+.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Paul Kranenburg.
+.\"
+.\" 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 NETBSD FOUNDATION, INC. 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 FOUNDATION 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 February 17, 2017
+.Dt MS 4 sun3
+.Os
+.Sh NAME
+.Nm ms
+.Nd Sun workstation mouse driver
+.Sh SYNOPSIS
+.Cd "pseudo-device mouse"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides an interface to the workstation console mouse.
+This
+.Tn Mouse Systems
+three-button device produces five-byte blobs of the form:
+.Bd -literal -offset indent
+b dx dy dx dy
+.Ed
+.Pp
+where
+.Dq b
+is the button state, encoded as
+.Li 0x80|(~buttons)
+-- there are three buttons (4=left, 2=middle, 1=right) --
+and
+.Dq \&dx
+and
+.Dq \&dy
+are X and Y delta values, none of which are in the range
+.Bq Li 0x80..0x87 .
+.Pp
+The device special file
+.Pa /dev/mouse
+is used to get direct access to the mouse input stream.
+The following
+ioctl's are supported (mostly just enough to keep the
+.Ic X
+server going):
+.Bl -tag -width VUIDSFORMAT
+.It Dv VUIDSFORMAT
+Set translation mode.
+The argument is of type
+.Fa "int *" ,
+the only value supported is
+.Dv VUID_FIRM_EVENT .
+.It Dv VUIDGFORMAT
+Get translation mode.
+The argument is of type
+.Fa "int *" .
+.Dv VUID_FIRM_EVENT
+is always returned.
+.El
+.Ss OPTIONS
+The mouse driver can be configured using the following kernel configuration
+file options.
+.Bl -tag -width VUIDSFORMAT
+.It Cd options SUN_MS_BPS=integer
+This option causes the kernel to communicate with the mouse using the serial
+baud rate
+.Va integer .
+It is useful for mice which do not communicate at 1200 baud.
+.El
+.Sh SEE ALSO
+.Xr sun3/kbd 4
+.Sh BUGS
+.Nm
+is hardwired to the built-in
+.Em zs1
+serial port.