Aren
/
NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

mdoc(7) & nroff cleanup, plus some additional references

This commit is contained in:
fair 1998-06-11 09:03:45 +00:00
parent c5a827e7f6
commit 91b5182e46
9 changed files with 121 additions and 82 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
share/man/man4/man4.sun3/bwtwo.4
View File

@ -35,7 +35,7 @@
.\"
.\" 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.1.1.1 1995/08/08 20:18:53 gwr Exp $
.\" $NetBSD: bwtwo.4,v 1.2 1998/06/11 09:03:45 fair Exp $
.\"
.Dd February 16, 1994
.Dt BWTWO 4 sun3
@ -46,10 +46,11 @@
.Sh SYNOPSIS
.Cd "bwtwo0 at obmem0 addr ?"
.Sh DESCRIPTION
The
The
.Nm
is a memory based black and white frame buffer.
It supports the minimal ioctl's needed to run X11.
It supports the minimal ioctl's needed to run
.Xr X 1 .
.Sh SEE ALSO
.Xr cgtwo 4 ,
.Xr cgfour 4

7
share/man/man4/man4.sun3/cgfour.4
View File

@ -35,7 +35,7 @@
.\"
.\" 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.1.1.1 1995/08/08 20:18:53 gwr Exp $
.\" $NetBSD: cgfour.4,v 1.2 1998/06/11 09:03:45 fair Exp $
.\"
.Dd February 16, 1994
.Dt CGFOUR 4 sun3
@ -46,10 +46,11 @@
.Sh SYNOPSIS
.Cd "cgfour0 at obmem0 addr ?"
.Sh DESCRIPTION
The
The
.Nm
is a memory based color frame buffer.
It supports the minimal ioctl's needed to run X11.
It supports the minimal ioctl's needed to run
.Xr X 1 .
.Sh SEE ALSO
.Xr bwtwo 4 ,
.Xr cgtwo 4

15
share/man/man4/man4.sun3/cgtwo.4
View File

@ -35,21 +35,24 @@
.\"
.\" 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.1.1.1 1995/08/08 20:18:53 gwr Exp $
.\" $NetBSD: cgtwo.4,v 1.2 1998/06/11 09:03:45 fair Exp $
.\"
.Dd February 16, 1994
.Dt CGTWO 4 sun3
.Os
.Sh NAME
.Nm cgtwo
.Nd 8-bit color frame buffer
.Nd 8-bit VME bus color frame buffer
.Sh SYNOPSIS
.Cd "cgtwo0 at vmes0 addr 0xff400000 level 4 vect 0xA8"
.Cd "cgtwo0 at vme2 addr 0x400000 ipl 4 vect 0xA8"
.Sh DESCRIPTION
The
The
.Nm
is a memory based color frame buffer.
It supports the minimal ioctl's needed to run X11.
is a memory based,
.Tn VME
bus, color frame buffer.
It supports the minimal ioctl's needed to run
.Xr X 1 .
.Sh SEE ALSO
.Xr bwtwo 4 ,
.Xr cgfour 4

27
share/man/man4/man4.sun3/fd.4
View File

@ -1,4 +1,4 @@
.\" $NetBSD: fd.4,v 1.4 1997/10/22 23:08:22 gwr Exp $
.\" $NetBSD: fd.4,v 1.5 1998/06/11 09:03:46 fair Exp $
.\"
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -25,7 +25,7 @@
.\" 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
.\" 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
@ -39,13 +39,16 @@
.Os
.Sh NAME
.Nm fd
.Nd Sun3/80 floppy drive
.Nd Sun 3/80 i82027 floppy disk drive controller driver
.Sh SYNOPSIS
.Cd "fdc0 at obio0" Pq sun3x
.Cd "fd* at fdc0"
.Sh DESCRIPTION
This is the driver for the built-in disquette station found on the
Sun3/80.
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
@ -53,13 +56,13 @@ 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 disquettes.
3.5'' 1.44MB floppy diskettes.
.It 1
3.5'' 720KB disquettes.
3.5'' 720KB floppy diskettes.
.It 2
3.5'' 360KB disquettes.
3.5'' 360KB floppy diskettes.
.It 3
3.5'' 1.2MB/NEC Japanese format disquettes.
3.5'' 1.2MB/NEC Japanese format floppy diskettes.
.El
.Sh FORMATTING
The driver supports floppy disk formatting using the interfaces in
@ -67,7 +70,8 @@ The driver supports floppy disk formatting using the interfaces in
.Pp
.Bl -tag -width FDIOCFORMAT_TRACK -compact
.It Dv FDIOCGETFORMAT Fa struct fdformat_parms
Fetch current formatting parameters. This gets the default parameters
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
@ -84,7 +88,8 @@ If it returns
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
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

25
share/man/man4/man4.sun3/ie.4
View File

@ -35,34 +35,37 @@
.\"
.\" 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.1.1.1 1995/08/08 20:18:53 gwr Exp $
.\" $NetBSD: ie.4,v 1.2 1998/06/11 09:03:46 fair Exp $
.\"
.Dd June 9, 1993
.Dt IE 4 sun3
.Os
.Sh NAME
.Nm ie
.Nd Intel 82586 Ethernet interface
.Nd Intel 82586 Ethernet interface driver
.Sh SYNOPSIS
.Cd "ie0 at obio0 addr ? level ?"
.Cd "ie1 at vmes0 addr 0xffe88000 level 3 vect 0x75"
.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
The
.Nm
interface provides access to the 10 Mb/s Ethernet network via the
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
Each of the host's network addresses is specified at boot time with an
.Dv SIOCSIFADDR
.Xr ioctl .
The
.Nm
interface employs the address resolution protocol described in
interface employs the Address Resolution Protocol described in
.Xr arp 4
to dynamically map between Internet and Ethernet addresses on the local
network.
to dynamically map between Internet and
.Tn Ethernet
addresses on the local network.
.Sh SEE ALSO
.Xr le 4 ,
.Xr intro 4 ,

61
share/man/man4/man4.sun3/kbd.4
View File

@ -1,4 +1,4 @@
.\" $NetBSD: kbd.4,v 1.4 1997/11/25 22:15:58 pk Exp $
.\" $NetBSD: kbd.4,v 1.5 1998/06/11 09:03:46 fair Exp $
.\"
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -25,7 +25,7 @@
.\" 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
.\" 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
@ -46,17 +46,24 @@
The
.Nm
driver provides an interface to the workstation console keyboard.
.Dq type 2 ,
.Dq type 3 ,
.Qq type 2 ,
.Qq type 3 ,
.Qq type 4 ,
and
.Dq type 4
keyboards are supported. All types generate keycodes encoding the
.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 ASCII characters first according to a set of built-in
tables.
translates them into
.Tn ASCII
characters first according to a set of built-in tables.
If the keyboard is configured as the device
to be used for system console input
.Pq see Xr openprom 4 ,
@ -67,24 +74,31 @@ device special file, which can be used as a
device.
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 X11 server going):
is used to get direct access to the keyboard input stream.
The following
ioctl's are supported (mostly just enough to keep the
.Xr X 1
server going):
.Bl -tag -width KIOCSDIRECT
.It KIOCTRANS
Set translation mode. The argument is of type
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
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
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
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
@ -95,10 +109,11 @@ 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.. oh well..
Instruct the keyboard to stop making extra noise when touching keys.
.El
.It KIOCTYPE
Get keyboard type. The argument is of type
Get keyboard type.
The argument is of type
.Fa "int *" ,
in which one of the values
.Dv KB_SUN2 ,
@ -107,7 +122,9 @@ or
.Dv KB_SUN4
will be returned.
.It KIOCSDIRECT
Route the keyboard input stream through the (SunOS) compatible event module.
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
@ -116,11 +133,13 @@ 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 *"
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
Get key station translation.
The argument is of type
.Fa "struct kiockey *" .
.It KIOCLAYOUT
Get keyboard layout
@ -161,4 +180,4 @@ in which the current LED state is returned.
.Nm
is hardwired to the built-in
.Em zs1
serial port.
serial port at 1200 bps.

22
share/man/man4/man4.sun3/leds.4
View File

@ -1,4 +1,4 @@
.\" $NetBSD: leds.4,v 1.2 1998/02/06 06:07:02 perry Exp $
.\" $NetBSD: leds.4,v 1.3 1998/06/11 09:03:46 fair Exp $
.\"
.\" Copyright (c) 1997 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -39,7 +39,7 @@
.Os NetBSD 1.2
.Sh NAME
.Nm leds
.Nd sun3 diagnostic LED(s)
.Nd sun3 diagnostic Light Emitting Diodes driver
.Sh SYNOPSIS
.nf
.ft B
@ -47,15 +47,15 @@
.ft R
.fi
.Sh DESCRIPTION
With the exception of the 3/80, all sun3 machines are equipped a diagnostic
display of eight Light Emitting Diodes,
located on the back of the system unit.
The 3/80 has a single LED, which is located on the front panel.
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
.Nm /dev/leds
.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:
@ -77,7 +77,8 @@ 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
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.
@ -99,7 +100,7 @@ of the display to the other, using six clock ticks between each update.
.Ed
.Sh "ERRORS"
An I/O transfer to
.Nm /dev/leds
.Pa /dev/leds
will complete successfully unless:
.Bl -tag -width Er
.It Bq Er EIO
@ -112,5 +113,6 @@ A read or write starting beyond the end of the file was attempted.
.Sh "SEE ALSO"
.Xr ppt 6
.Sh HISTORY
.Nm /dev/leds
.Pa /dev/leds
first appeared in
.Nx 1.2 .

10
share/man/man4/man4.sun3/mem.4
View File

@ -34,7 +34,7 @@
.\" SUCH DAMAGE.
.\"
.\" from: @(#)mem.4 8.1 (Berkeley) 6/5/93
.\" $NetBSD: mem.4,v 1.1.1.1 1995/08/08 20:18:53 gwr Exp $
.\" $NetBSD: mem.4,v 1.2 1998/06/11 09:03:46 fair Exp $
.\"
.Dd June 5, 1993
.Dt MEM 4 sun3
@ -45,7 +45,7 @@
.Nd main memory
.Sh DESCRIPTION
The file
.Nm /dev/mem
.Pa /dev/mem
is an interface to the physical memory of the
computer.
Byte offsets in this file are interpreted as physical memory addresses.
@ -53,12 +53,12 @@ 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
.Nm /dev/mem .
.Pa /dev/mem .
.Pp
Kernel virtual memory is accessed via the file
.Nm /dev/kmem
.Pa /dev/kmem
in the same manner as
.Nm /dev/mem .
.Pa /dev/mem .
Only kernel virtual addresses that are currently mapped to memory are allowed.
.Pp
On the

29
share/man/man4/man4.sun3/ms.4
View File

@ -1,4 +1,4 @@
.\" $NetBSD: ms.4,v 1.3 1997/10/22 22:55:48 gwr Exp $
.\" $NetBSD: ms.4,v 1.4 1998/06/11 09:03:46 fair Exp $
.\"
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -25,7 +25,7 @@
.\" 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
.\" 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
@ -35,11 +35,11 @@
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd June 22, 1996
.Dt KBD 4 sun3
.Dt MS 4 sun3
.Os
.Sh NAME
.Nm mouse
.Nd workstation mouse
.Nm ms
.Nd workstation mouse driver
.Sh SYNOPSIS
.Cd "pseudo-device mouse"
.Sh DESCRIPTION
@ -68,16 +68,21 @@ are X and Y delta values, none of which are in the range
.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 X11 server going):
is used to get direct access to the mouse input stream.
The following
ioctl's are supported (mostly just enough to keep the
.Xr X 1
server going):
.Bl -tag -width VUIDSFORMAT
.It VUIDSFORMAT
Set translation mode. The argument is of type
.It Dv VUIDSFORMAT
Set translation mode.
The argument is of type
.Fa "int *" ,
the only value supported is
.Dv VUID_FIRM_EVENT .
.It VUIDGFORMAT
Get translation mode. The argument is of type
.It Dv VUIDGFORMAT
Get translation mode.
The argument is of type
.Fa "int *" .
.Dv VUID_FIRM_EVENT
is always returned.
@ -88,4 +93,4 @@ is always returned.
.Nm
is hardwired to the built-in
.Em zs1
serial port.
serial port at 1200 bps.