]>
Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | /* |
2 | * scsi_scan.c | |
3 | * | |
4 | * Copyright (C) 2000 Eric Youngdale, | |
5 | * Copyright (C) 2002 Patrick Mansfield | |
6 | * | |
7 | * The general scanning/probing algorithm is as follows, exceptions are | |
8 | * made to it depending on device specific flags, compilation options, and | |
9 | * global variable (boot or module load time) settings. | |
10 | * | |
11 | * A specific LUN is scanned via an INQUIRY command; if the LUN has a | |
f64a181d | 12 | * device attached, a scsi_device is allocated and setup for it. |
1da177e4 LT |
13 | * |
14 | * For every id of every channel on the given host: | |
15 | * | |
16 | * Scan LUN 0; if the target responds to LUN 0 (even if there is no | |
17 | * device or storage attached to LUN 0): | |
18 | * | |
19 | * If LUN 0 has a device attached, allocate and setup a | |
f64a181d | 20 | * scsi_device for it. |
1da177e4 LT |
21 | * |
22 | * If target is SCSI-3 or up, issue a REPORT LUN, and scan | |
23 | * all of the LUNs returned by the REPORT LUN; else, | |
24 | * sequentially scan LUNs up until some maximum is reached, | |
25 | * or a LUN is seen that cannot have a device attached to it. | |
26 | */ | |
27 | ||
1da177e4 LT |
28 | #include <linux/module.h> |
29 | #include <linux/moduleparam.h> | |
30 | #include <linux/init.h> | |
31 | #include <linux/blkdev.h> | |
3e082a91 MW |
32 | #include <linux/delay.h> |
33 | #include <linux/kthread.h> | |
34 | #include <linux/spinlock.h> | |
4ace92fc | 35 | #include <linux/async.h> |
1da177e4 LT |
36 | |
37 | #include <scsi/scsi.h> | |
beb40487 | 38 | #include <scsi/scsi_cmnd.h> |
1da177e4 LT |
39 | #include <scsi/scsi_device.h> |
40 | #include <scsi/scsi_driver.h> | |
41 | #include <scsi/scsi_devinfo.h> | |
42 | #include <scsi/scsi_host.h> | |
1da177e4 LT |
43 | #include <scsi/scsi_transport.h> |
44 | #include <scsi/scsi_eh.h> | |
45 | ||
46 | #include "scsi_priv.h" | |
47 | #include "scsi_logging.h" | |
48 | ||
49 | #define ALLOC_FAILURE_MSG KERN_ERR "%s: Allocation failure during" \ | |
50 | " SCSI scanning, some SCSI devices might not be configured\n" | |
51 | ||
52 | /* | |
53 | * Default timeout | |
54 | */ | |
55 | #define SCSI_TIMEOUT (2*HZ) | |
56 | ||
57 | /* | |
405ae7d3 | 58 | * Prefix values for the SCSI id's (stored in sysfs name field) |
1da177e4 LT |
59 | */ |
60 | #define SCSI_UID_SER_NUM 'S' | |
61 | #define SCSI_UID_UNKNOWN 'Z' | |
62 | ||
63 | /* | |
64 | * Return values of some of the scanning functions. | |
65 | * | |
66 | * SCSI_SCAN_NO_RESPONSE: no valid response received from the target, this | |
67 | * includes allocation or general failures preventing IO from being sent. | |
68 | * | |
69 | * SCSI_SCAN_TARGET_PRESENT: target responded, but no device is available | |
70 | * on the given LUN. | |
71 | * | |
72 | * SCSI_SCAN_LUN_PRESENT: target responded, and a device is available on a | |
73 | * given LUN. | |
74 | */ | |
75 | #define SCSI_SCAN_NO_RESPONSE 0 | |
76 | #define SCSI_SCAN_TARGET_PRESENT 1 | |
77 | #define SCSI_SCAN_LUN_PRESENT 2 | |
78 | ||
0ad78200 | 79 | static const char *scsi_null_device_strs = "nullnullnullnull"; |
1da177e4 LT |
80 | |
81 | #define MAX_SCSI_LUNS 512 | |
82 | ||
83 | #ifdef CONFIG_SCSI_MULTI_LUN | |
84 | static unsigned int max_scsi_luns = MAX_SCSI_LUNS; | |
85 | #else | |
86 | static unsigned int max_scsi_luns = 1; | |
87 | #endif | |
88 | ||
10f4b89a | 89 | module_param_named(max_luns, max_scsi_luns, uint, S_IRUGO|S_IWUSR); |
1da177e4 LT |
90 | MODULE_PARM_DESC(max_luns, |
91 | "last scsi LUN (should be between 1 and 2^32-1)"); | |
92 | ||
21db1882 MW |
93 | #ifdef CONFIG_SCSI_SCAN_ASYNC |
94 | #define SCSI_SCAN_TYPE_DEFAULT "async" | |
95 | #else | |
96 | #define SCSI_SCAN_TYPE_DEFAULT "sync" | |
97 | #endif | |
98 | ||
99 | static char scsi_scan_type[6] = SCSI_SCAN_TYPE_DEFAULT; | |
3e082a91 MW |
100 | |
101 | module_param_string(scan, scsi_scan_type, sizeof(scsi_scan_type), S_IRUGO); | |
102 | MODULE_PARM_DESC(scan, "sync, async or none"); | |
103 | ||
1da177e4 LT |
104 | /* |
105 | * max_scsi_report_luns: the maximum number of LUNS that will be | |
106 | * returned from the REPORT LUNS command. 8 times this value must | |
107 | * be allocated. In theory this could be up to an 8 byte value, but | |
108 | * in practice, the maximum number of LUNs suppored by any device | |
109 | * is about 16k. | |
110 | */ | |
111 | static unsigned int max_scsi_report_luns = 511; | |
112 | ||
10f4b89a | 113 | module_param_named(max_report_luns, max_scsi_report_luns, uint, S_IRUGO|S_IWUSR); |
1da177e4 LT |
114 | MODULE_PARM_DESC(max_report_luns, |
115 | "REPORT LUNS maximum number of LUNS received (should be" | |
116 | " between 1 and 16384)"); | |
117 | ||
118 | static unsigned int scsi_inq_timeout = SCSI_TIMEOUT/HZ+3; | |
119 | ||
10f4b89a | 120 | module_param_named(inq_timeout, scsi_inq_timeout, uint, S_IRUGO|S_IWUSR); |
1da177e4 LT |
121 | MODULE_PARM_DESC(inq_timeout, |
122 | "Timeout (in seconds) waiting for devices to answer INQUIRY." | |
123 | " Default is 5. Some non-compliant devices need more."); | |
124 | ||
6b7f123f | 125 | /* This lock protects only this list */ |
3e082a91 MW |
126 | static DEFINE_SPINLOCK(async_scan_lock); |
127 | static LIST_HEAD(scanning_hosts); | |
128 | ||
129 | struct async_scan_data { | |
130 | struct list_head list; | |
131 | struct Scsi_Host *shost; | |
132 | struct completion prev_finished; | |
133 | }; | |
134 | ||
135 | /** | |
136 | * scsi_complete_async_scans - Wait for asynchronous scans to complete | |
137 | * | |
8bcc2412 MW |
138 | * When this function returns, any host which started scanning before |
139 | * this function was called will have finished its scan. Hosts which | |
140 | * started scanning after this function was called may or may not have | |
141 | * finished. | |
3e082a91 MW |
142 | */ |
143 | int scsi_complete_async_scans(void) | |
144 | { | |
145 | struct async_scan_data *data; | |
146 | ||
147 | do { | |
148 | if (list_empty(&scanning_hosts)) | |
149 | return 0; | |
150 | /* If we can't get memory immediately, that's OK. Just | |
151 | * sleep a little. Even if we never get memory, the async | |
152 | * scans will finish eventually. | |
153 | */ | |
154 | data = kmalloc(sizeof(*data), GFP_KERNEL); | |
155 | if (!data) | |
156 | msleep(1); | |
157 | } while (!data); | |
158 | ||
159 | data->shost = NULL; | |
160 | init_completion(&data->prev_finished); | |
161 | ||
162 | spin_lock(&async_scan_lock); | |
163 | /* Check that there's still somebody else on the list */ | |
164 | if (list_empty(&scanning_hosts)) | |
165 | goto done; | |
166 | list_add_tail(&data->list, &scanning_hosts); | |
167 | spin_unlock(&async_scan_lock); | |
168 | ||
169 | printk(KERN_INFO "scsi: waiting for bus probes to complete ...\n"); | |
170 | wait_for_completion(&data->prev_finished); | |
171 | ||
172 | spin_lock(&async_scan_lock); | |
173 | list_del(&data->list); | |
8bcc2412 MW |
174 | if (!list_empty(&scanning_hosts)) { |
175 | struct async_scan_data *next = list_entry(scanning_hosts.next, | |
176 | struct async_scan_data, list); | |
177 | complete(&next->prev_finished); | |
178 | } | |
3e082a91 MW |
179 | done: |
180 | spin_unlock(&async_scan_lock); | |
181 | ||
182 | kfree(data); | |
183 | return 0; | |
184 | } | |
185 | ||
3e082a91 MW |
186 | /* Only exported for the benefit of scsi_wait_scan */ |
187 | EXPORT_SYMBOL_GPL(scsi_complete_async_scans); | |
3e082a91 | 188 | |
f2f027c6 HD |
189 | #ifndef MODULE |
190 | /* | |
191 | * For async scanning we need to wait for all the scans to complete before | |
192 | * trying to mount the root fs. Otherwise non-modular drivers may not be ready | |
193 | * yet. | |
194 | */ | |
195 | late_initcall(scsi_complete_async_scans); | |
196 | #endif | |
197 | ||
1da177e4 LT |
198 | /** |
199 | * scsi_unlock_floptical - unlock device via a special MODE SENSE command | |
39216033 | 200 | * @sdev: scsi device to send command to |
1da177e4 LT |
201 | * @result: area to store the result of the MODE SENSE |
202 | * | |
203 | * Description: | |
39216033 | 204 | * Send a vendor specific MODE SENSE (not a MODE SELECT) command. |
1da177e4 LT |
205 | * Called for BLIST_KEY devices. |
206 | **/ | |
39216033 | 207 | static void scsi_unlock_floptical(struct scsi_device *sdev, |
1da177e4 LT |
208 | unsigned char *result) |
209 | { | |
210 | unsigned char scsi_cmd[MAX_COMMAND_SIZE]; | |
211 | ||
212 | printk(KERN_NOTICE "scsi: unlocking floptical drive\n"); | |
213 | scsi_cmd[0] = MODE_SENSE; | |
214 | scsi_cmd[1] = 0; | |
215 | scsi_cmd[2] = 0x2e; | |
216 | scsi_cmd[3] = 0; | |
39216033 | 217 | scsi_cmd[4] = 0x2a; /* size */ |
1da177e4 | 218 | scsi_cmd[5] = 0; |
39216033 | 219 | scsi_execute_req(sdev, scsi_cmd, DMA_FROM_DEVICE, result, 0x2a, NULL, |
f4f4e47e | 220 | SCSI_TIMEOUT, 3, NULL); |
1da177e4 LT |
221 | } |
222 | ||
1da177e4 LT |
223 | /** |
224 | * scsi_alloc_sdev - allocate and setup a scsi_Device | |
eb44820c RL |
225 | * @starget: which target to allocate a &scsi_device for |
226 | * @lun: which lun | |
227 | * @hostdata: usually NULL and set by ->slave_alloc instead | |
1da177e4 LT |
228 | * |
229 | * Description: | |
230 | * Allocate, initialize for io, and return a pointer to a scsi_Device. | |
231 | * Stores the @shost, @channel, @id, and @lun in the scsi_Device, and | |
232 | * adds scsi_Device to the appropriate list. | |
233 | * | |
234 | * Return value: | |
235 | * scsi_Device pointer, or NULL on failure. | |
236 | **/ | |
237 | static struct scsi_device *scsi_alloc_sdev(struct scsi_target *starget, | |
238 | unsigned int lun, void *hostdata) | |
239 | { | |
240 | struct scsi_device *sdev; | |
241 | int display_failure_msg = 1, ret; | |
242 | struct Scsi_Host *shost = dev_to_shost(starget->dev.parent); | |
a341cd0f | 243 | extern void scsi_evt_thread(struct work_struct *work); |
1da177e4 | 244 | |
24669f75 | 245 | sdev = kzalloc(sizeof(*sdev) + shost->transportt->device_size, |
1da177e4 LT |
246 | GFP_ATOMIC); |
247 | if (!sdev) | |
248 | goto out; | |
249 | ||
1da177e4 LT |
250 | sdev->vendor = scsi_null_device_strs; |
251 | sdev->model = scsi_null_device_strs; | |
252 | sdev->rev = scsi_null_device_strs; | |
253 | sdev->host = shost; | |
254 | sdev->id = starget->id; | |
255 | sdev->lun = lun; | |
256 | sdev->channel = starget->channel; | |
257 | sdev->sdev_state = SDEV_CREATED; | |
258 | INIT_LIST_HEAD(&sdev->siblings); | |
259 | INIT_LIST_HEAD(&sdev->same_target_siblings); | |
260 | INIT_LIST_HEAD(&sdev->cmd_list); | |
261 | INIT_LIST_HEAD(&sdev->starved_entry); | |
a341cd0f | 262 | INIT_LIST_HEAD(&sdev->event_list); |
1da177e4 | 263 | spin_lock_init(&sdev->list_lock); |
a341cd0f | 264 | INIT_WORK(&sdev->event_work, scsi_evt_thread); |
1da177e4 LT |
265 | |
266 | sdev->sdev_gendev.parent = get_device(&starget->dev); | |
267 | sdev->sdev_target = starget; | |
268 | ||
269 | /* usually NULL and set by ->slave_alloc instead */ | |
270 | sdev->hostdata = hostdata; | |
271 | ||
272 | /* if the device needs this changing, it may do so in the | |
273 | * slave_configure function */ | |
274 | sdev->max_device_blocked = SCSI_DEFAULT_DEVICE_BLOCKED; | |
275 | ||
276 | /* | |
277 | * Some low level driver could use device->type | |
278 | */ | |
279 | sdev->type = -1; | |
280 | ||
281 | /* | |
282 | * Assume that the device will have handshaking problems, | |
283 | * and then fix this field later if it turns out it | |
284 | * doesn't | |
285 | */ | |
286 | sdev->borken = 1; | |
287 | ||
1da177e4 LT |
288 | sdev->request_queue = scsi_alloc_queue(sdev); |
289 | if (!sdev->request_queue) { | |
290 | /* release fn is set up in scsi_sysfs_device_initialise, so | |
291 | * have to free and put manually here */ | |
292 | put_device(&starget->dev); | |
93f56089 | 293 | kfree(sdev); |
1da177e4 LT |
294 | goto out; |
295 | } | |
296 | ||
297 | sdev->request_queue->queuedata = sdev; | |
298 | scsi_adjust_queue_depth(sdev, 0, sdev->host->cmd_per_lun); | |
299 | ||
300 | scsi_sysfs_device_initialize(sdev); | |
301 | ||
302 | if (shost->hostt->slave_alloc) { | |
303 | ret = shost->hostt->slave_alloc(sdev); | |
304 | if (ret) { | |
305 | /* | |
306 | * if LLDD reports slave not present, don't clutter | |
307 | * console with alloc failure messages | |
1da177e4 LT |
308 | */ |
309 | if (ret == -ENXIO) | |
310 | display_failure_msg = 0; | |
311 | goto out_device_destroy; | |
312 | } | |
313 | } | |
314 | ||
315 | return sdev; | |
316 | ||
317 | out_device_destroy: | |
c2f9e49f | 318 | scsi_device_set_state(sdev, SDEV_DEL); |
1da177e4 | 319 | transport_destroy_device(&sdev->sdev_gendev); |
1da177e4 LT |
320 | put_device(&sdev->sdev_gendev); |
321 | out: | |
322 | if (display_failure_msg) | |
cadbd4a5 | 323 | printk(ALLOC_FAILURE_MSG, __func__); |
1da177e4 LT |
324 | return NULL; |
325 | } | |
326 | ||
643eb2d9 JB |
327 | static void scsi_target_destroy(struct scsi_target *starget) |
328 | { | |
329 | struct device *dev = &starget->dev; | |
330 | struct Scsi_Host *shost = dev_to_shost(dev->parent); | |
331 | unsigned long flags; | |
332 | ||
333 | transport_destroy_device(dev); | |
334 | spin_lock_irqsave(shost->host_lock, flags); | |
335 | if (shost->hostt->target_destroy) | |
336 | shost->hostt->target_destroy(starget); | |
337 | list_del_init(&starget->siblings); | |
338 | spin_unlock_irqrestore(shost->host_lock, flags); | |
339 | put_device(dev); | |
340 | } | |
341 | ||
1da177e4 LT |
342 | static void scsi_target_dev_release(struct device *dev) |
343 | { | |
344 | struct device *parent = dev->parent; | |
345 | struct scsi_target *starget = to_scsi_target(dev); | |
a283bd37 | 346 | |
1da177e4 LT |
347 | kfree(starget); |
348 | put_device(parent); | |
349 | } | |
350 | ||
453cd0f3 | 351 | static struct device_type scsi_target_type = { |
b0ed4336 HR |
352 | .name = "scsi_target", |
353 | .release = scsi_target_dev_release, | |
354 | }; | |
355 | ||
1da177e4 LT |
356 | int scsi_is_target_device(const struct device *dev) |
357 | { | |
b0ed4336 | 358 | return dev->type == &scsi_target_type; |
1da177e4 LT |
359 | } |
360 | EXPORT_SYMBOL(scsi_is_target_device); | |
361 | ||
362 | static struct scsi_target *__scsi_find_target(struct device *parent, | |
363 | int channel, uint id) | |
364 | { | |
365 | struct scsi_target *starget, *found_starget = NULL; | |
366 | struct Scsi_Host *shost = dev_to_shost(parent); | |
367 | /* | |
368 | * Search for an existing target for this sdev. | |
369 | */ | |
370 | list_for_each_entry(starget, &shost->__targets, siblings) { | |
371 | if (starget->id == id && | |
372 | starget->channel == channel) { | |
373 | found_starget = starget; | |
374 | break; | |
375 | } | |
376 | } | |
377 | if (found_starget) | |
378 | get_device(&found_starget->dev); | |
379 | ||
380 | return found_starget; | |
381 | } | |
382 | ||
884d25cc JB |
383 | /** |
384 | * scsi_alloc_target - allocate a new or find an existing target | |
385 | * @parent: parent of the target (need not be a scsi host) | |
386 | * @channel: target channel number (zero if no channels) | |
387 | * @id: target id number | |
388 | * | |
389 | * Return an existing target if one exists, provided it hasn't already | |
390 | * gone into STARGET_DEL state, otherwise allocate a new target. | |
391 | * | |
392 | * The target is returned with an incremented reference, so the caller | |
393 | * is responsible for both reaping and doing a last put | |
394 | */ | |
1da177e4 LT |
395 | static struct scsi_target *scsi_alloc_target(struct device *parent, |
396 | int channel, uint id) | |
397 | { | |
398 | struct Scsi_Host *shost = dev_to_shost(parent); | |
399 | struct device *dev = NULL; | |
400 | unsigned long flags; | |
401 | const int size = sizeof(struct scsi_target) | |
402 | + shost->transportt->target_size; | |
5c44cd2a | 403 | struct scsi_target *starget; |
1da177e4 | 404 | struct scsi_target *found_target; |
32f95792 | 405 | int error; |
1da177e4 | 406 | |
24669f75 | 407 | starget = kzalloc(size, GFP_KERNEL); |
1da177e4 | 408 | if (!starget) { |
cadbd4a5 | 409 | printk(KERN_ERR "%s: allocation failure\n", __func__); |
1da177e4 LT |
410 | return NULL; |
411 | } | |
1da177e4 LT |
412 | dev = &starget->dev; |
413 | device_initialize(dev); | |
414 | starget->reap_ref = 1; | |
415 | dev->parent = get_device(parent); | |
71610f55 | 416 | dev_set_name(dev, "target%d:%d:%d", shost->host_no, channel, id); |
b0ed4336 HR |
417 | #ifndef CONFIG_SYSFS_DEPRECATED |
418 | dev->bus = &scsi_bus_type; | |
419 | #endif | |
420 | dev->type = &scsi_target_type; | |
1da177e4 LT |
421 | starget->id = id; |
422 | starget->channel = channel; | |
f0c0a376 | 423 | starget->can_queue = 0; |
1da177e4 LT |
424 | INIT_LIST_HEAD(&starget->siblings); |
425 | INIT_LIST_HEAD(&starget->devices); | |
643eb2d9 | 426 | starget->state = STARGET_CREATED; |
7c9d6f16 | 427 | starget->scsi_level = SCSI_2; |
ffedb452 | 428 | retry: |
1da177e4 LT |
429 | spin_lock_irqsave(shost->host_lock, flags); |
430 | ||
431 | found_target = __scsi_find_target(parent, channel, id); | |
432 | if (found_target) | |
433 | goto found; | |
434 | ||
435 | list_add_tail(&starget->siblings, &shost->__targets); | |
436 | spin_unlock_irqrestore(shost->host_lock, flags); | |
437 | /* allocate and add */ | |
a283bd37 | 438 | transport_setup_device(dev); |
a283bd37 | 439 | if (shost->hostt->target_alloc) { |
32f95792 | 440 | error = shost->hostt->target_alloc(starget); |
a283bd37 JB |
441 | |
442 | if(error) { | |
443 | dev_printk(KERN_ERR, dev, "target allocation failed, error %d\n", error); | |
444 | /* don't want scsi_target_reap to do the final | |
445 | * put because it will be under the host lock */ | |
643eb2d9 | 446 | scsi_target_destroy(starget); |
a283bd37 JB |
447 | return NULL; |
448 | } | |
449 | } | |
884d25cc | 450 | get_device(dev); |
a283bd37 | 451 | |
1da177e4 LT |
452 | return starget; |
453 | ||
454 | found: | |
455 | found_target->reap_ref++; | |
456 | spin_unlock_irqrestore(shost->host_lock, flags); | |
ffedb452 | 457 | if (found_target->state != STARGET_DEL) { |
884d25cc | 458 | put_device(parent); |
ffedb452 JB |
459 | kfree(starget); |
460 | return found_target; | |
461 | } | |
462 | /* Unfortunately, we found a dying target; need to | |
463 | * wait until it's dead before we can get a new one */ | |
464 | put_device(&found_target->dev); | |
465 | flush_scheduled_work(); | |
466 | goto retry; | |
1da177e4 LT |
467 | } |
468 | ||
65f27f38 | 469 | static void scsi_target_reap_usercontext(struct work_struct *work) |
65110b21 | 470 | { |
65f27f38 DH |
471 | struct scsi_target *starget = |
472 | container_of(work, struct scsi_target, ew.work); | |
863a930a | 473 | |
ffedb452 JB |
474 | transport_remove_device(&starget->dev); |
475 | device_del(&starget->dev); | |
643eb2d9 | 476 | scsi_target_destroy(starget); |
863a930a JB |
477 | } |
478 | ||
1da177e4 LT |
479 | /** |
480 | * scsi_target_reap - check to see if target is in use and destroy if not | |
1da177e4 LT |
481 | * @starget: target to be checked |
482 | * | |
483 | * This is used after removing a LUN or doing a last put of the target | |
484 | * it checks atomically that nothing is using the target and removes | |
485 | * it if so. | |
486 | */ | |
487 | void scsi_target_reap(struct scsi_target *starget) | |
488 | { | |
ffedb452 JB |
489 | struct Scsi_Host *shost = dev_to_shost(starget->dev.parent); |
490 | unsigned long flags; | |
643eb2d9 JB |
491 | enum scsi_target_state state; |
492 | int empty; | |
ffedb452 JB |
493 | |
494 | spin_lock_irqsave(shost->host_lock, flags); | |
643eb2d9 JB |
495 | state = starget->state; |
496 | empty = --starget->reap_ref == 0 && | |
497 | list_empty(&starget->devices) ? 1 : 0; | |
498 | spin_unlock_irqrestore(shost->host_lock, flags); | |
ffedb452 | 499 | |
643eb2d9 | 500 | if (!empty) |
ffedb452 JB |
501 | return; |
502 | ||
643eb2d9 JB |
503 | BUG_ON(state == STARGET_DEL); |
504 | starget->state = STARGET_DEL; | |
505 | if (state == STARGET_CREATED) | |
506 | scsi_target_destroy(starget); | |
507 | else | |
508 | execute_in_process_context(scsi_target_reap_usercontext, | |
509 | &starget->ew); | |
1da177e4 LT |
510 | } |
511 | ||
e5b3cd42 AS |
512 | /** |
513 | * sanitize_inquiry_string - remove non-graphical chars from an INQUIRY result string | |
514 | * @s: INQUIRY result string to sanitize | |
515 | * @len: length of the string | |
516 | * | |
517 | * Description: | |
518 | * The SCSI spec says that INQUIRY vendor, product, and revision | |
519 | * strings must consist entirely of graphic ASCII characters, | |
520 | * padded on the right with spaces. Since not all devices obey | |
521 | * this rule, we will replace non-graphic or non-ASCII characters | |
522 | * with spaces. Exception: a NUL character is interpreted as a | |
523 | * string terminator, so all the following characters are set to | |
524 | * spaces. | |
525 | **/ | |
526 | static void sanitize_inquiry_string(unsigned char *s, int len) | |
527 | { | |
528 | int terminated = 0; | |
529 | ||
530 | for (; len > 0; (--len, ++s)) { | |
531 | if (*s == 0) | |
532 | terminated = 1; | |
533 | if (terminated || *s < 0x20 || *s > 0x7e) | |
534 | *s = ' '; | |
535 | } | |
536 | } | |
537 | ||
1da177e4 LT |
538 | /** |
539 | * scsi_probe_lun - probe a single LUN using a SCSI INQUIRY | |
39216033 | 540 | * @sdev: scsi_device to probe |
1da177e4 | 541 | * @inq_result: area to store the INQUIRY result |
39216033 | 542 | * @result_len: len of inq_result |
1da177e4 LT |
543 | * @bflags: store any bflags found here |
544 | * | |
545 | * Description: | |
39216033 | 546 | * Probe the lun associated with @req using a standard SCSI INQUIRY; |
1da177e4 | 547 | * |
39216033 | 548 | * If the INQUIRY is successful, zero is returned and the |
1da177e4 | 549 | * INQUIRY data is in @inq_result; the scsi_level and INQUIRY length |
f64a181d | 550 | * are copied to the scsi_device any flags value is stored in *@bflags. |
1da177e4 | 551 | **/ |
e5b3cd42 | 552 | static int scsi_probe_lun(struct scsi_device *sdev, unsigned char *inq_result, |
39216033 | 553 | int result_len, int *bflags) |
1da177e4 | 554 | { |
1da177e4 LT |
555 | unsigned char scsi_cmd[MAX_COMMAND_SIZE]; |
556 | int first_inquiry_len, try_inquiry_len, next_inquiry_len; | |
557 | int response_len = 0; | |
39216033 | 558 | int pass, count, result; |
1da177e4 LT |
559 | struct scsi_sense_hdr sshdr; |
560 | ||
561 | *bflags = 0; | |
562 | ||
563 | /* Perform up to 3 passes. The first pass uses a conservative | |
564 | * transfer length of 36 unless sdev->inquiry_len specifies a | |
565 | * different value. */ | |
566 | first_inquiry_len = sdev->inquiry_len ? sdev->inquiry_len : 36; | |
567 | try_inquiry_len = first_inquiry_len; | |
568 | pass = 1; | |
569 | ||
570 | next_pass: | |
9ccfc756 JB |
571 | SCSI_LOG_SCAN_BUS(3, sdev_printk(KERN_INFO, sdev, |
572 | "scsi scan: INQUIRY pass %d length %d\n", | |
573 | pass, try_inquiry_len)); | |
1da177e4 LT |
574 | |
575 | /* Each pass gets up to three chances to ignore Unit Attention */ | |
576 | for (count = 0; count < 3; ++count) { | |
5cd3bbfa FT |
577 | int resid; |
578 | ||
1da177e4 LT |
579 | memset(scsi_cmd, 0, 6); |
580 | scsi_cmd[0] = INQUIRY; | |
581 | scsi_cmd[4] = (unsigned char) try_inquiry_len; | |
1da177e4 LT |
582 | |
583 | memset(inq_result, 0, try_inquiry_len); | |
39216033 JB |
584 | |
585 | result = scsi_execute_req(sdev, scsi_cmd, DMA_FROM_DEVICE, | |
ea73a9f2 | 586 | inq_result, try_inquiry_len, &sshdr, |
f4f4e47e | 587 | HZ / 2 + HZ * scsi_inq_timeout, 3, |
5cd3bbfa | 588 | &resid); |
1da177e4 LT |
589 | |
590 | SCSI_LOG_SCAN_BUS(3, printk(KERN_INFO "scsi scan: INQUIRY %s " | |
591 | "with code 0x%x\n", | |
39216033 | 592 | result ? "failed" : "successful", result)); |
1da177e4 | 593 | |
39216033 | 594 | if (result) { |
1da177e4 LT |
595 | /* |
596 | * not-ready to ready transition [asc/ascq=0x28/0x0] | |
597 | * or power-on, reset [asc/ascq=0x29/0x0], continue. | |
598 | * INQUIRY should not yield UNIT_ATTENTION | |
599 | * but many buggy devices do so anyway. | |
600 | */ | |
39216033 | 601 | if ((driver_byte(result) & DRIVER_SENSE) && |
ea73a9f2 | 602 | scsi_sense_valid(&sshdr)) { |
1da177e4 LT |
603 | if ((sshdr.sense_key == UNIT_ATTENTION) && |
604 | ((sshdr.asc == 0x28) || | |
605 | (sshdr.asc == 0x29)) && | |
606 | (sshdr.ascq == 0)) | |
607 | continue; | |
608 | } | |
5cd3bbfa FT |
609 | } else { |
610 | /* | |
611 | * if nothing was transferred, we try | |
612 | * again. It's a workaround for some USB | |
613 | * devices. | |
614 | */ | |
615 | if (resid == try_inquiry_len) | |
616 | continue; | |
1da177e4 LT |
617 | } |
618 | break; | |
619 | } | |
620 | ||
39216033 | 621 | if (result == 0) { |
e5b3cd42 AS |
622 | sanitize_inquiry_string(&inq_result[8], 8); |
623 | sanitize_inquiry_string(&inq_result[16], 16); | |
624 | sanitize_inquiry_string(&inq_result[32], 4); | |
625 | ||
626 | response_len = inq_result[4] + 5; | |
1da177e4 LT |
627 | if (response_len > 255) |
628 | response_len = first_inquiry_len; /* sanity */ | |
629 | ||
630 | /* | |
631 | * Get any flags for this device. | |
632 | * | |
f64a181d CH |
633 | * XXX add a bflags to scsi_device, and replace the |
634 | * corresponding bit fields in scsi_device, so bflags | |
1da177e4 LT |
635 | * need not be passed as an argument. |
636 | */ | |
637 | *bflags = scsi_get_device_flags(sdev, &inq_result[8], | |
638 | &inq_result[16]); | |
639 | ||
640 | /* When the first pass succeeds we gain information about | |
641 | * what larger transfer lengths might work. */ | |
642 | if (pass == 1) { | |
643 | if (BLIST_INQUIRY_36 & *bflags) | |
644 | next_inquiry_len = 36; | |
645 | else if (BLIST_INQUIRY_58 & *bflags) | |
646 | next_inquiry_len = 58; | |
647 | else if (sdev->inquiry_len) | |
648 | next_inquiry_len = sdev->inquiry_len; | |
649 | else | |
650 | next_inquiry_len = response_len; | |
651 | ||
652 | /* If more data is available perform the second pass */ | |
653 | if (next_inquiry_len > try_inquiry_len) { | |
654 | try_inquiry_len = next_inquiry_len; | |
655 | pass = 2; | |
656 | goto next_pass; | |
657 | } | |
658 | } | |
659 | ||
660 | } else if (pass == 2) { | |
661 | printk(KERN_INFO "scsi scan: %d byte inquiry failed. " | |
662 | "Consider BLIST_INQUIRY_36 for this device\n", | |
663 | try_inquiry_len); | |
664 | ||
665 | /* If this pass failed, the third pass goes back and transfers | |
666 | * the same amount as we successfully got in the first pass. */ | |
667 | try_inquiry_len = first_inquiry_len; | |
668 | pass = 3; | |
669 | goto next_pass; | |
670 | } | |
671 | ||
672 | /* If the last transfer attempt got an error, assume the | |
673 | * peripheral doesn't exist or is dead. */ | |
39216033 JB |
674 | if (result) |
675 | return -EIO; | |
1da177e4 LT |
676 | |
677 | /* Don't report any more data than the device says is valid */ | |
678 | sdev->inquiry_len = min(try_inquiry_len, response_len); | |
679 | ||
680 | /* | |
681 | * XXX Abort if the response length is less than 36? If less than | |
682 | * 32, the lookup of the device flags (above) could be invalid, | |
683 | * and it would be possible to take an incorrect action - we do | |
684 | * not want to hang because of a short INQUIRY. On the flip side, | |
685 | * if the device is spun down or becoming ready (and so it gives a | |
686 | * short INQUIRY), an abort here prevents any further use of the | |
687 | * device, including spin up. | |
688 | * | |
e423ee31 AS |
689 | * On the whole, the best approach seems to be to assume the first |
690 | * 36 bytes are valid no matter what the device says. That's | |
691 | * better than copying < 36 bytes to the inquiry-result buffer | |
692 | * and displaying garbage for the Vendor, Product, or Revision | |
693 | * strings. | |
694 | */ | |
695 | if (sdev->inquiry_len < 36) { | |
696 | printk(KERN_INFO "scsi scan: INQUIRY result too short (%d)," | |
697 | " using 36\n", sdev->inquiry_len); | |
698 | sdev->inquiry_len = 36; | |
699 | } | |
700 | ||
701 | /* | |
1da177e4 LT |
702 | * Related to the above issue: |
703 | * | |
704 | * XXX Devices (disk or all?) should be sent a TEST UNIT READY, | |
705 | * and if not ready, sent a START_STOP to start (maybe spin up) and | |
706 | * then send the INQUIRY again, since the INQUIRY can change after | |
707 | * a device is initialized. | |
708 | * | |
709 | * Ideally, start a device if explicitly asked to do so. This | |
710 | * assumes that a device is spun up on power on, spun down on | |
711 | * request, and then spun up on request. | |
712 | */ | |
713 | ||
714 | /* | |
715 | * The scanning code needs to know the scsi_level, even if no | |
716 | * device is attached at LUN 0 (SCSI_SCAN_TARGET_PRESENT) so | |
717 | * non-zero LUNs can be scanned. | |
718 | */ | |
719 | sdev->scsi_level = inq_result[2] & 0x07; | |
720 | if (sdev->scsi_level >= 2 || | |
721 | (sdev->scsi_level == 1 && (inq_result[3] & 0x0f) == 1)) | |
722 | sdev->scsi_level++; | |
6f3a2024 | 723 | sdev->sdev_target->scsi_level = sdev->scsi_level; |
1da177e4 | 724 | |
39216033 | 725 | return 0; |
1da177e4 LT |
726 | } |
727 | ||
728 | /** | |
f64a181d | 729 | * scsi_add_lun - allocate and fully initialze a scsi_device |
6d877688 | 730 | * @sdev: holds information to be stored in the new scsi_device |
1da177e4 LT |
731 | * @inq_result: holds the result of a previous INQUIRY to the LUN |
732 | * @bflags: black/white list flag | |
6d877688 | 733 | * @async: 1 if this device is being scanned asynchronously |
1da177e4 LT |
734 | * |
735 | * Description: | |
6d877688 MW |
736 | * Initialize the scsi_device @sdev. Optionally set fields based |
737 | * on values in *@bflags. | |
1da177e4 LT |
738 | * |
739 | * Return: | |
f64a181d CH |
740 | * SCSI_SCAN_NO_RESPONSE: could not allocate or setup a scsi_device |
741 | * SCSI_SCAN_LUN_PRESENT: a new scsi_device was allocated and initialized | |
1da177e4 | 742 | **/ |
e5b3cd42 | 743 | static int scsi_add_lun(struct scsi_device *sdev, unsigned char *inq_result, |
3e082a91 | 744 | int *bflags, int async) |
1da177e4 | 745 | { |
6f4267e3 JB |
746 | int ret; |
747 | ||
1da177e4 LT |
748 | /* |
749 | * XXX do not save the inquiry, since it can change underneath us, | |
750 | * save just vendor/model/rev. | |
751 | * | |
752 | * Rather than save it and have an ioctl that retrieves the saved | |
753 | * value, have an ioctl that executes the same INQUIRY code used | |
754 | * in scsi_probe_lun, let user level programs doing INQUIRY | |
755 | * scanning run at their own risk, or supply a user level program | |
756 | * that can correctly scan. | |
757 | */ | |
09123d23 AS |
758 | |
759 | /* | |
760 | * Copy at least 36 bytes of INQUIRY data, so that we don't | |
761 | * dereference unallocated memory when accessing the Vendor, | |
762 | * Product, and Revision strings. Badly behaved devices may set | |
763 | * the INQUIRY Additional Length byte to a small value, indicating | |
764 | * these strings are invalid, but often they contain plausible data | |
765 | * nonetheless. It doesn't matter if the device sent < 36 bytes | |
766 | * total, since scsi_probe_lun() initializes inq_result with 0s. | |
767 | */ | |
768 | sdev->inquiry = kmemdup(inq_result, | |
769 | max_t(size_t, sdev->inquiry_len, 36), | |
770 | GFP_ATOMIC); | |
771 | if (sdev->inquiry == NULL) | |
1da177e4 | 772 | return SCSI_SCAN_NO_RESPONSE; |
1da177e4 | 773 | |
1da177e4 LT |
774 | sdev->vendor = (char *) (sdev->inquiry + 8); |
775 | sdev->model = (char *) (sdev->inquiry + 16); | |
776 | sdev->rev = (char *) (sdev->inquiry + 32); | |
777 | ||
778 | if (*bflags & BLIST_ISROM) { | |
6d877688 MW |
779 | sdev->type = TYPE_ROM; |
780 | sdev->removable = 1; | |
781 | } else { | |
782 | sdev->type = (inq_result[0] & 0x1f); | |
783 | sdev->removable = (inq_result[1] & 0x80) >> 7; | |
784 | } | |
1da177e4 | 785 | |
6d877688 | 786 | switch (sdev->type) { |
ddaf6fc8 | 787 | case TYPE_RBC: |
1da177e4 LT |
788 | case TYPE_TAPE: |
789 | case TYPE_DISK: | |
790 | case TYPE_PRINTER: | |
791 | case TYPE_MOD: | |
792 | case TYPE_PROCESSOR: | |
793 | case TYPE_SCANNER: | |
794 | case TYPE_MEDIUM_CHANGER: | |
795 | case TYPE_ENCLOSURE: | |
796 | case TYPE_COMM: | |
4d7db04a | 797 | case TYPE_RAID: |
82443a58 | 798 | case TYPE_OSD: |
1da177e4 LT |
799 | sdev->writeable = 1; |
800 | break; | |
1da177e4 | 801 | case TYPE_ROM: |
ddaf6fc8 | 802 | case TYPE_WORM: |
1da177e4 LT |
803 | sdev->writeable = 0; |
804 | break; | |
805 | default: | |
806 | printk(KERN_INFO "scsi: unknown device type %d\n", sdev->type); | |
807 | } | |
808 | ||
6d877688 MW |
809 | if (sdev->type == TYPE_RBC || sdev->type == TYPE_ROM) { |
810 | /* RBC and MMC devices can return SCSI-3 compliance and yet | |
811 | * still not support REPORT LUNS, so make them act as | |
812 | * BLIST_NOREPORTLUN unless BLIST_REPORTLUN2 is | |
813 | * specifically set */ | |
814 | if ((*bflags & BLIST_REPORTLUN2) == 0) | |
815 | *bflags |= BLIST_NOREPORTLUN; | |
816 | } | |
817 | ||
1da177e4 LT |
818 | /* |
819 | * For a peripheral qualifier (PQ) value of 1 (001b), the SCSI | |
820 | * spec says: The device server is capable of supporting the | |
821 | * specified peripheral device type on this logical unit. However, | |
822 | * the physical device is not currently connected to this logical | |
823 | * unit. | |
824 | * | |
825 | * The above is vague, as it implies that we could treat 001 and | |
826 | * 011 the same. Stay compatible with previous code, and create a | |
f64a181d | 827 | * scsi_device for a PQ of 1 |
1da177e4 LT |
828 | * |
829 | * Don't set the device offline here; rather let the upper | |
830 | * level drivers eval the PQ to decide whether they should | |
831 | * attach. So remove ((inq_result[0] >> 5) & 7) == 1 check. | |
832 | */ | |
833 | ||
834 | sdev->inq_periph_qual = (inq_result[0] >> 5) & 7; | |
1da177e4 LT |
835 | sdev->lockable = sdev->removable; |
836 | sdev->soft_reset = (inq_result[7] & 1) && ((inq_result[3] & 7) == 2); | |
837 | ||
6d877688 MW |
838 | if (sdev->scsi_level >= SCSI_3 || |
839 | (sdev->inquiry_len > 56 && inq_result[56] & 0x04)) | |
1da177e4 LT |
840 | sdev->ppr = 1; |
841 | if (inq_result[7] & 0x60) | |
842 | sdev->wdtr = 1; | |
843 | if (inq_result[7] & 0x10) | |
844 | sdev->sdtr = 1; | |
845 | ||
19ac0db3 | 846 | sdev_printk(KERN_NOTICE, sdev, "%s %.8s %.16s %.4s PQ: %d " |
4ff36718 MW |
847 | "ANSI: %d%s\n", scsi_device_type(sdev->type), |
848 | sdev->vendor, sdev->model, sdev->rev, | |
849 | sdev->inq_periph_qual, inq_result[2] & 0x07, | |
850 | (inq_result[3] & 0x0f) == 1 ? " CCS" : ""); | |
851 | ||
1da177e4 LT |
852 | if ((sdev->scsi_level >= SCSI_2) && (inq_result[7] & 2) && |
853 | !(*bflags & BLIST_NOTQ)) | |
854 | sdev->tagged_supported = 1; | |
6d877688 | 855 | |
1da177e4 LT |
856 | /* |
857 | * Some devices (Texel CD ROM drives) have handshaking problems | |
858 | * when used with the Seagate controllers. borken is initialized | |
859 | * to 1, and then set it to 0 here. | |
860 | */ | |
861 | if ((*bflags & BLIST_BORKEN) == 0) | |
862 | sdev->borken = 0; | |
863 | ||
6d877688 MW |
864 | if (*bflags & BLIST_NO_ULD_ATTACH) |
865 | sdev->no_uld_attach = 1; | |
866 | ||
1da177e4 LT |
867 | /* |
868 | * Apparently some really broken devices (contrary to the SCSI | |
869 | * standards) need to be selected without asserting ATN | |
870 | */ | |
871 | if (*bflags & BLIST_SELECT_NO_ATN) | |
872 | sdev->select_no_atn = 1; | |
873 | ||
4d7db04a JB |
874 | /* |
875 | * Maximum 512 sector transfer length | |
876 | * broken RA4x00 Compaq Disk Array | |
877 | */ | |
878 | if (*bflags & BLIST_MAX_512) | |
879 | blk_queue_max_sectors(sdev->request_queue, 512); | |
880 | ||
1da177e4 LT |
881 | /* |
882 | * Some devices may not want to have a start command automatically | |
883 | * issued when a device is added. | |
884 | */ | |
885 | if (*bflags & BLIST_NOSTARTONADD) | |
886 | sdev->no_start_on_add = 1; | |
887 | ||
888 | if (*bflags & BLIST_SINGLELUN) | |
25d7c363 | 889 | scsi_target(sdev)->single_lun = 1; |
1da177e4 | 890 | |
1da177e4 LT |
891 | sdev->use_10_for_rw = 1; |
892 | ||
893 | if (*bflags & BLIST_MS_SKIP_PAGE_08) | |
894 | sdev->skip_ms_page_8 = 1; | |
895 | ||
896 | if (*bflags & BLIST_MS_SKIP_PAGE_3F) | |
897 | sdev->skip_ms_page_3f = 1; | |
898 | ||
899 | if (*bflags & BLIST_USE_10_BYTE_MS) | |
900 | sdev->use_10_for_ms = 1; | |
901 | ||
902 | /* set the device running here so that slave configure | |
903 | * may do I/O */ | |
6f4267e3 JB |
904 | ret = scsi_device_set_state(sdev, SDEV_RUNNING); |
905 | if (ret) { | |
906 | ret = scsi_device_set_state(sdev, SDEV_BLOCK); | |
907 | ||
908 | if (ret) { | |
909 | sdev_printk(KERN_ERR, sdev, | |
910 | "in wrong state %s to complete scan\n", | |
911 | scsi_device_state_name(sdev->sdev_state)); | |
912 | return SCSI_SCAN_NO_RESPONSE; | |
913 | } | |
914 | } | |
1da177e4 LT |
915 | |
916 | if (*bflags & BLIST_MS_192_BYTES_FOR_3F) | |
917 | sdev->use_192_bytes_for_3f = 1; | |
918 | ||
919 | if (*bflags & BLIST_NOT_LOCKABLE) | |
920 | sdev->lockable = 0; | |
921 | ||
922 | if (*bflags & BLIST_RETRY_HWERROR) | |
923 | sdev->retry_hwerror = 1; | |
924 | ||
925 | transport_configure_device(&sdev->sdev_gendev); | |
926 | ||
93805091 | 927 | if (sdev->host->hostt->slave_configure) { |
6f4267e3 | 928 | ret = sdev->host->hostt->slave_configure(sdev); |
93805091 CH |
929 | if (ret) { |
930 | /* | |
931 | * if LLDD reports slave not present, don't clutter | |
932 | * console with alloc failure messages | |
933 | */ | |
934 | if (ret != -ENXIO) { | |
935 | sdev_printk(KERN_ERR, sdev, | |
936 | "failed to configure device\n"); | |
937 | } | |
938 | return SCSI_SCAN_NO_RESPONSE; | |
939 | } | |
940 | } | |
1da177e4 LT |
941 | |
942 | /* | |
943 | * Ok, the device is now all set up, we can | |
944 | * register it and tell the rest of the kernel | |
945 | * about it. | |
946 | */ | |
3e082a91 | 947 | if (!async && scsi_sysfs_add_sdev(sdev) != 0) |
b24b1033 | 948 | return SCSI_SCAN_NO_RESPONSE; |
1da177e4 LT |
949 | |
950 | return SCSI_SCAN_LUN_PRESENT; | |
951 | } | |
952 | ||
6f3a2024 JB |
953 | static inline void scsi_destroy_sdev(struct scsi_device *sdev) |
954 | { | |
309bd271 | 955 | scsi_device_set_state(sdev, SDEV_DEL); |
6f3a2024 JB |
956 | if (sdev->host->hostt->slave_destroy) |
957 | sdev->host->hostt->slave_destroy(sdev); | |
958 | transport_destroy_device(&sdev->sdev_gendev); | |
959 | put_device(&sdev->sdev_gendev); | |
960 | } | |
961 | ||
c5f2e640 | 962 | #ifdef CONFIG_SCSI_LOGGING |
6c7154c9 | 963 | /** |
eb44820c | 964 | * scsi_inq_str - print INQUIRY data from min to max index, strip trailing whitespace |
6c7154c9 KG |
965 | * @buf: Output buffer with at least end-first+1 bytes of space |
966 | * @inq: Inquiry buffer (input) | |
967 | * @first: Offset of string into inq | |
968 | * @end: Index after last character in inq | |
969 | */ | |
c5f2e640 | 970 | static unsigned char *scsi_inq_str(unsigned char *buf, unsigned char *inq, |
6c7154c9 KG |
971 | unsigned first, unsigned end) |
972 | { | |
973 | unsigned term = 0, idx; | |
c5f2e640 | 974 | |
975 | for (idx = 0; idx + first < end && idx + first < inq[4] + 5; idx++) { | |
976 | if (inq[idx+first] > ' ') { | |
6c7154c9 KG |
977 | buf[idx] = inq[idx+first]; |
978 | term = idx+1; | |
979 | } else { | |
980 | buf[idx] = ' '; | |
981 | } | |
982 | } | |
983 | buf[term] = 0; | |
984 | return buf; | |
985 | } | |
c5f2e640 | 986 | #endif |
6f3a2024 | 987 | |
1da177e4 LT |
988 | /** |
989 | * scsi_probe_and_add_lun - probe a LUN, if a LUN is found add it | |
990 | * @starget: pointer to target device structure | |
991 | * @lun: LUN of target device | |
1da177e4 | 992 | * @bflagsp: store bflags here if not NULL |
eb44820c RL |
993 | * @sdevp: probe the LUN corresponding to this scsi_device |
994 | * @rescan: if nonzero skip some code only needed on first scan | |
995 | * @hostdata: passed to scsi_alloc_sdev() | |
1da177e4 LT |
996 | * |
997 | * Description: | |
998 | * Call scsi_probe_lun, if a LUN with an attached device is found, | |
999 | * allocate and set it up by calling scsi_add_lun. | |
1000 | * | |
1001 | * Return: | |
f64a181d | 1002 | * SCSI_SCAN_NO_RESPONSE: could not allocate or setup a scsi_device |
1da177e4 LT |
1003 | * SCSI_SCAN_TARGET_PRESENT: target responded, but no device is |
1004 | * attached at the LUN | |
f64a181d | 1005 | * SCSI_SCAN_LUN_PRESENT: a new scsi_device was allocated and initialized |
1da177e4 LT |
1006 | **/ |
1007 | static int scsi_probe_and_add_lun(struct scsi_target *starget, | |
1008 | uint lun, int *bflagsp, | |
1009 | struct scsi_device **sdevp, int rescan, | |
1010 | void *hostdata) | |
1011 | { | |
1012 | struct scsi_device *sdev; | |
1da177e4 | 1013 | unsigned char *result; |
39216033 | 1014 | int bflags, res = SCSI_SCAN_NO_RESPONSE, result_len = 256; |
1da177e4 LT |
1015 | struct Scsi_Host *shost = dev_to_shost(starget->dev.parent); |
1016 | ||
1017 | /* | |
1018 | * The rescan flag is used as an optimization, the first scan of a | |
1019 | * host adapter calls into here with rescan == 0. | |
1020 | */ | |
6f3a2024 JB |
1021 | sdev = scsi_device_lookup_by_target(starget, lun); |
1022 | if (sdev) { | |
0f1d87a2 | 1023 | if (rescan || !scsi_device_created(sdev)) { |
1da177e4 LT |
1024 | SCSI_LOG_SCAN_BUS(3, printk(KERN_INFO |
1025 | "scsi scan: device exists on %s\n", | |
71610f55 | 1026 | dev_name(&sdev->sdev_gendev))); |
1da177e4 LT |
1027 | if (sdevp) |
1028 | *sdevp = sdev; | |
1029 | else | |
1030 | scsi_device_put(sdev); | |
1031 | ||
1032 | if (bflagsp) | |
1033 | *bflagsp = scsi_get_device_flags(sdev, | |
1034 | sdev->vendor, | |
1035 | sdev->model); | |
1036 | return SCSI_SCAN_LUN_PRESENT; | |
1037 | } | |
6f3a2024 JB |
1038 | scsi_device_put(sdev); |
1039 | } else | |
1040 | sdev = scsi_alloc_sdev(starget, lun, hostdata); | |
1da177e4 LT |
1041 | if (!sdev) |
1042 | goto out; | |
39216033 JB |
1043 | |
1044 | result = kmalloc(result_len, GFP_ATOMIC | | |
bc86120a | 1045 | ((shost->unchecked_isa_dma) ? __GFP_DMA : 0)); |
1da177e4 | 1046 | if (!result) |
39216033 | 1047 | goto out_free_sdev; |
1da177e4 | 1048 | |
39216033 | 1049 | if (scsi_probe_lun(sdev, result, result_len, &bflags)) |
1da177e4 LT |
1050 | goto out_free_result; |
1051 | ||
4186ab19 KG |
1052 | if (bflagsp) |
1053 | *bflagsp = bflags; | |
1da177e4 LT |
1054 | /* |
1055 | * result contains valid SCSI INQUIRY data. | |
1056 | */ | |
13f7e5ac | 1057 | if (((result[0] >> 5) == 3) && !(bflags & BLIST_ATTACH_PQ3)) { |
1da177e4 LT |
1058 | /* |
1059 | * For a Peripheral qualifier 3 (011b), the SCSI | |
1060 | * spec says: The device server is not capable of | |
1061 | * supporting a physical device on this logical | |
1062 | * unit. | |
1063 | * | |
1064 | * For disks, this implies that there is no | |
1065 | * logical disk configured at sdev->lun, but there | |
1066 | * is a target id responding. | |
1067 | */ | |
6c7154c9 KG |
1068 | SCSI_LOG_SCAN_BUS(2, sdev_printk(KERN_INFO, sdev, "scsi scan:" |
1069 | " peripheral qualifier of 3, device not" | |
1070 | " added\n")) | |
1071 | if (lun == 0) { | |
c5f2e640 | 1072 | SCSI_LOG_SCAN_BUS(1, { |
1073 | unsigned char vend[9]; | |
1074 | unsigned char mod[17]; | |
1075 | ||
1076 | sdev_printk(KERN_INFO, sdev, | |
6c7154c9 | 1077 | "scsi scan: consider passing scsi_mod." |
3424a65d | 1078 | "dev_flags=%s:%s:0x240 or 0x1000240\n", |
6c7154c9 | 1079 | scsi_inq_str(vend, result, 8, 16), |
c5f2e640 | 1080 | scsi_inq_str(mod, result, 16, 32)); |
1081 | }); | |
643eb2d9 | 1082 | |
6c7154c9 | 1083 | } |
643eb2d9 | 1084 | |
1da177e4 LT |
1085 | res = SCSI_SCAN_TARGET_PRESENT; |
1086 | goto out_free_result; | |
1087 | } | |
1088 | ||
1bfc5d9d | 1089 | /* |
84961f28 | 1090 | * Some targets may set slight variations of PQ and PDT to signal |
1091 | * that no LUN is present, so don't add sdev in these cases. | |
1092 | * Two specific examples are: | |
1093 | * 1) NetApp targets: return PQ=1, PDT=0x1f | |
1094 | * 2) USB UFI: returns PDT=0x1f, with the PQ bits being "reserved" | |
1095 | * in the UFI 1.0 spec (we cannot rely on reserved bits). | |
1096 | * | |
1097 | * References: | |
1098 | * 1) SCSI SPC-3, pp. 145-146 | |
1099 | * PQ=1: "A peripheral device having the specified peripheral | |
1100 | * device type is not connected to this logical unit. However, the | |
1101 | * device server is capable of supporting the specified peripheral | |
1102 | * device type on this logical unit." | |
1103 | * PDT=0x1f: "Unknown or no device type" | |
1104 | * 2) USB UFI 1.0, p. 20 | |
1105 | * PDT=00h Direct-access device (floppy) | |
1106 | * PDT=1Fh none (no FDD connected to the requested logical unit) | |
1bfc5d9d | 1107 | */ |
84961f28 | 1108 | if (((result[0] >> 5) == 1 || starget->pdt_1f_for_no_lun) && |
01b291bd JB |
1109 | (result[0] & 0x1f) == 0x1f && |
1110 | !scsi_is_wlun(lun)) { | |
1bfc5d9d AS |
1111 | SCSI_LOG_SCAN_BUS(3, printk(KERN_INFO |
1112 | "scsi scan: peripheral device type" | |
1113 | " of 31, no device added\n")); | |
1114 | res = SCSI_SCAN_TARGET_PRESENT; | |
1115 | goto out_free_result; | |
1116 | } | |
1117 | ||
3e082a91 | 1118 | res = scsi_add_lun(sdev, result, &bflags, shost->async_scan); |
1da177e4 LT |
1119 | if (res == SCSI_SCAN_LUN_PRESENT) { |
1120 | if (bflags & BLIST_KEY) { | |
1121 | sdev->lockable = 0; | |
39216033 | 1122 | scsi_unlock_floptical(sdev, result); |
1da177e4 | 1123 | } |
1da177e4 LT |
1124 | } |
1125 | ||
1126 | out_free_result: | |
1127 | kfree(result); | |
1da177e4 LT |
1128 | out_free_sdev: |
1129 | if (res == SCSI_SCAN_LUN_PRESENT) { | |
1130 | if (sdevp) { | |
b70d37bf AS |
1131 | if (scsi_device_get(sdev) == 0) { |
1132 | *sdevp = sdev; | |
1133 | } else { | |
1134 | __scsi_remove_device(sdev); | |
1135 | res = SCSI_SCAN_NO_RESPONSE; | |
1136 | } | |
1da177e4 | 1137 | } |
6f3a2024 JB |
1138 | } else |
1139 | scsi_destroy_sdev(sdev); | |
1da177e4 LT |
1140 | out: |
1141 | return res; | |
1142 | } | |
1143 | ||
1144 | /** | |
1145 | * scsi_sequential_lun_scan - sequentially scan a SCSI target | |
1146 | * @starget: pointer to target structure to scan | |
1147 | * @bflags: black/white list flag for LUN 0 | |
eb44820c RL |
1148 | * @scsi_level: Which version of the standard does this device adhere to |
1149 | * @rescan: passed to scsi_probe_add_lun() | |
1da177e4 LT |
1150 | * |
1151 | * Description: | |
1152 | * Generally, scan from LUN 1 (LUN 0 is assumed to already have been | |
1153 | * scanned) to some maximum lun until a LUN is found with no device | |
1154 | * attached. Use the bflags to figure out any oddities. | |
1155 | * | |
1156 | * Modifies sdevscan->lun. | |
1157 | **/ | |
1158 | static void scsi_sequential_lun_scan(struct scsi_target *starget, | |
4186ab19 | 1159 | int bflags, int scsi_level, int rescan) |
1da177e4 LT |
1160 | { |
1161 | unsigned int sparse_lun, lun, max_dev_lun; | |
1162 | struct Scsi_Host *shost = dev_to_shost(starget->dev.parent); | |
1163 | ||
1164 | SCSI_LOG_SCAN_BUS(3, printk(KERN_INFO "scsi scan: Sequential scan of" | |
71610f55 | 1165 | "%s\n", dev_name(&starget->dev))); |
1da177e4 LT |
1166 | |
1167 | max_dev_lun = min(max_scsi_luns, shost->max_lun); | |
1168 | /* | |
1169 | * If this device is known to support sparse multiple units, | |
1170 | * override the other settings, and scan all of them. Normally, | |
1171 | * SCSI-3 devices should be scanned via the REPORT LUNS. | |
1172 | */ | |
1173 | if (bflags & BLIST_SPARSELUN) { | |
1174 | max_dev_lun = shost->max_lun; | |
1175 | sparse_lun = 1; | |
1176 | } else | |
1177 | sparse_lun = 0; | |
1178 | ||
1da177e4 LT |
1179 | /* |
1180 | * If less than SCSI_1_CSS, and no special lun scaning, stop | |
1181 | * scanning; this matches 2.4 behaviour, but could just be a bug | |
1182 | * (to continue scanning a SCSI_1_CSS device). | |
1183 | * | |
1184 | * This test is broken. We might not have any device on lun0 for | |
1185 | * a sparselun device, and if that's the case then how would we | |
1186 | * know the real scsi_level, eh? It might make sense to just not | |
1187 | * scan any SCSI_1 device for non-0 luns, but that check would best | |
1188 | * go into scsi_alloc_sdev() and just have it return null when asked | |
1189 | * to alloc an sdev for lun > 0 on an already found SCSI_1 device. | |
1190 | * | |
1191 | if ((sdevscan->scsi_level < SCSI_1_CCS) && | |
1192 | ((bflags & (BLIST_FORCELUN | BLIST_SPARSELUN | BLIST_MAX5LUN)) | |
1193 | == 0)) | |
1194 | return; | |
1195 | */ | |
1196 | /* | |
1197 | * If this device is known to support multiple units, override | |
1198 | * the other settings, and scan all of them. | |
1199 | */ | |
1200 | if (bflags & BLIST_FORCELUN) | |
1201 | max_dev_lun = shost->max_lun; | |
1202 | /* | |
1203 | * REGAL CDC-4X: avoid hang after LUN 4 | |
1204 | */ | |
1205 | if (bflags & BLIST_MAX5LUN) | |
1206 | max_dev_lun = min(5U, max_dev_lun); | |
1207 | /* | |
1208 | * Do not scan SCSI-2 or lower device past LUN 7, unless | |
1209 | * BLIST_LARGELUN. | |
1210 | */ | |
1211 | if (scsi_level < SCSI_3 && !(bflags & BLIST_LARGELUN)) | |
1212 | max_dev_lun = min(8U, max_dev_lun); | |
1213 | ||
1214 | /* | |
1215 | * We have already scanned LUN 0, so start at LUN 1. Keep scanning | |
1216 | * until we reach the max, or no LUN is found and we are not | |
1217 | * sparse_lun. | |
1218 | */ | |
1219 | for (lun = 1; lun < max_dev_lun; ++lun) | |
1220 | if ((scsi_probe_and_add_lun(starget, lun, NULL, NULL, rescan, | |
1221 | NULL) != SCSI_SCAN_LUN_PRESENT) && | |
1222 | !sparse_lun) | |
1223 | return; | |
1224 | } | |
1225 | ||
1226 | /** | |
1227 | * scsilun_to_int: convert a scsi_lun to an int | |
1228 | * @scsilun: struct scsi_lun to be converted. | |
1229 | * | |
1230 | * Description: | |
1231 | * Convert @scsilun from a struct scsi_lun to a four byte host byte-ordered | |
1232 | * integer, and return the result. The caller must check for | |
1233 | * truncation before using this function. | |
1234 | * | |
1235 | * Notes: | |
1236 | * The struct scsi_lun is assumed to be four levels, with each level | |
1237 | * effectively containing a SCSI byte-ordered (big endian) short; the | |
1238 | * addressing bits of each level are ignored (the highest two bits). | |
1239 | * For a description of the LUN format, post SCSI-3 see the SCSI | |
1240 | * Architecture Model, for SCSI-3 see the SCSI Controller Commands. | |
1241 | * | |
1242 | * Given a struct scsi_lun of: 0a 04 0b 03 00 00 00 00, this function returns | |
1243 | * the integer: 0x0b030a04 | |
1244 | **/ | |
462b7859 | 1245 | int scsilun_to_int(struct scsi_lun *scsilun) |
1da177e4 LT |
1246 | { |
1247 | int i; | |
1248 | unsigned int lun; | |
1249 | ||
1250 | lun = 0; | |
1251 | for (i = 0; i < sizeof(lun); i += 2) | |
1252 | lun = lun | (((scsilun->scsi_lun[i] << 8) | | |
1253 | scsilun->scsi_lun[i + 1]) << (i * 8)); | |
1254 | return lun; | |
1255 | } | |
462b7859 | 1256 | EXPORT_SYMBOL(scsilun_to_int); |
1da177e4 | 1257 | |
2f4701d8 JSEC |
1258 | /** |
1259 | * int_to_scsilun: reverts an int into a scsi_lun | |
eb44820c | 1260 | * @lun: integer to be reverted |
2f4701d8 JSEC |
1261 | * @scsilun: struct scsi_lun to be set. |
1262 | * | |
1263 | * Description: | |
1264 | * Reverts the functionality of the scsilun_to_int, which packed | |
1265 | * an 8-byte lun value into an int. This routine unpacks the int | |
1266 | * back into the lun value. | |
1267 | * Note: the scsilun_to_int() routine does not truly handle all | |
1268 | * 8bytes of the lun value. This functions restores only as much | |
1269 | * as was set by the routine. | |
1270 | * | |
1271 | * Notes: | |
1272 | * Given an integer : 0x0b030a04, this function returns a | |
1273 | * scsi_lun of : struct scsi_lun of: 0a 04 0b 03 00 00 00 00 | |
1274 | * | |
1275 | **/ | |
1276 | void int_to_scsilun(unsigned int lun, struct scsi_lun *scsilun) | |
1277 | { | |
1278 | int i; | |
1279 | ||
1280 | memset(scsilun->scsi_lun, 0, sizeof(scsilun->scsi_lun)); | |
1281 | ||
1282 | for (i = 0; i < sizeof(lun); i += 2) { | |
1283 | scsilun->scsi_lun[i] = (lun >> 8) & 0xFF; | |
1284 | scsilun->scsi_lun[i+1] = lun & 0xFF; | |
1285 | lun = lun >> 16; | |
1286 | } | |
1287 | } | |
1288 | EXPORT_SYMBOL(int_to_scsilun); | |
1289 | ||
1da177e4 LT |
1290 | /** |
1291 | * scsi_report_lun_scan - Scan using SCSI REPORT LUN results | |
eb44820c RL |
1292 | * @starget: which target |
1293 | * @bflags: Zero or a mix of BLIST_NOLUN, BLIST_REPORTLUN2, or BLIST_NOREPORTLUN | |
1294 | * @rescan: nonzero if we can skip code only needed on first scan | |
1da177e4 LT |
1295 | * |
1296 | * Description: | |
eb44820c RL |
1297 | * Fast scanning for modern (SCSI-3) devices by sending a REPORT LUN command. |
1298 | * Scan the resulting list of LUNs by calling scsi_probe_and_add_lun. | |
1da177e4 | 1299 | * |
eb44820c RL |
1300 | * If BLINK_REPORTLUN2 is set, scan a target that supports more than 8 |
1301 | * LUNs even if it's older than SCSI-3. | |
1302 | * If BLIST_NOREPORTLUN is set, return 1 always. | |
1303 | * If BLIST_NOLUN is set, return 0 always. | |
1da177e4 LT |
1304 | * |
1305 | * Return: | |
1306 | * 0: scan completed (or no memory, so further scanning is futile) | |
eb44820c | 1307 | * 1: could not scan with REPORT LUN |
1da177e4 | 1308 | **/ |
6f3a2024 | 1309 | static int scsi_report_lun_scan(struct scsi_target *starget, int bflags, |
1da177e4 LT |
1310 | int rescan) |
1311 | { | |
1312 | char devname[64]; | |
1313 | unsigned char scsi_cmd[MAX_COMMAND_SIZE]; | |
1314 | unsigned int length; | |
1315 | unsigned int lun; | |
1316 | unsigned int num_luns; | |
1317 | unsigned int retries; | |
39216033 | 1318 | int result; |
1da177e4 | 1319 | struct scsi_lun *lunp, *lun_data; |
1da177e4 LT |
1320 | u8 *data; |
1321 | struct scsi_sense_hdr sshdr; | |
6f3a2024 JB |
1322 | struct scsi_device *sdev; |
1323 | struct Scsi_Host *shost = dev_to_shost(&starget->dev); | |
2ef89198 | 1324 | int ret = 0; |
1da177e4 LT |
1325 | |
1326 | /* | |
1327 | * Only support SCSI-3 and up devices if BLIST_NOREPORTLUN is not set. | |
1328 | * Also allow SCSI-2 if BLIST_REPORTLUN2 is set and host adapter does | |
1329 | * support more than 8 LUNs. | |
1330 | */ | |
4d7db04a JB |
1331 | if (bflags & BLIST_NOREPORTLUN) |
1332 | return 1; | |
1333 | if (starget->scsi_level < SCSI_2 && | |
1334 | starget->scsi_level != SCSI_UNKNOWN) | |
1335 | return 1; | |
1336 | if (starget->scsi_level < SCSI_3 && | |
1337 | (!(bflags & BLIST_REPORTLUN2) || shost->max_lun <= 8)) | |
1da177e4 LT |
1338 | return 1; |
1339 | if (bflags & BLIST_NOLUN) | |
1340 | return 0; | |
1341 | ||
6f3a2024 JB |
1342 | if (!(sdev = scsi_device_lookup_by_target(starget, 0))) { |
1343 | sdev = scsi_alloc_sdev(starget, 0, NULL); | |
1344 | if (!sdev) | |
1345 | return 0; | |
1346 | if (scsi_device_get(sdev)) | |
1347 | return 0; | |
1348 | } | |
1349 | ||
1da177e4 | 1350 | sprintf(devname, "host %d channel %d id %d", |
6f3a2024 | 1351 | shost->host_no, sdev->channel, sdev->id); |
1da177e4 LT |
1352 | |
1353 | /* | |
1354 | * Allocate enough to hold the header (the same size as one scsi_lun) | |
1355 | * plus the max number of luns we are requesting. | |
1356 | * | |
1357 | * Reallocating and trying again (with the exact amount we need) | |
1358 | * would be nice, but then we need to somehow limit the size | |
1359 | * allocated based on the available memory and the limits of | |
1360 | * kmalloc - we don't want a kmalloc() failure of a huge value to | |
1361 | * prevent us from finding any LUNs on this target. | |
1362 | */ | |
1363 | length = (max_scsi_report_luns + 1) * sizeof(struct scsi_lun); | |
1364 | lun_data = kmalloc(length, GFP_ATOMIC | | |
1365 | (sdev->host->unchecked_isa_dma ? __GFP_DMA : 0)); | |
6f3a2024 | 1366 | if (!lun_data) { |
cadbd4a5 | 1367 | printk(ALLOC_FAILURE_MSG, __func__); |
39216033 | 1368 | goto out; |
6f3a2024 | 1369 | } |
1da177e4 LT |
1370 | |
1371 | scsi_cmd[0] = REPORT_LUNS; | |
1372 | ||
1373 | /* | |
1374 | * bytes 1 - 5: reserved, set to zero. | |
1375 | */ | |
1376 | memset(&scsi_cmd[1], 0, 5); | |
1377 | ||
1378 | /* | |
1379 | * bytes 6 - 9: length of the command. | |
1380 | */ | |
1381 | scsi_cmd[6] = (unsigned char) (length >> 24) & 0xff; | |
1382 | scsi_cmd[7] = (unsigned char) (length >> 16) & 0xff; | |
1383 | scsi_cmd[8] = (unsigned char) (length >> 8) & 0xff; | |
1384 | scsi_cmd[9] = (unsigned char) length & 0xff; | |
1385 | ||
1386 | scsi_cmd[10] = 0; /* reserved */ | |
1387 | scsi_cmd[11] = 0; /* control */ | |
1da177e4 LT |
1388 | |
1389 | /* | |
1390 | * We can get a UNIT ATTENTION, for example a power on/reset, so | |
1391 | * retry a few times (like sd.c does for TEST UNIT READY). | |
1392 | * Experience shows some combinations of adapter/devices get at | |
1393 | * least two power on/resets. | |
1394 | * | |
1395 | * Illegal requests (for devices that do not support REPORT LUNS) | |
1396 | * should come through as a check condition, and will not generate | |
1397 | * a retry. | |
1398 | */ | |
1399 | for (retries = 0; retries < 3; retries++) { | |
1400 | SCSI_LOG_SCAN_BUS(3, printk (KERN_INFO "scsi scan: Sending" | |
1401 | " REPORT LUNS to %s (try %d)\n", devname, | |
1402 | retries)); | |
39216033 | 1403 | |
39216033 | 1404 | result = scsi_execute_req(sdev, scsi_cmd, DMA_FROM_DEVICE, |
ea73a9f2 | 1405 | lun_data, length, &sshdr, |
f4f4e47e | 1406 | SCSI_TIMEOUT + 4 * HZ, 3, NULL); |
39216033 | 1407 | |
1da177e4 | 1408 | SCSI_LOG_SCAN_BUS(3, printk (KERN_INFO "scsi scan: REPORT LUNS" |
39216033 JB |
1409 | " %s (try %d) result 0x%x\n", result |
1410 | ? "failed" : "successful", retries, result)); | |
1411 | if (result == 0) | |
1da177e4 | 1412 | break; |
ea73a9f2 | 1413 | else if (scsi_sense_valid(&sshdr)) { |
1da177e4 LT |
1414 | if (sshdr.sense_key != UNIT_ATTENTION) |
1415 | break; | |
1416 | } | |
1417 | } | |
1418 | ||
39216033 | 1419 | if (result) { |
1da177e4 LT |
1420 | /* |
1421 | * The device probably does not support a REPORT LUN command | |
1422 | */ | |
2ef89198 AS |
1423 | ret = 1; |
1424 | goto out_err; | |
1da177e4 | 1425 | } |
1da177e4 LT |
1426 | |
1427 | /* | |
1428 | * Get the length from the first four bytes of lun_data. | |
1429 | */ | |
1430 | data = (u8 *) lun_data->scsi_lun; | |
1431 | length = ((data[0] << 24) | (data[1] << 16) | | |
1432 | (data[2] << 8) | (data[3] << 0)); | |
1433 | ||
1434 | num_luns = (length / sizeof(struct scsi_lun)); | |
1435 | if (num_luns > max_scsi_report_luns) { | |
1436 | printk(KERN_WARNING "scsi: On %s only %d (max_scsi_report_luns)" | |
1437 | " of %d luns reported, try increasing" | |
1438 | " max_scsi_report_luns.\n", devname, | |
1439 | max_scsi_report_luns, num_luns); | |
1440 | num_luns = max_scsi_report_luns; | |
1441 | } | |
1442 | ||
3bf743e7 JG |
1443 | SCSI_LOG_SCAN_BUS(3, sdev_printk (KERN_INFO, sdev, |
1444 | "scsi scan: REPORT LUN scan\n")); | |
1da177e4 LT |
1445 | |
1446 | /* | |
1447 | * Scan the luns in lun_data. The entry at offset 0 is really | |
1448 | * the header, so start at 1 and go up to and including num_luns. | |
1449 | */ | |
1450 | for (lunp = &lun_data[1]; lunp <= &lun_data[num_luns]; lunp++) { | |
1451 | lun = scsilun_to_int(lunp); | |
1452 | ||
1453 | /* | |
1454 | * Check if the unused part of lunp is non-zero, and so | |
1455 | * does not fit in lun. | |
1456 | */ | |
1457 | if (memcmp(&lunp->scsi_lun[sizeof(lun)], "\0\0\0\0", 4)) { | |
1458 | int i; | |
1459 | ||
1460 | /* | |
1461 | * Output an error displaying the LUN in byte order, | |
1462 | * this differs from what linux would print for the | |
1463 | * integer LUN value. | |
1464 | */ | |
1465 | printk(KERN_WARNING "scsi: %s lun 0x", devname); | |
1466 | data = (char *)lunp->scsi_lun; | |
1467 | for (i = 0; i < sizeof(struct scsi_lun); i++) | |
1468 | printk("%02x", data[i]); | |
1469 | printk(" has a LUN larger than currently supported.\n"); | |
1da177e4 LT |
1470 | } else if (lun > sdev->host->max_lun) { |
1471 | printk(KERN_WARNING "scsi: %s lun%d has a LUN larger" | |
1472 | " than allowed by the host adapter\n", | |
1473 | devname, lun); | |
1474 | } else { | |
1475 | int res; | |
1476 | ||
1477 | res = scsi_probe_and_add_lun(starget, | |
1478 | lun, NULL, NULL, rescan, NULL); | |
1479 | if (res == SCSI_SCAN_NO_RESPONSE) { | |
1480 | /* | |
1481 | * Got some results, but now none, abort. | |
1482 | */ | |
3bf743e7 JG |
1483 | sdev_printk(KERN_ERR, sdev, |
1484 | "Unexpected response" | |
1485 | " from lun %d while scanning, scan" | |
1486 | " aborted\n", lun); | |
1da177e4 LT |
1487 | break; |
1488 | } | |
1489 | } | |
1490 | } | |
1491 | ||
2ef89198 | 1492 | out_err: |
1da177e4 | 1493 | kfree(lun_data); |
1da177e4 | 1494 | out: |
6f3a2024 | 1495 | scsi_device_put(sdev); |
0f1d87a2 | 1496 | if (scsi_device_created(sdev)) |
6f3a2024 JB |
1497 | /* |
1498 | * the sdev we used didn't appear in the report luns scan | |
1499 | */ | |
1500 | scsi_destroy_sdev(sdev); | |
2ef89198 | 1501 | return ret; |
1da177e4 LT |
1502 | } |
1503 | ||
1504 | struct scsi_device *__scsi_add_device(struct Scsi_Host *shost, uint channel, | |
1505 | uint id, uint lun, void *hostdata) | |
1506 | { | |
a97a83a0 | 1507 | struct scsi_device *sdev = ERR_PTR(-ENODEV); |
1da177e4 | 1508 | struct device *parent = &shost->shost_gendev; |
e02f3f59 | 1509 | struct scsi_target *starget; |
1da177e4 | 1510 | |
938e2ac0 MW |
1511 | if (strncmp(scsi_scan_type, "none", 4) == 0) |
1512 | return ERR_PTR(-ENODEV); | |
1513 | ||
e02f3f59 | 1514 | starget = scsi_alloc_target(parent, channel, id); |
1da177e4 LT |
1515 | if (!starget) |
1516 | return ERR_PTR(-ENOMEM); | |
1517 | ||
0b950672 | 1518 | mutex_lock(&shost->scan_mutex); |
6b7f123f MW |
1519 | if (!shost->async_scan) |
1520 | scsi_complete_async_scans(); | |
1521 | ||
a97a83a0 MW |
1522 | if (scsi_host_scan_allowed(shost)) |
1523 | scsi_probe_and_add_lun(starget, lun, NULL, &sdev, 1, hostdata); | |
0b950672 | 1524 | mutex_unlock(&shost->scan_mutex); |
1da177e4 LT |
1525 | scsi_target_reap(starget); |
1526 | put_device(&starget->dev); | |
1527 | ||
1528 | return sdev; | |
1529 | } | |
1530 | EXPORT_SYMBOL(__scsi_add_device); | |
1531 | ||
146f7262 JB |
1532 | int scsi_add_device(struct Scsi_Host *host, uint channel, |
1533 | uint target, uint lun) | |
1534 | { | |
1535 | struct scsi_device *sdev = | |
1536 | __scsi_add_device(host, channel, target, lun, NULL); | |
1537 | if (IS_ERR(sdev)) | |
1538 | return PTR_ERR(sdev); | |
1539 | ||
1540 | scsi_device_put(sdev); | |
1541 | return 0; | |
1542 | } | |
1543 | EXPORT_SYMBOL(scsi_add_device); | |
1544 | ||
1da177e4 LT |
1545 | void scsi_rescan_device(struct device *dev) |
1546 | { | |
1547 | struct scsi_driver *drv; | |
1548 | ||
1549 | if (!dev->driver) | |
1550 | return; | |
1551 | ||
1552 | drv = to_scsi_driver(dev->driver); | |
1553 | if (try_module_get(drv->owner)) { | |
1554 | if (drv->rescan) | |
1555 | drv->rescan(dev); | |
1556 | module_put(drv->owner); | |
1557 | } | |
1558 | } | |
1559 | EXPORT_SYMBOL(scsi_rescan_device); | |
1560 | ||
e517d313 AS |
1561 | static void __scsi_scan_target(struct device *parent, unsigned int channel, |
1562 | unsigned int id, unsigned int lun, int rescan) | |
1da177e4 LT |
1563 | { |
1564 | struct Scsi_Host *shost = dev_to_shost(parent); | |
1565 | int bflags = 0; | |
1566 | int res; | |
1da177e4 LT |
1567 | struct scsi_target *starget; |
1568 | ||
1569 | if (shost->this_id == id) | |
1570 | /* | |
1571 | * Don't scan the host adapter | |
1572 | */ | |
1573 | return; | |
1574 | ||
1da177e4 | 1575 | starget = scsi_alloc_target(parent, channel, id); |
1da177e4 LT |
1576 | if (!starget) |
1577 | return; | |
1578 | ||
1da177e4 LT |
1579 | if (lun != SCAN_WILD_CARD) { |
1580 | /* | |
1581 | * Scan for a specific host/chan/id/lun. | |
1582 | */ | |
1583 | scsi_probe_and_add_lun(starget, lun, NULL, NULL, rescan, NULL); | |
1584 | goto out_reap; | |
1585 | } | |
1586 | ||
1587 | /* | |
1588 | * Scan LUN 0, if there is some response, scan further. Ideally, we | |
1589 | * would not configure LUN 0 until all LUNs are scanned. | |
1590 | */ | |
6f3a2024 JB |
1591 | res = scsi_probe_and_add_lun(starget, 0, &bflags, NULL, rescan, NULL); |
1592 | if (res == SCSI_SCAN_LUN_PRESENT || res == SCSI_SCAN_TARGET_PRESENT) { | |
1593 | if (scsi_report_lun_scan(starget, bflags, rescan) != 0) | |
1da177e4 LT |
1594 | /* |
1595 | * The REPORT LUN did not scan the target, | |
1596 | * do a sequential scan. | |
1597 | */ | |
1598 | scsi_sequential_lun_scan(starget, bflags, | |
4186ab19 | 1599 | starget->scsi_level, rescan); |
1da177e4 | 1600 | } |
1da177e4 LT |
1601 | |
1602 | out_reap: | |
1603 | /* now determine if the target has any children at all | |
1604 | * and if not, nuke it */ | |
1605 | scsi_target_reap(starget); | |
1606 | ||
1607 | put_device(&starget->dev); | |
1608 | } | |
e517d313 AS |
1609 | |
1610 | /** | |
e59e4a09 | 1611 | * scsi_scan_target - scan a target id, possibly including all LUNs on the target. |
e517d313 AS |
1612 | * @parent: host to scan |
1613 | * @channel: channel to scan | |
1614 | * @id: target id to scan | |
1615 | * @lun: Specific LUN to scan or SCAN_WILD_CARD | |
1616 | * @rescan: passed to LUN scanning routines | |
1617 | * | |
1618 | * Description: | |
1619 | * Scan the target id on @parent, @channel, and @id. Scan at least LUN 0, | |
1620 | * and possibly all LUNs on the target id. | |
1621 | * | |
1622 | * First try a REPORT LUN scan, if that does not scan the target, do a | |
1623 | * sequential scan of LUNs on the target id. | |
1624 | **/ | |
1625 | void scsi_scan_target(struct device *parent, unsigned int channel, | |
1626 | unsigned int id, unsigned int lun, int rescan) | |
1627 | { | |
1628 | struct Scsi_Host *shost = dev_to_shost(parent); | |
1629 | ||
93b45af5 MW |
1630 | if (strncmp(scsi_scan_type, "none", 4) == 0) |
1631 | return; | |
1632 | ||
6b7f123f | 1633 | mutex_lock(&shost->scan_mutex); |
3e082a91 MW |
1634 | if (!shost->async_scan) |
1635 | scsi_complete_async_scans(); | |
1636 | ||
e517d313 AS |
1637 | if (scsi_host_scan_allowed(shost)) |
1638 | __scsi_scan_target(parent, channel, id, lun, rescan); | |
0b950672 | 1639 | mutex_unlock(&shost->scan_mutex); |
e517d313 | 1640 | } |
1da177e4 LT |
1641 | EXPORT_SYMBOL(scsi_scan_target); |
1642 | ||
1643 | static void scsi_scan_channel(struct Scsi_Host *shost, unsigned int channel, | |
1644 | unsigned int id, unsigned int lun, int rescan) | |
1645 | { | |
1646 | uint order_id; | |
1647 | ||
1648 | if (id == SCAN_WILD_CARD) | |
1649 | for (id = 0; id < shost->max_id; ++id) { | |
1650 | /* | |
1651 | * XXX adapter drivers when possible (FCP, iSCSI) | |
1652 | * could modify max_id to match the current max, | |
1653 | * not the absolute max. | |
1654 | * | |
1655 | * XXX add a shost id iterator, so for example, | |
1656 | * the FC ID can be the same as a target id | |
1657 | * without a huge overhead of sparse id's. | |
1658 | */ | |
1659 | if (shost->reverse_ordering) | |
1660 | /* | |
1661 | * Scan from high to low id. | |
1662 | */ | |
1663 | order_id = shost->max_id - id - 1; | |
1664 | else | |
1665 | order_id = id; | |
e517d313 AS |
1666 | __scsi_scan_target(&shost->shost_gendev, channel, |
1667 | order_id, lun, rescan); | |
1da177e4 LT |
1668 | } |
1669 | else | |
e517d313 AS |
1670 | __scsi_scan_target(&shost->shost_gendev, channel, |
1671 | id, lun, rescan); | |
1da177e4 LT |
1672 | } |
1673 | ||
1674 | int scsi_scan_host_selected(struct Scsi_Host *shost, unsigned int channel, | |
1675 | unsigned int id, unsigned int lun, int rescan) | |
1676 | { | |
3bf743e7 JG |
1677 | SCSI_LOG_SCAN_BUS(3, shost_printk (KERN_INFO, shost, |
1678 | "%s: <%u:%u:%u>\n", | |
cadbd4a5 | 1679 | __func__, channel, id, lun)); |
1da177e4 LT |
1680 | |
1681 | if (((channel != SCAN_WILD_CARD) && (channel > shost->max_channel)) || | |
091686d3 | 1682 | ((id != SCAN_WILD_CARD) && (id >= shost->max_id)) || |
1da177e4 LT |
1683 | ((lun != SCAN_WILD_CARD) && (lun > shost->max_lun))) |
1684 | return -EINVAL; | |
1685 | ||
0b950672 | 1686 | mutex_lock(&shost->scan_mutex); |
6b7f123f MW |
1687 | if (!shost->async_scan) |
1688 | scsi_complete_async_scans(); | |
1689 | ||
82f29467 MA |
1690 | if (scsi_host_scan_allowed(shost)) { |
1691 | if (channel == SCAN_WILD_CARD) | |
1692 | for (channel = 0; channel <= shost->max_channel; | |
1693 | channel++) | |
1694 | scsi_scan_channel(shost, channel, id, lun, | |
1695 | rescan); | |
1696 | else | |
1da177e4 | 1697 | scsi_scan_channel(shost, channel, id, lun, rescan); |
82f29467 | 1698 | } |
0b950672 | 1699 | mutex_unlock(&shost->scan_mutex); |
1da177e4 LT |
1700 | |
1701 | return 0; | |
1702 | } | |
1703 | ||
3e082a91 MW |
1704 | static void scsi_sysfs_add_devices(struct Scsi_Host *shost) |
1705 | { | |
1706 | struct scsi_device *sdev; | |
1707 | shost_for_each_device(sdev, shost) { | |
6b7f123f MW |
1708 | if (!scsi_host_scan_allowed(shost) || |
1709 | scsi_sysfs_add_sdev(sdev) != 0) | |
3e082a91 MW |
1710 | scsi_destroy_sdev(sdev); |
1711 | } | |
1712 | } | |
1713 | ||
1714 | /** | |
1715 | * scsi_prep_async_scan - prepare for an async scan | |
1716 | * @shost: the host which will be scanned | |
1717 | * Returns: a cookie to be passed to scsi_finish_async_scan() | |
1718 | * | |
1719 | * Tells the midlayer this host is going to do an asynchronous scan. | |
1720 | * It reserves the host's position in the scanning list and ensures | |
1721 | * that other asynchronous scans started after this one won't affect the | |
1722 | * ordering of the discovered devices. | |
1723 | */ | |
1aa8fab2 | 1724 | static struct async_scan_data *scsi_prep_async_scan(struct Scsi_Host *shost) |
3e082a91 MW |
1725 | { |
1726 | struct async_scan_data *data; | |
6b7f123f | 1727 | unsigned long flags; |
3e082a91 MW |
1728 | |
1729 | if (strncmp(scsi_scan_type, "sync", 4) == 0) | |
1730 | return NULL; | |
1731 | ||
1732 | if (shost->async_scan) { | |
cadbd4a5 | 1733 | printk("%s called twice for host %d", __func__, |
3e082a91 MW |
1734 | shost->host_no); |
1735 | dump_stack(); | |
1736 | return NULL; | |
1737 | } | |
1738 | ||
1739 | data = kmalloc(sizeof(*data), GFP_KERNEL); | |
1740 | if (!data) | |
1741 | goto err; | |
1742 | data->shost = scsi_host_get(shost); | |
1743 | if (!data->shost) | |
1744 | goto err; | |
1745 | init_completion(&data->prev_finished); | |
1746 | ||
6b7f123f MW |
1747 | mutex_lock(&shost->scan_mutex); |
1748 | spin_lock_irqsave(shost->host_lock, flags); | |
3e082a91 | 1749 | shost->async_scan = 1; |
6b7f123f MW |
1750 | spin_unlock_irqrestore(shost->host_lock, flags); |
1751 | mutex_unlock(&shost->scan_mutex); | |
1752 | ||
1753 | spin_lock(&async_scan_lock); | |
3e082a91 MW |
1754 | if (list_empty(&scanning_hosts)) |
1755 | complete(&data->prev_finished); | |
1756 | list_add_tail(&data->list, &scanning_hosts); | |
1757 | spin_unlock(&async_scan_lock); | |
1758 | ||
1759 | return data; | |
1760 | ||
1761 | err: | |
1762 | kfree(data); | |
1763 | return NULL; | |
1764 | } | |
1765 | ||
1766 | /** | |
1767 | * scsi_finish_async_scan - asynchronous scan has finished | |
1768 | * @data: cookie returned from earlier call to scsi_prep_async_scan() | |
1769 | * | |
1770 | * All the devices currently attached to this host have been found. | |
1771 | * This function announces all the devices it has found to the rest | |
1772 | * of the system. | |
1773 | */ | |
1aa8fab2 | 1774 | static void scsi_finish_async_scan(struct async_scan_data *data) |
3e082a91 MW |
1775 | { |
1776 | struct Scsi_Host *shost; | |
6b7f123f | 1777 | unsigned long flags; |
3e082a91 MW |
1778 | |
1779 | if (!data) | |
1780 | return; | |
1781 | ||
1782 | shost = data->shost; | |
6b7f123f MW |
1783 | |
1784 | mutex_lock(&shost->scan_mutex); | |
1785 | ||
3e082a91 | 1786 | if (!shost->async_scan) { |
cadbd4a5 | 1787 | printk("%s called twice for host %d", __func__, |
3e082a91 MW |
1788 | shost->host_no); |
1789 | dump_stack(); | |
773e82f6 | 1790 | mutex_unlock(&shost->scan_mutex); |
3e082a91 MW |
1791 | return; |
1792 | } | |
1793 | ||
1794 | wait_for_completion(&data->prev_finished); | |
1795 | ||
1796 | scsi_sysfs_add_devices(shost); | |
1797 | ||
6b7f123f | 1798 | spin_lock_irqsave(shost->host_lock, flags); |
3e082a91 | 1799 | shost->async_scan = 0; |
6b7f123f MW |
1800 | spin_unlock_irqrestore(shost->host_lock, flags); |
1801 | ||
1802 | mutex_unlock(&shost->scan_mutex); | |
1803 | ||
1804 | spin_lock(&async_scan_lock); | |
3e082a91 MW |
1805 | list_del(&data->list); |
1806 | if (!list_empty(&scanning_hosts)) { | |
1807 | struct async_scan_data *next = list_entry(scanning_hosts.next, | |
1808 | struct async_scan_data, list); | |
1809 | complete(&next->prev_finished); | |
1810 | } | |
1811 | spin_unlock(&async_scan_lock); | |
1812 | ||
1813 | scsi_host_put(shost); | |
1814 | kfree(data); | |
1815 | } | |
1816 | ||
1aa8fab2 | 1817 | static void do_scsi_scan_host(struct Scsi_Host *shost) |
3e082a91 | 1818 | { |
1aa8fab2 MW |
1819 | if (shost->hostt->scan_finished) { |
1820 | unsigned long start = jiffies; | |
1821 | if (shost->hostt->scan_start) | |
1822 | shost->hostt->scan_start(shost); | |
1823 | ||
1824 | while (!shost->hostt->scan_finished(shost, jiffies - start)) | |
1825 | msleep(10); | |
1826 | } else { | |
1827 | scsi_scan_host_selected(shost, SCAN_WILD_CARD, SCAN_WILD_CARD, | |
3e082a91 | 1828 | SCAN_WILD_CARD, 0); |
1aa8fab2 MW |
1829 | } |
1830 | } | |
3e082a91 | 1831 | |
1aa8fab2 MW |
1832 | static int do_scan_async(void *_data) |
1833 | { | |
1834 | struct async_scan_data *data = _data; | |
1835 | do_scsi_scan_host(data->shost); | |
3e082a91 MW |
1836 | scsi_finish_async_scan(data); |
1837 | return 0; | |
1838 | } | |
1839 | ||
1da177e4 LT |
1840 | /** |
1841 | * scsi_scan_host - scan the given adapter | |
1842 | * @shost: adapter to scan | |
1843 | **/ | |
1844 | void scsi_scan_host(struct Scsi_Host *shost) | |
1845 | { | |
a57b1fcc | 1846 | struct task_struct *p; |
3e082a91 MW |
1847 | struct async_scan_data *data; |
1848 | ||
1849 | if (strncmp(scsi_scan_type, "none", 4) == 0) | |
1850 | return; | |
1851 | ||
1852 | data = scsi_prep_async_scan(shost); | |
1853 | if (!data) { | |
1aa8fab2 | 1854 | do_scsi_scan_host(shost); |
3e082a91 MW |
1855 | return; |
1856 | } | |
1aa8fab2 | 1857 | |
a57b1fcc | 1858 | p = kthread_run(do_scan_async, data, "scsi_scan_%d", shost->host_no); |
801678c5 | 1859 | if (IS_ERR(p)) |
a57b1fcc | 1860 | do_scan_async(data); |
1da177e4 LT |
1861 | } |
1862 | EXPORT_SYMBOL(scsi_scan_host); | |
1863 | ||
1da177e4 LT |
1864 | void scsi_forget_host(struct Scsi_Host *shost) |
1865 | { | |
a64358db | 1866 | struct scsi_device *sdev; |
1da177e4 LT |
1867 | unsigned long flags; |
1868 | ||
a64358db | 1869 | restart: |
1da177e4 | 1870 | spin_lock_irqsave(shost->host_lock, flags); |
a64358db AS |
1871 | list_for_each_entry(sdev, &shost->__devices, siblings) { |
1872 | if (sdev->sdev_state == SDEV_DEL) | |
1873 | continue; | |
1da177e4 | 1874 | spin_unlock_irqrestore(shost->host_lock, flags); |
a64358db AS |
1875 | __scsi_remove_device(sdev); |
1876 | goto restart; | |
1da177e4 LT |
1877 | } |
1878 | spin_unlock_irqrestore(shost->host_lock, flags); | |
1879 | } | |
1880 | ||
1881 | /* | |
1882 | * Function: scsi_get_host_dev() | |
1883 | * | |
f64a181d | 1884 | * Purpose: Create a scsi_device that points to the host adapter itself. |
1da177e4 | 1885 | * |
f64a181d | 1886 | * Arguments: SHpnt - Host that needs a scsi_device |
1da177e4 LT |
1887 | * |
1888 | * Lock status: None assumed. | |
1889 | * | |
f64a181d | 1890 | * Returns: The scsi_device or NULL |
1da177e4 LT |
1891 | * |
1892 | * Notes: | |
f64a181d | 1893 | * Attach a single scsi_device to the Scsi_Host - this should |
1da177e4 LT |
1894 | * be made to look like a "pseudo-device" that points to the |
1895 | * HA itself. | |
1896 | * | |
1897 | * Note - this device is not accessible from any high-level | |
1898 | * drivers (including generics), which is probably not | |
1899 | * optimal. We can add hooks later to attach | |
1900 | */ | |
1901 | struct scsi_device *scsi_get_host_dev(struct Scsi_Host *shost) | |
1902 | { | |
e517d313 | 1903 | struct scsi_device *sdev = NULL; |
1da177e4 LT |
1904 | struct scsi_target *starget; |
1905 | ||
0b950672 | 1906 | mutex_lock(&shost->scan_mutex); |
e517d313 AS |
1907 | if (!scsi_host_scan_allowed(shost)) |
1908 | goto out; | |
1da177e4 LT |
1909 | starget = scsi_alloc_target(&shost->shost_gendev, 0, shost->this_id); |
1910 | if (!starget) | |
e517d313 | 1911 | goto out; |
1da177e4 LT |
1912 | |
1913 | sdev = scsi_alloc_sdev(starget, 0, NULL); | |
1914 | if (sdev) { | |
1915 | sdev->sdev_gendev.parent = get_device(&starget->dev); | |
1916 | sdev->borken = 0; | |
884d25cc JB |
1917 | } else |
1918 | scsi_target_reap(starget); | |
1da177e4 | 1919 | put_device(&starget->dev); |
e517d313 | 1920 | out: |
0b950672 | 1921 | mutex_unlock(&shost->scan_mutex); |
1da177e4 LT |
1922 | return sdev; |
1923 | } | |
1924 | EXPORT_SYMBOL(scsi_get_host_dev); | |
1925 | ||
1926 | /* | |
1927 | * Function: scsi_free_host_dev() | |
1928 | * | |
1929 | * Purpose: Free a scsi_device that points to the host adapter itself. | |
1930 | * | |
f64a181d | 1931 | * Arguments: SHpnt - Host that needs a scsi_device |
1da177e4 LT |
1932 | * |
1933 | * Lock status: None assumed. | |
1934 | * | |
1935 | * Returns: Nothing | |
1936 | * | |
1937 | * Notes: | |
1938 | */ | |
1939 | void scsi_free_host_dev(struct scsi_device *sdev) | |
1940 | { | |
1941 | BUG_ON(sdev->id != sdev->host->this_id); | |
1942 | ||
6f3a2024 | 1943 | scsi_destroy_sdev(sdev); |
1da177e4 LT |
1944 | } |
1945 | EXPORT_SYMBOL(scsi_free_host_dev); | |
1946 |