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(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");
348 show_host_busy(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
350 struct Scsi_Host
*shost
= class_to_shost(dev
);
351 return snprintf(buf
, 20, "%d\n", atomic_read(&shost
->host_busy
));
353 static DEVICE_ATTR(host_busy
, S_IRUGO
, show_host_busy
, NULL
);
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
,
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
,
376 struct attribute_group scsi_shost_attr_group
= {
377 .attrs
= scsi_sysfs_shost_attrs
,
380 const struct attribute_group
*scsi_sysfs_shost_attr_groups
[] = {
381 &scsi_shost_attr_group
,
385 static void scsi_device_cls_release(struct device
*class_dev
)
387 struct scsi_device
*sdev
;
389 sdev
= class_to_sdev(class_dev
);
390 put_device(&sdev
->sdev_gendev
);
393 static void scsi_device_dev_release_usercontext(struct work_struct
*work
)
395 struct scsi_device
*sdev
;
396 struct device
*parent
;
397 struct list_head
*this, *tmp
;
400 sdev
= container_of(work
, struct scsi_device
, ew
.work
);
402 scsi_dh_release_device(sdev
);
404 parent
= sdev
->sdev_gendev
.parent
;
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
);
412 cancel_work_sync(&sdev
->event_work
);
414 list_for_each_safe(this, tmp
, &sdev
->event_list
) {
415 struct scsi_event
*evt
;
417 evt
= list_entry(this, struct scsi_event
, node
);
418 list_del(&evt
->node
);
422 blk_put_queue(sdev
->request_queue
);
423 /* NULL queue means the device can't be used */
424 sdev
->request_queue
= NULL
;
426 kfree(sdev
->vpd_pg83
);
427 kfree(sdev
->vpd_pg80
);
428 kfree(sdev
->inquiry
);
435 static void scsi_device_dev_release(struct device
*dev
)
437 struct scsi_device
*sdp
= to_scsi_device(dev
);
438 execute_in_process_context(scsi_device_dev_release_usercontext
,
442 static struct class sdev_class
= {
443 .name
= "scsi_device",
444 .dev_release
= scsi_device_cls_release
,
447 /* all probing is done in the individual ->probe routines */
448 static int scsi_bus_match(struct device
*dev
, struct device_driver
*gendrv
)
450 struct scsi_device
*sdp
;
452 if (dev
->type
!= &scsi_dev_type
)
455 sdp
= to_scsi_device(dev
);
456 if (sdp
->no_uld_attach
)
458 return (sdp
->inq_periph_qual
== SCSI_INQ_PQ_CON
)? 1: 0;
461 static int scsi_bus_uevent(struct device
*dev
, struct kobj_uevent_env
*env
)
463 struct scsi_device
*sdev
;
465 if (dev
->type
!= &scsi_dev_type
)
468 sdev
= to_scsi_device(dev
);
470 add_uevent_var(env
, "MODALIAS=" SCSI_DEVICE_MODALIAS_FMT
, sdev
->type
);
474 struct bus_type scsi_bus_type
= {
476 .match
= scsi_bus_match
,
477 .uevent
= scsi_bus_uevent
,
479 .pm
= &scsi_bus_pm_ops
,
482 EXPORT_SYMBOL_GPL(scsi_bus_type
);
484 int scsi_sysfs_register(void)
488 error
= bus_register(&scsi_bus_type
);
490 error
= class_register(&sdev_class
);
492 bus_unregister(&scsi_bus_type
);
498 void scsi_sysfs_unregister(void)
500 class_unregister(&sdev_class
);
501 bus_unregister(&scsi_bus_type
);
505 * sdev_show_function: macro to create an attr function that can be used to
506 * show a non-bit field.
508 #define sdev_show_function(field, format_string) \
510 sdev_show_##field (struct device *dev, struct device_attribute *attr, \
513 struct scsi_device *sdev; \
514 sdev = to_scsi_device(dev); \
515 return snprintf (buf, 20, format_string, sdev->field); \
519 * sdev_rd_attr: macro to create a function and attribute variable for a
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);
528 * sdev_rw_attr: create a function and attribute variable for a
531 #define sdev_rw_attr(field, format_string) \
532 sdev_show_function(field, format_string) \
535 sdev_store_##field (struct device *dev, struct device_attribute *attr, \
536 const char *buf, size_t count) \
538 struct scsi_device *sdev; \
539 sdev = to_scsi_device(dev); \
540 sscanf (buf, format_string, &sdev->field); \
543 static DEVICE_ATTR(field, S_IRUGO | S_IWUSR, sdev_show_##field, sdev_store_##field);
545 /* Currently we don't export bit fields, but we might in future,
546 * so leave this code in */
549 * sdev_rd_attr: create a function and attribute variable for a
550 * read/write bit field.
552 #define sdev_rw_attr_bit(field) \
553 sdev_show_function(field, "%d\n") \
556 sdev_store_##field (struct device *dev, struct device_attribute *attr, \
557 const char *buf, size_t count) \
560 struct scsi_device *sdev; \
561 ret = scsi_sdev_check_buf_bit(buf); \
563 sdev = to_scsi_device(dev); \
569 static DEVICE_ATTR(field, S_IRUGO | S_IWUSR, sdev_show_##field, sdev_store_##field);
572 * scsi_sdev_check_buf_bit: return 0 if buf is "0", return 1 if buf is "1",
573 * else return -EINVAL.
575 static int scsi_sdev_check_buf_bit(const char *buf
)
577 if ((buf
[1] == '\0') || ((buf
[1] == '\n') && (buf
[2] == '\0'))) {
580 else if (buf
[0] == '0')
589 * Create the actual show/store functions and data structures.
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");
598 sdev_show_device_busy(struct device
*dev
, struct device_attribute
*attr
,
601 struct scsi_device
*sdev
= to_scsi_device(dev
);
602 return snprintf(buf
, 20, "%d\n", atomic_read(&sdev
->device_busy
));
604 static DEVICE_ATTR(device_busy
, S_IRUGO
, sdev_show_device_busy
, NULL
);
607 sdev_show_device_blocked(struct device
*dev
, struct device_attribute
*attr
,
610 struct scsi_device
*sdev
= to_scsi_device(dev
);
611 return snprintf(buf
, 20, "%d\n", atomic_read(&sdev
->device_blocked
));
613 static DEVICE_ATTR(device_blocked
, S_IRUGO
, sdev_show_device_blocked
, NULL
);
616 * TODO: can we make these symlinks to the block layer ones?
619 sdev_show_timeout (struct device
*dev
, struct device_attribute
*attr
, char *buf
)
621 struct scsi_device
*sdev
;
622 sdev
= to_scsi_device(dev
);
623 return snprintf(buf
, 20, "%d\n", sdev
->request_queue
->rq_timeout
/ HZ
);
627 sdev_store_timeout (struct device
*dev
, struct device_attribute
*attr
,
628 const char *buf
, size_t count
)
630 struct scsi_device
*sdev
;
632 sdev
= to_scsi_device(dev
);
633 sscanf (buf
, "%d\n", &timeout
);
634 blk_queue_rq_timeout(sdev
->request_queue
, timeout
* HZ
);
637 static DEVICE_ATTR(timeout
, S_IRUGO
| S_IWUSR
, sdev_show_timeout
, sdev_store_timeout
);
640 sdev_show_eh_timeout(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
642 struct scsi_device
*sdev
;
643 sdev
= to_scsi_device(dev
);
644 return snprintf(buf
, 20, "%u\n", sdev
->eh_timeout
/ HZ
);
648 sdev_store_eh_timeout(struct device
*dev
, struct device_attribute
*attr
,
649 const char *buf
, size_t count
)
651 struct scsi_device
*sdev
;
652 unsigned int eh_timeout
;
655 if (!capable(CAP_SYS_ADMIN
))
658 sdev
= to_scsi_device(dev
);
659 err
= kstrtouint(buf
, 10, &eh_timeout
);
662 sdev
->eh_timeout
= eh_timeout
* HZ
;
666 static DEVICE_ATTR(eh_timeout
, S_IRUGO
| S_IWUSR
, sdev_show_eh_timeout
, sdev_store_eh_timeout
);
669 store_rescan_field (struct device
*dev
, struct device_attribute
*attr
,
670 const char *buf
, size_t count
)
672 scsi_rescan_device(dev
);
675 static DEVICE_ATTR(rescan
, S_IWUSR
, NULL
, store_rescan_field
);
678 sdev_store_delete(struct device
*dev
, struct device_attribute
*attr
,
679 const char *buf
, size_t count
)
681 struct kernfs_node
*kn
;
683 kn
= sysfs_break_active_protection(&dev
->kobj
, &attr
->attr
);
686 * Concurrent writes into the "delete" sysfs attribute may trigger
687 * concurrent calls to device_remove_file() and scsi_remove_device().
688 * device_remove_file() handles concurrent removal calls by
689 * serializing these and by ignoring the second and later removal
690 * attempts. Concurrent calls of scsi_remove_device() are
691 * serialized. The second and later calls of scsi_remove_device() are
692 * ignored because the first call of that function changes the device
693 * state into SDEV_DEL.
695 device_remove_file(dev
, attr
);
696 scsi_remove_device(to_scsi_device(dev
));
698 sysfs_unbreak_active_protection(kn
);
701 static DEVICE_ATTR(delete, S_IWUSR
, NULL
, sdev_store_delete
);
704 store_state_field(struct device
*dev
, struct device_attribute
*attr
,
705 const char *buf
, size_t count
)
708 struct scsi_device
*sdev
= to_scsi_device(dev
);
709 enum scsi_device_state state
= 0;
711 for (i
= 0; i
< ARRAY_SIZE(sdev_states
); i
++) {
712 const int len
= strlen(sdev_states
[i
].name
);
713 if (strncmp(sdev_states
[i
].name
, buf
, len
) == 0 &&
715 state
= sdev_states
[i
].value
;
722 if (scsi_device_set_state(sdev
, state
))
728 show_state_field(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
730 struct scsi_device
*sdev
= to_scsi_device(dev
);
731 const char *name
= scsi_device_state_name(sdev
->sdev_state
);
736 return snprintf(buf
, 20, "%s\n", name
);
739 static DEVICE_ATTR(state
, S_IRUGO
| S_IWUSR
, show_state_field
, store_state_field
);
742 show_queue_type_field(struct device
*dev
, struct device_attribute
*attr
,
745 struct scsi_device
*sdev
= to_scsi_device(dev
);
746 const char *name
= "none";
748 if (sdev
->simple_tags
)
751 return snprintf(buf
, 20, "%s\n", name
);
755 store_queue_type_field(struct device
*dev
, struct device_attribute
*attr
,
756 const char *buf
, size_t count
)
758 struct scsi_device
*sdev
= to_scsi_device(dev
);
760 if (!sdev
->tagged_supported
)
763 sdev_printk(KERN_INFO
, sdev
,
764 "ignoring write to deprecated queue_type attribute");
768 static DEVICE_ATTR(queue_type
, S_IRUGO
| S_IWUSR
, show_queue_type_field
,
769 store_queue_type_field
);
771 #define sdev_vpd_pg_attr(_page) \
773 show_vpd_##_page(struct file *filp, struct kobject *kobj, \
774 struct bin_attribute *bin_attr, \
775 char *buf, loff_t off, size_t count) \
777 struct device *dev = container_of(kobj, struct device, kobj); \
778 struct scsi_device *sdev = to_scsi_device(dev); \
779 if (!sdev->vpd_##_page) \
781 return memory_read_from_buffer(buf, count, &off, \
783 sdev->vpd_##_page##_len); \
785 static struct bin_attribute dev_attr_vpd_##_page = { \
786 .attr = {.name = __stringify(vpd_##_page), .mode = S_IRUGO }, \
788 .read = show_vpd_##_page, \
791 sdev_vpd_pg_attr(pg83
);
792 sdev_vpd_pg_attr(pg80
);
794 static ssize_t
show_inquiry(struct file
*filep
, struct kobject
*kobj
,
795 struct bin_attribute
*bin_attr
,
796 char *buf
, loff_t off
, size_t count
)
798 struct device
*dev
= container_of(kobj
, struct device
, kobj
);
799 struct scsi_device
*sdev
= to_scsi_device(dev
);
804 return memory_read_from_buffer(buf
, count
, &off
, sdev
->inquiry
,
808 static struct bin_attribute dev_attr_inquiry
= {
814 .read
= show_inquiry
,
818 show_iostat_counterbits(struct device
*dev
, struct device_attribute
*attr
,
821 return snprintf(buf
, 20, "%d\n", (int)sizeof(atomic_t
) * 8);
824 static DEVICE_ATTR(iocounterbits
, S_IRUGO
, show_iostat_counterbits
, NULL
);
826 #define show_sdev_iostat(field) \
828 show_iostat_##field(struct device *dev, struct device_attribute *attr, \
831 struct scsi_device *sdev = to_scsi_device(dev); \
832 unsigned long long count = atomic_read(&sdev->field); \
833 return snprintf(buf, 20, "0x%llx\n", count); \
835 static DEVICE_ATTR(field, S_IRUGO, show_iostat_##field, NULL)
837 show_sdev_iostat(iorequest_cnt
);
838 show_sdev_iostat(iodone_cnt
);
839 show_sdev_iostat(ioerr_cnt
);
842 sdev_show_modalias(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
844 struct scsi_device
*sdev
;
845 sdev
= to_scsi_device(dev
);
846 return snprintf (buf
, 20, SCSI_DEVICE_MODALIAS_FMT
"\n", sdev
->type
);
848 static DEVICE_ATTR(modalias
, S_IRUGO
, sdev_show_modalias
, NULL
);
850 #define DECLARE_EVT_SHOW(name, Cap_name) \
852 sdev_show_evt_##name(struct device *dev, struct device_attribute *attr, \
855 struct scsi_device *sdev = to_scsi_device(dev); \
856 int val = test_bit(SDEV_EVT_##Cap_name, sdev->supported_events);\
857 return snprintf(buf, 20, "%d\n", val); \
860 #define DECLARE_EVT_STORE(name, Cap_name) \
862 sdev_store_evt_##name(struct device *dev, struct device_attribute *attr,\
863 const char *buf, size_t count) \
865 struct scsi_device *sdev = to_scsi_device(dev); \
866 int val = simple_strtoul(buf, NULL, 0); \
868 clear_bit(SDEV_EVT_##Cap_name, sdev->supported_events); \
870 set_bit(SDEV_EVT_##Cap_name, sdev->supported_events); \
876 #define DECLARE_EVT(name, Cap_name) \
877 DECLARE_EVT_SHOW(name, Cap_name) \
878 DECLARE_EVT_STORE(name, Cap_name) \
879 static DEVICE_ATTR(evt_##name, S_IRUGO, sdev_show_evt_##name, \
880 sdev_store_evt_##name);
881 #define REF_EVT(name) &dev_attr_evt_##name.attr
883 DECLARE_EVT(media_change
, MEDIA_CHANGE
)
884 DECLARE_EVT(inquiry_change_reported
, INQUIRY_CHANGE_REPORTED
)
885 DECLARE_EVT(capacity_change_reported
, CAPACITY_CHANGE_REPORTED
)
886 DECLARE_EVT(soft_threshold_reached
, SOFT_THRESHOLD_REACHED_REPORTED
)
887 DECLARE_EVT(mode_parameter_change_reported
, MODE_PARAMETER_CHANGE_REPORTED
)
888 DECLARE_EVT(lun_change_reported
, LUN_CHANGE_REPORTED
)
891 sdev_store_queue_depth(struct device
*dev
, struct device_attribute
*attr
,
892 const char *buf
, size_t count
)
895 struct scsi_device
*sdev
= to_scsi_device(dev
);
896 struct scsi_host_template
*sht
= sdev
->host
->hostt
;
898 if (!sht
->change_queue_depth
)
901 depth
= simple_strtoul(buf
, NULL
, 0);
903 if (depth
< 1 || depth
> sdev
->host
->can_queue
)
906 retval
= sht
->change_queue_depth(sdev
, depth
);
910 sdev
->max_queue_depth
= sdev
->queue_depth
;
914 sdev_show_function(queue_depth
, "%d\n");
916 static DEVICE_ATTR(queue_depth
, S_IRUGO
| S_IWUSR
, sdev_show_queue_depth
,
917 sdev_store_queue_depth
);
920 sdev_show_queue_ramp_up_period(struct device
*dev
,
921 struct device_attribute
*attr
,
924 struct scsi_device
*sdev
;
925 sdev
= to_scsi_device(dev
);
926 return snprintf(buf
, 20, "%u\n",
927 jiffies_to_msecs(sdev
->queue_ramp_up_period
));
931 sdev_store_queue_ramp_up_period(struct device
*dev
,
932 struct device_attribute
*attr
,
933 const char *buf
, size_t count
)
935 struct scsi_device
*sdev
= to_scsi_device(dev
);
938 if (kstrtouint(buf
, 10, &period
))
941 sdev
->queue_ramp_up_period
= msecs_to_jiffies(period
);
945 static DEVICE_ATTR(queue_ramp_up_period
, S_IRUGO
| S_IWUSR
,
946 sdev_show_queue_ramp_up_period
,
947 sdev_store_queue_ramp_up_period
);
949 static umode_t
scsi_sdev_attr_is_visible(struct kobject
*kobj
,
950 struct attribute
*attr
, int i
)
952 struct device
*dev
= container_of(kobj
, struct device
, kobj
);
953 struct scsi_device
*sdev
= to_scsi_device(dev
);
956 if (attr
== &dev_attr_queue_depth
.attr
&&
957 !sdev
->host
->hostt
->change_queue_depth
)
960 if (attr
== &dev_attr_queue_ramp_up_period
.attr
&&
961 !sdev
->host
->hostt
->change_queue_depth
)
967 /* Default template for device attributes. May NOT be modified */
968 static struct attribute
*scsi_sdev_attrs
[] = {
969 &dev_attr_device_blocked
.attr
,
971 &dev_attr_scsi_level
.attr
,
972 &dev_attr_device_busy
.attr
,
973 &dev_attr_vendor
.attr
,
974 &dev_attr_model
.attr
,
976 &dev_attr_rescan
.attr
,
977 &dev_attr_delete
.attr
,
978 &dev_attr_state
.attr
,
979 &dev_attr_timeout
.attr
,
980 &dev_attr_eh_timeout
.attr
,
981 &dev_attr_iocounterbits
.attr
,
982 &dev_attr_iorequest_cnt
.attr
,
983 &dev_attr_iodone_cnt
.attr
,
984 &dev_attr_ioerr_cnt
.attr
,
985 &dev_attr_modalias
.attr
,
986 &dev_attr_queue_depth
.attr
,
987 &dev_attr_queue_type
.attr
,
988 &dev_attr_queue_ramp_up_period
.attr
,
989 REF_EVT(media_change
),
990 REF_EVT(inquiry_change_reported
),
991 REF_EVT(capacity_change_reported
),
992 REF_EVT(soft_threshold_reached
),
993 REF_EVT(mode_parameter_change_reported
),
994 REF_EVT(lun_change_reported
),
998 static struct bin_attribute
*scsi_sdev_bin_attrs
[] = {
1004 static struct attribute_group scsi_sdev_attr_group
= {
1005 .attrs
= scsi_sdev_attrs
,
1006 .bin_attrs
= scsi_sdev_bin_attrs
,
1007 .is_visible
= scsi_sdev_attr_is_visible
,
1010 static const struct attribute_group
*scsi_sdev_attr_groups
[] = {
1011 &scsi_sdev_attr_group
,
1015 static int scsi_target_add(struct scsi_target
*starget
)
1019 if (starget
->state
!= STARGET_CREATED
)
1022 error
= device_add(&starget
->dev
);
1024 dev_err(&starget
->dev
, "target device_add failed, error %d\n", error
);
1027 transport_add_device(&starget
->dev
);
1028 starget
->state
= STARGET_RUNNING
;
1030 pm_runtime_set_active(&starget
->dev
);
1031 pm_runtime_enable(&starget
->dev
);
1032 device_enable_async_suspend(&starget
->dev
);
1038 * scsi_sysfs_add_sdev - add scsi device to sysfs
1039 * @sdev: scsi_device to add
1042 * 0 on Success / non-zero on Failure
1044 int scsi_sysfs_add_sdev(struct scsi_device
*sdev
)
1047 struct request_queue
*rq
= sdev
->request_queue
;
1048 struct scsi_target
*starget
= sdev
->sdev_target
;
1050 error
= scsi_target_add(starget
);
1054 transport_configure_device(&starget
->dev
);
1056 device_enable_async_suspend(&sdev
->sdev_gendev
);
1057 scsi_autopm_get_target(starget
);
1058 pm_runtime_set_active(&sdev
->sdev_gendev
);
1059 pm_runtime_forbid(&sdev
->sdev_gendev
);
1060 pm_runtime_enable(&sdev
->sdev_gendev
);
1061 scsi_autopm_put_target(starget
);
1063 scsi_autopm_get_device(sdev
);
1065 error
= device_add(&sdev
->sdev_gendev
);
1067 sdev_printk(KERN_INFO
, sdev
,
1068 "failed to add device: %d\n", error
);
1072 error
= scsi_dh_add_device(sdev
);
1075 * device_handler is optional, so any error can be ignored
1077 sdev_printk(KERN_INFO
, sdev
,
1078 "failed to add device handler: %d\n", error
);
1080 device_enable_async_suspend(&sdev
->sdev_dev
);
1081 error
= device_add(&sdev
->sdev_dev
);
1083 sdev_printk(KERN_INFO
, sdev
,
1084 "failed to add class device: %d\n", error
);
1085 scsi_dh_remove_device(sdev
);
1086 device_del(&sdev
->sdev_gendev
);
1089 transport_add_device(&sdev
->sdev_gendev
);
1090 sdev
->is_visible
= 1;
1092 error
= bsg_register_queue(rq
, &sdev
->sdev_gendev
, NULL
, NULL
);
1095 /* we're treating error on bsg register as non-fatal,
1096 * so pretend nothing went wrong */
1097 sdev_printk(KERN_INFO
, sdev
,
1098 "Failed to register bsg queue, errno=%d\n", error
);
1100 /* add additional host specific attributes */
1101 if (sdev
->host
->hostt
->sdev_attrs
) {
1102 for (i
= 0; sdev
->host
->hostt
->sdev_attrs
[i
]; i
++) {
1103 error
= device_create_file(&sdev
->sdev_gendev
,
1104 sdev
->host
->hostt
->sdev_attrs
[i
]);
1110 scsi_autopm_put_device(sdev
);
1114 void __scsi_remove_device(struct scsi_device
*sdev
)
1116 struct device
*dev
= &sdev
->sdev_gendev
;
1119 * This cleanup path is not reentrant and while it is impossible
1120 * to get a new reference with scsi_device_get() someone can still
1121 * hold a previously acquired one.
1123 if (sdev
->sdev_state
== SDEV_DEL
)
1126 if (sdev
->is_visible
) {
1127 if (scsi_device_set_state(sdev
, SDEV_CANCEL
) != 0)
1130 bsg_unregister_queue(sdev
->request_queue
);
1131 device_unregister(&sdev
->sdev_dev
);
1132 transport_remove_device(dev
);
1133 scsi_dh_remove_device(sdev
);
1136 put_device(&sdev
->sdev_dev
);
1139 * Stop accepting new requests and wait until all queuecommand() and
1140 * scsi_run_queue() invocations have finished before tearing down the
1143 scsi_device_set_state(sdev
, SDEV_DEL
);
1144 blk_cleanup_queue(sdev
->request_queue
);
1145 cancel_work_sync(&sdev
->requeue_work
);
1147 if (sdev
->host
->hostt
->slave_destroy
)
1148 sdev
->host
->hostt
->slave_destroy(sdev
);
1149 transport_destroy_device(dev
);
1152 * Paired with the kref_get() in scsi_sysfs_initialize(). We have
1153 * remoed sysfs visibility from the device, so make the target
1154 * invisible if this was the last device underneath it.
1156 scsi_target_reap(scsi_target(sdev
));
1162 * scsi_remove_device - unregister a device from the scsi bus
1163 * @sdev: scsi_device to unregister
1165 void scsi_remove_device(struct scsi_device
*sdev
)
1167 struct Scsi_Host
*shost
= sdev
->host
;
1169 mutex_lock(&shost
->scan_mutex
);
1170 __scsi_remove_device(sdev
);
1171 mutex_unlock(&shost
->scan_mutex
);
1173 EXPORT_SYMBOL(scsi_remove_device
);
1175 static void __scsi_remove_target(struct scsi_target
*starget
)
1177 struct Scsi_Host
*shost
= dev_to_shost(starget
->dev
.parent
);
1178 unsigned long flags
;
1179 struct scsi_device
*sdev
;
1181 spin_lock_irqsave(shost
->host_lock
, flags
);
1183 list_for_each_entry(sdev
, &shost
->__devices
, siblings
) {
1184 if (sdev
->channel
!= starget
->channel
||
1185 sdev
->id
!= starget
->id
||
1186 scsi_device_get(sdev
))
1188 spin_unlock_irqrestore(shost
->host_lock
, flags
);
1189 scsi_remove_device(sdev
);
1190 scsi_device_put(sdev
);
1191 spin_lock_irqsave(shost
->host_lock
, flags
);
1194 spin_unlock_irqrestore(shost
->host_lock
, flags
);
1198 * scsi_remove_target - try to remove a target and all its devices
1199 * @dev: generic starget or parent of generic stargets to be removed
1201 * Note: This is slightly racy. It is possible that if the user
1202 * requests the addition of another device then the target won't be
1205 void scsi_remove_target(struct device
*dev
)
1207 struct Scsi_Host
*shost
= dev_to_shost(dev
->parent
);
1208 struct scsi_target
*starget
;
1209 unsigned long flags
;
1212 spin_lock_irqsave(shost
->host_lock
, flags
);
1213 list_for_each_entry(starget
, &shost
->__targets
, siblings
) {
1214 if (starget
->state
== STARGET_DEL
||
1215 starget
->state
== STARGET_REMOVE
)
1217 if (starget
->dev
.parent
== dev
|| &starget
->dev
== dev
) {
1218 kref_get(&starget
->reap_ref
);
1219 starget
->state
= STARGET_REMOVE
;
1220 spin_unlock_irqrestore(shost
->host_lock
, flags
);
1221 __scsi_remove_target(starget
);
1222 scsi_target_reap(starget
);
1226 spin_unlock_irqrestore(shost
->host_lock
, flags
);
1228 EXPORT_SYMBOL(scsi_remove_target
);
1230 int scsi_register_driver(struct device_driver
*drv
)
1232 drv
->bus
= &scsi_bus_type
;
1234 return driver_register(drv
);
1236 EXPORT_SYMBOL(scsi_register_driver
);
1238 int scsi_register_interface(struct class_interface
*intf
)
1240 intf
->class = &sdev_class
;
1242 return class_interface_register(intf
);
1244 EXPORT_SYMBOL(scsi_register_interface
);
1247 * scsi_sysfs_add_host - add scsi host to subsystem
1248 * @shost: scsi host struct to add to subsystem
1250 int scsi_sysfs_add_host(struct Scsi_Host
*shost
)
1254 /* add host specific attributes */
1255 if (shost
->hostt
->shost_attrs
) {
1256 for (i
= 0; shost
->hostt
->shost_attrs
[i
]; i
++) {
1257 error
= device_create_file(&shost
->shost_dev
,
1258 shost
->hostt
->shost_attrs
[i
]);
1264 transport_register_device(&shost
->shost_gendev
);
1265 transport_configure_device(&shost
->shost_gendev
);
1269 static struct device_type scsi_dev_type
= {
1270 .name
= "scsi_device",
1271 .release
= scsi_device_dev_release
,
1272 .groups
= scsi_sdev_attr_groups
,
1275 void scsi_sysfs_device_initialize(struct scsi_device
*sdev
)
1277 unsigned long flags
;
1278 struct Scsi_Host
*shost
= sdev
->host
;
1279 struct scsi_target
*starget
= sdev
->sdev_target
;
1281 device_initialize(&sdev
->sdev_gendev
);
1282 sdev
->sdev_gendev
.bus
= &scsi_bus_type
;
1283 sdev
->sdev_gendev
.type
= &scsi_dev_type
;
1284 dev_set_name(&sdev
->sdev_gendev
, "%d:%d:%d:%llu",
1285 sdev
->host
->host_no
, sdev
->channel
, sdev
->id
, sdev
->lun
);
1287 device_initialize(&sdev
->sdev_dev
);
1288 sdev
->sdev_dev
.parent
= get_device(&sdev
->sdev_gendev
);
1289 sdev
->sdev_dev
.class = &sdev_class
;
1290 dev_set_name(&sdev
->sdev_dev
, "%d:%d:%d:%llu",
1291 sdev
->host
->host_no
, sdev
->channel
, sdev
->id
, sdev
->lun
);
1293 * Get a default scsi_level from the target (derived from sibling
1294 * devices). This is the best we can do for guessing how to set
1295 * sdev->lun_in_cdb for the initial INQUIRY command. For LUN 0 the
1296 * setting doesn't matter, because all the bits are zero anyway.
1297 * But it does matter for higher LUNs.
1299 sdev
->scsi_level
= starget
->scsi_level
;
1300 if (sdev
->scsi_level
<= SCSI_2
&&
1301 sdev
->scsi_level
!= SCSI_UNKNOWN
&&
1302 !shost
->no_scsi2_lun_in_cdb
)
1303 sdev
->lun_in_cdb
= 1;
1305 transport_setup_device(&sdev
->sdev_gendev
);
1306 spin_lock_irqsave(shost
->host_lock
, flags
);
1307 list_add_tail(&sdev
->same_target_siblings
, &starget
->devices
);
1308 list_add_tail(&sdev
->siblings
, &shost
->__devices
);
1309 spin_unlock_irqrestore(shost
->host_lock
, flags
);
1311 * device can now only be removed via __scsi_remove_device() so hold
1312 * the target. Target will be held in CREATED state until something
1313 * beneath it becomes visible (in which case it moves to RUNNING)
1315 kref_get(&starget
->reap_ref
);
1318 int scsi_is_sdev_device(const struct device
*dev
)
1320 return dev
->type
== &scsi_dev_type
;
1322 EXPORT_SYMBOL(scsi_is_sdev_device
);
1324 /* A blank transport template that is used in drivers that don't
1325 * yet implement Transport Attributes */
1326 struct scsi_transport_template blank_transport_template
= { { { {NULL
, }, }, }, };