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