Merge branch 'vendor/OPENSSH'
[dragonfly.git] / share / man / man4 / adv.4
1 .\"
2 .\" Copyright (c) 1998, 2000
3 .\"     Justin T. Gibbs.  All rights reserved.
4 .\"
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
7 .\" are met:
8 .\" 1. Redistributions of source code must retain the above copyright
9 .\"    notice, this list of conditions and the following disclaimer.
10 .\" 2. The name of the author may not be used to endorse or promote products
11 .\"    derived from this software without specific prior written permission.
12 .\"
13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
14 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
15 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
16 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
17 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
18 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
19 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
20 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
21 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
22 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
23 .\"
24 .\" $FreeBSD: src/share/man/man4/adv.4,v 1.7.4.6 2001/10/01 13:07:22 dd Exp $
25 .\" $DragonFly: src/share/man/man4/adv.4,v 1.4 2008/05/02 02:05:05 swildner Exp $
26 .\"
27 .Dd February 13, 2000
28 .Dt ADV 4
29 .Os
30 .Sh NAME
31 .Nm adv
32 .Nd Advansys ISA/VL/EISA/PCI 8bit SCSI Host adapter driver
33 .Sh SYNOPSIS
34 For one or more ISA or VL cards:
35 .Cd device isa
36 .Cd device "adv0 at isa? port ? irq ? drq ?"
37 .Pp
38 For one or more EISA cards:
39 .Cd device eisa
40 .Cd device adv
41 .Pp
42 For one or more PCI cards:
43 .Cd device pci
44 .Cd device adv
45 .Pp
46 For one or more SCSI busses:
47 .Cd device scbus0 at adv0
48 .Sh DESCRIPTION
49 This driver provides access to the 8bit
50 .Tn SCSI
51 bus connected to the Advanced Systems Products, Inc.
52 .Tn ASC900 ,
53 .Tn ASC1000 ,
54 .Tn ASC1090 ,
55 .Tn ASC1200 ,
56 .Tn ASC3030 ,
57 .Tn ASC3050 ,
58 and
59 .Tn ASC3150
60 host adapter chips.
61 The following tables list the AdvanSys products using these chips,
62 their bus attachment type, maximum sync rate, and the maximum number of
63 commands that can be handled by the adapter concurrently.
64 .Bd -ragged -offset indent
65 Connectivity Products:
66 .Bl -column "ABP510/5150 " "ISA PnP " "Floppy " "MaxSync " "Commands " "Footnotes "
67 .It Em Adapter Ta Em Bus Ta Em Floppy Ta Em MaxSync Ta Em Commands Ta Em Footnotes
68 .It ABP510/5150 Ta ISA Ta \&No Ta 10MHz Ta 240 Ta 1
69 .It ABP5140 Ta ISA PnP Ta \&No Ta 10MHz Ta 16 Ta "1,3"
70 .It ABP5142 Ta ISA PnP Ta Yes Ta 10MHz Ta 16 Ta 4
71 .It ABP[3]902 Ta PCI Ta \&No Ta 10MHz Ta 16
72 .It ABP3905 Ta PCI Ta \&No Ta 10MHz Ta 16
73 .It ABP915 Ta PCI Ta \&No Ta 10MHz Ta 16
74 .It ABP920 Ta PCI Ta \&No Ta 10MHz Ta 16
75 .It ABP3922 Ta PCI Ta \&No Ta 10MHz Ta 16
76 .It ABP3925 Ta PCI Ta \&No Ta 10MHz Ta 16
77 .It ABP930 Ta PCI Ta \&No Ta 10MHz Ta 16 Ta 5
78 .It ABP930U Ta PCI Ta \&No Ta 20MHz Ta 16
79 .It ABP930UA Ta PCI Ta \&No Ta 20MHz Ta 16
80 .It ABP960 Ta PCI Ta \&No Ta 10MHz Ta 16
81 .It ABP960U Ta PCI Ta \&No Ta 20MHz Ta 16
82 .El
83 .Pp
84 Footnotes:
85 .Bl -enum -compact
86 .It
87 This board has been shipped by HP with the 4020i CD-R drive.
88 The board has no BIOS so it cannot control a boot device, but
89 it can control any secondary SCSI device.
90 .It
91 This board has been sold by Iomega as a Jaz Jet PCI adapter.
92 .It
93 This board has been sold by SIIG as the i540 SpeedMaster.
94 .It
95 This board has been sold by SIIG as the i542 SpeedMaster.
96 .It
97 This board has been sold by SIIG as the Fast SCSI Pro PCI.
98 .El
99 .Ed
100 .Bd -ragged -offset indent
101 Single Channel Products:
102 .Bl -column "ABP510/5150 " "ISA PnP " "Floppy " "MaxSync " "Commands "
103 .It Em Adapter Ta Em Bus Ta Em Floppy Ta Em MaxSync Ta Em Commands
104 .It ABP542 Ta ISA Ta Yes Ta 10MHz Ta 240
105 .It ABP742 Ta EISA Ta Yes Ta 10MHz Ta 240
106 .It ABP842 Ta VL Ta Yes Ta 10MHz Ta 240
107 .It ABP940 Ta PCI Ta \&No Ta 10MHz Ta 240
108 .It ABP[3]940UA Ta PCI Ta \&No Ta 20MHz Ta 240
109 .It ABP940U Ta PCI Ta \&No Ta 20MHz Ta 240
110 .It ABP3960UA Ta PCI Ta \&No Ta 20MHz Ta 240
111 .It ABP970 Ta PCI Ta \&No Ta 10MHz Ta 240
112 .It ABP970U Ta PCI Ta \&No Ta 20MHz Ta 240
113 .El
114 .Ed
115 .Bd -ragged -offset indent
116 Multi Channel Products (Commands are per-channel):
117 .Bl -column "ABP510/5150 " "ISA PnP " "Floppy " "MaxSync " "Commands " "Channels "
118 .It Em Adapter Ta Em Bus Ta Em Floppy Ta Em MaxSync Ta Em Commands Ta Em Channels
119 .It ABP752 Ta EISA Ta Yes Ta 10MHz Ta 240 Ta 2
120 .It ABP852 Ta VL Ta Yes Ta 10MHz Ta 240 Ta 2
121 .It ABP950 Ta PCI Ta \&No Ta 10MHz Ta 240 Ta 2
122 .It ABP980 Ta PCI Ta \&No Ta 10MHz Ta 240 Ta 4
123 .It ABP980U Ta PCI Ta \&No Ta 20MHz Ta 240 Ta 4
124 .It ABP[3]980UA Ta PCI Ta \&No Ta 20MHz Ta 16 Ta 4
125 .El
126 .Ed
127 .Pp
128 For ISA or Vesa Local Bus adapters, one kernel config entry is required
129 for every card to be attached by the system.  Specific values for the port
130 address, irq, and drq may be specified.  If wildcard values are used, the
131 driver will query the device for its current settings and use those.  If
132 the port address is a wildcard, the driver consults an internal table of
133 possible port address locations and attaches to the first unattached card
134 it finds.  The possible port addresses for these card are 0x110, 0x130,
135 0x150, 0x190, 0x210, 0x230, 0x250, and 0x330.
136 .Pp
137 Per target configuration performed in the
138 .Tn AdvanceWare
139 menu, which is accessible at boot,
140 is honored by this driver.
141 This includes synchronous/asynchronous transfers,
142 maximum synchronous negotiation rate, disconnection, tagged queueing,
143 and the host adapter's SCSI ID.
144 The global setting for the maximum number of tagged transactions allowed
145 per target is not honored as the CAM SCSI system will automatically determine
146 the maximum number of tags a device can receive as well as guarantee fair
147 resource allocation among devices.
148 .Sh SEE ALSO
149 .Xr adw 4 ,
150 .Xr aha 4 ,
151 .Xr ahb 4 ,
152 .Xr ahc 4 ,
153 .Xr cd 4 ,
154 .Xr da 4 ,
155 .Xr sa 4 ,
156 .Xr scsi 4
157 .Sh HISTORY
158 The
159 .Nm
160 driver appeared in
161 .Fx 3.0 .
162 .Sh AUTHORS
163 .An -nosplit
164 The
165 .Nm
166 driver was ported by
167 .An Justin T. Gibbs
168 from the Linux driver
169 written by
170 .An Bob Frey
171 of Advanced System Products, Inc.
172 Many thanks to AdvanSys for providing the original driver under a suitable
173 license for use in
174 .Fx .