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