Back to home page

OSCL-LXR
 
 

     

0001 // SPDX-License-Identifier: GPL-2.0-only
0002 /*
0003  * scsi_sysfs.c
0004  *
0005  * SCSI sysfs interface routines.
0006  *
0007  * Created to pull SCSI mid layer sysfs routines into one file.
0008  */
0009 
0010 #include <linux/module.h>
0011 #include <linux/slab.h>
0012 #include <linux/init.h>
0013 #include <linux/blkdev.h>
0014 #include <linux/device.h>
0015 #include <linux/pm_runtime.h>
0016 #include <linux/bsg.h>
0017 
0018 #include <scsi/scsi.h>
0019 #include <scsi/scsi_device.h>
0020 #include <scsi/scsi_host.h>
0021 #include <scsi/scsi_tcq.h>
0022 #include <scsi/scsi_dh.h>
0023 #include <scsi/scsi_transport.h>
0024 #include <scsi/scsi_driver.h>
0025 #include <scsi/scsi_devinfo.h>
0026 
0027 #include "scsi_priv.h"
0028 #include "scsi_logging.h"
0029 
0030 static struct device_type scsi_dev_type;
0031 
0032 static const struct {
0033     enum scsi_device_state  value;
0034     char            *name;
0035 } sdev_states[] = {
0036     { SDEV_CREATED, "created" },
0037     { SDEV_RUNNING, "running" },
0038     { SDEV_CANCEL, "cancel" },
0039     { SDEV_DEL, "deleted" },
0040     { SDEV_QUIESCE, "quiesce" },
0041     { SDEV_OFFLINE, "offline" },
0042     { SDEV_TRANSPORT_OFFLINE, "transport-offline" },
0043     { SDEV_BLOCK,   "blocked" },
0044     { SDEV_CREATED_BLOCK, "created-blocked" },
0045 };
0046 
0047 const char *scsi_device_state_name(enum scsi_device_state state)
0048 {
0049     int i;
0050     char *name = NULL;
0051 
0052     for (i = 0; i < ARRAY_SIZE(sdev_states); i++) {
0053         if (sdev_states[i].value == state) {
0054             name = sdev_states[i].name;
0055             break;
0056         }
0057     }
0058     return name;
0059 }
0060 
0061 static const struct {
0062     enum scsi_host_state    value;
0063     char            *name;
0064 } shost_states[] = {
0065     { SHOST_CREATED, "created" },
0066     { SHOST_RUNNING, "running" },
0067     { SHOST_CANCEL, "cancel" },
0068     { SHOST_DEL, "deleted" },
0069     { SHOST_RECOVERY, "recovery" },
0070     { SHOST_CANCEL_RECOVERY, "cancel/recovery" },
0071     { SHOST_DEL_RECOVERY, "deleted/recovery", },
0072 };
0073 const char *scsi_host_state_name(enum scsi_host_state state)
0074 {
0075     int i;
0076     char *name = NULL;
0077 
0078     for (i = 0; i < ARRAY_SIZE(shost_states); i++) {
0079         if (shost_states[i].value == state) {
0080             name = shost_states[i].name;
0081             break;
0082         }
0083     }
0084     return name;
0085 }
0086 
0087 #ifdef CONFIG_SCSI_DH
0088 static const struct {
0089     unsigned char   value;
0090     char        *name;
0091 } sdev_access_states[] = {
0092     { SCSI_ACCESS_STATE_OPTIMAL, "active/optimized" },
0093     { SCSI_ACCESS_STATE_ACTIVE, "active/non-optimized" },
0094     { SCSI_ACCESS_STATE_STANDBY, "standby" },
0095     { SCSI_ACCESS_STATE_UNAVAILABLE, "unavailable" },
0096     { SCSI_ACCESS_STATE_LBA, "lba-dependent" },
0097     { SCSI_ACCESS_STATE_OFFLINE, "offline" },
0098     { SCSI_ACCESS_STATE_TRANSITIONING, "transitioning" },
0099 };
0100 
0101 static const char *scsi_access_state_name(unsigned char state)
0102 {
0103     int i;
0104     char *name = NULL;
0105 
0106     for (i = 0; i < ARRAY_SIZE(sdev_access_states); i++) {
0107         if (sdev_access_states[i].value == state) {
0108             name = sdev_access_states[i].name;
0109             break;
0110         }
0111     }
0112     return name;
0113 }
0114 #endif
0115 
0116 static int check_set(unsigned long long *val, char *src)
0117 {
0118     char *last;
0119 
0120     if (strcmp(src, "-") == 0) {
0121         *val = SCAN_WILD_CARD;
0122     } else {
0123         /*
0124          * Doesn't check for int overflow
0125          */
0126         *val = simple_strtoull(src, &last, 0);
0127         if (*last != '\0')
0128             return 1;
0129     }
0130     return 0;
0131 }
0132 
0133 static int scsi_scan(struct Scsi_Host *shost, const char *str)
0134 {
0135     char s1[15], s2[15], s3[17], junk;
0136     unsigned long long channel, id, lun;
0137     int res;
0138 
0139     res = sscanf(str, "%10s %10s %16s %c", s1, s2, s3, &junk);
0140     if (res != 3)
0141         return -EINVAL;
0142     if (check_set(&channel, s1))
0143         return -EINVAL;
0144     if (check_set(&id, s2))
0145         return -EINVAL;
0146     if (check_set(&lun, s3))
0147         return -EINVAL;
0148     if (shost->transportt->user_scan)
0149         res = shost->transportt->user_scan(shost, channel, id, lun);
0150     else
0151         res = scsi_scan_host_selected(shost, channel, id, lun,
0152                           SCSI_SCAN_MANUAL);
0153     return res;
0154 }
0155 
0156 /*
0157  * shost_show_function: macro to create an attr function that can be used to
0158  * show a non-bit field.
0159  */
0160 #define shost_show_function(name, field, format_string)         \
0161 static ssize_t                              \
0162 show_##name (struct device *dev, struct device_attribute *attr,     \
0163          char *buf)                         \
0164 {                                   \
0165     struct Scsi_Host *shost = class_to_shost(dev);          \
0166     return snprintf (buf, 20, format_string, shost->field);     \
0167 }
0168 
0169 /*
0170  * shost_rd_attr: macro to create a function and attribute variable for a
0171  * read only field.
0172  */
0173 #define shost_rd_attr2(name, field, format_string)          \
0174     shost_show_function(name, field, format_string)         \
0175 static DEVICE_ATTR(name, S_IRUGO, show_##name, NULL);
0176 
0177 #define shost_rd_attr(field, format_string) \
0178 shost_rd_attr2(field, field, format_string)
0179 
0180 /*
0181  * Create the actual show/store functions and data structures.
0182  */
0183 
0184 static ssize_t
0185 store_scan(struct device *dev, struct device_attribute *attr,
0186        const char *buf, size_t count)
0187 {
0188     struct Scsi_Host *shost = class_to_shost(dev);
0189     int res;
0190 
0191     res = scsi_scan(shost, buf);
0192     if (res == 0)
0193         res = count;
0194     return res;
0195 };
0196 static DEVICE_ATTR(scan, S_IWUSR, NULL, store_scan);
0197 
0198 static ssize_t
0199 store_shost_state(struct device *dev, struct device_attribute *attr,
0200           const char *buf, size_t count)
0201 {
0202     int i;
0203     struct Scsi_Host *shost = class_to_shost(dev);
0204     enum scsi_host_state state = 0;
0205 
0206     for (i = 0; i < ARRAY_SIZE(shost_states); i++) {
0207         const int len = strlen(shost_states[i].name);
0208         if (strncmp(shost_states[i].name, buf, len) == 0 &&
0209            buf[len] == '\n') {
0210             state = shost_states[i].value;
0211             break;
0212         }
0213     }
0214     if (!state)
0215         return -EINVAL;
0216 
0217     if (scsi_host_set_state(shost, state))
0218         return -EINVAL;
0219     return count;
0220 }
0221 
0222 static ssize_t
0223 show_shost_state(struct device *dev, struct device_attribute *attr, char *buf)
0224 {
0225     struct Scsi_Host *shost = class_to_shost(dev);
0226     const char *name = scsi_host_state_name(shost->shost_state);
0227 
0228     if (!name)
0229         return -EINVAL;
0230 
0231     return snprintf(buf, 20, "%s\n", name);
0232 }
0233 
0234 /* DEVICE_ATTR(state) clashes with dev_attr_state for sdev */
0235 static struct device_attribute dev_attr_hstate =
0236     __ATTR(state, S_IRUGO | S_IWUSR, show_shost_state, store_shost_state);
0237 
0238 static ssize_t
0239 show_shost_mode(unsigned int mode, char *buf)
0240 {
0241     ssize_t len = 0;
0242 
0243     if (mode & MODE_INITIATOR)
0244         len = sprintf(buf, "%s", "Initiator");
0245 
0246     if (mode & MODE_TARGET)
0247         len += sprintf(buf + len, "%s%s", len ? ", " : "", "Target");
0248 
0249     len += sprintf(buf + len, "\n");
0250 
0251     return len;
0252 }
0253 
0254 static ssize_t
0255 show_shost_supported_mode(struct device *dev, struct device_attribute *attr,
0256               char *buf)
0257 {
0258     struct Scsi_Host *shost = class_to_shost(dev);
0259     unsigned int supported_mode = shost->hostt->supported_mode;
0260 
0261     if (supported_mode == MODE_UNKNOWN)
0262         /* by default this should be initiator */
0263         supported_mode = MODE_INITIATOR;
0264 
0265     return show_shost_mode(supported_mode, buf);
0266 }
0267 
0268 static DEVICE_ATTR(supported_mode, S_IRUGO | S_IWUSR, show_shost_supported_mode, NULL);
0269 
0270 static ssize_t
0271 show_shost_active_mode(struct device *dev,
0272                struct device_attribute *attr, char *buf)
0273 {
0274     struct Scsi_Host *shost = class_to_shost(dev);
0275 
0276     if (shost->active_mode == MODE_UNKNOWN)
0277         return snprintf(buf, 20, "unknown\n");
0278     else
0279         return show_shost_mode(shost->active_mode, buf);
0280 }
0281 
0282 static DEVICE_ATTR(active_mode, S_IRUGO | S_IWUSR, show_shost_active_mode, NULL);
0283 
0284 static int check_reset_type(const char *str)
0285 {
0286     if (sysfs_streq(str, "adapter"))
0287         return SCSI_ADAPTER_RESET;
0288     else if (sysfs_streq(str, "firmware"))
0289         return SCSI_FIRMWARE_RESET;
0290     else
0291         return 0;
0292 }
0293 
0294 static ssize_t
0295 store_host_reset(struct device *dev, struct device_attribute *attr,
0296         const char *buf, size_t count)
0297 {
0298     struct Scsi_Host *shost = class_to_shost(dev);
0299     struct scsi_host_template *sht = shost->hostt;
0300     int ret = -EINVAL;
0301     int type;
0302 
0303     type = check_reset_type(buf);
0304     if (!type)
0305         goto exit_store_host_reset;
0306 
0307     if (sht->host_reset)
0308         ret = sht->host_reset(shost, type);
0309     else
0310         ret = -EOPNOTSUPP;
0311 
0312 exit_store_host_reset:
0313     if (ret == 0)
0314         ret = count;
0315     return ret;
0316 }
0317 
0318 static DEVICE_ATTR(host_reset, S_IWUSR, NULL, store_host_reset);
0319 
0320 static ssize_t
0321 show_shost_eh_deadline(struct device *dev,
0322               struct device_attribute *attr, char *buf)
0323 {
0324     struct Scsi_Host *shost = class_to_shost(dev);
0325 
0326     if (shost->eh_deadline == -1)
0327         return snprintf(buf, strlen("off") + 2, "off\n");
0328     return sprintf(buf, "%u\n", shost->eh_deadline / HZ);
0329 }
0330 
0331 static ssize_t
0332 store_shost_eh_deadline(struct device *dev, struct device_attribute *attr,
0333         const char *buf, size_t count)
0334 {
0335     struct Scsi_Host *shost = class_to_shost(dev);
0336     int ret = -EINVAL;
0337     unsigned long deadline, flags;
0338 
0339     if (shost->transportt &&
0340         (shost->transportt->eh_strategy_handler ||
0341          !shost->hostt->eh_host_reset_handler))
0342         return ret;
0343 
0344     if (!strncmp(buf, "off", strlen("off")))
0345         deadline = -1;
0346     else {
0347         ret = kstrtoul(buf, 10, &deadline);
0348         if (ret)
0349             return ret;
0350         if (deadline * HZ > UINT_MAX)
0351             return -EINVAL;
0352     }
0353 
0354     spin_lock_irqsave(shost->host_lock, flags);
0355     if (scsi_host_in_recovery(shost))
0356         ret = -EBUSY;
0357     else {
0358         if (deadline == -1)
0359             shost->eh_deadline = -1;
0360         else
0361             shost->eh_deadline = deadline * HZ;
0362 
0363         ret = count;
0364     }
0365     spin_unlock_irqrestore(shost->host_lock, flags);
0366 
0367     return ret;
0368 }
0369 
0370 static DEVICE_ATTR(eh_deadline, S_IRUGO | S_IWUSR, show_shost_eh_deadline, store_shost_eh_deadline);
0371 
0372 shost_rd_attr(unique_id, "%u\n");
0373 shost_rd_attr(cmd_per_lun, "%hd\n");
0374 shost_rd_attr(can_queue, "%d\n");
0375 shost_rd_attr(sg_tablesize, "%hu\n");
0376 shost_rd_attr(sg_prot_tablesize, "%hu\n");
0377 shost_rd_attr(prot_capabilities, "%u\n");
0378 shost_rd_attr(prot_guard_type, "%hd\n");
0379 shost_rd_attr2(proc_name, hostt->proc_name, "%s\n");
0380 
0381 static ssize_t
0382 show_host_busy(struct device *dev, struct device_attribute *attr, char *buf)
0383 {
0384     struct Scsi_Host *shost = class_to_shost(dev);
0385     return snprintf(buf, 20, "%d\n", scsi_host_busy(shost));
0386 }
0387 static DEVICE_ATTR(host_busy, S_IRUGO, show_host_busy, NULL);
0388 
0389 static ssize_t
0390 show_use_blk_mq(struct device *dev, struct device_attribute *attr, char *buf)
0391 {
0392     return sprintf(buf, "1\n");
0393 }
0394 static DEVICE_ATTR(use_blk_mq, S_IRUGO, show_use_blk_mq, NULL);
0395 
0396 static ssize_t
0397 show_nr_hw_queues(struct device *dev, struct device_attribute *attr, char *buf)
0398 {
0399     struct Scsi_Host *shost = class_to_shost(dev);
0400     struct blk_mq_tag_set *tag_set = &shost->tag_set;
0401 
0402     return snprintf(buf, 20, "%d\n", tag_set->nr_hw_queues);
0403 }
0404 static DEVICE_ATTR(nr_hw_queues, S_IRUGO, show_nr_hw_queues, NULL);
0405 
0406 static struct attribute *scsi_sysfs_shost_attrs[] = {
0407     &dev_attr_use_blk_mq.attr,
0408     &dev_attr_unique_id.attr,
0409     &dev_attr_host_busy.attr,
0410     &dev_attr_cmd_per_lun.attr,
0411     &dev_attr_can_queue.attr,
0412     &dev_attr_sg_tablesize.attr,
0413     &dev_attr_sg_prot_tablesize.attr,
0414     &dev_attr_proc_name.attr,
0415     &dev_attr_scan.attr,
0416     &dev_attr_hstate.attr,
0417     &dev_attr_supported_mode.attr,
0418     &dev_attr_active_mode.attr,
0419     &dev_attr_prot_capabilities.attr,
0420     &dev_attr_prot_guard_type.attr,
0421     &dev_attr_host_reset.attr,
0422     &dev_attr_eh_deadline.attr,
0423     &dev_attr_nr_hw_queues.attr,
0424     NULL
0425 };
0426 
0427 static const struct attribute_group scsi_shost_attr_group = {
0428     .attrs =    scsi_sysfs_shost_attrs,
0429 };
0430 
0431 const struct attribute_group *scsi_shost_groups[] = {
0432     &scsi_shost_attr_group,
0433     NULL
0434 };
0435 
0436 static void scsi_device_cls_release(struct device *class_dev)
0437 {
0438     struct scsi_device *sdev;
0439 
0440     sdev = class_to_sdev(class_dev);
0441     put_device(&sdev->sdev_gendev);
0442 }
0443 
0444 static void scsi_device_dev_release_usercontext(struct work_struct *work)
0445 {
0446     struct scsi_device *sdev;
0447     struct device *parent;
0448     struct list_head *this, *tmp;
0449     struct scsi_vpd *vpd_pg80 = NULL, *vpd_pg83 = NULL;
0450     struct scsi_vpd *vpd_pg0 = NULL, *vpd_pg89 = NULL;
0451     struct scsi_vpd *vpd_pgb0 = NULL, *vpd_pgb1 = NULL, *vpd_pgb2 = NULL;
0452     unsigned long flags;
0453     struct module *mod;
0454 
0455     sdev = container_of(work, struct scsi_device, ew.work);
0456 
0457     mod = sdev->host->hostt->module;
0458 
0459     scsi_dh_release_device(sdev);
0460 
0461     parent = sdev->sdev_gendev.parent;
0462 
0463     spin_lock_irqsave(sdev->host->host_lock, flags);
0464     list_del(&sdev->siblings);
0465     list_del(&sdev->same_target_siblings);
0466     list_del(&sdev->starved_entry);
0467     spin_unlock_irqrestore(sdev->host->host_lock, flags);
0468 
0469     cancel_work_sync(&sdev->event_work);
0470 
0471     list_for_each_safe(this, tmp, &sdev->event_list) {
0472         struct scsi_event *evt;
0473 
0474         evt = list_entry(this, struct scsi_event, node);
0475         list_del(&evt->node);
0476         kfree(evt);
0477     }
0478 
0479     blk_put_queue(sdev->request_queue);
0480     /* NULL queue means the device can't be used */
0481     sdev->request_queue = NULL;
0482 
0483     sbitmap_free(&sdev->budget_map);
0484 
0485     mutex_lock(&sdev->inquiry_mutex);
0486     vpd_pg0 = rcu_replace_pointer(sdev->vpd_pg0, vpd_pg0,
0487                        lockdep_is_held(&sdev->inquiry_mutex));
0488     vpd_pg80 = rcu_replace_pointer(sdev->vpd_pg80, vpd_pg80,
0489                        lockdep_is_held(&sdev->inquiry_mutex));
0490     vpd_pg83 = rcu_replace_pointer(sdev->vpd_pg83, vpd_pg83,
0491                        lockdep_is_held(&sdev->inquiry_mutex));
0492     vpd_pg89 = rcu_replace_pointer(sdev->vpd_pg89, vpd_pg89,
0493                        lockdep_is_held(&sdev->inquiry_mutex));
0494     vpd_pgb0 = rcu_replace_pointer(sdev->vpd_pgb0, vpd_pgb0,
0495                        lockdep_is_held(&sdev->inquiry_mutex));
0496     vpd_pgb1 = rcu_replace_pointer(sdev->vpd_pgb1, vpd_pgb1,
0497                        lockdep_is_held(&sdev->inquiry_mutex));
0498     vpd_pgb2 = rcu_replace_pointer(sdev->vpd_pgb2, vpd_pgb2,
0499                        lockdep_is_held(&sdev->inquiry_mutex));
0500     mutex_unlock(&sdev->inquiry_mutex);
0501 
0502     if (vpd_pg0)
0503         kfree_rcu(vpd_pg0, rcu);
0504     if (vpd_pg83)
0505         kfree_rcu(vpd_pg83, rcu);
0506     if (vpd_pg80)
0507         kfree_rcu(vpd_pg80, rcu);
0508     if (vpd_pg89)
0509         kfree_rcu(vpd_pg89, rcu);
0510     if (vpd_pgb0)
0511         kfree_rcu(vpd_pgb0, rcu);
0512     if (vpd_pgb1)
0513         kfree_rcu(vpd_pgb1, rcu);
0514     if (vpd_pgb2)
0515         kfree_rcu(vpd_pgb2, rcu);
0516     kfree(sdev->inquiry);
0517     kfree(sdev);
0518 
0519     if (parent)
0520         put_device(parent);
0521     module_put(mod);
0522 }
0523 
0524 static void scsi_device_dev_release(struct device *dev)
0525 {
0526     struct scsi_device *sdp = to_scsi_device(dev);
0527 
0528     /* Set module pointer as NULL in case of module unloading */
0529     if (!try_module_get(sdp->host->hostt->module))
0530         sdp->host->hostt->module = NULL;
0531 
0532     execute_in_process_context(scsi_device_dev_release_usercontext,
0533                    &sdp->ew);
0534 }
0535 
0536 static struct class sdev_class = {
0537     .name       = "scsi_device",
0538     .dev_release    = scsi_device_cls_release,
0539 };
0540 
0541 /* all probing is done in the individual ->probe routines */
0542 static int scsi_bus_match(struct device *dev, struct device_driver *gendrv)
0543 {
0544     struct scsi_device *sdp;
0545 
0546     if (dev->type != &scsi_dev_type)
0547         return 0;
0548 
0549     sdp = to_scsi_device(dev);
0550     if (sdp->no_uld_attach)
0551         return 0;
0552     return (sdp->inq_periph_qual == SCSI_INQ_PQ_CON)? 1: 0;
0553 }
0554 
0555 static int scsi_bus_uevent(struct device *dev, struct kobj_uevent_env *env)
0556 {
0557     struct scsi_device *sdev;
0558 
0559     if (dev->type != &scsi_dev_type)
0560         return 0;
0561 
0562     sdev = to_scsi_device(dev);
0563 
0564     add_uevent_var(env, "MODALIAS=" SCSI_DEVICE_MODALIAS_FMT, sdev->type);
0565     return 0;
0566 }
0567 
0568 struct bus_type scsi_bus_type = {
0569         .name       = "scsi",
0570         .match      = scsi_bus_match,
0571     .uevent     = scsi_bus_uevent,
0572 #ifdef CONFIG_PM
0573     .pm     = &scsi_bus_pm_ops,
0574 #endif
0575 };
0576 
0577 int scsi_sysfs_register(void)
0578 {
0579     int error;
0580 
0581     error = bus_register(&scsi_bus_type);
0582     if (!error) {
0583         error = class_register(&sdev_class);
0584         if (error)
0585             bus_unregister(&scsi_bus_type);
0586     }
0587 
0588     return error;
0589 }
0590 
0591 void scsi_sysfs_unregister(void)
0592 {
0593     class_unregister(&sdev_class);
0594     bus_unregister(&scsi_bus_type);
0595 }
0596 
0597 /*
0598  * sdev_show_function: macro to create an attr function that can be used to
0599  * show a non-bit field.
0600  */
0601 #define sdev_show_function(field, format_string)                \
0602 static ssize_t                              \
0603 sdev_show_##field (struct device *dev, struct device_attribute *attr,   \
0604            char *buf)                       \
0605 {                                   \
0606     struct scsi_device *sdev;                   \
0607     sdev = to_scsi_device(dev);                 \
0608     return snprintf (buf, 20, format_string, sdev->field);      \
0609 }                                   \
0610 
0611 /*
0612  * sdev_rd_attr: macro to create a function and attribute variable for a
0613  * read only field.
0614  */
0615 #define sdev_rd_attr(field, format_string)              \
0616     sdev_show_function(field, format_string)            \
0617 static DEVICE_ATTR(field, S_IRUGO, sdev_show_##field, NULL);
0618 
0619 
0620 /*
0621  * sdev_rw_attr: create a function and attribute variable for a
0622  * read/write field.
0623  */
0624 #define sdev_rw_attr(field, format_string)              \
0625     sdev_show_function(field, format_string)                \
0626                                     \
0627 static ssize_t                              \
0628 sdev_store_##field (struct device *dev, struct device_attribute *attr,  \
0629             const char *buf, size_t count)          \
0630 {                                   \
0631     struct scsi_device *sdev;                   \
0632     sdev = to_scsi_device(dev);                 \
0633     sscanf (buf, format_string, &sdev->field);          \
0634     return count;                           \
0635 }                                   \
0636 static DEVICE_ATTR(field, S_IRUGO | S_IWUSR, sdev_show_##field, sdev_store_##field);
0637 
0638 /* Currently we don't export bit fields, but we might in future,
0639  * so leave this code in */
0640 #if 0
0641 /*
0642  * sdev_rd_attr: create a function and attribute variable for a
0643  * read/write bit field.
0644  */
0645 #define sdev_rw_attr_bit(field)                     \
0646     sdev_show_function(field, "%d\n")                   \
0647                                     \
0648 static ssize_t                              \
0649 sdev_store_##field (struct device *dev, struct device_attribute *attr,  \
0650             const char *buf, size_t count)          \
0651 {                                   \
0652     int ret;                            \
0653     struct scsi_device *sdev;                   \
0654     ret = scsi_sdev_check_buf_bit(buf);             \
0655     if (ret >= 0)   {                       \
0656         sdev = to_scsi_device(dev);             \
0657         sdev->field = ret;                  \
0658         ret = count;                        \
0659     }                               \
0660     return ret;                         \
0661 }                                   \
0662 static DEVICE_ATTR(field, S_IRUGO | S_IWUSR, sdev_show_##field, sdev_store_##field);
0663 
0664 /*
0665  * scsi_sdev_check_buf_bit: return 0 if buf is "0", return 1 if buf is "1",
0666  * else return -EINVAL.
0667  */
0668 static int scsi_sdev_check_buf_bit(const char *buf)
0669 {
0670     if ((buf[1] == '\0') || ((buf[1] == '\n') && (buf[2] == '\0'))) {
0671         if (buf[0] == '1')
0672             return 1;
0673         else if (buf[0] == '0')
0674             return 0;
0675         else 
0676             return -EINVAL;
0677     } else
0678         return -EINVAL;
0679 }
0680 #endif
0681 /*
0682  * Create the actual show/store functions and data structures.
0683  */
0684 sdev_rd_attr (type, "%d\n");
0685 sdev_rd_attr (scsi_level, "%d\n");
0686 sdev_rd_attr (vendor, "%.8s\n");
0687 sdev_rd_attr (model, "%.16s\n");
0688 sdev_rd_attr (rev, "%.4s\n");
0689 
0690 static ssize_t
0691 sdev_show_device_busy(struct device *dev, struct device_attribute *attr,
0692         char *buf)
0693 {
0694     struct scsi_device *sdev = to_scsi_device(dev);
0695     return snprintf(buf, 20, "%d\n", scsi_device_busy(sdev));
0696 }
0697 static DEVICE_ATTR(device_busy, S_IRUGO, sdev_show_device_busy, NULL);
0698 
0699 static ssize_t
0700 sdev_show_device_blocked(struct device *dev, struct device_attribute *attr,
0701         char *buf)
0702 {
0703     struct scsi_device *sdev = to_scsi_device(dev);
0704     return snprintf(buf, 20, "%d\n", atomic_read(&sdev->device_blocked));
0705 }
0706 static DEVICE_ATTR(device_blocked, S_IRUGO, sdev_show_device_blocked, NULL);
0707 
0708 /*
0709  * TODO: can we make these symlinks to the block layer ones?
0710  */
0711 static ssize_t
0712 sdev_show_timeout (struct device *dev, struct device_attribute *attr, char *buf)
0713 {
0714     struct scsi_device *sdev;
0715     sdev = to_scsi_device(dev);
0716     return snprintf(buf, 20, "%d\n", sdev->request_queue->rq_timeout / HZ);
0717 }
0718 
0719 static ssize_t
0720 sdev_store_timeout (struct device *dev, struct device_attribute *attr,
0721             const char *buf, size_t count)
0722 {
0723     struct scsi_device *sdev;
0724     int timeout;
0725     sdev = to_scsi_device(dev);
0726     sscanf (buf, "%d\n", &timeout);
0727     blk_queue_rq_timeout(sdev->request_queue, timeout * HZ);
0728     return count;
0729 }
0730 static DEVICE_ATTR(timeout, S_IRUGO | S_IWUSR, sdev_show_timeout, sdev_store_timeout);
0731 
0732 static ssize_t
0733 sdev_show_eh_timeout(struct device *dev, struct device_attribute *attr, char *buf)
0734 {
0735     struct scsi_device *sdev;
0736     sdev = to_scsi_device(dev);
0737     return snprintf(buf, 20, "%u\n", sdev->eh_timeout / HZ);
0738 }
0739 
0740 static ssize_t
0741 sdev_store_eh_timeout(struct device *dev, struct device_attribute *attr,
0742             const char *buf, size_t count)
0743 {
0744     struct scsi_device *sdev;
0745     unsigned int eh_timeout;
0746     int err;
0747 
0748     if (!capable(CAP_SYS_ADMIN))
0749         return -EACCES;
0750 
0751     sdev = to_scsi_device(dev);
0752     err = kstrtouint(buf, 10, &eh_timeout);
0753     if (err)
0754         return err;
0755     sdev->eh_timeout = eh_timeout * HZ;
0756 
0757     return count;
0758 }
0759 static DEVICE_ATTR(eh_timeout, S_IRUGO | S_IWUSR, sdev_show_eh_timeout, sdev_store_eh_timeout);
0760 
0761 static ssize_t
0762 store_rescan_field (struct device *dev, struct device_attribute *attr,
0763             const char *buf, size_t count)
0764 {
0765     scsi_rescan_device(dev);
0766     return count;
0767 }
0768 static DEVICE_ATTR(rescan, S_IWUSR, NULL, store_rescan_field);
0769 
0770 static ssize_t
0771 sdev_store_delete(struct device *dev, struct device_attribute *attr,
0772           const char *buf, size_t count)
0773 {
0774     struct kernfs_node *kn;
0775     struct scsi_device *sdev = to_scsi_device(dev);
0776 
0777     /*
0778      * We need to try to get module, avoiding the module been removed
0779      * during delete.
0780      */
0781     if (scsi_device_get(sdev))
0782         return -ENODEV;
0783 
0784     kn = sysfs_break_active_protection(&dev->kobj, &attr->attr);
0785     WARN_ON_ONCE(!kn);
0786     /*
0787      * Concurrent writes into the "delete" sysfs attribute may trigger
0788      * concurrent calls to device_remove_file() and scsi_remove_device().
0789      * device_remove_file() handles concurrent removal calls by
0790      * serializing these and by ignoring the second and later removal
0791      * attempts.  Concurrent calls of scsi_remove_device() are
0792      * serialized. The second and later calls of scsi_remove_device() are
0793      * ignored because the first call of that function changes the device
0794      * state into SDEV_DEL.
0795      */
0796     device_remove_file(dev, attr);
0797     scsi_remove_device(sdev);
0798     if (kn)
0799         sysfs_unbreak_active_protection(kn);
0800     scsi_device_put(sdev);
0801     return count;
0802 };
0803 static DEVICE_ATTR(delete, S_IWUSR, NULL, sdev_store_delete);
0804 
0805 static ssize_t
0806 store_state_field(struct device *dev, struct device_attribute *attr,
0807           const char *buf, size_t count)
0808 {
0809     int i, ret;
0810     struct scsi_device *sdev = to_scsi_device(dev);
0811     enum scsi_device_state state = 0;
0812     bool rescan_dev = false;
0813 
0814     for (i = 0; i < ARRAY_SIZE(sdev_states); i++) {
0815         const int len = strlen(sdev_states[i].name);
0816         if (strncmp(sdev_states[i].name, buf, len) == 0 &&
0817            buf[len] == '\n') {
0818             state = sdev_states[i].value;
0819             break;
0820         }
0821     }
0822     switch (state) {
0823     case SDEV_RUNNING:
0824     case SDEV_OFFLINE:
0825         break;
0826     default:
0827         return -EINVAL;
0828     }
0829 
0830     mutex_lock(&sdev->state_mutex);
0831     if (sdev->sdev_state == SDEV_RUNNING && state == SDEV_RUNNING) {
0832         ret = 0;
0833     } else {
0834         ret = scsi_device_set_state(sdev, state);
0835         if (ret == 0 && state == SDEV_RUNNING)
0836             rescan_dev = true;
0837     }
0838     mutex_unlock(&sdev->state_mutex);
0839 
0840     if (rescan_dev) {
0841         /*
0842          * If the device state changes to SDEV_RUNNING, we need to
0843          * run the queue to avoid I/O hang, and rescan the device
0844          * to revalidate it. Running the queue first is necessary
0845          * because another thread may be waiting inside
0846          * blk_mq_freeze_queue_wait() and because that call may be
0847          * waiting for pending I/O to finish.
0848          */
0849         blk_mq_run_hw_queues(sdev->request_queue, true);
0850         scsi_rescan_device(dev);
0851     }
0852 
0853     return ret == 0 ? count : -EINVAL;
0854 }
0855 
0856 static ssize_t
0857 show_state_field(struct device *dev, struct device_attribute *attr, char *buf)
0858 {
0859     struct scsi_device *sdev = to_scsi_device(dev);
0860     const char *name = scsi_device_state_name(sdev->sdev_state);
0861 
0862     if (!name)
0863         return -EINVAL;
0864 
0865     return snprintf(buf, 20, "%s\n", name);
0866 }
0867 
0868 static DEVICE_ATTR(state, S_IRUGO | S_IWUSR, show_state_field, store_state_field);
0869 
0870 static ssize_t
0871 show_queue_type_field(struct device *dev, struct device_attribute *attr,
0872               char *buf)
0873 {
0874     struct scsi_device *sdev = to_scsi_device(dev);
0875     const char *name = "none";
0876 
0877     if (sdev->simple_tags)
0878         name = "simple";
0879 
0880     return snprintf(buf, 20, "%s\n", name);
0881 }
0882 
0883 static ssize_t
0884 store_queue_type_field(struct device *dev, struct device_attribute *attr,
0885                const char *buf, size_t count)
0886 {
0887     struct scsi_device *sdev = to_scsi_device(dev);
0888 
0889     if (!sdev->tagged_supported)
0890         return -EINVAL;
0891         
0892     sdev_printk(KERN_INFO, sdev,
0893             "ignoring write to deprecated queue_type attribute");
0894     return count;
0895 }
0896 
0897 static DEVICE_ATTR(queue_type, S_IRUGO | S_IWUSR, show_queue_type_field,
0898            store_queue_type_field);
0899 
0900 #define sdev_vpd_pg_attr(_page)                     \
0901 static ssize_t                          \
0902 show_vpd_##_page(struct file *filp, struct kobject *kobj,   \
0903          struct bin_attribute *bin_attr,            \
0904          char *buf, loff_t off, size_t count)           \
0905 {                                   \
0906     struct device *dev = kobj_to_dev(kobj);             \
0907     struct scsi_device *sdev = to_scsi_device(dev);         \
0908     struct scsi_vpd *vpd_page;                  \
0909     int ret = -EINVAL;                      \
0910                                     \
0911     rcu_read_lock();                        \
0912     vpd_page = rcu_dereference(sdev->vpd_##_page);          \
0913     if (vpd_page)                           \
0914         ret = memory_read_from_buffer(buf, count, &off,     \
0915                 vpd_page->data, vpd_page->len);     \
0916     rcu_read_unlock();                      \
0917     return ret;                         \
0918 }                                   \
0919 static struct bin_attribute dev_attr_vpd_##_page = {        \
0920     .attr = {.name = __stringify(vpd_##_page), .mode = S_IRUGO },   \
0921     .size = 0,                          \
0922     .read = show_vpd_##_page,                   \
0923 };
0924 
0925 sdev_vpd_pg_attr(pg83);
0926 sdev_vpd_pg_attr(pg80);
0927 sdev_vpd_pg_attr(pg89);
0928 sdev_vpd_pg_attr(pgb0);
0929 sdev_vpd_pg_attr(pgb1);
0930 sdev_vpd_pg_attr(pgb2);
0931 sdev_vpd_pg_attr(pg0);
0932 
0933 static ssize_t show_inquiry(struct file *filep, struct kobject *kobj,
0934                 struct bin_attribute *bin_attr,
0935                 char *buf, loff_t off, size_t count)
0936 {
0937     struct device *dev = kobj_to_dev(kobj);
0938     struct scsi_device *sdev = to_scsi_device(dev);
0939 
0940     if (!sdev->inquiry)
0941         return -EINVAL;
0942 
0943     return memory_read_from_buffer(buf, count, &off, sdev->inquiry,
0944                        sdev->inquiry_len);
0945 }
0946 
0947 static struct bin_attribute dev_attr_inquiry = {
0948     .attr = {
0949         .name = "inquiry",
0950         .mode = S_IRUGO,
0951     },
0952     .size = 0,
0953     .read = show_inquiry,
0954 };
0955 
0956 static ssize_t
0957 show_iostat_counterbits(struct device *dev, struct device_attribute *attr,
0958             char *buf)
0959 {
0960     return snprintf(buf, 20, "%d\n", (int)sizeof(atomic_t) * 8);
0961 }
0962 
0963 static DEVICE_ATTR(iocounterbits, S_IRUGO, show_iostat_counterbits, NULL);
0964 
0965 #define show_sdev_iostat(field)                     \
0966 static ssize_t                              \
0967 show_iostat_##field(struct device *dev, struct device_attribute *attr,  \
0968             char *buf)                      \
0969 {                                   \
0970     struct scsi_device *sdev = to_scsi_device(dev);         \
0971     unsigned long long count = atomic_read(&sdev->field);       \
0972     return snprintf(buf, 20, "0x%llx\n", count);            \
0973 }                                   \
0974 static DEVICE_ATTR(field, S_IRUGO, show_iostat_##field, NULL)
0975 
0976 show_sdev_iostat(iorequest_cnt);
0977 show_sdev_iostat(iodone_cnt);
0978 show_sdev_iostat(ioerr_cnt);
0979 
0980 static ssize_t
0981 sdev_show_modalias(struct device *dev, struct device_attribute *attr, char *buf)
0982 {
0983     struct scsi_device *sdev;
0984     sdev = to_scsi_device(dev);
0985     return snprintf (buf, 20, SCSI_DEVICE_MODALIAS_FMT "\n", sdev->type);
0986 }
0987 static DEVICE_ATTR(modalias, S_IRUGO, sdev_show_modalias, NULL);
0988 
0989 #define DECLARE_EVT_SHOW(name, Cap_name)                \
0990 static ssize_t                              \
0991 sdev_show_evt_##name(struct device *dev, struct device_attribute *attr, \
0992              char *buf)                     \
0993 {                                   \
0994     struct scsi_device *sdev = to_scsi_device(dev);         \
0995     int val = test_bit(SDEV_EVT_##Cap_name, sdev->supported_events);\
0996     return snprintf(buf, 20, "%d\n", val);              \
0997 }
0998 
0999 #define DECLARE_EVT_STORE(name, Cap_name)               \
1000 static ssize_t                              \
1001 sdev_store_evt_##name(struct device *dev, struct device_attribute *attr,\
1002               const char *buf, size_t count)            \
1003 {                                   \
1004     struct scsi_device *sdev = to_scsi_device(dev);         \
1005     int val = simple_strtoul(buf, NULL, 0);             \
1006     if (val == 0)                           \
1007         clear_bit(SDEV_EVT_##Cap_name, sdev->supported_events); \
1008     else if (val == 1)                      \
1009         set_bit(SDEV_EVT_##Cap_name, sdev->supported_events);   \
1010     else                                \
1011         return -EINVAL;                     \
1012     return count;                           \
1013 }
1014 
1015 #define DECLARE_EVT(name, Cap_name)                 \
1016     DECLARE_EVT_SHOW(name, Cap_name)                \
1017     DECLARE_EVT_STORE(name, Cap_name)               \
1018     static DEVICE_ATTR(evt_##name, S_IRUGO, sdev_show_evt_##name,   \
1019                sdev_store_evt_##name);
1020 #define REF_EVT(name) &dev_attr_evt_##name.attr
1021 
1022 DECLARE_EVT(media_change, MEDIA_CHANGE)
1023 DECLARE_EVT(inquiry_change_reported, INQUIRY_CHANGE_REPORTED)
1024 DECLARE_EVT(capacity_change_reported, CAPACITY_CHANGE_REPORTED)
1025 DECLARE_EVT(soft_threshold_reached, SOFT_THRESHOLD_REACHED_REPORTED)
1026 DECLARE_EVT(mode_parameter_change_reported, MODE_PARAMETER_CHANGE_REPORTED)
1027 DECLARE_EVT(lun_change_reported, LUN_CHANGE_REPORTED)
1028 
1029 static ssize_t
1030 sdev_store_queue_depth(struct device *dev, struct device_attribute *attr,
1031                const char *buf, size_t count)
1032 {
1033     int depth, retval;
1034     struct scsi_device *sdev = to_scsi_device(dev);
1035     struct scsi_host_template *sht = sdev->host->hostt;
1036 
1037     if (!sht->change_queue_depth)
1038         return -EINVAL;
1039 
1040     depth = simple_strtoul(buf, NULL, 0);
1041 
1042     if (depth < 1 || depth > sdev->host->can_queue)
1043         return -EINVAL;
1044 
1045     retval = sht->change_queue_depth(sdev, depth);
1046     if (retval < 0)
1047         return retval;
1048 
1049     sdev->max_queue_depth = sdev->queue_depth;
1050 
1051     return count;
1052 }
1053 sdev_show_function(queue_depth, "%d\n");
1054 
1055 static DEVICE_ATTR(queue_depth, S_IRUGO | S_IWUSR, sdev_show_queue_depth,
1056            sdev_store_queue_depth);
1057 
1058 static ssize_t
1059 sdev_show_wwid(struct device *dev, struct device_attribute *attr,
1060             char *buf)
1061 {
1062     struct scsi_device *sdev = to_scsi_device(dev);
1063     ssize_t count;
1064 
1065     count = scsi_vpd_lun_id(sdev, buf, PAGE_SIZE);
1066     if (count > 0) {
1067         buf[count] = '\n';
1068         count++;
1069     }
1070     return count;
1071 }
1072 static DEVICE_ATTR(wwid, S_IRUGO, sdev_show_wwid, NULL);
1073 
1074 #define BLIST_FLAG_NAME(name)                   \
1075     [const_ilog2((__force __u64)BLIST_##name)] = #name
1076 static const char *const sdev_bflags_name[] = {
1077 #include "scsi_devinfo_tbl.c"
1078 };
1079 #undef BLIST_FLAG_NAME
1080 
1081 static ssize_t
1082 sdev_show_blacklist(struct device *dev, struct device_attribute *attr,
1083             char *buf)
1084 {
1085     struct scsi_device *sdev = to_scsi_device(dev);
1086     int i;
1087     ssize_t len = 0;
1088 
1089     for (i = 0; i < sizeof(sdev->sdev_bflags) * BITS_PER_BYTE; i++) {
1090         const char *name = NULL;
1091 
1092         if (!(sdev->sdev_bflags & (__force blist_flags_t)BIT(i)))
1093             continue;
1094         if (i < ARRAY_SIZE(sdev_bflags_name) && sdev_bflags_name[i])
1095             name = sdev_bflags_name[i];
1096 
1097         if (name)
1098             len += scnprintf(buf + len, PAGE_SIZE - len,
1099                      "%s%s", len ? " " : "", name);
1100         else
1101             len += scnprintf(buf + len, PAGE_SIZE - len,
1102                      "%sINVALID_BIT(%d)", len ? " " : "", i);
1103     }
1104     if (len)
1105         len += scnprintf(buf + len, PAGE_SIZE - len, "\n");
1106     return len;
1107 }
1108 static DEVICE_ATTR(blacklist, S_IRUGO, sdev_show_blacklist, NULL);
1109 
1110 #ifdef CONFIG_SCSI_DH
1111 static ssize_t
1112 sdev_show_dh_state(struct device *dev, struct device_attribute *attr,
1113            char *buf)
1114 {
1115     struct scsi_device *sdev = to_scsi_device(dev);
1116 
1117     if (!sdev->handler)
1118         return snprintf(buf, 20, "detached\n");
1119 
1120     return snprintf(buf, 20, "%s\n", sdev->handler->name);
1121 }
1122 
1123 static ssize_t
1124 sdev_store_dh_state(struct device *dev, struct device_attribute *attr,
1125             const char *buf, size_t count)
1126 {
1127     struct scsi_device *sdev = to_scsi_device(dev);
1128     int err = -EINVAL;
1129 
1130     if (sdev->sdev_state == SDEV_CANCEL ||
1131         sdev->sdev_state == SDEV_DEL)
1132         return -ENODEV;
1133 
1134     if (!sdev->handler) {
1135         /*
1136          * Attach to a device handler
1137          */
1138         err = scsi_dh_attach(sdev->request_queue, buf);
1139     } else if (!strncmp(buf, "activate", 8)) {
1140         /*
1141          * Activate a device handler
1142          */
1143         if (sdev->handler->activate)
1144             err = sdev->handler->activate(sdev, NULL, NULL);
1145         else
1146             err = 0;
1147     } else if (!strncmp(buf, "detach", 6)) {
1148         /*
1149          * Detach from a device handler
1150          */
1151         sdev_printk(KERN_WARNING, sdev,
1152                 "can't detach handler %s.\n",
1153                 sdev->handler->name);
1154         err = -EINVAL;
1155     }
1156 
1157     return err < 0 ? err : count;
1158 }
1159 
1160 static DEVICE_ATTR(dh_state, S_IRUGO | S_IWUSR, sdev_show_dh_state,
1161            sdev_store_dh_state);
1162 
1163 static ssize_t
1164 sdev_show_access_state(struct device *dev,
1165                struct device_attribute *attr,
1166                char *buf)
1167 {
1168     struct scsi_device *sdev = to_scsi_device(dev);
1169     unsigned char access_state;
1170     const char *access_state_name;
1171 
1172     if (!sdev->handler)
1173         return -EINVAL;
1174 
1175     access_state = (sdev->access_state & SCSI_ACCESS_STATE_MASK);
1176     access_state_name = scsi_access_state_name(access_state);
1177 
1178     return sprintf(buf, "%s\n",
1179                access_state_name ? access_state_name : "unknown");
1180 }
1181 static DEVICE_ATTR(access_state, S_IRUGO, sdev_show_access_state, NULL);
1182 
1183 static ssize_t
1184 sdev_show_preferred_path(struct device *dev,
1185              struct device_attribute *attr,
1186              char *buf)
1187 {
1188     struct scsi_device *sdev = to_scsi_device(dev);
1189 
1190     if (!sdev->handler)
1191         return -EINVAL;
1192 
1193     if (sdev->access_state & SCSI_ACCESS_STATE_PREFERRED)
1194         return sprintf(buf, "1\n");
1195     else
1196         return sprintf(buf, "0\n");
1197 }
1198 static DEVICE_ATTR(preferred_path, S_IRUGO, sdev_show_preferred_path, NULL);
1199 #endif
1200 
1201 static ssize_t
1202 sdev_show_queue_ramp_up_period(struct device *dev,
1203                    struct device_attribute *attr,
1204                    char *buf)
1205 {
1206     struct scsi_device *sdev;
1207     sdev = to_scsi_device(dev);
1208     return snprintf(buf, 20, "%u\n",
1209             jiffies_to_msecs(sdev->queue_ramp_up_period));
1210 }
1211 
1212 static ssize_t
1213 sdev_store_queue_ramp_up_period(struct device *dev,
1214                 struct device_attribute *attr,
1215                 const char *buf, size_t count)
1216 {
1217     struct scsi_device *sdev = to_scsi_device(dev);
1218     unsigned int period;
1219 
1220     if (kstrtouint(buf, 10, &period))
1221         return -EINVAL;
1222 
1223     sdev->queue_ramp_up_period = msecs_to_jiffies(period);
1224     return count;
1225 }
1226 
1227 static DEVICE_ATTR(queue_ramp_up_period, S_IRUGO | S_IWUSR,
1228            sdev_show_queue_ramp_up_period,
1229            sdev_store_queue_ramp_up_period);
1230 
1231 static umode_t scsi_sdev_attr_is_visible(struct kobject *kobj,
1232                      struct attribute *attr, int i)
1233 {
1234     struct device *dev = kobj_to_dev(kobj);
1235     struct scsi_device *sdev = to_scsi_device(dev);
1236 
1237 
1238     if (attr == &dev_attr_queue_depth.attr &&
1239         !sdev->host->hostt->change_queue_depth)
1240         return S_IRUGO;
1241 
1242     if (attr == &dev_attr_queue_ramp_up_period.attr &&
1243         !sdev->host->hostt->change_queue_depth)
1244         return 0;
1245 
1246     return attr->mode;
1247 }
1248 
1249 static umode_t scsi_sdev_bin_attr_is_visible(struct kobject *kobj,
1250                          struct bin_attribute *attr, int i)
1251 {
1252     struct device *dev = kobj_to_dev(kobj);
1253     struct scsi_device *sdev = to_scsi_device(dev);
1254 
1255 
1256     if (attr == &dev_attr_vpd_pg0 && !sdev->vpd_pg0)
1257         return 0;
1258 
1259     if (attr == &dev_attr_vpd_pg80 && !sdev->vpd_pg80)
1260         return 0;
1261 
1262     if (attr == &dev_attr_vpd_pg83 && !sdev->vpd_pg83)
1263         return 0;
1264 
1265     if (attr == &dev_attr_vpd_pg89 && !sdev->vpd_pg89)
1266         return 0;
1267 
1268     if (attr == &dev_attr_vpd_pgb0 && !sdev->vpd_pgb0)
1269         return 0;
1270 
1271     if (attr == &dev_attr_vpd_pgb1 && !sdev->vpd_pgb1)
1272         return 0;
1273 
1274     if (attr == &dev_attr_vpd_pgb2 && !sdev->vpd_pgb2)
1275         return 0;
1276 
1277     return S_IRUGO;
1278 }
1279 
1280 /* Default template for device attributes.  May NOT be modified */
1281 static struct attribute *scsi_sdev_attrs[] = {
1282     &dev_attr_device_blocked.attr,
1283     &dev_attr_type.attr,
1284     &dev_attr_scsi_level.attr,
1285     &dev_attr_device_busy.attr,
1286     &dev_attr_vendor.attr,
1287     &dev_attr_model.attr,
1288     &dev_attr_rev.attr,
1289     &dev_attr_rescan.attr,
1290     &dev_attr_delete.attr,
1291     &dev_attr_state.attr,
1292     &dev_attr_timeout.attr,
1293     &dev_attr_eh_timeout.attr,
1294     &dev_attr_iocounterbits.attr,
1295     &dev_attr_iorequest_cnt.attr,
1296     &dev_attr_iodone_cnt.attr,
1297     &dev_attr_ioerr_cnt.attr,
1298     &dev_attr_modalias.attr,
1299     &dev_attr_queue_depth.attr,
1300     &dev_attr_queue_type.attr,
1301     &dev_attr_wwid.attr,
1302     &dev_attr_blacklist.attr,
1303 #ifdef CONFIG_SCSI_DH
1304     &dev_attr_dh_state.attr,
1305     &dev_attr_access_state.attr,
1306     &dev_attr_preferred_path.attr,
1307 #endif
1308     &dev_attr_queue_ramp_up_period.attr,
1309     REF_EVT(media_change),
1310     REF_EVT(inquiry_change_reported),
1311     REF_EVT(capacity_change_reported),
1312     REF_EVT(soft_threshold_reached),
1313     REF_EVT(mode_parameter_change_reported),
1314     REF_EVT(lun_change_reported),
1315     NULL
1316 };
1317 
1318 static struct bin_attribute *scsi_sdev_bin_attrs[] = {
1319     &dev_attr_vpd_pg0,
1320     &dev_attr_vpd_pg83,
1321     &dev_attr_vpd_pg80,
1322     &dev_attr_vpd_pg89,
1323     &dev_attr_vpd_pgb0,
1324     &dev_attr_vpd_pgb1,
1325     &dev_attr_vpd_pgb2,
1326     &dev_attr_inquiry,
1327     NULL
1328 };
1329 static struct attribute_group scsi_sdev_attr_group = {
1330     .attrs =    scsi_sdev_attrs,
1331     .bin_attrs =    scsi_sdev_bin_attrs,
1332     .is_visible =   scsi_sdev_attr_is_visible,
1333     .is_bin_visible = scsi_sdev_bin_attr_is_visible,
1334 };
1335 
1336 static const struct attribute_group *scsi_sdev_attr_groups[] = {
1337     &scsi_sdev_attr_group,
1338     NULL
1339 };
1340 
1341 static int scsi_target_add(struct scsi_target *starget)
1342 {
1343     int error;
1344 
1345     if (starget->state != STARGET_CREATED)
1346         return 0;
1347 
1348     error = device_add(&starget->dev);
1349     if (error) {
1350         dev_err(&starget->dev, "target device_add failed, error %d\n", error);
1351         return error;
1352     }
1353     transport_add_device(&starget->dev);
1354     starget->state = STARGET_RUNNING;
1355 
1356     pm_runtime_set_active(&starget->dev);
1357     pm_runtime_enable(&starget->dev);
1358     device_enable_async_suspend(&starget->dev);
1359 
1360     return 0;
1361 }
1362 
1363 /**
1364  * scsi_sysfs_add_sdev - add scsi device to sysfs
1365  * @sdev:   scsi_device to add
1366  *
1367  * Return value:
1368  *  0 on Success / non-zero on Failure
1369  **/
1370 int scsi_sysfs_add_sdev(struct scsi_device *sdev)
1371 {
1372     int error;
1373     struct scsi_target *starget = sdev->sdev_target;
1374 
1375     error = scsi_target_add(starget);
1376     if (error)
1377         return error;
1378 
1379     transport_configure_device(&starget->dev);
1380 
1381     device_enable_async_suspend(&sdev->sdev_gendev);
1382     scsi_autopm_get_target(starget);
1383     pm_runtime_set_active(&sdev->sdev_gendev);
1384     if (!sdev->rpm_autosuspend)
1385         pm_runtime_forbid(&sdev->sdev_gendev);
1386     pm_runtime_enable(&sdev->sdev_gendev);
1387     scsi_autopm_put_target(starget);
1388 
1389     scsi_autopm_get_device(sdev);
1390 
1391     scsi_dh_add_device(sdev);
1392 
1393     error = device_add(&sdev->sdev_gendev);
1394     if (error) {
1395         sdev_printk(KERN_INFO, sdev,
1396                 "failed to add device: %d\n", error);
1397         return error;
1398     }
1399 
1400     device_enable_async_suspend(&sdev->sdev_dev);
1401     error = device_add(&sdev->sdev_dev);
1402     if (error) {
1403         sdev_printk(KERN_INFO, sdev,
1404                 "failed to add class device: %d\n", error);
1405         device_del(&sdev->sdev_gendev);
1406         return error;
1407     }
1408     transport_add_device(&sdev->sdev_gendev);
1409     sdev->is_visible = 1;
1410 
1411     if (IS_ENABLED(CONFIG_BLK_DEV_BSG)) {
1412         sdev->bsg_dev = scsi_bsg_register_queue(sdev);
1413         if (IS_ERR(sdev->bsg_dev)) {
1414             error = PTR_ERR(sdev->bsg_dev);
1415             sdev_printk(KERN_INFO, sdev,
1416                     "Failed to register bsg queue, errno=%d\n",
1417                     error);
1418             sdev->bsg_dev = NULL;
1419         }
1420     }
1421 
1422     scsi_autopm_put_device(sdev);
1423     return error;
1424 }
1425 
1426 void __scsi_remove_device(struct scsi_device *sdev)
1427 {
1428     struct device *dev = &sdev->sdev_gendev;
1429     int res;
1430 
1431     /*
1432      * This cleanup path is not reentrant and while it is impossible
1433      * to get a new reference with scsi_device_get() someone can still
1434      * hold a previously acquired one.
1435      */
1436     if (sdev->sdev_state == SDEV_DEL)
1437         return;
1438 
1439     if (sdev->is_visible) {
1440         /*
1441          * If scsi_internal_target_block() is running concurrently,
1442          * wait until it has finished before changing the device state.
1443          */
1444         mutex_lock(&sdev->state_mutex);
1445         /*
1446          * If blocked, we go straight to DEL and restart the queue so
1447          * any commands issued during driver shutdown (like sync
1448          * cache) are errored immediately.
1449          */
1450         res = scsi_device_set_state(sdev, SDEV_CANCEL);
1451         if (res != 0) {
1452             res = scsi_device_set_state(sdev, SDEV_DEL);
1453             if (res == 0)
1454                 scsi_start_queue(sdev);
1455         }
1456         mutex_unlock(&sdev->state_mutex);
1457 
1458         if (res != 0)
1459             return;
1460 
1461         if (IS_ENABLED(CONFIG_BLK_DEV_BSG) && sdev->bsg_dev)
1462             bsg_unregister_queue(sdev->bsg_dev);
1463         device_unregister(&sdev->sdev_dev);
1464         transport_remove_device(dev);
1465         device_del(dev);
1466     } else
1467         put_device(&sdev->sdev_dev);
1468 
1469     /*
1470      * Stop accepting new requests and wait until all queuecommand() and
1471      * scsi_run_queue() invocations have finished before tearing down the
1472      * device.
1473      */
1474     mutex_lock(&sdev->state_mutex);
1475     scsi_device_set_state(sdev, SDEV_DEL);
1476     mutex_unlock(&sdev->state_mutex);
1477 
1478     blk_mq_destroy_queue(sdev->request_queue);
1479     kref_put(&sdev->host->tagset_refcnt, scsi_mq_free_tags);
1480     cancel_work_sync(&sdev->requeue_work);
1481 
1482     if (sdev->host->hostt->slave_destroy)
1483         sdev->host->hostt->slave_destroy(sdev);
1484     transport_destroy_device(dev);
1485 
1486     /*
1487      * Paired with the kref_get() in scsi_sysfs_initialize().  We have
1488      * removed sysfs visibility from the device, so make the target
1489      * invisible if this was the last device underneath it.
1490      */
1491     scsi_target_reap(scsi_target(sdev));
1492 
1493     put_device(dev);
1494 }
1495 
1496 /**
1497  * scsi_remove_device - unregister a device from the scsi bus
1498  * @sdev:   scsi_device to unregister
1499  **/
1500 void scsi_remove_device(struct scsi_device *sdev)
1501 {
1502     struct Scsi_Host *shost = sdev->host;
1503 
1504     mutex_lock(&shost->scan_mutex);
1505     __scsi_remove_device(sdev);
1506     mutex_unlock(&shost->scan_mutex);
1507 }
1508 EXPORT_SYMBOL(scsi_remove_device);
1509 
1510 static void __scsi_remove_target(struct scsi_target *starget)
1511 {
1512     struct Scsi_Host *shost = dev_to_shost(starget->dev.parent);
1513     unsigned long flags;
1514     struct scsi_device *sdev;
1515 
1516     spin_lock_irqsave(shost->host_lock, flags);
1517  restart:
1518     list_for_each_entry(sdev, &shost->__devices, siblings) {
1519         /*
1520          * We cannot call scsi_device_get() here, as
1521          * we might've been called from rmmod() causing
1522          * scsi_device_get() to fail the module_is_live()
1523          * check.
1524          */
1525         if (sdev->channel != starget->channel ||
1526             sdev->id != starget->id)
1527             continue;
1528         if (sdev->sdev_state == SDEV_DEL ||
1529             sdev->sdev_state == SDEV_CANCEL ||
1530             !get_device(&sdev->sdev_gendev))
1531             continue;
1532         spin_unlock_irqrestore(shost->host_lock, flags);
1533         scsi_remove_device(sdev);
1534         put_device(&sdev->sdev_gendev);
1535         spin_lock_irqsave(shost->host_lock, flags);
1536         goto restart;
1537     }
1538     spin_unlock_irqrestore(shost->host_lock, flags);
1539 }
1540 
1541 /**
1542  * scsi_remove_target - try to remove a target and all its devices
1543  * @dev: generic starget or parent of generic stargets to be removed
1544  *
1545  * Note: This is slightly racy.  It is possible that if the user
1546  * requests the addition of another device then the target won't be
1547  * removed.
1548  */
1549 void scsi_remove_target(struct device *dev)
1550 {
1551     struct Scsi_Host *shost = dev_to_shost(dev->parent);
1552     struct scsi_target *starget;
1553     unsigned long flags;
1554 
1555 restart:
1556     spin_lock_irqsave(shost->host_lock, flags);
1557     list_for_each_entry(starget, &shost->__targets, siblings) {
1558         if (starget->state == STARGET_DEL ||
1559             starget->state == STARGET_REMOVE ||
1560             starget->state == STARGET_CREATED_REMOVE)
1561             continue;
1562         if (starget->dev.parent == dev || &starget->dev == dev) {
1563             kref_get(&starget->reap_ref);
1564             if (starget->state == STARGET_CREATED)
1565                 starget->state = STARGET_CREATED_REMOVE;
1566             else
1567                 starget->state = STARGET_REMOVE;
1568             spin_unlock_irqrestore(shost->host_lock, flags);
1569             __scsi_remove_target(starget);
1570             scsi_target_reap(starget);
1571             goto restart;
1572         }
1573     }
1574     spin_unlock_irqrestore(shost->host_lock, flags);
1575 }
1576 EXPORT_SYMBOL(scsi_remove_target);
1577 
1578 int scsi_register_driver(struct device_driver *drv)
1579 {
1580     drv->bus = &scsi_bus_type;
1581 
1582     return driver_register(drv);
1583 }
1584 EXPORT_SYMBOL(scsi_register_driver);
1585 
1586 int scsi_register_interface(struct class_interface *intf)
1587 {
1588     intf->class = &sdev_class;
1589 
1590     return class_interface_register(intf);
1591 }
1592 EXPORT_SYMBOL(scsi_register_interface);
1593 
1594 /**
1595  * scsi_sysfs_add_host - add scsi host to subsystem
1596  * @shost:     scsi host struct to add to subsystem
1597  **/
1598 int scsi_sysfs_add_host(struct Scsi_Host *shost)
1599 {
1600     transport_register_device(&shost->shost_gendev);
1601     transport_configure_device(&shost->shost_gendev);
1602     return 0;
1603 }
1604 
1605 static struct device_type scsi_dev_type = {
1606     .name =     "scsi_device",
1607     .release =  scsi_device_dev_release,
1608     .groups =   scsi_sdev_attr_groups,
1609 };
1610 
1611 void scsi_sysfs_device_initialize(struct scsi_device *sdev)
1612 {
1613     unsigned long flags;
1614     struct Scsi_Host *shost = sdev->host;
1615     struct scsi_host_template *hostt = shost->hostt;
1616     struct scsi_target  *starget = sdev->sdev_target;
1617 
1618     device_initialize(&sdev->sdev_gendev);
1619     sdev->sdev_gendev.bus = &scsi_bus_type;
1620     sdev->sdev_gendev.type = &scsi_dev_type;
1621     scsi_enable_async_suspend(&sdev->sdev_gendev);
1622     dev_set_name(&sdev->sdev_gendev, "%d:%d:%d:%llu",
1623              sdev->host->host_no, sdev->channel, sdev->id, sdev->lun);
1624     sdev->sdev_gendev.groups = hostt->sdev_groups;
1625 
1626     device_initialize(&sdev->sdev_dev);
1627     sdev->sdev_dev.parent = get_device(&sdev->sdev_gendev);
1628     sdev->sdev_dev.class = &sdev_class;
1629     dev_set_name(&sdev->sdev_dev, "%d:%d:%d:%llu",
1630              sdev->host->host_no, sdev->channel, sdev->id, sdev->lun);
1631     /*
1632      * Get a default scsi_level from the target (derived from sibling
1633      * devices).  This is the best we can do for guessing how to set
1634      * sdev->lun_in_cdb for the initial INQUIRY command.  For LUN 0 the
1635      * setting doesn't matter, because all the bits are zero anyway.
1636      * But it does matter for higher LUNs.
1637      */
1638     sdev->scsi_level = starget->scsi_level;
1639     if (sdev->scsi_level <= SCSI_2 &&
1640             sdev->scsi_level != SCSI_UNKNOWN &&
1641             !shost->no_scsi2_lun_in_cdb)
1642         sdev->lun_in_cdb = 1;
1643 
1644     transport_setup_device(&sdev->sdev_gendev);
1645     spin_lock_irqsave(shost->host_lock, flags);
1646     list_add_tail(&sdev->same_target_siblings, &starget->devices);
1647     list_add_tail(&sdev->siblings, &shost->__devices);
1648     spin_unlock_irqrestore(shost->host_lock, flags);
1649     /*
1650      * device can now only be removed via __scsi_remove_device() so hold
1651      * the target.  Target will be held in CREATED state until something
1652      * beneath it becomes visible (in which case it moves to RUNNING)
1653      */
1654     kref_get(&starget->reap_ref);
1655 }
1656 
1657 int scsi_is_sdev_device(const struct device *dev)
1658 {
1659     return dev->type == &scsi_dev_type;
1660 }
1661 EXPORT_SYMBOL(scsi_is_sdev_device);
1662 
1663 /* A blank transport template that is used in drivers that don't
1664  * yet implement Transport Attributes */
1665 struct scsi_transport_template blank_transport_template = { { { {NULL, }, }, }, };
[ Source navigation ] [ Diff markup ] [ Identifier search ] [ general search ]

This page was automatically generated by the 2.1.0 LXR engine.

The LXR team
Valid CSS 2.1! Valid HTML 4.01!