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