Merge from vendor branch LIBPCAP:
[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.3 2006/02/17 19:37:09 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 .Pp
65 .Bd -ragged -offset indent
66 .Bl -column "ABP510/5150 " "ISA PnP " "Yes " "10MHz " "Commands " Footnotes
67 Connectivity Products:
68 .Pp
69 .Em "Adapter       Bus   Floppy      MaxSync   Commands  Footnotes"
70 ABP510/5150   ISA     No         10MHz       240    1
71 ABP5140     ISA PnP   No         10MHz       16     1, 3
72 ABP5142     ISA PnP   Yes        10MHz       16     4
73 ABP[3]902     PCI     No         10MHz       16
74 ABP3905       PCI     No         10MHz       16
75 ABP915        PCI     No         10MHz       16
76 ABP920        PCI     No         10MHz       16
77 ABP3922       PCI     No         10MHz       16
78 ABP3925       PCI     No         10MHz       16
79 ABP930        PCI     No         10MHz       16     5
80 ABP930U       PCI     No         20MHz       16
81 ABP930UA      PCI     No         20MHz       16
82 ABP960        PCI     No         10MHz       16
83 ABP960U       PCI     No         20MHz       16
84 .El
85 .Pp
86 Footnotes:
87 .Bl -enum -compact
88 .It
89 This board has been shipped by HP with the 4020i CD-R drive.
90 The board has no BIOS so it cannot control a boot device, but
91 it can control any secondary SCSI device.
92 .It
93 This board has been sold by Iomega as a Jaz Jet PCI adapter.
94 .It
95 This board has been sold by SIIG as the i540 SpeedMaster.
96 .It
97 This board has been sold by SIIG as the i542 SpeedMaster.
98 .It
99 This board has been sold by SIIG as the Fast SCSI Pro PCI.
100 .El
101 .Ed
102 .Pp
103 .Bd -ragged -offset indent
104 .Bl -column "ABP510/5150 " "ISA PnP " "Yes " "10MHz " Commands
105 Single Channel Products:
106 .Pp
107 .Em "Adapter       Bus   Floppy      MaxSync   Commands"
108 ABP542        ISA     Yes        10MHz       240
109 ABP742        EISA    Yes        10MHz       240
110 ABP842        VL      Yes        10MHz       240
111 ABP940        PCI     No         10MHz       240
112 ABP[3]940UA   PCI     No         20MHz       240
113 ABP940U       PCI     No         20MHz       240
114 ABP3960UA     PCI     No         20MHz       240
115 ABP970        PCI     No         10MHz       240
116 ABP970U       PCI     No         20MHz       240
117 .El
118 .Ed
119 .Pp
120 .Bd -ragged -offset indent
121 .Bl -column "ABP510/5150 " "ISA PnP " "Yes " "10MHz " "Commands " "Channels "
122 Multi Channel Products (Commands are per-channel):
123 .Pp
124 .Em "Adapter       Bus   Floppy      MaxSync   Commands  Channels"
125 ABP752       EISA     Yes        10MHz       240      2
126 ABP852        VL      Yes        10MHz       240      2
127 ABP950        PCI     No         10MHz       240      2
128 ABP980        PCI     No         10MHz       240      4
129 ABP980U       PCI     No         20MHz       240      4
130 ABP[3]980UA   PCI     No         20MHz       16       4
131 .El
132 .Ed
133 .Pp
134 For ISA or Vesa Local Bus adapters, one kernel config entry is required
135 for every card to be attached by the system.  Specific values for the port
136 address, irq, and drq may be specified.  If wildcard values are used, the
137 driver will query the device for its current settings and use those.  If
138 the port address is a wildcard, the driver consults an internal table of
139 possible port address locations and attaches to the first unattached card
140 it finds.  The possible port addresses for these card are 0x110, 0x130,
141 0x150, 0x190, 0x210, 0x230, 0x250, and 0x330.
142 .Pp
143 Per target configuration performed in the
144 .Tn AdvanceWare
145 menu, which is accessible at boot,
146 is honored by this driver.
147 This includes synchronous/asynchronous transfers,
148 maximum synchronous negotiation rate, disconnection, tagged queueing,
149 and the host adapter's SCSI ID.
150 The global setting for the maximum number of tagged transactions allowed
151 per target is not honored as the CAM SCSI system will automatically determine
152 the maximum number of tags a device can receive as well as guarantee fair
153 resource allocation among devices.
154 .Sh SEE ALSO
155 .Xr adw 4 ,
156 .Xr aha 4 ,
157 .Xr ahb 4 ,
158 .Xr ahc 4 ,
159 .Xr cd 4 ,
160 .Xr da 4 ,
161 .Xr sa 4 ,
162 .Xr scsi 4
163 .Sh HISTORY
164 The
165 .Nm
166 driver appeared in
167 .Fx 3.0 .
168 .Sh AUTHORS
169 .An -nosplit
170 The
171 .Nm
172 driver was ported by
173 .An Justin T. Gibbs
174 from the Linux driver
175 written by
176 .An Bob Frey
177 of Advanced System Products, Inc.
178 Many thanks to AdvanSys for providing the original driver under a suitable
179 license for use in
180 .Fx .