4 * SCSI sysfs interface routines.
6 * Created to pull SCSI mid layer sysfs routines into one file.
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>
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>
23 #include "scsi_priv.h"
24 #include "scsi_logging.h"
26 static struct device_type scsi_dev_type;
29 enum scsi_device_state value;
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" },
43 const char *scsi_device_state_name(enum scsi_device_state state)
48 for (i = 0; i < ARRAY_SIZE(sdev_states); i++) {
49 if (sdev_states[i].value == state) {
50 name = sdev_states[i].name;
58 enum scsi_host_state value;
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", },
69 const char *scsi_host_state_name(enum scsi_host_state state)
74 for (i = 0; i < ARRAY_SIZE(shost_states); i++) {
75 if (shost_states[i].value == state) {
76 name = shost_states[i].name;
83 static int check_set(unsigned long long *val, char *src)
87 if (strncmp(src, "-", 20) == 0) {
88 *val = SCAN_WILD_CARD;
91 * Doesn't check for int overflow
93 *val = simple_strtoull(src, &last, 0);
100 static int scsi_scan(struct Scsi_Host *shost, const char *str)
102 char s1[15], s2[15], s3[17], junk;
103 unsigned long long channel, id, lun;
106 res = sscanf(str, "%10s %10s %16s %c", s1, s2, s3, &junk);
109 if (check_set(&channel, s1))
111 if (check_set(&id, s2))
113 if (check_set(&lun, s3))
115 if (shost->transportt->user_scan)
116 res = shost->transportt->user_scan(shost, channel, id, lun);
118 res = scsi_scan_host_selected(shost, channel, id, lun, 1);
123 * shost_show_function: macro to create an attr function that can be used to
124 * show a non-bit field.
126 #define shost_show_function(name, field, format_string) \
128 show_##name (struct device *dev, struct device_attribute *attr, \
131 struct Scsi_Host *shost = class_to_shost(dev); \
132 return snprintf (buf, 20, format_string, shost->field); \
136 * shost_rd_attr: macro to create a function and attribute variable for a
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);
143 #define shost_rd_attr(field, format_string) \
144 shost_rd_attr2(field, field, format_string)
147 * Create the actual show/store functions and data structures.
151 store_scan(struct device *dev, struct device_attribute *attr,
152 const char *buf, size_t count)
154 struct Scsi_Host *shost = class_to_shost(dev);
157 res = scsi_scan(shost, buf);
162 static DEVICE_ATTR(scan, S_IWUSR, NULL, store_scan);
165 store_shost_state(struct device *dev, struct device_attribute *attr,
166 const char *buf, size_t count)
169 struct Scsi_Host *shost = class_to_shost(dev);
170 enum scsi_host_state state = 0;
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 &&
176 state = shost_states[i].value;
183 if (scsi_host_set_state(shost, state))
189 show_shost_state(struct device *dev, struct device_attribute *attr, char *buf)
191 struct Scsi_Host *shost = class_to_shost(dev);
192 const char *name = scsi_host_state_name(shost->shost_state);
197 return snprintf(buf, 20, "%s\n", name);
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);
205 show_shost_mode(unsigned int mode, char *buf)
209 if (mode & MODE_INITIATOR)
210 len = sprintf(buf, "%s", "Initiator");
212 if (mode & MODE_TARGET)
213 len += sprintf(buf + len, "%s%s", len ? ", " : "", "Target");
215 len += sprintf(buf + len, "\n");
221 show_shost_supported_mode(struct device *dev, struct device_attribute *attr,
224 struct Scsi_Host *shost = class_to_shost(dev);
225 unsigned int supported_mode = shost->hostt->supported_mode;
227 if (supported_mode == MODE_UNKNOWN)
228 /* by default this should be initiator */
229 supported_mode = MODE_INITIATOR;
231 return show_shost_mode(supported_mode, buf);
234 static DEVICE_ATTR(supported_mode, S_IRUGO | S_IWUSR, show_shost_supported_mode, NULL);
237 show_shost_active_mode(struct device *dev,
238 struct device_attribute *attr, char *buf)
240 struct Scsi_Host *shost = class_to_shost(dev);
242 if (shost->active_mode == MODE_UNKNOWN)
243 return snprintf(buf, 20, "unknown\n");
245 return show_shost_mode(shost->active_mode, buf);
248 static DEVICE_ATTR(active_mode, S_IRUGO | S_IWUSR, show_shost_active_mode, NULL);
250 static int check_reset_type(const char *str)
252 if (sysfs_streq(str, "adapter"))
253 return SCSI_ADAPTER_RESET;
254 else if (sysfs_streq(str, "firmware"))
255 return SCSI_FIRMWARE_RESET;
261 store_host_reset(struct device *dev, struct device_attribute *attr,
262 const char *buf, size_t count)
264 struct Scsi_Host *shost = class_to_shost(dev);
265 struct scsi_host_template *sht = shost->hostt;
269 type = check_reset_type(buf);
271 goto exit_store_host_reset;
274 ret = sht->host_reset(shost, type);
276 exit_store_host_reset:
282 static DEVICE_ATTR(host_reset, S_IWUSR, NULL, store_host_reset);
285 show_shost_eh_deadline(struct device *dev,
286 struct device_attribute *attr, char *buf)
288 struct Scsi_Host *shost = class_to_shost(dev);
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);
296 store_shost_eh_deadline(struct device *dev, struct device_attribute *attr,
297 const char *buf, size_t count)
299 struct Scsi_Host *shost = class_to_shost(dev);
301 unsigned long deadline, flags;
303 if (shost->transportt &&
304 (shost->transportt->eh_strategy_handler ||
305 !shost->hostt->eh_host_reset_handler))
308 if (!strncmp(buf, "off", strlen("off")))
311 ret = kstrtoul(buf, 10, &deadline);
314 if (deadline * HZ > UINT_MAX)
318 spin_lock_irqsave(shost->host_lock, flags);
319 if (scsi_host_in_recovery(shost))
323 shost->eh_deadline = -1;
325 shost->eh_deadline = deadline * HZ;
329 spin_unlock_irqrestore(shost->host_lock, flags);
334 static DEVICE_ATTR(eh_deadline, S_IRUGO | S_IWUSR, show_shost_eh_deadline, store_shost_eh_deadline);
336 shost_rd_attr(unique_id, "%u\n");
337 shost_rd_attr(cmd_per_lun, "%hd\n");
338 shost_rd_attr(can_queue, "%hd\n");
339 shost_rd_attr(sg_tablesize, "%hu\n");
340 shost_rd_attr(sg_prot_tablesize, "%hu\n");
341 shost_rd_attr(unchecked_isa_dma, "%d\n");
342 shost_rd_attr(prot_capabilities, "%u\n");
343 shost_rd_attr(prot_guard_type, "%hd\n");
344 shost_rd_attr2(proc_name, hostt->proc_name, "%s\n");
347 show_host_busy(struct device *dev, struct device_attribute *attr, char *buf)
349 struct Scsi_Host *shost = class_to_shost(dev);
350 return snprintf(buf, 20, "%d\n", atomic_read(&shost->host_busy));
352 static DEVICE_ATTR(host_busy, S_IRUGO, show_host_busy, NULL);
354 static struct attribute *scsi_sysfs_shost_attrs[] = {
355 &dev_attr_unique_id.attr,
356 &dev_attr_host_busy.attr,
357 &dev_attr_cmd_per_lun.attr,
358 &dev_attr_can_queue.attr,
359 &dev_attr_sg_tablesize.attr,
360 &dev_attr_sg_prot_tablesize.attr,
361 &dev_attr_unchecked_isa_dma.attr,
362 &dev_attr_proc_name.attr,
364 &dev_attr_hstate.attr,
365 &dev_attr_supported_mode.attr,
366 &dev_attr_active_mode.attr,
367 &dev_attr_prot_capabilities.attr,
368 &dev_attr_prot_guard_type.attr,
369 &dev_attr_host_reset.attr,
370 &dev_attr_eh_deadline.attr,
374 struct attribute_group scsi_shost_attr_group = {
375 .attrs = scsi_sysfs_shost_attrs,
378 const struct attribute_group *scsi_sysfs_shost_attr_groups[] = {
379 &scsi_shost_attr_group,
383 static void scsi_device_cls_release(struct device *class_dev)
385 struct scsi_device *sdev;
387 sdev = class_to_sdev(class_dev);
388 put_device(&sdev->sdev_gendev);
391 static void scsi_device_dev_release_usercontext(struct work_struct *work)
393 struct scsi_device *sdev;
394 struct device *parent;
395 struct list_head *this, *tmp;
398 sdev = container_of(work, struct scsi_device, ew.work);
400 parent = sdev->sdev_gendev.parent;
402 spin_lock_irqsave(sdev->host->host_lock, flags);
403 list_del(&sdev->siblings);
404 list_del(&sdev->same_target_siblings);
405 list_del(&sdev->starved_entry);
406 spin_unlock_irqrestore(sdev->host->host_lock, flags);
408 cancel_work_sync(&sdev->event_work);
410 list_for_each_safe(this, tmp, &sdev->event_list) {
411 struct scsi_event *evt;
413 evt = list_entry(this, struct scsi_event, node);
414 list_del(&evt->node);
418 blk_put_queue(sdev->request_queue);
419 /* NULL queue means the device can't be used */
420 sdev->request_queue = NULL;
422 kfree(sdev->vpd_pg83);
423 kfree(sdev->vpd_pg80);
424 kfree(sdev->inquiry);
431 static void scsi_device_dev_release(struct device *dev)
433 struct scsi_device *sdp = to_scsi_device(dev);
434 execute_in_process_context(scsi_device_dev_release_usercontext,
438 static struct class sdev_class = {
439 .name = "scsi_device",
440 .dev_release = scsi_device_cls_release,
443 /* all probing is done in the individual ->probe routines */
444 static int scsi_bus_match(struct device *dev, struct device_driver *gendrv)
446 struct scsi_device *sdp;
448 if (dev->type != &scsi_dev_type)
451 sdp = to_scsi_device(dev);
452 if (sdp->no_uld_attach)
454 return (sdp->inq_periph_qual == SCSI_INQ_PQ_CON)? 1: 0;
457 static int scsi_bus_uevent(struct device *dev, struct kobj_uevent_env *env)
459 struct scsi_device *sdev;
461 if (dev->type != &scsi_dev_type)
464 sdev = to_scsi_device(dev);
466 add_uevent_var(env, "MODALIAS=" SCSI_DEVICE_MODALIAS_FMT, sdev->type);
470 struct bus_type scsi_bus_type = {
472 .match = scsi_bus_match,
473 .uevent = scsi_bus_uevent,
475 .pm = &scsi_bus_pm_ops,
478 EXPORT_SYMBOL_GPL(scsi_bus_type);
480 int scsi_sysfs_register(void)
484 error = bus_register(&scsi_bus_type);
486 error = class_register(&sdev_class);
488 bus_unregister(&scsi_bus_type);
494 void scsi_sysfs_unregister(void)
496 class_unregister(&sdev_class);
497 bus_unregister(&scsi_bus_type);
501 * sdev_show_function: macro to create an attr function that can be used to
502 * show a non-bit field.
504 #define sdev_show_function(field, format_string) \
506 sdev_show_##field (struct device *dev, struct device_attribute *attr, \
509 struct scsi_device *sdev; \
510 sdev = to_scsi_device(dev); \
511 return snprintf (buf, 20, format_string, sdev->field); \
515 * sdev_rd_attr: macro to create a function and attribute variable for a
518 #define sdev_rd_attr(field, format_string) \
519 sdev_show_function(field, format_string) \
520 static DEVICE_ATTR(field, S_IRUGO, sdev_show_##field, NULL);
524 * sdev_rw_attr: create a function and attribute variable for a
527 #define sdev_rw_attr(field, format_string) \
528 sdev_show_function(field, format_string) \
531 sdev_store_##field (struct device *dev, struct device_attribute *attr, \
532 const char *buf, size_t count) \
534 struct scsi_device *sdev; \
535 sdev = to_scsi_device(dev); \
536 sscanf (buf, format_string, &sdev->field); \
539 static DEVICE_ATTR(field, S_IRUGO | S_IWUSR, sdev_show_##field, sdev_store_##field);
541 /* Currently we don't export bit fields, but we might in future,
542 * so leave this code in */
545 * sdev_rd_attr: create a function and attribute variable for a
546 * read/write bit field.
548 #define sdev_rw_attr_bit(field) \
549 sdev_show_function(field, "%d\n") \
552 sdev_store_##field (struct device *dev, struct device_attribute *attr, \
553 const char *buf, size_t count) \
556 struct scsi_device *sdev; \
557 ret = scsi_sdev_check_buf_bit(buf); \
559 sdev = to_scsi_device(dev); \
565 static DEVICE_ATTR(field, S_IRUGO | S_IWUSR, sdev_show_##field, sdev_store_##field);
568 * scsi_sdev_check_buf_bit: return 0 if buf is "0", return 1 if buf is "1",
569 * else return -EINVAL.
571 static int scsi_sdev_check_buf_bit(const char *buf)
573 if ((buf[1] == '\0') || ((buf[1] == '\n') && (buf[2] == '\0'))) {
576 else if (buf[0] == '0')
585 * Create the actual show/store functions and data structures.
587 sdev_rd_attr (device_blocked, "%d\n");
588 sdev_rd_attr (device_busy, "%d\n");
589 sdev_rd_attr (type, "%d\n");
590 sdev_rd_attr (scsi_level, "%d\n");
591 sdev_rd_attr (vendor, "%.8s\n");
592 sdev_rd_attr (model, "%.16s\n");
593 sdev_rd_attr (rev, "%.4s\n");
596 * TODO: can we make these symlinks to the block layer ones?
599 sdev_show_timeout (struct device *dev, struct device_attribute *attr, char *buf)
601 struct scsi_device *sdev;
602 sdev = to_scsi_device(dev);
603 return snprintf(buf, 20, "%d\n", sdev->request_queue->rq_timeout / HZ);
607 sdev_store_timeout (struct device *dev, struct device_attribute *attr,
608 const char *buf, size_t count)
610 struct scsi_device *sdev;
612 sdev = to_scsi_device(dev);
613 sscanf (buf, "%d\n", &timeout);
614 blk_queue_rq_timeout(sdev->request_queue, timeout * HZ);
617 static DEVICE_ATTR(timeout, S_IRUGO | S_IWUSR, sdev_show_timeout, sdev_store_timeout);
620 sdev_show_eh_timeout(struct device *dev, struct device_attribute *attr, char *buf)
622 struct scsi_device *sdev;
623 sdev = to_scsi_device(dev);
624 return snprintf(buf, 20, "%u\n", sdev->eh_timeout / HZ);
628 sdev_store_eh_timeout(struct device *dev, struct device_attribute *attr,
629 const char *buf, size_t count)
631 struct scsi_device *sdev;
632 unsigned int eh_timeout;
635 if (!capable(CAP_SYS_ADMIN))
638 sdev = to_scsi_device(dev);
639 err = kstrtouint(buf, 10, &eh_timeout);
642 sdev->eh_timeout = eh_timeout * HZ;
646 static DEVICE_ATTR(eh_timeout, S_IRUGO | S_IWUSR, sdev_show_eh_timeout, sdev_store_eh_timeout);
649 store_rescan_field (struct device *dev, struct device_attribute *attr,
650 const char *buf, size_t count)
652 scsi_rescan_device(dev);
655 static DEVICE_ATTR(rescan, S_IWUSR, NULL, store_rescan_field);
658 sdev_store_delete(struct device *dev, struct device_attribute *attr,
659 const char *buf, size_t count)
661 if (device_remove_file_self(dev, attr))
662 scsi_remove_device(to_scsi_device(dev));
665 static DEVICE_ATTR(delete, S_IWUSR, NULL, sdev_store_delete);
668 store_state_field(struct device *dev, struct device_attribute *attr,
669 const char *buf, size_t count)
672 struct scsi_device *sdev = to_scsi_device(dev);
673 enum scsi_device_state state = 0;
675 for (i = 0; i < ARRAY_SIZE(sdev_states); i++) {
676 const int len = strlen(sdev_states[i].name);
677 if (strncmp(sdev_states[i].name, buf, len) == 0 &&
679 state = sdev_states[i].value;
686 if (scsi_device_set_state(sdev, state))
692 show_state_field(struct device *dev, struct device_attribute *attr, char *buf)
694 struct scsi_device *sdev = to_scsi_device(dev);
695 const char *name = scsi_device_state_name(sdev->sdev_state);
700 return snprintf(buf, 20, "%s\n", name);
703 static DEVICE_ATTR(state, S_IRUGO | S_IWUSR, show_state_field, store_state_field);
706 show_queue_type_field(struct device *dev, struct device_attribute *attr,
709 struct scsi_device *sdev = to_scsi_device(dev);
710 const char *name = "none";
712 if (sdev->ordered_tags)
714 else if (sdev->simple_tags)
717 return snprintf(buf, 20, "%s\n", name);
721 store_queue_type_field(struct device *dev, struct device_attribute *attr,
722 const char *buf, size_t count)
724 struct scsi_device *sdev = to_scsi_device(dev);
725 struct scsi_host_template *sht = sdev->host->hostt;
726 int tag_type = 0, retval;
727 int prev_tag_type = scsi_get_tag_type(sdev);
729 if (!sdev->tagged_supported || !sht->change_queue_type)
732 if (strncmp(buf, "ordered", 7) == 0)
733 tag_type = MSG_ORDERED_TAG;
734 else if (strncmp(buf, "simple", 6) == 0)
735 tag_type = MSG_SIMPLE_TAG;
736 else if (strncmp(buf, "none", 4) != 0)
739 if (tag_type == prev_tag_type)
742 retval = sht->change_queue_type(sdev, tag_type);
749 static DEVICE_ATTR(queue_type, S_IRUGO | S_IWUSR, show_queue_type_field,
750 store_queue_type_field);
752 #define sdev_vpd_pg_attr(_page) \
754 show_vpd_##_page(struct file *filp, struct kobject *kobj, \
755 struct bin_attribute *bin_attr, \
756 char *buf, loff_t off, size_t count) \
758 struct device *dev = container_of(kobj, struct device, kobj); \
759 struct scsi_device *sdev = to_scsi_device(dev); \
760 if (!sdev->vpd_##_page) \
762 return memory_read_from_buffer(buf, count, &off, \
764 sdev->vpd_##_page##_len); \
766 static struct bin_attribute dev_attr_vpd_##_page = { \
767 .attr = {.name = __stringify(vpd_##_page), .mode = S_IRUGO }, \
769 .read = show_vpd_##_page, \
772 sdev_vpd_pg_attr(pg83);
773 sdev_vpd_pg_attr(pg80);
776 show_iostat_counterbits(struct device *dev, struct device_attribute *attr,
779 return snprintf(buf, 20, "%d\n", (int)sizeof(atomic_t) * 8);
782 static DEVICE_ATTR(iocounterbits, S_IRUGO, show_iostat_counterbits, NULL);
784 #define show_sdev_iostat(field) \
786 show_iostat_##field(struct device *dev, struct device_attribute *attr, \
789 struct scsi_device *sdev = to_scsi_device(dev); \
790 unsigned long long count = atomic_read(&sdev->field); \
791 return snprintf(buf, 20, "0x%llx\n", count); \
793 static DEVICE_ATTR(field, S_IRUGO, show_iostat_##field, NULL)
795 show_sdev_iostat(iorequest_cnt);
796 show_sdev_iostat(iodone_cnt);
797 show_sdev_iostat(ioerr_cnt);
800 sdev_show_modalias(struct device *dev, struct device_attribute *attr, char *buf)
802 struct scsi_device *sdev;
803 sdev = to_scsi_device(dev);
804 return snprintf (buf, 20, SCSI_DEVICE_MODALIAS_FMT "\n", sdev->type);
806 static DEVICE_ATTR(modalias, S_IRUGO, sdev_show_modalias, NULL);
808 #define DECLARE_EVT_SHOW(name, Cap_name) \
810 sdev_show_evt_##name(struct device *dev, struct device_attribute *attr, \
813 struct scsi_device *sdev = to_scsi_device(dev); \
814 int val = test_bit(SDEV_EVT_##Cap_name, sdev->supported_events);\
815 return snprintf(buf, 20, "%d\n", val); \
818 #define DECLARE_EVT_STORE(name, Cap_name) \
820 sdev_store_evt_##name(struct device *dev, struct device_attribute *attr,\
821 const char *buf, size_t count) \
823 struct scsi_device *sdev = to_scsi_device(dev); \
824 int val = simple_strtoul(buf, NULL, 0); \
826 clear_bit(SDEV_EVT_##Cap_name, sdev->supported_events); \
828 set_bit(SDEV_EVT_##Cap_name, sdev->supported_events); \
834 #define DECLARE_EVT(name, Cap_name) \
835 DECLARE_EVT_SHOW(name, Cap_name) \
836 DECLARE_EVT_STORE(name, Cap_name) \
837 static DEVICE_ATTR(evt_##name, S_IRUGO, sdev_show_evt_##name, \
838 sdev_store_evt_##name);
839 #define REF_EVT(name) &dev_attr_evt_##name.attr
841 DECLARE_EVT(media_change, MEDIA_CHANGE)
842 DECLARE_EVT(inquiry_change_reported, INQUIRY_CHANGE_REPORTED)
843 DECLARE_EVT(capacity_change_reported, CAPACITY_CHANGE_REPORTED)
844 DECLARE_EVT(soft_threshold_reached, SOFT_THRESHOLD_REACHED_REPORTED)
845 DECLARE_EVT(mode_parameter_change_reported, MODE_PARAMETER_CHANGE_REPORTED)
846 DECLARE_EVT(lun_change_reported, LUN_CHANGE_REPORTED)
849 sdev_store_queue_depth(struct device *dev, struct device_attribute *attr,
850 const char *buf, size_t count)
853 struct scsi_device *sdev = to_scsi_device(dev);
854 struct scsi_host_template *sht = sdev->host->hostt;
856 if (!sht->change_queue_depth)
859 depth = simple_strtoul(buf, NULL, 0);
864 retval = sht->change_queue_depth(sdev, depth,
865 SCSI_QDEPTH_DEFAULT);
869 sdev->max_queue_depth = sdev->queue_depth;
873 sdev_show_function(queue_depth, "%d\n");
875 static DEVICE_ATTR(queue_depth, S_IRUGO | S_IWUSR, sdev_show_queue_depth,
876 sdev_store_queue_depth);
879 sdev_show_queue_ramp_up_period(struct device *dev,
880 struct device_attribute *attr,
883 struct scsi_device *sdev;
884 sdev = to_scsi_device(dev);
885 return snprintf(buf, 20, "%u\n",
886 jiffies_to_msecs(sdev->queue_ramp_up_period));
890 sdev_store_queue_ramp_up_period(struct device *dev,
891 struct device_attribute *attr,
892 const char *buf, size_t count)
894 struct scsi_device *sdev = to_scsi_device(dev);
895 unsigned long period;
897 if (strict_strtoul(buf, 10, &period))
900 sdev->queue_ramp_up_period = msecs_to_jiffies(period);
904 static DEVICE_ATTR(queue_ramp_up_period, S_IRUGO | S_IWUSR,
905 sdev_show_queue_ramp_up_period,
906 sdev_store_queue_ramp_up_period);
908 static umode_t scsi_sdev_attr_is_visible(struct kobject *kobj,
909 struct attribute *attr, int i)
911 struct device *dev = container_of(kobj, struct device, kobj);
912 struct scsi_device *sdev = to_scsi_device(dev);
915 if (attr == &dev_attr_queue_depth.attr &&
916 !sdev->host->hostt->change_queue_depth)
919 if (attr == &dev_attr_queue_ramp_up_period.attr &&
920 !sdev->host->hostt->change_queue_depth)
923 if (attr == &dev_attr_queue_type.attr &&
924 !sdev->host->hostt->change_queue_type)
930 /* Default template for device attributes. May NOT be modified */
931 static struct attribute *scsi_sdev_attrs[] = {
932 &dev_attr_device_blocked.attr,
934 &dev_attr_scsi_level.attr,
935 &dev_attr_device_busy.attr,
936 &dev_attr_vendor.attr,
937 &dev_attr_model.attr,
939 &dev_attr_rescan.attr,
940 &dev_attr_delete.attr,
941 &dev_attr_state.attr,
942 &dev_attr_timeout.attr,
943 &dev_attr_eh_timeout.attr,
944 &dev_attr_iocounterbits.attr,
945 &dev_attr_iorequest_cnt.attr,
946 &dev_attr_iodone_cnt.attr,
947 &dev_attr_ioerr_cnt.attr,
948 &dev_attr_modalias.attr,
949 &dev_attr_queue_depth.attr,
950 &dev_attr_queue_type.attr,
951 &dev_attr_queue_ramp_up_period.attr,
952 REF_EVT(media_change),
953 REF_EVT(inquiry_change_reported),
954 REF_EVT(capacity_change_reported),
955 REF_EVT(soft_threshold_reached),
956 REF_EVT(mode_parameter_change_reported),
957 REF_EVT(lun_change_reported),
961 static struct bin_attribute *scsi_sdev_bin_attrs[] = {
966 static struct attribute_group scsi_sdev_attr_group = {
967 .attrs = scsi_sdev_attrs,
968 .bin_attrs = scsi_sdev_bin_attrs,
969 .is_visible = scsi_sdev_attr_is_visible,
972 static const struct attribute_group *scsi_sdev_attr_groups[] = {
973 &scsi_sdev_attr_group,
977 static int scsi_target_add(struct scsi_target *starget)
981 if (starget->state != STARGET_CREATED)
984 error = device_add(&starget->dev);
986 dev_err(&starget->dev, "target device_add failed, error %d\n", error);
989 transport_add_device(&starget->dev);
990 starget->state = STARGET_RUNNING;
992 pm_runtime_set_active(&starget->dev);
993 pm_runtime_enable(&starget->dev);
994 device_enable_async_suspend(&starget->dev);
1000 * scsi_sysfs_add_sdev - add scsi device to sysfs
1001 * @sdev: scsi_device to add
1004 * 0 on Success / non-zero on Failure
1006 int scsi_sysfs_add_sdev(struct scsi_device *sdev)
1009 struct request_queue *rq = sdev->request_queue;
1010 struct scsi_target *starget = sdev->sdev_target;
1012 error = scsi_device_set_state(sdev, SDEV_RUNNING);
1016 error = scsi_target_add(starget);
1020 transport_configure_device(&starget->dev);
1022 device_enable_async_suspend(&sdev->sdev_gendev);
1023 scsi_autopm_get_target(starget);
1024 pm_runtime_set_active(&sdev->sdev_gendev);
1025 pm_runtime_forbid(&sdev->sdev_gendev);
1026 pm_runtime_enable(&sdev->sdev_gendev);
1027 scsi_autopm_put_target(starget);
1029 /* The following call will keep sdev active indefinitely, until
1030 * its driver does a corresponding scsi_autopm_pm_device(). Only
1031 * drivers supporting autosuspend will do this.
1033 scsi_autopm_get_device(sdev);
1035 error = device_add(&sdev->sdev_gendev);
1037 sdev_printk(KERN_INFO, sdev,
1038 "failed to add device: %d\n", error);
1041 device_enable_async_suspend(&sdev->sdev_dev);
1042 error = device_add(&sdev->sdev_dev);
1044 sdev_printk(KERN_INFO, sdev,
1045 "failed to add class device: %d\n", error);
1046 device_del(&sdev->sdev_gendev);
1049 transport_add_device(&sdev->sdev_gendev);
1050 sdev->is_visible = 1;
1052 error = bsg_register_queue(rq, &sdev->sdev_gendev, NULL, NULL);
1055 /* we're treating error on bsg register as non-fatal,
1056 * so pretend nothing went wrong */
1057 sdev_printk(KERN_INFO, sdev,
1058 "Failed to register bsg queue, errno=%d\n", error);
1060 /* add additional host specific attributes */
1061 if (sdev->host->hostt->sdev_attrs) {
1062 for (i = 0; sdev->host->hostt->sdev_attrs[i]; i++) {
1063 error = device_create_file(&sdev->sdev_gendev,
1064 sdev->host->hostt->sdev_attrs[i]);
1073 void __scsi_remove_device(struct scsi_device *sdev)
1075 struct device *dev = &sdev->sdev_gendev;
1077 if (sdev->is_visible) {
1078 if (scsi_device_set_state(sdev, SDEV_CANCEL) != 0)
1081 bsg_unregister_queue(sdev->request_queue);
1082 device_unregister(&sdev->sdev_dev);
1083 transport_remove_device(dev);
1086 put_device(&sdev->sdev_dev);
1089 * Stop accepting new requests and wait until all queuecommand() and
1090 * scsi_run_queue() invocations have finished before tearing down the
1093 scsi_device_set_state(sdev, SDEV_DEL);
1094 blk_cleanup_queue(sdev->request_queue);
1095 cancel_work_sync(&sdev->requeue_work);
1097 if (sdev->host->hostt->slave_destroy)
1098 sdev->host->hostt->slave_destroy(sdev);
1099 transport_destroy_device(dev);
1102 * Paired with the kref_get() in scsi_sysfs_initialize(). We have
1103 * remoed sysfs visibility from the device, so make the target
1104 * invisible if this was the last device underneath it.
1106 scsi_target_reap(scsi_target(sdev));
1112 * scsi_remove_device - unregister a device from the scsi bus
1113 * @sdev: scsi_device to unregister
1115 void scsi_remove_device(struct scsi_device *sdev)
1117 struct Scsi_Host *shost = sdev->host;
1119 mutex_lock(&shost->scan_mutex);
1120 __scsi_remove_device(sdev);
1121 mutex_unlock(&shost->scan_mutex);
1123 EXPORT_SYMBOL(scsi_remove_device);
1125 static void __scsi_remove_target(struct scsi_target *starget)
1127 struct Scsi_Host *shost = dev_to_shost(starget->dev.parent);
1128 unsigned long flags;
1129 struct scsi_device *sdev;
1131 spin_lock_irqsave(shost->host_lock, flags);
1133 list_for_each_entry(sdev, &shost->__devices, siblings) {
1134 if (sdev->channel != starget->channel ||
1135 sdev->id != starget->id ||
1136 scsi_device_get(sdev))
1138 spin_unlock_irqrestore(shost->host_lock, flags);
1139 scsi_remove_device(sdev);
1140 scsi_device_put(sdev);
1141 spin_lock_irqsave(shost->host_lock, flags);
1144 spin_unlock_irqrestore(shost->host_lock, flags);
1148 * scsi_remove_target - try to remove a target and all its devices
1149 * @dev: generic starget or parent of generic stargets to be removed
1151 * Note: This is slightly racy. It is possible that if the user
1152 * requests the addition of another device then the target won't be
1155 void scsi_remove_target(struct device *dev)
1157 struct Scsi_Host *shost = dev_to_shost(dev->parent);
1158 struct scsi_target *starget, *last = NULL;
1159 unsigned long flags;
1161 /* remove targets being careful to lookup next entry before
1164 spin_lock_irqsave(shost->host_lock, flags);
1165 list_for_each_entry(starget, &shost->__targets, siblings) {
1166 if (starget->state == STARGET_DEL)
1168 if (starget->dev.parent == dev || &starget->dev == dev) {
1169 /* assuming new targets arrive at the end */
1170 kref_get(&starget->reap_ref);
1171 spin_unlock_irqrestore(shost->host_lock, flags);
1173 scsi_target_reap(last);
1175 __scsi_remove_target(starget);
1176 spin_lock_irqsave(shost->host_lock, flags);
1179 spin_unlock_irqrestore(shost->host_lock, flags);
1182 scsi_target_reap(last);
1184 EXPORT_SYMBOL(scsi_remove_target);
1186 int scsi_register_driver(struct device_driver *drv)
1188 drv->bus = &scsi_bus_type;
1190 return driver_register(drv);
1192 EXPORT_SYMBOL(scsi_register_driver);
1194 int scsi_register_interface(struct class_interface *intf)
1196 intf->class = &sdev_class;
1198 return class_interface_register(intf);
1200 EXPORT_SYMBOL(scsi_register_interface);
1203 * scsi_sysfs_add_host - add scsi host to subsystem
1204 * @shost: scsi host struct to add to subsystem
1206 int scsi_sysfs_add_host(struct Scsi_Host *shost)
1210 /* add host specific attributes */
1211 if (shost->hostt->shost_attrs) {
1212 for (i = 0; shost->hostt->shost_attrs[i]; i++) {
1213 error = device_create_file(&shost->shost_dev,
1214 shost->hostt->shost_attrs[i]);
1220 transport_register_device(&shost->shost_gendev);
1221 transport_configure_device(&shost->shost_gendev);
1225 static struct device_type scsi_dev_type = {
1226 .name = "scsi_device",
1227 .release = scsi_device_dev_release,
1228 .groups = scsi_sdev_attr_groups,
1231 void scsi_sysfs_device_initialize(struct scsi_device *sdev)
1233 unsigned long flags;
1234 struct Scsi_Host *shost = sdev->host;
1235 struct scsi_target *starget = sdev->sdev_target;
1237 device_initialize(&sdev->sdev_gendev);
1238 sdev->sdev_gendev.bus = &scsi_bus_type;
1239 sdev->sdev_gendev.type = &scsi_dev_type;
1240 dev_set_name(&sdev->sdev_gendev, "%d:%d:%d:%llu",
1241 sdev->host->host_no, sdev->channel, sdev->id, sdev->lun);
1243 device_initialize(&sdev->sdev_dev);
1244 sdev->sdev_dev.parent = get_device(&sdev->sdev_gendev);
1245 sdev->sdev_dev.class = &sdev_class;
1246 dev_set_name(&sdev->sdev_dev, "%d:%d:%d:%llu",
1247 sdev->host->host_no, sdev->channel, sdev->id, sdev->lun);
1248 sdev->scsi_level = starget->scsi_level;
1249 transport_setup_device(&sdev->sdev_gendev);
1250 spin_lock_irqsave(shost->host_lock, flags);
1251 list_add_tail(&sdev->same_target_siblings, &starget->devices);
1252 list_add_tail(&sdev->siblings, &shost->__devices);
1253 spin_unlock_irqrestore(shost->host_lock, flags);
1255 * device can now only be removed via __scsi_remove_device() so hold
1256 * the target. Target will be held in CREATED state until something
1257 * beneath it becomes visible (in which case it moves to RUNNING)
1259 kref_get(&starget->reap_ref);
1262 int scsi_is_sdev_device(const struct device *dev)
1264 return dev->type == &scsi_dev_type;
1266 EXPORT_SYMBOL(scsi_is_sdev_device);
1268 /* A blank transport template that is used in drivers that don't
1269 * yet implement Transport Attributes */
1270 struct scsi_transport_template blank_transport_template = { { { {NULL, }, }, }, };