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

5
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: Header: bwtwo.4,v 1.3 94/02/03 20:42:13 leres Exp
.\" from: @(#)bwtwo.4 8.2 (Berkeley) 2/16/94 .\" 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 .Dd February 16, 1994
.Dt BWTWO 4 sun3 .Dt BWTWO 4 sun3
@ -49,7 +49,8 @@
The The
.Nm .Nm
is a memory based black and white frame buffer. 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 .Sh SEE ALSO
.Xr cgtwo 4 , .Xr cgtwo 4 ,
.Xr cgfour 4 .Xr cgfour 4

5
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: Header: cgthree.4,v 1.3 94/02/03 20:49:52 leres Exp
.\" from: @(#)cgthree.4 8.2 (Berkeley) 2/16/94 .\" 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 .Dd February 16, 1994
.Dt CGFOUR 4 sun3 .Dt CGFOUR 4 sun3
@ -49,7 +49,8 @@
The The
.Nm .Nm
is a memory based color frame buffer. 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 .Sh SEE ALSO
.Xr bwtwo 4 , .Xr bwtwo 4 ,
.Xr cgtwo 4 .Xr cgtwo 4

13
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: Header: cgthree.4,v 1.3 94/02/03 20:49:52 leres Exp
.\" from: @(#)cgthree.4 8.2 (Berkeley) 2/16/94 .\" 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 .Dd February 16, 1994
.Dt CGTWO 4 sun3 .Dt CGTWO 4 sun3
.Os .Os
.Sh NAME .Sh NAME
.Nm cgtwo .Nm cgtwo
.Nd 8-bit color frame buffer .Nd 8-bit VME bus color frame buffer
.Sh SYNOPSIS .Sh SYNOPSIS
.Cd "cgtwo0 at vmes0 addr 0xff400000 level 4 vect 0xA8" .Cd "cgtwo0 at vme2 addr 0x400000 ipl 4 vect 0xA8"
.Sh DESCRIPTION .Sh DESCRIPTION
The The
.Nm .Nm
is a memory based color frame buffer. is a memory based,
It supports the minimal ioctl's needed to run X11. .Tn VME
bus, color frame buffer.
It supports the minimal ioctl's needed to run
.Xr X 1 .
.Sh SEE ALSO .Sh SEE ALSO
.Xr bwtwo 4 , .Xr bwtwo 4 ,
.Xr cgfour 4 .Xr cgfour 4

25
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. .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
.\" All rights reserved. .\" All rights reserved.
@ -39,13 +39,16 @@
.Os .Os
.Sh NAME .Sh NAME
.Nm fd .Nm fd
.Nd Sun3/80 floppy drive .Nd Sun 3/80 i82027 floppy disk drive controller driver
.Sh SYNOPSIS .Sh SYNOPSIS
.Cd "fdc0 at obio0" Pq sun3x .Cd "fdc0 at obio0" Pq sun3x
.Cd "fd* at fdc0" .Cd "fd* at fdc0"
.Sh DESCRIPTION .Sh DESCRIPTION
This is the driver for the built-in disquette station found on the The
Sun3/80. .Nm
driver is for the built-in floppy diskette drive run by the
.Tn Intel
i82027 controller found on the Sun 3/80.
.Pp .Pp
Bits Bits
.Bq 0-3 .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: device encode the floppy density as follows:
.Bl -tag -width indent -offset indent .Bl -tag -width indent -offset indent
.It 0 .It 0
3.5'' 1.44MB disquettes. 3.5'' 1.44MB floppy diskettes.
.It 1 .It 1
3.5'' 720KB disquettes. 3.5'' 720KB floppy diskettes.
.It 2 .It 2
3.5'' 360KB disquettes. 3.5'' 360KB floppy diskettes.
.It 3 .It 3
3.5'' 1.2MB/NEC Japanese format disquettes. 3.5'' 1.2MB/NEC Japanese format floppy diskettes.
.El .El
.Sh FORMATTING .Sh FORMATTING
The driver supports floppy disk formatting using the interfaces in 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 .Pp
.Bl -tag -width FDIOCFORMAT_TRACK -compact .Bl -tag -width FDIOCFORMAT_TRACK -compact
.It Dv FDIOCGETFORMAT Fa struct fdformat_parms .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. for the open device if no parameters have been set during the session.
.Pp .Pp
.It Dv FDIOCSETFORMAT Fa struct fdformat_parms .It Dv FDIOCSETFORMAT Fa struct fdformat_parms
@ -84,7 +88,8 @@ If it returns
there was a medium error while formatting the track. there was a medium error while formatting the track.
.Pp .Pp
.It Dv FDIOCSETOPTS Fa int .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: options should be the logical OR of the desired values below:
.Pp .Pp
.Bl -tag -width FDOPT_NORETRY -compact .Bl -tag -width FDOPT_NORETRY -compact

23
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: Header: le.4,v 1.2 92/10/13 05:31:33 leres Exp
.\" from: @(#)le.4 8.1 (Berkeley) 6/9/93 .\" 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 .Dd June 9, 1993
.Dt IE 4 sun3 .Dt IE 4 sun3
.Os .Os
.Sh NAME .Sh NAME
.Nm ie .Nm ie
.Nd Intel 82586 Ethernet interface .Nd Intel 82586 Ethernet interface driver
.Sh SYNOPSIS .Sh SYNOPSIS
.Cd "ie0 at obio0 addr ? level ?" .Cd "ie0 at obio0 addr 0x0C0000 ipl 3"
.Cd "ie1 at vmes0 addr 0xffe88000 level 3 vect 0x75" .Cd "ie1 at vme2 addr 0xe88000 ipl 3 vect 0x75"
.Cd "ie* at sebuf?"
.Sh DESCRIPTION .Sh DESCRIPTION
The The
.Nm .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 .Tn Intel
82586 Ethernet chip set. 82586 Ethernet chip set.
.Pp .Pp
Each of the host's network addresses Each of the host's network addresses is specified at boot time with an
is specified at boot time with an
.Dv SIOCSIFADDR .Dv SIOCSIFADDR
.Xr ioctl . .Xr ioctl .
The The
.Nm .Nm
interface employs the address resolution protocol described in interface employs the Address Resolution Protocol described in
.Xr arp 4 .Xr arp 4
to dynamically map between Internet and Ethernet addresses on the local to dynamically map between Internet and
network. .Tn Ethernet
addresses on the local network.
.Sh SEE ALSO .Sh SEE ALSO
.Xr le 4 , .Xr le 4 ,
.Xr intro 4 , .Xr intro 4 ,

57
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. .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
.\" All rights reserved. .\" All rights reserved.
@ -46,17 +46,24 @@
The The
.Nm .Nm
driver provides an interface to the workstation console keyboard. driver provides an interface to the workstation console keyboard.
.Dq type 2 , .Qq type 2 ,
.Dq type 3 , .Qq type 3 ,
.Qq type 4 ,
and and
.Dq type 4 .Qq type 5
keyboards are supported. All types generate keycodes encoding the 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. key identity and motion (up or down) as the keys are pressed and released.
The The
.Nm .Nm
driver either passes the keycodes to an application as they come in, or 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 translates them into
tables. .Tn ASCII
characters first according to a set of built-in tables.
If the keyboard is configured as the device If the keyboard is configured as the device
to be used for system console input to be used for system console input
.Pq see Xr openprom 4 , .Pq see Xr openprom 4 ,
@ -67,24 +74,31 @@ device special file, which can be used as a
device. device.
The device special file The device special file
.Pa /dev/kbd .Pa /dev/kbd
is used to get direct access to the keyboard input stream. The following is used to get direct access to the keyboard input stream.
ioctl's are supported (mostly just enough to keep the X11 server going): The following
ioctl's are supported (mostly just enough to keep the
.Xr X 1
server going):
.Bl -tag -width KIOCSDIRECT .Bl -tag -width KIOCSDIRECT
.It KIOCTRANS .It KIOCTRANS
Set translation mode. The argument is of type Set translation mode.
The argument is of type
.Fa "int *" , .Fa "int *" ,
the only value supported is the only value supported is
.Dv TR_UNTRANS_EVENT . .Dv TR_UNTRANS_EVENT .
.It KIOCGTRANS .It KIOCGTRANS
Get translation mode. The argument is of type Get translation mode.
The argument is of type
.Fa "int *" . .Fa "int *" .
.Dv TR_UNTRANS_EVENT .Dv TR_UNTRANS_EVENT
is always returned. is always returned.
.It KIOCGETKEY .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 *" . .Fa "struct okiockey *" .
.It KIOCCMD .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 *" , .Fa "int *" ,
and can have one of the following values: and can have one of the following values:
.Bl -tag -width KBD_CMD_NOCLICK .Bl -tag -width KBD_CMD_NOCLICK
@ -95,10 +109,11 @@ Stop the keyboard beeper.
.It KBD_CMD_CLICK .It KBD_CMD_CLICK
Instruct the keyboard to make extra noise when touching keys. Instruct the keyboard to make extra noise when touching keys.
.It KBD_CMD_NOCLICK .It KBD_CMD_NOCLICK
Instruct the keyboard to.. oh well.. Instruct the keyboard to stop making extra noise when touching keys.
.El .El
.It KIOCTYPE .It KIOCTYPE
Get keyboard type. The argument is of type Get keyboard type.
The argument is of type
.Fa "int *" , .Fa "int *" ,
in which one of the values in which one of the values
.Dv KB_SUN2 , .Dv KB_SUN2 ,
@ -107,7 +122,9 @@ or
.Dv KB_SUN4 .Dv KB_SUN4
will be returned. will be returned.
.It KIOCSDIRECT .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 The argument is of type
.Fa "int *" , .Fa "int *" ,
a non-zero value will put the driver into 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 .Dq ASCII translation
mode. mode.
.It KIOCSKEY .It KIOCSKEY
Set key station translation. The argument is of type Set key station translation.
The argument is of type
.Fa "struct kiockey *" .Fa "struct kiockey *"
.Pq see Pa /usr/include/machine/kbio.h No for more details . .Pq see Pa /usr/include/machine/kbio.h No for more details .
.It KIOCGKEY .It KIOCGKEY
Get key station translation. The argument is of type Get key station translation.
The argument is of type
.Fa "struct kiockey *" . .Fa "struct kiockey *" .
.It KIOCLAYOUT .It KIOCLAYOUT
Get keyboard layout Get keyboard layout
@ -161,4 +180,4 @@ in which the current LED state is returned.
.Nm .Nm
is hardwired to the built-in is hardwired to the built-in
.Em zs1 .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. .\" Copyright (c) 1997 The NetBSD Foundation, Inc.
.\" All rights reserved. .\" All rights reserved.
@ -39,7 +39,7 @@
.Os NetBSD 1.2 .Os NetBSD 1.2
.Sh NAME .Sh NAME
.Nm leds .Nm leds
.Nd sun3 diagnostic LED(s) .Nd sun3 diagnostic Light Emitting Diodes driver
.Sh SYNOPSIS .Sh SYNOPSIS
.nf .nf
.ft B .ft B
@ -47,15 +47,15 @@
.ft R .ft R
.fi .fi
.Sh DESCRIPTION .Sh DESCRIPTION
With the exception of the 3/80, all sun3 machines are equipped a diagnostic With the exception of the Sun 3/80, all sun3 machines are equipped
display of eight Light Emitting Diodes, a diagnostic display of eight Light Emitting Diodes (LEDs), located
located on the back of the system unit. on the back of the system unit.
The 3/80 has a single LED, which is located on the front panel. The Sun 3/80 has a single LED, which is located on the front panel.
.Pp .Pp
The kernel changes the display during periods of idle processor activity The kernel changes the display during periods of idle processor activity
according to a stored sequential pattern list. according to a stored sequential pattern list.
The The
.Nm /dev/leds .Pa /dev/leds
interface provides a way of manipulating the pattern list via simple file I/O. interface provides a way of manipulating the pattern list via simple file I/O.
.Pp .Pp
The structure of the file is as follows: The structure of the file is as follows:
@ -77,7 +77,8 @@ The array of patterns to display.
.El .El
.Pp .Pp
When a clock interrupt occurs while the processor is idle, a pattern 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 it is reset with the
.Sy divisor .Sy divisor
value and the next pattern in the array is selected and displayed. 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 .Ed
.Sh "ERRORS" .Sh "ERRORS"
An I/O transfer to An I/O transfer to
.Nm /dev/leds .Pa /dev/leds
will complete successfully unless: will complete successfully unless:
.Bl -tag -width Er .Bl -tag -width Er
.It Bq Er EIO .It Bq Er EIO
@ -112,5 +113,6 @@ A read or write starting beyond the end of the file was attempted.
.Sh "SEE ALSO" .Sh "SEE ALSO"
.Xr ppt 6 .Xr ppt 6
.Sh HISTORY .Sh HISTORY
.Nm /dev/leds .Pa /dev/leds
first appeared in
.Nx 1.2 . .Nx 1.2 .

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

@ -34,7 +34,7 @@
.\" SUCH DAMAGE. .\" SUCH DAMAGE.
.\" .\"
.\" from: @(#)mem.4 8.1 (Berkeley) 6/5/93 .\" 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 .Dd June 5, 1993
.Dt MEM 4 sun3 .Dt MEM 4 sun3
@ -45,7 +45,7 @@
.Nd main memory .Nd main memory
.Sh DESCRIPTION .Sh DESCRIPTION
The file The file
.Nm /dev/mem .Pa /dev/mem
is an interface to the physical memory of the is an interface to the physical memory of the
computer. computer.
Byte offsets in this file are interpreted as physical memory addresses. 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. memory itself.
An error will be returned if an attempt is made to reference An error will be returned if an attempt is made to reference
an offset outside of an offset outside of
.Nm /dev/mem . .Pa /dev/mem .
.Pp .Pp
Kernel virtual memory is accessed via the file Kernel virtual memory is accessed via the file
.Nm /dev/kmem .Pa /dev/kmem
in the same manner as in the same manner as
.Nm /dev/mem . .Pa /dev/mem .
Only kernel virtual addresses that are currently mapped to memory are allowed. Only kernel virtual addresses that are currently mapped to memory are allowed.
.Pp .Pp
On the On the

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