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