system/freebsd-src
system/freebsd-src
1
0
Fork 0
mirror of https://github.com/freebsd/freebsd-src synced 2024-11-05 18:22:52 +00:00
Code Issues Projects Releases Packages Wiki Activity

Add in the adv(4) and adw(4) man pages for the AdvanSys narrow and wide

Browse source 
SCSI controllers, respectively.

Once these drivers are tested on the alpha, these man pages can probably be
moved up a directory to reflect the fact that they're architecture
independent.

An mdoc guru should probably look at the AUTHORS sections in both of these
pages -- the .An macro seems to cause strange spacing problems.

Reviewed by:	ken
Submitted by:	gibbs
This commit is contained in:
Kenneth D. Merry 1998-10-16 21:12:07 +00:00
parent d800cebf61
commit 976f6cbd90
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=40460
5 changed files with 504 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

170
share/man/man4/adv.4 Normal file
View file

@ -0,0 +1,170 @@
.\"
.\" Copyright (c) 1998
.\" Justin T. Gibbs. 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. The name of the author may not be used to endorse or promote products
.\" derived from this software withough 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$
.\"
.Dd October 16, 1998
.Dt ADV 4 i386
.Os FreeBSD
.Sh NAME
.Nm adv
.Nd Advansys ISA/VL/EISA/PCI 8bit SCSI Host adapter driver
.Sh SYNOPSIS
For one or more ISA or VL cards:
.Cd controller isa0
.Cd controller "adv0 at isa? port ? cam irq ? drq ?"
.Pp
For one or more EISA cards:
.Cd controller eisa0
.Cd controller adv0
.Pp
For one or more PCI cards:
.Cd controller pci0
.Cd controller adv0
.Pp
For one or more SCSI busses:
.Cd controller scbus0 at adv0
.Sh DESCRIPTION
This driver provides access to the 8bit
.Tn SCSI
bus connected to the Advanced Systems Products, Inc.
.Tn ASC900 ,
.Tn ASC1000 ,
.Tn ASC1090 ,
.Tn ASC1200 ,
.Tn ASC3050 ,
and
.Tn ASC3150
host adapter chips.
The following tables list the AdvanSys products using these chips,
their bus attachment type, maximum sync rate, and the maximum number of
commands that can be handled by the adapter concurrently.
.Pp
.Bd -filled -offset indent
.Bl -column "ABP510/5150 " "ISA PnP " "Yes " "10MHz " "Commands " Footnotes
Connectivity Products:
.Pp
.Em "Adapter Bus Floppy MaxSync Commands Footnotes"
ABP510/5150 ISA No 10MHz 240 1
ABP5140 ISA PnP No 10MHz 16 1, 3
ABP5142 ISA PnP Yes 10MHz 16 4
ABP920 PCI No 10MHz 16
ABP930 PCI No 10MHz 16 5
ABP930U PCI No 20MHz 16
ABP930UA PCI No 20MHz 16
ABP960 PCI No 10MHz 16 2
ABP960U PCI No 20MHz 16 2
.El
.Pp
Footnotes:
.Bl -enum -compact
.It
This board has been shipped by HP with the 4020i CD-R drive.
The board has no BIOS so it cannot control a boot device, but
it can control any secondary SCSI device.
.It
This board has been sold by Iomega as a Jaz Jet PCI adapter.
.It
This board has been sold by SIIG as the i540 SpeedMaster.
.It
This board has been sold by SIIG as the i542 SpeedMaster.
.It
This board has been sold by SIIG as the Fast SCSI Pro PCI.
.El
.Ed
.Pp
.Bd -filled -offset indent
.Bl -column "ABP510/5150 " "ISA PnP " "Yes " "10MHz " Commands
Single Channel Products:
.Pp
.Em "Adapter Bus Floppy MaxSync Commands"
ABP542 ISA Yes 10MHz 240
ABP742 EISA Yes 10MHz 240
ABP842 VL Yes 10MHz 240
ABP940 PCI No 10MHz 240
ABP940U PCI No 20MHz 240
ABP970 PCI No 10MHz 240
ABP970U PCI No 20MHz 240
.El
.Ed
.Pp
.Bd -filled -offset indent
.Bl -column "ABP510/5150 " "ISA PnP " "Yes " "10MHz " "Commands " "Channels "
Multi Channel Products (Commands are per-channel):
.Pp
.Em "Adapter Bus Floppy MaxSync Commands Channels"
ABP752 EISA Yes 10MHz 240 2
ABP852 VL Yes 10MHz 240 2
ABP950 PCI No 10MHz 240 2
ABP980 PCI No 10MHz 240 4
ABP980U PCI No 20MHz 240 4
.El
.Ed
.Pp
For ISA or Vesa Local Bus adapters, one kernel config entry is required
for every card to be attached by the system. Specific values for the port
address, irq, and drq may be specified. If wildcard values are used, the
driver will query the device for its current settings and use those. If
the port address is a wildcard, the driver consults an internal table of
possible port address locations and attaches to the first unattached card
it finds. The possible port addresses for these card are 0x110, 0x130,
0x150, 0x190, 0x210, 0x230, 0x250, and 0x330.
.Pp
Per target configuration performed in the
.Tn AdvanceWare
menu, which is accessible at boot,
is honored by this driver.
This includes synchronous/asynchronous transfers,
maximum synchronous negotiation rate, disconnection, tagged queueing,
and the host adapter's SCSI ID.
The global setting for the maximum number of tagged transactions allowed
per target is not honored as the CAM SCSI system will automatically determine
the maximum number of tags a device can receive as well as guarantee fair
resource allocation among devices.
.Sh SEE ALSO
.Xr adw 4 ,
.Xr aha 4 ,
.Xr ahb 4 ,
.Xr ahc 4 ,
.Xr cd 4 ,
.Xr da 4 ,
.Xr sa 4 ,
.Xr scsi 4
.Sh AUTHORS
The
.Nm adv
driver was ported by
.An Justin T. Gibbs
from the Linux driver
written by
.An Bob Frey
of Advanced System Products, Inc.
Many thanks to AdvanSys for providing the original driver under a suitable
license for use in FreeBSD.
.Sh HISTORY
The
.Nm
driver appeared in
.Fx 3.0 .

79
share/man/man4/adw.4 Normal file
View file

@ -0,0 +1,79 @@
.\"
.\" Copyright (c) 1998
.\" Justin T. Gibbs. 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. The name of the author may not be used to endorse or promote products
.\" derived from this software withough 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$
.\"
.Dd October 16, 1998
.Dt ADW 4 i386
.Os FreeBSD
.Sh NAME
.Nm adw
.Nd Advansys PCI 16bit SCSI Host adapter driver
.Sh SYNOPSIS
.Cd controller pci0
.Cd controller adw0
.Pp
For one or more SCSI busses:
.Cd controller scbus0 at adw0
.Sh DESCRIPTION
This driver provides access to the 16bit
.Tn SCSI
bus connected to the Advanced Systems Products, Inc.
.Tn ASC3550
as found on the ABP940UW SCSI Host Adapter board. This chip
supports, Ultra SCSI (20MHz), 16bit transfers, tagged queueing,
and up to 253 concurrent SCSI transactions.
.Pp
Per target configuration performed in the
.Tn AdvanceWare
menu, which is accessible at boot,
is honored by this driver.
This includes synchronous/asynchronous transfers,
maximum synchronous negotiation rate, wide transfers, disconnection,
tagged queueing, and the host adapter's SCSI ID.
The global setting for the maximum number of tagged transactions allowed
per target is not honored as the CAM SCSI system will automatically determine
the maximum number of tags a device can receive as well as guarantee fair
resource allocation among devices.
.Sh SEE ALSO
.Xr adv 4 ,
.Xr cd 4 ,
.Xr scsi 4 ,
.Xr da 4 ,
.Xr sa 4
.Sh AUTHORS
The
.Nm
driver was ported by
.An Justin T. Gibbs
from the Linux driver written by
.An Bob Frey
of Advanced System Products, Inc. Many thanks to AdvanSys for providing
the original driver under a suitable license for use in FreeBSD.
.Sh HISTORY
The
.Nm
driver appeared in
.Fx 3.0 .

10
share/man/man4/man4.i386/Makefile
View file

@ -1,7 +1,7 @@
# $Id: Makefile,v 1.80 1998/08/19 01:54:13 jkoshy Exp $
# $Id: Makefile,v 1.81 1998/10/15 20:35:28 wosch Exp $
MAN4= aha.4 ahb.4 ahc.4 aic.4 alog.4 apm.4 ar.4 asc.4 bktr.4 bt.4 \
cs.4 cx.4 cy.4 de.4 \
MAN4= adv.4 adw.4 aha.4 ahb.4 ahc.4 aic.4 alog.4 apm.4 ar.4 asc.4 bktr.4 \
bt.4 cs.4 cx.4 cy.4 de.4 \
dgb.4 ed.4 eg.4 el.4 en.4 ep.4 ex.4 fdc.4 fe.4 fxp.4 gsc.4 ie.4 io.4 \
joy.4 keyboard.4 labpc.4 le.4 lnc.4 lp.4 lpt.4 matcd.4 mcd.4 mem.4 \
meteor.4 mouse.4 mse.4 mtio.4 nca.4 ncr.4 npx.4 \
@ -10,7 +10,9 @@ MAN4= aha.4 ahb.4 ahc.4 aic.4 alog.4 apm.4 ar.4 asc.4 bktr.4 bt.4 \
spkr.4 sr.4 sysmouse.4 tl.4 tw.4 tx.4 uha.4 vx.4 \
wd.4 wfd.4 wl.4 wt.4 xl.4 ze.4 zp.4
MLINKS= aha.4 ../aha.4
MLINKS= adv.4 ../adv.4
MLINKS+= adw.4 ../adw.4
MLINKS+= aha.4 ../aha.4
MLINKS+= ahb.4 ../ahb.4
MLINKS+= ahc.4 ../ahc.4
MLINKS+= aic.4 ../aic.4

170
share/man/man4/man4.i386/adv.4 Normal file
View file

@ -0,0 +1,170 @@
.\"
.\" Copyright (c) 1998
.\" Justin T. Gibbs. 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. The name of the author may not be used to endorse or promote products
.\" derived from this software withough 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$
.\"
.Dd October 16, 1998
.Dt ADV 4 i386
.Os FreeBSD
.Sh NAME
.Nm adv
.Nd Advansys ISA/VL/EISA/PCI 8bit SCSI Host adapter driver
.Sh SYNOPSIS
For one or more ISA or VL cards:
.Cd controller isa0
.Cd controller "adv0 at isa? port ? cam irq ? drq ?"
.Pp
For one or more EISA cards:
.Cd controller eisa0
.Cd controller adv0
.Pp
For one or more PCI cards:
.Cd controller pci0
.Cd controller adv0
.Pp
For one or more SCSI busses:
.Cd controller scbus0 at adv0
.Sh DESCRIPTION
This driver provides access to the 8bit
.Tn SCSI
bus connected to the Advanced Systems Products, Inc.
.Tn ASC900 ,
.Tn ASC1000 ,
.Tn ASC1090 ,
.Tn ASC1200 ,
.Tn ASC3050 ,
and
.Tn ASC3150
host adapter chips.
The following tables list the AdvanSys products using these chips,
their bus attachment type, maximum sync rate, and the maximum number of
commands that can be handled by the adapter concurrently.
.Pp
.Bd -filled -offset indent
.Bl -column "ABP510/5150 " "ISA PnP " "Yes " "10MHz " "Commands " Footnotes
Connectivity Products:
.Pp
.Em "Adapter Bus Floppy MaxSync Commands Footnotes"
ABP510/5150 ISA No 10MHz 240 1
ABP5140 ISA PnP No 10MHz 16 1, 3
ABP5142 ISA PnP Yes 10MHz 16 4
ABP920 PCI No 10MHz 16
ABP930 PCI No 10MHz 16 5
ABP930U PCI No 20MHz 16
ABP930UA PCI No 20MHz 16
ABP960 PCI No 10MHz 16 2
ABP960U PCI No 20MHz 16 2
.El
.Pp
Footnotes:
.Bl -enum -compact
.It
This board has been shipped by HP with the 4020i CD-R drive.
The board has no BIOS so it cannot control a boot device, but
it can control any secondary SCSI device.
.It
This board has been sold by Iomega as a Jaz Jet PCI adapter.
.It
This board has been sold by SIIG as the i540 SpeedMaster.
.It
This board has been sold by SIIG as the i542 SpeedMaster.
.It
This board has been sold by SIIG as the Fast SCSI Pro PCI.
.El
.Ed
.Pp
.Bd -filled -offset indent
.Bl -column "ABP510/5150 " "ISA PnP " "Yes " "10MHz " Commands
Single Channel Products:
.Pp
.Em "Adapter Bus Floppy MaxSync Commands"
ABP542 ISA Yes 10MHz 240
ABP742 EISA Yes 10MHz 240
ABP842 VL Yes 10MHz 240
ABP940 PCI No 10MHz 240
ABP940U PCI No 20MHz 240
ABP970 PCI No 10MHz 240
ABP970U PCI No 20MHz 240
.El
.Ed
.Pp
.Bd -filled -offset indent
.Bl -column "ABP510/5150 " "ISA PnP " "Yes " "10MHz " "Commands " "Channels "
Multi Channel Products (Commands are per-channel):
.Pp
.Em "Adapter Bus Floppy MaxSync Commands Channels"
ABP752 EISA Yes 10MHz 240 2
ABP852 VL Yes 10MHz 240 2
ABP950 PCI No 10MHz 240 2
ABP980 PCI No 10MHz 240 4
ABP980U PCI No 20MHz 240 4
.El
.Ed
.Pp
For ISA or Vesa Local Bus adapters, one kernel config entry is required
for every card to be attached by the system. Specific values for the port
address, irq, and drq may be specified. If wildcard values are used, the
driver will query the device for its current settings and use those. If
the port address is a wildcard, the driver consults an internal table of
possible port address locations and attaches to the first unattached card
it finds. The possible port addresses for these card are 0x110, 0x130,
0x150, 0x190, 0x210, 0x230, 0x250, and 0x330.
.Pp
Per target configuration performed in the
.Tn AdvanceWare
menu, which is accessible at boot,
is honored by this driver.
This includes synchronous/asynchronous transfers,
maximum synchronous negotiation rate, disconnection, tagged queueing,
and the host adapter's SCSI ID.
The global setting for the maximum number of tagged transactions allowed
per target is not honored as the CAM SCSI system will automatically determine
the maximum number of tags a device can receive as well as guarantee fair
resource allocation among devices.
.Sh SEE ALSO
.Xr adw 4 ,
.Xr aha 4 ,
.Xr ahb 4 ,
.Xr ahc 4 ,
.Xr cd 4 ,
.Xr da 4 ,
.Xr sa 4 ,
.Xr scsi 4
.Sh AUTHORS
The
.Nm adv
driver was ported by
.An Justin T. Gibbs
from the Linux driver
written by
.An Bob Frey
of Advanced System Products, Inc.
Many thanks to AdvanSys for providing the original driver under a suitable
license for use in FreeBSD.
.Sh HISTORY
The
.Nm
driver appeared in
.Fx 3.0 .

79
share/man/man4/man4.i386/adw.4 Normal file
View file

@ -0,0 +1,79 @@
.\"
.\" Copyright (c) 1998
.\" Justin T. Gibbs. 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. The name of the author may not be used to endorse or promote products
.\" derived from this software withough 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$
.\"
.Dd October 16, 1998
.Dt ADW 4 i386
.Os FreeBSD
.Sh NAME
.Nm adw
.Nd Advansys PCI 16bit SCSI Host adapter driver
.Sh SYNOPSIS
.Cd controller pci0
.Cd controller adw0
.Pp
For one or more SCSI busses:
.Cd controller scbus0 at adw0
.Sh DESCRIPTION
This driver provides access to the 16bit
.Tn SCSI
bus connected to the Advanced Systems Products, Inc.
.Tn ASC3550
as found on the ABP940UW SCSI Host Adapter board. This chip
supports, Ultra SCSI (20MHz), 16bit transfers, tagged queueing,
and up to 253 concurrent SCSI transactions.
.Pp
Per target configuration performed in the
.Tn AdvanceWare
menu, which is accessible at boot,
is honored by this driver.
This includes synchronous/asynchronous transfers,
maximum synchronous negotiation rate, wide transfers, disconnection,
tagged queueing, and the host adapter's SCSI ID.
The global setting for the maximum number of tagged transactions allowed
per target is not honored as the CAM SCSI system will automatically determine
the maximum number of tags a device can receive as well as guarantee fair
resource allocation among devices.
.Sh SEE ALSO
.Xr adv 4 ,
.Xr cd 4 ,
.Xr scsi 4 ,
.Xr da 4 ,
.Xr sa 4
.Sh AUTHORS
The
.Nm
driver was ported by
.An Justin T. Gibbs
from the Linux driver written by
.An Bob Frey
of Advanced System Products, Inc. Many thanks to AdvanSys for providing
the original driver under a suitable license for use in FreeBSD.
.Sh HISTORY
The
.Nm
driver appeared in
.Fx 3.0 .