xref: /linux/drivers/scsi/scsi_sysfs.c (revision 9cfc5c90ad38c8fc11bfd39de42a107da00871ba)
1 /*
2  * scsi_sysfs.c
3  *
4  * SCSI sysfs interface routines.
5  *
6  * Created to pull SCSI mid layer sysfs routines into one file.
7  */
8 
9 #include <linux/module.h>
10 #include <linux/slab.h>
11 #include <linux/init.h>
12 #include <linux/blkdev.h>
13 #include <linux/device.h>
14 #include <linux/pm_runtime.h>
15 
16 #include <scsi/scsi.h>
17 #include <scsi/scsi_device.h>
18 #include <scsi/scsi_host.h>
19 #include <scsi/scsi_tcq.h>
20 #include <scsi/scsi_transport.h>
21 #include <scsi/scsi_driver.h>
22 
23 #include "scsi_priv.h"
24 #include "scsi_logging.h"
25 
26 static struct device_type scsi_dev_type;
27 
28 static const struct {
29 	enum scsi_device_state	value;
30 	char			*name;
31 } sdev_states[] = {
32 	{ SDEV_CREATED, "created" },
33 	{ SDEV_RUNNING, "running" },
34 	{ SDEV_CANCEL, "cancel" },
35 	{ SDEV_DEL, "deleted" },
36 	{ SDEV_QUIESCE, "quiesce" },
37 	{ SDEV_OFFLINE,	"offline" },
38 	{ SDEV_TRANSPORT_OFFLINE, "transport-offline" },
39 	{ SDEV_BLOCK,	"blocked" },
40 	{ SDEV_CREATED_BLOCK, "created-blocked" },
41 };
42 
43 const char *scsi_device_state_name(enum scsi_device_state state)
44 {
45 	int i;
46 	char *name = NULL;
47 
48 	for (i = 0; i < ARRAY_SIZE(sdev_states); i++) {
49 		if (sdev_states[i].value == state) {
50 			name = sdev_states[i].name;
51 			break;
52 		}
53 	}
54 	return name;
55 }
56 
57 static const struct {
58 	enum scsi_host_state	value;
59 	char			*name;
60 } shost_states[] = {
61 	{ SHOST_CREATED, "created" },
62 	{ SHOST_RUNNING, "running" },
63 	{ SHOST_CANCEL, "cancel" },
64 	{ SHOST_DEL, "deleted" },
65 	{ SHOST_RECOVERY, "recovery" },
66 	{ SHOST_CANCEL_RECOVERY, "cancel/recovery" },
67 	{ SHOST_DEL_RECOVERY, "deleted/recovery", },
68 };
69 const char *scsi_host_state_name(enum scsi_host_state state)
70 {
71 	int i;
72 	char *name = NULL;
73 
74 	for (i = 0; i < ARRAY_SIZE(shost_states); i++) {
75 		if (shost_states[i].value == state) {
76 			name = shost_states[i].name;
77 			break;
78 		}
79 	}
80 	return name;
81 }
82 
83 static int check_set(unsigned long long *val, char *src)
84 {
85 	char *last;
86 
87 	if (strncmp(src, "-", 20) == 0) {
88 		*val = SCAN_WILD_CARD;
89 	} else {
90 		/*
91 		 * Doesn't check for int overflow
92 		 */
93 		*val = simple_strtoull(src, &last, 0);
94 		if (*last != '\0')
95 			return 1;
96 	}
97 	return 0;
98 }
99 
100 static int scsi_scan(struct Scsi_Host *shost, const char *str)
101 {
102 	char s1[15], s2[15], s3[17], junk;
103 	unsigned long long channel, id, lun;
104 	int res;
105 
106 	res = sscanf(str, "%10s %10s %16s %c", s1, s2, s3, &junk);
107 	if (res != 3)
108 		return -EINVAL;
109 	if (check_set(&channel, s1))
110 		return -EINVAL;
111 	if (check_set(&id, s2))
112 		return -EINVAL;
113 	if (check_set(&lun, s3))
114 		return -EINVAL;
115 	if (shost->transportt->user_scan)
116 		res = shost->transportt->user_scan(shost, channel, id, lun);
117 	else
118 		res = scsi_scan_host_selected(shost, channel, id, lun, 1);
119 	return res;
120 }
121 
122 /*
123  * shost_show_function: macro to create an attr function that can be used to
124  * show a non-bit field.
125  */
126 #define shost_show_function(name, field, format_string)			\
127 static ssize_t								\
128 show_##name (struct device *dev, struct device_attribute *attr, 	\
129 	     char *buf)							\
130 {									\
131 	struct Scsi_Host *shost = class_to_shost(dev);			\
132 	return snprintf (buf, 20, format_string, shost->field);		\
133 }
134 
135 /*
136  * shost_rd_attr: macro to create a function and attribute variable for a
137  * read only field.
138  */
139 #define shost_rd_attr2(name, field, format_string)			\
140 	shost_show_function(name, field, format_string)			\
141 static DEVICE_ATTR(name, S_IRUGO, show_##name, NULL);
142 
143 #define shost_rd_attr(field, format_string) \
144 shost_rd_attr2(field, field, format_string)
145 
146 /*
147  * Create the actual show/store functions and data structures.
148  */
149 
150 static ssize_t
151 store_scan(struct device *dev, struct device_attribute *attr,
152 	   const char *buf, size_t count)
153 {
154 	struct Scsi_Host *shost = class_to_shost(dev);
155 	int res;
156 
157 	res = scsi_scan(shost, buf);
158 	if (res == 0)
159 		res = count;
160 	return res;
161 };
162 static DEVICE_ATTR(scan, S_IWUSR, NULL, store_scan);
163 
164 static ssize_t
165 store_shost_state(struct device *dev, struct device_attribute *attr,
166 		  const char *buf, size_t count)
167 {
168 	int i;
169 	struct Scsi_Host *shost = class_to_shost(dev);
170 	enum scsi_host_state state = 0;
171 
172 	for (i = 0; i < ARRAY_SIZE(shost_states); i++) {
173 		const int len = strlen(shost_states[i].name);
174 		if (strncmp(shost_states[i].name, buf, len) == 0 &&
175 		   buf[len] == '\n') {
176 			state = shost_states[i].value;
177 			break;
178 		}
179 	}
180 	if (!state)
181 		return -EINVAL;
182 
183 	if (scsi_host_set_state(shost, state))
184 		return -EINVAL;
185 	return count;
186 }
187 
188 static ssize_t
189 show_shost_state(struct device *dev, struct device_attribute *attr, char *buf)
190 {
191 	struct Scsi_Host *shost = class_to_shost(dev);
192 	const char *name = scsi_host_state_name(shost->shost_state);
193 
194 	if (!name)
195 		return -EINVAL;
196 
197 	return snprintf(buf, 20, "%s\n", name);
198 }
199 
200 /* DEVICE_ATTR(state) clashes with dev_attr_state for sdev */
201 struct device_attribute dev_attr_hstate =
202 	__ATTR(state, S_IRUGO | S_IWUSR, show_shost_state, store_shost_state);
203 
204 static ssize_t
205 show_shost_mode(unsigned int mode, char *buf)
206 {
207 	ssize_t len = 0;
208 
209 	if (mode & MODE_INITIATOR)
210 		len = sprintf(buf, "%s", "Initiator");
211 
212 	if (mode & MODE_TARGET)
213 		len += sprintf(buf + len, "%s%s", len ? ", " : "", "Target");
214 
215 	len += sprintf(buf + len, "\n");
216 
217 	return len;
218 }
219 
220 static ssize_t
221 show_shost_supported_mode(struct device *dev, struct device_attribute *attr,
222 			  char *buf)
223 {
224 	struct Scsi_Host *shost = class_to_shost(dev);
225 	unsigned int supported_mode = shost->hostt->supported_mode;
226 
227 	if (supported_mode == MODE_UNKNOWN)
228 		/* by default this should be initiator */
229 		supported_mode = MODE_INITIATOR;
230 
231 	return show_shost_mode(supported_mode, buf);
232 }
233 
234 static DEVICE_ATTR(supported_mode, S_IRUGO | S_IWUSR, show_shost_supported_mode, NULL);
235 
236 static ssize_t
237 show_shost_active_mode(struct device *dev,
238 		       struct device_attribute *attr, char *buf)
239 {
240 	struct Scsi_Host *shost = class_to_shost(dev);
241 
242 	if (shost->active_mode == MODE_UNKNOWN)
243 		return snprintf(buf, 20, "unknown\n");
244 	else
245 		return show_shost_mode(shost->active_mode, buf);
246 }
247 
248 static DEVICE_ATTR(active_mode, S_IRUGO | S_IWUSR, show_shost_active_mode, NULL);
249 
250 static int check_reset_type(const char *str)
251 {
252 	if (sysfs_streq(str, "adapter"))
253 		return SCSI_ADAPTER_RESET;
254 	else if (sysfs_streq(str, "firmware"))
255 		return SCSI_FIRMWARE_RESET;
256 	else
257 		return 0;
258 }
259 
260 static ssize_t
261 store_host_reset(struct device *dev, struct device_attribute *attr,
262 		const char *buf, size_t count)
263 {
264 	struct Scsi_Host *shost = class_to_shost(dev);
265 	struct scsi_host_template *sht = shost->hostt;
266 	int ret = -EINVAL;
267 	int type;
268 
269 	type = check_reset_type(buf);
270 	if (!type)
271 		goto exit_store_host_reset;
272 
273 	if (sht->host_reset)
274 		ret = sht->host_reset(shost, type);
275 
276 exit_store_host_reset:
277 	if (ret == 0)
278 		ret = count;
279 	return ret;
280 }
281 
282 static DEVICE_ATTR(host_reset, S_IWUSR, NULL, store_host_reset);
283 
284 static ssize_t
285 show_shost_eh_deadline(struct device *dev,
286 		      struct device_attribute *attr, char *buf)
287 {
288 	struct Scsi_Host *shost = class_to_shost(dev);
289 
290 	if (shost->eh_deadline == -1)
291 		return snprintf(buf, strlen("off") + 2, "off\n");
292 	return sprintf(buf, "%u\n", shost->eh_deadline / HZ);
293 }
294 
295 static ssize_t
296 store_shost_eh_deadline(struct device *dev, struct device_attribute *attr,
297 		const char *buf, size_t count)
298 {
299 	struct Scsi_Host *shost = class_to_shost(dev);
300 	int ret = -EINVAL;
301 	unsigned long deadline, flags;
302 
303 	if (shost->transportt &&
304 	    (shost->transportt->eh_strategy_handler ||
305 	     !shost->hostt->eh_host_reset_handler))
306 		return ret;
307 
308 	if (!strncmp(buf, "off", strlen("off")))
309 		deadline = -1;
310 	else {
311 		ret = kstrtoul(buf, 10, &deadline);
312 		if (ret)
313 			return ret;
314 		if (deadline * HZ > UINT_MAX)
315 			return -EINVAL;
316 	}
317 
318 	spin_lock_irqsave(shost->host_lock, flags);
319 	if (scsi_host_in_recovery(shost))
320 		ret = -EBUSY;
321 	else {
322 		if (deadline == -1)
323 			shost->eh_deadline = -1;
324 		else
325 			shost->eh_deadline = deadline * HZ;
326 
327 		ret = count;
328 	}
329 	spin_unlock_irqrestore(shost->host_lock, flags);
330 
331 	return ret;
332 }
333 
334 static DEVICE_ATTR(eh_deadline, S_IRUGO | S_IWUSR, show_shost_eh_deadline, store_shost_eh_deadline);
335 
336 shost_rd_attr(use_blk_mq, "%d\n");
337 shost_rd_attr(unique_id, "%u\n");
338 shost_rd_attr(cmd_per_lun, "%hd\n");
339 shost_rd_attr(can_queue, "%hd\n");
340 shost_rd_attr(sg_tablesize, "%hu\n");
341 shost_rd_attr(sg_prot_tablesize, "%hu\n");
342 shost_rd_attr(unchecked_isa_dma, "%d\n");
343 shost_rd_attr(prot_capabilities, "%u\n");
344 shost_rd_attr(prot_guard_type, "%hd\n");
345 shost_rd_attr2(proc_name, hostt->proc_name, "%s\n");
346 
347 static ssize_t
348 show_host_busy(struct device *dev, struct device_attribute *attr, char *buf)
349 {
350 	struct Scsi_Host *shost = class_to_shost(dev);
351 	return snprintf(buf, 20, "%d\n", atomic_read(&shost->host_busy));
352 }
353 static DEVICE_ATTR(host_busy, S_IRUGO, show_host_busy, NULL);
354 
355 static struct attribute *scsi_sysfs_shost_attrs[] = {
356 	&dev_attr_use_blk_mq.attr,
357 	&dev_attr_unique_id.attr,
358 	&dev_attr_host_busy.attr,
359 	&dev_attr_cmd_per_lun.attr,
360 	&dev_attr_can_queue.attr,
361 	&dev_attr_sg_tablesize.attr,
362 	&dev_attr_sg_prot_tablesize.attr,
363 	&dev_attr_unchecked_isa_dma.attr,
364 	&dev_attr_proc_name.attr,
365 	&dev_attr_scan.attr,
366 	&dev_attr_hstate.attr,
367 	&dev_attr_supported_mode.attr,
368 	&dev_attr_active_mode.attr,
369 	&dev_attr_prot_capabilities.attr,
370 	&dev_attr_prot_guard_type.attr,
371 	&dev_attr_host_reset.attr,
372 	&dev_attr_eh_deadline.attr,
373 	NULL
374 };
375 
376 struct attribute_group scsi_shost_attr_group = {
377 	.attrs =	scsi_sysfs_shost_attrs,
378 };
379 
380 const struct attribute_group *scsi_sysfs_shost_attr_groups[] = {
381 	&scsi_shost_attr_group,
382 	NULL
383 };
384 
385 static void scsi_device_cls_release(struct device *class_dev)
386 {
387 	struct scsi_device *sdev;
388 
389 	sdev = class_to_sdev(class_dev);
390 	put_device(&sdev->sdev_gendev);
391 }
392 
393 static void scsi_device_dev_release_usercontext(struct work_struct *work)
394 {
395 	struct scsi_device *sdev;
396 	struct device *parent;
397 	struct list_head *this, *tmp;
398 	unsigned long flags;
399 
400 	sdev = container_of(work, struct scsi_device, ew.work);
401 
402 	scsi_dh_release_device(sdev);
403 
404 	parent = sdev->sdev_gendev.parent;
405 
406 	spin_lock_irqsave(sdev->host->host_lock, flags);
407 	list_del(&sdev->siblings);
408 	list_del(&sdev->same_target_siblings);
409 	list_del(&sdev->starved_entry);
410 	spin_unlock_irqrestore(sdev->host->host_lock, flags);
411 
412 	cancel_work_sync(&sdev->event_work);
413 
414 	list_for_each_safe(this, tmp, &sdev->event_list) {
415 		struct scsi_event *evt;
416 
417 		evt = list_entry(this, struct scsi_event, node);
418 		list_del(&evt->node);
419 		kfree(evt);
420 	}
421 
422 	blk_put_queue(sdev->request_queue);
423 	/* NULL queue means the device can't be used */
424 	sdev->request_queue = NULL;
425 
426 	kfree(sdev->vpd_pg83);
427 	kfree(sdev->vpd_pg80);
428 	kfree(sdev->inquiry);
429 	kfree(sdev);
430 
431 	if (parent)
432 		put_device(parent);
433 }
434 
435 static void scsi_device_dev_release(struct device *dev)
436 {
437 	struct scsi_device *sdp = to_scsi_device(dev);
438 	execute_in_process_context(scsi_device_dev_release_usercontext,
439 				   &sdp->ew);
440 }
441 
442 static struct class sdev_class = {
443 	.name		= "scsi_device",
444 	.dev_release	= scsi_device_cls_release,
445 };
446 
447 /* all probing is done in the individual ->probe routines */
448 static int scsi_bus_match(struct device *dev, struct device_driver *gendrv)
449 {
450 	struct scsi_device *sdp;
451 
452 	if (dev->type != &scsi_dev_type)
453 		return 0;
454 
455 	sdp = to_scsi_device(dev);
456 	if (sdp->no_uld_attach)
457 		return 0;
458 	return (sdp->inq_periph_qual == SCSI_INQ_PQ_CON)? 1: 0;
459 }
460 
461 static int scsi_bus_uevent(struct device *dev, struct kobj_uevent_env *env)
462 {
463 	struct scsi_device *sdev;
464 
465 	if (dev->type != &scsi_dev_type)
466 		return 0;
467 
468 	sdev = to_scsi_device(dev);
469 
470 	add_uevent_var(env, "MODALIAS=" SCSI_DEVICE_MODALIAS_FMT, sdev->type);
471 	return 0;
472 }
473 
474 struct bus_type scsi_bus_type = {
475         .name		= "scsi",
476         .match		= scsi_bus_match,
477 	.uevent		= scsi_bus_uevent,
478 #ifdef CONFIG_PM
479 	.pm		= &scsi_bus_pm_ops,
480 #endif
481 };
482 EXPORT_SYMBOL_GPL(scsi_bus_type);
483 
484 int scsi_sysfs_register(void)
485 {
486 	int error;
487 
488 	error = bus_register(&scsi_bus_type);
489 	if (!error) {
490 		error = class_register(&sdev_class);
491 		if (error)
492 			bus_unregister(&scsi_bus_type);
493 	}
494 
495 	return error;
496 }
497 
498 void scsi_sysfs_unregister(void)
499 {
500 	class_unregister(&sdev_class);
501 	bus_unregister(&scsi_bus_type);
502 }
503 
504 /*
505  * sdev_show_function: macro to create an attr function that can be used to
506  * show a non-bit field.
507  */
508 #define sdev_show_function(field, format_string)				\
509 static ssize_t								\
510 sdev_show_##field (struct device *dev, struct device_attribute *attr,	\
511 		   char *buf)						\
512 {									\
513 	struct scsi_device *sdev;					\
514 	sdev = to_scsi_device(dev);					\
515 	return snprintf (buf, 20, format_string, sdev->field);		\
516 }									\
517 
518 /*
519  * sdev_rd_attr: macro to create a function and attribute variable for a
520  * read only field.
521  */
522 #define sdev_rd_attr(field, format_string)				\
523 	sdev_show_function(field, format_string)			\
524 static DEVICE_ATTR(field, S_IRUGO, sdev_show_##field, NULL);
525 
526 
527 /*
528  * sdev_rw_attr: create a function and attribute variable for a
529  * read/write field.
530  */
531 #define sdev_rw_attr(field, format_string)				\
532 	sdev_show_function(field, format_string)				\
533 									\
534 static ssize_t								\
535 sdev_store_##field (struct device *dev, struct device_attribute *attr,	\
536 		    const char *buf, size_t count)			\
537 {									\
538 	struct scsi_device *sdev;					\
539 	sdev = to_scsi_device(dev);					\
540 	sscanf (buf, format_string, &sdev->field);			\
541 	return count;							\
542 }									\
543 static DEVICE_ATTR(field, S_IRUGO | S_IWUSR, sdev_show_##field, sdev_store_##field);
544 
545 /* Currently we don't export bit fields, but we might in future,
546  * so leave this code in */
547 #if 0
548 /*
549  * sdev_rd_attr: create a function and attribute variable for a
550  * read/write bit field.
551  */
552 #define sdev_rw_attr_bit(field)						\
553 	sdev_show_function(field, "%d\n")					\
554 									\
555 static ssize_t								\
556 sdev_store_##field (struct device *dev, struct device_attribute *attr,	\
557 		    const char *buf, size_t count)			\
558 {									\
559 	int ret;							\
560 	struct scsi_device *sdev;					\
561 	ret = scsi_sdev_check_buf_bit(buf);				\
562 	if (ret >= 0)	{						\
563 		sdev = to_scsi_device(dev);				\
564 		sdev->field = ret;					\
565 		ret = count;						\
566 	}								\
567 	return ret;							\
568 }									\
569 static DEVICE_ATTR(field, S_IRUGO | S_IWUSR, sdev_show_##field, sdev_store_##field);
570 
571 /*
572  * scsi_sdev_check_buf_bit: return 0 if buf is "0", return 1 if buf is "1",
573  * else return -EINVAL.
574  */
575 static int scsi_sdev_check_buf_bit(const char *buf)
576 {
577 	if ((buf[1] == '\0') || ((buf[1] == '\n') && (buf[2] == '\0'))) {
578 		if (buf[0] == '1')
579 			return 1;
580 		else if (buf[0] == '0')
581 			return 0;
582 		else
583 			return -EINVAL;
584 	} else
585 		return -EINVAL;
586 }
587 #endif
588 /*
589  * Create the actual show/store functions and data structures.
590  */
591 sdev_rd_attr (type, "%d\n");
592 sdev_rd_attr (scsi_level, "%d\n");
593 sdev_rd_attr (vendor, "%.8s\n");
594 sdev_rd_attr (model, "%.16s\n");
595 sdev_rd_attr (rev, "%.4s\n");
596 
597 static ssize_t
598 sdev_show_device_busy(struct device *dev, struct device_attribute *attr,
599 		char *buf)
600 {
601 	struct scsi_device *sdev = to_scsi_device(dev);
602 	return snprintf(buf, 20, "%d\n", atomic_read(&sdev->device_busy));
603 }
604 static DEVICE_ATTR(device_busy, S_IRUGO, sdev_show_device_busy, NULL);
605 
606 static ssize_t
607 sdev_show_device_blocked(struct device *dev, struct device_attribute *attr,
608 		char *buf)
609 {
610 	struct scsi_device *sdev = to_scsi_device(dev);
611 	return snprintf(buf, 20, "%d\n", atomic_read(&sdev->device_blocked));
612 }
613 static DEVICE_ATTR(device_blocked, S_IRUGO, sdev_show_device_blocked, NULL);
614 
615 /*
616  * TODO: can we make these symlinks to the block layer ones?
617  */
618 static ssize_t
619 sdev_show_timeout (struct device *dev, struct device_attribute *attr, char *buf)
620 {
621 	struct scsi_device *sdev;
622 	sdev = to_scsi_device(dev);
623 	return snprintf(buf, 20, "%d\n", sdev->request_queue->rq_timeout / HZ);
624 }
625 
626 static ssize_t
627 sdev_store_timeout (struct device *dev, struct device_attribute *attr,
628 		    const char *buf, size_t count)
629 {
630 	struct scsi_device *sdev;
631 	int timeout;
632 	sdev = to_scsi_device(dev);
633 	sscanf (buf, "%d\n", &timeout);
634 	blk_queue_rq_timeout(sdev->request_queue, timeout * HZ);
635 	return count;
636 }
637 static DEVICE_ATTR(timeout, S_IRUGO | S_IWUSR, sdev_show_timeout, sdev_store_timeout);
638 
639 static ssize_t
640 sdev_show_eh_timeout(struct device *dev, struct device_attribute *attr, char *buf)
641 {
642 	struct scsi_device *sdev;
643 	sdev = to_scsi_device(dev);
644 	return snprintf(buf, 20, "%u\n", sdev->eh_timeout / HZ);
645 }
646 
647 static ssize_t
648 sdev_store_eh_timeout(struct device *dev, struct device_attribute *attr,
649 		    const char *buf, size_t count)
650 {
651 	struct scsi_device *sdev;
652 	unsigned int eh_timeout;
653 	int err;
654 
655 	if (!capable(CAP_SYS_ADMIN))
656 		return -EACCES;
657 
658 	sdev = to_scsi_device(dev);
659 	err = kstrtouint(buf, 10, &eh_timeout);
660 	if (err)
661 		return err;
662 	sdev->eh_timeout = eh_timeout * HZ;
663 
664 	return count;
665 }
666 static DEVICE_ATTR(eh_timeout, S_IRUGO | S_IWUSR, sdev_show_eh_timeout, sdev_store_eh_timeout);
667 
668 static ssize_t
669 store_rescan_field (struct device *dev, struct device_attribute *attr,
670 		    const char *buf, size_t count)
671 {
672 	scsi_rescan_device(dev);
673 	return count;
674 }
675 static DEVICE_ATTR(rescan, S_IWUSR, NULL, store_rescan_field);
676 
677 static ssize_t
678 sdev_store_delete(struct device *dev, struct device_attribute *attr,
679 		  const char *buf, size_t count)
680 {
681 	if (device_remove_file_self(dev, attr))
682 		scsi_remove_device(to_scsi_device(dev));
683 	return count;
684 };
685 static DEVICE_ATTR(delete, S_IWUSR, NULL, sdev_store_delete);
686 
687 static ssize_t
688 store_state_field(struct device *dev, struct device_attribute *attr,
689 		  const char *buf, size_t count)
690 {
691 	int i;
692 	struct scsi_device *sdev = to_scsi_device(dev);
693 	enum scsi_device_state state = 0;
694 
695 	for (i = 0; i < ARRAY_SIZE(sdev_states); i++) {
696 		const int len = strlen(sdev_states[i].name);
697 		if (strncmp(sdev_states[i].name, buf, len) == 0 &&
698 		   buf[len] == '\n') {
699 			state = sdev_states[i].value;
700 			break;
701 		}
702 	}
703 	if (!state)
704 		return -EINVAL;
705 
706 	if (scsi_device_set_state(sdev, state))
707 		return -EINVAL;
708 	return count;
709 }
710 
711 static ssize_t
712 show_state_field(struct device *dev, struct device_attribute *attr, char *buf)
713 {
714 	struct scsi_device *sdev = to_scsi_device(dev);
715 	const char *name = scsi_device_state_name(sdev->sdev_state);
716 
717 	if (!name)
718 		return -EINVAL;
719 
720 	return snprintf(buf, 20, "%s\n", name);
721 }
722 
723 static DEVICE_ATTR(state, S_IRUGO | S_IWUSR, show_state_field, store_state_field);
724 
725 static ssize_t
726 show_queue_type_field(struct device *dev, struct device_attribute *attr,
727 		      char *buf)
728 {
729 	struct scsi_device *sdev = to_scsi_device(dev);
730 	const char *name = "none";
731 
732 	if (sdev->simple_tags)
733 		name = "simple";
734 
735 	return snprintf(buf, 20, "%s\n", name);
736 }
737 
738 static ssize_t
739 store_queue_type_field(struct device *dev, struct device_attribute *attr,
740 		       const char *buf, size_t count)
741 {
742 	struct scsi_device *sdev = to_scsi_device(dev);
743 
744 	if (!sdev->tagged_supported)
745 		return -EINVAL;
746 
747 	sdev_printk(KERN_INFO, sdev,
748 		    "ignoring write to deprecated queue_type attribute");
749 	return count;
750 }
751 
752 static DEVICE_ATTR(queue_type, S_IRUGO | S_IWUSR, show_queue_type_field,
753 		   store_queue_type_field);
754 
755 #define sdev_vpd_pg_attr(_page)						\
756 static ssize_t							\
757 show_vpd_##_page(struct file *filp, struct kobject *kobj,	\
758 		 struct bin_attribute *bin_attr,			\
759 		 char *buf, loff_t off, size_t count)			\
760 {									\
761 	struct device *dev = container_of(kobj, struct device, kobj);	\
762 	struct scsi_device *sdev = to_scsi_device(dev);			\
763 	if (!sdev->vpd_##_page)						\
764 		return -EINVAL;						\
765 	return memory_read_from_buffer(buf, count, &off,		\
766 				       sdev->vpd_##_page,		\
767 				       sdev->vpd_##_page##_len);	\
768 }									\
769 static struct bin_attribute dev_attr_vpd_##_page = {		\
770 	.attr =	{.name = __stringify(vpd_##_page), .mode = S_IRUGO },	\
771 	.size = 0,							\
772 	.read = show_vpd_##_page,					\
773 };
774 
775 sdev_vpd_pg_attr(pg83);
776 sdev_vpd_pg_attr(pg80);
777 
778 static ssize_t show_inquiry(struct file *filep, struct kobject *kobj,
779 			    struct bin_attribute *bin_attr,
780 			    char *buf, loff_t off, size_t count)
781 {
782 	struct device *dev = container_of(kobj, struct device, kobj);
783 	struct scsi_device *sdev = to_scsi_device(dev);
784 
785 	if (!sdev->inquiry)
786 		return -EINVAL;
787 
788 	return memory_read_from_buffer(buf, count, &off, sdev->inquiry,
789 				       sdev->inquiry_len);
790 }
791 
792 static struct bin_attribute dev_attr_inquiry = {
793 	.attr = {
794 		.name = "inquiry",
795 		.mode = S_IRUGO,
796 	},
797 	.size = 0,
798 	.read = show_inquiry,
799 };
800 
801 static ssize_t
802 show_iostat_counterbits(struct device *dev, struct device_attribute *attr,
803 			char *buf)
804 {
805 	return snprintf(buf, 20, "%d\n", (int)sizeof(atomic_t) * 8);
806 }
807 
808 static DEVICE_ATTR(iocounterbits, S_IRUGO, show_iostat_counterbits, NULL);
809 
810 #define show_sdev_iostat(field)						\
811 static ssize_t								\
812 show_iostat_##field(struct device *dev, struct device_attribute *attr,	\
813 		    char *buf)						\
814 {									\
815 	struct scsi_device *sdev = to_scsi_device(dev);			\
816 	unsigned long long count = atomic_read(&sdev->field);		\
817 	return snprintf(buf, 20, "0x%llx\n", count);			\
818 }									\
819 static DEVICE_ATTR(field, S_IRUGO, show_iostat_##field, NULL)
820 
821 show_sdev_iostat(iorequest_cnt);
822 show_sdev_iostat(iodone_cnt);
823 show_sdev_iostat(ioerr_cnt);
824 
825 static ssize_t
826 sdev_show_modalias(struct device *dev, struct device_attribute *attr, char *buf)
827 {
828 	struct scsi_device *sdev;
829 	sdev = to_scsi_device(dev);
830 	return snprintf (buf, 20, SCSI_DEVICE_MODALIAS_FMT "\n", sdev->type);
831 }
832 static DEVICE_ATTR(modalias, S_IRUGO, sdev_show_modalias, NULL);
833 
834 #define DECLARE_EVT_SHOW(name, Cap_name)				\
835 static ssize_t								\
836 sdev_show_evt_##name(struct device *dev, struct device_attribute *attr,	\
837 		     char *buf)						\
838 {									\
839 	struct scsi_device *sdev = to_scsi_device(dev);			\
840 	int val = test_bit(SDEV_EVT_##Cap_name, sdev->supported_events);\
841 	return snprintf(buf, 20, "%d\n", val);				\
842 }
843 
844 #define DECLARE_EVT_STORE(name, Cap_name)				\
845 static ssize_t								\
846 sdev_store_evt_##name(struct device *dev, struct device_attribute *attr,\
847 		      const char *buf, size_t count)			\
848 {									\
849 	struct scsi_device *sdev = to_scsi_device(dev);			\
850 	int val = simple_strtoul(buf, NULL, 0);				\
851 	if (val == 0)							\
852 		clear_bit(SDEV_EVT_##Cap_name, sdev->supported_events);	\
853 	else if (val == 1)						\
854 		set_bit(SDEV_EVT_##Cap_name, sdev->supported_events);	\
855 	else								\
856 		return -EINVAL;						\
857 	return count;							\
858 }
859 
860 #define DECLARE_EVT(name, Cap_name)					\
861 	DECLARE_EVT_SHOW(name, Cap_name)				\
862 	DECLARE_EVT_STORE(name, Cap_name)				\
863 	static DEVICE_ATTR(evt_##name, S_IRUGO, sdev_show_evt_##name,	\
864 			   sdev_store_evt_##name);
865 #define REF_EVT(name) &dev_attr_evt_##name.attr
866 
867 DECLARE_EVT(media_change, MEDIA_CHANGE)
868 DECLARE_EVT(inquiry_change_reported, INQUIRY_CHANGE_REPORTED)
869 DECLARE_EVT(capacity_change_reported, CAPACITY_CHANGE_REPORTED)
870 DECLARE_EVT(soft_threshold_reached, SOFT_THRESHOLD_REACHED_REPORTED)
871 DECLARE_EVT(mode_parameter_change_reported, MODE_PARAMETER_CHANGE_REPORTED)
872 DECLARE_EVT(lun_change_reported, LUN_CHANGE_REPORTED)
873 
874 static ssize_t
875 sdev_store_queue_depth(struct device *dev, struct device_attribute *attr,
876 		       const char *buf, size_t count)
877 {
878 	int depth, retval;
879 	struct scsi_device *sdev = to_scsi_device(dev);
880 	struct scsi_host_template *sht = sdev->host->hostt;
881 
882 	if (!sht->change_queue_depth)
883 		return -EINVAL;
884 
885 	depth = simple_strtoul(buf, NULL, 0);
886 
887 	if (depth < 1 || depth > sdev->host->can_queue)
888 		return -EINVAL;
889 
890 	retval = sht->change_queue_depth(sdev, depth);
891 	if (retval < 0)
892 		return retval;
893 
894 	sdev->max_queue_depth = sdev->queue_depth;
895 
896 	return count;
897 }
898 sdev_show_function(queue_depth, "%d\n");
899 
900 static DEVICE_ATTR(queue_depth, S_IRUGO | S_IWUSR, sdev_show_queue_depth,
901 		   sdev_store_queue_depth);
902 
903 static ssize_t
904 sdev_show_queue_ramp_up_period(struct device *dev,
905 			       struct device_attribute *attr,
906 			       char *buf)
907 {
908 	struct scsi_device *sdev;
909 	sdev = to_scsi_device(dev);
910 	return snprintf(buf, 20, "%u\n",
911 			jiffies_to_msecs(sdev->queue_ramp_up_period));
912 }
913 
914 static ssize_t
915 sdev_store_queue_ramp_up_period(struct device *dev,
916 				struct device_attribute *attr,
917 				const char *buf, size_t count)
918 {
919 	struct scsi_device *sdev = to_scsi_device(dev);
920 	unsigned int period;
921 
922 	if (kstrtouint(buf, 10, &period))
923 		return -EINVAL;
924 
925 	sdev->queue_ramp_up_period = msecs_to_jiffies(period);
926 	return count;
927 }
928 
929 static DEVICE_ATTR(queue_ramp_up_period, S_IRUGO | S_IWUSR,
930 		   sdev_show_queue_ramp_up_period,
931 		   sdev_store_queue_ramp_up_period);
932 
933 static umode_t scsi_sdev_attr_is_visible(struct kobject *kobj,
934 					 struct attribute *attr, int i)
935 {
936 	struct device *dev = container_of(kobj, struct device, kobj);
937 	struct scsi_device *sdev = to_scsi_device(dev);
938 
939 
940 	if (attr == &dev_attr_queue_depth.attr &&
941 	    !sdev->host->hostt->change_queue_depth)
942 		return S_IRUGO;
943 
944 	if (attr == &dev_attr_queue_ramp_up_period.attr &&
945 	    !sdev->host->hostt->change_queue_depth)
946 		return 0;
947 
948 	return attr->mode;
949 }
950 
951 /* Default template for device attributes.  May NOT be modified */
952 static struct attribute *scsi_sdev_attrs[] = {
953 	&dev_attr_device_blocked.attr,
954 	&dev_attr_type.attr,
955 	&dev_attr_scsi_level.attr,
956 	&dev_attr_device_busy.attr,
957 	&dev_attr_vendor.attr,
958 	&dev_attr_model.attr,
959 	&dev_attr_rev.attr,
960 	&dev_attr_rescan.attr,
961 	&dev_attr_delete.attr,
962 	&dev_attr_state.attr,
963 	&dev_attr_timeout.attr,
964 	&dev_attr_eh_timeout.attr,
965 	&dev_attr_iocounterbits.attr,
966 	&dev_attr_iorequest_cnt.attr,
967 	&dev_attr_iodone_cnt.attr,
968 	&dev_attr_ioerr_cnt.attr,
969 	&dev_attr_modalias.attr,
970 	&dev_attr_queue_depth.attr,
971 	&dev_attr_queue_type.attr,
972 	&dev_attr_queue_ramp_up_period.attr,
973 	REF_EVT(media_change),
974 	REF_EVT(inquiry_change_reported),
975 	REF_EVT(capacity_change_reported),
976 	REF_EVT(soft_threshold_reached),
977 	REF_EVT(mode_parameter_change_reported),
978 	REF_EVT(lun_change_reported),
979 	NULL
980 };
981 
982 static struct bin_attribute *scsi_sdev_bin_attrs[] = {
983 	&dev_attr_vpd_pg83,
984 	&dev_attr_vpd_pg80,
985 	&dev_attr_inquiry,
986 	NULL
987 };
988 static struct attribute_group scsi_sdev_attr_group = {
989 	.attrs =	scsi_sdev_attrs,
990 	.bin_attrs =	scsi_sdev_bin_attrs,
991 	.is_visible =	scsi_sdev_attr_is_visible,
992 };
993 
994 static const struct attribute_group *scsi_sdev_attr_groups[] = {
995 	&scsi_sdev_attr_group,
996 	NULL
997 };
998 
999 static int scsi_target_add(struct scsi_target *starget)
1000 {
1001 	int error;
1002 
1003 	if (starget->state != STARGET_CREATED)
1004 		return 0;
1005 
1006 	error = device_add(&starget->dev);
1007 	if (error) {
1008 		dev_err(&starget->dev, "target device_add failed, error %d\n", error);
1009 		return error;
1010 	}
1011 	transport_add_device(&starget->dev);
1012 	starget->state = STARGET_RUNNING;
1013 
1014 	pm_runtime_set_active(&starget->dev);
1015 	pm_runtime_enable(&starget->dev);
1016 	device_enable_async_suspend(&starget->dev);
1017 
1018 	return 0;
1019 }
1020 
1021 /**
1022  * scsi_sysfs_add_sdev - add scsi device to sysfs
1023  * @sdev:	scsi_device to add
1024  *
1025  * Return value:
1026  * 	0 on Success / non-zero on Failure
1027  **/
1028 int scsi_sysfs_add_sdev(struct scsi_device *sdev)
1029 {
1030 	int error, i;
1031 	struct request_queue *rq = sdev->request_queue;
1032 	struct scsi_target *starget = sdev->sdev_target;
1033 
1034 	error = scsi_device_set_state(sdev, SDEV_RUNNING);
1035 	if (error)
1036 		return error;
1037 
1038 	error = scsi_target_add(starget);
1039 	if (error)
1040 		return error;
1041 
1042 	transport_configure_device(&starget->dev);
1043 
1044 	device_enable_async_suspend(&sdev->sdev_gendev);
1045 	scsi_autopm_get_target(starget);
1046 	pm_runtime_set_active(&sdev->sdev_gendev);
1047 	pm_runtime_forbid(&sdev->sdev_gendev);
1048 	pm_runtime_enable(&sdev->sdev_gendev);
1049 	scsi_autopm_put_target(starget);
1050 
1051 	scsi_autopm_get_device(sdev);
1052 
1053 	error = device_add(&sdev->sdev_gendev);
1054 	if (error) {
1055 		sdev_printk(KERN_INFO, sdev,
1056 				"failed to add device: %d\n", error);
1057 		return error;
1058 	}
1059 
1060 	error = scsi_dh_add_device(sdev);
1061 	if (error) {
1062 		sdev_printk(KERN_INFO, sdev,
1063 				"failed to add device handler: %d\n", error);
1064 		return error;
1065 	}
1066 
1067 	device_enable_async_suspend(&sdev->sdev_dev);
1068 	error = device_add(&sdev->sdev_dev);
1069 	if (error) {
1070 		sdev_printk(KERN_INFO, sdev,
1071 				"failed to add class device: %d\n", error);
1072 		scsi_dh_remove_device(sdev);
1073 		device_del(&sdev->sdev_gendev);
1074 		return error;
1075 	}
1076 	transport_add_device(&sdev->sdev_gendev);
1077 	sdev->is_visible = 1;
1078 
1079 	error = bsg_register_queue(rq, &sdev->sdev_gendev, NULL, NULL);
1080 
1081 	if (error)
1082 		/* we're treating error on bsg register as non-fatal,
1083 		 * so pretend nothing went wrong */
1084 		sdev_printk(KERN_INFO, sdev,
1085 			    "Failed to register bsg queue, errno=%d\n", error);
1086 
1087 	/* add additional host specific attributes */
1088 	if (sdev->host->hostt->sdev_attrs) {
1089 		for (i = 0; sdev->host->hostt->sdev_attrs[i]; i++) {
1090 			error = device_create_file(&sdev->sdev_gendev,
1091 					sdev->host->hostt->sdev_attrs[i]);
1092 			if (error)
1093 				return error;
1094 		}
1095 	}
1096 
1097 	scsi_autopm_put_device(sdev);
1098 	return error;
1099 }
1100 
1101 void __scsi_remove_device(struct scsi_device *sdev)
1102 {
1103 	struct device *dev = &sdev->sdev_gendev;
1104 
1105 	if (sdev->is_visible) {
1106 		if (scsi_device_set_state(sdev, SDEV_CANCEL) != 0)
1107 			return;
1108 
1109 		bsg_unregister_queue(sdev->request_queue);
1110 		device_unregister(&sdev->sdev_dev);
1111 		transport_remove_device(dev);
1112 		scsi_dh_remove_device(sdev);
1113 	}
1114 
1115 	/*
1116 	 * Stop accepting new requests and wait until all queuecommand() and
1117 	 * scsi_run_queue() invocations have finished before tearing down the
1118 	 * device.
1119 	 */
1120 	scsi_device_set_state(sdev, SDEV_DEL);
1121 	blk_cleanup_queue(sdev->request_queue);
1122 	cancel_work_sync(&sdev->requeue_work);
1123 
1124 	/*
1125 	 * Remove the device after blk_cleanup_queue() has been called such
1126 	 * a possible bdi_register() call with the same name occurs after
1127 	 * blk_cleanup_queue() has called bdi_destroy().
1128 	 */
1129 	if (sdev->is_visible)
1130 		device_del(dev);
1131 	else
1132 		put_device(&sdev->sdev_dev);
1133 
1134 	if (sdev->host->hostt->slave_destroy)
1135 		sdev->host->hostt->slave_destroy(sdev);
1136 	transport_destroy_device(dev);
1137 
1138 	/*
1139 	 * Paired with the kref_get() in scsi_sysfs_initialize().  We have
1140 	 * remoed sysfs visibility from the device, so make the target
1141 	 * invisible if this was the last device underneath it.
1142 	 */
1143 	scsi_target_reap(scsi_target(sdev));
1144 
1145 	put_device(dev);
1146 }
1147 
1148 /**
1149  * scsi_remove_device - unregister a device from the scsi bus
1150  * @sdev:	scsi_device to unregister
1151  **/
1152 void scsi_remove_device(struct scsi_device *sdev)
1153 {
1154 	struct Scsi_Host *shost = sdev->host;
1155 
1156 	mutex_lock(&shost->scan_mutex);
1157 	__scsi_remove_device(sdev);
1158 	mutex_unlock(&shost->scan_mutex);
1159 }
1160 EXPORT_SYMBOL(scsi_remove_device);
1161 
1162 static void __scsi_remove_target(struct scsi_target *starget)
1163 {
1164 	struct Scsi_Host *shost = dev_to_shost(starget->dev.parent);
1165 	unsigned long flags;
1166 	struct scsi_device *sdev;
1167 
1168 	spin_lock_irqsave(shost->host_lock, flags);
1169  restart:
1170 	list_for_each_entry(sdev, &shost->__devices, siblings) {
1171 		if (sdev->channel != starget->channel ||
1172 		    sdev->id != starget->id ||
1173 		    scsi_device_get(sdev))
1174 			continue;
1175 		spin_unlock_irqrestore(shost->host_lock, flags);
1176 		scsi_remove_device(sdev);
1177 		scsi_device_put(sdev);
1178 		spin_lock_irqsave(shost->host_lock, flags);
1179 		goto restart;
1180 	}
1181 	spin_unlock_irqrestore(shost->host_lock, flags);
1182 }
1183 
1184 /**
1185  * scsi_remove_target - try to remove a target and all its devices
1186  * @dev: generic starget or parent of generic stargets to be removed
1187  *
1188  * Note: This is slightly racy.  It is possible that if the user
1189  * requests the addition of another device then the target won't be
1190  * removed.
1191  */
1192 void scsi_remove_target(struct device *dev)
1193 {
1194 	struct Scsi_Host *shost = dev_to_shost(dev->parent);
1195 	struct scsi_target *starget;
1196 	unsigned long flags;
1197 
1198 restart:
1199 	spin_lock_irqsave(shost->host_lock, flags);
1200 	list_for_each_entry(starget, &shost->__targets, siblings) {
1201 		if (starget->state == STARGET_DEL)
1202 			continue;
1203 		if (starget->dev.parent == dev || &starget->dev == dev) {
1204 			kref_get(&starget->reap_ref);
1205 			spin_unlock_irqrestore(shost->host_lock, flags);
1206 			__scsi_remove_target(starget);
1207 			scsi_target_reap(starget);
1208 			goto restart;
1209 		}
1210 	}
1211 	spin_unlock_irqrestore(shost->host_lock, flags);
1212 }
1213 EXPORT_SYMBOL(scsi_remove_target);
1214 
1215 int scsi_register_driver(struct device_driver *drv)
1216 {
1217 	drv->bus = &scsi_bus_type;
1218 
1219 	return driver_register(drv);
1220 }
1221 EXPORT_SYMBOL(scsi_register_driver);
1222 
1223 int scsi_register_interface(struct class_interface *intf)
1224 {
1225 	intf->class = &sdev_class;
1226 
1227 	return class_interface_register(intf);
1228 }
1229 EXPORT_SYMBOL(scsi_register_interface);
1230 
1231 /**
1232  * scsi_sysfs_add_host - add scsi host to subsystem
1233  * @shost:     scsi host struct to add to subsystem
1234  **/
1235 int scsi_sysfs_add_host(struct Scsi_Host *shost)
1236 {
1237 	int error, i;
1238 
1239 	/* add host specific attributes */
1240 	if (shost->hostt->shost_attrs) {
1241 		for (i = 0; shost->hostt->shost_attrs[i]; i++) {
1242 			error = device_create_file(&shost->shost_dev,
1243 					shost->hostt->shost_attrs[i]);
1244 			if (error)
1245 				return error;
1246 		}
1247 	}
1248 
1249 	transport_register_device(&shost->shost_gendev);
1250 	transport_configure_device(&shost->shost_gendev);
1251 	return 0;
1252 }
1253 
1254 static struct device_type scsi_dev_type = {
1255 	.name =		"scsi_device",
1256 	.release =	scsi_device_dev_release,
1257 	.groups =	scsi_sdev_attr_groups,
1258 };
1259 
1260 void scsi_sysfs_device_initialize(struct scsi_device *sdev)
1261 {
1262 	unsigned long flags;
1263 	struct Scsi_Host *shost = sdev->host;
1264 	struct scsi_target  *starget = sdev->sdev_target;
1265 
1266 	device_initialize(&sdev->sdev_gendev);
1267 	sdev->sdev_gendev.bus = &scsi_bus_type;
1268 	sdev->sdev_gendev.type = &scsi_dev_type;
1269 	dev_set_name(&sdev->sdev_gendev, "%d:%d:%d:%llu",
1270 		     sdev->host->host_no, sdev->channel, sdev->id, sdev->lun);
1271 
1272 	device_initialize(&sdev->sdev_dev);
1273 	sdev->sdev_dev.parent = get_device(&sdev->sdev_gendev);
1274 	sdev->sdev_dev.class = &sdev_class;
1275 	dev_set_name(&sdev->sdev_dev, "%d:%d:%d:%llu",
1276 		     sdev->host->host_no, sdev->channel, sdev->id, sdev->lun);
1277 	/*
1278 	 * Get a default scsi_level from the target (derived from sibling
1279 	 * devices).  This is the best we can do for guessing how to set
1280 	 * sdev->lun_in_cdb for the initial INQUIRY command.  For LUN 0 the
1281 	 * setting doesn't matter, because all the bits are zero anyway.
1282 	 * But it does matter for higher LUNs.
1283 	 */
1284 	sdev->scsi_level = starget->scsi_level;
1285 	if (sdev->scsi_level <= SCSI_2 &&
1286 			sdev->scsi_level != SCSI_UNKNOWN &&
1287 			!shost->no_scsi2_lun_in_cdb)
1288 		sdev->lun_in_cdb = 1;
1289 
1290 	transport_setup_device(&sdev->sdev_gendev);
1291 	spin_lock_irqsave(shost->host_lock, flags);
1292 	list_add_tail(&sdev->same_target_siblings, &starget->devices);
1293 	list_add_tail(&sdev->siblings, &shost->__devices);
1294 	spin_unlock_irqrestore(shost->host_lock, flags);
1295 	/*
1296 	 * device can now only be removed via __scsi_remove_device() so hold
1297 	 * the target.  Target will be held in CREATED state until something
1298 	 * beneath it becomes visible (in which case it moves to RUNNING)
1299 	 */
1300 	kref_get(&starget->reap_ref);
1301 }
1302 
1303 int scsi_is_sdev_device(const struct device *dev)
1304 {
1305 	return dev->type == &scsi_dev_type;
1306 }
1307 EXPORT_SYMBOL(scsi_is_sdev_device);
1308 
1309 /* A blank transport template that is used in drivers that don't
1310  * yet implement Transport Attributes */
1311 struct scsi_transport_template blank_transport_template = { { { {NULL, }, }, }, };
1312