d/freebsd-nq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Minor mdoc cleanup.

Browse Source
This commit is contained in:
Mike Pritchard 1997-01-31 00:38:18 +00:00
parent c492ccdb9a
commit 8f20a914b6
18 changed files with 120 additions and 130 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
share/man/man3/queue.3
View File

@ -84,7 +84,7 @@
lists, tail queues, and circular queues
.Sh SYNOPSIS
.Fd #include <sys/queue.h>
.sp
.\"
.Fn SLIST_EMPTY "SLIST_HEAD *head"
.Fn SLIST_ENTRY "TYPE"
.Fn SLIST_FIRST "SLIST_HEAD *head"
@ -95,7 +95,7 @@ lists, tail queues, and circular queues
.Fn SLIST_NEXT "TYPE *elm" "SLIST_ENTRY NAME"
.Fn SLIST_REMOVE_HEAD "SLIST_HEAD *head" "SLIST_ENTRY NAME"
.Fn SLIST_REMOVE "SLIST_HEAD *head" "TYPE *elm" "TYPE" "SLIST_ENTRY NAME"
.sp
.\"
.Fn STAILQ_ENTRY "TYPE"
.Fn STAILQ_HEAD "HEADNAME" "TYPE"
.Fn STAILQ_INIT "STAILQ_HEAD *head"
@ -104,7 +104,7 @@ lists, tail queues, and circular queues
.Fn STAILQ_INSERT_TAIL "STAILQ_HEAD *head" "TYPE *elm" "STAILQ_ENTRY NAME"
.Fn STAILQ_REMOVE_HEAD "STAILQ_HEAD *head" "TYPE *elm" "STAILQ_ENTRY NAME"
.Fn STAILQ_REMOVE "STAILQ_HEAD *head" "TYPE *elm" "TYPE" "STAILQ_ENTRY NAME"
.sp
.\"
.Fn LIST_ENTRY "TYPE"
.Fn LIST_HEAD "HEADNAME" "TYPE"
.Fn LIST_INIT "LIST_HEAD *head"
@ -112,7 +112,7 @@ lists, tail queues, and circular queues
.Fn LIST_INSERT_BEFORE "TYPE *listelm" "TYPE *elm" "LIST_ENTRY NAME"
.Fn LIST_INSERT_HEAD "LIST_HEAD *head" "TYPE *elm" "LIST_ENTRY NAME"
.Fn LIST_REMOVE "TYPE *elm" "LIST_ENTRY NAME"
.sp
.\"
.Fn TAILQ_EMPTY "TAILQ_HEAD *head"
.Fn TAILQ_ENTRY "TYPE"
.Fn TAILQ_FIRST "TAILQ_HEAD *head"
@ -125,7 +125,7 @@ lists, tail queues, and circular queues
.Fn TAILQ_LAST "TAILQ_HEAD *head"
.Fn TAILQ_NEXT "TYPE *elm" "TAILQ_ENTRY NAME"
.Fn TAILQ_REMOVE "TAILQ_HEAD *head" "TYPE *elm" "TAILQ_ENTRY NAME"
.sp
.\"
.Fn CIRCLEQ_ENTRY "TYPE"
.Fn CIRCLEQ_HEAD "HEADNAME" "TYPE"
.Fn CIRCLEQ_INIT "CIRCLEQ_HEAD *head"
@ -274,7 +274,7 @@ structure is declared as follows:
.Bd -literal -offset indent
SLIST_HEAD(HEADNAME, TYPE) head;
.Ed
.sp
.Pp
where
.Fa HEADNAME
is the name of the structure to be defined, and
@ -284,7 +284,7 @@ A pointer to the head of the list can later be declared as:
.Bd -literal -offset indent
struct HEADNAME *headp;
.Ed
.sp
.Pp
(The names
.Li head
and
@ -383,7 +383,7 @@ structure is declared as follows:
.Bd -literal -offset indent
STAILQ_HEAD(HEADNAME, TYPE) head;
.Ed
.sp
.Pp
where
.Li HEADNAME
is the name of the structure to be defined, and
@ -393,7 +393,7 @@ A pointer to the head of the tail queue can later be declared as:
.Bd -literal -offset indent
struct HEADNAME *headp;
.Ed
.sp
.Pp
(The names
.Li head
and
@ -509,7 +509,7 @@ structure is declared as follows:
.Bd -literal -offset indent
LIST_HEAD(HEADNAME, TYPE) head;
.Ed
.sp
.Pp
where
.Fa HEADNAME
is the name of the structure to be defined, and
@ -519,7 +519,7 @@ A pointer to the head of the list can later be declared as:
.Bd -literal -offset indent
struct HEADNAME *headp;
.Ed
.sp
.Pp
(The names
.Li head
and
@ -622,7 +622,7 @@ structure is declared as follows:
.Bd -literal -offset indent
TAILQ_HEAD(HEADNAME, TYPE) head;
.Ed
.sp
.Pp
where
.Li HEADNAME
is the name of the structure to be defined, and
@ -632,7 +632,7 @@ A pointer to the head of the tail queue can later be declared as:
.Bd -literal -offset indent
struct HEADNAME *headp;
.Ed
.sp
.Pp
(The names
.Li head
and
@ -761,7 +761,7 @@ structure is declared as follows:
.Bd -literal -offset indent
CIRCLEQ_HEAD(HEADNAME, TYPE) head;
.Ed
.sp
.Pp
where
.Li HEADNAME
is the name of the structure to be defined, and
@ -771,7 +771,7 @@ A pointer to the head of the circular queue can later be declared as:
.Bd -literal -offset indent
struct HEADNAME *headp;
.Ed
.sp
.Pp
(The names
.Li head
and

18
share/man/man4/cy.4
View File

@ -47,18 +47,16 @@ Cyclades Cyclom-8Y and Cyclom-16Y serial driver
.Sh SYNOPSIS
.Cd "device cy0 at isa? tty irq 10 iomem 0xd4000 iosiz 0x2000 vector cyintr
.Cd "device cy1 at isa? tty irq 11 iomem 0xd6000 iosiz 0x2000 vector cyintr
.sp
.Pp
Minor numbering:
.br
..Pp
.Bd -literal
0b\fIOLIMMMMM\fR
.br
call\fBO\fRut
.br
\fBL\fRock
.br
\fBI\fRnitial
.br
\fBMMMMMM\fRinor
.Ed
.Sh DESCRIPTION
The
.Nm cy
@ -120,7 +118,7 @@ Use
.Xr stty 1
in the normal way on the initial-state devices to program
initial termios states suitable for your setup.
.sp
.Pp
The lock termios state acts as flags to disable changing
the termios state. E.g., to lock a flag variable such as
CRTSCTS, use
@ -128,7 +126,7 @@ CRTSCTS, use
on the lock-state device. Speeds and special characters
may be locked by setting the corresponding value in the lock-state
device to any nonzero value.
.sp
.Pp
Correct programs talking to correctly wired external devices
work with almost arbitrary initial states and almost no locking,
but other setups may benefit from changing some of the default
@ -154,7 +152,7 @@ for callin ports
.It Pa /dev/ttyic?
.It Pa /dev/ttylc?
corresponding callin initial-state and lock-state devices
.sp
.Pp
.\" XXX more cloning: s/a/c/g. No consistency :-(.
.It Pa /dev/cuac?
for callout ports
@ -162,7 +160,7 @@ for callout ports
.It Pa /dev/cualc?
corresponding callout initial-state and lock-state devices
.El
.sp
.Pp
.Bl -tag -width /etc/rc.serial -compact
.It Pa /etc/rc.serial
examples of setting the initial-state and lock-state devices

3
share/man/man4/fdc.4
View File

@ -34,11 +34,10 @@
.Nd
PC architecture floppy disk controller driver
.Sh SYNOPSIS
.sp
.Cd "controller fdc0 at isa? port" \&"IO_FD1\&" bio irq 6 drq 2 vector fdintr
.Cd "disk fd0 at fdc0 drive 0
.Cd "disk fd1 at fdc0 drive 1
.sp
.Pp
For QIC40 and QIC80 tapedrives controlled by the floppy controller:
.Cd "tape ft0 at fdc0 drive 2
.Sh DESCRIPTION

18
share/man/man4/man4.i386/cy.4
View File

@ -47,18 +47,16 @@ Cyclades Cyclom-8Y and Cyclom-16Y serial driver
.Sh SYNOPSIS
.Cd "device cy0 at isa? tty irq 10 iomem 0xd4000 iosiz 0x2000 vector cyintr
.Cd "device cy1 at isa? tty irq 11 iomem 0xd6000 iosiz 0x2000 vector cyintr
.sp
.Pp
Minor numbering:
.br
..Pp
.Bd -literal
0b\fIOLIMMMMM\fR
.br
call\fBO\fRut
.br
\fBL\fRock
.br
\fBI\fRnitial
.br
\fBMMMMMM\fRinor
.Ed
.Sh DESCRIPTION
The
.Nm cy
@ -120,7 +118,7 @@ Use
.Xr stty 1
in the normal way on the initial-state devices to program
initial termios states suitable for your setup.
.sp
.Pp
The lock termios state acts as flags to disable changing
the termios state. E.g., to lock a flag variable such as
CRTSCTS, use
@ -128,7 +126,7 @@ CRTSCTS, use
on the lock-state device. Speeds and special characters
may be locked by setting the corresponding value in the lock-state
device to any nonzero value.
.sp
.Pp
Correct programs talking to correctly wired external devices
work with almost arbitrary initial states and almost no locking,
but other setups may benefit from changing some of the default
@ -154,7 +152,7 @@ for callin ports
.It Pa /dev/ttyic?
.It Pa /dev/ttylc?
corresponding callin initial-state and lock-state devices
.sp
.Pp
.\" XXX more cloning: s/a/c/g. No consistency :-(.
.It Pa /dev/cuac?
for callout ports
@ -162,7 +160,7 @@ for callout ports
.It Pa /dev/cualc?
corresponding callout initial-state and lock-state devices
.El
.sp
.Pp
.Bl -tag -width /etc/rc.serial -compact
.It Pa /etc/rc.serial
examples of setting the initial-state and lock-state devices

22
share/man/man4/man4.i386/dgb.4
View File

@ -48,7 +48,7 @@ DigiBoard intelligent serial cards driver
.Cd "options" \&"NDGBPORTS=8\&"
.Cd "device dgb0 at isa? tty port 0x220 iomem 0xfc0000 iosiz ? flags 0x0
All values are just examples.
.sp
.Pp
The \fBNDGBPORTS\fR option defines the total number of ports on all cards
installed in the system. When not defined the number is computed:
@ -59,13 +59,13 @@ If it is less than the actual number of ports
the system will be able to use only the
first \fBNDGBPORTS\fR ports. If it is greater then all ports will be usable
but some memory will be wasted.
.sp
.Pp
Meaning of \fBflags\fR:
.br
\fB0x0001\fR use alternate pinout (exchange DCD and DSR lines)
.br
\fB0x0002\fR don't use 8K window mode of PC/Xe
.sp
.Pp
Device numbering:
.br
0b\fICC\fRmmmmmmmm\fIOLIPPPPP\fR
@ -103,12 +103,12 @@ DigiBoard cards have large input and output buffers (more than 1Kbyte per
port) and hardware that allows efficiently finding the port that needs
attention. The only problem seen with this policy is slower
SLIP and PPP response.
.sp
.Pp
Each line in the kernel configuration file describes one card, not one port
as in the
.Nm sio
driver.
.sp
.Pp
The
.Nm flags
keyword may be used on each
@ -120,7 +120,7 @@ which can work with an 8K memory window in compatibility mode
that using 8K memory window doesn't mean shorter input/output buffers, it means
only that all buffers will be mapped to the same memory address and switched as
needed.
.sp
.Pp
The
.Nm port
value must be the same
@ -140,7 +140,7 @@ write the address you want as the
.Nm iomem
value in kernel config file and the card will be programmed
to use this address.
.sp
.Pp
The same range of memory addresses may be used
for all the DigiBoards installed
(but not for any other card or real memory). DigiBoards
@ -192,7 +192,7 @@ Use
.Xr stty 1
in the normal way on the initial-state devices to program
initial termios states suitable for your setup.
.sp
.Pp
The lock termios state acts as flags to disable changing
the termios state. E.g., to lock a flag variable such as
CRTSCTS, use
@ -200,7 +200,7 @@ CRTSCTS, use
on the lock-state device. Speeds and special characters
may be locked by setting the corresponding value in the lock-state
device to any nonzero value.
.sp
.Pp
Correct programs talking to correctly wired external devices
.\" XXX change next line in other man pages too, and rewrite this paragraph.
work with almost arbitrary initial states and no locking,
@ -226,14 +226,14 @@ for callin ports
.It Pa /dev/ttyiD??
.It Pa /dev/ttylD??
corresponding callin initial-state and lock-state devices
.sp
.Pp
.It Pa /dev/cuaD??
for callout ports
.It Pa /dev/cuaiD??
.It Pa /dev/cualD??
corresponding callout initial-state and lock-state devices
.El
.sp
.Pp
.Bl -tag -width /etc/rc.serial -compact
.It Pa /etc/rc.serial
examples of setting the initial-state and lock-state devices

3
share/man/man4/man4.i386/fdc.4
View File

@ -34,11 +34,10 @@
.Nd
PC architecture floppy disk controller driver
.Sh SYNOPSIS
.sp
.Cd "controller fdc0 at isa? port" \&"IO_FD1\&" bio irq 6 drq 2 vector fdintr
.Cd "disk fd0 at fdc0 drive 0
.Cd "disk fd1 at fdc0 drive 1
.sp
.Pp
For QIC40 and QIC80 tapedrives controlled by the floppy controller:
.Cd "tape ft0 at fdc0 drive 2
.Sh DESCRIPTION

9
share/man/man4/man4.i386/gsc.4
View File

@ -38,7 +38,7 @@
.Nd a device driver for a handy scanner
.Sh SYNOPSIS
.Fd #include <machine/gsc.h>
.sp
.Pp
.Cd Minor number bits: Ar uu d g p ...
.Bl -tag -width "uu " -compact -offset indent
.It Ar uu
@ -60,7 +60,7 @@ vs. portable
.Em pnm
output
.El
.sp
.Pp
.Sh DESCRIPTION
The
.Nm gsc
@ -164,8 +164,9 @@ width
Values which are not reported in the above table will cause the ioctl
call to fail with
.Xr errno 2
set to EINVAL.
.sp
set to
.Er EINVAL .
.Pp
As you can see, there are width values > 1696. This does, however, not
mean that you can obtain scanned lines longer than the width of your
scanner or by higher resolutions. Actually, the resolution is selected

4
share/man/man4/man4.i386/labpc.4
View File

@ -51,7 +51,7 @@ National Instruments LABPC and LABPC+ driver
.Sh DESCRIPTION
This supports the National Instruments LABPC and LABPC+ \fILow-Cost
Multifunction I/O Board\fP.
.sp
.Pp
This board provides 8 12 bit A-D input channels, 2 12 bit D-A output
channels, and 3 8 bit digital I/O ports. It also supports setting
up the National Instruments SCXI bus off the digital I/O ports,
@ -120,7 +120,7 @@ integers and returns the cuurrent board gains.
.Sh BUGS
In general, only those capabilities that I needed are present. In
particular the following notable restrictions are present.
.sp
.Pp
The analog input is only supported in a clocked conversion mode.
.Pp
You can only set the sample clock down to 15 Hz. Anything slower

10
share/man/man4/man4.i386/lpt.4
View File

@ -42,22 +42,22 @@ For interrupt-driven ports:
.Cd "device lpt0 at isa? port" \&"IO_LPT1\&" tty irq 7 vector lptintr
.Cd "device lpt1 at isa? port" \&"IO_LPT2\&" tty irq 7 vector lptintr
.Cd "device lpt2 at isa? port" \&"IO_LPT3\&" tty irq 7 vector lptintr
.sp
.Pp
For BIOS-probed ports:
.Cd "device lpt0 at isa? port? tty irq 7 vector lptintr"
.sp
.Pp
For polled ports:
.Cd "device lpt0 at isa? port? tty"
.Cd "device lpt1 at isa? port" \&"IO_LPT2\&" tty
.Sh DESCRIPTION
This driver provides access to parallel ports.
.sp
.Pp
The driver can be configured either to be either interrupt-driven, or
to poll the printer. Ports that are configured to be
interrupt-driven can be switched to polled mode by using the
.Xr lptcontrol 8
command.
.sp
.Pp
This driver replaces the functionality of the
.Xr lpa 4
driver, which is now defunct.
@ -70,7 +70,7 @@ first parallel port driver
.Xr lptcontrol 8
.Sh BUGS
There are lots of them, especially in cheap parallel port implementations.
.sp
.Pp
It is only possible to open a lpt port when a printer is connected and
on-line, making it impossible to run
.Xr lptcontrol 8

6
share/man/man4/man4.i386/matcd.4
View File

@ -89,13 +89,13 @@
.Nm matcd
.Nd Matsushita (Panasonic) CD-ROM driver
.Sh SYNOPSIS
.sp
.Pp
.Cd "controller matcd[0-4] at isa? port [?| addr]"
.br
.Cd "/dev/[r]matcd[0-15][a|c]
.br
.Cd "/dev/[r]matcdl[0-15][a|c]
.sp
.Pp
.Sh DESCRIPTION
The
.Nm matcd
@ -286,7 +286,7 @@ accepts numerous
.Fn ioctl
commands, including disk and functions related to CD-ROM audio and tray
control features. The commands are:
.sp
.Pp
.Bl -tag -width CDIOCREADSUBCHANNELXXX -compact -offset indent
.It DIOCGDINFO
get disklabel.

4
share/man/man4/man4.i386/mcd.4
View File

@ -32,9 +32,7 @@
.Nm mcd
.Nd Mitsumi CD-ROM driver
.Sh SYNOPSIS
.sp
.Cd "device mcd0 at isa? port 0x300 bio irq 10 vector mcdintr"
.sp
.Sh DESCRIPTION
The
.Nm mcd
@ -66,7 +64,7 @@ driver also responds to special CD-ROM
commands. These commands
control the CD-ROM player's audio features.
The commands are:
.sp
.Pp
.Bl -tag -width CDIOCREADSUBCHANNEL -compact -offset indent
.It CDIOCREADSUBCHANNEL
get sub-channel information on current status of disc playing

14
share/man/man4/man4.i386/nca.4
View File

@ -17,16 +17,16 @@ Generic NCR-5380/NCR-53C400 SCSI adapter driver
.Sh SYNOPSIS
Trantor 130, with IRQ:
.Cd "controller nca0 at isa? port 0x350 bio irq 5 vector ncaintr
.sp
.Pp
Trantor 130, without IRQ:
.Cd "controller nca0 at isa? port 0x350
.sp
.Pp
ProAudioSpectrum-16, with IRQ:
.Cd "controller nca0 at isa? port 0x1f88 bio irq 5 vector ncaintr
.Cd "controller nca1 at isa? port 0x1f84 bio irq 5 vector ncaintr
.Cd "controller nca2 at isa? port 0x1f8c bio irq 5 vector ncaintr
.Cd "controller nca3 at isa? port 0x1e88 bio irq 5 vector ncaintr
.sp
.Pp
ProAudioSpectrum-16, without IRQ:
.Cd "controller nca0 at isa? port 0x1f88
.Cd "controller nca1 at isa? port 0x1f84
@ -35,19 +35,19 @@ ProAudioSpectrum-16, without IRQ:
.Sh DESCRIPTION
This driver provides access to SCSI devices connected to
NCR-5380/NCR-53C400 SCSI adapter.
.sp
.Pp
It's possible to use the adapter without IRQ line.
The data rate then slightly decreases (by 20-30%).
.sp
.Pp
The \fBflags\fP keyword in the configuration file can be used to set
some adapter driver parameters:
.sp
.Pp
Bits Description
.br
------------------------------------------
.br
0x01 Disable SCSI bus parity check.
.sp
.Pp
Tested on the following hardware:
.br
Adapter: Trantor T130

2
share/man/man4/man4.i386/scd.4
View File

@ -32,9 +32,7 @@
.Nm scd
.Nd Sony CDU31/33 CD-ROM driver
.Sh SYNOPSIS
.sp
.Cd "device scd0 at isa? port 0x230 bio"
.sp
.Sh DESCRIPTION
The
.Nm scd

26
share/man/man4/man4.i386/sea.4
View File

@ -18,55 +18,55 @@ Seagate ST01/ST02, Future Domain TMC-885, TMC-950 SCSI adapter driver
.Sh SYNOPSIS
With explicit memory and IRQ parameters:
.Cd "controller sea0 at isa? bio irq 5 iomem 0xc8000 vector seaintr
.sp
.Pp
With automatic memory address detection and no IRQ:
.Cd "controller sea0 at isa?
.sp
.Pp
.Cd "controller scbus0
.sp
.Pp
For each connected disk:
.Cd "device sd0
.sp
.Pp
For each connected tape device:
.Cd "device st0
.sp
.Pp
For one or more cdroms:
.Cd "device cd0
.Sh DESCRIPTION
This driver provides access to SCSI devices connected to Seagate ST01/ST02 or
Future Domain TMC-885, TMC-950 SCSI adapter.
.sp
.Pp
It's possible to use the Seagate ST01/ST02 adapter without IRQ line.
The data rate then slightly decreases (by 20-30%).
.sp
.Pp
The \fBflags\fP keyword in the configuration file can be used to set
some adapter driver parameters:
.sp
.Pp
Bits Description
.br
------------------------------------------
.br
0x01 Disable SCSI bus parity check.
.sp
.Pp
The original Seagate ST02
BIOS cannot coexist with IDE or any other disk controller
because it does not share BIOS disk drive numbers (80h, 81h)
with others. The probing code of the driver allows using ST02 controller
without BIOS: just unplug the ST02 BIOS chip from the board.
.sp
.Pp
Another problem is the floppy adapter on ST02 which could not be
disabled by jumpers. The ST02 adapter it the best as a cheap solution
for atttaching the tape and CD-ROM drives, and an extra floppy controller
is just a headache. There exist a simple workaround: cutting off
the AEN signal (A11 contact on ISA connector). AEN then goes high and
disables the floppy adapter port address decoder.
.sp
.Pp
Some motherboards also have a problem with ST02 conflicting with IDE during
IDE data write phase. It seems than ST02 makes some noise
on /IOW line. The /IOW line is used only for floppy controller
part of ST02, and because it's rarely needed, cutting off the /IOW
(contact B13) will help.
.sp
.Pp
Tested on the following hardware:
.br
Adapter: Seagate ST02
@ -76,7 +76,7 @@ Tested on the following hardware:
Streamers: Archive Viper 150, Wangtek 5525
.br
CD-ROMs: Toshiba XM-3401, NEC CDR-25
.sp
.Pp
Maximum data rate is about 270-280 kbytes/sec (on 386DX/40).
.Sh FILES
.Bl -tag -width Pa -compact

28
share/man/man4/man4.i386/sio.4
View File

@ -49,24 +49,24 @@ For standard ports:
.Cd "device sio1 at isa? port" \&"IO_COM2\&" tty irq 3 vector siointr
.Cd "device sio2 at isa? port" \&"IO_COM3\&" tty irq 5 vector siointr
.Cd "device sio3 at isa? port" \&"IO_COM4\&" tty irq 9 vector siointr
.sp
.Pp
For AST compatible multiport cards with 4 ports:
.Cd "options" \&"COM_MULTIPORT\&"
.Cd "device sio4 at isa? port 0x2a0 tty flags 0x701"
.Cd "device sio5 at isa? port 0x2a8 tty flags 0x701"
.Cd "device sio6 at isa? port 0x2b0 tty flags 0x701"
.Cd "device sio7 at isa? port 0x2b8 tty flags 0x701 irq 12 vector siointr"
.sp
.Pp
For Boca Board compatible multiport cards with 8 ports:
.Cd "options" \&"COM_MULTIPORT\&"
.Cd "device sio4 at isa? port 0x100 tty flags 0xb05"
.Cd "..."
.Cd "device sio11 at isa? port 0x138 tty flags 0xb05 irq 12 vector siointr"
.sp
.Pp
For Hayes ESP cards:
.Cd "options" \&"COM_ESP\&"
.Cd "..."
.sp
.Pp
Meaning of \fBflags\fR:
.br
\fB0x0001\fR shared IRQs
@ -80,7 +80,7 @@ Meaning of \fBflags\fR:
\fB0x0080\fR enable diagnostics in probe
.br
\fB0x\fI??\fB00\fR minor number of master port
.sp
.Pp
Minor numbering:
.br
0b\fIOLIMMMMM\fR
@ -116,7 +116,7 @@ Frequently 4 ports share 1 IRQ; some 8 port cards have 2 groups of 4 ports,
thus using 2 IRQs.
Some cards allow the first 2 serial ports to have seperate IRQs per port
(as per DOS PC standard).
.sp
.Pp
Some cards have an IRQ control register for each group.
Some cards require special initialization related to such registers.
Only AST/4 compatible IRQ control registers are supported.
@ -128,7 +128,7 @@ of a port in the group.
Such a port is called a
.Nm master
port.
.sp
.Pp
The
.Nm flags
keyword may be used on each
@ -140,7 +140,7 @@ or to disable the FIFO on 16550A UARTs
Disabling the FIFO should rarely be necessary
since the driver automatically adjusts the receiver
FIFO trigger level for low latency and high efficiency.
.sp
.Pp
The
.Nm flags
keyword
@ -152,7 +152,7 @@ require AST/4 compatible initialization.
The minor number of the device corresponding a master port
for the group is encoded as a bitfield in the high byte.
The same master port must be specified for all ports in a group.
.sp
.Pp
The
.Nm irq
and
@ -166,7 +166,7 @@ In the synopsis,
means that the 8th port (sio7) is the master
port, and that the port is on a multiport card with shared IRQs
and an AST/4 compatible IRQ control register.
.sp
.Pp
.Nm flags 0xb05
means that the 12th port (sio11) is the master
port, and that the port is on a multiport card with shared IRQs
@ -214,7 +214,7 @@ Use
.Xr stty 1
in the normal way on the initial-state devices to program
initial termios states suitable for your setup.
.sp
.Pp
The lock termios state acts as flags to disable changing
the termios state. E.g., to lock a flag variable such as
CRTSCTS, use
@ -222,7 +222,7 @@ CRTSCTS, use
on the lock-state device. Speeds and special characters
may be locked by setting the corresponding value in the lock-state
device to any nonzero value.
.sp
.Pp
Correct programs talking to correctly wired external devices
work with almost arbitrary initial states and almost no locking,
but other setups may benefit from changing some of the default
@ -247,14 +247,14 @@ for callin ports
.It Pa /dev/ttyid?
.It Pa /dev/ttyld?
corresponding callin initial-state and lock-state devices
.sp
.Pp
.It Pa /dev/cuaa?
for callout ports
.It Pa /dev/cuaia?
.It Pa /dev/cuala?
corresponding callout initial-state and lock-state devices
.El
.sp
.Pp
.Bl -tag -width /etc/rc.serial -compact
.It Pa /etc/rc.serial
examples of setting the initial-state and lock-state devices

11
share/man/man4/man4.i386/uha.4
View File

@ -33,27 +33,26 @@
.Nd
Ultrastore SCSI host adapter driver
.Sh SYNOPSIS
.sp
For Ultrastore 24f controllers in EISA mode:
.Cd "controller uha0 at isa? bio irq ? vector uhaintr
.Cd "controller scbus0
.sp
.Pp
For Ultrastore 14f and 34f controllers:
.Cd "controller uha0 at isa? port" \&"IO_UHA0\&" bio irq ? drq 5 vector uhaintr
.Cd "controller scbus0
.sp
.Pp
For each disk:
.Cd "device sd0
.sp
.Pp
For each tape device:
.Cd "device st0
.sp
.Pp
For one or more cdroms:
.Cd "device cd0
.Sh DESCRIPTION
This driver provides access to SCSI devices connected to an Ultrastore
Ultrastore 14f, Ultrastore 24f or Ultrastore 34f hostadapter.
.sp
.Pp
Note that for an Ultrastore 24f in EISA mode no I/O addresses or DMA channels
are required in the kernel config file. If they are present, the driver
will correctly find the Ultrastore 24f, but you tie up precious DMA channels

14
share/man/man4/man4.i386/wd.4
View File

@ -33,25 +33,23 @@
.Nd
Generic WD100x/IDE diskcontroller driver
.Sh SYNOPSIS
.sp
.Cd "controller wdc0 at isa? port" \&"IO_WD1\&" bio irq 14 vector wdintr
.Cd "disk wd0 at wdc0 drive 0
.Cd "disk wd1 at wdc0 drive 1
.sp
.Sh DESCRIPTION
This driver provides access to disks connected to controllers that emulate
the Western Digital WD100x series. This range of controllers includes WD1003
type ST412 controllers, WD1007 ESDI controllers and also the generic IDE
controllers found on most motherboards.
.sp
.Pp
Your controller documentation is usually quick to point out any WD100x
compatibility.
.sp
.Pp
You can convey a number of hints and instructions to the driver using
the
.Ar flags
parameter.
.sp
.Pp
For each drive there are four bit-fields encoded in a 16 bit integer:
.Bl -tag -width 0x0000 -offset 1c
.It 0x8000
@ -66,7 +64,7 @@ of cylinders to match.
Test and use multi-sector transfer mode of this drive, max number of
sectors attempted is (flags & 0x00ff).
.El
.sp
.Pp
The flags can be specified on the line for the drive as a 16 bit int,
or on the controller line as a 32 bit int, where the top 16 bit is
relevant to the highest numbered drive.
@ -85,4 +83,6 @@ driver source
.Xr bad144 8
.Sh NOTES
This controller/disk combo has no provisions for automatic bad block handling.
You need to run bad144(8) to check for bad blocks.
You need to run
.Xr bad144 8
to check for bad blocks.

28
share/man/man4/sio.4
View File

@ -49,24 +49,24 @@ For standard ports:
.Cd "device sio1 at isa? port" \&"IO_COM2\&" tty irq 3 vector siointr
.Cd "device sio2 at isa? port" \&"IO_COM3\&" tty irq 5 vector siointr
.Cd "device sio3 at isa? port" \&"IO_COM4\&" tty irq 9 vector siointr
.sp
.Pp
For AST compatible multiport cards with 4 ports:
.Cd "options" \&"COM_MULTIPORT\&"
.Cd "device sio4 at isa? port 0x2a0 tty flags 0x701"
.Cd "device sio5 at isa? port 0x2a8 tty flags 0x701"
.Cd "device sio6 at isa? port 0x2b0 tty flags 0x701"
.Cd "device sio7 at isa? port 0x2b8 tty flags 0x701 irq 12 vector siointr"
.sp
.Pp
For Boca Board compatible multiport cards with 8 ports:
.Cd "options" \&"COM_MULTIPORT\&"
.Cd "device sio4 at isa? port 0x100 tty flags 0xb05"
.Cd "..."
.Cd "device sio11 at isa? port 0x138 tty flags 0xb05 irq 12 vector siointr"
.sp
.Pp
For Hayes ESP cards:
.Cd "options" \&"COM_ESP\&"
.Cd "..."
.sp
.Pp
Meaning of \fBflags\fR:
.br
\fB0x0001\fR shared IRQs
@ -80,7 +80,7 @@ Meaning of \fBflags\fR:
\fB0x0080\fR enable diagnostics in probe
.br
\fB0x\fI??\fB00\fR minor number of master port
.sp
.Pp
Minor numbering:
.br
0b\fIOLIMMMMM\fR
@ -116,7 +116,7 @@ Frequently 4 ports share 1 IRQ; some 8 port cards have 2 groups of 4 ports,
thus using 2 IRQs.
Some cards allow the first 2 serial ports to have seperate IRQs per port
(as per DOS PC standard).
.sp
.Pp
Some cards have an IRQ control register for each group.
Some cards require special initialization related to such registers.
Only AST/4 compatible IRQ control registers are supported.
@ -128,7 +128,7 @@ of a port in the group.
Such a port is called a
.Nm master
port.
.sp
.Pp
The
.Nm flags
keyword may be used on each
@ -140,7 +140,7 @@ or to disable the FIFO on 16550A UARTs
Disabling the FIFO should rarely be necessary
since the driver automatically adjusts the receiver
FIFO trigger level for low latency and high efficiency.
.sp
.Pp
The
.Nm flags
keyword
@ -152,7 +152,7 @@ require AST/4 compatible initialization.
The minor number of the device corresponding a master port
for the group is encoded as a bitfield in the high byte.
The same master port must be specified for all ports in a group.
.sp
.Pp
The
.Nm irq
and
@ -166,7 +166,7 @@ In the synopsis,
means that the 8th port (sio7) is the master
port, and that the port is on a multiport card with shared IRQs
and an AST/4 compatible IRQ control register.
.sp
.Pp
.Nm flags 0xb05
means that the 12th port (sio11) is the master
port, and that the port is on a multiport card with shared IRQs
@ -214,7 +214,7 @@ Use
.Xr stty 1
in the normal way on the initial-state devices to program
initial termios states suitable for your setup.
.sp
.Pp
The lock termios state acts as flags to disable changing
the termios state. E.g., to lock a flag variable such as
CRTSCTS, use
@ -222,7 +222,7 @@ CRTSCTS, use
on the lock-state device. Speeds and special characters
may be locked by setting the corresponding value in the lock-state
device to any nonzero value.
.sp
.Pp
Correct programs talking to correctly wired external devices
work with almost arbitrary initial states and almost no locking,
but other setups may benefit from changing some of the default
@ -247,14 +247,14 @@ for callin ports
.It Pa /dev/ttyid?
.It Pa /dev/ttyld?
corresponding callin initial-state and lock-state devices
.sp
.Pp
.It Pa /dev/cuaa?
for callout ports
.It Pa /dev/cuaia?
.It Pa /dev/cuala?
corresponding callout initial-state and lock-state devices
.El
.sp
.Pp
.Bl -tag -width /etc/rc.serial -compact
.It Pa /etc/rc.serial
examples of setting the initial-state and lock-state devices