diff options
author | Linus Torvalds <torvalds@linux-foundation.org> | 2008-01-25 20:19:08 -0500 |
---|---|---|
committer | Linus Torvalds <torvalds@linux-foundation.org> | 2008-01-25 20:19:08 -0500 |
commit | 9b73e76f3cf63379dcf45fcd4f112f5812418d0a (patch) | |
tree | 4e6bef87cd0cd6d848fc39a5ae25b981dbbe035b /Documentation | |
parent | 50d9a126240f9961cfdd063336bbeb91f77a7dce (diff) | |
parent | 23c3e290fb9ce38cabc2822b47583fc8702411bf (diff) |
Merge git://git.kernel.org/pub/scm/linux/kernel/git/jejb/scsi-misc-2.6
* git://git.kernel.org/pub/scm/linux/kernel/git/jejb/scsi-misc-2.6: (200 commits)
[SCSI] usbstorage: use last_sector_bug flag universally
[SCSI] libsas: abstract STP task status into a function
[SCSI] ultrastor: clean up inline asm warnings
[SCSI] aic7xxx: fix firmware build
[SCSI] aacraid: fib context lock for management ioctls
[SCSI] ch: remove forward declarations
[SCSI] ch: fix device minor number management bug
[SCSI] ch: handle class_device_create failure properly
[SCSI] NCR5380: fix section mismatch
[SCSI] sg: fix /proc/scsi/sg/devices when no SCSI devices
[SCSI] IB/iSER: add logical unit reset support
[SCSI] don't use __GFP_DMA for sense buffers if not required
[SCSI] use dynamically allocated sense buffer
[SCSI] scsi.h: add macro for enclosure bit of inquiry data
[SCSI] sd: add fix for devices with last sector access problems
[SCSI] fix pcmcia compile problem
[SCSI] aacraid: add Voodoo Lite class of cards.
[SCSI] aacraid: add new driver features flags
[SCSI] qla2xxx: Update version number to 8.02.00-k7.
[SCSI] qla2xxx: Issue correct MBC_INITIALIZE_FIRMWARE command.
...
Diffstat (limited to 'Documentation')
-rw-r--r-- | Documentation/DocBook/Makefile | 2 | ||||
-rw-r--r-- | Documentation/DocBook/scsi.tmpl | 409 | ||||
-rw-r--r-- | Documentation/dontdiff | 2 | ||||
-rw-r--r-- | Documentation/kernel-parameters.txt | 8 | ||||
-rw-r--r-- | Documentation/m68k/kernel-options.txt | 60 | ||||
-rw-r--r-- | Documentation/scsi/00-INDEX | 2 | ||||
-rw-r--r-- | Documentation/scsi/ChangeLog.megaraid_sas | 159 | ||||
-rw-r--r-- | Documentation/scsi/aacraid.txt | 4 | ||||
-rw-r--r-- | Documentation/scsi/hptiop.txt | 30 | ||||
-rw-r--r-- | Documentation/scsi/ncr53c7xx.txt | 40 |
10 files changed, 601 insertions, 115 deletions
diff --git a/Documentation/DocBook/Makefile b/Documentation/DocBook/Makefile index 4953bc258729..6a0ad4715e9f 100644 --- a/Documentation/DocBook/Makefile +++ b/Documentation/DocBook/Makefile | |||
@@ -11,7 +11,7 @@ DOCBOOKS := wanbook.xml z8530book.xml mcabook.xml videobook.xml \ | |||
11 | procfs-guide.xml writing_usb_driver.xml \ | 11 | procfs-guide.xml writing_usb_driver.xml \ |
12 | kernel-api.xml filesystems.xml lsm.xml usb.xml \ | 12 | kernel-api.xml filesystems.xml lsm.xml usb.xml \ |
13 | gadget.xml libata.xml mtdnand.xml librs.xml rapidio.xml \ | 13 | gadget.xml libata.xml mtdnand.xml librs.xml rapidio.xml \ |
14 | genericirq.xml s390-drivers.xml uio-howto.xml | 14 | genericirq.xml s390-drivers.xml uio-howto.xml scsi.xml |
15 | 15 | ||
16 | ### | 16 | ### |
17 | # The build process is as follows (targets): | 17 | # The build process is as follows (targets): |
diff --git a/Documentation/DocBook/scsi.tmpl b/Documentation/DocBook/scsi.tmpl new file mode 100644 index 000000000000..f299ab182bbe --- /dev/null +++ b/Documentation/DocBook/scsi.tmpl | |||
@@ -0,0 +1,409 @@ | |||
1 | <?xml version="1.0" encoding="UTF-8"?> | ||
2 | <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" | ||
3 | "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" []> | ||
4 | |||
5 | <book id="scsimid"> | ||
6 | <bookinfo> | ||
7 | <title>SCSI Interfaces Guide</title> | ||
8 | |||
9 | <authorgroup> | ||
10 | <author> | ||
11 | <firstname>James</firstname> | ||
12 | <surname>Bottomley</surname> | ||
13 | <affiliation> | ||
14 | <address> | ||
15 | <email>James.Bottomley@steeleye.com</email> | ||
16 | </address> | ||
17 | </affiliation> | ||
18 | </author> | ||
19 | |||
20 | <author> | ||
21 | <firstname>Rob</firstname> | ||
22 | <surname>Landley</surname> | ||
23 | <affiliation> | ||
24 | <address> | ||
25 | <email>rob@landley.net</email> | ||
26 | </address> | ||
27 | </affiliation> | ||
28 | </author> | ||
29 | |||
30 | </authorgroup> | ||
31 | |||
32 | <copyright> | ||
33 | <year>2007</year> | ||
34 | <holder>Linux Foundation</holder> | ||
35 | </copyright> | ||
36 | |||
37 | <legalnotice> | ||
38 | <para> | ||
39 | This documentation is free software; you can redistribute | ||
40 | it and/or modify it under the terms of the GNU General Public | ||
41 | License version 2. | ||
42 | </para> | ||
43 | |||
44 | <para> | ||
45 | This program is distributed in the hope that it will be | ||
46 | useful, but WITHOUT ANY WARRANTY; without even the implied | ||
47 | warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. | ||
48 | For more details see the file COPYING in the source | ||
49 | distribution of Linux. | ||
50 | </para> | ||
51 | </legalnotice> | ||
52 | </bookinfo> | ||
53 | |||
54 | <toc></toc> | ||
55 | |||
56 | <chapter id="intro"> | ||
57 | <title>Introduction</title> | ||
58 | <sect1 id="protocol_vs_bus"> | ||
59 | <title>Protocol vs bus</title> | ||
60 | <para> | ||
61 | Once upon a time, the Small Computer Systems Interface defined both | ||
62 | a parallel I/O bus and a data protocol to connect a wide variety of | ||
63 | peripherals (disk drives, tape drives, modems, printers, scanners, | ||
64 | optical drives, test equipment, and medical devices) to a host | ||
65 | computer. | ||
66 | </para> | ||
67 | <para> | ||
68 | Although the old parallel (fast/wide/ultra) SCSI bus has largely | ||
69 | fallen out of use, the SCSI command set is more widely used than ever | ||
70 | to communicate with devices over a number of different busses. | ||
71 | </para> | ||
72 | <para> | ||
73 | The <ulink url='http://www.t10.org/scsi-3.htm'>SCSI protocol</ulink> | ||
74 | is a big-endian peer-to-peer packet based protocol. SCSI commands | ||
75 | are 6, 10, 12, or 16 bytes long, often followed by an associated data | ||
76 | payload. | ||
77 | </para> | ||
78 | <para> | ||
79 | SCSI commands can be transported over just about any kind of bus, and | ||
80 | are the default protocol for storage devices attached to USB, SATA, | ||
81 | SAS, Fibre Channel, FireWire, and ATAPI devices. SCSI packets are | ||
82 | also commonly exchanged over Infiniband, | ||
83 | <ulink url='http://i2o.shadowconnect.com/faq.php'>I20</ulink>, TCP/IP | ||
84 | (<ulink url='http://en.wikipedia.org/wiki/ISCSI'>iSCSI</ulink>), even | ||
85 | <ulink url='http://cyberelk.net/tim/parport/parscsi.html'>Parallel | ||
86 | ports</ulink>. | ||
87 | </para> | ||
88 | </sect1> | ||
89 | <sect1 id="subsystem_design"> | ||
90 | <title>Design of the Linux SCSI subsystem</title> | ||
91 | <para> | ||
92 | The SCSI subsystem uses a three layer design, with upper, mid, and low | ||
93 | layers. Every operation involving the SCSI subsystem (such as reading | ||
94 | a sector from a disk) uses one driver at each of the 3 levels: one | ||
95 | upper layer driver, one lower layer driver, and the SCSI midlayer. | ||
96 | </para> | ||
97 | <para> | ||
98 | The SCSI upper layer provides the interface between userspace and the | ||
99 | kernel, in the form of block and char device nodes for I/O and | ||
100 | ioctl(). The SCSI lower layer contains drivers for specific hardware | ||
101 | devices. | ||
102 | </para> | ||
103 | <para> | ||
104 | In between is the SCSI mid-layer, analogous to a network routing | ||
105 | layer such as the IPv4 stack. The SCSI mid-layer routes a packet | ||
106 | based data protocol between the upper layer's /dev nodes and the | ||
107 | corresponding devices in the lower layer. It manages command queues, | ||
108 | provides error handling and power management functions, and responds | ||
109 | to ioctl() requests. | ||
110 | </para> | ||
111 | </sect1> | ||
112 | </chapter> | ||
113 | |||
114 | <chapter id="upper_layer"> | ||
115 | <title>SCSI upper layer</title> | ||
116 | <para> | ||
117 | The upper layer supports the user-kernel interface by providing | ||
118 | device nodes. | ||
119 | </para> | ||
120 | <sect1 id="sd"> | ||
121 | <title>sd (SCSI Disk)</title> | ||
122 | <para>sd (sd_mod.o)</para> | ||
123 | <!-- !Idrivers/scsi/sd.c --> | ||
124 | </sect1> | ||
125 | <sect1 id="sr"> | ||
126 | <title>sr (SCSI CD-ROM)</title> | ||
127 | <para>sr (sr_mod.o)</para> | ||
128 | </sect1> | ||
129 | <sect1 id="st"> | ||
130 | <title>st (SCSI Tape)</title> | ||
131 | <para>st (st.o)</para> | ||
132 | </sect1> | ||
133 | <sect1 id="sg"> | ||
134 | <title>sg (SCSI Generic)</title> | ||
135 | <para>sg (sg.o)</para> | ||
136 | </sect1> | ||
137 | <sect1 id="ch"> | ||
138 | <title>ch (SCSI Media Changer)</title> | ||
139 | <para>ch (ch.c)</para> | ||
140 | </sect1> | ||
141 | </chapter> | ||
142 | |||
143 | <chapter id="mid_layer"> | ||
144 | <title>SCSI mid layer</title> | ||
145 | |||
146 | <sect1 id="midlayer_implementation"> | ||
147 | <title>SCSI midlayer implementation</title> | ||
148 | <sect2 id="scsi_device.h"> | ||
149 | <title>include/scsi/scsi_device.h</title> | ||
150 | <para> | ||
151 | </para> | ||
152 | !Iinclude/scsi/scsi_device.h | ||
153 | </sect2> | ||
154 | |||
155 | <sect2 id="scsi.c"> | ||
156 | <title>drivers/scsi/scsi.c</title> | ||
157 | <para>Main file for the SCSI midlayer.</para> | ||
158 | !Edrivers/scsi/scsi.c | ||
159 | </sect2> | ||
160 | <sect2 id="scsicam.c"> | ||
161 | <title>drivers/scsi/scsicam.c</title> | ||
162 | <para> | ||
163 | <ulink url='http://www.t10.org/ftp/t10/drafts/cam/cam-r12b.pdf'>SCSI | ||
164 | Common Access Method</ulink> support functions, for use with | ||
165 | HDIO_GETGEO, etc. | ||
166 | </para> | ||
167 | !Edrivers/scsi/scsicam.c | ||
168 | </sect2> | ||
169 | <sect2 id="scsi_error.c"> | ||
170 | <title>drivers/scsi/scsi_error.c</title> | ||
171 | <para>Common SCSI error/timeout handling routines.</para> | ||
172 | !Edrivers/scsi/scsi_error.c | ||
173 | </sect2> | ||
174 | <sect2 id="scsi_devinfo.c"> | ||
175 | <title>drivers/scsi/scsi_devinfo.c</title> | ||
176 | <para> | ||
177 | Manage scsi_dev_info_list, which tracks blacklisted and whitelisted | ||
178 | devices. | ||
179 | </para> | ||
180 | !Idrivers/scsi/scsi_devinfo.c | ||
181 | </sect2> | ||
182 | <sect2 id="scsi_ioctl.c"> | ||
183 | <title>drivers/scsi/scsi_ioctl.c</title> | ||
184 | <para> | ||
185 | Handle ioctl() calls for SCSI devices. | ||
186 | </para> | ||
187 | !Edrivers/scsi/scsi_ioctl.c | ||
188 | </sect2> | ||
189 | <sect2 id="scsi_lib.c"> | ||
190 | <title>drivers/scsi/scsi_lib.c</title> | ||
191 | <para> | ||
192 | SCSI queuing library. | ||
193 | </para> | ||
194 | !Edrivers/scsi/scsi_lib.c | ||
195 | </sect2> | ||
196 | <sect2 id="scsi_lib_dma.c"> | ||
197 | <title>drivers/scsi/scsi_lib_dma.c</title> | ||
198 | <para> | ||
199 | SCSI library functions depending on DMA | ||
200 | (map and unmap scatter-gather lists). | ||
201 | </para> | ||
202 | !Edrivers/scsi/scsi_lib_dma.c | ||
203 | </sect2> | ||
204 | <sect2 id="scsi_module.c"> | ||
205 | <title>drivers/scsi/scsi_module.c</title> | ||
206 | <para> | ||
207 | The file drivers/scsi/scsi_module.c contains legacy support for | ||
208 | old-style host templates. It should never be used by any new driver. | ||
209 | </para> | ||
210 | </sect2> | ||
211 | <sect2 id="scsi_proc.c"> | ||
212 | <title>drivers/scsi/scsi_proc.c</title> | ||
213 | <para> | ||
214 | The functions in this file provide an interface between | ||
215 | the PROC file system and the SCSI device drivers | ||
216 | It is mainly used for debugging, statistics and to pass | ||
217 | information directly to the lowlevel driver. | ||
218 | |||
219 | I.E. plumbing to manage /proc/scsi/* | ||
220 | </para> | ||
221 | !Idrivers/scsi/scsi_proc.c | ||
222 | </sect2> | ||
223 | <sect2 id="scsi_netlink.c"> | ||
224 | <title>drivers/scsi/scsi_netlink.c</title> | ||
225 | <para> | ||
226 | Infrastructure to provide async events from transports to userspace | ||
227 | via netlink, using a single NETLINK_SCSITRANSPORT protocol for all | ||
228 | transports. | ||
229 | |||
230 | See <ulink url='http://marc.info/?l=linux-scsi&m=115507374832500&w=2'>the | ||
231 | original patch submission</ulink> for more details. | ||
232 | </para> | ||
233 | !Idrivers/scsi/scsi_netlink.c | ||
234 | </sect2> | ||
235 | <sect2 id="scsi_scan.c"> | ||
236 | <title>drivers/scsi/scsi_scan.c</title> | ||
237 | <para> | ||
238 | Scan a host to determine which (if any) devices are attached. | ||
239 | |||
240 | The general scanning/probing algorithm is as follows, exceptions are | ||
241 | made to it depending on device specific flags, compilation options, | ||
242 | and global variable (boot or module load time) settings. | ||
243 | |||
244 | A specific LUN is scanned via an INQUIRY command; if the LUN has a | ||
245 | device attached, a scsi_device is allocated and setup for it. | ||
246 | |||
247 | For every id of every channel on the given host, start by scanning | ||
248 | LUN 0. Skip hosts that don't respond at all to a scan of LUN 0. | ||
249 | Otherwise, if LUN 0 has a device attached, allocate and setup a | ||
250 | scsi_device for it. If target is SCSI-3 or up, issue a REPORT LUN, | ||
251 | and scan all of the LUNs returned by the REPORT LUN; else, | ||
252 | sequentially scan LUNs up until some maximum is reached, or a LUN is | ||
253 | seen that cannot have a device attached to it. | ||
254 | </para> | ||
255 | !Idrivers/scsi/scsi_scan.c | ||
256 | </sect2> | ||
257 | <sect2 id="scsi_sysctl.c"> | ||
258 | <title>drivers/scsi/scsi_sysctl.c</title> | ||
259 | <para> | ||
260 | Set up the sysctl entry: "/dev/scsi/logging_level" | ||
261 | (DEV_SCSI_LOGGING_LEVEL) which sets/returns scsi_logging_level. | ||
262 | </para> | ||
263 | </sect2> | ||
264 | <sect2 id="scsi_sysfs.c"> | ||
265 | <title>drivers/scsi/scsi_sysfs.c</title> | ||
266 | <para> | ||
267 | SCSI sysfs interface routines. | ||
268 | </para> | ||
269 | !Edrivers/scsi/scsi_sysfs.c | ||
270 | </sect2> | ||
271 | <sect2 id="hosts.c"> | ||
272 | <title>drivers/scsi/hosts.c</title> | ||
273 | <para> | ||
274 | mid to lowlevel SCSI driver interface | ||
275 | </para> | ||
276 | !Edrivers/scsi/hosts.c | ||
277 | </sect2> | ||
278 | <sect2 id="constants.c"> | ||
279 | <title>drivers/scsi/constants.c</title> | ||
280 | <para> | ||
281 | mid to lowlevel SCSI driver interface | ||
282 | </para> | ||
283 | !Edrivers/scsi/constants.c | ||
284 | </sect2> | ||
285 | </sect1> | ||
286 | |||
287 | <sect1 id="Transport_classes"> | ||
288 | <title>Transport classes</title> | ||
289 | <para> | ||
290 | Transport classes are service libraries for drivers in the SCSI | ||
291 | lower layer, which expose transport attributes in sysfs. | ||
292 | </para> | ||
293 | <sect2 id="Fibre_Channel_transport"> | ||
294 | <title>Fibre Channel transport</title> | ||
295 | <para> | ||
296 | The file drivers/scsi/scsi_transport_fc.c defines transport attributes | ||
297 | for Fibre Channel. | ||
298 | </para> | ||
299 | !Edrivers/scsi/scsi_transport_fc.c | ||
300 | </sect2> | ||
301 | <sect2 id="iSCSI_transport"> | ||
302 | <title>iSCSI transport class</title> | ||
303 | <para> | ||
304 | The file drivers/scsi/scsi_transport_iscsi.c defines transport | ||
305 | attributes for the iSCSI class, which sends SCSI packets over TCP/IP | ||
306 | connections. | ||
307 | </para> | ||
308 | !Edrivers/scsi/scsi_transport_iscsi.c | ||
309 | </sect2> | ||
310 | <sect2 id="SAS_transport"> | ||
311 | <title>Serial Attached SCSI (SAS) transport class</title> | ||
312 | <para> | ||
313 | The file drivers/scsi/scsi_transport_sas.c defines transport | ||
314 | attributes for Serial Attached SCSI, a variant of SATA aimed at | ||
315 | large high-end systems. | ||
316 | </para> | ||
317 | <para> | ||
318 | The SAS transport class contains common code to deal with SAS HBAs, | ||
319 | an aproximated representation of SAS topologies in the driver model, | ||
320 | and various sysfs attributes to expose these topologies and managment | ||
321 | interfaces to userspace. | ||
322 | </para> | ||
323 | <para> | ||
324 | In addition to the basic SCSI core objects this transport class | ||
325 | introduces two additional intermediate objects: The SAS PHY | ||
326 | as represented by struct sas_phy defines an "outgoing" PHY on | ||
327 | a SAS HBA or Expander, and the SAS remote PHY represented by | ||
328 | struct sas_rphy defines an "incoming" PHY on a SAS Expander or | ||
329 | end device. Note that this is purely a software concept, the | ||
330 | underlying hardware for a PHY and a remote PHY is the exactly | ||
331 | the same. | ||
332 | </para> | ||
333 | <para> | ||
334 | There is no concept of a SAS port in this code, users can see | ||
335 | what PHYs form a wide port based on the port_identifier attribute, | ||
336 | which is the same for all PHYs in a port. | ||
337 | </para> | ||
338 | !Edrivers/scsi/scsi_transport_sas.c | ||
339 | </sect2> | ||
340 | <sect2 id="SATA_transport"> | ||
341 | <title>SATA transport class</title> | ||
342 | <para> | ||
343 | The SATA transport is handled by libata, which has its own book of | ||
344 | documentation in this directory. | ||
345 | </para> | ||
346 | </sect2> | ||
347 | <sect2 id="SPI_transport"> | ||
348 | <title>Parallel SCSI (SPI) transport class</title> | ||
349 | <para> | ||
350 | The file drivers/scsi/scsi_transport_spi.c defines transport | ||
351 | attributes for traditional (fast/wide/ultra) SCSI busses. | ||
352 | </para> | ||
353 | !Edrivers/scsi/scsi_transport_spi.c | ||
354 | </sect2> | ||
355 | <sect2 id="SRP_transport"> | ||
356 | <title>SCSI RDMA (SRP) transport class</title> | ||
357 | <para> | ||
358 | The file drivers/scsi/scsi_transport_srp.c defines transport | ||
359 | attributes for SCSI over Remote Direct Memory Access. | ||
360 | </para> | ||
361 | !Edrivers/scsi/scsi_transport_srp.c | ||
362 | </sect2> | ||
363 | </sect1> | ||
364 | |||
365 | </chapter> | ||
366 | |||
367 | <chapter id="lower_layer"> | ||
368 | <title>SCSI lower layer</title> | ||
369 | <sect1 id="hba_drivers"> | ||
370 | <title>Host Bus Adapter transport types</title> | ||
371 | <para> | ||
372 | Many modern device controllers use the SCSI command set as a protocol to | ||
373 | communicate with their devices through many different types of physical | ||
374 | connections. | ||
375 | </para> | ||
376 | <para> | ||
377 | In SCSI language a bus capable of carrying SCSI commands is | ||
378 | called a "transport", and a controller connecting to such a bus is | ||
379 | called a "host bus adapter" (HBA). | ||
380 | </para> | ||
381 | <sect2 id="scsi_debug.c"> | ||
382 | <title>Debug transport</title> | ||
383 | <para> | ||
384 | The file drivers/scsi/scsi_debug.c simulates a host adapter with a | ||
385 | variable number of disks (or disk like devices) attached, sharing a | ||
386 | common amount of RAM. Does a lot of checking to make sure that we are | ||
387 | not getting blocks mixed up, and panics the kernel if anything out of | ||
388 | the ordinary is seen. | ||
389 | </para> | ||
390 | <para> | ||
391 | To be more realistic, the simulated devices have the transport | ||
392 | attributes of SAS disks. | ||
393 | </para> | ||
394 | <para> | ||
395 | For documentation see | ||
396 | <ulink url='http://www.torque.net/sg/sdebug26.html'>http://www.torque.net/sg/sdebug26.html</ulink> | ||
397 | </para> | ||
398 | <!-- !Edrivers/scsi/scsi_debug.c --> | ||
399 | </sect2> | ||
400 | <sect2 id="todo"> | ||
401 | <title>todo</title> | ||
402 | <para>Parallel (fast/wide/ultra) SCSI, USB, SATA, | ||
403 | SAS, Fibre Channel, FireWire, ATAPI devices, Infiniband, | ||
404 | I20, iSCSI, Parallel ports, netlink... | ||
405 | </para> | ||
406 | </sect2> | ||
407 | </sect1> | ||
408 | </chapter> | ||
409 | </book> | ||
diff --git a/Documentation/dontdiff b/Documentation/dontdiff index f2d658a6a942..c09a96b99354 100644 --- a/Documentation/dontdiff +++ b/Documentation/dontdiff | |||
@@ -46,8 +46,6 @@ | |||
46 | .mailmap | 46 | .mailmap |
47 | .mm | 47 | .mm |
48 | 53c700_d.h | 48 | 53c700_d.h |
49 | 53c7xx_d.h | ||
50 | 53c7xx_u.h | ||
51 | 53c8xx_d.h* | 49 | 53c8xx_d.h* |
52 | BitKeeper | 50 | BitKeeper |
53 | COPYING | 51 | COPYING |
diff --git a/Documentation/kernel-parameters.txt b/Documentation/kernel-parameters.txt index 17fc60e32443..65de5ba7b74c 100644 --- a/Documentation/kernel-parameters.txt +++ b/Documentation/kernel-parameters.txt | |||
@@ -1598,7 +1598,13 @@ and is between 256 and 4096 characters. It is defined in the file | |||
1598 | Format: <vendor>:<model>:<flags> | 1598 | Format: <vendor>:<model>:<flags> |
1599 | (flags are integer value) | 1599 | (flags are integer value) |
1600 | 1600 | ||
1601 | scsi_logging= [SCSI] | 1601 | scsi_logging_level= [SCSI] a bit mask of logging levels |
1602 | See drivers/scsi/scsi_logging.h for bits. Also | ||
1603 | settable via sysctl at dev.scsi.logging_level | ||
1604 | (/proc/sys/dev/scsi/logging_level). | ||
1605 | There is also a nice 'scsi_logging_level' script in the | ||
1606 | S390-tools package, available for download at | ||
1607 | http://www-128.ibm.com/developerworks/linux/linux390/s390-tools-1.5.4.html | ||
1602 | 1608 | ||
1603 | scsi_mod.scan= [SCSI] sync (default) scans SCSI busses as they are | 1609 | scsi_mod.scan= [SCSI] sync (default) scans SCSI busses as they are |
1604 | discovered. async scans them in kernel threads, | 1610 | discovered. async scans them in kernel threads, |
diff --git a/Documentation/m68k/kernel-options.txt b/Documentation/m68k/kernel-options.txt index 248589e8bcf5..c93bed66e25d 100644 --- a/Documentation/m68k/kernel-options.txt +++ b/Documentation/m68k/kernel-options.txt | |||
@@ -867,66 +867,6 @@ controller and should be autodetected by the driver. An example is the | |||
867 | 24 bit region which is specified by a mask of 0x00fffffe. | 867 | 24 bit region which is specified by a mask of 0x00fffffe. |
868 | 868 | ||
869 | 869 | ||
870 | 5.5) 53c7xx= | ||
871 | ------------ | ||
872 | |||
873 | Syntax: 53c7xx=<sub-options...> | ||
874 | |||
875 | These options affect the A4000T, A4091, WarpEngine, Blizzard 603e+, | ||
876 | and GForce 040/060 SCSI controllers on the Amiga, as well as the | ||
877 | builtin MVME 16x SCSI controller. | ||
878 | |||
879 | The <sub-options> is a comma-separated list of the sub-options listed | ||
880 | below. | ||
881 | |||
882 | 5.5.1) nosync | ||
883 | ------------- | ||
884 | |||
885 | Syntax: nosync:0 | ||
886 | |||
887 | Disables sync negotiation for all devices. Any value after the | ||
888 | colon is acceptable (and has the same effect). | ||
889 | |||
890 | 5.5.2) noasync | ||
891 | -------------- | ||
892 | |||
893 | [OBSOLETE, REMOVED] | ||
894 | |||
895 | 5.5.3) nodisconnect | ||
896 | ------------------- | ||
897 | |||
898 | Syntax: nodisconnect:0 | ||
899 | |||
900 | Disables SCSI disconnects. Any value after the colon is acceptable | ||
901 | (and has the same effect). | ||
902 | |||
903 | 5.5.4) validids | ||
904 | --------------- | ||
905 | |||
906 | Syntax: validids:0xNN | ||
907 | |||
908 | Specify which SCSI ids the driver should pay attention to. This is | ||
909 | a bitmask (i.e. to only pay attention to ID#4, you'd use 0x10). | ||
910 | Default is 0x7f (devices 0-6). | ||
911 | |||
912 | 5.5.5) opthi | ||
913 | 5.5.6) optlo | ||
914 | ------------ | ||
915 | |||
916 | Syntax: opthi:M,optlo:N | ||
917 | |||
918 | Specify options for "hostdata->options". The acceptable definitions | ||
919 | are listed in drivers/scsi/53c7xx.h; the 32 high bits should be in | ||
920 | opthi and the 32 low bits in optlo. They must be specified in the | ||
921 | order opthi=M,optlo=N. | ||
922 | |||
923 | 5.5.7) next | ||
924 | ----------- | ||
925 | |||
926 | No argument. Used to separate blocks of keywords when there's more | ||
927 | than one 53c7xx host adapter in the system. | ||
928 | |||
929 | |||
930 | /* Local Variables: */ | 870 | /* Local Variables: */ |
931 | /* mode: text */ | 871 | /* mode: text */ |
932 | /* End: */ | 872 | /* End: */ |
diff --git a/Documentation/scsi/00-INDEX b/Documentation/scsi/00-INDEX index aa1f7e927834..c2e18e109858 100644 --- a/Documentation/scsi/00-INDEX +++ b/Documentation/scsi/00-INDEX | |||
@@ -64,8 +64,6 @@ lpfc.txt | |||
64 | - LPFC driver release notes | 64 | - LPFC driver release notes |
65 | megaraid.txt | 65 | megaraid.txt |
66 | - Common Management Module, shared code handling ioctls for LSI drivers | 66 | - Common Management Module, shared code handling ioctls for LSI drivers |
67 | ncr53c7xx.txt | ||
68 | - info on driver for NCR53c7xx based adapters | ||
69 | ncr53c8xx.txt | 67 | ncr53c8xx.txt |
70 | - info on driver for NCR53c8xx based adapters | 68 | - info on driver for NCR53c8xx based adapters |
71 | osst.txt | 69 | osst.txt |
diff --git a/Documentation/scsi/ChangeLog.megaraid_sas b/Documentation/scsi/ChangeLog.megaraid_sas index 5eb927544990..91c81db0ba71 100644 --- a/Documentation/scsi/ChangeLog.megaraid_sas +++ b/Documentation/scsi/ChangeLog.megaraid_sas | |||
@@ -1,3 +1,162 @@ | |||
1 | 1 Release Date : Thur. Nov. 07 16:30:43 PST 2007 - | ||
2 | (emaild-id:megaraidlinux@lsi.com) | ||
3 | Sumant Patro | ||
4 | Bo Yang | ||
5 | |||
6 | 2 Current Version : 00.00.03.16 | ||
7 | 3 Older Version : 00.00.03.15 | ||
8 | |||
9 | 1. Increased MFI_POLL_TIMEOUT_SECS to 60 seconds from 10. FW may take | ||
10 | a max of 60 seconds to respond to the INIT cmd. | ||
11 | |||
12 | 1 Release Date : Fri. Sep. 07 16:30:43 PST 2007 - | ||
13 | (emaild-id:megaraidlinux@lsi.com) | ||
14 | Sumant Patro | ||
15 | Bo Yang | ||
16 | |||
17 | 2 Current Version : 00.00.03.15 | ||
18 | 3 Older Version : 00.00.03.14 | ||
19 | |||
20 | 1. Added module parameter "poll_mode_io" to support for "polling" | ||
21 | (reduced interrupt operation). In this mode, IO completion | ||
22 | interrupts are delayed. At the end of initiating IOs, the | ||
23 | driver schedules for cmd completion if there are pending cmds | ||
24 | to be completed. A timer-based interrupt has also been added | ||
25 | to prevent IO completion processing from being delayed | ||
26 | indefinitely in the case that no new IOs are initiated. | ||
27 | |||
28 | 1 Release Date : Fri. Sep. 07 16:30:43 PST 2007 - | ||
29 | (emaild-id:megaraidlinux@lsi.com) | ||
30 | Sumant Patro | ||
31 | Bo Yang | ||
32 | |||
33 | 2 Current Version : 00.00.03.14 | ||
34 | 3 Older Version : 00.00.03.13 | ||
35 | |||
36 | 1. Setting the max_sectors_per_req based on max SGL supported by the | ||
37 | FW. Prior versions calculated this value from controller info | ||
38 | (max_sectors_1, max_sectors_2). For certain controllers/FW, | ||
39 | this was resulting in a value greater than max SGL supported | ||
40 | by the FW. Issue was first reported by users running LUKS+XFS | ||
41 | with megaraid_sas. Thanks to RB for providing the logs and | ||
42 | duplication steps that helped to get to the root cause of the | ||
43 | issue. 2. Increased MFI_POLL_TIMEOUT_SECS to 60 seconds from | ||
44 | 10. FW may take a max of 60 seconds to respond to the INIT | ||
45 | cmd. | ||
46 | |||
47 | 1 Release Date : Fri. June. 15 16:30:43 PST 2007 - | ||
48 | (emaild-id:megaraidlinux@lsi.com) | ||
49 | Sumant Patro | ||
50 | Bo Yang | ||
51 | |||
52 | 2 Current Version : 00.00.03.13 | ||
53 | 3 Older Version : 00.00.03.12 | ||
54 | |||
55 | 1. Added the megasas_reset_timer routine to intercept cmd timeout and throttle io. | ||
56 | |||
57 | On Fri, 2007-03-16 at 16:44 -0600, James Bottomley wrote: | ||
58 | It looks like megaraid_sas at least needs this to throttle its commands | ||
59 | > as they begin to time out. The code keeps the existing transport | ||
60 | > template use of eh_timed_out (and allows the transport to override the | ||
61 | > host if they both have this callback). | ||
62 | > | ||
63 | > James | ||
64 | |||
65 | 1 Release Date : Sat May. 12 16:30:43 PST 2007 - | ||
66 | (emaild-id:megaraidlinux@lsi.com) | ||
67 | Sumant Patro | ||
68 | Bo Yang | ||
69 | |||
70 | 2 Current Version : 00.00.03.12 | ||
71 | 3 Older Version : 00.00.03.11 | ||
72 | |||
73 | 1. When MegaSAS driver receives reset call from OS, driver waits in reset | ||
74 | routine for max 3 minutes for all pending command completion. Now driver will | ||
75 | call completion routine every 5 seconds from the reset routine instead of | ||
76 | waiting for depending on cmd completion from isr path. | ||
77 | |||
78 | 1 Release Date : Mon Apr. 30 10:25:52 PST 2007 - | ||
79 | (emaild-id:megaraidlinux@lsi.com) | ||
80 | Sumant Patro | ||
81 | Bo Yang | ||
82 | |||
83 | 2 Current Version : 00.00.03.11 | ||
84 | 3 Older Version : 00.00.03.09 | ||
85 | |||
86 | 1. Memory Manager for IOCTL removed for 2.6 kernels. | ||
87 | pci_alloc_consistent replaced by dma_alloc_coherent. With this | ||
88 | change there is no need of memory manager in the driver code | ||
89 | |||
90 | On Wed, 2007-02-07 at 13:30 -0800, Andrew Morton wrote: | ||
91 | > I suspect all this horror is due to stupidity in the DMA API. | ||
92 | > | ||
93 | > pci_alloc_consistent() just goes and assumes GFP_ATOMIC, whereas | ||
94 | > the caller (megasas_mgmt_fw_ioctl) would have been perfectly happy | ||
95 | > to use GFP_KERNEL. | ||
96 | > | ||
97 | > I bet this fixes it | ||
98 | |||
99 | It does, but the DMA API was expanded to cope with this exact case, so | ||
100 | use dma_alloc_coherent() directly in the megaraid code instead. The dev | ||
101 | is just &pci_dev->dev. | ||
102 | |||
103 | James <James.Bottomley@SteelEye.com> | ||
104 | |||
105 | 3. SYNCHRONIZE_CACHE is not supported by FW and thus blocked by driver. | ||
106 | 4. Hibernation support added | ||
107 | 5. Performing diskdump while running IO in RHEL 4 was failing. Fixed. | ||
108 | |||
109 | 1 Release Date : Fri Feb. 09 14:36:28 PST 2007 - | ||
110 | (emaild-id:megaraidlinux@lsi.com) | ||
111 | Sumant Patro | ||
112 | Bo Yang | ||
113 | |||
114 | 2 Current Version : 00.00.03.09 | ||
115 | 3 Older Version : 00.00.03.08 | ||
116 | |||
117 | i. Under heavy IO mid-layer prints "DRIVER_TIMEOUT" errors | ||
118 | |||
119 | The driver now waits for 10 seconds to elapse instead of 5 (as in | ||
120 | previous release) to resume IO. | ||
121 | |||
122 | 1 Release Date : Mon Feb. 05 11:35:24 PST 2007 - | ||
123 | (emaild-id:megaraidlinux@lsi.com) | ||
124 | Sumant Patro | ||
125 | Bo Yang | ||
126 | 2 Current Version : 00.00.03.08 | ||
127 | 3 Older Version : 00.00.03.07 | ||
128 | |||
129 | i. Under heavy IO mid-layer prints "DRIVER_TIMEOUT" errors | ||
130 | |||
131 | Fix: The driver is now throttling IO. | ||
132 | Checks added in megasas_queue_command to know if FW is able to | ||
133 | process commands within timeout period. If number of retries | ||
134 | is 2 or greater,the driver stops sending cmd to FW temporarily. IO is | ||
135 | resumed if pending cmd count reduces to 16 or 5 seconds has elapsed | ||
136 | from the time cmds were last sent to FW. | ||
137 | |||
138 | ii. FW enables WCE bit in Mode Sense cmd for drives that are configured | ||
139 | as WriteBack. The OS may send "SYNCHRONIZE_CACHE" cmd when Logical | ||
140 | Disks are exposed with WCE=1. User is advised to enable Write Back | ||
141 | mode only when the controller has battery backup. At this time | ||
142 | Synhronize cache is not supported by the FW. Driver will short-cycle | ||
143 | the cmd and return sucess without sending down to FW. | ||
144 | |||
145 | 1 Release Date : Sun Jan. 14 11:21:32 PDT 2007 - | ||
146 | Sumant Patro <Sumant.Patro@lsil.com>/Bo Yang | ||
147 | 2 Current Version : 00.00.03.07 | ||
148 | 3 Older Version : 00.00.03.06 | ||
149 | |||
150 | i. bios_param entry added in scsi_host_template that returns disk geometry | ||
151 | information. | ||
152 | |||
153 | 1 Release Date : Fri Oct 20 11:21:32 PDT 2006 - Sumant Patro <Sumant.Patro@lsil.com>/Bo Yang | ||
154 | 2 Current Version : 00.00.03.06 | ||
155 | 3 Older Version : 00.00.03.05 | ||
156 | |||
157 | 1. Added new memory management module to support the IOCTL memory allocation. For IOCTL we try to allocate from the memory pool created during driver initialization. If mem pool is empty then we allocate at run time. | ||
158 | 2. Added check in megasas_queue_command and dpc/isr routine to see if we have already declared adapter dead | ||
159 | (hw_crit_error=1). If hw_crit_error==1, now we donot accept any processing of pending cmds/accept any cmd from OS | ||
1 | 160 | ||
2 | 1 Release Date : Mon Oct 02 11:21:32 PDT 2006 - Sumant Patro <Sumant.Patro@lsil.com> | 161 | 1 Release Date : Mon Oct 02 11:21:32 PDT 2006 - Sumant Patro <Sumant.Patro@lsil.com> |
3 | 2 Current Version : 00.00.03.05 | 162 | 2 Current Version : 00.00.03.05 |
diff --git a/Documentation/scsi/aacraid.txt b/Documentation/scsi/aacraid.txt index a8257840695a..d16011a8618e 100644 --- a/Documentation/scsi/aacraid.txt +++ b/Documentation/scsi/aacraid.txt | |||
@@ -56,6 +56,10 @@ Supported Cards/Chipsets | |||
56 | 9005:0285:9005:02d1 Adaptec 5405 (Voodoo40) | 56 | 9005:0285:9005:02d1 Adaptec 5405 (Voodoo40) |
57 | 9005:0285:15d9:02d2 SMC AOC-USAS-S8i-LP | 57 | 9005:0285:15d9:02d2 SMC AOC-USAS-S8i-LP |
58 | 9005:0285:15d9:02d3 SMC AOC-USAS-S8iR-LP | 58 | 9005:0285:15d9:02d3 SMC AOC-USAS-S8iR-LP |
59 | 9005:0285:9005:02d4 Adaptec 2045 (Voodoo04 Lite) | ||
60 | 9005:0285:9005:02d5 Adaptec 2405 (Voodoo40 Lite) | ||
61 | 9005:0285:9005:02d6 Adaptec 2445 (Voodoo44 Lite) | ||
62 | 9005:0285:9005:02d7 Adaptec 2805 (Voodoo80 Lite) | ||
59 | 1011:0046:9005:0364 Adaptec 5400S (Mustang) | 63 | 1011:0046:9005:0364 Adaptec 5400S (Mustang) |
60 | 9005:0287:9005:0800 Adaptec Themisto (Jupiter) | 64 | 9005:0287:9005:0800 Adaptec Themisto (Jupiter) |
61 | 9005:0200:9005:0200 Adaptec Themisto (Jupiter) | 65 | 9005:0200:9005:0200 Adaptec Themisto (Jupiter) |
diff --git a/Documentation/scsi/hptiop.txt b/Documentation/scsi/hptiop.txt index d28a31247d4c..a6eb4add1be6 100644 --- a/Documentation/scsi/hptiop.txt +++ b/Documentation/scsi/hptiop.txt | |||
@@ -1,9 +1,9 @@ | |||
1 | HIGHPOINT ROCKETRAID 3xxx RAID DRIVER (hptiop) | 1 | HIGHPOINT ROCKETRAID 3xxx/4xxx ADAPTER DRIVER (hptiop) |
2 | 2 | ||
3 | Controller Register Map | 3 | Controller Register Map |
4 | ------------------------- | 4 | ------------------------- |
5 | 5 | ||
6 | The controller IOP is accessed via PCI BAR0. | 6 | For Intel IOP based adapters, the controller IOP is accessed via PCI BAR0: |
7 | 7 | ||
8 | BAR0 offset Register | 8 | BAR0 offset Register |
9 | 0x10 Inbound Message Register 0 | 9 | 0x10 Inbound Message Register 0 |
@@ -18,6 +18,24 @@ The controller IOP is accessed via PCI BAR0. | |||
18 | 0x40 Inbound Queue Port | 18 | 0x40 Inbound Queue Port |
19 | 0x44 Outbound Queue Port | 19 | 0x44 Outbound Queue Port |
20 | 20 | ||
21 | For Marvell IOP based adapters, the IOP is accessed via PCI BAR0 and BAR1: | ||
22 | |||
23 | BAR0 offset Register | ||
24 | 0x20400 Inbound Doorbell Register | ||
25 | 0x20404 Inbound Interrupt Mask Register | ||
26 | 0x20408 Outbound Doorbell Register | ||
27 | 0x2040C Outbound Interrupt Mask Register | ||
28 | |||
29 | BAR1 offset Register | ||
30 | 0x0 Inbound Queue Head Pointer | ||
31 | 0x4 Inbound Queue Tail Pointer | ||
32 | 0x8 Outbound Queue Head Pointer | ||
33 | 0xC Outbound Queue Tail Pointer | ||
34 | 0x10 Inbound Message Register | ||
35 | 0x14 Outbound Message Register | ||
36 | 0x40-0x1040 Inbound Queue | ||
37 | 0x1040-0x2040 Outbound Queue | ||
38 | |||
21 | 39 | ||
22 | I/O Request Workflow | 40 | I/O Request Workflow |
23 | ---------------------- | 41 | ---------------------- |
@@ -73,15 +91,9 @@ The driver exposes following sysfs attributes: | |||
73 | driver-version R driver version string | 91 | driver-version R driver version string |
74 | firmware-version R firmware version string | 92 | firmware-version R firmware version string |
75 | 93 | ||
76 | The driver registers char device "hptiop" to communicate with HighPoint RAID | ||
77 | management software. Its ioctl routine acts as a general binary interface | ||
78 | between the IOP firmware and HighPoint RAID management software. New management | ||
79 | functions can be implemented in application/firmware without modification | ||
80 | in driver code. | ||
81 | |||
82 | 94 | ||
83 | ----------------------------------------------------------------------------- | 95 | ----------------------------------------------------------------------------- |
84 | Copyright (C) 2006 HighPoint Technologies, Inc. All Rights Reserved. | 96 | Copyright (C) 2006-2007 HighPoint Technologies, Inc. All Rights Reserved. |
85 | 97 | ||
86 | This file is distributed in the hope that it will be useful, | 98 | This file is distributed in the hope that it will be useful, |
87 | but WITHOUT ANY WARRANTY; without even the implied warranty of | 99 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
diff --git a/Documentation/scsi/ncr53c7xx.txt b/Documentation/scsi/ncr53c7xx.txt deleted file mode 100644 index 91e9552d63e5..000000000000 --- a/Documentation/scsi/ncr53c7xx.txt +++ /dev/null | |||
@@ -1,40 +0,0 @@ | |||
1 | README for WarpEngine/A4000T/A4091 SCSI kernels. | ||
2 | |||
3 | Use the following options to disable options in the SCSI driver. | ||
4 | |||
5 | Using amiboot for example..... | ||
6 | |||
7 | To disable Synchronous Negotiation.... | ||
8 | |||
9 | amiboot -k kernel 53c7xx=nosync:0 | ||
10 | |||
11 | To disable Disconnection.... | ||
12 | |||
13 | amiboot -k kernel 53c7xx=nodisconnect:0 | ||
14 | |||
15 | To disable certain SCSI devices... | ||
16 | |||
17 | amiboot -k kernel 53c7xx=validids:0x3F | ||
18 | |||
19 | this allows only device ID's 0,1,2,3,4 and 5 for linux to handle. | ||
20 | (this is a bitmasked field - i.e. each bit represents a SCSI ID) | ||
21 | |||
22 | These commands work on a per controller basis and use the option 'next' to | ||
23 | move to the next controller in the system. | ||
24 | |||
25 | e.g. | ||
26 | amiboot -k kernel 53c7xx=nodisconnect:0,next,nosync:0 | ||
27 | |||
28 | this uses No Disconnection on the first controller and Asynchronous | ||
29 | SCSI on the second controller. | ||
30 | |||
31 | Known Issues: | ||
32 | |||
33 | Two devices are known not to function with the default settings of using | ||
34 | synchronous SCSI. These are the Archive Viper 150 Tape Drive and the | ||
35 | SyQuest SQ555 removeable hard drive. When using these devices on a controller | ||
36 | use the 'nosync:0' option. | ||
37 | |||
38 | Please try these options and post any problems/successes to me. | ||
39 | |||
40 | Alan Hourihane <alanh@fairlite.demon.co.uk> | ||