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