]>
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> | |
32 | #include <asm/semaphore.h> | |
33 | ||
34 | #include <scsi/scsi.h> | |
beb40487 | 35 | #include <scsi/scsi_cmnd.h> |
1da177e4 LT |
36 | #include <scsi/scsi_device.h> |
37 | #include <scsi/scsi_driver.h> | |
38 | #include <scsi/scsi_devinfo.h> | |
39 | #include <scsi/scsi_host.h> | |
1da177e4 LT |
40 | #include <scsi/scsi_transport.h> |
41 | #include <scsi/scsi_eh.h> | |
42 | ||
43 | #include "scsi_priv.h" | |
44 | #include "scsi_logging.h" | |
45 | ||
46 | #define ALLOC_FAILURE_MSG KERN_ERR "%s: Allocation failure during" \ | |
47 | " SCSI scanning, some SCSI devices might not be configured\n" | |
48 | ||
49 | /* | |
50 | * Default timeout | |
51 | */ | |
52 | #define SCSI_TIMEOUT (2*HZ) | |
53 | ||
54 | /* | |
55 | * Prefix values for the SCSI id's (stored in driverfs name field) | |
56 | */ | |
57 | #define SCSI_UID_SER_NUM 'S' | |
58 | #define SCSI_UID_UNKNOWN 'Z' | |
59 | ||
60 | /* | |
61 | * Return values of some of the scanning functions. | |
62 | * | |
63 | * SCSI_SCAN_NO_RESPONSE: no valid response received from the target, this | |
64 | * includes allocation or general failures preventing IO from being sent. | |
65 | * | |
66 | * SCSI_SCAN_TARGET_PRESENT: target responded, but no device is available | |
67 | * on the given LUN. | |
68 | * | |
69 | * SCSI_SCAN_LUN_PRESENT: target responded, and a device is available on a | |
70 | * given LUN. | |
71 | */ | |
72 | #define SCSI_SCAN_NO_RESPONSE 0 | |
73 | #define SCSI_SCAN_TARGET_PRESENT 1 | |
74 | #define SCSI_SCAN_LUN_PRESENT 2 | |
75 | ||
0ad78200 | 76 | static const char *scsi_null_device_strs = "nullnullnullnull"; |
1da177e4 LT |
77 | |
78 | #define MAX_SCSI_LUNS 512 | |
79 | ||
80 | #ifdef CONFIG_SCSI_MULTI_LUN | |
81 | static unsigned int max_scsi_luns = MAX_SCSI_LUNS; | |
82 | #else | |
83 | static unsigned int max_scsi_luns = 1; | |
84 | #endif | |
85 | ||
86 | module_param_named(max_luns, max_scsi_luns, int, S_IRUGO|S_IWUSR); | |
87 | MODULE_PARM_DESC(max_luns, | |
88 | "last scsi LUN (should be between 1 and 2^32-1)"); | |
89 | ||
90 | /* | |
91 | * max_scsi_report_luns: the maximum number of LUNS that will be | |
92 | * returned from the REPORT LUNS command. 8 times this value must | |
93 | * be allocated. In theory this could be up to an 8 byte value, but | |
94 | * in practice, the maximum number of LUNs suppored by any device | |
95 | * is about 16k. | |
96 | */ | |
97 | static unsigned int max_scsi_report_luns = 511; | |
98 | ||
99 | module_param_named(max_report_luns, max_scsi_report_luns, int, S_IRUGO|S_IWUSR); | |
100 | MODULE_PARM_DESC(max_report_luns, | |
101 | "REPORT LUNS maximum number of LUNS received (should be" | |
102 | " between 1 and 16384)"); | |
103 | ||
104 | static unsigned int scsi_inq_timeout = SCSI_TIMEOUT/HZ+3; | |
105 | ||
106 | module_param_named(inq_timeout, scsi_inq_timeout, int, S_IRUGO|S_IWUSR); | |
107 | MODULE_PARM_DESC(inq_timeout, | |
108 | "Timeout (in seconds) waiting for devices to answer INQUIRY." | |
109 | " Default is 5. Some non-compliant devices need more."); | |
110 | ||
111 | /** | |
112 | * scsi_unlock_floptical - unlock device via a special MODE SENSE command | |
39216033 | 113 | * @sdev: scsi device to send command to |
1da177e4 LT |
114 | * @result: area to store the result of the MODE SENSE |
115 | * | |
116 | * Description: | |
39216033 | 117 | * Send a vendor specific MODE SENSE (not a MODE SELECT) command. |
1da177e4 LT |
118 | * Called for BLIST_KEY devices. |
119 | **/ | |
39216033 | 120 | static void scsi_unlock_floptical(struct scsi_device *sdev, |
1da177e4 LT |
121 | unsigned char *result) |
122 | { | |
123 | unsigned char scsi_cmd[MAX_COMMAND_SIZE]; | |
124 | ||
125 | printk(KERN_NOTICE "scsi: unlocking floptical drive\n"); | |
126 | scsi_cmd[0] = MODE_SENSE; | |
127 | scsi_cmd[1] = 0; | |
128 | scsi_cmd[2] = 0x2e; | |
129 | scsi_cmd[3] = 0; | |
39216033 | 130 | scsi_cmd[4] = 0x2a; /* size */ |
1da177e4 | 131 | scsi_cmd[5] = 0; |
39216033 JB |
132 | scsi_execute_req(sdev, scsi_cmd, DMA_FROM_DEVICE, result, 0x2a, NULL, |
133 | SCSI_TIMEOUT, 3); | |
1da177e4 LT |
134 | } |
135 | ||
1da177e4 LT |
136 | /** |
137 | * scsi_alloc_sdev - allocate and setup a scsi_Device | |
138 | * | |
139 | * Description: | |
140 | * Allocate, initialize for io, and return a pointer to a scsi_Device. | |
141 | * Stores the @shost, @channel, @id, and @lun in the scsi_Device, and | |
142 | * adds scsi_Device to the appropriate list. | |
143 | * | |
144 | * Return value: | |
145 | * scsi_Device pointer, or NULL on failure. | |
146 | **/ | |
147 | static struct scsi_device *scsi_alloc_sdev(struct scsi_target *starget, | |
148 | unsigned int lun, void *hostdata) | |
149 | { | |
150 | struct scsi_device *sdev; | |
151 | int display_failure_msg = 1, ret; | |
152 | struct Scsi_Host *shost = dev_to_shost(starget->dev.parent); | |
153 | ||
24669f75 | 154 | sdev = kzalloc(sizeof(*sdev) + shost->transportt->device_size, |
1da177e4 LT |
155 | GFP_ATOMIC); |
156 | if (!sdev) | |
157 | goto out; | |
158 | ||
1da177e4 LT |
159 | sdev->vendor = scsi_null_device_strs; |
160 | sdev->model = scsi_null_device_strs; | |
161 | sdev->rev = scsi_null_device_strs; | |
162 | sdev->host = shost; | |
163 | sdev->id = starget->id; | |
164 | sdev->lun = lun; | |
165 | sdev->channel = starget->channel; | |
166 | sdev->sdev_state = SDEV_CREATED; | |
167 | INIT_LIST_HEAD(&sdev->siblings); | |
168 | INIT_LIST_HEAD(&sdev->same_target_siblings); | |
169 | INIT_LIST_HEAD(&sdev->cmd_list); | |
170 | INIT_LIST_HEAD(&sdev->starved_entry); | |
171 | spin_lock_init(&sdev->list_lock); | |
172 | ||
173 | sdev->sdev_gendev.parent = get_device(&starget->dev); | |
174 | sdev->sdev_target = starget; | |
175 | ||
176 | /* usually NULL and set by ->slave_alloc instead */ | |
177 | sdev->hostdata = hostdata; | |
178 | ||
179 | /* if the device needs this changing, it may do so in the | |
180 | * slave_configure function */ | |
181 | sdev->max_device_blocked = SCSI_DEFAULT_DEVICE_BLOCKED; | |
182 | ||
183 | /* | |
184 | * Some low level driver could use device->type | |
185 | */ | |
186 | sdev->type = -1; | |
187 | ||
188 | /* | |
189 | * Assume that the device will have handshaking problems, | |
190 | * and then fix this field later if it turns out it | |
191 | * doesn't | |
192 | */ | |
193 | sdev->borken = 1; | |
194 | ||
1da177e4 LT |
195 | sdev->request_queue = scsi_alloc_queue(sdev); |
196 | if (!sdev->request_queue) { | |
197 | /* release fn is set up in scsi_sysfs_device_initialise, so | |
198 | * have to free and put manually here */ | |
199 | put_device(&starget->dev); | |
93f56089 | 200 | kfree(sdev); |
1da177e4 LT |
201 | goto out; |
202 | } | |
203 | ||
204 | sdev->request_queue->queuedata = sdev; | |
205 | scsi_adjust_queue_depth(sdev, 0, sdev->host->cmd_per_lun); | |
206 | ||
207 | scsi_sysfs_device_initialize(sdev); | |
208 | ||
209 | if (shost->hostt->slave_alloc) { | |
210 | ret = shost->hostt->slave_alloc(sdev); | |
211 | if (ret) { | |
212 | /* | |
213 | * if LLDD reports slave not present, don't clutter | |
214 | * console with alloc failure messages | |
1da177e4 LT |
215 | */ |
216 | if (ret == -ENXIO) | |
217 | display_failure_msg = 0; | |
218 | goto out_device_destroy; | |
219 | } | |
220 | } | |
221 | ||
222 | return sdev; | |
223 | ||
224 | out_device_destroy: | |
225 | transport_destroy_device(&sdev->sdev_gendev); | |
1da177e4 LT |
226 | put_device(&sdev->sdev_gendev); |
227 | out: | |
228 | if (display_failure_msg) | |
229 | printk(ALLOC_FAILURE_MSG, __FUNCTION__); | |
230 | return NULL; | |
231 | } | |
232 | ||
233 | static void scsi_target_dev_release(struct device *dev) | |
234 | { | |
235 | struct device *parent = dev->parent; | |
236 | struct scsi_target *starget = to_scsi_target(dev); | |
a283bd37 | 237 | |
1da177e4 LT |
238 | kfree(starget); |
239 | put_device(parent); | |
240 | } | |
241 | ||
242 | int scsi_is_target_device(const struct device *dev) | |
243 | { | |
244 | return dev->release == scsi_target_dev_release; | |
245 | } | |
246 | EXPORT_SYMBOL(scsi_is_target_device); | |
247 | ||
248 | static struct scsi_target *__scsi_find_target(struct device *parent, | |
249 | int channel, uint id) | |
250 | { | |
251 | struct scsi_target *starget, *found_starget = NULL; | |
252 | struct Scsi_Host *shost = dev_to_shost(parent); | |
253 | /* | |
254 | * Search for an existing target for this sdev. | |
255 | */ | |
256 | list_for_each_entry(starget, &shost->__targets, siblings) { | |
257 | if (starget->id == id && | |
258 | starget->channel == channel) { | |
259 | found_starget = starget; | |
260 | break; | |
261 | } | |
262 | } | |
263 | if (found_starget) | |
264 | get_device(&found_starget->dev); | |
265 | ||
266 | return found_starget; | |
267 | } | |
268 | ||
269 | static struct scsi_target *scsi_alloc_target(struct device *parent, | |
270 | int channel, uint id) | |
271 | { | |
272 | struct Scsi_Host *shost = dev_to_shost(parent); | |
273 | struct device *dev = NULL; | |
274 | unsigned long flags; | |
275 | const int size = sizeof(struct scsi_target) | |
276 | + shost->transportt->target_size; | |
5c44cd2a | 277 | struct scsi_target *starget; |
1da177e4 | 278 | struct scsi_target *found_target; |
32f95792 | 279 | int error; |
1da177e4 | 280 | |
24669f75 | 281 | starget = kzalloc(size, GFP_KERNEL); |
1da177e4 LT |
282 | if (!starget) { |
283 | printk(KERN_ERR "%s: allocation failure\n", __FUNCTION__); | |
284 | return NULL; | |
285 | } | |
1da177e4 LT |
286 | dev = &starget->dev; |
287 | device_initialize(dev); | |
288 | starget->reap_ref = 1; | |
289 | dev->parent = get_device(parent); | |
290 | dev->release = scsi_target_dev_release; | |
291 | sprintf(dev->bus_id, "target%d:%d:%d", | |
292 | shost->host_no, channel, id); | |
293 | starget->id = id; | |
294 | starget->channel = channel; | |
295 | INIT_LIST_HEAD(&starget->siblings); | |
296 | INIT_LIST_HEAD(&starget->devices); | |
ffedb452 JB |
297 | starget->state = STARGET_RUNNING; |
298 | retry: | |
1da177e4 LT |
299 | spin_lock_irqsave(shost->host_lock, flags); |
300 | ||
301 | found_target = __scsi_find_target(parent, channel, id); | |
302 | if (found_target) | |
303 | goto found; | |
304 | ||
305 | list_add_tail(&starget->siblings, &shost->__targets); | |
306 | spin_unlock_irqrestore(shost->host_lock, flags); | |
307 | /* allocate and add */ | |
a283bd37 | 308 | transport_setup_device(dev); |
32f95792 BK |
309 | error = device_add(dev); |
310 | if (error) { | |
311 | dev_err(dev, "target device_add failed, error %d\n", error); | |
312 | spin_lock_irqsave(shost->host_lock, flags); | |
313 | list_del_init(&starget->siblings); | |
314 | spin_unlock_irqrestore(shost->host_lock, flags); | |
315 | transport_destroy_device(dev); | |
316 | put_device(parent); | |
317 | kfree(starget); | |
318 | return NULL; | |
319 | } | |
a283bd37 JB |
320 | transport_add_device(dev); |
321 | if (shost->hostt->target_alloc) { | |
32f95792 | 322 | error = shost->hostt->target_alloc(starget); |
a283bd37 JB |
323 | |
324 | if(error) { | |
325 | dev_printk(KERN_ERR, dev, "target allocation failed, error %d\n", error); | |
326 | /* don't want scsi_target_reap to do the final | |
327 | * put because it will be under the host lock */ | |
328 | get_device(dev); | |
329 | scsi_target_reap(starget); | |
330 | put_device(dev); | |
331 | return NULL; | |
332 | } | |
333 | } | |
334 | ||
1da177e4 LT |
335 | return starget; |
336 | ||
337 | found: | |
338 | found_target->reap_ref++; | |
339 | spin_unlock_irqrestore(shost->host_lock, flags); | |
340 | put_device(parent); | |
ffedb452 JB |
341 | if (found_target->state != STARGET_DEL) { |
342 | kfree(starget); | |
343 | return found_target; | |
344 | } | |
345 | /* Unfortunately, we found a dying target; need to | |
346 | * wait until it's dead before we can get a new one */ | |
347 | put_device(&found_target->dev); | |
348 | flush_scheduled_work(); | |
349 | goto retry; | |
1da177e4 LT |
350 | } |
351 | ||
65110b21 JB |
352 | static void scsi_target_reap_usercontext(void *data) |
353 | { | |
354 | struct scsi_target *starget = data; | |
863a930a JB |
355 | struct Scsi_Host *shost = dev_to_shost(starget->dev.parent); |
356 | unsigned long flags; | |
357 | ||
ffedb452 JB |
358 | transport_remove_device(&starget->dev); |
359 | device_del(&starget->dev); | |
360 | transport_destroy_device(&starget->dev); | |
863a930a | 361 | spin_lock_irqsave(shost->host_lock, flags); |
a50a5e37 MA |
362 | if (shost->hostt->target_destroy) |
363 | shost->hostt->target_destroy(starget); | |
ffedb452 | 364 | list_del_init(&starget->siblings); |
863a930a | 365 | spin_unlock_irqrestore(shost->host_lock, flags); |
ffedb452 | 366 | put_device(&starget->dev); |
863a930a JB |
367 | } |
368 | ||
1da177e4 LT |
369 | /** |
370 | * scsi_target_reap - check to see if target is in use and destroy if not | |
371 | * | |
372 | * @starget: target to be checked | |
373 | * | |
374 | * This is used after removing a LUN or doing a last put of the target | |
375 | * it checks atomically that nothing is using the target and removes | |
376 | * it if so. | |
377 | */ | |
378 | void scsi_target_reap(struct scsi_target *starget) | |
379 | { | |
ffedb452 JB |
380 | struct Scsi_Host *shost = dev_to_shost(starget->dev.parent); |
381 | unsigned long flags; | |
382 | ||
383 | spin_lock_irqsave(shost->host_lock, flags); | |
384 | ||
385 | if (--starget->reap_ref == 0 && list_empty(&starget->devices)) { | |
386 | BUG_ON(starget->state == STARGET_DEL); | |
387 | starget->state = STARGET_DEL; | |
388 | spin_unlock_irqrestore(shost->host_lock, flags); | |
389 | execute_in_process_context(scsi_target_reap_usercontext, | |
390 | starget, &starget->ew); | |
391 | return; | |
392 | ||
393 | } | |
394 | spin_unlock_irqrestore(shost->host_lock, flags); | |
395 | ||
396 | return; | |
1da177e4 LT |
397 | } |
398 | ||
399 | /** | |
400 | * scsi_probe_lun - probe a single LUN using a SCSI INQUIRY | |
39216033 | 401 | * @sdev: scsi_device to probe |
1da177e4 | 402 | * @inq_result: area to store the INQUIRY result |
39216033 | 403 | * @result_len: len of inq_result |
1da177e4 LT |
404 | * @bflags: store any bflags found here |
405 | * | |
406 | * Description: | |
39216033 | 407 | * Probe the lun associated with @req using a standard SCSI INQUIRY; |
1da177e4 | 408 | * |
39216033 | 409 | * If the INQUIRY is successful, zero is returned and the |
1da177e4 | 410 | * INQUIRY data is in @inq_result; the scsi_level and INQUIRY length |
f64a181d | 411 | * are copied to the scsi_device any flags value is stored in *@bflags. |
1da177e4 | 412 | **/ |
39216033 JB |
413 | static int scsi_probe_lun(struct scsi_device *sdev, char *inq_result, |
414 | int result_len, int *bflags) | |
1da177e4 | 415 | { |
1da177e4 LT |
416 | unsigned char scsi_cmd[MAX_COMMAND_SIZE]; |
417 | int first_inquiry_len, try_inquiry_len, next_inquiry_len; | |
418 | int response_len = 0; | |
39216033 | 419 | int pass, count, result; |
1da177e4 LT |
420 | struct scsi_sense_hdr sshdr; |
421 | ||
422 | *bflags = 0; | |
423 | ||
424 | /* Perform up to 3 passes. The first pass uses a conservative | |
425 | * transfer length of 36 unless sdev->inquiry_len specifies a | |
426 | * different value. */ | |
427 | first_inquiry_len = sdev->inquiry_len ? sdev->inquiry_len : 36; | |
428 | try_inquiry_len = first_inquiry_len; | |
429 | pass = 1; | |
430 | ||
431 | next_pass: | |
9ccfc756 JB |
432 | SCSI_LOG_SCAN_BUS(3, sdev_printk(KERN_INFO, sdev, |
433 | "scsi scan: INQUIRY pass %d length %d\n", | |
434 | pass, try_inquiry_len)); | |
1da177e4 LT |
435 | |
436 | /* Each pass gets up to three chances to ignore Unit Attention */ | |
437 | for (count = 0; count < 3; ++count) { | |
438 | memset(scsi_cmd, 0, 6); | |
439 | scsi_cmd[0] = INQUIRY; | |
440 | scsi_cmd[4] = (unsigned char) try_inquiry_len; | |
1da177e4 LT |
441 | |
442 | memset(inq_result, 0, try_inquiry_len); | |
39216033 JB |
443 | |
444 | result = scsi_execute_req(sdev, scsi_cmd, DMA_FROM_DEVICE, | |
ea73a9f2 | 445 | inq_result, try_inquiry_len, &sshdr, |
39216033 | 446 | HZ / 2 + HZ * scsi_inq_timeout, 3); |
1da177e4 LT |
447 | |
448 | SCSI_LOG_SCAN_BUS(3, printk(KERN_INFO "scsi scan: INQUIRY %s " | |
449 | "with code 0x%x\n", | |
39216033 | 450 | result ? "failed" : "successful", result)); |
1da177e4 | 451 | |
39216033 | 452 | if (result) { |
1da177e4 LT |
453 | /* |
454 | * not-ready to ready transition [asc/ascq=0x28/0x0] | |
455 | * or power-on, reset [asc/ascq=0x29/0x0], continue. | |
456 | * INQUIRY should not yield UNIT_ATTENTION | |
457 | * but many buggy devices do so anyway. | |
458 | */ | |
39216033 | 459 | if ((driver_byte(result) & DRIVER_SENSE) && |
ea73a9f2 | 460 | scsi_sense_valid(&sshdr)) { |
1da177e4 LT |
461 | if ((sshdr.sense_key == UNIT_ATTENTION) && |
462 | ((sshdr.asc == 0x28) || | |
463 | (sshdr.asc == 0x29)) && | |
464 | (sshdr.ascq == 0)) | |
465 | continue; | |
466 | } | |
467 | } | |
468 | break; | |
469 | } | |
470 | ||
39216033 | 471 | if (result == 0) { |
1da177e4 LT |
472 | response_len = (unsigned char) inq_result[4] + 5; |
473 | if (response_len > 255) | |
474 | response_len = first_inquiry_len; /* sanity */ | |
475 | ||
476 | /* | |
477 | * Get any flags for this device. | |
478 | * | |
f64a181d CH |
479 | * XXX add a bflags to scsi_device, and replace the |
480 | * corresponding bit fields in scsi_device, so bflags | |
1da177e4 LT |
481 | * need not be passed as an argument. |
482 | */ | |
483 | *bflags = scsi_get_device_flags(sdev, &inq_result[8], | |
484 | &inq_result[16]); | |
485 | ||
486 | /* When the first pass succeeds we gain information about | |
487 | * what larger transfer lengths might work. */ | |
488 | if (pass == 1) { | |
489 | if (BLIST_INQUIRY_36 & *bflags) | |
490 | next_inquiry_len = 36; | |
491 | else if (BLIST_INQUIRY_58 & *bflags) | |
492 | next_inquiry_len = 58; | |
493 | else if (sdev->inquiry_len) | |
494 | next_inquiry_len = sdev->inquiry_len; | |
495 | else | |
496 | next_inquiry_len = response_len; | |
497 | ||
498 | /* If more data is available perform the second pass */ | |
499 | if (next_inquiry_len > try_inquiry_len) { | |
500 | try_inquiry_len = next_inquiry_len; | |
501 | pass = 2; | |
502 | goto next_pass; | |
503 | } | |
504 | } | |
505 | ||
506 | } else if (pass == 2) { | |
507 | printk(KERN_INFO "scsi scan: %d byte inquiry failed. " | |
508 | "Consider BLIST_INQUIRY_36 for this device\n", | |
509 | try_inquiry_len); | |
510 | ||
511 | /* If this pass failed, the third pass goes back and transfers | |
512 | * the same amount as we successfully got in the first pass. */ | |
513 | try_inquiry_len = first_inquiry_len; | |
514 | pass = 3; | |
515 | goto next_pass; | |
516 | } | |
517 | ||
518 | /* If the last transfer attempt got an error, assume the | |
519 | * peripheral doesn't exist or is dead. */ | |
39216033 JB |
520 | if (result) |
521 | return -EIO; | |
1da177e4 LT |
522 | |
523 | /* Don't report any more data than the device says is valid */ | |
524 | sdev->inquiry_len = min(try_inquiry_len, response_len); | |
525 | ||
526 | /* | |
527 | * XXX Abort if the response length is less than 36? If less than | |
528 | * 32, the lookup of the device flags (above) could be invalid, | |
529 | * and it would be possible to take an incorrect action - we do | |
530 | * not want to hang because of a short INQUIRY. On the flip side, | |
531 | * if the device is spun down or becoming ready (and so it gives a | |
532 | * short INQUIRY), an abort here prevents any further use of the | |
533 | * device, including spin up. | |
534 | * | |
535 | * Related to the above issue: | |
536 | * | |
537 | * XXX Devices (disk or all?) should be sent a TEST UNIT READY, | |
538 | * and if not ready, sent a START_STOP to start (maybe spin up) and | |
539 | * then send the INQUIRY again, since the INQUIRY can change after | |
540 | * a device is initialized. | |
541 | * | |
542 | * Ideally, start a device if explicitly asked to do so. This | |
543 | * assumes that a device is spun up on power on, spun down on | |
544 | * request, and then spun up on request. | |
545 | */ | |
546 | ||
547 | /* | |
548 | * The scanning code needs to know the scsi_level, even if no | |
549 | * device is attached at LUN 0 (SCSI_SCAN_TARGET_PRESENT) so | |
550 | * non-zero LUNs can be scanned. | |
551 | */ | |
552 | sdev->scsi_level = inq_result[2] & 0x07; | |
553 | if (sdev->scsi_level >= 2 || | |
554 | (sdev->scsi_level == 1 && (inq_result[3] & 0x0f) == 1)) | |
555 | sdev->scsi_level++; | |
6f3a2024 | 556 | sdev->sdev_target->scsi_level = sdev->scsi_level; |
1da177e4 | 557 | |
39216033 | 558 | return 0; |
1da177e4 LT |
559 | } |
560 | ||
561 | /** | |
f64a181d CH |
562 | * scsi_add_lun - allocate and fully initialze a scsi_device |
563 | * @sdevscan: holds information to be stored in the new scsi_device | |
564 | * @sdevnew: store the address of the newly allocated scsi_device | |
1da177e4 LT |
565 | * @inq_result: holds the result of a previous INQUIRY to the LUN |
566 | * @bflags: black/white list flag | |
567 | * | |
568 | * Description: | |
f64a181d | 569 | * Allocate and initialize a scsi_device matching sdevscan. Optionally |
1da177e4 | 570 | * set fields based on values in *@bflags. If @sdevnew is not |
f64a181d | 571 | * NULL, store the address of the new scsi_device in *@sdevnew (needed |
1da177e4 LT |
572 | * when scanning a particular LUN). |
573 | * | |
574 | * Return: | |
f64a181d CH |
575 | * SCSI_SCAN_NO_RESPONSE: could not allocate or setup a scsi_device |
576 | * SCSI_SCAN_LUN_PRESENT: a new scsi_device was allocated and initialized | |
1da177e4 LT |
577 | **/ |
578 | static int scsi_add_lun(struct scsi_device *sdev, char *inq_result, int *bflags) | |
579 | { | |
580 | /* | |
581 | * XXX do not save the inquiry, since it can change underneath us, | |
582 | * save just vendor/model/rev. | |
583 | * | |
584 | * Rather than save it and have an ioctl that retrieves the saved | |
585 | * value, have an ioctl that executes the same INQUIRY code used | |
586 | * in scsi_probe_lun, let user level programs doing INQUIRY | |
587 | * scanning run at their own risk, or supply a user level program | |
588 | * that can correctly scan. | |
589 | */ | |
590 | sdev->inquiry = kmalloc(sdev->inquiry_len, GFP_ATOMIC); | |
591 | if (sdev->inquiry == NULL) { | |
592 | return SCSI_SCAN_NO_RESPONSE; | |
593 | } | |
594 | ||
595 | memcpy(sdev->inquiry, inq_result, sdev->inquiry_len); | |
596 | sdev->vendor = (char *) (sdev->inquiry + 8); | |
597 | sdev->model = (char *) (sdev->inquiry + 16); | |
598 | sdev->rev = (char *) (sdev->inquiry + 32); | |
599 | ||
600 | if (*bflags & BLIST_ISROM) { | |
601 | /* | |
602 | * It would be better to modify sdev->type, and set | |
4ff36718 MW |
603 | * sdev->removable; this can now be done since |
604 | * print_inquiry has gone away. | |
1da177e4 LT |
605 | */ |
606 | inq_result[0] = TYPE_ROM; | |
607 | inq_result[1] |= 0x80; /* removable */ | |
608 | } else if (*bflags & BLIST_NO_ULD_ATTACH) | |
609 | sdev->no_uld_attach = 1; | |
610 | ||
611 | switch (sdev->type = (inq_result[0] & 0x1f)) { | |
612 | case TYPE_TAPE: | |
613 | case TYPE_DISK: | |
614 | case TYPE_PRINTER: | |
615 | case TYPE_MOD: | |
616 | case TYPE_PROCESSOR: | |
617 | case TYPE_SCANNER: | |
618 | case TYPE_MEDIUM_CHANGER: | |
619 | case TYPE_ENCLOSURE: | |
620 | case TYPE_COMM: | |
4d7db04a | 621 | case TYPE_RAID: |
631e8a13 | 622 | case TYPE_RBC: |
1da177e4 LT |
623 | sdev->writeable = 1; |
624 | break; | |
625 | case TYPE_WORM: | |
626 | case TYPE_ROM: | |
627 | sdev->writeable = 0; | |
628 | break; | |
629 | default: | |
630 | printk(KERN_INFO "scsi: unknown device type %d\n", sdev->type); | |
631 | } | |
632 | ||
1da177e4 LT |
633 | /* |
634 | * For a peripheral qualifier (PQ) value of 1 (001b), the SCSI | |
635 | * spec says: The device server is capable of supporting the | |
636 | * specified peripheral device type on this logical unit. However, | |
637 | * the physical device is not currently connected to this logical | |
638 | * unit. | |
639 | * | |
640 | * The above is vague, as it implies that we could treat 001 and | |
641 | * 011 the same. Stay compatible with previous code, and create a | |
f64a181d | 642 | * scsi_device for a PQ of 1 |
1da177e4 LT |
643 | * |
644 | * Don't set the device offline here; rather let the upper | |
645 | * level drivers eval the PQ to decide whether they should | |
646 | * attach. So remove ((inq_result[0] >> 5) & 7) == 1 check. | |
647 | */ | |
648 | ||
649 | sdev->inq_periph_qual = (inq_result[0] >> 5) & 7; | |
650 | sdev->removable = (0x80 & inq_result[1]) >> 7; | |
651 | sdev->lockable = sdev->removable; | |
652 | sdev->soft_reset = (inq_result[7] & 1) && ((inq_result[3] & 7) == 2); | |
653 | ||
654 | if (sdev->scsi_level >= SCSI_3 || (sdev->inquiry_len > 56 && | |
655 | inq_result[56] & 0x04)) | |
656 | sdev->ppr = 1; | |
657 | if (inq_result[7] & 0x60) | |
658 | sdev->wdtr = 1; | |
659 | if (inq_result[7] & 0x10) | |
660 | sdev->sdtr = 1; | |
661 | ||
19ac0db3 | 662 | sdev_printk(KERN_NOTICE, sdev, "%s %.8s %.16s %.4s PQ: %d " |
4ff36718 MW |
663 | "ANSI: %d%s\n", scsi_device_type(sdev->type), |
664 | sdev->vendor, sdev->model, sdev->rev, | |
665 | sdev->inq_periph_qual, inq_result[2] & 0x07, | |
666 | (inq_result[3] & 0x0f) == 1 ? " CCS" : ""); | |
667 | ||
1da177e4 | 668 | /* |
5e3c34c1 | 669 | * End sysfs code. |
1da177e4 LT |
670 | */ |
671 | ||
672 | if ((sdev->scsi_level >= SCSI_2) && (inq_result[7] & 2) && | |
673 | !(*bflags & BLIST_NOTQ)) | |
674 | sdev->tagged_supported = 1; | |
675 | /* | |
676 | * Some devices (Texel CD ROM drives) have handshaking problems | |
677 | * when used with the Seagate controllers. borken is initialized | |
678 | * to 1, and then set it to 0 here. | |
679 | */ | |
680 | if ((*bflags & BLIST_BORKEN) == 0) | |
681 | sdev->borken = 0; | |
682 | ||
683 | /* | |
684 | * Apparently some really broken devices (contrary to the SCSI | |
685 | * standards) need to be selected without asserting ATN | |
686 | */ | |
687 | if (*bflags & BLIST_SELECT_NO_ATN) | |
688 | sdev->select_no_atn = 1; | |
689 | ||
4d7db04a JB |
690 | /* |
691 | * Maximum 512 sector transfer length | |
692 | * broken RA4x00 Compaq Disk Array | |
693 | */ | |
694 | if (*bflags & BLIST_MAX_512) | |
695 | blk_queue_max_sectors(sdev->request_queue, 512); | |
696 | ||
1da177e4 LT |
697 | /* |
698 | * Some devices may not want to have a start command automatically | |
699 | * issued when a device is added. | |
700 | */ | |
701 | if (*bflags & BLIST_NOSTARTONADD) | |
702 | sdev->no_start_on_add = 1; | |
703 | ||
704 | if (*bflags & BLIST_SINGLELUN) | |
705 | sdev->single_lun = 1; | |
706 | ||
707 | ||
708 | sdev->use_10_for_rw = 1; | |
709 | ||
710 | if (*bflags & BLIST_MS_SKIP_PAGE_08) | |
711 | sdev->skip_ms_page_8 = 1; | |
712 | ||
713 | if (*bflags & BLIST_MS_SKIP_PAGE_3F) | |
714 | sdev->skip_ms_page_3f = 1; | |
715 | ||
716 | if (*bflags & BLIST_USE_10_BYTE_MS) | |
717 | sdev->use_10_for_ms = 1; | |
718 | ||
719 | /* set the device running here so that slave configure | |
720 | * may do I/O */ | |
721 | scsi_device_set_state(sdev, SDEV_RUNNING); | |
722 | ||
723 | if (*bflags & BLIST_MS_192_BYTES_FOR_3F) | |
724 | sdev->use_192_bytes_for_3f = 1; | |
725 | ||
726 | if (*bflags & BLIST_NOT_LOCKABLE) | |
727 | sdev->lockable = 0; | |
728 | ||
729 | if (*bflags & BLIST_RETRY_HWERROR) | |
730 | sdev->retry_hwerror = 1; | |
731 | ||
732 | transport_configure_device(&sdev->sdev_gendev); | |
733 | ||
93805091 CH |
734 | if (sdev->host->hostt->slave_configure) { |
735 | int ret = sdev->host->hostt->slave_configure(sdev); | |
736 | if (ret) { | |
737 | /* | |
738 | * if LLDD reports slave not present, don't clutter | |
739 | * console with alloc failure messages | |
740 | */ | |
741 | if (ret != -ENXIO) { | |
742 | sdev_printk(KERN_ERR, sdev, | |
743 | "failed to configure device\n"); | |
744 | } | |
745 | return SCSI_SCAN_NO_RESPONSE; | |
746 | } | |
747 | } | |
1da177e4 LT |
748 | |
749 | /* | |
750 | * Ok, the device is now all set up, we can | |
751 | * register it and tell the rest of the kernel | |
752 | * about it. | |
753 | */ | |
b24b1033 AS |
754 | if (scsi_sysfs_add_sdev(sdev) != 0) |
755 | return SCSI_SCAN_NO_RESPONSE; | |
1da177e4 LT |
756 | |
757 | return SCSI_SCAN_LUN_PRESENT; | |
758 | } | |
759 | ||
6f3a2024 JB |
760 | static inline void scsi_destroy_sdev(struct scsi_device *sdev) |
761 | { | |
309bd271 | 762 | scsi_device_set_state(sdev, SDEV_DEL); |
6f3a2024 JB |
763 | if (sdev->host->hostt->slave_destroy) |
764 | sdev->host->hostt->slave_destroy(sdev); | |
765 | transport_destroy_device(&sdev->sdev_gendev); | |
766 | put_device(&sdev->sdev_gendev); | |
767 | } | |
768 | ||
c5f2e640 | 769 | #ifdef CONFIG_SCSI_LOGGING |
6c7154c9 KG |
770 | /** |
771 | * scsi_inq_str - print INQUIRY data from min to max index, | |
772 | * strip trailing whitespace | |
773 | * @buf: Output buffer with at least end-first+1 bytes of space | |
774 | * @inq: Inquiry buffer (input) | |
775 | * @first: Offset of string into inq | |
776 | * @end: Index after last character in inq | |
777 | */ | |
c5f2e640 | 778 | static unsigned char *scsi_inq_str(unsigned char *buf, unsigned char *inq, |
6c7154c9 KG |
779 | unsigned first, unsigned end) |
780 | { | |
781 | unsigned term = 0, idx; | |
c5f2e640 | 782 | |
783 | for (idx = 0; idx + first < end && idx + first < inq[4] + 5; idx++) { | |
784 | if (inq[idx+first] > ' ') { | |
6c7154c9 KG |
785 | buf[idx] = inq[idx+first]; |
786 | term = idx+1; | |
787 | } else { | |
788 | buf[idx] = ' '; | |
789 | } | |
790 | } | |
791 | buf[term] = 0; | |
792 | return buf; | |
793 | } | |
c5f2e640 | 794 | #endif |
6f3a2024 | 795 | |
1da177e4 LT |
796 | /** |
797 | * scsi_probe_and_add_lun - probe a LUN, if a LUN is found add it | |
798 | * @starget: pointer to target device structure | |
799 | * @lun: LUN of target device | |
f64a181d CH |
800 | * @sdevscan: probe the LUN corresponding to this scsi_device |
801 | * @sdevnew: store the value of any new scsi_device allocated | |
1da177e4 LT |
802 | * @bflagsp: store bflags here if not NULL |
803 | * | |
804 | * Description: | |
805 | * Call scsi_probe_lun, if a LUN with an attached device is found, | |
806 | * allocate and set it up by calling scsi_add_lun. | |
807 | * | |
808 | * Return: | |
f64a181d | 809 | * SCSI_SCAN_NO_RESPONSE: could not allocate or setup a scsi_device |
1da177e4 LT |
810 | * SCSI_SCAN_TARGET_PRESENT: target responded, but no device is |
811 | * attached at the LUN | |
f64a181d | 812 | * SCSI_SCAN_LUN_PRESENT: a new scsi_device was allocated and initialized |
1da177e4 LT |
813 | **/ |
814 | static int scsi_probe_and_add_lun(struct scsi_target *starget, | |
815 | uint lun, int *bflagsp, | |
816 | struct scsi_device **sdevp, int rescan, | |
817 | void *hostdata) | |
818 | { | |
819 | struct scsi_device *sdev; | |
1da177e4 | 820 | unsigned char *result; |
39216033 | 821 | int bflags, res = SCSI_SCAN_NO_RESPONSE, result_len = 256; |
1da177e4 LT |
822 | struct Scsi_Host *shost = dev_to_shost(starget->dev.parent); |
823 | ||
824 | /* | |
825 | * The rescan flag is used as an optimization, the first scan of a | |
826 | * host adapter calls into here with rescan == 0. | |
827 | */ | |
6f3a2024 JB |
828 | sdev = scsi_device_lookup_by_target(starget, lun); |
829 | if (sdev) { | |
830 | if (rescan || sdev->sdev_state != SDEV_CREATED) { | |
1da177e4 LT |
831 | SCSI_LOG_SCAN_BUS(3, printk(KERN_INFO |
832 | "scsi scan: device exists on %s\n", | |
833 | sdev->sdev_gendev.bus_id)); | |
834 | if (sdevp) | |
835 | *sdevp = sdev; | |
836 | else | |
837 | scsi_device_put(sdev); | |
838 | ||
839 | if (bflagsp) | |
840 | *bflagsp = scsi_get_device_flags(sdev, | |
841 | sdev->vendor, | |
842 | sdev->model); | |
843 | return SCSI_SCAN_LUN_PRESENT; | |
844 | } | |
6f3a2024 JB |
845 | scsi_device_put(sdev); |
846 | } else | |
847 | sdev = scsi_alloc_sdev(starget, lun, hostdata); | |
1da177e4 LT |
848 | if (!sdev) |
849 | goto out; | |
39216033 JB |
850 | |
851 | result = kmalloc(result_len, GFP_ATOMIC | | |
bc86120a | 852 | ((shost->unchecked_isa_dma) ? __GFP_DMA : 0)); |
1da177e4 | 853 | if (!result) |
39216033 | 854 | goto out_free_sdev; |
1da177e4 | 855 | |
39216033 | 856 | if (scsi_probe_lun(sdev, result, result_len, &bflags)) |
1da177e4 LT |
857 | goto out_free_result; |
858 | ||
4186ab19 KG |
859 | if (bflagsp) |
860 | *bflagsp = bflags; | |
1da177e4 LT |
861 | /* |
862 | * result contains valid SCSI INQUIRY data. | |
863 | */ | |
13f7e5ac | 864 | if (((result[0] >> 5) == 3) && !(bflags & BLIST_ATTACH_PQ3)) { |
1da177e4 LT |
865 | /* |
866 | * For a Peripheral qualifier 3 (011b), the SCSI | |
867 | * spec says: The device server is not capable of | |
868 | * supporting a physical device on this logical | |
869 | * unit. | |
870 | * | |
871 | * For disks, this implies that there is no | |
872 | * logical disk configured at sdev->lun, but there | |
873 | * is a target id responding. | |
874 | */ | |
6c7154c9 KG |
875 | SCSI_LOG_SCAN_BUS(2, sdev_printk(KERN_INFO, sdev, "scsi scan:" |
876 | " peripheral qualifier of 3, device not" | |
877 | " added\n")) | |
878 | if (lun == 0) { | |
c5f2e640 | 879 | SCSI_LOG_SCAN_BUS(1, { |
880 | unsigned char vend[9]; | |
881 | unsigned char mod[17]; | |
882 | ||
883 | sdev_printk(KERN_INFO, sdev, | |
6c7154c9 KG |
884 | "scsi scan: consider passing scsi_mod." |
885 | "dev_flags=%s:%s:0x240 or 0x800240\n", | |
886 | scsi_inq_str(vend, result, 8, 16), | |
c5f2e640 | 887 | scsi_inq_str(mod, result, 16, 32)); |
888 | }); | |
6c7154c9 KG |
889 | } |
890 | ||
1da177e4 LT |
891 | res = SCSI_SCAN_TARGET_PRESENT; |
892 | goto out_free_result; | |
893 | } | |
894 | ||
1bfc5d9d AS |
895 | /* |
896 | * Non-standard SCSI targets may set the PDT to 0x1f (unknown or | |
897 | * no device type) instead of using the Peripheral Qualifier to | |
898 | * indicate that no LUN is present. For example, USB UFI does this. | |
899 | */ | |
900 | if (starget->pdt_1f_for_no_lun && (result[0] & 0x1f) == 0x1f) { | |
901 | SCSI_LOG_SCAN_BUS(3, printk(KERN_INFO | |
902 | "scsi scan: peripheral device type" | |
903 | " of 31, no device added\n")); | |
904 | res = SCSI_SCAN_TARGET_PRESENT; | |
905 | goto out_free_result; | |
906 | } | |
907 | ||
1da177e4 LT |
908 | res = scsi_add_lun(sdev, result, &bflags); |
909 | if (res == SCSI_SCAN_LUN_PRESENT) { | |
910 | if (bflags & BLIST_KEY) { | |
911 | sdev->lockable = 0; | |
39216033 | 912 | scsi_unlock_floptical(sdev, result); |
1da177e4 | 913 | } |
1da177e4 LT |
914 | } |
915 | ||
916 | out_free_result: | |
917 | kfree(result); | |
1da177e4 LT |
918 | out_free_sdev: |
919 | if (res == SCSI_SCAN_LUN_PRESENT) { | |
920 | if (sdevp) { | |
b70d37bf AS |
921 | if (scsi_device_get(sdev) == 0) { |
922 | *sdevp = sdev; | |
923 | } else { | |
924 | __scsi_remove_device(sdev); | |
925 | res = SCSI_SCAN_NO_RESPONSE; | |
926 | } | |
1da177e4 | 927 | } |
6f3a2024 JB |
928 | } else |
929 | scsi_destroy_sdev(sdev); | |
1da177e4 LT |
930 | out: |
931 | return res; | |
932 | } | |
933 | ||
934 | /** | |
935 | * scsi_sequential_lun_scan - sequentially scan a SCSI target | |
936 | * @starget: pointer to target structure to scan | |
937 | * @bflags: black/white list flag for LUN 0 | |
1da177e4 LT |
938 | * |
939 | * Description: | |
940 | * Generally, scan from LUN 1 (LUN 0 is assumed to already have been | |
941 | * scanned) to some maximum lun until a LUN is found with no device | |
942 | * attached. Use the bflags to figure out any oddities. | |
943 | * | |
944 | * Modifies sdevscan->lun. | |
945 | **/ | |
946 | static void scsi_sequential_lun_scan(struct scsi_target *starget, | |
4186ab19 | 947 | int bflags, int scsi_level, int rescan) |
1da177e4 LT |
948 | { |
949 | unsigned int sparse_lun, lun, max_dev_lun; | |
950 | struct Scsi_Host *shost = dev_to_shost(starget->dev.parent); | |
951 | ||
952 | SCSI_LOG_SCAN_BUS(3, printk(KERN_INFO "scsi scan: Sequential scan of" | |
953 | "%s\n", starget->dev.bus_id)); | |
954 | ||
955 | max_dev_lun = min(max_scsi_luns, shost->max_lun); | |
956 | /* | |
957 | * If this device is known to support sparse multiple units, | |
958 | * override the other settings, and scan all of them. Normally, | |
959 | * SCSI-3 devices should be scanned via the REPORT LUNS. | |
960 | */ | |
961 | if (bflags & BLIST_SPARSELUN) { | |
962 | max_dev_lun = shost->max_lun; | |
963 | sparse_lun = 1; | |
964 | } else | |
965 | sparse_lun = 0; | |
966 | ||
1da177e4 LT |
967 | /* |
968 | * If less than SCSI_1_CSS, and no special lun scaning, stop | |
969 | * scanning; this matches 2.4 behaviour, but could just be a bug | |
970 | * (to continue scanning a SCSI_1_CSS device). | |
971 | * | |
972 | * This test is broken. We might not have any device on lun0 for | |
973 | * a sparselun device, and if that's the case then how would we | |
974 | * know the real scsi_level, eh? It might make sense to just not | |
975 | * scan any SCSI_1 device for non-0 luns, but that check would best | |
976 | * go into scsi_alloc_sdev() and just have it return null when asked | |
977 | * to alloc an sdev for lun > 0 on an already found SCSI_1 device. | |
978 | * | |
979 | if ((sdevscan->scsi_level < SCSI_1_CCS) && | |
980 | ((bflags & (BLIST_FORCELUN | BLIST_SPARSELUN | BLIST_MAX5LUN)) | |
981 | == 0)) | |
982 | return; | |
983 | */ | |
984 | /* | |
985 | * If this device is known to support multiple units, override | |
986 | * the other settings, and scan all of them. | |
987 | */ | |
988 | if (bflags & BLIST_FORCELUN) | |
989 | max_dev_lun = shost->max_lun; | |
990 | /* | |
991 | * REGAL CDC-4X: avoid hang after LUN 4 | |
992 | */ | |
993 | if (bflags & BLIST_MAX5LUN) | |
994 | max_dev_lun = min(5U, max_dev_lun); | |
995 | /* | |
996 | * Do not scan SCSI-2 or lower device past LUN 7, unless | |
997 | * BLIST_LARGELUN. | |
998 | */ | |
999 | if (scsi_level < SCSI_3 && !(bflags & BLIST_LARGELUN)) | |
1000 | max_dev_lun = min(8U, max_dev_lun); | |
1001 | ||
1002 | /* | |
1003 | * We have already scanned LUN 0, so start at LUN 1. Keep scanning | |
1004 | * until we reach the max, or no LUN is found and we are not | |
1005 | * sparse_lun. | |
1006 | */ | |
1007 | for (lun = 1; lun < max_dev_lun; ++lun) | |
1008 | if ((scsi_probe_and_add_lun(starget, lun, NULL, NULL, rescan, | |
1009 | NULL) != SCSI_SCAN_LUN_PRESENT) && | |
1010 | !sparse_lun) | |
1011 | return; | |
1012 | } | |
1013 | ||
1014 | /** | |
1015 | * scsilun_to_int: convert a scsi_lun to an int | |
1016 | * @scsilun: struct scsi_lun to be converted. | |
1017 | * | |
1018 | * Description: | |
1019 | * Convert @scsilun from a struct scsi_lun to a four byte host byte-ordered | |
1020 | * integer, and return the result. The caller must check for | |
1021 | * truncation before using this function. | |
1022 | * | |
1023 | * Notes: | |
1024 | * The struct scsi_lun is assumed to be four levels, with each level | |
1025 | * effectively containing a SCSI byte-ordered (big endian) short; the | |
1026 | * addressing bits of each level are ignored (the highest two bits). | |
1027 | * For a description of the LUN format, post SCSI-3 see the SCSI | |
1028 | * Architecture Model, for SCSI-3 see the SCSI Controller Commands. | |
1029 | * | |
1030 | * Given a struct scsi_lun of: 0a 04 0b 03 00 00 00 00, this function returns | |
1031 | * the integer: 0x0b030a04 | |
1032 | **/ | |
1033 | static int scsilun_to_int(struct scsi_lun *scsilun) | |
1034 | { | |
1035 | int i; | |
1036 | unsigned int lun; | |
1037 | ||
1038 | lun = 0; | |
1039 | for (i = 0; i < sizeof(lun); i += 2) | |
1040 | lun = lun | (((scsilun->scsi_lun[i] << 8) | | |
1041 | scsilun->scsi_lun[i + 1]) << (i * 8)); | |
1042 | return lun; | |
1043 | } | |
1044 | ||
2f4701d8 JSEC |
1045 | /** |
1046 | * int_to_scsilun: reverts an int into a scsi_lun | |
1047 | * @int: integer to be reverted | |
1048 | * @scsilun: struct scsi_lun to be set. | |
1049 | * | |
1050 | * Description: | |
1051 | * Reverts the functionality of the scsilun_to_int, which packed | |
1052 | * an 8-byte lun value into an int. This routine unpacks the int | |
1053 | * back into the lun value. | |
1054 | * Note: the scsilun_to_int() routine does not truly handle all | |
1055 | * 8bytes of the lun value. This functions restores only as much | |
1056 | * as was set by the routine. | |
1057 | * | |
1058 | * Notes: | |
1059 | * Given an integer : 0x0b030a04, this function returns a | |
1060 | * scsi_lun of : struct scsi_lun of: 0a 04 0b 03 00 00 00 00 | |
1061 | * | |
1062 | **/ | |
1063 | void int_to_scsilun(unsigned int lun, struct scsi_lun *scsilun) | |
1064 | { | |
1065 | int i; | |
1066 | ||
1067 | memset(scsilun->scsi_lun, 0, sizeof(scsilun->scsi_lun)); | |
1068 | ||
1069 | for (i = 0; i < sizeof(lun); i += 2) { | |
1070 | scsilun->scsi_lun[i] = (lun >> 8) & 0xFF; | |
1071 | scsilun->scsi_lun[i+1] = lun & 0xFF; | |
1072 | lun = lun >> 16; | |
1073 | } | |
1074 | } | |
1075 | EXPORT_SYMBOL(int_to_scsilun); | |
1076 | ||
1da177e4 LT |
1077 | /** |
1078 | * scsi_report_lun_scan - Scan using SCSI REPORT LUN results | |
f64a181d | 1079 | * @sdevscan: scan the host, channel, and id of this scsi_device |
1da177e4 LT |
1080 | * |
1081 | * Description: | |
1082 | * If @sdevscan is for a SCSI-3 or up device, send a REPORT LUN | |
1083 | * command, and scan the resulting list of LUNs by calling | |
1084 | * scsi_probe_and_add_lun. | |
1085 | * | |
1086 | * Modifies sdevscan->lun. | |
1087 | * | |
1088 | * Return: | |
1089 | * 0: scan completed (or no memory, so further scanning is futile) | |
1090 | * 1: no report lun scan, or not configured | |
1091 | **/ | |
6f3a2024 | 1092 | static int scsi_report_lun_scan(struct scsi_target *starget, int bflags, |
1da177e4 LT |
1093 | int rescan) |
1094 | { | |
1095 | char devname[64]; | |
1096 | unsigned char scsi_cmd[MAX_COMMAND_SIZE]; | |
1097 | unsigned int length; | |
1098 | unsigned int lun; | |
1099 | unsigned int num_luns; | |
1100 | unsigned int retries; | |
39216033 | 1101 | int result; |
1da177e4 | 1102 | struct scsi_lun *lunp, *lun_data; |
1da177e4 LT |
1103 | u8 *data; |
1104 | struct scsi_sense_hdr sshdr; | |
6f3a2024 JB |
1105 | struct scsi_device *sdev; |
1106 | struct Scsi_Host *shost = dev_to_shost(&starget->dev); | |
2ef89198 | 1107 | int ret = 0; |
1da177e4 LT |
1108 | |
1109 | /* | |
1110 | * Only support SCSI-3 and up devices if BLIST_NOREPORTLUN is not set. | |
1111 | * Also allow SCSI-2 if BLIST_REPORTLUN2 is set and host adapter does | |
1112 | * support more than 8 LUNs. | |
1113 | */ | |
4d7db04a JB |
1114 | if (bflags & BLIST_NOREPORTLUN) |
1115 | return 1; | |
1116 | if (starget->scsi_level < SCSI_2 && | |
1117 | starget->scsi_level != SCSI_UNKNOWN) | |
1118 | return 1; | |
1119 | if (starget->scsi_level < SCSI_3 && | |
1120 | (!(bflags & BLIST_REPORTLUN2) || shost->max_lun <= 8)) | |
1da177e4 LT |
1121 | return 1; |
1122 | if (bflags & BLIST_NOLUN) | |
1123 | return 0; | |
1124 | ||
6f3a2024 JB |
1125 | if (!(sdev = scsi_device_lookup_by_target(starget, 0))) { |
1126 | sdev = scsi_alloc_sdev(starget, 0, NULL); | |
1127 | if (!sdev) | |
1128 | return 0; | |
1129 | if (scsi_device_get(sdev)) | |
1130 | return 0; | |
1131 | } | |
1132 | ||
1da177e4 | 1133 | sprintf(devname, "host %d channel %d id %d", |
6f3a2024 | 1134 | shost->host_no, sdev->channel, sdev->id); |
1da177e4 LT |
1135 | |
1136 | /* | |
1137 | * Allocate enough to hold the header (the same size as one scsi_lun) | |
1138 | * plus the max number of luns we are requesting. | |
1139 | * | |
1140 | * Reallocating and trying again (with the exact amount we need) | |
1141 | * would be nice, but then we need to somehow limit the size | |
1142 | * allocated based on the available memory and the limits of | |
1143 | * kmalloc - we don't want a kmalloc() failure of a huge value to | |
1144 | * prevent us from finding any LUNs on this target. | |
1145 | */ | |
1146 | length = (max_scsi_report_luns + 1) * sizeof(struct scsi_lun); | |
1147 | lun_data = kmalloc(length, GFP_ATOMIC | | |
1148 | (sdev->host->unchecked_isa_dma ? __GFP_DMA : 0)); | |
6f3a2024 JB |
1149 | if (!lun_data) { |
1150 | printk(ALLOC_FAILURE_MSG, __FUNCTION__); | |
39216033 | 1151 | goto out; |
6f3a2024 | 1152 | } |
1da177e4 LT |
1153 | |
1154 | scsi_cmd[0] = REPORT_LUNS; | |
1155 | ||
1156 | /* | |
1157 | * bytes 1 - 5: reserved, set to zero. | |
1158 | */ | |
1159 | memset(&scsi_cmd[1], 0, 5); | |
1160 | ||
1161 | /* | |
1162 | * bytes 6 - 9: length of the command. | |
1163 | */ | |
1164 | scsi_cmd[6] = (unsigned char) (length >> 24) & 0xff; | |
1165 | scsi_cmd[7] = (unsigned char) (length >> 16) & 0xff; | |
1166 | scsi_cmd[8] = (unsigned char) (length >> 8) & 0xff; | |
1167 | scsi_cmd[9] = (unsigned char) length & 0xff; | |
1168 | ||
1169 | scsi_cmd[10] = 0; /* reserved */ | |
1170 | scsi_cmd[11] = 0; /* control */ | |
1da177e4 LT |
1171 | |
1172 | /* | |
1173 | * We can get a UNIT ATTENTION, for example a power on/reset, so | |
1174 | * retry a few times (like sd.c does for TEST UNIT READY). | |
1175 | * Experience shows some combinations of adapter/devices get at | |
1176 | * least two power on/resets. | |
1177 | * | |
1178 | * Illegal requests (for devices that do not support REPORT LUNS) | |
1179 | * should come through as a check condition, and will not generate | |
1180 | * a retry. | |
1181 | */ | |
1182 | for (retries = 0; retries < 3; retries++) { | |
1183 | SCSI_LOG_SCAN_BUS(3, printk (KERN_INFO "scsi scan: Sending" | |
1184 | " REPORT LUNS to %s (try %d)\n", devname, | |
1185 | retries)); | |
39216033 | 1186 | |
39216033 | 1187 | result = scsi_execute_req(sdev, scsi_cmd, DMA_FROM_DEVICE, |
ea73a9f2 | 1188 | lun_data, length, &sshdr, |
39216033 JB |
1189 | SCSI_TIMEOUT + 4 * HZ, 3); |
1190 | ||
1da177e4 | 1191 | SCSI_LOG_SCAN_BUS(3, printk (KERN_INFO "scsi scan: REPORT LUNS" |
39216033 JB |
1192 | " %s (try %d) result 0x%x\n", result |
1193 | ? "failed" : "successful", retries, result)); | |
1194 | if (result == 0) | |
1da177e4 | 1195 | break; |
ea73a9f2 | 1196 | else if (scsi_sense_valid(&sshdr)) { |
1da177e4 LT |
1197 | if (sshdr.sense_key != UNIT_ATTENTION) |
1198 | break; | |
1199 | } | |
1200 | } | |
1201 | ||
39216033 | 1202 | if (result) { |
1da177e4 LT |
1203 | /* |
1204 | * The device probably does not support a REPORT LUN command | |
1205 | */ | |
2ef89198 AS |
1206 | ret = 1; |
1207 | goto out_err; | |
1da177e4 | 1208 | } |
1da177e4 LT |
1209 | |
1210 | /* | |
1211 | * Get the length from the first four bytes of lun_data. | |
1212 | */ | |
1213 | data = (u8 *) lun_data->scsi_lun; | |
1214 | length = ((data[0] << 24) | (data[1] << 16) | | |
1215 | (data[2] << 8) | (data[3] << 0)); | |
1216 | ||
1217 | num_luns = (length / sizeof(struct scsi_lun)); | |
1218 | if (num_luns > max_scsi_report_luns) { | |
1219 | printk(KERN_WARNING "scsi: On %s only %d (max_scsi_report_luns)" | |
1220 | " of %d luns reported, try increasing" | |
1221 | " max_scsi_report_luns.\n", devname, | |
1222 | max_scsi_report_luns, num_luns); | |
1223 | num_luns = max_scsi_report_luns; | |
1224 | } | |
1225 | ||
3bf743e7 JG |
1226 | SCSI_LOG_SCAN_BUS(3, sdev_printk (KERN_INFO, sdev, |
1227 | "scsi scan: REPORT LUN scan\n")); | |
1da177e4 LT |
1228 | |
1229 | /* | |
1230 | * Scan the luns in lun_data. The entry at offset 0 is really | |
1231 | * the header, so start at 1 and go up to and including num_luns. | |
1232 | */ | |
1233 | for (lunp = &lun_data[1]; lunp <= &lun_data[num_luns]; lunp++) { | |
1234 | lun = scsilun_to_int(lunp); | |
1235 | ||
1236 | /* | |
1237 | * Check if the unused part of lunp is non-zero, and so | |
1238 | * does not fit in lun. | |
1239 | */ | |
1240 | if (memcmp(&lunp->scsi_lun[sizeof(lun)], "\0\0\0\0", 4)) { | |
1241 | int i; | |
1242 | ||
1243 | /* | |
1244 | * Output an error displaying the LUN in byte order, | |
1245 | * this differs from what linux would print for the | |
1246 | * integer LUN value. | |
1247 | */ | |
1248 | printk(KERN_WARNING "scsi: %s lun 0x", devname); | |
1249 | data = (char *)lunp->scsi_lun; | |
1250 | for (i = 0; i < sizeof(struct scsi_lun); i++) | |
1251 | printk("%02x", data[i]); | |
1252 | printk(" has a LUN larger than currently supported.\n"); | |
1da177e4 LT |
1253 | } else if (lun > sdev->host->max_lun) { |
1254 | printk(KERN_WARNING "scsi: %s lun%d has a LUN larger" | |
1255 | " than allowed by the host adapter\n", | |
1256 | devname, lun); | |
1257 | } else { | |
1258 | int res; | |
1259 | ||
1260 | res = scsi_probe_and_add_lun(starget, | |
1261 | lun, NULL, NULL, rescan, NULL); | |
1262 | if (res == SCSI_SCAN_NO_RESPONSE) { | |
1263 | /* | |
1264 | * Got some results, but now none, abort. | |
1265 | */ | |
3bf743e7 JG |
1266 | sdev_printk(KERN_ERR, sdev, |
1267 | "Unexpected response" | |
1268 | " from lun %d while scanning, scan" | |
1269 | " aborted\n", lun); | |
1da177e4 LT |
1270 | break; |
1271 | } | |
1272 | } | |
1273 | } | |
1274 | ||
2ef89198 | 1275 | out_err: |
1da177e4 | 1276 | kfree(lun_data); |
1da177e4 | 1277 | out: |
6f3a2024 JB |
1278 | scsi_device_put(sdev); |
1279 | if (sdev->sdev_state == SDEV_CREATED) | |
1280 | /* | |
1281 | * the sdev we used didn't appear in the report luns scan | |
1282 | */ | |
1283 | scsi_destroy_sdev(sdev); | |
2ef89198 | 1284 | return ret; |
1da177e4 LT |
1285 | } |
1286 | ||
1287 | struct scsi_device *__scsi_add_device(struct Scsi_Host *shost, uint channel, | |
1288 | uint id, uint lun, void *hostdata) | |
1289 | { | |
a97a83a0 | 1290 | struct scsi_device *sdev = ERR_PTR(-ENODEV); |
1da177e4 | 1291 | struct device *parent = &shost->shost_gendev; |
e02f3f59 | 1292 | struct scsi_target *starget; |
1da177e4 | 1293 | |
e02f3f59 | 1294 | starget = scsi_alloc_target(parent, channel, id); |
1da177e4 LT |
1295 | if (!starget) |
1296 | return ERR_PTR(-ENOMEM); | |
1297 | ||
c92715b3 | 1298 | get_device(&starget->dev); |
0b950672 | 1299 | mutex_lock(&shost->scan_mutex); |
a97a83a0 MW |
1300 | if (scsi_host_scan_allowed(shost)) |
1301 | scsi_probe_and_add_lun(starget, lun, NULL, &sdev, 1, hostdata); | |
0b950672 | 1302 | mutex_unlock(&shost->scan_mutex); |
1da177e4 LT |
1303 | scsi_target_reap(starget); |
1304 | put_device(&starget->dev); | |
1305 | ||
1306 | return sdev; | |
1307 | } | |
1308 | EXPORT_SYMBOL(__scsi_add_device); | |
1309 | ||
146f7262 JB |
1310 | int scsi_add_device(struct Scsi_Host *host, uint channel, |
1311 | uint target, uint lun) | |
1312 | { | |
1313 | struct scsi_device *sdev = | |
1314 | __scsi_add_device(host, channel, target, lun, NULL); | |
1315 | if (IS_ERR(sdev)) | |
1316 | return PTR_ERR(sdev); | |
1317 | ||
1318 | scsi_device_put(sdev); | |
1319 | return 0; | |
1320 | } | |
1321 | EXPORT_SYMBOL(scsi_add_device); | |
1322 | ||
1da177e4 LT |
1323 | void scsi_rescan_device(struct device *dev) |
1324 | { | |
1325 | struct scsi_driver *drv; | |
1326 | ||
1327 | if (!dev->driver) | |
1328 | return; | |
1329 | ||
1330 | drv = to_scsi_driver(dev->driver); | |
1331 | if (try_module_get(drv->owner)) { | |
1332 | if (drv->rescan) | |
1333 | drv->rescan(dev); | |
1334 | module_put(drv->owner); | |
1335 | } | |
1336 | } | |
1337 | EXPORT_SYMBOL(scsi_rescan_device); | |
1338 | ||
e517d313 AS |
1339 | static void __scsi_scan_target(struct device *parent, unsigned int channel, |
1340 | unsigned int id, unsigned int lun, int rescan) | |
1da177e4 LT |
1341 | { |
1342 | struct Scsi_Host *shost = dev_to_shost(parent); | |
1343 | int bflags = 0; | |
1344 | int res; | |
1da177e4 LT |
1345 | struct scsi_target *starget; |
1346 | ||
1347 | if (shost->this_id == id) | |
1348 | /* | |
1349 | * Don't scan the host adapter | |
1350 | */ | |
1351 | return; | |
1352 | ||
1da177e4 | 1353 | starget = scsi_alloc_target(parent, channel, id); |
1da177e4 LT |
1354 | if (!starget) |
1355 | return; | |
1356 | ||
1357 | get_device(&starget->dev); | |
1358 | if (lun != SCAN_WILD_CARD) { | |
1359 | /* | |
1360 | * Scan for a specific host/chan/id/lun. | |
1361 | */ | |
1362 | scsi_probe_and_add_lun(starget, lun, NULL, NULL, rescan, NULL); | |
1363 | goto out_reap; | |
1364 | } | |
1365 | ||
1366 | /* | |
1367 | * Scan LUN 0, if there is some response, scan further. Ideally, we | |
1368 | * would not configure LUN 0 until all LUNs are scanned. | |
1369 | */ | |
6f3a2024 JB |
1370 | res = scsi_probe_and_add_lun(starget, 0, &bflags, NULL, rescan, NULL); |
1371 | if (res == SCSI_SCAN_LUN_PRESENT || res == SCSI_SCAN_TARGET_PRESENT) { | |
1372 | if (scsi_report_lun_scan(starget, bflags, rescan) != 0) | |
1da177e4 LT |
1373 | /* |
1374 | * The REPORT LUN did not scan the target, | |
1375 | * do a sequential scan. | |
1376 | */ | |
1377 | scsi_sequential_lun_scan(starget, bflags, | |
4186ab19 | 1378 | starget->scsi_level, rescan); |
1da177e4 | 1379 | } |
1da177e4 LT |
1380 | |
1381 | out_reap: | |
1382 | /* now determine if the target has any children at all | |
1383 | * and if not, nuke it */ | |
1384 | scsi_target_reap(starget); | |
1385 | ||
1386 | put_device(&starget->dev); | |
1387 | } | |
e517d313 AS |
1388 | |
1389 | /** | |
1390 | * scsi_scan_target - scan a target id, possibly including all LUNs on the | |
1391 | * target. | |
1392 | * @parent: host to scan | |
1393 | * @channel: channel to scan | |
1394 | * @id: target id to scan | |
1395 | * @lun: Specific LUN to scan or SCAN_WILD_CARD | |
1396 | * @rescan: passed to LUN scanning routines | |
1397 | * | |
1398 | * Description: | |
1399 | * Scan the target id on @parent, @channel, and @id. Scan at least LUN 0, | |
1400 | * and possibly all LUNs on the target id. | |
1401 | * | |
1402 | * First try a REPORT LUN scan, if that does not scan the target, do a | |
1403 | * sequential scan of LUNs on the target id. | |
1404 | **/ | |
1405 | void scsi_scan_target(struct device *parent, unsigned int channel, | |
1406 | unsigned int id, unsigned int lun, int rescan) | |
1407 | { | |
1408 | struct Scsi_Host *shost = dev_to_shost(parent); | |
1409 | ||
0b950672 | 1410 | mutex_lock(&shost->scan_mutex); |
e517d313 AS |
1411 | if (scsi_host_scan_allowed(shost)) |
1412 | __scsi_scan_target(parent, channel, id, lun, rescan); | |
0b950672 | 1413 | mutex_unlock(&shost->scan_mutex); |
e517d313 | 1414 | } |
1da177e4 LT |
1415 | EXPORT_SYMBOL(scsi_scan_target); |
1416 | ||
1417 | static void scsi_scan_channel(struct Scsi_Host *shost, unsigned int channel, | |
1418 | unsigned int id, unsigned int lun, int rescan) | |
1419 | { | |
1420 | uint order_id; | |
1421 | ||
1422 | if (id == SCAN_WILD_CARD) | |
1423 | for (id = 0; id < shost->max_id; ++id) { | |
1424 | /* | |
1425 | * XXX adapter drivers when possible (FCP, iSCSI) | |
1426 | * could modify max_id to match the current max, | |
1427 | * not the absolute max. | |
1428 | * | |
1429 | * XXX add a shost id iterator, so for example, | |
1430 | * the FC ID can be the same as a target id | |
1431 | * without a huge overhead of sparse id's. | |
1432 | */ | |
1433 | if (shost->reverse_ordering) | |
1434 | /* | |
1435 | * Scan from high to low id. | |
1436 | */ | |
1437 | order_id = shost->max_id - id - 1; | |
1438 | else | |
1439 | order_id = id; | |
e517d313 AS |
1440 | __scsi_scan_target(&shost->shost_gendev, channel, |
1441 | order_id, lun, rescan); | |
1da177e4 LT |
1442 | } |
1443 | else | |
e517d313 AS |
1444 | __scsi_scan_target(&shost->shost_gendev, channel, |
1445 | id, lun, rescan); | |
1da177e4 LT |
1446 | } |
1447 | ||
1448 | int scsi_scan_host_selected(struct Scsi_Host *shost, unsigned int channel, | |
1449 | unsigned int id, unsigned int lun, int rescan) | |
1450 | { | |
3bf743e7 JG |
1451 | SCSI_LOG_SCAN_BUS(3, shost_printk (KERN_INFO, shost, |
1452 | "%s: <%u:%u:%u>\n", | |
1453 | __FUNCTION__, channel, id, lun)); | |
1da177e4 LT |
1454 | |
1455 | if (((channel != SCAN_WILD_CARD) && (channel > shost->max_channel)) || | |
091686d3 | 1456 | ((id != SCAN_WILD_CARD) && (id >= shost->max_id)) || |
1da177e4 LT |
1457 | ((lun != SCAN_WILD_CARD) && (lun > shost->max_lun))) |
1458 | return -EINVAL; | |
1459 | ||
0b950672 | 1460 | mutex_lock(&shost->scan_mutex); |
82f29467 MA |
1461 | if (scsi_host_scan_allowed(shost)) { |
1462 | if (channel == SCAN_WILD_CARD) | |
1463 | for (channel = 0; channel <= shost->max_channel; | |
1464 | channel++) | |
1465 | scsi_scan_channel(shost, channel, id, lun, | |
1466 | rescan); | |
1467 | else | |
1da177e4 | 1468 | scsi_scan_channel(shost, channel, id, lun, rescan); |
82f29467 | 1469 | } |
0b950672 | 1470 | mutex_unlock(&shost->scan_mutex); |
1da177e4 LT |
1471 | |
1472 | return 0; | |
1473 | } | |
1474 | ||
1475 | /** | |
1476 | * scsi_scan_host - scan the given adapter | |
1477 | * @shost: adapter to scan | |
1478 | **/ | |
1479 | void scsi_scan_host(struct Scsi_Host *shost) | |
1480 | { | |
1481 | scsi_scan_host_selected(shost, SCAN_WILD_CARD, SCAN_WILD_CARD, | |
1482 | SCAN_WILD_CARD, 0); | |
1483 | } | |
1484 | EXPORT_SYMBOL(scsi_scan_host); | |
1485 | ||
1da177e4 LT |
1486 | void scsi_forget_host(struct Scsi_Host *shost) |
1487 | { | |
a64358db | 1488 | struct scsi_device *sdev; |
1da177e4 LT |
1489 | unsigned long flags; |
1490 | ||
a64358db | 1491 | restart: |
1da177e4 | 1492 | spin_lock_irqsave(shost->host_lock, flags); |
a64358db AS |
1493 | list_for_each_entry(sdev, &shost->__devices, siblings) { |
1494 | if (sdev->sdev_state == SDEV_DEL) | |
1495 | continue; | |
1da177e4 | 1496 | spin_unlock_irqrestore(shost->host_lock, flags); |
a64358db AS |
1497 | __scsi_remove_device(sdev); |
1498 | goto restart; | |
1da177e4 LT |
1499 | } |
1500 | spin_unlock_irqrestore(shost->host_lock, flags); | |
1501 | } | |
1502 | ||
1503 | /* | |
1504 | * Function: scsi_get_host_dev() | |
1505 | * | |
f64a181d | 1506 | * Purpose: Create a scsi_device that points to the host adapter itself. |
1da177e4 | 1507 | * |
f64a181d | 1508 | * Arguments: SHpnt - Host that needs a scsi_device |
1da177e4 LT |
1509 | * |
1510 | * Lock status: None assumed. | |
1511 | * | |
f64a181d | 1512 | * Returns: The scsi_device or NULL |
1da177e4 LT |
1513 | * |
1514 | * Notes: | |
f64a181d | 1515 | * Attach a single scsi_device to the Scsi_Host - this should |
1da177e4 LT |
1516 | * be made to look like a "pseudo-device" that points to the |
1517 | * HA itself. | |
1518 | * | |
1519 | * Note - this device is not accessible from any high-level | |
1520 | * drivers (including generics), which is probably not | |
1521 | * optimal. We can add hooks later to attach | |
1522 | */ | |
1523 | struct scsi_device *scsi_get_host_dev(struct Scsi_Host *shost) | |
1524 | { | |
e517d313 | 1525 | struct scsi_device *sdev = NULL; |
1da177e4 LT |
1526 | struct scsi_target *starget; |
1527 | ||
0b950672 | 1528 | mutex_lock(&shost->scan_mutex); |
e517d313 AS |
1529 | if (!scsi_host_scan_allowed(shost)) |
1530 | goto out; | |
1da177e4 LT |
1531 | starget = scsi_alloc_target(&shost->shost_gendev, 0, shost->this_id); |
1532 | if (!starget) | |
e517d313 | 1533 | goto out; |
1da177e4 LT |
1534 | |
1535 | sdev = scsi_alloc_sdev(starget, 0, NULL); | |
1536 | if (sdev) { | |
1537 | sdev->sdev_gendev.parent = get_device(&starget->dev); | |
1538 | sdev->borken = 0; | |
1539 | } | |
1540 | put_device(&starget->dev); | |
e517d313 | 1541 | out: |
0b950672 | 1542 | mutex_unlock(&shost->scan_mutex); |
1da177e4 LT |
1543 | return sdev; |
1544 | } | |
1545 | EXPORT_SYMBOL(scsi_get_host_dev); | |
1546 | ||
1547 | /* | |
1548 | * Function: scsi_free_host_dev() | |
1549 | * | |
1550 | * Purpose: Free a scsi_device that points to the host adapter itself. | |
1551 | * | |
f64a181d | 1552 | * Arguments: SHpnt - Host that needs a scsi_device |
1da177e4 LT |
1553 | * |
1554 | * Lock status: None assumed. | |
1555 | * | |
1556 | * Returns: Nothing | |
1557 | * | |
1558 | * Notes: | |
1559 | */ | |
1560 | void scsi_free_host_dev(struct scsi_device *sdev) | |
1561 | { | |
1562 | BUG_ON(sdev->id != sdev->host->this_id); | |
1563 | ||
6f3a2024 | 1564 | scsi_destroy_sdev(sdev); |
1da177e4 LT |
1565 | } |
1566 | EXPORT_SYMBOL(scsi_free_host_dev); | |
1567 |