blob: 983aed10ff2f8d97c9d34254768ecd3ec819ab9b [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
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
Christoph Hellwigf64a1812005-10-31 18:32:08 +010012 * device attached, a scsi_device is allocated and setup for it.
Linus Torvalds1da177e2005-04-16 15:20:36 -070013 *
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
Christoph Hellwigf64a1812005-10-31 18:32:08 +010020 * scsi_device for it.
Linus Torvalds1da177e2005-04-16 15:20:36 -070021 *
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
Linus Torvalds1da177e2005-04-16 15:20:36 -070028#include <linux/module.h>
29#include <linux/moduleparam.h>
30#include <linux/init.h>
31#include <linux/blkdev.h>
Matthew Wilcox3e082a92006-09-28 15:19:20 -060032#include <linux/delay.h>
33#include <linux/kthread.h>
34#include <linux/spinlock.h>
Arjan van de Ven4ace92f2009-01-04 05:32:28 -080035#include <linux/async.h>
Tejun Heo5a0e3ad2010-03-24 17:04:11 +090036#include <linux/slab.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070037
38#include <scsi/scsi.h>
Christoph Hellwigbeb40482006-06-10 18:01:03 +020039#include <scsi/scsi_cmnd.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070040#include <scsi/scsi_device.h>
41#include <scsi/scsi_driver.h>
42#include <scsi/scsi_devinfo.h>
43#include <scsi/scsi_host.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070044#include <scsi/scsi_transport.h>
45#include <scsi/scsi_eh.h>
46
47#include "scsi_priv.h"
48#include "scsi_logging.h"
49
50#define ALLOC_FAILURE_MSG KERN_ERR "%s: Allocation failure during" \
51 " SCSI scanning, some SCSI devices might not be configured\n"
52
53/*
54 * Default timeout
55 */
56#define SCSI_TIMEOUT (2*HZ)
57
58/*
Robert P. J. Day405ae7d2007-02-17 19:13:42 +010059 * Prefix values for the SCSI id's (stored in sysfs name field)
Linus Torvalds1da177e2005-04-16 15:20:36 -070060 */
61#define SCSI_UID_SER_NUM 'S'
62#define SCSI_UID_UNKNOWN 'Z'
63
64/*
65 * Return values of some of the scanning functions.
66 *
67 * SCSI_SCAN_NO_RESPONSE: no valid response received from the target, this
68 * includes allocation or general failures preventing IO from being sent.
69 *
70 * SCSI_SCAN_TARGET_PRESENT: target responded, but no device is available
71 * on the given LUN.
72 *
73 * SCSI_SCAN_LUN_PRESENT: target responded, and a device is available on a
74 * given LUN.
75 */
76#define SCSI_SCAN_NO_RESPONSE 0
77#define SCSI_SCAN_TARGET_PRESENT 1
78#define SCSI_SCAN_LUN_PRESENT 2
79
Arjan van de Ven0ad78202005-11-28 16:22:25 +010080static const char *scsi_null_device_strs = "nullnullnullnull";
Linus Torvalds1da177e2005-04-16 15:20:36 -070081
82#define MAX_SCSI_LUNS 512
83
Hannes Reinecke1abf6352014-06-25 15:27:38 +020084static u64 max_scsi_luns = MAX_SCSI_LUNS;
Linus Torvalds1da177e2005-04-16 15:20:36 -070085
Hannes Reinecke1abf6352014-06-25 15:27:38 +020086module_param_named(max_luns, max_scsi_luns, ullong, S_IRUGO|S_IWUSR);
Linus Torvalds1da177e2005-04-16 15:20:36 -070087MODULE_PARM_DESC(max_luns,
Hannes Reinecke1abf6352014-06-25 15:27:38 +020088 "last scsi LUN (should be between 1 and 2^64-1)");
Linus Torvalds1da177e2005-04-16 15:20:36 -070089
Matthew Wilcox21db1882006-11-22 13:24:52 -070090#ifdef CONFIG_SCSI_SCAN_ASYNC
91#define SCSI_SCAN_TYPE_DEFAULT "async"
92#else
93#define SCSI_SCAN_TYPE_DEFAULT "sync"
94#endif
95
Dan Williams3c31b522014-04-10 15:30:35 -070096char scsi_scan_type[6] = SCSI_SCAN_TYPE_DEFAULT;
Matthew Wilcox3e082a92006-09-28 15:19:20 -060097
98module_param_string(scan, scsi_scan_type, sizeof(scsi_scan_type), S_IRUGO);
99MODULE_PARM_DESC(scan, "sync, async or none");
100
Linus Torvalds1da177e2005-04-16 15:20:36 -0700101/*
102 * max_scsi_report_luns: the maximum number of LUNS that will be
103 * returned from the REPORT LUNS command. 8 times this value must
104 * be allocated. In theory this could be up to an 8 byte value, but
105 * in practice, the maximum number of LUNs suppored by any device
106 * is about 16k.
107 */
108static unsigned int max_scsi_report_luns = 511;
109
Masatake YAMATO10f4b892007-09-19 22:59:16 +0900110module_param_named(max_report_luns, max_scsi_report_luns, uint, S_IRUGO|S_IWUSR);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700111MODULE_PARM_DESC(max_report_luns,
112 "REPORT LUNS maximum number of LUNS received (should be"
113 " between 1 and 16384)");
114
Alan Stern14faf122009-03-12 11:08:51 -0400115static unsigned int scsi_inq_timeout = SCSI_TIMEOUT/HZ + 18;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700116
Masatake YAMATO10f4b892007-09-19 22:59:16 +0900117module_param_named(inq_timeout, scsi_inq_timeout, uint, S_IRUGO|S_IWUSR);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700118MODULE_PARM_DESC(inq_timeout,
119 "Timeout (in seconds) waiting for devices to answer INQUIRY."
Alan Stern14faf122009-03-12 11:08:51 -0400120 " Default is 20. Some devices may need more; most need less.");
Linus Torvalds1da177e2005-04-16 15:20:36 -0700121
Matthew Wilcox6b7f1232007-06-26 15:18:51 -0600122/* This lock protects only this list */
Matthew Wilcox3e082a92006-09-28 15:19:20 -0600123static DEFINE_SPINLOCK(async_scan_lock);
124static LIST_HEAD(scanning_hosts);
125
126struct async_scan_data {
127 struct list_head list;
128 struct Scsi_Host *shost;
129 struct completion prev_finished;
130};
131
132/**
133 * scsi_complete_async_scans - Wait for asynchronous scans to complete
134 *
Matthew Wilcox8bcc2412006-12-07 19:29:27 -0700135 * When this function returns, any host which started scanning before
136 * this function was called will have finished its scan. Hosts which
137 * started scanning after this function was called may or may not have
138 * finished.
Matthew Wilcox3e082a92006-09-28 15:19:20 -0600139 */
140int scsi_complete_async_scans(void)
141{
142 struct async_scan_data *data;
143
144 do {
145 if (list_empty(&scanning_hosts))
Dan Williamse96eb232012-07-09 19:33:45 -0700146 return 0;
Matthew Wilcox3e082a92006-09-28 15:19:20 -0600147 /* If we can't get memory immediately, that's OK. Just
148 * sleep a little. Even if we never get memory, the async
149 * scans will finish eventually.
150 */
151 data = kmalloc(sizeof(*data), GFP_KERNEL);
152 if (!data)
153 msleep(1);
154 } while (!data);
155
156 data->shost = NULL;
157 init_completion(&data->prev_finished);
158
159 spin_lock(&async_scan_lock);
160 /* Check that there's still somebody else on the list */
161 if (list_empty(&scanning_hosts))
162 goto done;
163 list_add_tail(&data->list, &scanning_hosts);
164 spin_unlock(&async_scan_lock);
165
166 printk(KERN_INFO "scsi: waiting for bus probes to complete ...\n");
167 wait_for_completion(&data->prev_finished);
168
169 spin_lock(&async_scan_lock);
170 list_del(&data->list);
Matthew Wilcox8bcc2412006-12-07 19:29:27 -0700171 if (!list_empty(&scanning_hosts)) {
172 struct async_scan_data *next = list_entry(scanning_hosts.next,
173 struct async_scan_data, list);
174 complete(&next->prev_finished);
175 }
Matthew Wilcox3e082a92006-09-28 15:19:20 -0600176 done:
177 spin_unlock(&async_scan_lock);
Dan Williamse96eb232012-07-09 19:33:45 -0700178
Matthew Wilcox3e082a92006-09-28 15:19:20 -0600179 kfree(data);
180 return 0;
181}
182
Linus Torvalds1da177e2005-04-16 15:20:36 -0700183/**
184 * scsi_unlock_floptical - unlock device via a special MODE SENSE command
James Bottomley39216032005-06-15 18:48:29 -0500185 * @sdev: scsi device to send command to
Linus Torvalds1da177e2005-04-16 15:20:36 -0700186 * @result: area to store the result of the MODE SENSE
187 *
188 * Description:
James Bottomley39216032005-06-15 18:48:29 -0500189 * Send a vendor specific MODE SENSE (not a MODE SELECT) command.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700190 * Called for BLIST_KEY devices.
191 **/
James Bottomley39216032005-06-15 18:48:29 -0500192static void scsi_unlock_floptical(struct scsi_device *sdev,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700193 unsigned char *result)
194{
195 unsigned char scsi_cmd[MAX_COMMAND_SIZE];
196
Hannes Reinecke91921e02014-06-25 16:39:59 +0200197 sdev_printk(KERN_NOTICE, sdev, "unlocking floptical drive\n");
Linus Torvalds1da177e2005-04-16 15:20:36 -0700198 scsi_cmd[0] = MODE_SENSE;
199 scsi_cmd[1] = 0;
200 scsi_cmd[2] = 0x2e;
201 scsi_cmd[3] = 0;
James Bottomley39216032005-06-15 18:48:29 -0500202 scsi_cmd[4] = 0x2a; /* size */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700203 scsi_cmd[5] = 0;
James Bottomley39216032005-06-15 18:48:29 -0500204 scsi_execute_req(sdev, scsi_cmd, DMA_FROM_DEVICE, result, 0x2a, NULL,
FUJITA Tomonorif4f4e472008-12-04 14:24:39 +0900205 SCSI_TIMEOUT, 3, NULL);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700206}
207
208/**
Linus Torvalds1da177e2005-04-16 15:20:36 -0700209 * scsi_alloc_sdev - allocate and setup a scsi_Device
Rob Landleyeb448202007-11-03 13:30:39 -0500210 * @starget: which target to allocate a &scsi_device for
211 * @lun: which lun
212 * @hostdata: usually NULL and set by ->slave_alloc instead
Linus Torvalds1da177e2005-04-16 15:20:36 -0700213 *
214 * Description:
215 * Allocate, initialize for io, and return a pointer to a scsi_Device.
216 * Stores the @shost, @channel, @id, and @lun in the scsi_Device, and
217 * adds scsi_Device to the appropriate list.
218 *
219 * Return value:
220 * scsi_Device pointer, or NULL on failure.
221 **/
222static struct scsi_device *scsi_alloc_sdev(struct scsi_target *starget,
Hannes Reinecke9cb78c12014-06-25 15:27:36 +0200223 u64 lun, void *hostdata)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700224{
225 struct scsi_device *sdev;
226 int display_failure_msg = 1, ret;
227 struct Scsi_Host *shost = dev_to_shost(starget->dev.parent);
Jeff Garzika341cd02007-10-29 17:15:22 -0400228 extern void scsi_evt_thread(struct work_struct *work);
Jens Axboe9937a5e2011-05-17 11:04:44 +0200229 extern void scsi_requeue_run_queue(struct work_struct *work);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700230
Jes Sorensen24669f752006-01-16 10:31:18 -0500231 sdev = kzalloc(sizeof(*sdev) + shost->transportt->device_size,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700232 GFP_ATOMIC);
233 if (!sdev)
234 goto out;
235
Linus Torvalds1da177e2005-04-16 15:20:36 -0700236 sdev->vendor = scsi_null_device_strs;
237 sdev->model = scsi_null_device_strs;
238 sdev->rev = scsi_null_device_strs;
239 sdev->host = shost;
Vasu Dev4a840672009-10-22 15:46:33 -0700240 sdev->queue_ramp_up_period = SCSI_DEFAULT_RAMP_UP_PERIOD;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700241 sdev->id = starget->id;
242 sdev->lun = lun;
243 sdev->channel = starget->channel;
244 sdev->sdev_state = SDEV_CREATED;
245 INIT_LIST_HEAD(&sdev->siblings);
246 INIT_LIST_HEAD(&sdev->same_target_siblings);
247 INIT_LIST_HEAD(&sdev->cmd_list);
248 INIT_LIST_HEAD(&sdev->starved_entry);
Jeff Garzika341cd02007-10-29 17:15:22 -0400249 INIT_LIST_HEAD(&sdev->event_list);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700250 spin_lock_init(&sdev->list_lock);
Jeff Garzika341cd02007-10-29 17:15:22 -0400251 INIT_WORK(&sdev->event_work, scsi_evt_thread);
Jens Axboe9937a5e2011-05-17 11:04:44 +0200252 INIT_WORK(&sdev->requeue_work, scsi_requeue_run_queue);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700253
254 sdev->sdev_gendev.parent = get_device(&starget->dev);
255 sdev->sdev_target = starget;
256
257 /* usually NULL and set by ->slave_alloc instead */
258 sdev->hostdata = hostdata;
259
260 /* if the device needs this changing, it may do so in the
261 * slave_configure function */
262 sdev->max_device_blocked = SCSI_DEFAULT_DEVICE_BLOCKED;
263
264 /*
265 * Some low level driver could use device->type
266 */
267 sdev->type = -1;
268
269 /*
270 * Assume that the device will have handshaking problems,
271 * and then fix this field later if it turns out it
272 * doesn't
273 */
274 sdev->borken = 1;
275
Christoph Hellwigd2852032014-01-17 12:06:53 +0100276 if (shost_use_blk_mq(shost))
277 sdev->request_queue = scsi_mq_alloc_queue(sdev);
278 else
279 sdev->request_queue = scsi_alloc_queue(sdev);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700280 if (!sdev->request_queue) {
281 /* release fn is set up in scsi_sysfs_device_initialise, so
282 * have to free and put manually here */
283 put_device(&starget->dev);
Dave Jones93f560892006-03-09 10:21:27 -0500284 kfree(sdev);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700285 goto out;
286 }
Tejun Heo09ac46c2011-12-14 00:33:38 +0100287 WARN_ON_ONCE(!blk_get_queue(sdev->request_queue));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700288 sdev->request_queue->queuedata = sdev;
Christoph Hellwig2ecb2042014-11-03 14:09:02 +0100289
290 if (!shost_use_blk_mq(sdev->host) &&
291 (shost->bqt || shost->hostt->use_blk_tags)) {
292 blk_queue_init_tags(sdev->request_queue,
293 sdev->host->cmd_per_lun, shost->bqt);
294 }
Christoph Hellwigdb5ed4d2014-11-13 15:08:42 +0100295 scsi_change_queue_depth(sdev, sdev->host->cmd_per_lun);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700296
297 scsi_sysfs_device_initialize(sdev);
298
299 if (shost->hostt->slave_alloc) {
300 ret = shost->hostt->slave_alloc(sdev);
301 if (ret) {
302 /*
303 * if LLDD reports slave not present, don't clutter
304 * console with alloc failure messages
Linus Torvalds1da177e2005-04-16 15:20:36 -0700305 */
306 if (ret == -ENXIO)
307 display_failure_msg = 0;
308 goto out_device_destroy;
309 }
310 }
311
312 return sdev;
313
314out_device_destroy:
James Bottomley4e6c82b2011-11-07 08:51:24 -0600315 __scsi_remove_device(sdev);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700316out:
317 if (display_failure_msg)
Harvey Harrisoncadbd4a2008-07-03 23:47:27 -0700318 printk(ALLOC_FAILURE_MSG, __func__);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700319 return NULL;
320}
321
James Bottomley643eb2d2008-03-22 22:42:27 -0500322static void scsi_target_destroy(struct scsi_target *starget)
323{
324 struct device *dev = &starget->dev;
325 struct Scsi_Host *shost = dev_to_shost(dev->parent);
326 unsigned long flags;
327
James Bottomleyf2495e22014-01-21 07:01:41 -0800328 starget->state = STARGET_DEL;
James Bottomley643eb2d2008-03-22 22:42:27 -0500329 transport_destroy_device(dev);
330 spin_lock_irqsave(shost->host_lock, flags);
331 if (shost->hostt->target_destroy)
332 shost->hostt->target_destroy(starget);
333 list_del_init(&starget->siblings);
334 spin_unlock_irqrestore(shost->host_lock, flags);
335 put_device(dev);
336}
337
Linus Torvalds1da177e2005-04-16 15:20:36 -0700338static void scsi_target_dev_release(struct device *dev)
339{
340 struct device *parent = dev->parent;
341 struct scsi_target *starget = to_scsi_target(dev);
James Bottomleya283bd32005-05-24 12:06:38 -0500342
Linus Torvalds1da177e2005-04-16 15:20:36 -0700343 kfree(starget);
344 put_device(parent);
345}
346
Adrian Bunk453cd0f2008-07-03 23:47:33 -0700347static struct device_type scsi_target_type = {
Hannes Reineckeb0ed4332008-03-18 14:32:28 +0100348 .name = "scsi_target",
349 .release = scsi_target_dev_release,
350};
351
Linus Torvalds1da177e2005-04-16 15:20:36 -0700352int scsi_is_target_device(const struct device *dev)
353{
Hannes Reineckeb0ed4332008-03-18 14:32:28 +0100354 return dev->type == &scsi_target_type;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700355}
356EXPORT_SYMBOL(scsi_is_target_device);
357
358static struct scsi_target *__scsi_find_target(struct device *parent,
359 int channel, uint id)
360{
361 struct scsi_target *starget, *found_starget = NULL;
362 struct Scsi_Host *shost = dev_to_shost(parent);
363 /*
364 * Search for an existing target for this sdev.
365 */
366 list_for_each_entry(starget, &shost->__targets, siblings) {
367 if (starget->id == id &&
368 starget->channel == channel) {
369 found_starget = starget;
370 break;
371 }
372 }
373 if (found_starget)
374 get_device(&found_starget->dev);
375
376 return found_starget;
377}
378
James Bottomley884d25c2006-09-05 16:26:41 -0500379/**
James Bottomleye63ed0d2014-01-21 07:00:50 -0800380 * scsi_target_reap_ref_release - remove target from visibility
381 * @kref: the reap_ref in the target being released
382 *
383 * Called on last put of reap_ref, which is the indication that no device
384 * under this target is visible anymore, so render the target invisible in
385 * sysfs. Note: we have to be in user context here because the target reaps
386 * should be done in places where the scsi device visibility is being removed.
387 */
388static void scsi_target_reap_ref_release(struct kref *kref)
389{
390 struct scsi_target *starget
391 = container_of(kref, struct scsi_target, reap_ref);
392
James Bottomleyf2495e22014-01-21 07:01:41 -0800393 /*
394 * if we get here and the target is still in the CREATED state that
395 * means it was allocated but never made visible (because a scan
396 * turned up no LUNs), so don't call device_del() on it.
397 */
398 if (starget->state != STARGET_CREATED) {
399 transport_remove_device(&starget->dev);
400 device_del(&starget->dev);
401 }
James Bottomleye63ed0d2014-01-21 07:00:50 -0800402 scsi_target_destroy(starget);
403}
404
405static void scsi_target_reap_ref_put(struct scsi_target *starget)
406{
407 kref_put(&starget->reap_ref, scsi_target_reap_ref_release);
408}
409
410/**
James Bottomley884d25c2006-09-05 16:26:41 -0500411 * scsi_alloc_target - allocate a new or find an existing target
412 * @parent: parent of the target (need not be a scsi host)
413 * @channel: target channel number (zero if no channels)
414 * @id: target id number
415 *
416 * Return an existing target if one exists, provided it hasn't already
417 * gone into STARGET_DEL state, otherwise allocate a new target.
418 *
419 * The target is returned with an incremented reference, so the caller
420 * is responsible for both reaping and doing a last put
421 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700422static struct scsi_target *scsi_alloc_target(struct device *parent,
423 int channel, uint id)
424{
425 struct Scsi_Host *shost = dev_to_shost(parent);
426 struct device *dev = NULL;
427 unsigned long flags;
428 const int size = sizeof(struct scsi_target)
429 + shost->transportt->target_size;
James.Smart@Emulex.Com5c44cd22005-06-10 22:24:30 -0400430 struct scsi_target *starget;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700431 struct scsi_target *found_target;
James Bottomleye63ed0d2014-01-21 07:00:50 -0800432 int error, ref_got;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700433
Jes Sorensen24669f752006-01-16 10:31:18 -0500434 starget = kzalloc(size, GFP_KERNEL);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700435 if (!starget) {
Harvey Harrisoncadbd4a2008-07-03 23:47:27 -0700436 printk(KERN_ERR "%s: allocation failure\n", __func__);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700437 return NULL;
438 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700439 dev = &starget->dev;
440 device_initialize(dev);
James Bottomleye63ed0d2014-01-21 07:00:50 -0800441 kref_init(&starget->reap_ref);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700442 dev->parent = get_device(parent);
Kay Sievers71610f52008-12-03 22:41:36 +0100443 dev_set_name(dev, "target%d:%d:%d", shost->host_no, channel, id);
Hannes Reineckeb0ed4332008-03-18 14:32:28 +0100444 dev->bus = &scsi_bus_type;
Hannes Reineckeb0ed4332008-03-18 14:32:28 +0100445 dev->type = &scsi_target_type;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700446 starget->id = id;
447 starget->channel = channel;
Mike Christief0c0a372008-08-17 15:24:38 -0500448 starget->can_queue = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700449 INIT_LIST_HEAD(&starget->siblings);
450 INIT_LIST_HEAD(&starget->devices);
James Bottomley643eb2d2008-03-22 22:42:27 -0500451 starget->state = STARGET_CREATED;
Alan Stern7c9d6f12007-01-08 11:12:32 -0500452 starget->scsi_level = SCSI_2;
Edward Gogginc53a2842009-04-09 10:02:22 -0700453 starget->max_target_blocked = SCSI_DEFAULT_TARGET_BLOCKED;
James Bottomleyffedb452006-02-23 14:27:18 -0600454 retry:
Linus Torvalds1da177e2005-04-16 15:20:36 -0700455 spin_lock_irqsave(shost->host_lock, flags);
456
457 found_target = __scsi_find_target(parent, channel, id);
458 if (found_target)
459 goto found;
460
461 list_add_tail(&starget->siblings, &shost->__targets);
462 spin_unlock_irqrestore(shost->host_lock, flags);
463 /* allocate and add */
James Bottomleya283bd32005-05-24 12:06:38 -0500464 transport_setup_device(dev);
James Bottomleya283bd32005-05-24 12:06:38 -0500465 if (shost->hostt->target_alloc) {
Brian King32f95792006-02-22 14:28:24 -0600466 error = shost->hostt->target_alloc(starget);
James Bottomleya283bd32005-05-24 12:06:38 -0500467
468 if(error) {
469 dev_printk(KERN_ERR, dev, "target allocation failed, error %d\n", error);
470 /* don't want scsi_target_reap to do the final
471 * put because it will be under the host lock */
James Bottomley643eb2d2008-03-22 22:42:27 -0500472 scsi_target_destroy(starget);
James Bottomleya283bd32005-05-24 12:06:38 -0500473 return NULL;
474 }
475 }
James Bottomley884d25c2006-09-05 16:26:41 -0500476 get_device(dev);
James Bottomleya283bd32005-05-24 12:06:38 -0500477
Linus Torvalds1da177e2005-04-16 15:20:36 -0700478 return starget;
479
480 found:
James Bottomleye63ed0d2014-01-21 07:00:50 -0800481 /*
482 * release routine already fired if kref is zero, so if we can still
483 * take the reference, the target must be alive. If we can't, it must
484 * be dying and we need to wait for a new target
485 */
486 ref_got = kref_get_unless_zero(&found_target->reap_ref);
487
Linus Torvalds1da177e2005-04-16 15:20:36 -0700488 spin_unlock_irqrestore(shost->host_lock, flags);
James Bottomleye63ed0d2014-01-21 07:00:50 -0800489 if (ref_got) {
Alan Stern12fb8c12010-03-18 15:41:22 -0400490 put_device(dev);
James Bottomleyffedb452006-02-23 14:27:18 -0600491 return found_target;
492 }
James Bottomleye63ed0d2014-01-21 07:00:50 -0800493 /*
494 * Unfortunately, we found a dying target; need to wait until it's
495 * dead before we can get a new one. There is an anomaly here. We
496 * *should* call scsi_target_reap() to balance the kref_get() of the
497 * reap_ref above. However, since the target being released, it's
498 * already invisible and the reap_ref is irrelevant. If we call
499 * scsi_target_reap() we might spuriously do another device_del() on
500 * an already invisible target.
501 */
James Bottomleyffedb452006-02-23 14:27:18 -0600502 put_device(&found_target->dev);
James Bottomleye63ed0d2014-01-21 07:00:50 -0800503 /*
504 * length of time is irrelevant here, we just want to yield the CPU
505 * for a tick to avoid busy waiting for the target to die.
506 */
507 msleep(1);
James Bottomleyffedb452006-02-23 14:27:18 -0600508 goto retry;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700509}
510
511/**
512 * scsi_target_reap - check to see if target is in use and destroy if not
Linus Torvalds1da177e2005-04-16 15:20:36 -0700513 * @starget: target to be checked
514 *
515 * This is used after removing a LUN or doing a last put of the target
516 * it checks atomically that nothing is using the target and removes
517 * it if so.
518 */
519void scsi_target_reap(struct scsi_target *starget)
520{
James Bottomleyf2495e22014-01-21 07:01:41 -0800521 /*
522 * serious problem if this triggers: STARGET_DEL is only set in the if
523 * the reap_ref drops to zero, so we're trying to do another final put
524 * on an already released kref
525 */
James Bottomleye63ed0d2014-01-21 07:00:50 -0800526 BUG_ON(starget->state == STARGET_DEL);
James Bottomleyf2495e22014-01-21 07:01:41 -0800527 scsi_target_reap_ref_put(starget);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700528}
529
530/**
Alan Sterne5b3cd42006-08-21 15:53:25 -0400531 * sanitize_inquiry_string - remove non-graphical chars from an INQUIRY result string
532 * @s: INQUIRY result string to sanitize
533 * @len: length of the string
534 *
535 * Description:
536 * The SCSI spec says that INQUIRY vendor, product, and revision
537 * strings must consist entirely of graphic ASCII characters,
538 * padded on the right with spaces. Since not all devices obey
539 * this rule, we will replace non-graphic or non-ASCII characters
540 * with spaces. Exception: a NUL character is interpreted as a
541 * string terminator, so all the following characters are set to
542 * spaces.
543 **/
544static void sanitize_inquiry_string(unsigned char *s, int len)
545{
546 int terminated = 0;
547
548 for (; len > 0; (--len, ++s)) {
549 if (*s == 0)
550 terminated = 1;
551 if (terminated || *s < 0x20 || *s > 0x7e)
552 *s = ' ';
553 }
554}
555
556/**
Linus Torvalds1da177e2005-04-16 15:20:36 -0700557 * scsi_probe_lun - probe a single LUN using a SCSI INQUIRY
James Bottomley39216032005-06-15 18:48:29 -0500558 * @sdev: scsi_device to probe
Linus Torvalds1da177e2005-04-16 15:20:36 -0700559 * @inq_result: area to store the INQUIRY result
James Bottomley39216032005-06-15 18:48:29 -0500560 * @result_len: len of inq_result
Linus Torvalds1da177e2005-04-16 15:20:36 -0700561 * @bflags: store any bflags found here
562 *
563 * Description:
James Bottomley39216032005-06-15 18:48:29 -0500564 * Probe the lun associated with @req using a standard SCSI INQUIRY;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700565 *
James Bottomley39216032005-06-15 18:48:29 -0500566 * If the INQUIRY is successful, zero is returned and the
Linus Torvalds1da177e2005-04-16 15:20:36 -0700567 * INQUIRY data is in @inq_result; the scsi_level and INQUIRY length
Christoph Hellwigf64a1812005-10-31 18:32:08 +0100568 * are copied to the scsi_device any flags value is stored in *@bflags.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700569 **/
Alan Sterne5b3cd42006-08-21 15:53:25 -0400570static int scsi_probe_lun(struct scsi_device *sdev, unsigned char *inq_result,
James Bottomley39216032005-06-15 18:48:29 -0500571 int result_len, int *bflags)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700572{
Linus Torvalds1da177e2005-04-16 15:20:36 -0700573 unsigned char scsi_cmd[MAX_COMMAND_SIZE];
574 int first_inquiry_len, try_inquiry_len, next_inquiry_len;
575 int response_len = 0;
James Bottomley39216032005-06-15 18:48:29 -0500576 int pass, count, result;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700577 struct scsi_sense_hdr sshdr;
578
579 *bflags = 0;
580
581 /* Perform up to 3 passes. The first pass uses a conservative
582 * transfer length of 36 unless sdev->inquiry_len specifies a
583 * different value. */
584 first_inquiry_len = sdev->inquiry_len ? sdev->inquiry_len : 36;
585 try_inquiry_len = first_inquiry_len;
586 pass = 1;
587
588 next_pass:
James Bottomley9ccfc752005-10-02 11:45:08 -0500589 SCSI_LOG_SCAN_BUS(3, sdev_printk(KERN_INFO, sdev,
590 "scsi scan: INQUIRY pass %d length %d\n",
591 pass, try_inquiry_len));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700592
593 /* Each pass gets up to three chances to ignore Unit Attention */
594 for (count = 0; count < 3; ++count) {
FUJITA Tomonori5cd3bbf2008-12-05 11:21:46 +0900595 int resid;
596
Linus Torvalds1da177e2005-04-16 15:20:36 -0700597 memset(scsi_cmd, 0, 6);
598 scsi_cmd[0] = INQUIRY;
599 scsi_cmd[4] = (unsigned char) try_inquiry_len;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700600
601 memset(inq_result, 0, try_inquiry_len);
James Bottomley39216032005-06-15 18:48:29 -0500602
603 result = scsi_execute_req(sdev, scsi_cmd, DMA_FROM_DEVICE,
James Bottomleyea73a9f2005-08-28 11:33:52 -0500604 inq_result, try_inquiry_len, &sshdr,
FUJITA Tomonorif4f4e472008-12-04 14:24:39 +0900605 HZ / 2 + HZ * scsi_inq_timeout, 3,
FUJITA Tomonori5cd3bbf2008-12-05 11:21:46 +0900606 &resid);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700607
Hannes Reinecke91921e02014-06-25 16:39:59 +0200608 SCSI_LOG_SCAN_BUS(3, sdev_printk(KERN_INFO, sdev,
609 "scsi scan: INQUIRY %s with code 0x%x\n",
James Bottomley39216032005-06-15 18:48:29 -0500610 result ? "failed" : "successful", result));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700611
James Bottomley39216032005-06-15 18:48:29 -0500612 if (result) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700613 /*
614 * not-ready to ready transition [asc/ascq=0x28/0x0]
615 * or power-on, reset [asc/ascq=0x29/0x0], continue.
616 * INQUIRY should not yield UNIT_ATTENTION
617 * but many buggy devices do so anyway.
618 */
James Bottomley39216032005-06-15 18:48:29 -0500619 if ((driver_byte(result) & DRIVER_SENSE) &&
James Bottomleyea73a9f2005-08-28 11:33:52 -0500620 scsi_sense_valid(&sshdr)) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700621 if ((sshdr.sense_key == UNIT_ATTENTION) &&
622 ((sshdr.asc == 0x28) ||
623 (sshdr.asc == 0x29)) &&
624 (sshdr.ascq == 0))
625 continue;
626 }
FUJITA Tomonori5cd3bbf2008-12-05 11:21:46 +0900627 } else {
628 /*
629 * if nothing was transferred, we try
630 * again. It's a workaround for some USB
631 * devices.
632 */
633 if (resid == try_inquiry_len)
634 continue;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700635 }
636 break;
637 }
638
James Bottomley39216032005-06-15 18:48:29 -0500639 if (result == 0) {
Alan Sterne5b3cd42006-08-21 15:53:25 -0400640 sanitize_inquiry_string(&inq_result[8], 8);
641 sanitize_inquiry_string(&inq_result[16], 16);
642 sanitize_inquiry_string(&inq_result[32], 4);
643
644 response_len = inq_result[4] + 5;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700645 if (response_len > 255)
646 response_len = first_inquiry_len; /* sanity */
647
648 /*
649 * Get any flags for this device.
650 *
Christoph Hellwigf64a1812005-10-31 18:32:08 +0100651 * XXX add a bflags to scsi_device, and replace the
652 * corresponding bit fields in scsi_device, so bflags
Linus Torvalds1da177e2005-04-16 15:20:36 -0700653 * need not be passed as an argument.
654 */
655 *bflags = scsi_get_device_flags(sdev, &inq_result[8],
656 &inq_result[16]);
657
658 /* When the first pass succeeds we gain information about
659 * what larger transfer lengths might work. */
660 if (pass == 1) {
661 if (BLIST_INQUIRY_36 & *bflags)
662 next_inquiry_len = 36;
663 else if (BLIST_INQUIRY_58 & *bflags)
664 next_inquiry_len = 58;
665 else if (sdev->inquiry_len)
666 next_inquiry_len = sdev->inquiry_len;
667 else
668 next_inquiry_len = response_len;
669
670 /* If more data is available perform the second pass */
671 if (next_inquiry_len > try_inquiry_len) {
672 try_inquiry_len = next_inquiry_len;
673 pass = 2;
674 goto next_pass;
675 }
676 }
677
678 } else if (pass == 2) {
Hannes Reinecke91921e02014-06-25 16:39:59 +0200679 sdev_printk(KERN_INFO, sdev,
680 "scsi scan: %d byte inquiry failed. "
681 "Consider BLIST_INQUIRY_36 for this device\n",
682 try_inquiry_len);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700683
684 /* If this pass failed, the third pass goes back and transfers
685 * the same amount as we successfully got in the first pass. */
686 try_inquiry_len = first_inquiry_len;
687 pass = 3;
688 goto next_pass;
689 }
690
691 /* If the last transfer attempt got an error, assume the
692 * peripheral doesn't exist or is dead. */
James Bottomley39216032005-06-15 18:48:29 -0500693 if (result)
694 return -EIO;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700695
696 /* Don't report any more data than the device says is valid */
697 sdev->inquiry_len = min(try_inquiry_len, response_len);
698
699 /*
700 * XXX Abort if the response length is less than 36? If less than
701 * 32, the lookup of the device flags (above) could be invalid,
702 * and it would be possible to take an incorrect action - we do
703 * not want to hang because of a short INQUIRY. On the flip side,
704 * if the device is spun down or becoming ready (and so it gives a
705 * short INQUIRY), an abort here prevents any further use of the
706 * device, including spin up.
707 *
Alan Sterne423ee32007-02-16 01:46:38 -0800708 * On the whole, the best approach seems to be to assume the first
709 * 36 bytes are valid no matter what the device says. That's
710 * better than copying < 36 bytes to the inquiry-result buffer
711 * and displaying garbage for the Vendor, Product, or Revision
712 * strings.
713 */
714 if (sdev->inquiry_len < 36) {
Hannes Reinecke91921e02014-06-25 16:39:59 +0200715 sdev_printk(KERN_INFO, sdev,
716 "scsi scan: INQUIRY result too short (%d),"
717 " using 36\n", sdev->inquiry_len);
Alan Sterne423ee32007-02-16 01:46:38 -0800718 sdev->inquiry_len = 36;
719 }
720
721 /*
Linus Torvalds1da177e2005-04-16 15:20:36 -0700722 * Related to the above issue:
723 *
724 * XXX Devices (disk or all?) should be sent a TEST UNIT READY,
725 * and if not ready, sent a START_STOP to start (maybe spin up) and
726 * then send the INQUIRY again, since the INQUIRY can change after
727 * a device is initialized.
728 *
729 * Ideally, start a device if explicitly asked to do so. This
730 * assumes that a device is spun up on power on, spun down on
731 * request, and then spun up on request.
732 */
733
734 /*
735 * The scanning code needs to know the scsi_level, even if no
736 * device is attached at LUN 0 (SCSI_SCAN_TARGET_PRESENT) so
737 * non-zero LUNs can be scanned.
738 */
739 sdev->scsi_level = inq_result[2] & 0x07;
740 if (sdev->scsi_level >= 2 ||
741 (sdev->scsi_level == 1 && (inq_result[3] & 0x0f) == 1))
742 sdev->scsi_level++;
James Bottomley6f3a2022005-09-22 20:33:28 -0500743 sdev->sdev_target->scsi_level = sdev->scsi_level;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700744
Alan Stern50c4e962014-09-02 11:35:50 -0400745 /*
746 * If SCSI-2 or lower, and if the transport requires it,
747 * store the LUN value in CDB[1].
748 */
749 sdev->lun_in_cdb = 0;
750 if (sdev->scsi_level <= SCSI_2 &&
751 sdev->scsi_level != SCSI_UNKNOWN &&
752 !sdev->host->no_scsi2_lun_in_cdb)
753 sdev->lun_in_cdb = 1;
754
James Bottomley39216032005-06-15 18:48:29 -0500755 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700756}
757
758/**
Christoph Hellwigf64a1812005-10-31 18:32:08 +0100759 * scsi_add_lun - allocate and fully initialze a scsi_device
Matthew Wilcox6d877682007-07-11 12:54:55 -0600760 * @sdev: holds information to be stored in the new scsi_device
Linus Torvalds1da177e2005-04-16 15:20:36 -0700761 * @inq_result: holds the result of a previous INQUIRY to the LUN
762 * @bflags: black/white list flag
Matthew Wilcox6d877682007-07-11 12:54:55 -0600763 * @async: 1 if this device is being scanned asynchronously
Linus Torvalds1da177e2005-04-16 15:20:36 -0700764 *
765 * Description:
Matthew Wilcox6d877682007-07-11 12:54:55 -0600766 * Initialize the scsi_device @sdev. Optionally set fields based
767 * on values in *@bflags.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700768 *
769 * Return:
Christoph Hellwigf64a1812005-10-31 18:32:08 +0100770 * SCSI_SCAN_NO_RESPONSE: could not allocate or setup a scsi_device
771 * SCSI_SCAN_LUN_PRESENT: a new scsi_device was allocated and initialized
Linus Torvalds1da177e2005-04-16 15:20:36 -0700772 **/
Alan Sterne5b3cd42006-08-21 15:53:25 -0400773static int scsi_add_lun(struct scsi_device *sdev, unsigned char *inq_result,
Matthew Wilcox3e082a92006-09-28 15:19:20 -0600774 int *bflags, int async)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700775{
James Bottomley6f4267e2008-08-22 16:53:31 -0500776 int ret;
777
Linus Torvalds1da177e2005-04-16 15:20:36 -0700778 /*
779 * XXX do not save the inquiry, since it can change underneath us,
780 * save just vendor/model/rev.
781 *
782 * Rather than save it and have an ioctl that retrieves the saved
783 * value, have an ioctl that executes the same INQUIRY code used
784 * in scsi_probe_lun, let user level programs doing INQUIRY
785 * scanning run at their own risk, or supply a user level program
786 * that can correctly scan.
787 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700788
Alan Stern09123d22006-11-10 12:27:57 -0800789 /*
790 * Copy at least 36 bytes of INQUIRY data, so that we don't
791 * dereference unallocated memory when accessing the Vendor,
792 * Product, and Revision strings. Badly behaved devices may set
793 * the INQUIRY Additional Length byte to a small value, indicating
794 * these strings are invalid, but often they contain plausible data
795 * nonetheless. It doesn't matter if the device sent < 36 bytes
796 * total, since scsi_probe_lun() initializes inq_result with 0s.
797 */
798 sdev->inquiry = kmemdup(inq_result,
799 max_t(size_t, sdev->inquiry_len, 36),
800 GFP_ATOMIC);
801 if (sdev->inquiry == NULL)
802 return SCSI_SCAN_NO_RESPONSE;
803
Linus Torvalds1da177e2005-04-16 15:20:36 -0700804 sdev->vendor = (char *) (sdev->inquiry + 8);
805 sdev->model = (char *) (sdev->inquiry + 16);
806 sdev->rev = (char *) (sdev->inquiry + 32);
807
James Bottomley14216562012-07-25 23:55:55 +0400808 if (strncmp(sdev->vendor, "ATA ", 8) == 0) {
809 /*
810 * sata emulation layer device. This is a hack to work around
811 * the SATL power management specifications which state that
812 * when the SATL detects the device has gone into standby
813 * mode, it shall respond with NOT READY.
814 */
815 sdev->allow_restart = 1;
816 }
817
Linus Torvalds1da177e2005-04-16 15:20:36 -0700818 if (*bflags & BLIST_ISROM) {
Matthew Wilcox6d877682007-07-11 12:54:55 -0600819 sdev->type = TYPE_ROM;
820 sdev->removable = 1;
821 } else {
822 sdev->type = (inq_result[0] & 0x1f);
823 sdev->removable = (inq_result[1] & 0x80) >> 7;
Subhash Jadavani45341ca2014-09-25 15:32:19 +0300824
825 /*
826 * some devices may respond with wrong type for
827 * well-known logical units. Force well-known type
828 * to enumerate them correctly.
829 */
830 if (scsi_is_wlun(sdev->lun) && sdev->type != TYPE_WLUN) {
831 sdev_printk(KERN_WARNING, sdev,
832 "%s: correcting incorrect peripheral device type 0x%x for W-LUN 0x%16xhN\n",
833 __func__, sdev->type, (unsigned int)sdev->lun);
834 sdev->type = TYPE_WLUN;
835 }
836
Matthew Wilcox6d877682007-07-11 12:54:55 -0600837 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700838
Matthew Wilcox6d877682007-07-11 12:54:55 -0600839 if (sdev->type == TYPE_RBC || sdev->type == TYPE_ROM) {
840 /* RBC and MMC devices can return SCSI-3 compliance and yet
841 * still not support REPORT LUNS, so make them act as
842 * BLIST_NOREPORTLUN unless BLIST_REPORTLUN2 is
843 * specifically set */
844 if ((*bflags & BLIST_REPORTLUN2) == 0)
845 *bflags |= BLIST_NOREPORTLUN;
846 }
847
Linus Torvalds1da177e2005-04-16 15:20:36 -0700848 /*
849 * For a peripheral qualifier (PQ) value of 1 (001b), the SCSI
850 * spec says: The device server is capable of supporting the
851 * specified peripheral device type on this logical unit. However,
852 * the physical device is not currently connected to this logical
853 * unit.
854 *
855 * The above is vague, as it implies that we could treat 001 and
856 * 011 the same. Stay compatible with previous code, and create a
Christoph Hellwigf64a1812005-10-31 18:32:08 +0100857 * scsi_device for a PQ of 1
Linus Torvalds1da177e2005-04-16 15:20:36 -0700858 *
859 * Don't set the device offline here; rather let the upper
860 * level drivers eval the PQ to decide whether they should
861 * attach. So remove ((inq_result[0] >> 5) & 7) == 1 check.
862 */
863
864 sdev->inq_periph_qual = (inq_result[0] >> 5) & 7;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700865 sdev->lockable = sdev->removable;
866 sdev->soft_reset = (inq_result[7] & 1) && ((inq_result[3] & 7) == 2);
867
Matthew Wilcox6d877682007-07-11 12:54:55 -0600868 if (sdev->scsi_level >= SCSI_3 ||
869 (sdev->inquiry_len > 56 && inq_result[56] & 0x04))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700870 sdev->ppr = 1;
871 if (inq_result[7] & 0x60)
872 sdev->wdtr = 1;
873 if (inq_result[7] & 0x10)
874 sdev->sdtr = 1;
875
James Bottomley19ac0db2006-08-06 18:15:22 -0500876 sdev_printk(KERN_NOTICE, sdev, "%s %.8s %.16s %.4s PQ: %d "
Matthew Wilcox4ff36712006-07-04 12:15:20 -0600877 "ANSI: %d%s\n", scsi_device_type(sdev->type),
878 sdev->vendor, sdev->model, sdev->rev,
879 sdev->inq_periph_qual, inq_result[2] & 0x07,
880 (inq_result[3] & 0x0f) == 1 ? " CCS" : "");
881
Linus Torvalds1da177e2005-04-16 15:20:36 -0700882 if ((sdev->scsi_level >= SCSI_2) && (inq_result[7] & 2) &&
Christoph Hellwigc8b09f62014-11-03 20:15:14 +0100883 !(*bflags & BLIST_NOTQ)) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700884 sdev->tagged_supported = 1;
Christoph Hellwigc8b09f62014-11-03 20:15:14 +0100885 sdev->simple_tags = 1;
886 }
Matthew Wilcox6d877682007-07-11 12:54:55 -0600887
Linus Torvalds1da177e2005-04-16 15:20:36 -0700888 /*
889 * Some devices (Texel CD ROM drives) have handshaking problems
890 * when used with the Seagate controllers. borken is initialized
891 * to 1, and then set it to 0 here.
892 */
893 if ((*bflags & BLIST_BORKEN) == 0)
894 sdev->borken = 0;
895
Matthew Wilcox6d877682007-07-11 12:54:55 -0600896 if (*bflags & BLIST_NO_ULD_ATTACH)
897 sdev->no_uld_attach = 1;
898
Linus Torvalds1da177e2005-04-16 15:20:36 -0700899 /*
900 * Apparently some really broken devices (contrary to the SCSI
901 * standards) need to be selected without asserting ATN
902 */
903 if (*bflags & BLIST_SELECT_NO_ATN)
904 sdev->select_no_atn = 1;
905
906 /*
James Bottomley4d7db042006-03-31 20:07:45 -0600907 * Maximum 512 sector transfer length
908 * broken RA4x00 Compaq Disk Array
909 */
910 if (*bflags & BLIST_MAX_512)
Martin K. Petersen086fa5f2010-02-26 00:20:38 -0500911 blk_queue_max_hw_sectors(sdev->request_queue, 512);
James Bottomley4d7db042006-03-31 20:07:45 -0600912
913 /*
Linus Torvalds1da177e2005-04-16 15:20:36 -0700914 * Some devices may not want to have a start command automatically
915 * issued when a device is added.
916 */
917 if (*bflags & BLIST_NOSTARTONADD)
918 sdev->no_start_on_add = 1;
919
920 if (*bflags & BLIST_SINGLELUN)
Tony Battersby25d7c362007-11-12 10:00:44 -0500921 scsi_target(sdev)->single_lun = 1;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700922
Linus Torvalds1da177e2005-04-16 15:20:36 -0700923 sdev->use_10_for_rw = 1;
924
925 if (*bflags & BLIST_MS_SKIP_PAGE_08)
926 sdev->skip_ms_page_8 = 1;
927
928 if (*bflags & BLIST_MS_SKIP_PAGE_3F)
929 sdev->skip_ms_page_3f = 1;
930
931 if (*bflags & BLIST_USE_10_BYTE_MS)
932 sdev->use_10_for_ms = 1;
933
Janusz Dziemidowicz02134362014-07-24 15:48:46 +0200934 /* some devices don't like REPORT SUPPORTED OPERATION CODES
935 * and will simply timeout causing sd_mod init to take a very
936 * very long time */
937 if (*bflags & BLIST_NO_RSOC)
938 sdev->no_report_opcodes = 1;
939
Linus Torvalds1da177e2005-04-16 15:20:36 -0700940 /* set the device running here so that slave configure
941 * may do I/O */
James Bottomley6f4267e2008-08-22 16:53:31 -0500942 ret = scsi_device_set_state(sdev, SDEV_RUNNING);
943 if (ret) {
944 ret = scsi_device_set_state(sdev, SDEV_BLOCK);
945
946 if (ret) {
947 sdev_printk(KERN_ERR, sdev,
948 "in wrong state %s to complete scan\n",
949 scsi_device_state_name(sdev->sdev_state));
950 return SCSI_SCAN_NO_RESPONSE;
951 }
952 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700953
954 if (*bflags & BLIST_MS_192_BYTES_FOR_3F)
955 sdev->use_192_bytes_for_3f = 1;
956
957 if (*bflags & BLIST_NOT_LOCKABLE)
958 sdev->lockable = 0;
959
960 if (*bflags & BLIST_RETRY_HWERROR)
961 sdev->retry_hwerror = 1;
962
Martin K. Petersend974e422012-08-28 14:29:35 -0400963 if (*bflags & BLIST_NO_DIF)
964 sdev->no_dif = 1;
965
Martin K. Petersen0816c922013-05-10 10:36:04 -0400966 sdev->eh_timeout = SCSI_DEFAULT_EH_TIMEOUT;
967
Martin K. Petersenc1d40a52014-07-15 12:49:17 -0400968 if (*bflags & BLIST_TRY_VPD_PAGES)
969 sdev->try_vpd_pages = 1;
970 else if (*bflags & BLIST_SKIP_VPD_PAGES)
Martin K. Petersen56f2a802013-04-24 21:19:47 -0400971 sdev->skip_vpd_pages = 1;
972
Linus Torvalds1da177e2005-04-16 15:20:36 -0700973 transport_configure_device(&sdev->sdev_gendev);
974
Christoph Hellwig93805092006-02-17 12:11:29 +0100975 if (sdev->host->hostt->slave_configure) {
James Bottomley6f4267e2008-08-22 16:53:31 -0500976 ret = sdev->host->hostt->slave_configure(sdev);
Christoph Hellwig93805092006-02-17 12:11:29 +0100977 if (ret) {
978 /*
979 * if LLDD reports slave not present, don't clutter
980 * console with alloc failure messages
981 */
982 if (ret != -ENXIO) {
983 sdev_printk(KERN_ERR, sdev,
984 "failed to configure device\n");
985 }
986 return SCSI_SCAN_NO_RESPONSE;
987 }
988 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700989
Hannes Reineckeb3ae8782014-03-15 09:51:49 +0100990 if (sdev->scsi_level >= SCSI_3)
991 scsi_attach_vpd(sdev);
992
Vasu Dev4a840672009-10-22 15:46:33 -0700993 sdev->max_queue_depth = sdev->queue_depth;
994
Linus Torvalds1da177e2005-04-16 15:20:36 -0700995 /*
996 * Ok, the device is now all set up, we can
997 * register it and tell the rest of the kernel
998 * about it.
999 */
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001000 if (!async && scsi_sysfs_add_sdev(sdev) != 0)
Alan Sternb24b1032005-07-27 11:43:46 -07001001 return SCSI_SCAN_NO_RESPONSE;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001002
1003 return SCSI_SCAN_LUN_PRESENT;
1004}
1005
akpm@osdl.orgc5f2e642006-04-15 00:30:24 -07001006#ifdef CONFIG_SCSI_LOGGING
Kurt Garloff6c7154c2006-04-03 15:18:35 +02001007/**
Rob Landleyeb448202007-11-03 13:30:39 -05001008 * scsi_inq_str - print INQUIRY data from min to max index, strip trailing whitespace
Kurt Garloff6c7154c2006-04-03 15:18:35 +02001009 * @buf: Output buffer with at least end-first+1 bytes of space
1010 * @inq: Inquiry buffer (input)
1011 * @first: Offset of string into inq
1012 * @end: Index after last character in inq
1013 */
akpm@osdl.orgc5f2e642006-04-15 00:30:24 -07001014static unsigned char *scsi_inq_str(unsigned char *buf, unsigned char *inq,
Kurt Garloff6c7154c2006-04-03 15:18:35 +02001015 unsigned first, unsigned end)
1016{
1017 unsigned term = 0, idx;
akpm@osdl.orgc5f2e642006-04-15 00:30:24 -07001018
1019 for (idx = 0; idx + first < end && idx + first < inq[4] + 5; idx++) {
1020 if (inq[idx+first] > ' ') {
Kurt Garloff6c7154c2006-04-03 15:18:35 +02001021 buf[idx] = inq[idx+first];
1022 term = idx+1;
1023 } else {
1024 buf[idx] = ' ';
1025 }
1026 }
1027 buf[term] = 0;
1028 return buf;
1029}
akpm@osdl.orgc5f2e642006-04-15 00:30:24 -07001030#endif
James Bottomley6f3a2022005-09-22 20:33:28 -05001031
Linus Torvalds1da177e2005-04-16 15:20:36 -07001032/**
1033 * scsi_probe_and_add_lun - probe a LUN, if a LUN is found add it
1034 * @starget: pointer to target device structure
1035 * @lun: LUN of target device
Linus Torvalds1da177e2005-04-16 15:20:36 -07001036 * @bflagsp: store bflags here if not NULL
Rob Landleyeb448202007-11-03 13:30:39 -05001037 * @sdevp: probe the LUN corresponding to this scsi_device
1038 * @rescan: if nonzero skip some code only needed on first scan
1039 * @hostdata: passed to scsi_alloc_sdev()
Linus Torvalds1da177e2005-04-16 15:20:36 -07001040 *
1041 * Description:
1042 * Call scsi_probe_lun, if a LUN with an attached device is found,
1043 * allocate and set it up by calling scsi_add_lun.
1044 *
1045 * Return:
Christoph Hellwigf64a1812005-10-31 18:32:08 +01001046 * SCSI_SCAN_NO_RESPONSE: could not allocate or setup a scsi_device
Linus Torvalds1da177e2005-04-16 15:20:36 -07001047 * SCSI_SCAN_TARGET_PRESENT: target responded, but no device is
1048 * attached at the LUN
Christoph Hellwigf64a1812005-10-31 18:32:08 +01001049 * SCSI_SCAN_LUN_PRESENT: a new scsi_device was allocated and initialized
Linus Torvalds1da177e2005-04-16 15:20:36 -07001050 **/
1051static int scsi_probe_and_add_lun(struct scsi_target *starget,
Hannes Reinecke9cb78c12014-06-25 15:27:36 +02001052 u64 lun, int *bflagsp,
Linus Torvalds1da177e2005-04-16 15:20:36 -07001053 struct scsi_device **sdevp, int rescan,
1054 void *hostdata)
1055{
1056 struct scsi_device *sdev;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001057 unsigned char *result;
James Bottomley39216032005-06-15 18:48:29 -05001058 int bflags, res = SCSI_SCAN_NO_RESPONSE, result_len = 256;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001059 struct Scsi_Host *shost = dev_to_shost(starget->dev.parent);
1060
1061 /*
1062 * The rescan flag is used as an optimization, the first scan of a
1063 * host adapter calls into here with rescan == 0.
1064 */
James Bottomley6f3a2022005-09-22 20:33:28 -05001065 sdev = scsi_device_lookup_by_target(starget, lun);
1066 if (sdev) {
James Bottomley0f1d87a2008-08-22 16:43:59 -05001067 if (rescan || !scsi_device_created(sdev)) {
Hannes Reinecke91921e02014-06-25 16:39:59 +02001068 SCSI_LOG_SCAN_BUS(3, sdev_printk(KERN_INFO, sdev,
Linus Torvalds1da177e2005-04-16 15:20:36 -07001069 "scsi scan: device exists on %s\n",
Kay Sievers71610f52008-12-03 22:41:36 +01001070 dev_name(&sdev->sdev_gendev)));
Linus Torvalds1da177e2005-04-16 15:20:36 -07001071 if (sdevp)
1072 *sdevp = sdev;
1073 else
1074 scsi_device_put(sdev);
1075
1076 if (bflagsp)
1077 *bflagsp = scsi_get_device_flags(sdev,
1078 sdev->vendor,
1079 sdev->model);
1080 return SCSI_SCAN_LUN_PRESENT;
1081 }
James Bottomley6f3a2022005-09-22 20:33:28 -05001082 scsi_device_put(sdev);
1083 } else
1084 sdev = scsi_alloc_sdev(starget, lun, hostdata);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001085 if (!sdev)
1086 goto out;
James Bottomley39216032005-06-15 18:48:29 -05001087
1088 result = kmalloc(result_len, GFP_ATOMIC |
Al Virobc861202005-04-24 12:28:34 -07001089 ((shost->unchecked_isa_dma) ? __GFP_DMA : 0));
Linus Torvalds1da177e2005-04-16 15:20:36 -07001090 if (!result)
James Bottomley39216032005-06-15 18:48:29 -05001091 goto out_free_sdev;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001092
James Bottomley39216032005-06-15 18:48:29 -05001093 if (scsi_probe_lun(sdev, result, result_len, &bflags))
Linus Torvalds1da177e2005-04-16 15:20:36 -07001094 goto out_free_result;
1095
Kurt Garloff4186ab12006-04-03 15:16:48 +02001096 if (bflagsp)
1097 *bflagsp = bflags;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001098 /*
1099 * result contains valid SCSI INQUIRY data.
1100 */
Kurt Garloff13f7e5a2006-04-03 15:20:08 +02001101 if (((result[0] >> 5) == 3) && !(bflags & BLIST_ATTACH_PQ3)) {
Linus Torvalds1da177e2005-04-16 15:20:36 -07001102 /*
1103 * For a Peripheral qualifier 3 (011b), the SCSI
1104 * spec says: The device server is not capable of
1105 * supporting a physical device on this logical
1106 * unit.
1107 *
1108 * For disks, this implies that there is no
1109 * logical disk configured at sdev->lun, but there
1110 * is a target id responding.
1111 */
Kurt Garloff6c7154c2006-04-03 15:18:35 +02001112 SCSI_LOG_SCAN_BUS(2, sdev_printk(KERN_INFO, sdev, "scsi scan:"
1113 " peripheral qualifier of 3, device not"
1114 " added\n"))
1115 if (lun == 0) {
akpm@osdl.orgc5f2e642006-04-15 00:30:24 -07001116 SCSI_LOG_SCAN_BUS(1, {
1117 unsigned char vend[9];
1118 unsigned char mod[17];
1119
1120 sdev_printk(KERN_INFO, sdev,
Kurt Garloff6c7154c2006-04-03 15:18:35 +02001121 "scsi scan: consider passing scsi_mod."
Kurt Garloff3424a652007-01-09 02:28:54 +01001122 "dev_flags=%s:%s:0x240 or 0x1000240\n",
Kurt Garloff6c7154c2006-04-03 15:18:35 +02001123 scsi_inq_str(vend, result, 8, 16),
akpm@osdl.orgc5f2e642006-04-15 00:30:24 -07001124 scsi_inq_str(mod, result, 16, 32));
1125 });
James Bottomley643eb2d2008-03-22 22:42:27 -05001126
Kurt Garloff6c7154c2006-04-03 15:18:35 +02001127 }
James Bottomley643eb2d2008-03-22 22:42:27 -05001128
Linus Torvalds1da177e2005-04-16 15:20:36 -07001129 res = SCSI_SCAN_TARGET_PRESENT;
1130 goto out_free_result;
1131 }
1132
Alan Stern1bfc5d92006-02-09 15:26:18 -05001133 /*
dave wysochanski84961f22006-08-09 14:56:32 -04001134 * Some targets may set slight variations of PQ and PDT to signal
1135 * that no LUN is present, so don't add sdev in these cases.
1136 * Two specific examples are:
1137 * 1) NetApp targets: return PQ=1, PDT=0x1f
1138 * 2) USB UFI: returns PDT=0x1f, with the PQ bits being "reserved"
1139 * in the UFI 1.0 spec (we cannot rely on reserved bits).
1140 *
1141 * References:
1142 * 1) SCSI SPC-3, pp. 145-146
1143 * PQ=1: "A peripheral device having the specified peripheral
1144 * device type is not connected to this logical unit. However, the
1145 * device server is capable of supporting the specified peripheral
1146 * device type on this logical unit."
1147 * PDT=0x1f: "Unknown or no device type"
1148 * 2) USB UFI 1.0, p. 20
1149 * PDT=00h Direct-access device (floppy)
1150 * PDT=1Fh none (no FDD connected to the requested logical unit)
Alan Stern1bfc5d92006-02-09 15:26:18 -05001151 */
dave wysochanski84961f22006-08-09 14:56:32 -04001152 if (((result[0] >> 5) == 1 || starget->pdt_1f_for_no_lun) &&
James Bottomley01b291b2008-08-21 15:14:14 -05001153 (result[0] & 0x1f) == 0x1f &&
1154 !scsi_is_wlun(lun)) {
Hannes Reinecke91921e02014-06-25 16:39:59 +02001155 SCSI_LOG_SCAN_BUS(3, sdev_printk(KERN_INFO, sdev,
Alan Stern1bfc5d92006-02-09 15:26:18 -05001156 "scsi scan: peripheral device type"
1157 " of 31, no device added\n"));
1158 res = SCSI_SCAN_TARGET_PRESENT;
1159 goto out_free_result;
1160 }
1161
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001162 res = scsi_add_lun(sdev, result, &bflags, shost->async_scan);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001163 if (res == SCSI_SCAN_LUN_PRESENT) {
1164 if (bflags & BLIST_KEY) {
1165 sdev->lockable = 0;
James Bottomley39216032005-06-15 18:48:29 -05001166 scsi_unlock_floptical(sdev, result);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001167 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001168 }
1169
1170 out_free_result:
1171 kfree(result);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001172 out_free_sdev:
1173 if (res == SCSI_SCAN_LUN_PRESENT) {
1174 if (sdevp) {
Alan Sternb70d37b2005-07-26 10:30:40 -04001175 if (scsi_device_get(sdev) == 0) {
1176 *sdevp = sdev;
1177 } else {
1178 __scsi_remove_device(sdev);
1179 res = SCSI_SCAN_NO_RESPONSE;
1180 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001181 }
James Bottomley6f3a2022005-09-22 20:33:28 -05001182 } else
James Bottomley860dc732009-11-19 17:48:29 -05001183 __scsi_remove_device(sdev);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001184 out:
1185 return res;
1186}
1187
1188/**
1189 * scsi_sequential_lun_scan - sequentially scan a SCSI target
1190 * @starget: pointer to target structure to scan
1191 * @bflags: black/white list flag for LUN 0
Rob Landleyeb448202007-11-03 13:30:39 -05001192 * @scsi_level: Which version of the standard does this device adhere to
1193 * @rescan: passed to scsi_probe_add_lun()
Linus Torvalds1da177e2005-04-16 15:20:36 -07001194 *
1195 * Description:
1196 * Generally, scan from LUN 1 (LUN 0 is assumed to already have been
1197 * scanned) to some maximum lun until a LUN is found with no device
1198 * attached. Use the bflags to figure out any oddities.
1199 *
1200 * Modifies sdevscan->lun.
1201 **/
1202static void scsi_sequential_lun_scan(struct scsi_target *starget,
Kurt Garloff4186ab12006-04-03 15:16:48 +02001203 int bflags, int scsi_level, int rescan)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001204{
Hannes Reinecke9cb78c12014-06-25 15:27:36 +02001205 uint max_dev_lun;
1206 u64 sparse_lun, lun;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001207 struct Scsi_Host *shost = dev_to_shost(starget->dev.parent);
1208
Hannes Reinecke91921e02014-06-25 16:39:59 +02001209 SCSI_LOG_SCAN_BUS(3, starget_printk(KERN_INFO, starget,
1210 "scsi scan: Sequential scan\n"));
Linus Torvalds1da177e2005-04-16 15:20:36 -07001211
1212 max_dev_lun = min(max_scsi_luns, shost->max_lun);
1213 /*
1214 * If this device is known to support sparse multiple units,
1215 * override the other settings, and scan all of them. Normally,
1216 * SCSI-3 devices should be scanned via the REPORT LUNS.
1217 */
1218 if (bflags & BLIST_SPARSELUN) {
1219 max_dev_lun = shost->max_lun;
1220 sparse_lun = 1;
1221 } else
1222 sparse_lun = 0;
1223
1224 /*
Mark Knibbsfb0d82f2014-10-09 12:39:40 +01001225 * If less than SCSI_1_CCS, and no special lun scanning, stop
Linus Torvalds1da177e2005-04-16 15:20:36 -07001226 * scanning; this matches 2.4 behaviour, but could just be a bug
Mark Knibbsfb0d82f2014-10-09 12:39:40 +01001227 * (to continue scanning a SCSI_1_CCS device).
Linus Torvalds1da177e2005-04-16 15:20:36 -07001228 *
1229 * This test is broken. We might not have any device on lun0 for
1230 * a sparselun device, and if that's the case then how would we
1231 * know the real scsi_level, eh? It might make sense to just not
1232 * scan any SCSI_1 device for non-0 luns, but that check would best
1233 * go into scsi_alloc_sdev() and just have it return null when asked
1234 * to alloc an sdev for lun > 0 on an already found SCSI_1 device.
1235 *
1236 if ((sdevscan->scsi_level < SCSI_1_CCS) &&
1237 ((bflags & (BLIST_FORCELUN | BLIST_SPARSELUN | BLIST_MAX5LUN))
1238 == 0))
1239 return;
1240 */
1241 /*
1242 * If this device is known to support multiple units, override
1243 * the other settings, and scan all of them.
1244 */
1245 if (bflags & BLIST_FORCELUN)
1246 max_dev_lun = shost->max_lun;
1247 /*
1248 * REGAL CDC-4X: avoid hang after LUN 4
1249 */
1250 if (bflags & BLIST_MAX5LUN)
1251 max_dev_lun = min(5U, max_dev_lun);
1252 /*
1253 * Do not scan SCSI-2 or lower device past LUN 7, unless
1254 * BLIST_LARGELUN.
1255 */
1256 if (scsi_level < SCSI_3 && !(bflags & BLIST_LARGELUN))
1257 max_dev_lun = min(8U, max_dev_lun);
1258
1259 /*
Hannes Reinecke22ffeb42014-06-03 10:58:53 +02001260 * Stop scanning at 255 unless BLIST_SCSI3LUN
1261 */
1262 if (!(bflags & BLIST_SCSI3LUN))
1263 max_dev_lun = min(256U, max_dev_lun);
1264
1265 /*
Linus Torvalds1da177e2005-04-16 15:20:36 -07001266 * We have already scanned LUN 0, so start at LUN 1. Keep scanning
1267 * until we reach the max, or no LUN is found and we are not
1268 * sparse_lun.
1269 */
1270 for (lun = 1; lun < max_dev_lun; ++lun)
1271 if ((scsi_probe_and_add_lun(starget, lun, NULL, NULL, rescan,
1272 NULL) != SCSI_SCAN_LUN_PRESENT) &&
1273 !sparse_lun)
1274 return;
1275}
1276
1277/**
Randy Dunlap9f6aa572010-05-23 17:02:30 -07001278 * scsilun_to_int - convert a scsi_lun to an int
Linus Torvalds1da177e2005-04-16 15:20:36 -07001279 * @scsilun: struct scsi_lun to be converted.
1280 *
1281 * Description:
1282 * Convert @scsilun from a struct scsi_lun to a four byte host byte-ordered
1283 * integer, and return the result. The caller must check for
1284 * truncation before using this function.
1285 *
1286 * Notes:
Linus Torvalds1da177e2005-04-16 15:20:36 -07001287 * For a description of the LUN format, post SCSI-3 see the SCSI
1288 * Architecture Model, for SCSI-3 see the SCSI Controller Commands.
1289 *
Hannes Reinecked9e5d612014-06-25 15:27:39 +02001290 * Given a struct scsi_lun of: d2 04 0b 03 00 00 00 00, this function
1291 * returns the integer: 0x0b03d204
1292 *
1293 * This encoding will return a standard integer LUN for LUNs smaller
1294 * than 256, which typically use a single level LUN structure with
1295 * addressing method 0.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001296 **/
Hannes Reinecke9cb78c12014-06-25 15:27:36 +02001297u64 scsilun_to_int(struct scsi_lun *scsilun)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001298{
1299 int i;
Hannes Reinecke9cb78c12014-06-25 15:27:36 +02001300 u64 lun;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001301
1302 lun = 0;
1303 for (i = 0; i < sizeof(lun); i += 2)
Hannes Reinecked9e5d612014-06-25 15:27:39 +02001304 lun = lun | (((u64)scsilun->scsi_lun[i] << ((i + 1) * 8)) |
1305 ((u64)scsilun->scsi_lun[i + 1] << (i * 8)));
Linus Torvalds1da177e2005-04-16 15:20:36 -07001306 return lun;
1307}
Christof Schmitt462b7852007-06-19 10:25:30 +02001308EXPORT_SYMBOL(scsilun_to_int);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001309
1310/**
Randy Dunlap9f6aa572010-05-23 17:02:30 -07001311 * int_to_scsilun - reverts an int into a scsi_lun
Rob Landleyeb448202007-11-03 13:30:39 -05001312 * @lun: integer to be reverted
James.Smart@Emulex.Com2f4701d2005-07-13 22:05:03 -04001313 * @scsilun: struct scsi_lun to be set.
1314 *
1315 * Description:
1316 * Reverts the functionality of the scsilun_to_int, which packed
1317 * an 8-byte lun value into an int. This routine unpacks the int
1318 * back into the lun value.
James.Smart@Emulex.Com2f4701d2005-07-13 22:05:03 -04001319 *
1320 * Notes:
Hannes Reinecked9e5d612014-06-25 15:27:39 +02001321 * Given an integer : 0x0b03d204, this function returns a
1322 * struct scsi_lun of: d2 04 0b 03 00 00 00 00
James.Smart@Emulex.Com2f4701d2005-07-13 22:05:03 -04001323 *
1324 **/
Hannes Reinecke9cb78c12014-06-25 15:27:36 +02001325void int_to_scsilun(u64 lun, struct scsi_lun *scsilun)
James.Smart@Emulex.Com2f4701d2005-07-13 22:05:03 -04001326{
1327 int i;
1328
1329 memset(scsilun->scsi_lun, 0, sizeof(scsilun->scsi_lun));
1330
1331 for (i = 0; i < sizeof(lun); i += 2) {
1332 scsilun->scsi_lun[i] = (lun >> 8) & 0xFF;
1333 scsilun->scsi_lun[i+1] = lun & 0xFF;
1334 lun = lun >> 16;
1335 }
1336}
1337EXPORT_SYMBOL(int_to_scsilun);
1338
1339/**
Linus Torvalds1da177e2005-04-16 15:20:36 -07001340 * scsi_report_lun_scan - Scan using SCSI REPORT LUN results
Rob Landleyeb448202007-11-03 13:30:39 -05001341 * @starget: which target
1342 * @bflags: Zero or a mix of BLIST_NOLUN, BLIST_REPORTLUN2, or BLIST_NOREPORTLUN
1343 * @rescan: nonzero if we can skip code only needed on first scan
Linus Torvalds1da177e2005-04-16 15:20:36 -07001344 *
1345 * Description:
Rob Landleyeb448202007-11-03 13:30:39 -05001346 * Fast scanning for modern (SCSI-3) devices by sending a REPORT LUN command.
1347 * Scan the resulting list of LUNs by calling scsi_probe_and_add_lun.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001348 *
Rob Landleyeb448202007-11-03 13:30:39 -05001349 * If BLINK_REPORTLUN2 is set, scan a target that supports more than 8
1350 * LUNs even if it's older than SCSI-3.
1351 * If BLIST_NOREPORTLUN is set, return 1 always.
1352 * If BLIST_NOLUN is set, return 0 always.
Alan Stern09b6b512012-01-10 13:43:30 -05001353 * If starget->no_report_luns is set, return 1 always.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001354 *
1355 * Return:
1356 * 0: scan completed (or no memory, so further scanning is futile)
Rob Landleyeb448202007-11-03 13:30:39 -05001357 * 1: could not scan with REPORT LUN
Linus Torvalds1da177e2005-04-16 15:20:36 -07001358 **/
James Bottomley6f3a2022005-09-22 20:33:28 -05001359static int scsi_report_lun_scan(struct scsi_target *starget, int bflags,
Linus Torvalds1da177e2005-04-16 15:20:36 -07001360 int rescan)
1361{
1362 char devname[64];
1363 unsigned char scsi_cmd[MAX_COMMAND_SIZE];
1364 unsigned int length;
Hannes Reinecke9cb78c12014-06-25 15:27:36 +02001365 u64 lun;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001366 unsigned int num_luns;
1367 unsigned int retries;
James Bottomley39216032005-06-15 18:48:29 -05001368 int result;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001369 struct scsi_lun *lunp, *lun_data;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001370 u8 *data;
1371 struct scsi_sense_hdr sshdr;
James Bottomley6f3a2022005-09-22 20:33:28 -05001372 struct scsi_device *sdev;
1373 struct Scsi_Host *shost = dev_to_shost(&starget->dev);
Alan Stern2ef89192005-11-08 15:51:55 -05001374 int ret = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001375
1376 /*
1377 * Only support SCSI-3 and up devices if BLIST_NOREPORTLUN is not set.
1378 * Also allow SCSI-2 if BLIST_REPORTLUN2 is set and host adapter does
1379 * support more than 8 LUNs.
Alan Stern09b6b512012-01-10 13:43:30 -05001380 * Don't attempt if the target doesn't support REPORT LUNS.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001381 */
James Bottomley4d7db042006-03-31 20:07:45 -06001382 if (bflags & BLIST_NOREPORTLUN)
1383 return 1;
1384 if (starget->scsi_level < SCSI_2 &&
1385 starget->scsi_level != SCSI_UNKNOWN)
1386 return 1;
1387 if (starget->scsi_level < SCSI_3 &&
1388 (!(bflags & BLIST_REPORTLUN2) || shost->max_lun <= 8))
Linus Torvalds1da177e2005-04-16 15:20:36 -07001389 return 1;
1390 if (bflags & BLIST_NOLUN)
1391 return 0;
Alan Stern09b6b512012-01-10 13:43:30 -05001392 if (starget->no_report_luns)
1393 return 1;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001394
James Bottomley6f3a2022005-09-22 20:33:28 -05001395 if (!(sdev = scsi_device_lookup_by_target(starget, 0))) {
1396 sdev = scsi_alloc_sdev(starget, 0, NULL);
1397 if (!sdev)
1398 return 0;
Alan Stern75f8ee82010-02-12 12:13:31 -05001399 if (scsi_device_get(sdev)) {
1400 __scsi_remove_device(sdev);
James Bottomley6f3a2022005-09-22 20:33:28 -05001401 return 0;
Alan Stern75f8ee82010-02-12 12:13:31 -05001402 }
James Bottomley6f3a2022005-09-22 20:33:28 -05001403 }
1404
Linus Torvalds1da177e2005-04-16 15:20:36 -07001405 sprintf(devname, "host %d channel %d id %d",
James Bottomley6f3a2022005-09-22 20:33:28 -05001406 shost->host_no, sdev->channel, sdev->id);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001407
1408 /*
1409 * Allocate enough to hold the header (the same size as one scsi_lun)
1410 * plus the max number of luns we are requesting.
1411 *
1412 * Reallocating and trying again (with the exact amount we need)
1413 * would be nice, but then we need to somehow limit the size
1414 * allocated based on the available memory and the limits of
1415 * kmalloc - we don't want a kmalloc() failure of a huge value to
1416 * prevent us from finding any LUNs on this target.
1417 */
1418 length = (max_scsi_report_luns + 1) * sizeof(struct scsi_lun);
1419 lun_data = kmalloc(length, GFP_ATOMIC |
1420 (sdev->host->unchecked_isa_dma ? __GFP_DMA : 0));
James Bottomley6f3a2022005-09-22 20:33:28 -05001421 if (!lun_data) {
Harvey Harrisoncadbd4a2008-07-03 23:47:27 -07001422 printk(ALLOC_FAILURE_MSG, __func__);
James Bottomley39216032005-06-15 18:48:29 -05001423 goto out;
James Bottomley6f3a2022005-09-22 20:33:28 -05001424 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001425
1426 scsi_cmd[0] = REPORT_LUNS;
1427
1428 /*
1429 * bytes 1 - 5: reserved, set to zero.
1430 */
1431 memset(&scsi_cmd[1], 0, 5);
1432
1433 /*
1434 * bytes 6 - 9: length of the command.
1435 */
1436 scsi_cmd[6] = (unsigned char) (length >> 24) & 0xff;
1437 scsi_cmd[7] = (unsigned char) (length >> 16) & 0xff;
1438 scsi_cmd[8] = (unsigned char) (length >> 8) & 0xff;
1439 scsi_cmd[9] = (unsigned char) length & 0xff;
1440
1441 scsi_cmd[10] = 0; /* reserved */
1442 scsi_cmd[11] = 0; /* control */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001443
1444 /*
1445 * We can get a UNIT ATTENTION, for example a power on/reset, so
1446 * retry a few times (like sd.c does for TEST UNIT READY).
1447 * Experience shows some combinations of adapter/devices get at
1448 * least two power on/resets.
1449 *
1450 * Illegal requests (for devices that do not support REPORT LUNS)
1451 * should come through as a check condition, and will not generate
1452 * a retry.
1453 */
1454 for (retries = 0; retries < 3; retries++) {
Hannes Reinecke91921e02014-06-25 16:39:59 +02001455 SCSI_LOG_SCAN_BUS(3, sdev_printk (KERN_INFO, sdev,
1456 "scsi scan: Sending REPORT LUNS to (try %d)\n",
Linus Torvalds1da177e2005-04-16 15:20:36 -07001457 retries));
James Bottomley39216032005-06-15 18:48:29 -05001458
James Bottomley39216032005-06-15 18:48:29 -05001459 result = scsi_execute_req(sdev, scsi_cmd, DMA_FROM_DEVICE,
James Bottomleyea73a9f2005-08-28 11:33:52 -05001460 lun_data, length, &sshdr,
FUJITA Tomonorif4f4e472008-12-04 14:24:39 +09001461 SCSI_TIMEOUT + 4 * HZ, 3, NULL);
James Bottomley39216032005-06-15 18:48:29 -05001462
Hannes Reinecke91921e02014-06-25 16:39:59 +02001463 SCSI_LOG_SCAN_BUS(3, sdev_printk (KERN_INFO, sdev,
1464 "scsi scan: REPORT LUNS"
1465 " %s (try %d) result 0x%x\n",
1466 result ? "failed" : "successful",
1467 retries, result));
James Bottomley39216032005-06-15 18:48:29 -05001468 if (result == 0)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001469 break;
James Bottomleyea73a9f2005-08-28 11:33:52 -05001470 else if (scsi_sense_valid(&sshdr)) {
Linus Torvalds1da177e2005-04-16 15:20:36 -07001471 if (sshdr.sense_key != UNIT_ATTENTION)
1472 break;
1473 }
1474 }
1475
James Bottomley39216032005-06-15 18:48:29 -05001476 if (result) {
Linus Torvalds1da177e2005-04-16 15:20:36 -07001477 /*
1478 * The device probably does not support a REPORT LUN command
1479 */
Alan Stern2ef89192005-11-08 15:51:55 -05001480 ret = 1;
1481 goto out_err;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001482 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001483
1484 /*
1485 * Get the length from the first four bytes of lun_data.
1486 */
1487 data = (u8 *) lun_data->scsi_lun;
1488 length = ((data[0] << 24) | (data[1] << 16) |
1489 (data[2] << 8) | (data[3] << 0));
1490
1491 num_luns = (length / sizeof(struct scsi_lun));
1492 if (num_luns > max_scsi_report_luns) {
Hannes Reinecke91921e02014-06-25 16:39:59 +02001493 sdev_printk(KERN_WARNING, sdev,
1494 "Only %d (max_scsi_report_luns)"
1495 " of %d luns reported, try increasing"
1496 " max_scsi_report_luns.\n",
1497 max_scsi_report_luns, num_luns);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001498 num_luns = max_scsi_report_luns;
1499 }
1500
Jeff Garzik3bf743e2005-10-24 18:04:06 -04001501 SCSI_LOG_SCAN_BUS(3, sdev_printk (KERN_INFO, sdev,
1502 "scsi scan: REPORT LUN scan\n"));
Linus Torvalds1da177e2005-04-16 15:20:36 -07001503
1504 /*
1505 * Scan the luns in lun_data. The entry at offset 0 is really
1506 * the header, so start at 1 and go up to and including num_luns.
1507 */
1508 for (lunp = &lun_data[1]; lunp <= &lun_data[num_luns]; lunp++) {
1509 lun = scsilun_to_int(lunp);
1510
Hannes Reinecke9cb78c12014-06-25 15:27:36 +02001511 if (lun > sdev->host->max_lun) {
Hannes Reinecke91921e02014-06-25 16:39:59 +02001512 sdev_printk(KERN_WARNING, sdev,
1513 "lun%llu has a LUN larger than"
1514 " allowed by the host adapter\n", lun);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001515 } else {
1516 int res;
1517
1518 res = scsi_probe_and_add_lun(starget,
1519 lun, NULL, NULL, rescan, NULL);
1520 if (res == SCSI_SCAN_NO_RESPONSE) {
1521 /*
1522 * Got some results, but now none, abort.
1523 */
Jeff Garzik3bf743e2005-10-24 18:04:06 -04001524 sdev_printk(KERN_ERR, sdev,
1525 "Unexpected response"
Hannes Reinecke9cb78c12014-06-25 15:27:36 +02001526 " from lun %llu while scanning, scan"
1527 " aborted\n", (unsigned long long)lun);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001528 break;
1529 }
1530 }
1531 }
1532
Alan Stern2ef89192005-11-08 15:51:55 -05001533 out_err:
Linus Torvalds1da177e2005-04-16 15:20:36 -07001534 kfree(lun_data);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001535 out:
James Bottomley6f3a2022005-09-22 20:33:28 -05001536 scsi_device_put(sdev);
James Bottomley0f1d87a2008-08-22 16:43:59 -05001537 if (scsi_device_created(sdev))
James Bottomley6f3a2022005-09-22 20:33:28 -05001538 /*
1539 * the sdev we used didn't appear in the report luns scan
1540 */
James Bottomley860dc732009-11-19 17:48:29 -05001541 __scsi_remove_device(sdev);
Alan Stern2ef89192005-11-08 15:51:55 -05001542 return ret;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001543}
1544
1545struct scsi_device *__scsi_add_device(struct Scsi_Host *shost, uint channel,
Hannes Reinecke9cb78c12014-06-25 15:27:36 +02001546 uint id, u64 lun, void *hostdata)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001547{
Matthew Wilcoxa97a83a2006-02-05 08:01:33 -07001548 struct scsi_device *sdev = ERR_PTR(-ENODEV);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001549 struct device *parent = &shost->shost_gendev;
Christoph Hellwige02f3f52006-01-13 19:04:00 +01001550 struct scsi_target *starget;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001551
Matthew Wilcox938e2ac2007-01-15 18:07:09 -07001552 if (strncmp(scsi_scan_type, "none", 4) == 0)
1553 return ERR_PTR(-ENODEV);
1554
Christoph Hellwige02f3f52006-01-13 19:04:00 +01001555 starget = scsi_alloc_target(parent, channel, id);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001556 if (!starget)
1557 return ERR_PTR(-ENOMEM);
Alan Sternbc4f2402010-06-17 10:41:42 -04001558 scsi_autopm_get_target(starget);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001559
Arjan van de Ven0b950672006-01-11 13:16:10 +01001560 mutex_lock(&shost->scan_mutex);
Matthew Wilcox6b7f1232007-06-26 15:18:51 -06001561 if (!shost->async_scan)
1562 scsi_complete_async_scans();
1563
Alan Sternbc4f2402010-06-17 10:41:42 -04001564 if (scsi_host_scan_allowed(shost) && scsi_autopm_get_host(shost) == 0) {
Matthew Wilcoxa97a83a2006-02-05 08:01:33 -07001565 scsi_probe_and_add_lun(starget, lun, NULL, &sdev, 1, hostdata);
Alan Sternbc4f2402010-06-17 10:41:42 -04001566 scsi_autopm_put_host(shost);
1567 }
Arjan van de Ven0b950672006-01-11 13:16:10 +01001568 mutex_unlock(&shost->scan_mutex);
Alan Sternbc4f2402010-06-17 10:41:42 -04001569 scsi_autopm_put_target(starget);
James Bottomleye63ed0d2014-01-21 07:00:50 -08001570 /*
1571 * paired with scsi_alloc_target(). Target will be destroyed unless
1572 * scsi_probe_and_add_lun made an underlying device visible
1573 */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001574 scsi_target_reap(starget);
1575 put_device(&starget->dev);
1576
1577 return sdev;
1578}
1579EXPORT_SYMBOL(__scsi_add_device);
1580
James Bottomley146f7262005-09-10 12:44:09 -05001581int scsi_add_device(struct Scsi_Host *host, uint channel,
Hannes Reinecke9cb78c12014-06-25 15:27:36 +02001582 uint target, u64 lun)
James Bottomley146f7262005-09-10 12:44:09 -05001583{
1584 struct scsi_device *sdev =
1585 __scsi_add_device(host, channel, target, lun, NULL);
1586 if (IS_ERR(sdev))
1587 return PTR_ERR(sdev);
1588
1589 scsi_device_put(sdev);
1590 return 0;
1591}
1592EXPORT_SYMBOL(scsi_add_device);
1593
Linus Torvalds1da177e2005-04-16 15:20:36 -07001594void scsi_rescan_device(struct device *dev)
1595{
Linus Torvalds1da177e2005-04-16 15:20:36 -07001596 if (!dev->driver)
1597 return;
1598
Christoph Hellwig3af6b352014-11-12 18:34:51 +01001599 if (try_module_get(dev->driver->owner)) {
1600 struct scsi_driver *drv = to_scsi_driver(dev->driver);
1601
Linus Torvalds1da177e2005-04-16 15:20:36 -07001602 if (drv->rescan)
1603 drv->rescan(dev);
Christoph Hellwig3af6b352014-11-12 18:34:51 +01001604 module_put(dev->driver->owner);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001605 }
1606}
1607EXPORT_SYMBOL(scsi_rescan_device);
1608
Alan Sterne517d312005-07-26 10:18:45 -04001609static void __scsi_scan_target(struct device *parent, unsigned int channel,
Hannes Reinecke9cb78c12014-06-25 15:27:36 +02001610 unsigned int id, u64 lun, int rescan)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001611{
1612 struct Scsi_Host *shost = dev_to_shost(parent);
1613 int bflags = 0;
1614 int res;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001615 struct scsi_target *starget;
1616
1617 if (shost->this_id == id)
1618 /*
1619 * Don't scan the host adapter
1620 */
1621 return;
1622
Linus Torvalds1da177e2005-04-16 15:20:36 -07001623 starget = scsi_alloc_target(parent, channel, id);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001624 if (!starget)
1625 return;
Alan Sternbc4f2402010-06-17 10:41:42 -04001626 scsi_autopm_get_target(starget);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001627
Linus Torvalds1da177e2005-04-16 15:20:36 -07001628 if (lun != SCAN_WILD_CARD) {
1629 /*
1630 * Scan for a specific host/chan/id/lun.
1631 */
1632 scsi_probe_and_add_lun(starget, lun, NULL, NULL, rescan, NULL);
1633 goto out_reap;
1634 }
1635
1636 /*
1637 * Scan LUN 0, if there is some response, scan further. Ideally, we
1638 * would not configure LUN 0 until all LUNs are scanned.
1639 */
James Bottomley6f3a2022005-09-22 20:33:28 -05001640 res = scsi_probe_and_add_lun(starget, 0, &bflags, NULL, rescan, NULL);
1641 if (res == SCSI_SCAN_LUN_PRESENT || res == SCSI_SCAN_TARGET_PRESENT) {
1642 if (scsi_report_lun_scan(starget, bflags, rescan) != 0)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001643 /*
1644 * The REPORT LUN did not scan the target,
1645 * do a sequential scan.
1646 */
1647 scsi_sequential_lun_scan(starget, bflags,
Kurt Garloff4186ab12006-04-03 15:16:48 +02001648 starget->scsi_level, rescan);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001649 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001650
1651 out_reap:
Alan Sternbc4f2402010-06-17 10:41:42 -04001652 scsi_autopm_put_target(starget);
James Bottomleye63ed0d2014-01-21 07:00:50 -08001653 /*
1654 * paired with scsi_alloc_target(): determine if the target has
1655 * any children at all and if not, nuke it
1656 */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001657 scsi_target_reap(starget);
1658
1659 put_device(&starget->dev);
1660}
Alan Sterne517d312005-07-26 10:18:45 -04001661
1662/**
Randy Dunlape59e4a02008-02-29 22:02:50 -08001663 * scsi_scan_target - scan a target id, possibly including all LUNs on the target.
Alan Sterne517d312005-07-26 10:18:45 -04001664 * @parent: host to scan
1665 * @channel: channel to scan
1666 * @id: target id to scan
1667 * @lun: Specific LUN to scan or SCAN_WILD_CARD
1668 * @rescan: passed to LUN scanning routines
1669 *
1670 * Description:
1671 * Scan the target id on @parent, @channel, and @id. Scan at least LUN 0,
1672 * and possibly all LUNs on the target id.
1673 *
1674 * First try a REPORT LUN scan, if that does not scan the target, do a
1675 * sequential scan of LUNs on the target id.
1676 **/
1677void scsi_scan_target(struct device *parent, unsigned int channel,
Hannes Reinecke9cb78c12014-06-25 15:27:36 +02001678 unsigned int id, u64 lun, int rescan)
Alan Sterne517d312005-07-26 10:18:45 -04001679{
1680 struct Scsi_Host *shost = dev_to_shost(parent);
1681
Matthew Wilcox93b45af2006-11-22 13:24:53 -07001682 if (strncmp(scsi_scan_type, "none", 4) == 0)
1683 return;
1684
Matthew Wilcox6b7f1232007-06-26 15:18:51 -06001685 mutex_lock(&shost->scan_mutex);
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001686 if (!shost->async_scan)
1687 scsi_complete_async_scans();
1688
Alan Sternbc4f2402010-06-17 10:41:42 -04001689 if (scsi_host_scan_allowed(shost) && scsi_autopm_get_host(shost) == 0) {
Alan Sterne517d312005-07-26 10:18:45 -04001690 __scsi_scan_target(parent, channel, id, lun, rescan);
Alan Sternbc4f2402010-06-17 10:41:42 -04001691 scsi_autopm_put_host(shost);
1692 }
Arjan van de Ven0b950672006-01-11 13:16:10 +01001693 mutex_unlock(&shost->scan_mutex);
Alan Sterne517d312005-07-26 10:18:45 -04001694}
Linus Torvalds1da177e2005-04-16 15:20:36 -07001695EXPORT_SYMBOL(scsi_scan_target);
1696
1697static void scsi_scan_channel(struct Scsi_Host *shost, unsigned int channel,
Hannes Reinecke9cb78c12014-06-25 15:27:36 +02001698 unsigned int id, u64 lun, int rescan)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001699{
1700 uint order_id;
1701
1702 if (id == SCAN_WILD_CARD)
1703 for (id = 0; id < shost->max_id; ++id) {
1704 /*
1705 * XXX adapter drivers when possible (FCP, iSCSI)
1706 * could modify max_id to match the current max,
1707 * not the absolute max.
1708 *
1709 * XXX add a shost id iterator, so for example,
1710 * the FC ID can be the same as a target id
1711 * without a huge overhead of sparse id's.
1712 */
1713 if (shost->reverse_ordering)
1714 /*
1715 * Scan from high to low id.
1716 */
1717 order_id = shost->max_id - id - 1;
1718 else
1719 order_id = id;
Alan Sterne517d312005-07-26 10:18:45 -04001720 __scsi_scan_target(&shost->shost_gendev, channel,
1721 order_id, lun, rescan);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001722 }
1723 else
Alan Sterne517d312005-07-26 10:18:45 -04001724 __scsi_scan_target(&shost->shost_gendev, channel,
1725 id, lun, rescan);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001726}
1727
1728int scsi_scan_host_selected(struct Scsi_Host *shost, unsigned int channel,
Hannes Reinecke9cb78c12014-06-25 15:27:36 +02001729 unsigned int id, u64 lun, int rescan)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001730{
Jeff Garzik3bf743e2005-10-24 18:04:06 -04001731 SCSI_LOG_SCAN_BUS(3, shost_printk (KERN_INFO, shost,
Hannes Reinecke9cb78c12014-06-25 15:27:36 +02001732 "%s: <%u:%u:%llu>\n",
Harvey Harrisoncadbd4a2008-07-03 23:47:27 -07001733 __func__, channel, id, lun));
Linus Torvalds1da177e2005-04-16 15:20:36 -07001734
1735 if (((channel != SCAN_WILD_CARD) && (channel > shost->max_channel)) ||
Amit Arora091686d2006-05-19 16:14:50 -07001736 ((id != SCAN_WILD_CARD) && (id >= shost->max_id)) ||
Mark Knibbs605c6db2014-10-09 12:39:48 +01001737 ((lun != SCAN_WILD_CARD) && (lun >= shost->max_lun)))
Linus Torvalds1da177e2005-04-16 15:20:36 -07001738 return -EINVAL;
1739
Arjan van de Ven0b950672006-01-11 13:16:10 +01001740 mutex_lock(&shost->scan_mutex);
Matthew Wilcox6b7f1232007-06-26 15:18:51 -06001741 if (!shost->async_scan)
1742 scsi_complete_async_scans();
1743
Alan Sternbc4f2402010-06-17 10:41:42 -04001744 if (scsi_host_scan_allowed(shost) && scsi_autopm_get_host(shost) == 0) {
Mike Anderson82f29462005-06-16 11:14:33 -07001745 if (channel == SCAN_WILD_CARD)
1746 for (channel = 0; channel <= shost->max_channel;
1747 channel++)
1748 scsi_scan_channel(shost, channel, id, lun,
1749 rescan);
1750 else
Linus Torvalds1da177e2005-04-16 15:20:36 -07001751 scsi_scan_channel(shost, channel, id, lun, rescan);
Alan Sternbc4f2402010-06-17 10:41:42 -04001752 scsi_autopm_put_host(shost);
Mike Anderson82f29462005-06-16 11:14:33 -07001753 }
Arjan van de Ven0b950672006-01-11 13:16:10 +01001754 mutex_unlock(&shost->scan_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001755
1756 return 0;
1757}
1758
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001759static void scsi_sysfs_add_devices(struct Scsi_Host *shost)
1760{
1761 struct scsi_device *sdev;
1762 shost_for_each_device(sdev, shost) {
Dan Williams3b661a92012-06-21 23:47:28 -07001763 /* target removed before the device could be added */
1764 if (sdev->sdev_state == SDEV_DEL)
1765 continue;
Subhash Jadavani693ad5b2014-09-25 15:32:20 +03001766 /* If device is already visible, skip adding it to sysfs */
1767 if (sdev->is_visible)
1768 continue;
Matthew Wilcox6b7f1232007-06-26 15:18:51 -06001769 if (!scsi_host_scan_allowed(shost) ||
1770 scsi_sysfs_add_sdev(sdev) != 0)
James Bottomley860dc732009-11-19 17:48:29 -05001771 __scsi_remove_device(sdev);
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001772 }
1773}
1774
1775/**
1776 * scsi_prep_async_scan - prepare for an async scan
1777 * @shost: the host which will be scanned
1778 * Returns: a cookie to be passed to scsi_finish_async_scan()
1779 *
1780 * Tells the midlayer this host is going to do an asynchronous scan.
1781 * It reserves the host's position in the scanning list and ensures
1782 * that other asynchronous scans started after this one won't affect the
1783 * ordering of the discovered devices.
1784 */
Matthew Wilcox1aa8fab2006-11-22 13:24:54 -07001785static struct async_scan_data *scsi_prep_async_scan(struct Scsi_Host *shost)
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001786{
1787 struct async_scan_data *data;
Matthew Wilcox6b7f1232007-06-26 15:18:51 -06001788 unsigned long flags;
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001789
1790 if (strncmp(scsi_scan_type, "sync", 4) == 0)
1791 return NULL;
1792
1793 if (shost->async_scan) {
Hannes Reinecke91921e02014-06-25 16:39:59 +02001794 shost_printk(KERN_INFO, shost, "%s called twice\n", __func__);
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001795 dump_stack();
1796 return NULL;
1797 }
1798
1799 data = kmalloc(sizeof(*data), GFP_KERNEL);
1800 if (!data)
1801 goto err;
1802 data->shost = scsi_host_get(shost);
1803 if (!data->shost)
1804 goto err;
1805 init_completion(&data->prev_finished);
1806
Matthew Wilcox6b7f1232007-06-26 15:18:51 -06001807 mutex_lock(&shost->scan_mutex);
1808 spin_lock_irqsave(shost->host_lock, flags);
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001809 shost->async_scan = 1;
Matthew Wilcox6b7f1232007-06-26 15:18:51 -06001810 spin_unlock_irqrestore(shost->host_lock, flags);
1811 mutex_unlock(&shost->scan_mutex);
1812
1813 spin_lock(&async_scan_lock);
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001814 if (list_empty(&scanning_hosts))
1815 complete(&data->prev_finished);
1816 list_add_tail(&data->list, &scanning_hosts);
1817 spin_unlock(&async_scan_lock);
1818
1819 return data;
1820
1821 err:
1822 kfree(data);
1823 return NULL;
1824}
1825
1826/**
1827 * scsi_finish_async_scan - asynchronous scan has finished
1828 * @data: cookie returned from earlier call to scsi_prep_async_scan()
1829 *
1830 * All the devices currently attached to this host have been found.
1831 * This function announces all the devices it has found to the rest
1832 * of the system.
1833 */
Matthew Wilcox1aa8fab2006-11-22 13:24:54 -07001834static void scsi_finish_async_scan(struct async_scan_data *data)
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001835{
1836 struct Scsi_Host *shost;
Matthew Wilcox6b7f1232007-06-26 15:18:51 -06001837 unsigned long flags;
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001838
1839 if (!data)
1840 return;
1841
1842 shost = data->shost;
Matthew Wilcox6b7f1232007-06-26 15:18:51 -06001843
1844 mutex_lock(&shost->scan_mutex);
1845
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001846 if (!shost->async_scan) {
Hannes Reinecke91921e02014-06-25 16:39:59 +02001847 shost_printk(KERN_INFO, shost, "%s called twice\n", __func__);
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001848 dump_stack();
Julia Lawall773e82f2008-07-21 09:58:30 +02001849 mutex_unlock(&shost->scan_mutex);
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001850 return;
1851 }
1852
1853 wait_for_completion(&data->prev_finished);
1854
1855 scsi_sysfs_add_devices(shost);
1856
Matthew Wilcox6b7f1232007-06-26 15:18:51 -06001857 spin_lock_irqsave(shost->host_lock, flags);
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001858 shost->async_scan = 0;
Matthew Wilcox6b7f1232007-06-26 15:18:51 -06001859 spin_unlock_irqrestore(shost->host_lock, flags);
1860
1861 mutex_unlock(&shost->scan_mutex);
1862
1863 spin_lock(&async_scan_lock);
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001864 list_del(&data->list);
1865 if (!list_empty(&scanning_hosts)) {
1866 struct async_scan_data *next = list_entry(scanning_hosts.next,
1867 struct async_scan_data, list);
1868 complete(&next->prev_finished);
1869 }
1870 spin_unlock(&async_scan_lock);
1871
Huajun Li267a6ad2012-02-12 19:59:14 +08001872 scsi_autopm_put_host(shost);
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001873 scsi_host_put(shost);
1874 kfree(data);
1875}
1876
Matthew Wilcox1aa8fab2006-11-22 13:24:54 -07001877static void do_scsi_scan_host(struct Scsi_Host *shost)
1878{
1879 if (shost->hostt->scan_finished) {
1880 unsigned long start = jiffies;
1881 if (shost->hostt->scan_start)
1882 shost->hostt->scan_start(shost);
1883
1884 while (!shost->hostt->scan_finished(shost, jiffies - start))
1885 msleep(10);
1886 } else {
1887 scsi_scan_host_selected(shost, SCAN_WILD_CARD, SCAN_WILD_CARD,
1888 SCAN_WILD_CARD, 0);
1889 }
1890}
1891
Dan Williams6cdd5522012-07-09 19:33:35 -07001892static void do_scan_async(void *_data, async_cookie_t c)
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001893{
1894 struct async_scan_data *data = _data;
Alan Sternbc4f2402010-06-17 10:41:42 -04001895 struct Scsi_Host *shost = data->shost;
1896
1897 do_scsi_scan_host(shost);
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001898 scsi_finish_async_scan(data);
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001899}
1900
Linus Torvalds1da177e2005-04-16 15:20:36 -07001901/**
1902 * scsi_scan_host - scan the given adapter
1903 * @shost: adapter to scan
1904 **/
1905void scsi_scan_host(struct Scsi_Host *shost)
1906{
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001907 struct async_scan_data *data;
1908
1909 if (strncmp(scsi_scan_type, "none", 4) == 0)
1910 return;
Alan Sternbc4f2402010-06-17 10:41:42 -04001911 if (scsi_autopm_get_host(shost) < 0)
1912 return;
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001913
1914 data = scsi_prep_async_scan(shost);
1915 if (!data) {
Matthew Wilcox1aa8fab2006-11-22 13:24:54 -07001916 do_scsi_scan_host(shost);
Alan Sternbc4f2402010-06-17 10:41:42 -04001917 scsi_autopm_put_host(shost);
Matthew Wilcox3e082a92006-09-28 15:19:20 -06001918 return;
1919 }
Matthew Wilcox1aa8fab2006-11-22 13:24:54 -07001920
Dan Williams6cdd5522012-07-09 19:33:35 -07001921 /* register with the async subsystem so wait_for_device_probe()
1922 * will flush this work
1923 */
1924 async_schedule(do_scan_async, data);
1925
Huajun Li267a6ad2012-02-12 19:59:14 +08001926 /* scsi_autopm_put_host(shost) is called in scsi_finish_async_scan() */
Linus Torvalds1da177e2005-04-16 15:20:36 -07001927}
1928EXPORT_SYMBOL(scsi_scan_host);
1929
Linus Torvalds1da177e2005-04-16 15:20:36 -07001930void scsi_forget_host(struct Scsi_Host *shost)
1931{
Alan Sterna64358d2005-07-26 10:27:10 -04001932 struct scsi_device *sdev;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001933 unsigned long flags;
1934
Alan Sterna64358d2005-07-26 10:27:10 -04001935 restart:
Linus Torvalds1da177e2005-04-16 15:20:36 -07001936 spin_lock_irqsave(shost->host_lock, flags);
Alan Sterna64358d2005-07-26 10:27:10 -04001937 list_for_each_entry(sdev, &shost->__devices, siblings) {
1938 if (sdev->sdev_state == SDEV_DEL)
1939 continue;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001940 spin_unlock_irqrestore(shost->host_lock, flags);
Alan Sterna64358d2005-07-26 10:27:10 -04001941 __scsi_remove_device(sdev);
1942 goto restart;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001943 }
1944 spin_unlock_irqrestore(shost->host_lock, flags);
1945}
1946
Randy Dunlap9f6aa572010-05-23 17:02:30 -07001947/**
1948 * scsi_get_host_dev - Create a scsi_device that points to the host adapter itself
1949 * @shost: Host that needs a scsi_device
Linus Torvalds1da177e2005-04-16 15:20:36 -07001950 *
1951 * Lock status: None assumed.
1952 *
Christoph Hellwigf64a1812005-10-31 18:32:08 +01001953 * Returns: The scsi_device or NULL
Linus Torvalds1da177e2005-04-16 15:20:36 -07001954 *
1955 * Notes:
Christoph Hellwigf64a1812005-10-31 18:32:08 +01001956 * Attach a single scsi_device to the Scsi_Host - this should
Linus Torvalds1da177e2005-04-16 15:20:36 -07001957 * be made to look like a "pseudo-device" that points to the
1958 * HA itself.
1959 *
1960 * Note - this device is not accessible from any high-level
1961 * drivers (including generics), which is probably not
Randy Dunlap9f6aa572010-05-23 17:02:30 -07001962 * optimal. We can add hooks later to attach.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001963 */
1964struct scsi_device *scsi_get_host_dev(struct Scsi_Host *shost)
1965{
Alan Sterne517d312005-07-26 10:18:45 -04001966 struct scsi_device *sdev = NULL;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001967 struct scsi_target *starget;
1968
Arjan van de Ven0b950672006-01-11 13:16:10 +01001969 mutex_lock(&shost->scan_mutex);
Alan Sterne517d312005-07-26 10:18:45 -04001970 if (!scsi_host_scan_allowed(shost))
1971 goto out;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001972 starget = scsi_alloc_target(&shost->shost_gendev, 0, shost->this_id);
1973 if (!starget)
Alan Sterne517d312005-07-26 10:18:45 -04001974 goto out;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001975
1976 sdev = scsi_alloc_sdev(starget, 0, NULL);
Alan Sternd5469112010-02-12 12:13:39 -05001977 if (sdev)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001978 sdev->borken = 0;
Alan Sternd5469112010-02-12 12:13:39 -05001979 else
James Bottomley884d25c2006-09-05 16:26:41 -05001980 scsi_target_reap(starget);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001981 put_device(&starget->dev);
Alan Sterne517d312005-07-26 10:18:45 -04001982 out:
Arjan van de Ven0b950672006-01-11 13:16:10 +01001983 mutex_unlock(&shost->scan_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001984 return sdev;
1985}
1986EXPORT_SYMBOL(scsi_get_host_dev);
1987
Randy Dunlap9f6aa572010-05-23 17:02:30 -07001988/**
1989 * scsi_free_host_dev - Free a scsi_device that points to the host adapter itself
1990 * @sdev: Host device to be freed
Linus Torvalds1da177e2005-04-16 15:20:36 -07001991 *
1992 * Lock status: None assumed.
1993 *
1994 * Returns: Nothing
Linus Torvalds1da177e2005-04-16 15:20:36 -07001995 */
1996void scsi_free_host_dev(struct scsi_device *sdev)
1997{
1998 BUG_ON(sdev->id != sdev->host->this_id);
1999
James Bottomley860dc732009-11-19 17:48:29 -05002000 __scsi_remove_device(sdev);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002001}
2002EXPORT_SYMBOL(scsi_free_host_dev);
2003