Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
1// SPDX-License-Identifier: GPL-2.0-only
2/*
3 * scsi_sysfs.c
4 *
5 * SCSI sysfs interface routines.
6 *
7 * Created to pull SCSI mid layer sysfs routines into one file.
8 */
9
10#include <linux/module.h>
11#include <linux/slab.h>
12#include <linux/init.h>
13#include <linux/blkdev.h>
14#include <linux/device.h>
15#include <linux/pm_runtime.h>
16#include <linux/bsg.h>
17
18#include <scsi/scsi.h>
19#include <scsi/scsi_device.h>
20#include <scsi/scsi_host.h>
21#include <scsi/scsi_tcq.h>
22#include <scsi/scsi_dh.h>
23#include <scsi/scsi_transport.h>
24#include <scsi/scsi_driver.h>
25#include <scsi/scsi_devinfo.h>
26
27#include "scsi_priv.h"
28#include "scsi_logging.h"
29
30static struct device_type scsi_dev_type;
31
32static const struct {
33 enum scsi_device_state value;
34 char *name;
35} sdev_states[] = {
36 { SDEV_CREATED, "created" },
37 { SDEV_RUNNING, "running" },
38 { SDEV_CANCEL, "cancel" },
39 { SDEV_DEL, "deleted" },
40 { SDEV_QUIESCE, "quiesce" },
41 { SDEV_OFFLINE, "offline" },
42 { SDEV_TRANSPORT_OFFLINE, "transport-offline" },
43 { SDEV_BLOCK, "blocked" },
44 { SDEV_CREATED_BLOCK, "created-blocked" },
45};
46
47const char *scsi_device_state_name(enum scsi_device_state state)
48{
49 int i;
50 char *name = NULL;
51
52 for (i = 0; i < ARRAY_SIZE(sdev_states); i++) {
53 if (sdev_states[i].value == state) {
54 name = sdev_states[i].name;
55 break;
56 }
57 }
58 return name;
59}
60
61static const struct {
62 enum scsi_host_state value;
63 char *name;
64} shost_states[] = {
65 { SHOST_CREATED, "created" },
66 { SHOST_RUNNING, "running" },
67 { SHOST_CANCEL, "cancel" },
68 { SHOST_DEL, "deleted" },
69 { SHOST_RECOVERY, "recovery" },
70 { SHOST_CANCEL_RECOVERY, "cancel/recovery" },
71 { SHOST_DEL_RECOVERY, "deleted/recovery", },
72};
73const char *scsi_host_state_name(enum scsi_host_state state)
74{
75 int i;
76 char *name = NULL;
77
78 for (i = 0; i < ARRAY_SIZE(shost_states); i++) {
79 if (shost_states[i].value == state) {
80 name = shost_states[i].name;
81 break;
82 }
83 }
84 return name;
85}
86
87#ifdef CONFIG_SCSI_DH
88static const struct {
89 unsigned char value;
90 char *name;
91} sdev_access_states[] = {
92 { SCSI_ACCESS_STATE_OPTIMAL, "active/optimized" },
93 { SCSI_ACCESS_STATE_ACTIVE, "active/non-optimized" },
94 { SCSI_ACCESS_STATE_STANDBY, "standby" },
95 { SCSI_ACCESS_STATE_UNAVAILABLE, "unavailable" },
96 { SCSI_ACCESS_STATE_LBA, "lba-dependent" },
97 { SCSI_ACCESS_STATE_OFFLINE, "offline" },
98 { SCSI_ACCESS_STATE_TRANSITIONING, "transitioning" },
99};
100
101static const char *scsi_access_state_name(unsigned char state)
102{
103 int i;
104 char *name = NULL;
105
106 for (i = 0; i < ARRAY_SIZE(sdev_access_states); i++) {
107 if (sdev_access_states[i].value == state) {
108 name = sdev_access_states[i].name;
109 break;
110 }
111 }
112 return name;
113}
114#endif
115
116static int check_set(unsigned long long *val, char *src)
117{
118 char *last;
119
120 if (strcmp(src, "-") == 0) {
121 *val = SCAN_WILD_CARD;
122 } else {
123 /*
124 * Doesn't check for int overflow
125 */
126 *val = simple_strtoull(src, &last, 0);
127 if (*last != '\0')
128 return 1;
129 }
130 return 0;
131}
132
133static int scsi_scan(struct Scsi_Host *shost, const char *str)
134{
135 char s1[15], s2[15], s3[17], junk;
136 unsigned long long channel, id, lun;
137 int res;
138
139 res = sscanf(str, "%10s %10s %16s %c", s1, s2, s3, &junk);
140 if (res != 3)
141 return -EINVAL;
142 if (check_set(&channel, s1))
143 return -EINVAL;
144 if (check_set(&id, s2))
145 return -EINVAL;
146 if (check_set(&lun, s3))
147 return -EINVAL;
148 if (shost->transportt->user_scan)
149 res = shost->transportt->user_scan(shost, channel, id, lun);
150 else
151 res = scsi_scan_host_selected(shost, channel, id, lun,
152 SCSI_SCAN_MANUAL);
153 return res;
154}
155
156/*
157 * shost_show_function: macro to create an attr function that can be used to
158 * show a non-bit field.
159 */
160#define shost_show_function(name, field, format_string) \
161static ssize_t \
162show_##name (struct device *dev, struct device_attribute *attr, \
163 char *buf) \
164{ \
165 struct Scsi_Host *shost = class_to_shost(dev); \
166 return snprintf (buf, 20, format_string, shost->field); \
167}
168
169/*
170 * shost_rd_attr: macro to create a function and attribute variable for a
171 * read only field.
172 */
173#define shost_rd_attr2(name, field, format_string) \
174 shost_show_function(name, field, format_string) \
175static DEVICE_ATTR(name, S_IRUGO, show_##name, NULL);
176
177#define shost_rd_attr(field, format_string) \
178shost_rd_attr2(field, field, format_string)
179
180/*
181 * Create the actual show/store functions and data structures.
182 */
183
184static ssize_t
185store_scan(struct device *dev, struct device_attribute *attr,
186 const char *buf, size_t count)
187{
188 struct Scsi_Host *shost = class_to_shost(dev);
189 int res;
190
191 res = scsi_scan(shost, buf);
192 if (res == 0)
193 res = count;
194 return res;
195};
196static DEVICE_ATTR(scan, S_IWUSR, NULL, store_scan);
197
198static ssize_t
199store_shost_state(struct device *dev, struct device_attribute *attr,
200 const char *buf, size_t count)
201{
202 int i;
203 struct Scsi_Host *shost = class_to_shost(dev);
204 enum scsi_host_state state = 0;
205
206 for (i = 0; i < ARRAY_SIZE(shost_states); i++) {
207 const int len = strlen(shost_states[i].name);
208 if (strncmp(shost_states[i].name, buf, len) == 0 &&
209 buf[len] == '\n') {
210 state = shost_states[i].value;
211 break;
212 }
213 }
214 if (!state)
215 return -EINVAL;
216
217 if (scsi_host_set_state(shost, state))
218 return -EINVAL;
219 return count;
220}
221
222static ssize_t
223show_shost_state(struct device *dev, struct device_attribute *attr, char *buf)
224{
225 struct Scsi_Host *shost = class_to_shost(dev);
226 const char *name = scsi_host_state_name(shost->shost_state);
227
228 if (!name)
229 return -EINVAL;
230
231 return snprintf(buf, 20, "%s\n", name);
232}
233
234/* DEVICE_ATTR(state) clashes with dev_attr_state for sdev */
235static struct device_attribute dev_attr_hstate =
236 __ATTR(state, S_IRUGO | S_IWUSR, show_shost_state, store_shost_state);
237
238static ssize_t
239show_shost_mode(unsigned int mode, char *buf)
240{
241 ssize_t len = 0;
242
243 if (mode & MODE_INITIATOR)
244 len = sprintf(buf, "%s", "Initiator");
245
246 if (mode & MODE_TARGET)
247 len += sprintf(buf + len, "%s%s", len ? ", " : "", "Target");
248
249 len += sprintf(buf + len, "\n");
250
251 return len;
252}
253
254static ssize_t
255show_shost_supported_mode(struct device *dev, struct device_attribute *attr,
256 char *buf)
257{
258 struct Scsi_Host *shost = class_to_shost(dev);
259 unsigned int supported_mode = shost->hostt->supported_mode;
260
261 if (supported_mode == MODE_UNKNOWN)
262 /* by default this should be initiator */
263 supported_mode = MODE_INITIATOR;
264
265 return show_shost_mode(supported_mode, buf);
266}
267
268static DEVICE_ATTR(supported_mode, S_IRUGO | S_IWUSR, show_shost_supported_mode, NULL);
269
270static ssize_t
271show_shost_active_mode(struct device *dev,
272 struct device_attribute *attr, char *buf)
273{
274 struct Scsi_Host *shost = class_to_shost(dev);
275
276 if (shost->active_mode == MODE_UNKNOWN)
277 return snprintf(buf, 20, "unknown\n");
278 else
279 return show_shost_mode(shost->active_mode, buf);
280}
281
282static DEVICE_ATTR(active_mode, S_IRUGO | S_IWUSR, show_shost_active_mode, NULL);
283
284static int check_reset_type(const char *str)
285{
286 if (sysfs_streq(str, "adapter"))
287 return SCSI_ADAPTER_RESET;
288 else if (sysfs_streq(str, "firmware"))
289 return SCSI_FIRMWARE_RESET;
290 else
291 return 0;
292}
293
294static ssize_t
295store_host_reset(struct device *dev, struct device_attribute *attr,
296 const char *buf, size_t count)
297{
298 struct Scsi_Host *shost = class_to_shost(dev);
299 struct scsi_host_template *sht = shost->hostt;
300 int ret = -EINVAL;
301 int type;
302
303 type = check_reset_type(buf);
304 if (!type)
305 goto exit_store_host_reset;
306
307 if (sht->host_reset)
308 ret = sht->host_reset(shost, type);
309 else
310 ret = -EOPNOTSUPP;
311
312exit_store_host_reset:
313 if (ret == 0)
314 ret = count;
315 return ret;
316}
317
318static DEVICE_ATTR(host_reset, S_IWUSR, NULL, store_host_reset);
319
320static ssize_t
321show_shost_eh_deadline(struct device *dev,
322 struct device_attribute *attr, char *buf)
323{
324 struct Scsi_Host *shost = class_to_shost(dev);
325
326 if (shost->eh_deadline == -1)
327 return snprintf(buf, strlen("off") + 2, "off\n");
328 return sprintf(buf, "%u\n", shost->eh_deadline / HZ);
329}
330
331static ssize_t
332store_shost_eh_deadline(struct device *dev, struct device_attribute *attr,
333 const char *buf, size_t count)
334{
335 struct Scsi_Host *shost = class_to_shost(dev);
336 int ret = -EINVAL;
337 unsigned long deadline, flags;
338
339 if (shost->transportt &&
340 (shost->transportt->eh_strategy_handler ||
341 !shost->hostt->eh_host_reset_handler))
342 return ret;
343
344 if (!strncmp(buf, "off", strlen("off")))
345 deadline = -1;
346 else {
347 ret = kstrtoul(buf, 10, &deadline);
348 if (ret)
349 return ret;
350 if (deadline * HZ > UINT_MAX)
351 return -EINVAL;
352 }
353
354 spin_lock_irqsave(shost->host_lock, flags);
355 if (scsi_host_in_recovery(shost))
356 ret = -EBUSY;
357 else {
358 if (deadline == -1)
359 shost->eh_deadline = -1;
360 else
361 shost->eh_deadline = deadline * HZ;
362
363 ret = count;
364 }
365 spin_unlock_irqrestore(shost->host_lock, flags);
366
367 return ret;
368}
369
370static DEVICE_ATTR(eh_deadline, S_IRUGO | S_IWUSR, show_shost_eh_deadline, store_shost_eh_deadline);
371
372shost_rd_attr(unique_id, "%u\n");
373shost_rd_attr(cmd_per_lun, "%hd\n");
374shost_rd_attr(can_queue, "%d\n");
375shost_rd_attr(sg_tablesize, "%hu\n");
376shost_rd_attr(sg_prot_tablesize, "%hu\n");
377shost_rd_attr(prot_capabilities, "%u\n");
378shost_rd_attr(prot_guard_type, "%hd\n");
379shost_rd_attr2(proc_name, hostt->proc_name, "%s\n");
380
381static ssize_t
382show_host_busy(struct device *dev, struct device_attribute *attr, char *buf)
383{
384 struct Scsi_Host *shost = class_to_shost(dev);
385 return snprintf(buf, 20, "%d\n", scsi_host_busy(shost));
386}
387static DEVICE_ATTR(host_busy, S_IRUGO, show_host_busy, NULL);
388
389static ssize_t
390show_use_blk_mq(struct device *dev, struct device_attribute *attr, char *buf)
391{
392 return sprintf(buf, "1\n");
393}
394static DEVICE_ATTR(use_blk_mq, S_IRUGO, show_use_blk_mq, NULL);
395
396static ssize_t
397show_nr_hw_queues(struct device *dev, struct device_attribute *attr, char *buf)
398{
399 struct Scsi_Host *shost = class_to_shost(dev);
400 struct blk_mq_tag_set *tag_set = &shost->tag_set;
401
402 return snprintf(buf, 20, "%d\n", tag_set->nr_hw_queues);
403}
404static DEVICE_ATTR(nr_hw_queues, S_IRUGO, show_nr_hw_queues, NULL);
405
406static struct attribute *scsi_sysfs_shost_attrs[] = {
407 &dev_attr_use_blk_mq.attr,
408 &dev_attr_unique_id.attr,
409 &dev_attr_host_busy.attr,
410 &dev_attr_cmd_per_lun.attr,
411 &dev_attr_can_queue.attr,
412 &dev_attr_sg_tablesize.attr,
413 &dev_attr_sg_prot_tablesize.attr,
414 &dev_attr_proc_name.attr,
415 &dev_attr_scan.attr,
416 &dev_attr_hstate.attr,
417 &dev_attr_supported_mode.attr,
418 &dev_attr_active_mode.attr,
419 &dev_attr_prot_capabilities.attr,
420 &dev_attr_prot_guard_type.attr,
421 &dev_attr_host_reset.attr,
422 &dev_attr_eh_deadline.attr,
423 &dev_attr_nr_hw_queues.attr,
424 NULL
425};
426
427static const struct attribute_group scsi_shost_attr_group = {
428 .attrs = scsi_sysfs_shost_attrs,
429};
430
431const struct attribute_group *scsi_shost_groups[] = {
432 &scsi_shost_attr_group,
433 NULL
434};
435
436static void scsi_device_cls_release(struct device *class_dev)
437{
438 struct scsi_device *sdev;
439
440 sdev = class_to_sdev(class_dev);
441 put_device(&sdev->sdev_gendev);
442}
443
444static void scsi_device_dev_release(struct device *dev)
445{
446 struct scsi_device *sdev = to_scsi_device(dev);
447 struct device *parent;
448 struct list_head *this, *tmp;
449 struct scsi_vpd *vpd_pg80 = NULL, *vpd_pg83 = NULL;
450 struct scsi_vpd *vpd_pg0 = NULL, *vpd_pg89 = NULL;
451 struct scsi_vpd *vpd_pgb0 = NULL, *vpd_pgb1 = NULL, *vpd_pgb2 = NULL;
452 unsigned long flags;
453
454 scsi_dh_release_device(sdev);
455
456 parent = sdev->sdev_gendev.parent;
457
458 spin_lock_irqsave(sdev->host->host_lock, flags);
459 list_del(&sdev->siblings);
460 list_del(&sdev->same_target_siblings);
461 list_del(&sdev->starved_entry);
462 spin_unlock_irqrestore(sdev->host->host_lock, flags);
463
464 cancel_work_sync(&sdev->event_work);
465
466 list_for_each_safe(this, tmp, &sdev->event_list) {
467 struct scsi_event *evt;
468
469 evt = list_entry(this, struct scsi_event, node);
470 list_del(&evt->node);
471 kfree(evt);
472 }
473
474 blk_put_queue(sdev->request_queue);
475 /* NULL queue means the device can't be used */
476 sdev->request_queue = NULL;
477
478 sbitmap_free(&sdev->budget_map);
479
480 mutex_lock(&sdev->inquiry_mutex);
481 vpd_pg0 = rcu_replace_pointer(sdev->vpd_pg0, vpd_pg0,
482 lockdep_is_held(&sdev->inquiry_mutex));
483 vpd_pg80 = rcu_replace_pointer(sdev->vpd_pg80, vpd_pg80,
484 lockdep_is_held(&sdev->inquiry_mutex));
485 vpd_pg83 = rcu_replace_pointer(sdev->vpd_pg83, vpd_pg83,
486 lockdep_is_held(&sdev->inquiry_mutex));
487 vpd_pg89 = rcu_replace_pointer(sdev->vpd_pg89, vpd_pg89,
488 lockdep_is_held(&sdev->inquiry_mutex));
489 vpd_pgb0 = rcu_replace_pointer(sdev->vpd_pgb0, vpd_pgb0,
490 lockdep_is_held(&sdev->inquiry_mutex));
491 vpd_pgb1 = rcu_replace_pointer(sdev->vpd_pgb1, vpd_pgb1,
492 lockdep_is_held(&sdev->inquiry_mutex));
493 vpd_pgb2 = rcu_replace_pointer(sdev->vpd_pgb2, vpd_pgb2,
494 lockdep_is_held(&sdev->inquiry_mutex));
495 mutex_unlock(&sdev->inquiry_mutex);
496
497 if (vpd_pg0)
498 kfree_rcu(vpd_pg0, rcu);
499 if (vpd_pg83)
500 kfree_rcu(vpd_pg83, rcu);
501 if (vpd_pg80)
502 kfree_rcu(vpd_pg80, rcu);
503 if (vpd_pg89)
504 kfree_rcu(vpd_pg89, rcu);
505 if (vpd_pgb0)
506 kfree_rcu(vpd_pgb0, rcu);
507 if (vpd_pgb1)
508 kfree_rcu(vpd_pgb1, rcu);
509 if (vpd_pgb2)
510 kfree_rcu(vpd_pgb2, rcu);
511 kfree(sdev->inquiry);
512 kfree(sdev);
513
514 if (parent)
515 put_device(parent);
516}
517
518static struct class sdev_class = {
519 .name = "scsi_device",
520 .dev_release = scsi_device_cls_release,
521};
522
523/* all probing is done in the individual ->probe routines */
524static int scsi_bus_match(struct device *dev, struct device_driver *gendrv)
525{
526 struct scsi_device *sdp;
527
528 if (dev->type != &scsi_dev_type)
529 return 0;
530
531 sdp = to_scsi_device(dev);
532 if (sdp->no_uld_attach)
533 return 0;
534 return (sdp->inq_periph_qual == SCSI_INQ_PQ_CON)? 1: 0;
535}
536
537static int scsi_bus_uevent(struct device *dev, struct kobj_uevent_env *env)
538{
539 struct scsi_device *sdev;
540
541 if (dev->type != &scsi_dev_type)
542 return 0;
543
544 sdev = to_scsi_device(dev);
545
546 add_uevent_var(env, "MODALIAS=" SCSI_DEVICE_MODALIAS_FMT, sdev->type);
547 return 0;
548}
549
550struct bus_type scsi_bus_type = {
551 .name = "scsi",
552 .match = scsi_bus_match,
553 .uevent = scsi_bus_uevent,
554#ifdef CONFIG_PM
555 .pm = &scsi_bus_pm_ops,
556#endif
557};
558
559int scsi_sysfs_register(void)
560{
561 int error;
562
563 error = bus_register(&scsi_bus_type);
564 if (!error) {
565 error = class_register(&sdev_class);
566 if (error)
567 bus_unregister(&scsi_bus_type);
568 }
569
570 return error;
571}
572
573void scsi_sysfs_unregister(void)
574{
575 class_unregister(&sdev_class);
576 bus_unregister(&scsi_bus_type);
577}
578
579/*
580 * sdev_show_function: macro to create an attr function that can be used to
581 * show a non-bit field.
582 */
583#define sdev_show_function(field, format_string) \
584static ssize_t \
585sdev_show_##field (struct device *dev, struct device_attribute *attr, \
586 char *buf) \
587{ \
588 struct scsi_device *sdev; \
589 sdev = to_scsi_device(dev); \
590 return snprintf (buf, 20, format_string, sdev->field); \
591} \
592
593/*
594 * sdev_rd_attr: macro to create a function and attribute variable for a
595 * read only field.
596 */
597#define sdev_rd_attr(field, format_string) \
598 sdev_show_function(field, format_string) \
599static DEVICE_ATTR(field, S_IRUGO, sdev_show_##field, NULL);
600
601
602/*
603 * sdev_rw_attr: create a function and attribute variable for a
604 * read/write field.
605 */
606#define sdev_rw_attr(field, format_string) \
607 sdev_show_function(field, format_string) \
608 \
609static ssize_t \
610sdev_store_##field (struct device *dev, struct device_attribute *attr, \
611 const char *buf, size_t count) \
612{ \
613 struct scsi_device *sdev; \
614 sdev = to_scsi_device(dev); \
615 sscanf (buf, format_string, &sdev->field); \
616 return count; \
617} \
618static DEVICE_ATTR(field, S_IRUGO | S_IWUSR, sdev_show_##field, sdev_store_##field);
619
620/* Currently we don't export bit fields, but we might in future,
621 * so leave this code in */
622#if 0
623/*
624 * sdev_rd_attr: create a function and attribute variable for a
625 * read/write bit field.
626 */
627#define sdev_rw_attr_bit(field) \
628 sdev_show_function(field, "%d\n") \
629 \
630static ssize_t \
631sdev_store_##field (struct device *dev, struct device_attribute *attr, \
632 const char *buf, size_t count) \
633{ \
634 int ret; \
635 struct scsi_device *sdev; \
636 ret = scsi_sdev_check_buf_bit(buf); \
637 if (ret >= 0) { \
638 sdev = to_scsi_device(dev); \
639 sdev->field = ret; \
640 ret = count; \
641 } \
642 return ret; \
643} \
644static DEVICE_ATTR(field, S_IRUGO | S_IWUSR, sdev_show_##field, sdev_store_##field);
645
646/*
647 * scsi_sdev_check_buf_bit: return 0 if buf is "0", return 1 if buf is "1",
648 * else return -EINVAL.
649 */
650static int scsi_sdev_check_buf_bit(const char *buf)
651{
652 if ((buf[1] == '\0') || ((buf[1] == '\n') && (buf[2] == '\0'))) {
653 if (buf[0] == '1')
654 return 1;
655 else if (buf[0] == '0')
656 return 0;
657 else
658 return -EINVAL;
659 } else
660 return -EINVAL;
661}
662#endif
663/*
664 * Create the actual show/store functions and data structures.
665 */
666sdev_rd_attr (type, "%d\n");
667sdev_rd_attr (scsi_level, "%d\n");
668sdev_rd_attr (vendor, "%.8s\n");
669sdev_rd_attr (model, "%.16s\n");
670sdev_rd_attr (rev, "%.4s\n");
671
672static ssize_t
673sdev_show_device_busy(struct device *dev, struct device_attribute *attr,
674 char *buf)
675{
676 struct scsi_device *sdev = to_scsi_device(dev);
677 return snprintf(buf, 20, "%d\n", scsi_device_busy(sdev));
678}
679static DEVICE_ATTR(device_busy, S_IRUGO, sdev_show_device_busy, NULL);
680
681static ssize_t
682sdev_show_device_blocked(struct device *dev, struct device_attribute *attr,
683 char *buf)
684{
685 struct scsi_device *sdev = to_scsi_device(dev);
686 return snprintf(buf, 20, "%d\n", atomic_read(&sdev->device_blocked));
687}
688static DEVICE_ATTR(device_blocked, S_IRUGO, sdev_show_device_blocked, NULL);
689
690/*
691 * TODO: can we make these symlinks to the block layer ones?
692 */
693static ssize_t
694sdev_show_timeout (struct device *dev, struct device_attribute *attr, char *buf)
695{
696 struct scsi_device *sdev;
697 sdev = to_scsi_device(dev);
698 return snprintf(buf, 20, "%d\n", sdev->request_queue->rq_timeout / HZ);
699}
700
701static ssize_t
702sdev_store_timeout (struct device *dev, struct device_attribute *attr,
703 const char *buf, size_t count)
704{
705 struct scsi_device *sdev;
706 int timeout;
707 sdev = to_scsi_device(dev);
708 sscanf (buf, "%d\n", &timeout);
709 blk_queue_rq_timeout(sdev->request_queue, timeout * HZ);
710 return count;
711}
712static DEVICE_ATTR(timeout, S_IRUGO | S_IWUSR, sdev_show_timeout, sdev_store_timeout);
713
714static ssize_t
715sdev_show_eh_timeout(struct device *dev, struct device_attribute *attr, char *buf)
716{
717 struct scsi_device *sdev;
718 sdev = to_scsi_device(dev);
719 return snprintf(buf, 20, "%u\n", sdev->eh_timeout / HZ);
720}
721
722static ssize_t
723sdev_store_eh_timeout(struct device *dev, struct device_attribute *attr,
724 const char *buf, size_t count)
725{
726 struct scsi_device *sdev;
727 unsigned int eh_timeout;
728 int err;
729
730 if (!capable(CAP_SYS_ADMIN))
731 return -EACCES;
732
733 sdev = to_scsi_device(dev);
734 err = kstrtouint(buf, 10, &eh_timeout);
735 if (err)
736 return err;
737 sdev->eh_timeout = eh_timeout * HZ;
738
739 return count;
740}
741static DEVICE_ATTR(eh_timeout, S_IRUGO | S_IWUSR, sdev_show_eh_timeout, sdev_store_eh_timeout);
742
743static ssize_t
744store_rescan_field (struct device *dev, struct device_attribute *attr,
745 const char *buf, size_t count)
746{
747 scsi_rescan_device(dev);
748 return count;
749}
750static DEVICE_ATTR(rescan, S_IWUSR, NULL, store_rescan_field);
751
752static ssize_t
753sdev_store_delete(struct device *dev, struct device_attribute *attr,
754 const char *buf, size_t count)
755{
756 struct kernfs_node *kn;
757 struct scsi_device *sdev = to_scsi_device(dev);
758
759 /*
760 * We need to try to get module, avoiding the module been removed
761 * during delete.
762 */
763 if (scsi_device_get(sdev))
764 return -ENODEV;
765
766 kn = sysfs_break_active_protection(&dev->kobj, &attr->attr);
767 WARN_ON_ONCE(!kn);
768 /*
769 * Concurrent writes into the "delete" sysfs attribute may trigger
770 * concurrent calls to device_remove_file() and scsi_remove_device().
771 * device_remove_file() handles concurrent removal calls by
772 * serializing these and by ignoring the second and later removal
773 * attempts. Concurrent calls of scsi_remove_device() are
774 * serialized. The second and later calls of scsi_remove_device() are
775 * ignored because the first call of that function changes the device
776 * state into SDEV_DEL.
777 */
778 device_remove_file(dev, attr);
779 scsi_remove_device(sdev);
780 if (kn)
781 sysfs_unbreak_active_protection(kn);
782 scsi_device_put(sdev);
783 return count;
784};
785static DEVICE_ATTR(delete, S_IWUSR, NULL, sdev_store_delete);
786
787static ssize_t
788store_state_field(struct device *dev, struct device_attribute *attr,
789 const char *buf, size_t count)
790{
791 int i, ret;
792 struct scsi_device *sdev = to_scsi_device(dev);
793 enum scsi_device_state state = 0;
794 bool rescan_dev = false;
795
796 for (i = 0; i < ARRAY_SIZE(sdev_states); i++) {
797 const int len = strlen(sdev_states[i].name);
798 if (strncmp(sdev_states[i].name, buf, len) == 0 &&
799 buf[len] == '\n') {
800 state = sdev_states[i].value;
801 break;
802 }
803 }
804 switch (state) {
805 case SDEV_RUNNING:
806 case SDEV_OFFLINE:
807 break;
808 default:
809 return -EINVAL;
810 }
811
812 mutex_lock(&sdev->state_mutex);
813 switch (sdev->sdev_state) {
814 case SDEV_RUNNING:
815 case SDEV_OFFLINE:
816 break;
817 default:
818 mutex_unlock(&sdev->state_mutex);
819 return -EINVAL;
820 }
821 if (sdev->sdev_state == SDEV_RUNNING && state == SDEV_RUNNING) {
822 ret = 0;
823 } else {
824 ret = scsi_device_set_state(sdev, state);
825 if (ret == 0 && state == SDEV_RUNNING)
826 rescan_dev = true;
827 }
828 mutex_unlock(&sdev->state_mutex);
829
830 if (rescan_dev) {
831 /*
832 * If the device state changes to SDEV_RUNNING, we need to
833 * run the queue to avoid I/O hang, and rescan the device
834 * to revalidate it. Running the queue first is necessary
835 * because another thread may be waiting inside
836 * blk_mq_freeze_queue_wait() and because that call may be
837 * waiting for pending I/O to finish.
838 */
839 blk_mq_run_hw_queues(sdev->request_queue, true);
840 scsi_rescan_device(dev);
841 }
842
843 return ret == 0 ? count : -EINVAL;
844}
845
846static ssize_t
847show_state_field(struct device *dev, struct device_attribute *attr, char *buf)
848{
849 struct scsi_device *sdev = to_scsi_device(dev);
850 const char *name = scsi_device_state_name(sdev->sdev_state);
851
852 if (!name)
853 return -EINVAL;
854
855 return snprintf(buf, 20, "%s\n", name);
856}
857
858static DEVICE_ATTR(state, S_IRUGO | S_IWUSR, show_state_field, store_state_field);
859
860static ssize_t
861show_queue_type_field(struct device *dev, struct device_attribute *attr,
862 char *buf)
863{
864 struct scsi_device *sdev = to_scsi_device(dev);
865 const char *name = "none";
866
867 if (sdev->simple_tags)
868 name = "simple";
869
870 return snprintf(buf, 20, "%s\n", name);
871}
872
873static ssize_t
874store_queue_type_field(struct device *dev, struct device_attribute *attr,
875 const char *buf, size_t count)
876{
877 struct scsi_device *sdev = to_scsi_device(dev);
878
879 if (!sdev->tagged_supported)
880 return -EINVAL;
881
882 sdev_printk(KERN_INFO, sdev,
883 "ignoring write to deprecated queue_type attribute");
884 return count;
885}
886
887static DEVICE_ATTR(queue_type, S_IRUGO | S_IWUSR, show_queue_type_field,
888 store_queue_type_field);
889
890#define sdev_vpd_pg_attr(_page) \
891static ssize_t \
892show_vpd_##_page(struct file *filp, struct kobject *kobj, \
893 struct bin_attribute *bin_attr, \
894 char *buf, loff_t off, size_t count) \
895{ \
896 struct device *dev = kobj_to_dev(kobj); \
897 struct scsi_device *sdev = to_scsi_device(dev); \
898 struct scsi_vpd *vpd_page; \
899 int ret = -EINVAL; \
900 \
901 rcu_read_lock(); \
902 vpd_page = rcu_dereference(sdev->vpd_##_page); \
903 if (vpd_page) \
904 ret = memory_read_from_buffer(buf, count, &off, \
905 vpd_page->data, vpd_page->len); \
906 rcu_read_unlock(); \
907 return ret; \
908} \
909static struct bin_attribute dev_attr_vpd_##_page = { \
910 .attr = {.name = __stringify(vpd_##_page), .mode = S_IRUGO }, \
911 .size = 0, \
912 .read = show_vpd_##_page, \
913};
914
915sdev_vpd_pg_attr(pg83);
916sdev_vpd_pg_attr(pg80);
917sdev_vpd_pg_attr(pg89);
918sdev_vpd_pg_attr(pgb0);
919sdev_vpd_pg_attr(pgb1);
920sdev_vpd_pg_attr(pgb2);
921sdev_vpd_pg_attr(pg0);
922
923static ssize_t show_inquiry(struct file *filep, struct kobject *kobj,
924 struct bin_attribute *bin_attr,
925 char *buf, loff_t off, size_t count)
926{
927 struct device *dev = kobj_to_dev(kobj);
928 struct scsi_device *sdev = to_scsi_device(dev);
929
930 if (!sdev->inquiry)
931 return -EINVAL;
932
933 return memory_read_from_buffer(buf, count, &off, sdev->inquiry,
934 sdev->inquiry_len);
935}
936
937static struct bin_attribute dev_attr_inquiry = {
938 .attr = {
939 .name = "inquiry",
940 .mode = S_IRUGO,
941 },
942 .size = 0,
943 .read = show_inquiry,
944};
945
946static ssize_t
947show_iostat_counterbits(struct device *dev, struct device_attribute *attr,
948 char *buf)
949{
950 return snprintf(buf, 20, "%d\n", (int)sizeof(atomic_t) * 8);
951}
952
953static DEVICE_ATTR(iocounterbits, S_IRUGO, show_iostat_counterbits, NULL);
954
955#define show_sdev_iostat(field) \
956static ssize_t \
957show_iostat_##field(struct device *dev, struct device_attribute *attr, \
958 char *buf) \
959{ \
960 struct scsi_device *sdev = to_scsi_device(dev); \
961 unsigned long long count = atomic_read(&sdev->field); \
962 return snprintf(buf, 20, "0x%llx\n", count); \
963} \
964static DEVICE_ATTR(field, S_IRUGO, show_iostat_##field, NULL)
965
966show_sdev_iostat(iorequest_cnt);
967show_sdev_iostat(iodone_cnt);
968show_sdev_iostat(ioerr_cnt);
969show_sdev_iostat(iotmo_cnt);
970
971static ssize_t
972sdev_show_modalias(struct device *dev, struct device_attribute *attr, char *buf)
973{
974 struct scsi_device *sdev;
975 sdev = to_scsi_device(dev);
976 return snprintf (buf, 20, SCSI_DEVICE_MODALIAS_FMT "\n", sdev->type);
977}
978static DEVICE_ATTR(modalias, S_IRUGO, sdev_show_modalias, NULL);
979
980#define DECLARE_EVT_SHOW(name, Cap_name) \
981static ssize_t \
982sdev_show_evt_##name(struct device *dev, struct device_attribute *attr, \
983 char *buf) \
984{ \
985 struct scsi_device *sdev = to_scsi_device(dev); \
986 int val = test_bit(SDEV_EVT_##Cap_name, sdev->supported_events);\
987 return snprintf(buf, 20, "%d\n", val); \
988}
989
990#define DECLARE_EVT_STORE(name, Cap_name) \
991static ssize_t \
992sdev_store_evt_##name(struct device *dev, struct device_attribute *attr,\
993 const char *buf, size_t count) \
994{ \
995 struct scsi_device *sdev = to_scsi_device(dev); \
996 int val = simple_strtoul(buf, NULL, 0); \
997 if (val == 0) \
998 clear_bit(SDEV_EVT_##Cap_name, sdev->supported_events); \
999 else if (val == 1) \
1000 set_bit(SDEV_EVT_##Cap_name, sdev->supported_events); \
1001 else \
1002 return -EINVAL; \
1003 return count; \
1004}
1005
1006#define DECLARE_EVT(name, Cap_name) \
1007 DECLARE_EVT_SHOW(name, Cap_name) \
1008 DECLARE_EVT_STORE(name, Cap_name) \
1009 static DEVICE_ATTR(evt_##name, S_IRUGO, sdev_show_evt_##name, \
1010 sdev_store_evt_##name);
1011#define REF_EVT(name) &dev_attr_evt_##name.attr
1012
1013DECLARE_EVT(media_change, MEDIA_CHANGE)
1014DECLARE_EVT(inquiry_change_reported, INQUIRY_CHANGE_REPORTED)
1015DECLARE_EVT(capacity_change_reported, CAPACITY_CHANGE_REPORTED)
1016DECLARE_EVT(soft_threshold_reached, SOFT_THRESHOLD_REACHED_REPORTED)
1017DECLARE_EVT(mode_parameter_change_reported, MODE_PARAMETER_CHANGE_REPORTED)
1018DECLARE_EVT(lun_change_reported, LUN_CHANGE_REPORTED)
1019
1020static ssize_t
1021sdev_store_queue_depth(struct device *dev, struct device_attribute *attr,
1022 const char *buf, size_t count)
1023{
1024 int depth, retval;
1025 struct scsi_device *sdev = to_scsi_device(dev);
1026 struct scsi_host_template *sht = sdev->host->hostt;
1027
1028 if (!sht->change_queue_depth)
1029 return -EINVAL;
1030
1031 depth = simple_strtoul(buf, NULL, 0);
1032
1033 if (depth < 1 || depth > sdev->host->can_queue)
1034 return -EINVAL;
1035
1036 retval = sht->change_queue_depth(sdev, depth);
1037 if (retval < 0)
1038 return retval;
1039
1040 sdev->max_queue_depth = sdev->queue_depth;
1041
1042 return count;
1043}
1044sdev_show_function(queue_depth, "%d\n");
1045
1046static DEVICE_ATTR(queue_depth, S_IRUGO | S_IWUSR, sdev_show_queue_depth,
1047 sdev_store_queue_depth);
1048
1049static ssize_t
1050sdev_show_wwid(struct device *dev, struct device_attribute *attr,
1051 char *buf)
1052{
1053 struct scsi_device *sdev = to_scsi_device(dev);
1054 ssize_t count;
1055
1056 count = scsi_vpd_lun_id(sdev, buf, PAGE_SIZE);
1057 if (count > 0) {
1058 buf[count] = '\n';
1059 count++;
1060 }
1061 return count;
1062}
1063static DEVICE_ATTR(wwid, S_IRUGO, sdev_show_wwid, NULL);
1064
1065#define BLIST_FLAG_NAME(name) \
1066 [const_ilog2((__force __u64)BLIST_##name)] = #name
1067static const char *const sdev_bflags_name[] = {
1068#include "scsi_devinfo_tbl.c"
1069};
1070#undef BLIST_FLAG_NAME
1071
1072static ssize_t
1073sdev_show_blacklist(struct device *dev, struct device_attribute *attr,
1074 char *buf)
1075{
1076 struct scsi_device *sdev = to_scsi_device(dev);
1077 int i;
1078 ssize_t len = 0;
1079
1080 for (i = 0; i < sizeof(sdev->sdev_bflags) * BITS_PER_BYTE; i++) {
1081 const char *name = NULL;
1082
1083 if (!(sdev->sdev_bflags & (__force blist_flags_t)BIT(i)))
1084 continue;
1085 if (i < ARRAY_SIZE(sdev_bflags_name) && sdev_bflags_name[i])
1086 name = sdev_bflags_name[i];
1087
1088 if (name)
1089 len += scnprintf(buf + len, PAGE_SIZE - len,
1090 "%s%s", len ? " " : "", name);
1091 else
1092 len += scnprintf(buf + len, PAGE_SIZE - len,
1093 "%sINVALID_BIT(%d)", len ? " " : "", i);
1094 }
1095 if (len)
1096 len += scnprintf(buf + len, PAGE_SIZE - len, "\n");
1097 return len;
1098}
1099static DEVICE_ATTR(blacklist, S_IRUGO, sdev_show_blacklist, NULL);
1100
1101#ifdef CONFIG_SCSI_DH
1102static ssize_t
1103sdev_show_dh_state(struct device *dev, struct device_attribute *attr,
1104 char *buf)
1105{
1106 struct scsi_device *sdev = to_scsi_device(dev);
1107
1108 if (!sdev->handler)
1109 return snprintf(buf, 20, "detached\n");
1110
1111 return snprintf(buf, 20, "%s\n", sdev->handler->name);
1112}
1113
1114static ssize_t
1115sdev_store_dh_state(struct device *dev, struct device_attribute *attr,
1116 const char *buf, size_t count)
1117{
1118 struct scsi_device *sdev = to_scsi_device(dev);
1119 int err = -EINVAL;
1120
1121 if (sdev->sdev_state == SDEV_CANCEL ||
1122 sdev->sdev_state == SDEV_DEL)
1123 return -ENODEV;
1124
1125 if (!sdev->handler) {
1126 /*
1127 * Attach to a device handler
1128 */
1129 err = scsi_dh_attach(sdev->request_queue, buf);
1130 } else if (!strncmp(buf, "activate", 8)) {
1131 /*
1132 * Activate a device handler
1133 */
1134 if (sdev->handler->activate)
1135 err = sdev->handler->activate(sdev, NULL, NULL);
1136 else
1137 err = 0;
1138 } else if (!strncmp(buf, "detach", 6)) {
1139 /*
1140 * Detach from a device handler
1141 */
1142 sdev_printk(KERN_WARNING, sdev,
1143 "can't detach handler %s.\n",
1144 sdev->handler->name);
1145 err = -EINVAL;
1146 }
1147
1148 return err < 0 ? err : count;
1149}
1150
1151static DEVICE_ATTR(dh_state, S_IRUGO | S_IWUSR, sdev_show_dh_state,
1152 sdev_store_dh_state);
1153
1154static ssize_t
1155sdev_show_access_state(struct device *dev,
1156 struct device_attribute *attr,
1157 char *buf)
1158{
1159 struct scsi_device *sdev = to_scsi_device(dev);
1160 unsigned char access_state;
1161 const char *access_state_name;
1162
1163 if (!sdev->handler)
1164 return -EINVAL;
1165
1166 access_state = (sdev->access_state & SCSI_ACCESS_STATE_MASK);
1167 access_state_name = scsi_access_state_name(access_state);
1168
1169 return sprintf(buf, "%s\n",
1170 access_state_name ? access_state_name : "unknown");
1171}
1172static DEVICE_ATTR(access_state, S_IRUGO, sdev_show_access_state, NULL);
1173
1174static ssize_t
1175sdev_show_preferred_path(struct device *dev,
1176 struct device_attribute *attr,
1177 char *buf)
1178{
1179 struct scsi_device *sdev = to_scsi_device(dev);
1180
1181 if (!sdev->handler)
1182 return -EINVAL;
1183
1184 if (sdev->access_state & SCSI_ACCESS_STATE_PREFERRED)
1185 return sprintf(buf, "1\n");
1186 else
1187 return sprintf(buf, "0\n");
1188}
1189static DEVICE_ATTR(preferred_path, S_IRUGO, sdev_show_preferred_path, NULL);
1190#endif
1191
1192static ssize_t
1193sdev_show_queue_ramp_up_period(struct device *dev,
1194 struct device_attribute *attr,
1195 char *buf)
1196{
1197 struct scsi_device *sdev;
1198 sdev = to_scsi_device(dev);
1199 return snprintf(buf, 20, "%u\n",
1200 jiffies_to_msecs(sdev->queue_ramp_up_period));
1201}
1202
1203static ssize_t
1204sdev_store_queue_ramp_up_period(struct device *dev,
1205 struct device_attribute *attr,
1206 const char *buf, size_t count)
1207{
1208 struct scsi_device *sdev = to_scsi_device(dev);
1209 unsigned int period;
1210
1211 if (kstrtouint(buf, 10, &period))
1212 return -EINVAL;
1213
1214 sdev->queue_ramp_up_period = msecs_to_jiffies(period);
1215 return count;
1216}
1217
1218static DEVICE_ATTR(queue_ramp_up_period, S_IRUGO | S_IWUSR,
1219 sdev_show_queue_ramp_up_period,
1220 sdev_store_queue_ramp_up_period);
1221
1222static umode_t scsi_sdev_attr_is_visible(struct kobject *kobj,
1223 struct attribute *attr, int i)
1224{
1225 struct device *dev = kobj_to_dev(kobj);
1226 struct scsi_device *sdev = to_scsi_device(dev);
1227
1228
1229 if (attr == &dev_attr_queue_depth.attr &&
1230 !sdev->host->hostt->change_queue_depth)
1231 return S_IRUGO;
1232
1233 if (attr == &dev_attr_queue_ramp_up_period.attr &&
1234 !sdev->host->hostt->change_queue_depth)
1235 return 0;
1236
1237 return attr->mode;
1238}
1239
1240static umode_t scsi_sdev_bin_attr_is_visible(struct kobject *kobj,
1241 struct bin_attribute *attr, int i)
1242{
1243 struct device *dev = kobj_to_dev(kobj);
1244 struct scsi_device *sdev = to_scsi_device(dev);
1245
1246
1247 if (attr == &dev_attr_vpd_pg0 && !sdev->vpd_pg0)
1248 return 0;
1249
1250 if (attr == &dev_attr_vpd_pg80 && !sdev->vpd_pg80)
1251 return 0;
1252
1253 if (attr == &dev_attr_vpd_pg83 && !sdev->vpd_pg83)
1254 return 0;
1255
1256 if (attr == &dev_attr_vpd_pg89 && !sdev->vpd_pg89)
1257 return 0;
1258
1259 if (attr == &dev_attr_vpd_pgb0 && !sdev->vpd_pgb0)
1260 return 0;
1261
1262 if (attr == &dev_attr_vpd_pgb1 && !sdev->vpd_pgb1)
1263 return 0;
1264
1265 if (attr == &dev_attr_vpd_pgb2 && !sdev->vpd_pgb2)
1266 return 0;
1267
1268 return S_IRUGO;
1269}
1270
1271/* Default template for device attributes. May NOT be modified */
1272static struct attribute *scsi_sdev_attrs[] = {
1273 &dev_attr_device_blocked.attr,
1274 &dev_attr_type.attr,
1275 &dev_attr_scsi_level.attr,
1276 &dev_attr_device_busy.attr,
1277 &dev_attr_vendor.attr,
1278 &dev_attr_model.attr,
1279 &dev_attr_rev.attr,
1280 &dev_attr_rescan.attr,
1281 &dev_attr_delete.attr,
1282 &dev_attr_state.attr,
1283 &dev_attr_timeout.attr,
1284 &dev_attr_eh_timeout.attr,
1285 &dev_attr_iocounterbits.attr,
1286 &dev_attr_iorequest_cnt.attr,
1287 &dev_attr_iodone_cnt.attr,
1288 &dev_attr_ioerr_cnt.attr,
1289 &dev_attr_iotmo_cnt.attr,
1290 &dev_attr_modalias.attr,
1291 &dev_attr_queue_depth.attr,
1292 &dev_attr_queue_type.attr,
1293 &dev_attr_wwid.attr,
1294 &dev_attr_blacklist.attr,
1295#ifdef CONFIG_SCSI_DH
1296 &dev_attr_dh_state.attr,
1297 &dev_attr_access_state.attr,
1298 &dev_attr_preferred_path.attr,
1299#endif
1300 &dev_attr_queue_ramp_up_period.attr,
1301 REF_EVT(media_change),
1302 REF_EVT(inquiry_change_reported),
1303 REF_EVT(capacity_change_reported),
1304 REF_EVT(soft_threshold_reached),
1305 REF_EVT(mode_parameter_change_reported),
1306 REF_EVT(lun_change_reported),
1307 NULL
1308};
1309
1310static struct bin_attribute *scsi_sdev_bin_attrs[] = {
1311 &dev_attr_vpd_pg0,
1312 &dev_attr_vpd_pg83,
1313 &dev_attr_vpd_pg80,
1314 &dev_attr_vpd_pg89,
1315 &dev_attr_vpd_pgb0,
1316 &dev_attr_vpd_pgb1,
1317 &dev_attr_vpd_pgb2,
1318 &dev_attr_inquiry,
1319 NULL
1320};
1321static struct attribute_group scsi_sdev_attr_group = {
1322 .attrs = scsi_sdev_attrs,
1323 .bin_attrs = scsi_sdev_bin_attrs,
1324 .is_visible = scsi_sdev_attr_is_visible,
1325 .is_bin_visible = scsi_sdev_bin_attr_is_visible,
1326};
1327
1328static const struct attribute_group *scsi_sdev_attr_groups[] = {
1329 &scsi_sdev_attr_group,
1330 NULL
1331};
1332
1333static int scsi_target_add(struct scsi_target *starget)
1334{
1335 int error;
1336
1337 if (starget->state != STARGET_CREATED)
1338 return 0;
1339
1340 error = device_add(&starget->dev);
1341 if (error) {
1342 dev_err(&starget->dev, "target device_add failed, error %d\n", error);
1343 return error;
1344 }
1345 transport_add_device(&starget->dev);
1346 starget->state = STARGET_RUNNING;
1347
1348 pm_runtime_set_active(&starget->dev);
1349 pm_runtime_enable(&starget->dev);
1350 device_enable_async_suspend(&starget->dev);
1351
1352 return 0;
1353}
1354
1355/**
1356 * scsi_sysfs_add_sdev - add scsi device to sysfs
1357 * @sdev: scsi_device to add
1358 *
1359 * Return value:
1360 * 0 on Success / non-zero on Failure
1361 **/
1362int scsi_sysfs_add_sdev(struct scsi_device *sdev)
1363{
1364 int error;
1365 struct scsi_target *starget = sdev->sdev_target;
1366
1367 error = scsi_target_add(starget);
1368 if (error)
1369 return error;
1370
1371 transport_configure_device(&starget->dev);
1372
1373 device_enable_async_suspend(&sdev->sdev_gendev);
1374 scsi_autopm_get_target(starget);
1375 pm_runtime_set_active(&sdev->sdev_gendev);
1376 if (!sdev->rpm_autosuspend)
1377 pm_runtime_forbid(&sdev->sdev_gendev);
1378 pm_runtime_enable(&sdev->sdev_gendev);
1379 scsi_autopm_put_target(starget);
1380
1381 scsi_autopm_get_device(sdev);
1382
1383 scsi_dh_add_device(sdev);
1384
1385 error = device_add(&sdev->sdev_gendev);
1386 if (error) {
1387 sdev_printk(KERN_INFO, sdev,
1388 "failed to add device: %d\n", error);
1389 return error;
1390 }
1391
1392 device_enable_async_suspend(&sdev->sdev_dev);
1393 error = device_add(&sdev->sdev_dev);
1394 if (error) {
1395 sdev_printk(KERN_INFO, sdev,
1396 "failed to add class device: %d\n", error);
1397 device_del(&sdev->sdev_gendev);
1398 return error;
1399 }
1400 transport_add_device(&sdev->sdev_gendev);
1401 sdev->is_visible = 1;
1402
1403 if (IS_ENABLED(CONFIG_BLK_DEV_BSG)) {
1404 sdev->bsg_dev = scsi_bsg_register_queue(sdev);
1405 if (IS_ERR(sdev->bsg_dev)) {
1406 error = PTR_ERR(sdev->bsg_dev);
1407 sdev_printk(KERN_INFO, sdev,
1408 "Failed to register bsg queue, errno=%d\n",
1409 error);
1410 sdev->bsg_dev = NULL;
1411 }
1412 }
1413
1414 scsi_autopm_put_device(sdev);
1415 return error;
1416}
1417
1418void __scsi_remove_device(struct scsi_device *sdev)
1419{
1420 struct device *dev = &sdev->sdev_gendev;
1421 int res;
1422
1423 /*
1424 * This cleanup path is not reentrant and while it is impossible
1425 * to get a new reference with scsi_device_get() someone can still
1426 * hold a previously acquired one.
1427 */
1428 if (sdev->sdev_state == SDEV_DEL)
1429 return;
1430
1431 if (sdev->is_visible) {
1432 /*
1433 * If scsi_internal_target_block() is running concurrently,
1434 * wait until it has finished before changing the device state.
1435 */
1436 mutex_lock(&sdev->state_mutex);
1437 /*
1438 * If blocked, we go straight to DEL and restart the queue so
1439 * any commands issued during driver shutdown (like sync
1440 * cache) are errored immediately.
1441 */
1442 res = scsi_device_set_state(sdev, SDEV_CANCEL);
1443 if (res != 0) {
1444 res = scsi_device_set_state(sdev, SDEV_DEL);
1445 if (res == 0)
1446 scsi_start_queue(sdev);
1447 }
1448 mutex_unlock(&sdev->state_mutex);
1449
1450 if (res != 0)
1451 return;
1452
1453 if (IS_ENABLED(CONFIG_BLK_DEV_BSG) && sdev->bsg_dev)
1454 bsg_unregister_queue(sdev->bsg_dev);
1455 device_unregister(&sdev->sdev_dev);
1456 transport_remove_device(dev);
1457 device_del(dev);
1458 } else
1459 put_device(&sdev->sdev_dev);
1460
1461 /*
1462 * Stop accepting new requests and wait until all queuecommand() and
1463 * scsi_run_queue() invocations have finished before tearing down the
1464 * device.
1465 */
1466 mutex_lock(&sdev->state_mutex);
1467 scsi_device_set_state(sdev, SDEV_DEL);
1468 mutex_unlock(&sdev->state_mutex);
1469
1470 blk_mq_destroy_queue(sdev->request_queue);
1471 kref_put(&sdev->host->tagset_refcnt, scsi_mq_free_tags);
1472 cancel_work_sync(&sdev->requeue_work);
1473
1474 if (sdev->host->hostt->slave_destroy)
1475 sdev->host->hostt->slave_destroy(sdev);
1476 transport_destroy_device(dev);
1477
1478 /*
1479 * Paired with the kref_get() in scsi_sysfs_initialize(). We have
1480 * removed sysfs visibility from the device, so make the target
1481 * invisible if this was the last device underneath it.
1482 */
1483 scsi_target_reap(scsi_target(sdev));
1484
1485 put_device(dev);
1486}
1487
1488/**
1489 * scsi_remove_device - unregister a device from the scsi bus
1490 * @sdev: scsi_device to unregister
1491 **/
1492void scsi_remove_device(struct scsi_device *sdev)
1493{
1494 struct Scsi_Host *shost = sdev->host;
1495
1496 mutex_lock(&shost->scan_mutex);
1497 __scsi_remove_device(sdev);
1498 mutex_unlock(&shost->scan_mutex);
1499}
1500EXPORT_SYMBOL(scsi_remove_device);
1501
1502static void __scsi_remove_target(struct scsi_target *starget)
1503{
1504 struct Scsi_Host *shost = dev_to_shost(starget->dev.parent);
1505 unsigned long flags;
1506 struct scsi_device *sdev;
1507
1508 spin_lock_irqsave(shost->host_lock, flags);
1509 restart:
1510 list_for_each_entry(sdev, &shost->__devices, siblings) {
1511 /*
1512 * We cannot call scsi_device_get() here, as
1513 * we might've been called from rmmod() causing
1514 * scsi_device_get() to fail the module_is_live()
1515 * check.
1516 */
1517 if (sdev->channel != starget->channel ||
1518 sdev->id != starget->id)
1519 continue;
1520 if (sdev->sdev_state == SDEV_DEL ||
1521 sdev->sdev_state == SDEV_CANCEL ||
1522 !get_device(&sdev->sdev_gendev))
1523 continue;
1524 spin_unlock_irqrestore(shost->host_lock, flags);
1525 scsi_remove_device(sdev);
1526 put_device(&sdev->sdev_gendev);
1527 spin_lock_irqsave(shost->host_lock, flags);
1528 goto restart;
1529 }
1530 spin_unlock_irqrestore(shost->host_lock, flags);
1531}
1532
1533/**
1534 * scsi_remove_target - try to remove a target and all its devices
1535 * @dev: generic starget or parent of generic stargets to be removed
1536 *
1537 * Note: This is slightly racy. It is possible that if the user
1538 * requests the addition of another device then the target won't be
1539 * removed.
1540 */
1541void scsi_remove_target(struct device *dev)
1542{
1543 struct Scsi_Host *shost = dev_to_shost(dev->parent);
1544 struct scsi_target *starget;
1545 unsigned long flags;
1546
1547restart:
1548 spin_lock_irqsave(shost->host_lock, flags);
1549 list_for_each_entry(starget, &shost->__targets, siblings) {
1550 if (starget->state == STARGET_DEL ||
1551 starget->state == STARGET_REMOVE ||
1552 starget->state == STARGET_CREATED_REMOVE)
1553 continue;
1554 if (starget->dev.parent == dev || &starget->dev == dev) {
1555 kref_get(&starget->reap_ref);
1556 if (starget->state == STARGET_CREATED)
1557 starget->state = STARGET_CREATED_REMOVE;
1558 else
1559 starget->state = STARGET_REMOVE;
1560 spin_unlock_irqrestore(shost->host_lock, flags);
1561 __scsi_remove_target(starget);
1562 scsi_target_reap(starget);
1563 goto restart;
1564 }
1565 }
1566 spin_unlock_irqrestore(shost->host_lock, flags);
1567}
1568EXPORT_SYMBOL(scsi_remove_target);
1569
1570int scsi_register_driver(struct device_driver *drv)
1571{
1572 drv->bus = &scsi_bus_type;
1573
1574 return driver_register(drv);
1575}
1576EXPORT_SYMBOL(scsi_register_driver);
1577
1578int scsi_register_interface(struct class_interface *intf)
1579{
1580 intf->class = &sdev_class;
1581
1582 return class_interface_register(intf);
1583}
1584EXPORT_SYMBOL(scsi_register_interface);
1585
1586/**
1587 * scsi_sysfs_add_host - add scsi host to subsystem
1588 * @shost: scsi host struct to add to subsystem
1589 **/
1590int scsi_sysfs_add_host(struct Scsi_Host *shost)
1591{
1592 transport_register_device(&shost->shost_gendev);
1593 transport_configure_device(&shost->shost_gendev);
1594 return 0;
1595}
1596
1597static struct device_type scsi_dev_type = {
1598 .name = "scsi_device",
1599 .release = scsi_device_dev_release,
1600 .groups = scsi_sdev_attr_groups,
1601};
1602
1603void scsi_sysfs_device_initialize(struct scsi_device *sdev)
1604{
1605 unsigned long flags;
1606 struct Scsi_Host *shost = sdev->host;
1607 struct scsi_host_template *hostt = shost->hostt;
1608 struct scsi_target *starget = sdev->sdev_target;
1609
1610 device_initialize(&sdev->sdev_gendev);
1611 sdev->sdev_gendev.bus = &scsi_bus_type;
1612 sdev->sdev_gendev.type = &scsi_dev_type;
1613 scsi_enable_async_suspend(&sdev->sdev_gendev);
1614 dev_set_name(&sdev->sdev_gendev, "%d:%d:%d:%llu",
1615 sdev->host->host_no, sdev->channel, sdev->id, sdev->lun);
1616 sdev->sdev_gendev.groups = hostt->sdev_groups;
1617
1618 device_initialize(&sdev->sdev_dev);
1619 sdev->sdev_dev.parent = get_device(&sdev->sdev_gendev);
1620 sdev->sdev_dev.class = &sdev_class;
1621 dev_set_name(&sdev->sdev_dev, "%d:%d:%d:%llu",
1622 sdev->host->host_no, sdev->channel, sdev->id, sdev->lun);
1623 /*
1624 * Get a default scsi_level from the target (derived from sibling
1625 * devices). This is the best we can do for guessing how to set
1626 * sdev->lun_in_cdb for the initial INQUIRY command. For LUN 0 the
1627 * setting doesn't matter, because all the bits are zero anyway.
1628 * But it does matter for higher LUNs.
1629 */
1630 sdev->scsi_level = starget->scsi_level;
1631 if (sdev->scsi_level <= SCSI_2 &&
1632 sdev->scsi_level != SCSI_UNKNOWN &&
1633 !shost->no_scsi2_lun_in_cdb)
1634 sdev->lun_in_cdb = 1;
1635
1636 transport_setup_device(&sdev->sdev_gendev);
1637 spin_lock_irqsave(shost->host_lock, flags);
1638 list_add_tail(&sdev->same_target_siblings, &starget->devices);
1639 list_add_tail(&sdev->siblings, &shost->__devices);
1640 spin_unlock_irqrestore(shost->host_lock, flags);
1641 /*
1642 * device can now only be removed via __scsi_remove_device() so hold
1643 * the target. Target will be held in CREATED state until something
1644 * beneath it becomes visible (in which case it moves to RUNNING)
1645 */
1646 kref_get(&starget->reap_ref);
1647}
1648
1649int scsi_is_sdev_device(const struct device *dev)
1650{
1651 return dev->type == &scsi_dev_type;
1652}
1653EXPORT_SYMBOL(scsi_is_sdev_device);
1654
1655/* A blank transport template that is used in drivers that don't
1656 * yet implement Transport Attributes */
1657struct scsi_transport_template blank_transport_template = { { { {NULL, }, }, }, };