1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*******************************************************************************
3 * Filename: target_core_configfs.c
5 * This file contains ConfigFS logic for the Generic Target Engine project.
7 * (c) Copyright 2008-2013 Datera, Inc.
9 * Nicholas A. Bellinger <nab@kernel.org>
11 * based on configfs Copyright (C) 2005 Oracle. All rights reserved.
13 ****************************************************************************/
15 #include <linux/kstrtox.h>
16 #include <linux/module.h>
17 #include <linux/moduleparam.h>
18 #include <generated/utsrelease.h>
19 #include <linux/utsname.h>
20 #include <linux/init.h>
22 #include <linux/namei.h>
23 #include <linux/slab.h>
24 #include <linux/types.h>
25 #include <linux/delay.h>
26 #include <linux/unistd.h>
27 #include <linux/string.h>
28 #include <linux/parser.h>
29 #include <linux/syscalls.h>
30 #include <linux/configfs.h>
31 #include <linux/spinlock.h>
33 #include <target/target_core_base.h>
34 #include <target/target_core_backend.h>
35 #include <target/target_core_fabric.h>
37 #include "target_core_internal.h"
38 #include "target_core_alua.h"
39 #include "target_core_pr.h"
40 #include "target_core_rd.h"
41 #include "target_core_xcopy.h"
43 #define TB_CIT_SETUP(_name, _item_ops, _group_ops, _attrs) \
44 static void target_core_setup_##_name##_cit(struct target_backend *tb) \
46 struct config_item_type *cit = &tb->tb_##_name##_cit; \
48 cit->ct_item_ops = _item_ops; \
49 cit->ct_group_ops = _group_ops; \
50 cit->ct_attrs = _attrs; \
51 cit->ct_owner = tb->ops->owner; \
52 pr_debug("Setup generic %s\n", __stringify(_name)); \
55 #define TB_CIT_SETUP_DRV(_name, _item_ops, _group_ops) \
56 static void target_core_setup_##_name##_cit(struct target_backend *tb) \
58 struct config_item_type *cit = &tb->tb_##_name##_cit; \
60 cit->ct_item_ops = _item_ops; \
61 cit->ct_group_ops = _group_ops; \
62 cit->ct_attrs = tb->ops->tb_##_name##_attrs; \
63 cit->ct_owner = tb->ops->owner; \
64 pr_debug("Setup generic %s\n", __stringify(_name)); \
67 extern struct t10_alua_lu_gp *default_lu_gp;
69 static LIST_HEAD(g_tf_list);
70 static DEFINE_MUTEX(g_tf_lock);
72 static struct config_group target_core_hbagroup;
73 static struct config_group alua_group;
74 static struct config_group alua_lu_gps_group;
76 static unsigned int target_devices;
77 static DEFINE_MUTEX(target_devices_lock);
79 static inline struct se_hba *
80 item_to_hba(struct config_item *item)
82 return container_of(to_config_group(item), struct se_hba, hba_group);
86 * Attributes for /sys/kernel/config/target/
88 static ssize_t target_core_item_version_show(struct config_item *item,
91 return sprintf(page, "Target Engine Core ConfigFS Infrastructure %s"
92 " on %s/%s on "UTS_RELEASE"\n", TARGET_CORE_VERSION,
93 utsname()->sysname, utsname()->machine);
96 CONFIGFS_ATTR_RO(target_core_item_, version);
98 char db_root[DB_ROOT_LEN] = DB_ROOT_DEFAULT;
99 static char db_root_stage[DB_ROOT_LEN];
101 static ssize_t target_core_item_dbroot_show(struct config_item *item,
104 return sprintf(page, "%s\n", db_root);
107 static ssize_t target_core_item_dbroot_store(struct config_item *item,
108 const char *page, size_t count)
114 mutex_lock(&target_devices_lock);
115 if (target_devices) {
116 pr_err("db_root: cannot be changed because it's in use\n");
120 if (count > (DB_ROOT_LEN - 1)) {
121 pr_err("db_root: count %d exceeds DB_ROOT_LEN-1: %u\n",
122 (int)count, DB_ROOT_LEN - 1);
126 read_bytes = snprintf(db_root_stage, DB_ROOT_LEN, "%s", page);
130 if (db_root_stage[read_bytes - 1] == '\n')
131 db_root_stage[read_bytes - 1] = '\0';
133 /* validate new db root before accepting it */
134 fp = filp_open(db_root_stage, O_RDONLY, 0);
136 pr_err("db_root: cannot open: %s\n", db_root_stage);
139 if (!S_ISDIR(file_inode(fp)->i_mode)) {
140 filp_close(fp, NULL);
141 pr_err("db_root: not a directory: %s\n", db_root_stage);
144 filp_close(fp, NULL);
146 strncpy(db_root, db_root_stage, read_bytes);
147 pr_debug("Target_Core_ConfigFS: db_root set to %s\n", db_root);
152 mutex_unlock(&target_devices_lock);
156 CONFIGFS_ATTR(target_core_item_, dbroot);
158 static struct target_fabric_configfs *target_core_get_fabric(
161 struct target_fabric_configfs *tf;
166 mutex_lock(&g_tf_lock);
167 list_for_each_entry(tf, &g_tf_list, tf_list) {
168 const char *cmp_name = tf->tf_ops->fabric_alias;
170 cmp_name = tf->tf_ops->fabric_name;
171 if (!strcmp(cmp_name, name)) {
172 atomic_inc(&tf->tf_access_cnt);
173 mutex_unlock(&g_tf_lock);
177 mutex_unlock(&g_tf_lock);
183 * Called from struct target_core_group_ops->make_group()
185 static struct config_group *target_core_register_fabric(
186 struct config_group *group,
189 struct target_fabric_configfs *tf;
192 pr_debug("Target_Core_ConfigFS: REGISTER -> group: %p name:"
193 " %s\n", group, name);
195 tf = target_core_get_fabric(name);
197 pr_debug("target_core_register_fabric() trying autoload for %s\n",
201 * Below are some hardcoded request_module() calls to automatically
202 * local fabric modules when the following is called:
204 * mkdir -p /sys/kernel/config/target/$MODULE_NAME
206 * Note that this does not limit which TCM fabric module can be
207 * registered, but simply provids auto loading logic for modules with
208 * mkdir(2) system calls with known TCM fabric modules.
211 if (!strncmp(name, "iscsi", 5)) {
213 * Automatically load the LIO Target fabric module when the
214 * following is called:
216 * mkdir -p $CONFIGFS/target/iscsi
218 ret = request_module("iscsi_target_mod");
220 pr_debug("request_module() failed for"
221 " iscsi_target_mod.ko: %d\n", ret);
222 return ERR_PTR(-EINVAL);
224 } else if (!strncmp(name, "loopback", 8)) {
226 * Automatically load the tcm_loop fabric module when the
227 * following is called:
229 * mkdir -p $CONFIGFS/target/loopback
231 ret = request_module("tcm_loop");
233 pr_debug("request_module() failed for"
234 " tcm_loop.ko: %d\n", ret);
235 return ERR_PTR(-EINVAL);
239 tf = target_core_get_fabric(name);
243 pr_debug("target_core_get_fabric() failed for %s\n",
245 return ERR_PTR(-EINVAL);
247 pr_debug("Target_Core_ConfigFS: REGISTER -> Located fabric:"
248 " %s\n", tf->tf_ops->fabric_name);
250 * On a successful target_core_get_fabric() look, the returned
251 * struct target_fabric_configfs *tf will contain a usage reference.
253 pr_debug("Target_Core_ConfigFS: REGISTER tfc_wwn_cit -> %p\n",
256 config_group_init_type_name(&tf->tf_group, name, &tf->tf_wwn_cit);
258 config_group_init_type_name(&tf->tf_disc_group, "discovery_auth",
259 &tf->tf_discovery_cit);
260 configfs_add_default_group(&tf->tf_disc_group, &tf->tf_group);
262 pr_debug("Target_Core_ConfigFS: REGISTER -> Allocated Fabric: %s\n",
263 config_item_name(&tf->tf_group.cg_item));
264 return &tf->tf_group;
268 * Called from struct target_core_group_ops->drop_item()
270 static void target_core_deregister_fabric(
271 struct config_group *group,
272 struct config_item *item)
274 struct target_fabric_configfs *tf = container_of(
275 to_config_group(item), struct target_fabric_configfs, tf_group);
277 pr_debug("Target_Core_ConfigFS: DEREGISTER -> Looking up %s in"
278 " tf list\n", config_item_name(item));
280 pr_debug("Target_Core_ConfigFS: DEREGISTER -> located fabric:"
281 " %s\n", tf->tf_ops->fabric_name);
282 atomic_dec(&tf->tf_access_cnt);
284 pr_debug("Target_Core_ConfigFS: DEREGISTER -> Releasing ci"
285 " %s\n", config_item_name(item));
287 configfs_remove_default_groups(&tf->tf_group);
288 config_item_put(item);
291 static struct configfs_group_operations target_core_fabric_group_ops = {
292 .make_group = &target_core_register_fabric,
293 .drop_item = &target_core_deregister_fabric,
297 * All item attributes appearing in /sys/kernel/target/ appear here.
299 static struct configfs_attribute *target_core_fabric_item_attrs[] = {
300 &target_core_item_attr_version,
301 &target_core_item_attr_dbroot,
306 * Provides Fabrics Groups and Item Attributes for /sys/kernel/config/target/
308 static const struct config_item_type target_core_fabrics_item = {
309 .ct_group_ops = &target_core_fabric_group_ops,
310 .ct_attrs = target_core_fabric_item_attrs,
311 .ct_owner = THIS_MODULE,
314 static struct configfs_subsystem target_core_fabrics = {
317 .ci_namebuf = "target",
318 .ci_type = &target_core_fabrics_item,
323 int target_depend_item(struct config_item *item)
325 return configfs_depend_item(&target_core_fabrics, item);
327 EXPORT_SYMBOL(target_depend_item);
329 void target_undepend_item(struct config_item *item)
331 return configfs_undepend_item(item);
333 EXPORT_SYMBOL(target_undepend_item);
335 /*##############################################################################
336 // Start functions called by external Target Fabrics Modules
337 //############################################################################*/
338 static int target_disable_feature(struct se_portal_group *se_tpg)
343 static u32 target_default_get_inst_index(struct se_portal_group *se_tpg)
348 static u32 target_default_sess_get_index(struct se_session *se_sess)
353 static void target_set_default_node_attributes(struct se_node_acl *se_acl)
357 static int target_default_get_cmd_state(struct se_cmd *se_cmd)
362 static int target_fabric_tf_ops_check(const struct target_core_fabric_ops *tfo)
364 if (tfo->fabric_alias) {
365 if (strlen(tfo->fabric_alias) >= TARGET_FABRIC_NAME_SIZE) {
366 pr_err("Passed alias: %s exceeds "
367 "TARGET_FABRIC_NAME_SIZE\n", tfo->fabric_alias);
371 if (!tfo->fabric_name) {
372 pr_err("Missing tfo->fabric_name\n");
375 if (strlen(tfo->fabric_name) >= TARGET_FABRIC_NAME_SIZE) {
376 pr_err("Passed name: %s exceeds "
377 "TARGET_FABRIC_NAME_SIZE\n", tfo->fabric_name);
380 if (!tfo->tpg_get_wwn) {
381 pr_err("Missing tfo->tpg_get_wwn()\n");
384 if (!tfo->tpg_get_tag) {
385 pr_err("Missing tfo->tpg_get_tag()\n");
388 if (!tfo->release_cmd) {
389 pr_err("Missing tfo->release_cmd()\n");
392 if (!tfo->write_pending) {
393 pr_err("Missing tfo->write_pending()\n");
396 if (!tfo->queue_data_in) {
397 pr_err("Missing tfo->queue_data_in()\n");
400 if (!tfo->queue_status) {
401 pr_err("Missing tfo->queue_status()\n");
404 if (!tfo->queue_tm_rsp) {
405 pr_err("Missing tfo->queue_tm_rsp()\n");
408 if (!tfo->aborted_task) {
409 pr_err("Missing tfo->aborted_task()\n");
412 if (!tfo->check_stop_free) {
413 pr_err("Missing tfo->check_stop_free()\n");
417 * We at least require tfo->fabric_make_wwn(), tfo->fabric_drop_wwn()
418 * tfo->fabric_make_tpg() and tfo->fabric_drop_tpg() in
419 * target_core_fabric_configfs.c WWN+TPG group context code.
421 if (!tfo->fabric_make_wwn) {
422 pr_err("Missing tfo->fabric_make_wwn()\n");
425 if (!tfo->fabric_drop_wwn) {
426 pr_err("Missing tfo->fabric_drop_wwn()\n");
429 if (!tfo->fabric_make_tpg) {
430 pr_err("Missing tfo->fabric_make_tpg()\n");
433 if (!tfo->fabric_drop_tpg) {
434 pr_err("Missing tfo->fabric_drop_tpg()\n");
441 static void target_set_default_ops(struct target_core_fabric_ops *tfo)
443 if (!tfo->tpg_check_demo_mode)
444 tfo->tpg_check_demo_mode = target_disable_feature;
446 if (!tfo->tpg_check_demo_mode_cache)
447 tfo->tpg_check_demo_mode_cache = target_disable_feature;
449 if (!tfo->tpg_check_demo_mode_write_protect)
450 tfo->tpg_check_demo_mode_write_protect = target_disable_feature;
452 if (!tfo->tpg_check_prod_mode_write_protect)
453 tfo->tpg_check_prod_mode_write_protect = target_disable_feature;
455 if (!tfo->tpg_get_inst_index)
456 tfo->tpg_get_inst_index = target_default_get_inst_index;
458 if (!tfo->sess_get_index)
459 tfo->sess_get_index = target_default_sess_get_index;
461 if (!tfo->set_default_node_attributes)
462 tfo->set_default_node_attributes = target_set_default_node_attributes;
464 if (!tfo->get_cmd_state)
465 tfo->get_cmd_state = target_default_get_cmd_state;
468 int target_register_template(const struct target_core_fabric_ops *fo)
470 struct target_core_fabric_ops *tfo;
471 struct target_fabric_configfs *tf;
474 ret = target_fabric_tf_ops_check(fo);
478 tf = kzalloc(sizeof(struct target_fabric_configfs), GFP_KERNEL);
480 pr_err("%s: could not allocate memory!\n", __func__);
483 tfo = kzalloc(sizeof(struct target_core_fabric_ops), GFP_KERNEL);
486 pr_err("%s: could not allocate memory!\n", __func__);
489 memcpy(tfo, fo, sizeof(*tfo));
490 target_set_default_ops(tfo);
492 INIT_LIST_HEAD(&tf->tf_list);
493 atomic_set(&tf->tf_access_cnt, 0);
495 target_fabric_setup_cits(tf);
497 mutex_lock(&g_tf_lock);
498 list_add_tail(&tf->tf_list, &g_tf_list);
499 mutex_unlock(&g_tf_lock);
503 EXPORT_SYMBOL(target_register_template);
505 void target_unregister_template(const struct target_core_fabric_ops *fo)
507 struct target_fabric_configfs *t;
509 mutex_lock(&g_tf_lock);
510 list_for_each_entry(t, &g_tf_list, tf_list) {
511 if (!strcmp(t->tf_ops->fabric_name, fo->fabric_name)) {
512 BUG_ON(atomic_read(&t->tf_access_cnt));
513 list_del(&t->tf_list);
514 mutex_unlock(&g_tf_lock);
516 * Wait for any outstanding fabric se_deve_entry->rcu_head
517 * callbacks to complete post kfree_rcu(), before allowing
518 * fabric driver unload of TFO->module to proceed.
521 kfree(t->tf_tpg_base_cit.ct_attrs);
527 mutex_unlock(&g_tf_lock);
529 EXPORT_SYMBOL(target_unregister_template);
531 /*##############################################################################
532 // Stop functions called by external Target Fabrics Modules
533 //############################################################################*/
535 static inline struct se_dev_attrib *to_attrib(struct config_item *item)
537 return container_of(to_config_group(item), struct se_dev_attrib,
541 /* Start functions for struct config_item_type tb_dev_attrib_cit */
542 #define DEF_CONFIGFS_ATTRIB_SHOW(_name) \
543 static ssize_t _name##_show(struct config_item *item, char *page) \
545 return snprintf(page, PAGE_SIZE, "%u\n", to_attrib(item)->_name); \
548 DEF_CONFIGFS_ATTRIB_SHOW(emulate_model_alias);
549 DEF_CONFIGFS_ATTRIB_SHOW(emulate_dpo);
550 DEF_CONFIGFS_ATTRIB_SHOW(emulate_fua_write);
551 DEF_CONFIGFS_ATTRIB_SHOW(emulate_fua_read);
552 DEF_CONFIGFS_ATTRIB_SHOW(emulate_write_cache);
553 DEF_CONFIGFS_ATTRIB_SHOW(emulate_ua_intlck_ctrl);
554 DEF_CONFIGFS_ATTRIB_SHOW(emulate_tas);
555 DEF_CONFIGFS_ATTRIB_SHOW(emulate_tpu);
556 DEF_CONFIGFS_ATTRIB_SHOW(emulate_tpws);
557 DEF_CONFIGFS_ATTRIB_SHOW(emulate_caw);
558 DEF_CONFIGFS_ATTRIB_SHOW(emulate_3pc);
559 DEF_CONFIGFS_ATTRIB_SHOW(emulate_pr);
560 DEF_CONFIGFS_ATTRIB_SHOW(pi_prot_type);
561 DEF_CONFIGFS_ATTRIB_SHOW(hw_pi_prot_type);
562 DEF_CONFIGFS_ATTRIB_SHOW(pi_prot_verify);
563 DEF_CONFIGFS_ATTRIB_SHOW(enforce_pr_isids);
564 DEF_CONFIGFS_ATTRIB_SHOW(is_nonrot);
565 DEF_CONFIGFS_ATTRIB_SHOW(emulate_rest_reord);
566 DEF_CONFIGFS_ATTRIB_SHOW(force_pr_aptpl);
567 DEF_CONFIGFS_ATTRIB_SHOW(hw_block_size);
568 DEF_CONFIGFS_ATTRIB_SHOW(block_size);
569 DEF_CONFIGFS_ATTRIB_SHOW(hw_max_sectors);
570 DEF_CONFIGFS_ATTRIB_SHOW(optimal_sectors);
571 DEF_CONFIGFS_ATTRIB_SHOW(hw_queue_depth);
572 DEF_CONFIGFS_ATTRIB_SHOW(queue_depth);
573 DEF_CONFIGFS_ATTRIB_SHOW(max_unmap_lba_count);
574 DEF_CONFIGFS_ATTRIB_SHOW(max_unmap_block_desc_count);
575 DEF_CONFIGFS_ATTRIB_SHOW(unmap_granularity);
576 DEF_CONFIGFS_ATTRIB_SHOW(unmap_granularity_alignment);
577 DEF_CONFIGFS_ATTRIB_SHOW(unmap_zeroes_data);
578 DEF_CONFIGFS_ATTRIB_SHOW(max_write_same_len);
579 DEF_CONFIGFS_ATTRIB_SHOW(emulate_rsoc);
581 #define DEF_CONFIGFS_ATTRIB_STORE_U32(_name) \
582 static ssize_t _name##_store(struct config_item *item, const char *page,\
585 struct se_dev_attrib *da = to_attrib(item); \
589 ret = kstrtou32(page, 0, &val); \
596 DEF_CONFIGFS_ATTRIB_STORE_U32(max_unmap_lba_count);
597 DEF_CONFIGFS_ATTRIB_STORE_U32(max_unmap_block_desc_count);
598 DEF_CONFIGFS_ATTRIB_STORE_U32(unmap_granularity);
599 DEF_CONFIGFS_ATTRIB_STORE_U32(unmap_granularity_alignment);
600 DEF_CONFIGFS_ATTRIB_STORE_U32(max_write_same_len);
602 #define DEF_CONFIGFS_ATTRIB_STORE_BOOL(_name) \
603 static ssize_t _name##_store(struct config_item *item, const char *page, \
606 struct se_dev_attrib *da = to_attrib(item); \
610 ret = kstrtobool(page, &flag); \
617 DEF_CONFIGFS_ATTRIB_STORE_BOOL(emulate_fua_write);
618 DEF_CONFIGFS_ATTRIB_STORE_BOOL(emulate_caw);
619 DEF_CONFIGFS_ATTRIB_STORE_BOOL(emulate_3pc);
620 DEF_CONFIGFS_ATTRIB_STORE_BOOL(emulate_pr);
621 DEF_CONFIGFS_ATTRIB_STORE_BOOL(enforce_pr_isids);
622 DEF_CONFIGFS_ATTRIB_STORE_BOOL(is_nonrot);
624 #define DEF_CONFIGFS_ATTRIB_STORE_STUB(_name) \
625 static ssize_t _name##_store(struct config_item *item, const char *page,\
628 printk_once(KERN_WARNING \
629 "ignoring deprecated %s attribute\n", \
630 __stringify(_name)); \
634 DEF_CONFIGFS_ATTRIB_STORE_STUB(emulate_dpo);
635 DEF_CONFIGFS_ATTRIB_STORE_STUB(emulate_fua_read);
637 static void dev_set_t10_wwn_model_alias(struct se_device *dev)
639 const char *configname;
641 configname = config_item_name(&dev->dev_group.cg_item);
642 if (strlen(configname) >= INQUIRY_MODEL_LEN) {
643 pr_warn("dev[%p]: Backstore name '%s' is too long for "
644 "INQUIRY_MODEL, truncating to 15 characters\n", dev,
648 * XXX We can't use sizeof(dev->t10_wwn.model) (INQUIRY_MODEL_LEN + 1)
649 * here without potentially breaking existing setups, so continue to
650 * truncate one byte shorter than what can be carried in INQUIRY.
652 strscpy(dev->t10_wwn.model, configname, INQUIRY_MODEL_LEN);
655 static ssize_t emulate_model_alias_store(struct config_item *item,
656 const char *page, size_t count)
658 struct se_dev_attrib *da = to_attrib(item);
659 struct se_device *dev = da->da_dev;
663 if (dev->export_count) {
664 pr_err("dev[%p]: Unable to change model alias"
665 " while export_count is %d\n",
666 dev, dev->export_count);
670 ret = kstrtobool(page, &flag);
674 BUILD_BUG_ON(sizeof(dev->t10_wwn.model) != INQUIRY_MODEL_LEN + 1);
676 dev_set_t10_wwn_model_alias(dev);
678 strscpy(dev->t10_wwn.model, dev->transport->inquiry_prod,
679 sizeof(dev->t10_wwn.model));
681 da->emulate_model_alias = flag;
685 static ssize_t emulate_write_cache_store(struct config_item *item,
686 const char *page, size_t count)
688 struct se_dev_attrib *da = to_attrib(item);
692 ret = kstrtobool(page, &flag);
696 if (flag && da->da_dev->transport->get_write_cache) {
697 pr_err("emulate_write_cache not supported for this device\n");
701 da->emulate_write_cache = flag;
702 pr_debug("dev[%p]: SE Device WRITE_CACHE_EMULATION flag: %d\n",
707 static ssize_t emulate_ua_intlck_ctrl_store(struct config_item *item,
708 const char *page, size_t count)
710 struct se_dev_attrib *da = to_attrib(item);
714 ret = kstrtou32(page, 0, &val);
718 if (val != TARGET_UA_INTLCK_CTRL_CLEAR
719 && val != TARGET_UA_INTLCK_CTRL_NO_CLEAR
720 && val != TARGET_UA_INTLCK_CTRL_ESTABLISH_UA) {
721 pr_err("Illegal value %d\n", val);
725 if (da->da_dev->export_count) {
726 pr_err("dev[%p]: Unable to change SE Device"
727 " UA_INTRLCK_CTRL while export_count is %d\n",
728 da->da_dev, da->da_dev->export_count);
731 da->emulate_ua_intlck_ctrl = val;
732 pr_debug("dev[%p]: SE Device UA_INTRLCK_CTRL flag: %d\n",
737 static ssize_t emulate_tas_store(struct config_item *item,
738 const char *page, size_t count)
740 struct se_dev_attrib *da = to_attrib(item);
744 ret = kstrtobool(page, &flag);
748 if (da->da_dev->export_count) {
749 pr_err("dev[%p]: Unable to change SE Device TAS while"
750 " export_count is %d\n",
751 da->da_dev, da->da_dev->export_count);
754 da->emulate_tas = flag;
755 pr_debug("dev[%p]: SE Device TASK_ABORTED status bit: %s\n",
756 da->da_dev, flag ? "Enabled" : "Disabled");
761 static ssize_t emulate_tpu_store(struct config_item *item,
762 const char *page, size_t count)
764 struct se_dev_attrib *da = to_attrib(item);
765 struct se_device *dev = da->da_dev;
769 ret = kstrtobool(page, &flag);
774 * We expect this value to be non-zero when generic Block Layer
775 * Discard supported is detected iblock_create_virtdevice().
777 if (flag && !da->max_unmap_block_desc_count) {
778 if (!dev->transport->configure_unmap ||
779 !dev->transport->configure_unmap(dev)) {
780 pr_err("Generic Block Discard not supported\n");
785 da->emulate_tpu = flag;
786 pr_debug("dev[%p]: SE Device Thin Provisioning UNMAP bit: %d\n",
791 static ssize_t emulate_tpws_store(struct config_item *item,
792 const char *page, size_t count)
794 struct se_dev_attrib *da = to_attrib(item);
795 struct se_device *dev = da->da_dev;
799 ret = kstrtobool(page, &flag);
804 * We expect this value to be non-zero when generic Block Layer
805 * Discard supported is detected iblock_create_virtdevice().
807 if (flag && !da->max_unmap_block_desc_count) {
808 if (!dev->transport->configure_unmap ||
809 !dev->transport->configure_unmap(dev)) {
810 pr_err("Generic Block Discard not supported\n");
815 da->emulate_tpws = flag;
816 pr_debug("dev[%p]: SE Device Thin Provisioning WRITE_SAME: %d\n",
821 static ssize_t pi_prot_type_store(struct config_item *item,
822 const char *page, size_t count)
824 struct se_dev_attrib *da = to_attrib(item);
825 int old_prot = da->pi_prot_type, ret;
826 struct se_device *dev = da->da_dev;
829 ret = kstrtou32(page, 0, &flag);
833 if (flag != 0 && flag != 1 && flag != 2 && flag != 3) {
834 pr_err("Illegal value %d for pi_prot_type\n", flag);
838 pr_err("DIF TYPE2 protection currently not supported\n");
841 if (da->hw_pi_prot_type) {
842 pr_warn("DIF protection enabled on underlying hardware,"
846 if (!dev->transport->init_prot || !dev->transport->free_prot) {
847 /* 0 is only allowed value for non-supporting backends */
851 pr_err("DIF protection not supported by backend: %s\n",
852 dev->transport->name);
855 if (!target_dev_configured(dev)) {
856 pr_err("DIF protection requires device to be configured\n");
859 if (dev->export_count) {
860 pr_err("dev[%p]: Unable to change SE Device PROT type while"
861 " export_count is %d\n", dev, dev->export_count);
865 da->pi_prot_type = flag;
867 if (flag && !old_prot) {
868 ret = dev->transport->init_prot(dev);
870 da->pi_prot_type = old_prot;
871 da->pi_prot_verify = (bool) da->pi_prot_type;
875 } else if (!flag && old_prot) {
876 dev->transport->free_prot(dev);
879 da->pi_prot_verify = (bool) da->pi_prot_type;
880 pr_debug("dev[%p]: SE Device Protection Type: %d\n", dev, flag);
884 /* always zero, but attr needs to remain RW to avoid userspace breakage */
885 static ssize_t pi_prot_format_show(struct config_item *item, char *page)
887 return snprintf(page, PAGE_SIZE, "0\n");
890 static ssize_t pi_prot_format_store(struct config_item *item,
891 const char *page, size_t count)
893 struct se_dev_attrib *da = to_attrib(item);
894 struct se_device *dev = da->da_dev;
898 ret = kstrtobool(page, &flag);
905 if (!dev->transport->format_prot) {
906 pr_err("DIF protection format not supported by backend %s\n",
907 dev->transport->name);
910 if (!target_dev_configured(dev)) {
911 pr_err("DIF protection format requires device to be configured\n");
914 if (dev->export_count) {
915 pr_err("dev[%p]: Unable to format SE Device PROT type while"
916 " export_count is %d\n", dev, dev->export_count);
920 ret = dev->transport->format_prot(dev);
924 pr_debug("dev[%p]: SE Device Protection Format complete\n", dev);
928 static ssize_t pi_prot_verify_store(struct config_item *item,
929 const char *page, size_t count)
931 struct se_dev_attrib *da = to_attrib(item);
935 ret = kstrtobool(page, &flag);
940 da->pi_prot_verify = flag;
943 if (da->hw_pi_prot_type) {
944 pr_warn("DIF protection enabled on underlying hardware,"
948 if (!da->pi_prot_type) {
949 pr_warn("DIF protection not supported by backend, ignoring\n");
952 da->pi_prot_verify = flag;
957 static ssize_t force_pr_aptpl_store(struct config_item *item,
958 const char *page, size_t count)
960 struct se_dev_attrib *da = to_attrib(item);
964 ret = kstrtobool(page, &flag);
967 if (da->da_dev->export_count) {
968 pr_err("dev[%p]: Unable to set force_pr_aptpl while"
969 " export_count is %d\n",
970 da->da_dev, da->da_dev->export_count);
974 da->force_pr_aptpl = flag;
975 pr_debug("dev[%p]: SE Device force_pr_aptpl: %d\n", da->da_dev, flag);
979 static ssize_t emulate_rest_reord_store(struct config_item *item,
980 const char *page, size_t count)
982 struct se_dev_attrib *da = to_attrib(item);
986 ret = kstrtobool(page, &flag);
991 printk(KERN_ERR "dev[%p]: SE Device emulation of restricted"
992 " reordering not implemented\n", da->da_dev);
995 da->emulate_rest_reord = flag;
996 pr_debug("dev[%p]: SE Device emulate_rest_reord: %d\n",
1001 static ssize_t unmap_zeroes_data_store(struct config_item *item,
1002 const char *page, size_t count)
1004 struct se_dev_attrib *da = to_attrib(item);
1005 struct se_device *dev = da->da_dev;
1009 ret = kstrtobool(page, &flag);
1013 if (da->da_dev->export_count) {
1014 pr_err("dev[%p]: Unable to change SE Device"
1015 " unmap_zeroes_data while export_count is %d\n",
1016 da->da_dev, da->da_dev->export_count);
1020 * We expect this value to be non-zero when generic Block Layer
1021 * Discard supported is detected iblock_configure_device().
1023 if (flag && !da->max_unmap_block_desc_count) {
1024 if (!dev->transport->configure_unmap ||
1025 !dev->transport->configure_unmap(dev)) {
1026 pr_err("dev[%p]: Thin Provisioning LBPRZ will not be set because max_unmap_block_desc_count is zero\n",
1031 da->unmap_zeroes_data = flag;
1032 pr_debug("dev[%p]: SE Device Thin Provisioning LBPRZ bit: %d\n",
1038 * Note, this can only be called on unexported SE Device Object.
1040 static ssize_t queue_depth_store(struct config_item *item,
1041 const char *page, size_t count)
1043 struct se_dev_attrib *da = to_attrib(item);
1044 struct se_device *dev = da->da_dev;
1048 ret = kstrtou32(page, 0, &val);
1052 if (dev->export_count) {
1053 pr_err("dev[%p]: Unable to change SE Device TCQ while"
1054 " export_count is %d\n",
1055 dev, dev->export_count);
1059 pr_err("dev[%p]: Illegal ZERO value for queue_depth\n", dev);
1063 if (val > dev->dev_attrib.queue_depth) {
1064 if (val > dev->dev_attrib.hw_queue_depth) {
1065 pr_err("dev[%p]: Passed queue_depth:"
1066 " %u exceeds TCM/SE_Device MAX"
1067 " TCQ: %u\n", dev, val,
1068 dev->dev_attrib.hw_queue_depth);
1072 da->queue_depth = dev->queue_depth = val;
1073 pr_debug("dev[%p]: SE Device TCQ Depth changed to: %u\n", dev, val);
1077 static ssize_t optimal_sectors_store(struct config_item *item,
1078 const char *page, size_t count)
1080 struct se_dev_attrib *da = to_attrib(item);
1084 ret = kstrtou32(page, 0, &val);
1088 if (da->da_dev->export_count) {
1089 pr_err("dev[%p]: Unable to change SE Device"
1090 " optimal_sectors while export_count is %d\n",
1091 da->da_dev, da->da_dev->export_count);
1094 if (val > da->hw_max_sectors) {
1095 pr_err("dev[%p]: Passed optimal_sectors %u cannot be"
1096 " greater than hw_max_sectors: %u\n",
1097 da->da_dev, val, da->hw_max_sectors);
1101 da->optimal_sectors = val;
1102 pr_debug("dev[%p]: SE Device optimal_sectors changed to %u\n",
1107 static ssize_t block_size_store(struct config_item *item,
1108 const char *page, size_t count)
1110 struct se_dev_attrib *da = to_attrib(item);
1114 ret = kstrtou32(page, 0, &val);
1118 if (da->da_dev->export_count) {
1119 pr_err("dev[%p]: Unable to change SE Device block_size"
1120 " while export_count is %d\n",
1121 da->da_dev, da->da_dev->export_count);
1125 if (val != 512 && val != 1024 && val != 2048 && val != 4096) {
1126 pr_err("dev[%p]: Illegal value for block_device: %u"
1127 " for SE device, must be 512, 1024, 2048 or 4096\n",
1132 da->block_size = val;
1134 pr_debug("dev[%p]: SE Device block_size changed to %u\n",
1139 static ssize_t alua_support_show(struct config_item *item, char *page)
1141 struct se_dev_attrib *da = to_attrib(item);
1142 u8 flags = da->da_dev->transport_flags;
1144 return snprintf(page, PAGE_SIZE, "%d\n",
1145 flags & TRANSPORT_FLAG_PASSTHROUGH_ALUA ? 0 : 1);
1148 static ssize_t alua_support_store(struct config_item *item,
1149 const char *page, size_t count)
1151 struct se_dev_attrib *da = to_attrib(item);
1152 struct se_device *dev = da->da_dev;
1156 ret = kstrtobool(page, &flag);
1160 oldflag = !(dev->transport_flags & TRANSPORT_FLAG_PASSTHROUGH_ALUA);
1161 if (flag == oldflag)
1164 if (!(dev->transport->transport_flags_changeable &
1165 TRANSPORT_FLAG_PASSTHROUGH_ALUA)) {
1166 pr_err("dev[%p]: Unable to change SE Device alua_support:"
1167 " alua_support has fixed value\n", dev);
1172 dev->transport_flags &= ~TRANSPORT_FLAG_PASSTHROUGH_ALUA;
1174 dev->transport_flags |= TRANSPORT_FLAG_PASSTHROUGH_ALUA;
1178 static ssize_t pgr_support_show(struct config_item *item, char *page)
1180 struct se_dev_attrib *da = to_attrib(item);
1181 u8 flags = da->da_dev->transport_flags;
1183 return snprintf(page, PAGE_SIZE, "%d\n",
1184 flags & TRANSPORT_FLAG_PASSTHROUGH_PGR ? 0 : 1);
1187 static ssize_t pgr_support_store(struct config_item *item,
1188 const char *page, size_t count)
1190 struct se_dev_attrib *da = to_attrib(item);
1191 struct se_device *dev = da->da_dev;
1195 ret = kstrtobool(page, &flag);
1199 oldflag = !(dev->transport_flags & TRANSPORT_FLAG_PASSTHROUGH_PGR);
1200 if (flag == oldflag)
1203 if (!(dev->transport->transport_flags_changeable &
1204 TRANSPORT_FLAG_PASSTHROUGH_PGR)) {
1205 pr_err("dev[%p]: Unable to change SE Device pgr_support:"
1206 " pgr_support has fixed value\n", dev);
1211 dev->transport_flags &= ~TRANSPORT_FLAG_PASSTHROUGH_PGR;
1213 dev->transport_flags |= TRANSPORT_FLAG_PASSTHROUGH_PGR;
1217 static ssize_t emulate_rsoc_store(struct config_item *item,
1218 const char *page, size_t count)
1220 struct se_dev_attrib *da = to_attrib(item);
1224 ret = kstrtobool(page, &flag);
1228 da->emulate_rsoc = flag;
1229 pr_debug("dev[%p]: SE Device REPORT_SUPPORTED_OPERATION_CODES_EMULATION flag: %d\n",
1234 CONFIGFS_ATTR(, emulate_model_alias);
1235 CONFIGFS_ATTR(, emulate_dpo);
1236 CONFIGFS_ATTR(, emulate_fua_write);
1237 CONFIGFS_ATTR(, emulate_fua_read);
1238 CONFIGFS_ATTR(, emulate_write_cache);
1239 CONFIGFS_ATTR(, emulate_ua_intlck_ctrl);
1240 CONFIGFS_ATTR(, emulate_tas);
1241 CONFIGFS_ATTR(, emulate_tpu);
1242 CONFIGFS_ATTR(, emulate_tpws);
1243 CONFIGFS_ATTR(, emulate_caw);
1244 CONFIGFS_ATTR(, emulate_3pc);
1245 CONFIGFS_ATTR(, emulate_pr);
1246 CONFIGFS_ATTR(, emulate_rsoc);
1247 CONFIGFS_ATTR(, pi_prot_type);
1248 CONFIGFS_ATTR_RO(, hw_pi_prot_type);
1249 CONFIGFS_ATTR(, pi_prot_format);
1250 CONFIGFS_ATTR(, pi_prot_verify);
1251 CONFIGFS_ATTR(, enforce_pr_isids);
1252 CONFIGFS_ATTR(, is_nonrot);
1253 CONFIGFS_ATTR(, emulate_rest_reord);
1254 CONFIGFS_ATTR(, force_pr_aptpl);
1255 CONFIGFS_ATTR_RO(, hw_block_size);
1256 CONFIGFS_ATTR(, block_size);
1257 CONFIGFS_ATTR_RO(, hw_max_sectors);
1258 CONFIGFS_ATTR(, optimal_sectors);
1259 CONFIGFS_ATTR_RO(, hw_queue_depth);
1260 CONFIGFS_ATTR(, queue_depth);
1261 CONFIGFS_ATTR(, max_unmap_lba_count);
1262 CONFIGFS_ATTR(, max_unmap_block_desc_count);
1263 CONFIGFS_ATTR(, unmap_granularity);
1264 CONFIGFS_ATTR(, unmap_granularity_alignment);
1265 CONFIGFS_ATTR(, unmap_zeroes_data);
1266 CONFIGFS_ATTR(, max_write_same_len);
1267 CONFIGFS_ATTR(, alua_support);
1268 CONFIGFS_ATTR(, pgr_support);
1271 * dev_attrib attributes for devices using the target core SBC/SPC
1272 * interpreter. Any backend using spc_parse_cdb should be using
1275 struct configfs_attribute *sbc_attrib_attrs[] = {
1276 &attr_emulate_model_alias,
1278 &attr_emulate_fua_write,
1279 &attr_emulate_fua_read,
1280 &attr_emulate_write_cache,
1281 &attr_emulate_ua_intlck_ctrl,
1289 &attr_hw_pi_prot_type,
1290 &attr_pi_prot_format,
1291 &attr_pi_prot_verify,
1292 &attr_enforce_pr_isids,
1294 &attr_emulate_rest_reord,
1295 &attr_force_pr_aptpl,
1296 &attr_hw_block_size,
1298 &attr_hw_max_sectors,
1299 &attr_optimal_sectors,
1300 &attr_hw_queue_depth,
1302 &attr_max_unmap_lba_count,
1303 &attr_max_unmap_block_desc_count,
1304 &attr_unmap_granularity,
1305 &attr_unmap_granularity_alignment,
1306 &attr_unmap_zeroes_data,
1307 &attr_max_write_same_len,
1313 EXPORT_SYMBOL(sbc_attrib_attrs);
1316 * Minimal dev_attrib attributes for devices passing through CDBs.
1317 * In this case we only provide a few read-only attributes for
1318 * backwards compatibility.
1320 struct configfs_attribute *passthrough_attrib_attrs[] = {
1321 &attr_hw_pi_prot_type,
1322 &attr_hw_block_size,
1323 &attr_hw_max_sectors,
1324 &attr_hw_queue_depth,
1330 EXPORT_SYMBOL(passthrough_attrib_attrs);
1333 * pr related dev_attrib attributes for devices passing through CDBs,
1334 * but allowing in core pr emulation.
1336 struct configfs_attribute *passthrough_pr_attrib_attrs[] = {
1337 &attr_enforce_pr_isids,
1338 &attr_force_pr_aptpl,
1341 EXPORT_SYMBOL(passthrough_pr_attrib_attrs);
1343 TB_CIT_SETUP_DRV(dev_attrib, NULL, NULL);
1344 TB_CIT_SETUP_DRV(dev_action, NULL, NULL);
1346 /* End functions for struct config_item_type tb_dev_attrib_cit */
1348 /* Start functions for struct config_item_type tb_dev_wwn_cit */
1350 static struct t10_wwn *to_t10_wwn(struct config_item *item)
1352 return container_of(to_config_group(item), struct t10_wwn, t10_wwn_group);
1355 static ssize_t target_check_inquiry_data(char *buf)
1364 * ASCII data fields shall contain only ASCII printable characters
1365 * (i.e., code values 20h to 7Eh) and may be terminated with one or
1366 * more ASCII null (00h) characters.
1368 for (i = 0; i < len; i++) {
1369 if (buf[i] < 0x20 || buf[i] > 0x7E) {
1370 pr_err("Emulated T10 Inquiry Data contains non-ASCII-printable characters\n");
1379 * STANDARD and VPD page 0x83 T10 Vendor Identification
1381 static ssize_t target_wwn_vendor_id_show(struct config_item *item,
1384 return sprintf(page, "%s\n", &to_t10_wwn(item)->vendor[0]);
1387 static ssize_t target_wwn_vendor_id_store(struct config_item *item,
1388 const char *page, size_t count)
1390 struct t10_wwn *t10_wwn = to_t10_wwn(item);
1391 struct se_device *dev = t10_wwn->t10_dev;
1392 /* +2 to allow for a trailing (stripped) '\n' and null-terminator */
1393 unsigned char buf[INQUIRY_VENDOR_LEN + 2];
1394 char *stripped = NULL;
1398 len = strscpy(buf, page, sizeof(buf));
1400 /* Strip any newline added from userspace. */
1401 stripped = strstrip(buf);
1402 len = strlen(stripped);
1404 if (len < 0 || len > INQUIRY_VENDOR_LEN) {
1405 pr_err("Emulated T10 Vendor Identification exceeds"
1406 " INQUIRY_VENDOR_LEN: " __stringify(INQUIRY_VENDOR_LEN)
1411 ret = target_check_inquiry_data(stripped);
1417 * Check to see if any active exports exist. If they do exist, fail
1418 * here as changing this information on the fly (underneath the
1419 * initiator side OS dependent multipath code) could cause negative
1422 if (dev->export_count) {
1423 pr_err("Unable to set T10 Vendor Identification while"
1424 " active %d exports exist\n", dev->export_count);
1428 BUILD_BUG_ON(sizeof(dev->t10_wwn.vendor) != INQUIRY_VENDOR_LEN + 1);
1429 strscpy(dev->t10_wwn.vendor, stripped, sizeof(dev->t10_wwn.vendor));
1431 pr_debug("Target_Core_ConfigFS: Set emulated T10 Vendor Identification:"
1432 " %s\n", dev->t10_wwn.vendor);
1437 static ssize_t target_wwn_product_id_show(struct config_item *item,
1440 return sprintf(page, "%s\n", &to_t10_wwn(item)->model[0]);
1443 static ssize_t target_wwn_product_id_store(struct config_item *item,
1444 const char *page, size_t count)
1446 struct t10_wwn *t10_wwn = to_t10_wwn(item);
1447 struct se_device *dev = t10_wwn->t10_dev;
1448 /* +2 to allow for a trailing (stripped) '\n' and null-terminator */
1449 unsigned char buf[INQUIRY_MODEL_LEN + 2];
1450 char *stripped = NULL;
1454 len = strscpy(buf, page, sizeof(buf));
1456 /* Strip any newline added from userspace. */
1457 stripped = strstrip(buf);
1458 len = strlen(stripped);
1460 if (len < 0 || len > INQUIRY_MODEL_LEN) {
1461 pr_err("Emulated T10 Vendor exceeds INQUIRY_MODEL_LEN: "
1462 __stringify(INQUIRY_MODEL_LEN)
1467 ret = target_check_inquiry_data(stripped);
1473 * Check to see if any active exports exist. If they do exist, fail
1474 * here as changing this information on the fly (underneath the
1475 * initiator side OS dependent multipath code) could cause negative
1478 if (dev->export_count) {
1479 pr_err("Unable to set T10 Model while active %d exports exist\n",
1484 BUILD_BUG_ON(sizeof(dev->t10_wwn.model) != INQUIRY_MODEL_LEN + 1);
1485 strscpy(dev->t10_wwn.model, stripped, sizeof(dev->t10_wwn.model));
1487 pr_debug("Target_Core_ConfigFS: Set emulated T10 Model Identification: %s\n",
1488 dev->t10_wwn.model);
1493 static ssize_t target_wwn_revision_show(struct config_item *item,
1496 return sprintf(page, "%s\n", &to_t10_wwn(item)->revision[0]);
1499 static ssize_t target_wwn_revision_store(struct config_item *item,
1500 const char *page, size_t count)
1502 struct t10_wwn *t10_wwn = to_t10_wwn(item);
1503 struct se_device *dev = t10_wwn->t10_dev;
1504 /* +2 to allow for a trailing (stripped) '\n' and null-terminator */
1505 unsigned char buf[INQUIRY_REVISION_LEN + 2];
1506 char *stripped = NULL;
1510 len = strscpy(buf, page, sizeof(buf));
1512 /* Strip any newline added from userspace. */
1513 stripped = strstrip(buf);
1514 len = strlen(stripped);
1516 if (len < 0 || len > INQUIRY_REVISION_LEN) {
1517 pr_err("Emulated T10 Revision exceeds INQUIRY_REVISION_LEN: "
1518 __stringify(INQUIRY_REVISION_LEN)
1523 ret = target_check_inquiry_data(stripped);
1529 * Check to see if any active exports exist. If they do exist, fail
1530 * here as changing this information on the fly (underneath the
1531 * initiator side OS dependent multipath code) could cause negative
1534 if (dev->export_count) {
1535 pr_err("Unable to set T10 Revision while active %d exports exist\n",
1540 BUILD_BUG_ON(sizeof(dev->t10_wwn.revision) != INQUIRY_REVISION_LEN + 1);
1541 strscpy(dev->t10_wwn.revision, stripped, sizeof(dev->t10_wwn.revision));
1543 pr_debug("Target_Core_ConfigFS: Set emulated T10 Revision: %s\n",
1544 dev->t10_wwn.revision);
1550 target_wwn_company_id_show(struct config_item *item,
1553 return snprintf(page, PAGE_SIZE, "%#08x\n",
1554 to_t10_wwn(item)->company_id);
1558 target_wwn_company_id_store(struct config_item *item,
1559 const char *page, size_t count)
1561 struct t10_wwn *t10_wwn = to_t10_wwn(item);
1562 struct se_device *dev = t10_wwn->t10_dev;
1567 * The IEEE COMPANY_ID field should contain a 24-bit canonical
1568 * form OUI assigned by the IEEE.
1570 ret = kstrtou32(page, 0, &val);
1574 if (val >= 0x1000000)
1578 * Check to see if any active exports exist. If they do exist, fail
1579 * here as changing this information on the fly (underneath the
1580 * initiator side OS dependent multipath code) could cause negative
1583 if (dev->export_count) {
1584 pr_err("Unable to set Company ID while %u exports exist\n",
1589 t10_wwn->company_id = val;
1591 pr_debug("Target_Core_ConfigFS: Set IEEE Company ID: %#08x\n",
1592 t10_wwn->company_id);
1598 * VPD page 0x80 Unit serial
1600 static ssize_t target_wwn_vpd_unit_serial_show(struct config_item *item,
1603 return sprintf(page, "T10 VPD Unit Serial Number: %s\n",
1604 &to_t10_wwn(item)->unit_serial[0]);
1607 static ssize_t target_wwn_vpd_unit_serial_store(struct config_item *item,
1608 const char *page, size_t count)
1610 struct t10_wwn *t10_wwn = to_t10_wwn(item);
1611 struct se_device *dev = t10_wwn->t10_dev;
1612 unsigned char buf[INQUIRY_VPD_SERIAL_LEN] = { };
1615 * If Linux/SCSI subsystem_api_t plugin got a VPD Unit Serial
1616 * from the struct scsi_device level firmware, do not allow
1617 * VPD Unit Serial to be emulated.
1619 * Note this struct scsi_device could also be emulating VPD
1620 * information from its drivers/scsi LLD. But for now we assume
1621 * it is doing 'the right thing' wrt a world wide unique
1622 * VPD Unit Serial Number that OS dependent multipath can depend on.
1624 if (dev->dev_flags & DF_FIRMWARE_VPD_UNIT_SERIAL) {
1625 pr_err("Underlying SCSI device firmware provided VPD"
1626 " Unit Serial, ignoring request\n");
1630 if (strlen(page) >= INQUIRY_VPD_SERIAL_LEN) {
1631 pr_err("Emulated VPD Unit Serial exceeds"
1632 " INQUIRY_VPD_SERIAL_LEN: %d\n", INQUIRY_VPD_SERIAL_LEN);
1636 * Check to see if any active $FABRIC_MOD exports exist. If they
1637 * do exist, fail here as changing this information on the fly
1638 * (underneath the initiator side OS dependent multipath code)
1639 * could cause negative effects.
1641 if (dev->export_count) {
1642 pr_err("Unable to set VPD Unit Serial while"
1643 " active %d $FABRIC_MOD exports exist\n",
1649 * This currently assumes ASCII encoding for emulated VPD Unit Serial.
1651 * Also, strip any newline added from the userspace
1652 * echo $UUID > $TARGET/$HBA/$STORAGE_OBJECT/wwn/vpd_unit_serial
1654 snprintf(buf, INQUIRY_VPD_SERIAL_LEN, "%s", page);
1655 snprintf(dev->t10_wwn.unit_serial, INQUIRY_VPD_SERIAL_LEN,
1656 "%s", strstrip(buf));
1657 dev->dev_flags |= DF_EMULATED_VPD_UNIT_SERIAL;
1659 pr_debug("Target_Core_ConfigFS: Set emulated VPD Unit Serial:"
1660 " %s\n", dev->t10_wwn.unit_serial);
1666 * VPD page 0x83 Protocol Identifier
1668 static ssize_t target_wwn_vpd_protocol_identifier_show(struct config_item *item,
1671 struct t10_wwn *t10_wwn = to_t10_wwn(item);
1672 struct t10_vpd *vpd;
1673 unsigned char buf[VPD_TMP_BUF_SIZE] = { };
1676 spin_lock(&t10_wwn->t10_vpd_lock);
1677 list_for_each_entry(vpd, &t10_wwn->t10_vpd_list, vpd_list) {
1678 if (!vpd->protocol_identifier_set)
1681 transport_dump_vpd_proto_id(vpd, buf, VPD_TMP_BUF_SIZE);
1683 if (len + strlen(buf) >= PAGE_SIZE)
1686 len += sprintf(page+len, "%s", buf);
1688 spin_unlock(&t10_wwn->t10_vpd_lock);
1694 * Generic wrapper for dumping VPD identifiers by association.
1696 #define DEF_DEV_WWN_ASSOC_SHOW(_name, _assoc) \
1697 static ssize_t target_wwn_##_name##_show(struct config_item *item, \
1700 struct t10_wwn *t10_wwn = to_t10_wwn(item); \
1701 struct t10_vpd *vpd; \
1702 unsigned char buf[VPD_TMP_BUF_SIZE]; \
1705 spin_lock(&t10_wwn->t10_vpd_lock); \
1706 list_for_each_entry(vpd, &t10_wwn->t10_vpd_list, vpd_list) { \
1707 if (vpd->association != _assoc) \
1710 memset(buf, 0, VPD_TMP_BUF_SIZE); \
1711 transport_dump_vpd_assoc(vpd, buf, VPD_TMP_BUF_SIZE); \
1712 if (len + strlen(buf) >= PAGE_SIZE) \
1714 len += sprintf(page+len, "%s", buf); \
1716 memset(buf, 0, VPD_TMP_BUF_SIZE); \
1717 transport_dump_vpd_ident_type(vpd, buf, VPD_TMP_BUF_SIZE); \
1718 if (len + strlen(buf) >= PAGE_SIZE) \
1720 len += sprintf(page+len, "%s", buf); \
1722 memset(buf, 0, VPD_TMP_BUF_SIZE); \
1723 transport_dump_vpd_ident(vpd, buf, VPD_TMP_BUF_SIZE); \
1724 if (len + strlen(buf) >= PAGE_SIZE) \
1726 len += sprintf(page+len, "%s", buf); \
1728 spin_unlock(&t10_wwn->t10_vpd_lock); \
1733 /* VPD page 0x83 Association: Logical Unit */
1734 DEF_DEV_WWN_ASSOC_SHOW(vpd_assoc_logical_unit, 0x00);
1735 /* VPD page 0x83 Association: Target Port */
1736 DEF_DEV_WWN_ASSOC_SHOW(vpd_assoc_target_port, 0x10);
1737 /* VPD page 0x83 Association: SCSI Target Device */
1738 DEF_DEV_WWN_ASSOC_SHOW(vpd_assoc_scsi_target_device, 0x20);
1740 CONFIGFS_ATTR(target_wwn_, vendor_id);
1741 CONFIGFS_ATTR(target_wwn_, product_id);
1742 CONFIGFS_ATTR(target_wwn_, revision);
1743 CONFIGFS_ATTR(target_wwn_, company_id);
1744 CONFIGFS_ATTR(target_wwn_, vpd_unit_serial);
1745 CONFIGFS_ATTR_RO(target_wwn_, vpd_protocol_identifier);
1746 CONFIGFS_ATTR_RO(target_wwn_, vpd_assoc_logical_unit);
1747 CONFIGFS_ATTR_RO(target_wwn_, vpd_assoc_target_port);
1748 CONFIGFS_ATTR_RO(target_wwn_, vpd_assoc_scsi_target_device);
1750 static struct configfs_attribute *target_core_dev_wwn_attrs[] = {
1751 &target_wwn_attr_vendor_id,
1752 &target_wwn_attr_product_id,
1753 &target_wwn_attr_revision,
1754 &target_wwn_attr_company_id,
1755 &target_wwn_attr_vpd_unit_serial,
1756 &target_wwn_attr_vpd_protocol_identifier,
1757 &target_wwn_attr_vpd_assoc_logical_unit,
1758 &target_wwn_attr_vpd_assoc_target_port,
1759 &target_wwn_attr_vpd_assoc_scsi_target_device,
1763 TB_CIT_SETUP(dev_wwn, NULL, NULL, target_core_dev_wwn_attrs);
1765 /* End functions for struct config_item_type tb_dev_wwn_cit */
1767 /* Start functions for struct config_item_type tb_dev_pr_cit */
1769 static struct se_device *pr_to_dev(struct config_item *item)
1771 return container_of(to_config_group(item), struct se_device,
1775 static ssize_t target_core_dev_pr_show_spc3_res(struct se_device *dev,
1778 struct se_node_acl *se_nacl;
1779 struct t10_pr_registration *pr_reg;
1780 char i_buf[PR_REG_ISID_ID_LEN] = { };
1782 pr_reg = dev->dev_pr_res_holder;
1784 return sprintf(page, "No SPC-3 Reservation holder\n");
1786 se_nacl = pr_reg->pr_reg_nacl;
1787 core_pr_dump_initiator_port(pr_reg, i_buf, PR_REG_ISID_ID_LEN);
1789 return sprintf(page, "SPC-3 Reservation: %s Initiator: %s%s\n",
1790 se_nacl->se_tpg->se_tpg_tfo->fabric_name,
1791 se_nacl->initiatorname, i_buf);
1794 static ssize_t target_core_dev_pr_show_spc2_res(struct se_device *dev,
1797 struct se_session *sess = dev->reservation_holder;
1798 struct se_node_acl *se_nacl;
1802 se_nacl = sess->se_node_acl;
1804 "SPC-2 Reservation: %s Initiator: %s\n",
1805 se_nacl->se_tpg->se_tpg_tfo->fabric_name,
1806 se_nacl->initiatorname);
1808 len = sprintf(page, "No SPC-2 Reservation holder\n");
1813 static ssize_t target_pr_res_holder_show(struct config_item *item, char *page)
1815 struct se_device *dev = pr_to_dev(item);
1818 if (!dev->dev_attrib.emulate_pr)
1819 return sprintf(page, "SPC_RESERVATIONS_DISABLED\n");
1821 if (dev->transport_flags & TRANSPORT_FLAG_PASSTHROUGH_PGR)
1822 return sprintf(page, "Passthrough\n");
1824 spin_lock(&dev->dev_reservation_lock);
1825 if (dev->dev_reservation_flags & DRF_SPC2_RESERVATIONS)
1826 ret = target_core_dev_pr_show_spc2_res(dev, page);
1828 ret = target_core_dev_pr_show_spc3_res(dev, page);
1829 spin_unlock(&dev->dev_reservation_lock);
1833 static ssize_t target_pr_res_pr_all_tgt_pts_show(struct config_item *item,
1836 struct se_device *dev = pr_to_dev(item);
1839 spin_lock(&dev->dev_reservation_lock);
1840 if (!dev->dev_pr_res_holder) {
1841 len = sprintf(page, "No SPC-3 Reservation holder\n");
1842 } else if (dev->dev_pr_res_holder->pr_reg_all_tg_pt) {
1843 len = sprintf(page, "SPC-3 Reservation: All Target"
1844 " Ports registration\n");
1846 len = sprintf(page, "SPC-3 Reservation: Single"
1847 " Target Port registration\n");
1850 spin_unlock(&dev->dev_reservation_lock);
1854 static ssize_t target_pr_res_pr_generation_show(struct config_item *item,
1857 return sprintf(page, "0x%08x\n", pr_to_dev(item)->t10_pr.pr_generation);
1861 static ssize_t target_pr_res_pr_holder_tg_port_show(struct config_item *item,
1864 struct se_device *dev = pr_to_dev(item);
1865 struct se_node_acl *se_nacl;
1866 struct se_portal_group *se_tpg;
1867 struct t10_pr_registration *pr_reg;
1868 const struct target_core_fabric_ops *tfo;
1871 spin_lock(&dev->dev_reservation_lock);
1872 pr_reg = dev->dev_pr_res_holder;
1874 len = sprintf(page, "No SPC-3 Reservation holder\n");
1878 se_nacl = pr_reg->pr_reg_nacl;
1879 se_tpg = se_nacl->se_tpg;
1880 tfo = se_tpg->se_tpg_tfo;
1882 len += sprintf(page+len, "SPC-3 Reservation: %s"
1883 " Target Node Endpoint: %s\n", tfo->fabric_name,
1884 tfo->tpg_get_wwn(se_tpg));
1885 len += sprintf(page+len, "SPC-3 Reservation: Relative Port"
1886 " Identifier Tag: %hu %s Portal Group Tag: %hu"
1887 " %s Logical Unit: %llu\n", pr_reg->tg_pt_sep_rtpi,
1888 tfo->fabric_name, tfo->tpg_get_tag(se_tpg),
1889 tfo->fabric_name, pr_reg->pr_aptpl_target_lun);
1892 spin_unlock(&dev->dev_reservation_lock);
1897 static ssize_t target_pr_res_pr_registered_i_pts_show(struct config_item *item,
1900 struct se_device *dev = pr_to_dev(item);
1901 const struct target_core_fabric_ops *tfo;
1902 struct t10_pr_registration *pr_reg;
1903 unsigned char buf[384];
1904 char i_buf[PR_REG_ISID_ID_LEN];
1908 len += sprintf(page+len, "SPC-3 PR Registrations:\n");
1910 spin_lock(&dev->t10_pr.registration_lock);
1911 list_for_each_entry(pr_reg, &dev->t10_pr.registration_list,
1914 memset(buf, 0, 384);
1915 memset(i_buf, 0, PR_REG_ISID_ID_LEN);
1916 tfo = pr_reg->pr_reg_nacl->se_tpg->se_tpg_tfo;
1917 core_pr_dump_initiator_port(pr_reg, i_buf,
1918 PR_REG_ISID_ID_LEN);
1919 sprintf(buf, "%s Node: %s%s Key: 0x%016Lx PRgen: 0x%08x\n",
1921 pr_reg->pr_reg_nacl->initiatorname, i_buf, pr_reg->pr_res_key,
1922 pr_reg->pr_res_generation);
1924 if (len + strlen(buf) >= PAGE_SIZE)
1927 len += sprintf(page+len, "%s", buf);
1930 spin_unlock(&dev->t10_pr.registration_lock);
1933 len += sprintf(page+len, "None\n");
1938 static ssize_t target_pr_res_pr_type_show(struct config_item *item, char *page)
1940 struct se_device *dev = pr_to_dev(item);
1941 struct t10_pr_registration *pr_reg;
1944 spin_lock(&dev->dev_reservation_lock);
1945 pr_reg = dev->dev_pr_res_holder;
1947 len = sprintf(page, "SPC-3 Reservation Type: %s\n",
1948 core_scsi3_pr_dump_type(pr_reg->pr_res_type));
1950 len = sprintf(page, "No SPC-3 Reservation holder\n");
1953 spin_unlock(&dev->dev_reservation_lock);
1957 static ssize_t target_pr_res_type_show(struct config_item *item, char *page)
1959 struct se_device *dev = pr_to_dev(item);
1961 if (!dev->dev_attrib.emulate_pr)
1962 return sprintf(page, "SPC_RESERVATIONS_DISABLED\n");
1963 if (dev->transport_flags & TRANSPORT_FLAG_PASSTHROUGH_PGR)
1964 return sprintf(page, "SPC_PASSTHROUGH\n");
1965 if (dev->dev_reservation_flags & DRF_SPC2_RESERVATIONS)
1966 return sprintf(page, "SPC2_RESERVATIONS\n");
1968 return sprintf(page, "SPC3_PERSISTENT_RESERVATIONS\n");
1971 static ssize_t target_pr_res_aptpl_active_show(struct config_item *item,
1974 struct se_device *dev = pr_to_dev(item);
1976 if (!dev->dev_attrib.emulate_pr ||
1977 (dev->transport_flags & TRANSPORT_FLAG_PASSTHROUGH_PGR))
1980 return sprintf(page, "APTPL Bit Status: %s\n",
1981 (dev->t10_pr.pr_aptpl_active) ? "Activated" : "Disabled");
1984 static ssize_t target_pr_res_aptpl_metadata_show(struct config_item *item,
1987 struct se_device *dev = pr_to_dev(item);
1989 if (!dev->dev_attrib.emulate_pr ||
1990 (dev->transport_flags & TRANSPORT_FLAG_PASSTHROUGH_PGR))
1993 return sprintf(page, "Ready to process PR APTPL metadata..\n");
1997 Opt_initiator_fabric, Opt_initiator_node, Opt_initiator_sid,
1998 Opt_sa_res_key, Opt_res_holder, Opt_res_type, Opt_res_scope,
1999 Opt_res_all_tg_pt, Opt_mapped_lun, Opt_target_fabric,
2000 Opt_target_node, Opt_tpgt, Opt_port_rtpi, Opt_target_lun, Opt_err
2003 static match_table_t tokens = {
2004 {Opt_initiator_fabric, "initiator_fabric=%s"},
2005 {Opt_initiator_node, "initiator_node=%s"},
2006 {Opt_initiator_sid, "initiator_sid=%s"},
2007 {Opt_sa_res_key, "sa_res_key=%s"},
2008 {Opt_res_holder, "res_holder=%d"},
2009 {Opt_res_type, "res_type=%d"},
2010 {Opt_res_scope, "res_scope=%d"},
2011 {Opt_res_all_tg_pt, "res_all_tg_pt=%d"},
2012 {Opt_mapped_lun, "mapped_lun=%u"},
2013 {Opt_target_fabric, "target_fabric=%s"},
2014 {Opt_target_node, "target_node=%s"},
2015 {Opt_tpgt, "tpgt=%d"},
2016 {Opt_port_rtpi, "port_rtpi=%d"},
2017 {Opt_target_lun, "target_lun=%u"},
2021 static ssize_t target_pr_res_aptpl_metadata_store(struct config_item *item,
2022 const char *page, size_t count)
2024 struct se_device *dev = pr_to_dev(item);
2025 unsigned char *i_fabric = NULL, *i_port = NULL, *isid = NULL;
2026 unsigned char *t_fabric = NULL, *t_port = NULL;
2027 char *orig, *ptr, *opts;
2028 substring_t args[MAX_OPT_ARGS];
2029 unsigned long long tmp_ll;
2031 u64 mapped_lun = 0, target_lun = 0;
2032 int ret = -1, res_holder = 0, all_tg_pt = 0, arg, token;
2036 if (!dev->dev_attrib.emulate_pr ||
2037 (dev->transport_flags & TRANSPORT_FLAG_PASSTHROUGH_PGR))
2039 if (dev->dev_reservation_flags & DRF_SPC2_RESERVATIONS)
2042 if (dev->export_count) {
2043 pr_debug("Unable to process APTPL metadata while"
2044 " active fabric exports exist\n");
2048 opts = kstrdup(page, GFP_KERNEL);
2053 while ((ptr = strsep(&opts, ",\n")) != NULL) {
2057 token = match_token(ptr, tokens, args);
2059 case Opt_initiator_fabric:
2060 i_fabric = match_strdup(args);
2066 case Opt_initiator_node:
2067 i_port = match_strdup(args);
2072 if (strlen(i_port) >= PR_APTPL_MAX_IPORT_LEN) {
2073 pr_err("APTPL metadata initiator_node="
2074 " exceeds PR_APTPL_MAX_IPORT_LEN: %d\n",
2075 PR_APTPL_MAX_IPORT_LEN);
2080 case Opt_initiator_sid:
2081 isid = match_strdup(args);
2086 if (strlen(isid) >= PR_REG_ISID_LEN) {
2087 pr_err("APTPL metadata initiator_isid"
2088 "= exceeds PR_REG_ISID_LEN: %d\n",
2094 case Opt_sa_res_key:
2095 ret = match_u64(args, &tmp_ll);
2097 pr_err("kstrtoull() failed for sa_res_key=\n");
2100 sa_res_key = (u64)tmp_ll;
2103 * PR APTPL Metadata for Reservation
2105 case Opt_res_holder:
2106 ret = match_int(args, &arg);
2112 ret = match_int(args, &arg);
2118 ret = match_int(args, &arg);
2122 case Opt_res_all_tg_pt:
2123 ret = match_int(args, &arg);
2126 all_tg_pt = (int)arg;
2128 case Opt_mapped_lun:
2129 ret = match_u64(args, &tmp_ll);
2132 mapped_lun = (u64)tmp_ll;
2135 * PR APTPL Metadata for Target Port
2137 case Opt_target_fabric:
2138 t_fabric = match_strdup(args);
2144 case Opt_target_node:
2145 t_port = match_strdup(args);
2150 if (strlen(t_port) >= PR_APTPL_MAX_TPORT_LEN) {
2151 pr_err("APTPL metadata target_node="
2152 " exceeds PR_APTPL_MAX_TPORT_LEN: %d\n",
2153 PR_APTPL_MAX_TPORT_LEN);
2159 ret = match_int(args, &arg);
2165 ret = match_int(args, &arg);
2169 case Opt_target_lun:
2170 ret = match_u64(args, &tmp_ll);
2173 target_lun = (u64)tmp_ll;
2180 if (!i_port || !t_port || !sa_res_key) {
2181 pr_err("Illegal parameters for APTPL registration\n");
2186 if (res_holder && !(type)) {
2187 pr_err("Illegal PR type: 0x%02x for reservation"
2193 ret = core_scsi3_alloc_aptpl_registration(&dev->t10_pr, sa_res_key,
2194 i_port, isid, mapped_lun, t_port, tpgt, target_lun,
2195 res_holder, all_tg_pt, type);
2203 return (ret == 0) ? count : ret;
2207 CONFIGFS_ATTR_RO(target_pr_, res_holder);
2208 CONFIGFS_ATTR_RO(target_pr_, res_pr_all_tgt_pts);
2209 CONFIGFS_ATTR_RO(target_pr_, res_pr_generation);
2210 CONFIGFS_ATTR_RO(target_pr_, res_pr_holder_tg_port);
2211 CONFIGFS_ATTR_RO(target_pr_, res_pr_registered_i_pts);
2212 CONFIGFS_ATTR_RO(target_pr_, res_pr_type);
2213 CONFIGFS_ATTR_RO(target_pr_, res_type);
2214 CONFIGFS_ATTR_RO(target_pr_, res_aptpl_active);
2215 CONFIGFS_ATTR(target_pr_, res_aptpl_metadata);
2217 static struct configfs_attribute *target_core_dev_pr_attrs[] = {
2218 &target_pr_attr_res_holder,
2219 &target_pr_attr_res_pr_all_tgt_pts,
2220 &target_pr_attr_res_pr_generation,
2221 &target_pr_attr_res_pr_holder_tg_port,
2222 &target_pr_attr_res_pr_registered_i_pts,
2223 &target_pr_attr_res_pr_type,
2224 &target_pr_attr_res_type,
2225 &target_pr_attr_res_aptpl_active,
2226 &target_pr_attr_res_aptpl_metadata,
2230 TB_CIT_SETUP(dev_pr, NULL, NULL, target_core_dev_pr_attrs);
2232 /* End functions for struct config_item_type tb_dev_pr_cit */
2234 /* Start functions for struct config_item_type tb_dev_cit */
2236 static inline struct se_device *to_device(struct config_item *item)
2238 return container_of(to_config_group(item), struct se_device, dev_group);
2241 static ssize_t target_dev_info_show(struct config_item *item, char *page)
2243 struct se_device *dev = to_device(item);
2245 ssize_t read_bytes = 0;
2247 transport_dump_dev_state(dev, page, &bl);
2249 read_bytes += dev->transport->show_configfs_dev_params(dev,
2254 static ssize_t target_dev_control_store(struct config_item *item,
2255 const char *page, size_t count)
2257 struct se_device *dev = to_device(item);
2259 return dev->transport->set_configfs_dev_params(dev, page, count);
2262 static ssize_t target_dev_alias_show(struct config_item *item, char *page)
2264 struct se_device *dev = to_device(item);
2266 if (!(dev->dev_flags & DF_USING_ALIAS))
2269 return snprintf(page, PAGE_SIZE, "%s\n", dev->dev_alias);
2272 static ssize_t target_dev_alias_store(struct config_item *item,
2273 const char *page, size_t count)
2275 struct se_device *dev = to_device(item);
2276 struct se_hba *hba = dev->se_hba;
2279 if (count > (SE_DEV_ALIAS_LEN-1)) {
2280 pr_err("alias count: %d exceeds"
2281 " SE_DEV_ALIAS_LEN-1: %u\n", (int)count,
2282 SE_DEV_ALIAS_LEN-1);
2286 read_bytes = snprintf(&dev->dev_alias[0], SE_DEV_ALIAS_LEN, "%s", page);
2289 if (dev->dev_alias[read_bytes - 1] == '\n')
2290 dev->dev_alias[read_bytes - 1] = '\0';
2292 dev->dev_flags |= DF_USING_ALIAS;
2294 pr_debug("Target_Core_ConfigFS: %s/%s set alias: %s\n",
2295 config_item_name(&hba->hba_group.cg_item),
2296 config_item_name(&dev->dev_group.cg_item),
2302 static ssize_t target_dev_udev_path_show(struct config_item *item, char *page)
2304 struct se_device *dev = to_device(item);
2306 if (!(dev->dev_flags & DF_USING_UDEV_PATH))
2309 return snprintf(page, PAGE_SIZE, "%s\n", dev->udev_path);
2312 static ssize_t target_dev_udev_path_store(struct config_item *item,
2313 const char *page, size_t count)
2315 struct se_device *dev = to_device(item);
2316 struct se_hba *hba = dev->se_hba;
2319 if (count > (SE_UDEV_PATH_LEN-1)) {
2320 pr_err("udev_path count: %d exceeds"
2321 " SE_UDEV_PATH_LEN-1: %u\n", (int)count,
2322 SE_UDEV_PATH_LEN-1);
2326 read_bytes = snprintf(&dev->udev_path[0], SE_UDEV_PATH_LEN,
2330 if (dev->udev_path[read_bytes - 1] == '\n')
2331 dev->udev_path[read_bytes - 1] = '\0';
2333 dev->dev_flags |= DF_USING_UDEV_PATH;
2335 pr_debug("Target_Core_ConfigFS: %s/%s set udev_path: %s\n",
2336 config_item_name(&hba->hba_group.cg_item),
2337 config_item_name(&dev->dev_group.cg_item),
2343 static ssize_t target_dev_enable_show(struct config_item *item, char *page)
2345 struct se_device *dev = to_device(item);
2347 return snprintf(page, PAGE_SIZE, "%d\n", target_dev_configured(dev));
2350 static ssize_t target_dev_enable_store(struct config_item *item,
2351 const char *page, size_t count)
2353 struct se_device *dev = to_device(item);
2357 ptr = strstr(page, "1");
2359 pr_err("For dev_enable ops, only valid value"
2364 ret = target_configure_device(dev);
2370 static ssize_t target_dev_alua_lu_gp_show(struct config_item *item, char *page)
2372 struct se_device *dev = to_device(item);
2373 struct config_item *lu_ci;
2374 struct t10_alua_lu_gp *lu_gp;
2375 struct t10_alua_lu_gp_member *lu_gp_mem;
2378 lu_gp_mem = dev->dev_alua_lu_gp_mem;
2382 spin_lock(&lu_gp_mem->lu_gp_mem_lock);
2383 lu_gp = lu_gp_mem->lu_gp;
2385 lu_ci = &lu_gp->lu_gp_group.cg_item;
2386 len += sprintf(page, "LU Group Alias: %s\nLU Group ID: %hu\n",
2387 config_item_name(lu_ci), lu_gp->lu_gp_id);
2389 spin_unlock(&lu_gp_mem->lu_gp_mem_lock);
2394 static ssize_t target_dev_alua_lu_gp_store(struct config_item *item,
2395 const char *page, size_t count)
2397 struct se_device *dev = to_device(item);
2398 struct se_hba *hba = dev->se_hba;
2399 struct t10_alua_lu_gp *lu_gp = NULL, *lu_gp_new = NULL;
2400 struct t10_alua_lu_gp_member *lu_gp_mem;
2401 unsigned char buf[LU_GROUP_NAME_BUF] = { };
2404 lu_gp_mem = dev->dev_alua_lu_gp_mem;
2408 if (count > LU_GROUP_NAME_BUF) {
2409 pr_err("ALUA LU Group Alias too large!\n");
2412 memcpy(buf, page, count);
2414 * Any ALUA logical unit alias besides "NULL" means we will be
2415 * making a new group association.
2417 if (strcmp(strstrip(buf), "NULL")) {
2419 * core_alua_get_lu_gp_by_name() will increment reference to
2420 * struct t10_alua_lu_gp. This reference is released with
2421 * core_alua_get_lu_gp_by_name below().
2423 lu_gp_new = core_alua_get_lu_gp_by_name(strstrip(buf));
2428 spin_lock(&lu_gp_mem->lu_gp_mem_lock);
2429 lu_gp = lu_gp_mem->lu_gp;
2432 * Clearing an existing lu_gp association, and replacing
2436 pr_debug("Target_Core_ConfigFS: Releasing %s/%s"
2437 " from ALUA LU Group: core/alua/lu_gps/%s, ID:"
2439 config_item_name(&hba->hba_group.cg_item),
2440 config_item_name(&dev->dev_group.cg_item),
2441 config_item_name(&lu_gp->lu_gp_group.cg_item),
2444 __core_alua_drop_lu_gp_mem(lu_gp_mem, lu_gp);
2445 spin_unlock(&lu_gp_mem->lu_gp_mem_lock);
2450 * Removing existing association of lu_gp_mem with lu_gp
2452 __core_alua_drop_lu_gp_mem(lu_gp_mem, lu_gp);
2456 * Associate lu_gp_mem with lu_gp_new.
2458 __core_alua_attach_lu_gp_mem(lu_gp_mem, lu_gp_new);
2459 spin_unlock(&lu_gp_mem->lu_gp_mem_lock);
2461 pr_debug("Target_Core_ConfigFS: %s %s/%s to ALUA LU Group:"
2462 " core/alua/lu_gps/%s, ID: %hu\n",
2463 (move) ? "Moving" : "Adding",
2464 config_item_name(&hba->hba_group.cg_item),
2465 config_item_name(&dev->dev_group.cg_item),
2466 config_item_name(&lu_gp_new->lu_gp_group.cg_item),
2467 lu_gp_new->lu_gp_id);
2469 core_alua_put_lu_gp_from_name(lu_gp_new);
2473 static ssize_t target_dev_lba_map_show(struct config_item *item, char *page)
2475 struct se_device *dev = to_device(item);
2476 struct t10_alua_lba_map *map;
2477 struct t10_alua_lba_map_member *mem;
2482 spin_lock(&dev->t10_alua.lba_map_lock);
2483 if (!list_empty(&dev->t10_alua.lba_map_list))
2484 bl += sprintf(b + bl, "%u %u\n",
2485 dev->t10_alua.lba_map_segment_size,
2486 dev->t10_alua.lba_map_segment_multiplier);
2487 list_for_each_entry(map, &dev->t10_alua.lba_map_list, lba_map_list) {
2488 bl += sprintf(b + bl, "%llu %llu",
2489 map->lba_map_first_lba, map->lba_map_last_lba);
2490 list_for_each_entry(mem, &map->lba_map_mem_list,
2492 switch (mem->lba_map_mem_alua_state) {
2493 case ALUA_ACCESS_STATE_ACTIVE_OPTIMIZED:
2496 case ALUA_ACCESS_STATE_ACTIVE_NON_OPTIMIZED:
2499 case ALUA_ACCESS_STATE_STANDBY:
2502 case ALUA_ACCESS_STATE_UNAVAILABLE:
2509 bl += sprintf(b + bl, " %d:%c",
2510 mem->lba_map_mem_alua_pg_id, state);
2512 bl += sprintf(b + bl, "\n");
2514 spin_unlock(&dev->t10_alua.lba_map_lock);
2518 static ssize_t target_dev_lba_map_store(struct config_item *item,
2519 const char *page, size_t count)
2521 struct se_device *dev = to_device(item);
2522 struct t10_alua_lba_map *lba_map = NULL;
2523 struct list_head lba_list;
2524 char *map_entries, *orig, *ptr;
2526 int pg_num = -1, pg;
2527 int ret = 0, num = 0, pg_id, alua_state;
2528 unsigned long start_lba = -1, end_lba = -1;
2529 unsigned long segment_size = -1, segment_mult = -1;
2531 orig = map_entries = kstrdup(page, GFP_KERNEL);
2535 INIT_LIST_HEAD(&lba_list);
2536 while ((ptr = strsep(&map_entries, "\n")) != NULL) {
2541 if (sscanf(ptr, "%lu %lu\n",
2542 &segment_size, &segment_mult) != 2) {
2543 pr_err("Invalid line %d\n", num);
2550 if (sscanf(ptr, "%lu %lu", &start_lba, &end_lba) != 2) {
2551 pr_err("Invalid line %d\n", num);
2555 ptr = strchr(ptr, ' ');
2557 pr_err("Invalid line %d, missing end lba\n", num);
2562 ptr = strchr(ptr, ' ');
2564 pr_err("Invalid line %d, missing state definitions\n",
2570 lba_map = core_alua_allocate_lba_map(&lba_list,
2571 start_lba, end_lba);
2572 if (IS_ERR(lba_map)) {
2573 ret = PTR_ERR(lba_map);
2577 while (sscanf(ptr, "%d:%c", &pg_id, &state) == 2) {
2580 alua_state = ALUA_ACCESS_STATE_ACTIVE_OPTIMIZED;
2583 alua_state = ALUA_ACCESS_STATE_ACTIVE_NON_OPTIMIZED;
2586 alua_state = ALUA_ACCESS_STATE_STANDBY;
2589 alua_state = ALUA_ACCESS_STATE_UNAVAILABLE;
2592 pr_err("Invalid ALUA state '%c'\n", state);
2597 ret = core_alua_allocate_lba_map_mem(lba_map,
2600 pr_err("Invalid target descriptor %d:%c "
2606 ptr = strchr(ptr, ' ');
2614 else if (pg != pg_num) {
2615 pr_err("Only %d from %d port groups definitions "
2616 "at line %d\n", pg, pg_num, num);
2624 core_alua_free_lba_map(&lba_list);
2627 core_alua_set_lba_map(dev, &lba_list,
2628 segment_size, segment_mult);
2633 CONFIGFS_ATTR_RO(target_dev_, info);
2634 CONFIGFS_ATTR_WO(target_dev_, control);
2635 CONFIGFS_ATTR(target_dev_, alias);
2636 CONFIGFS_ATTR(target_dev_, udev_path);
2637 CONFIGFS_ATTR(target_dev_, enable);
2638 CONFIGFS_ATTR(target_dev_, alua_lu_gp);
2639 CONFIGFS_ATTR(target_dev_, lba_map);
2641 static struct configfs_attribute *target_core_dev_attrs[] = {
2642 &target_dev_attr_info,
2643 &target_dev_attr_control,
2644 &target_dev_attr_alias,
2645 &target_dev_attr_udev_path,
2646 &target_dev_attr_enable,
2647 &target_dev_attr_alua_lu_gp,
2648 &target_dev_attr_lba_map,
2652 static void target_core_dev_release(struct config_item *item)
2654 struct config_group *dev_cg = to_config_group(item);
2655 struct se_device *dev =
2656 container_of(dev_cg, struct se_device, dev_group);
2658 target_free_device(dev);
2662 * Used in target_core_fabric_configfs.c to verify valid se_device symlink
2663 * within target_fabric_port_link()
2665 struct configfs_item_operations target_core_dev_item_ops = {
2666 .release = target_core_dev_release,
2669 TB_CIT_SETUP(dev, &target_core_dev_item_ops, NULL, target_core_dev_attrs);
2671 /* End functions for struct config_item_type tb_dev_cit */
2673 /* Start functions for struct config_item_type target_core_alua_lu_gp_cit */
2675 static inline struct t10_alua_lu_gp *to_lu_gp(struct config_item *item)
2677 return container_of(to_config_group(item), struct t10_alua_lu_gp,
2681 static ssize_t target_lu_gp_lu_gp_id_show(struct config_item *item, char *page)
2683 struct t10_alua_lu_gp *lu_gp = to_lu_gp(item);
2685 if (!lu_gp->lu_gp_valid_id)
2687 return sprintf(page, "%hu\n", lu_gp->lu_gp_id);
2690 static ssize_t target_lu_gp_lu_gp_id_store(struct config_item *item,
2691 const char *page, size_t count)
2693 struct t10_alua_lu_gp *lu_gp = to_lu_gp(item);
2694 struct config_group *alua_lu_gp_cg = &lu_gp->lu_gp_group;
2695 unsigned long lu_gp_id;
2698 ret = kstrtoul(page, 0, &lu_gp_id);
2700 pr_err("kstrtoul() returned %d for"
2701 " lu_gp_id\n", ret);
2704 if (lu_gp_id > 0x0000ffff) {
2705 pr_err("ALUA lu_gp_id: %lu exceeds maximum:"
2706 " 0x0000ffff\n", lu_gp_id);
2710 ret = core_alua_set_lu_gp_id(lu_gp, (u16)lu_gp_id);
2714 pr_debug("Target_Core_ConfigFS: Set ALUA Logical Unit"
2715 " Group: core/alua/lu_gps/%s to ID: %hu\n",
2716 config_item_name(&alua_lu_gp_cg->cg_item),
2722 static ssize_t target_lu_gp_members_show(struct config_item *item, char *page)
2724 struct t10_alua_lu_gp *lu_gp = to_lu_gp(item);
2725 struct se_device *dev;
2727 struct t10_alua_lu_gp_member *lu_gp_mem;
2728 ssize_t len = 0, cur_len;
2729 unsigned char buf[LU_GROUP_NAME_BUF] = { };
2731 spin_lock(&lu_gp->lu_gp_lock);
2732 list_for_each_entry(lu_gp_mem, &lu_gp->lu_gp_mem_list, lu_gp_mem_list) {
2733 dev = lu_gp_mem->lu_gp_mem_dev;
2736 cur_len = snprintf(buf, LU_GROUP_NAME_BUF, "%s/%s\n",
2737 config_item_name(&hba->hba_group.cg_item),
2738 config_item_name(&dev->dev_group.cg_item));
2739 cur_len++; /* Extra byte for NULL terminator */
2741 if ((cur_len + len) > PAGE_SIZE) {
2742 pr_warn("Ran out of lu_gp_show_attr"
2743 "_members buffer\n");
2746 memcpy(page+len, buf, cur_len);
2749 spin_unlock(&lu_gp->lu_gp_lock);
2754 CONFIGFS_ATTR(target_lu_gp_, lu_gp_id);
2755 CONFIGFS_ATTR_RO(target_lu_gp_, members);
2757 static struct configfs_attribute *target_core_alua_lu_gp_attrs[] = {
2758 &target_lu_gp_attr_lu_gp_id,
2759 &target_lu_gp_attr_members,
2763 static void target_core_alua_lu_gp_release(struct config_item *item)
2765 struct t10_alua_lu_gp *lu_gp = container_of(to_config_group(item),
2766 struct t10_alua_lu_gp, lu_gp_group);
2768 core_alua_free_lu_gp(lu_gp);
2771 static struct configfs_item_operations target_core_alua_lu_gp_ops = {
2772 .release = target_core_alua_lu_gp_release,
2775 static const struct config_item_type target_core_alua_lu_gp_cit = {
2776 .ct_item_ops = &target_core_alua_lu_gp_ops,
2777 .ct_attrs = target_core_alua_lu_gp_attrs,
2778 .ct_owner = THIS_MODULE,
2781 /* End functions for struct config_item_type target_core_alua_lu_gp_cit */
2783 /* Start functions for struct config_item_type target_core_alua_lu_gps_cit */
2785 static struct config_group *target_core_alua_create_lu_gp(
2786 struct config_group *group,
2789 struct t10_alua_lu_gp *lu_gp;
2790 struct config_group *alua_lu_gp_cg = NULL;
2791 struct config_item *alua_lu_gp_ci = NULL;
2793 lu_gp = core_alua_allocate_lu_gp(name, 0);
2797 alua_lu_gp_cg = &lu_gp->lu_gp_group;
2798 alua_lu_gp_ci = &alua_lu_gp_cg->cg_item;
2800 config_group_init_type_name(alua_lu_gp_cg, name,
2801 &target_core_alua_lu_gp_cit);
2803 pr_debug("Target_Core_ConfigFS: Allocated ALUA Logical Unit"
2804 " Group: core/alua/lu_gps/%s\n",
2805 config_item_name(alua_lu_gp_ci));
2807 return alua_lu_gp_cg;
2811 static void target_core_alua_drop_lu_gp(
2812 struct config_group *group,
2813 struct config_item *item)
2815 struct t10_alua_lu_gp *lu_gp = container_of(to_config_group(item),
2816 struct t10_alua_lu_gp, lu_gp_group);
2818 pr_debug("Target_Core_ConfigFS: Releasing ALUA Logical Unit"
2819 " Group: core/alua/lu_gps/%s, ID: %hu\n",
2820 config_item_name(item), lu_gp->lu_gp_id);
2822 * core_alua_free_lu_gp() is called from target_core_alua_lu_gp_ops->release()
2823 * -> target_core_alua_lu_gp_release()
2825 config_item_put(item);
2828 static struct configfs_group_operations target_core_alua_lu_gps_group_ops = {
2829 .make_group = &target_core_alua_create_lu_gp,
2830 .drop_item = &target_core_alua_drop_lu_gp,
2833 static const struct config_item_type target_core_alua_lu_gps_cit = {
2834 .ct_item_ops = NULL,
2835 .ct_group_ops = &target_core_alua_lu_gps_group_ops,
2836 .ct_owner = THIS_MODULE,
2839 /* End functions for struct config_item_type target_core_alua_lu_gps_cit */
2841 /* Start functions for struct config_item_type target_core_alua_tg_pt_gp_cit */
2843 static inline struct t10_alua_tg_pt_gp *to_tg_pt_gp(struct config_item *item)
2845 return container_of(to_config_group(item), struct t10_alua_tg_pt_gp,
2849 static ssize_t target_tg_pt_gp_alua_access_state_show(struct config_item *item,
2852 return sprintf(page, "%d\n",
2853 to_tg_pt_gp(item)->tg_pt_gp_alua_access_state);
2856 static ssize_t target_tg_pt_gp_alua_access_state_store(struct config_item *item,
2857 const char *page, size_t count)
2859 struct t10_alua_tg_pt_gp *tg_pt_gp = to_tg_pt_gp(item);
2860 struct se_device *dev = tg_pt_gp->tg_pt_gp_dev;
2864 if (!tg_pt_gp->tg_pt_gp_valid_id) {
2865 pr_err("Unable to do implicit ALUA on invalid tg_pt_gp ID\n");
2868 if (!target_dev_configured(dev)) {
2869 pr_err("Unable to set alua_access_state while device is"
2870 " not configured\n");
2874 ret = kstrtoul(page, 0, &tmp);
2876 pr_err("Unable to extract new ALUA access state from"
2880 new_state = (int)tmp;
2882 if (!(tg_pt_gp->tg_pt_gp_alua_access_type & TPGS_IMPLICIT_ALUA)) {
2883 pr_err("Unable to process implicit configfs ALUA"
2884 " transition while TPGS_IMPLICIT_ALUA is disabled\n");
2887 if (tg_pt_gp->tg_pt_gp_alua_access_type & TPGS_EXPLICIT_ALUA &&
2888 new_state == ALUA_ACCESS_STATE_LBA_DEPENDENT) {
2889 /* LBA DEPENDENT is only allowed with implicit ALUA */
2890 pr_err("Unable to process implicit configfs ALUA transition"
2891 " while explicit ALUA management is enabled\n");
2895 ret = core_alua_do_port_transition(tg_pt_gp, dev,
2896 NULL, NULL, new_state, 0);
2897 return (!ret) ? count : -EINVAL;
2900 static ssize_t target_tg_pt_gp_alua_access_status_show(struct config_item *item,
2903 struct t10_alua_tg_pt_gp *tg_pt_gp = to_tg_pt_gp(item);
2904 return sprintf(page, "%s\n",
2905 core_alua_dump_status(tg_pt_gp->tg_pt_gp_alua_access_status));
2908 static ssize_t target_tg_pt_gp_alua_access_status_store(
2909 struct config_item *item, const char *page, size_t count)
2911 struct t10_alua_tg_pt_gp *tg_pt_gp = to_tg_pt_gp(item);
2913 int new_status, ret;
2915 if (!tg_pt_gp->tg_pt_gp_valid_id) {
2916 pr_err("Unable to set ALUA access status on invalid tg_pt_gp ID\n");
2920 ret = kstrtoul(page, 0, &tmp);
2922 pr_err("Unable to extract new ALUA access status"
2923 " from %s\n", page);
2926 new_status = (int)tmp;
2928 if ((new_status != ALUA_STATUS_NONE) &&
2929 (new_status != ALUA_STATUS_ALTERED_BY_EXPLICIT_STPG) &&
2930 (new_status != ALUA_STATUS_ALTERED_BY_IMPLICIT_ALUA)) {
2931 pr_err("Illegal ALUA access status: 0x%02x\n",
2936 tg_pt_gp->tg_pt_gp_alua_access_status = new_status;
2940 static ssize_t target_tg_pt_gp_alua_access_type_show(struct config_item *item,
2943 return core_alua_show_access_type(to_tg_pt_gp(item), page);
2946 static ssize_t target_tg_pt_gp_alua_access_type_store(struct config_item *item,
2947 const char *page, size_t count)
2949 return core_alua_store_access_type(to_tg_pt_gp(item), page, count);
2952 #define ALUA_SUPPORTED_STATE_ATTR(_name, _bit) \
2953 static ssize_t target_tg_pt_gp_alua_support_##_name##_show( \
2954 struct config_item *item, char *p) \
2956 struct t10_alua_tg_pt_gp *t = to_tg_pt_gp(item); \
2957 return sprintf(p, "%d\n", \
2958 !!(t->tg_pt_gp_alua_supported_states & _bit)); \
2961 static ssize_t target_tg_pt_gp_alua_support_##_name##_store( \
2962 struct config_item *item, const char *p, size_t c) \
2964 struct t10_alua_tg_pt_gp *t = to_tg_pt_gp(item); \
2965 unsigned long tmp; \
2968 if (!t->tg_pt_gp_valid_id) { \
2969 pr_err("Unable to set " #_name " ALUA state on invalid tg_pt_gp ID\n"); \
2973 ret = kstrtoul(p, 0, &tmp); \
2975 pr_err("Invalid value '%s', must be '0' or '1'\n", p); \
2979 pr_err("Invalid value '%ld', must be '0' or '1'\n", tmp); \
2983 t->tg_pt_gp_alua_supported_states |= _bit; \
2985 t->tg_pt_gp_alua_supported_states &= ~_bit; \
2990 ALUA_SUPPORTED_STATE_ATTR(transitioning, ALUA_T_SUP);
2991 ALUA_SUPPORTED_STATE_ATTR(offline, ALUA_O_SUP);
2992 ALUA_SUPPORTED_STATE_ATTR(lba_dependent, ALUA_LBD_SUP);
2993 ALUA_SUPPORTED_STATE_ATTR(unavailable, ALUA_U_SUP);
2994 ALUA_SUPPORTED_STATE_ATTR(standby, ALUA_S_SUP);
2995 ALUA_SUPPORTED_STATE_ATTR(active_optimized, ALUA_AO_SUP);
2996 ALUA_SUPPORTED_STATE_ATTR(active_nonoptimized, ALUA_AN_SUP);
2998 static ssize_t target_tg_pt_gp_alua_write_metadata_show(
2999 struct config_item *item, char *page)
3001 return sprintf(page, "%d\n",
3002 to_tg_pt_gp(item)->tg_pt_gp_write_metadata);
3005 static ssize_t target_tg_pt_gp_alua_write_metadata_store(
3006 struct config_item *item, const char *page, size_t count)
3008 struct t10_alua_tg_pt_gp *tg_pt_gp = to_tg_pt_gp(item);
3012 ret = kstrtoul(page, 0, &tmp);
3014 pr_err("Unable to extract alua_write_metadata\n");
3018 if ((tmp != 0) && (tmp != 1)) {
3019 pr_err("Illegal value for alua_write_metadata:"
3023 tg_pt_gp->tg_pt_gp_write_metadata = (int)tmp;
3028 static ssize_t target_tg_pt_gp_nonop_delay_msecs_show(struct config_item *item,
3031 return core_alua_show_nonop_delay_msecs(to_tg_pt_gp(item), page);
3034 static ssize_t target_tg_pt_gp_nonop_delay_msecs_store(struct config_item *item,
3035 const char *page, size_t count)
3037 return core_alua_store_nonop_delay_msecs(to_tg_pt_gp(item), page,
3041 static ssize_t target_tg_pt_gp_trans_delay_msecs_show(struct config_item *item,
3044 return core_alua_show_trans_delay_msecs(to_tg_pt_gp(item), page);
3047 static ssize_t target_tg_pt_gp_trans_delay_msecs_store(struct config_item *item,
3048 const char *page, size_t count)
3050 return core_alua_store_trans_delay_msecs(to_tg_pt_gp(item), page,
3054 static ssize_t target_tg_pt_gp_implicit_trans_secs_show(
3055 struct config_item *item, char *page)
3057 return core_alua_show_implicit_trans_secs(to_tg_pt_gp(item), page);
3060 static ssize_t target_tg_pt_gp_implicit_trans_secs_store(
3061 struct config_item *item, const char *page, size_t count)
3063 return core_alua_store_implicit_trans_secs(to_tg_pt_gp(item), page,
3067 static ssize_t target_tg_pt_gp_preferred_show(struct config_item *item,
3070 return core_alua_show_preferred_bit(to_tg_pt_gp(item), page);
3073 static ssize_t target_tg_pt_gp_preferred_store(struct config_item *item,
3074 const char *page, size_t count)
3076 return core_alua_store_preferred_bit(to_tg_pt_gp(item), page, count);
3079 static ssize_t target_tg_pt_gp_tg_pt_gp_id_show(struct config_item *item,
3082 struct t10_alua_tg_pt_gp *tg_pt_gp = to_tg_pt_gp(item);
3084 if (!tg_pt_gp->tg_pt_gp_valid_id)
3086 return sprintf(page, "%hu\n", tg_pt_gp->tg_pt_gp_id);
3089 static ssize_t target_tg_pt_gp_tg_pt_gp_id_store(struct config_item *item,
3090 const char *page, size_t count)
3092 struct t10_alua_tg_pt_gp *tg_pt_gp = to_tg_pt_gp(item);
3093 struct config_group *alua_tg_pt_gp_cg = &tg_pt_gp->tg_pt_gp_group;
3094 unsigned long tg_pt_gp_id;
3097 ret = kstrtoul(page, 0, &tg_pt_gp_id);
3099 pr_err("ALUA tg_pt_gp_id: invalid value '%s' for tg_pt_gp_id\n",
3103 if (tg_pt_gp_id > 0x0000ffff) {
3104 pr_err("ALUA tg_pt_gp_id: %lu exceeds maximum: 0x0000ffff\n",
3109 ret = core_alua_set_tg_pt_gp_id(tg_pt_gp, (u16)tg_pt_gp_id);
3113 pr_debug("Target_Core_ConfigFS: Set ALUA Target Port Group: "
3114 "core/alua/tg_pt_gps/%s to ID: %hu\n",
3115 config_item_name(&alua_tg_pt_gp_cg->cg_item),
3116 tg_pt_gp->tg_pt_gp_id);
3121 static ssize_t target_tg_pt_gp_members_show(struct config_item *item,
3124 struct t10_alua_tg_pt_gp *tg_pt_gp = to_tg_pt_gp(item);
3126 ssize_t len = 0, cur_len;
3127 unsigned char buf[TG_PT_GROUP_NAME_BUF] = { };
3129 spin_lock(&tg_pt_gp->tg_pt_gp_lock);
3130 list_for_each_entry(lun, &tg_pt_gp->tg_pt_gp_lun_list,
3131 lun_tg_pt_gp_link) {
3132 struct se_portal_group *tpg = lun->lun_tpg;
3134 cur_len = snprintf(buf, TG_PT_GROUP_NAME_BUF, "%s/%s/tpgt_%hu"
3135 "/%s\n", tpg->se_tpg_tfo->fabric_name,
3136 tpg->se_tpg_tfo->tpg_get_wwn(tpg),
3137 tpg->se_tpg_tfo->tpg_get_tag(tpg),
3138 config_item_name(&lun->lun_group.cg_item));
3139 cur_len++; /* Extra byte for NULL terminator */
3141 if ((cur_len + len) > PAGE_SIZE) {
3142 pr_warn("Ran out of lu_gp_show_attr"
3143 "_members buffer\n");
3146 memcpy(page+len, buf, cur_len);
3149 spin_unlock(&tg_pt_gp->tg_pt_gp_lock);
3154 CONFIGFS_ATTR(target_tg_pt_gp_, alua_access_state);
3155 CONFIGFS_ATTR(target_tg_pt_gp_, alua_access_status);
3156 CONFIGFS_ATTR(target_tg_pt_gp_, alua_access_type);
3157 CONFIGFS_ATTR(target_tg_pt_gp_, alua_support_transitioning);
3158 CONFIGFS_ATTR(target_tg_pt_gp_, alua_support_offline);
3159 CONFIGFS_ATTR(target_tg_pt_gp_, alua_support_lba_dependent);
3160 CONFIGFS_ATTR(target_tg_pt_gp_, alua_support_unavailable);
3161 CONFIGFS_ATTR(target_tg_pt_gp_, alua_support_standby);
3162 CONFIGFS_ATTR(target_tg_pt_gp_, alua_support_active_optimized);
3163 CONFIGFS_ATTR(target_tg_pt_gp_, alua_support_active_nonoptimized);
3164 CONFIGFS_ATTR(target_tg_pt_gp_, alua_write_metadata);
3165 CONFIGFS_ATTR(target_tg_pt_gp_, nonop_delay_msecs);
3166 CONFIGFS_ATTR(target_tg_pt_gp_, trans_delay_msecs);
3167 CONFIGFS_ATTR(target_tg_pt_gp_, implicit_trans_secs);
3168 CONFIGFS_ATTR(target_tg_pt_gp_, preferred);
3169 CONFIGFS_ATTR(target_tg_pt_gp_, tg_pt_gp_id);
3170 CONFIGFS_ATTR_RO(target_tg_pt_gp_, members);
3172 static struct configfs_attribute *target_core_alua_tg_pt_gp_attrs[] = {
3173 &target_tg_pt_gp_attr_alua_access_state,
3174 &target_tg_pt_gp_attr_alua_access_status,
3175 &target_tg_pt_gp_attr_alua_access_type,
3176 &target_tg_pt_gp_attr_alua_support_transitioning,
3177 &target_tg_pt_gp_attr_alua_support_offline,
3178 &target_tg_pt_gp_attr_alua_support_lba_dependent,
3179 &target_tg_pt_gp_attr_alua_support_unavailable,
3180 &target_tg_pt_gp_attr_alua_support_standby,
3181 &target_tg_pt_gp_attr_alua_support_active_nonoptimized,
3182 &target_tg_pt_gp_attr_alua_support_active_optimized,
3183 &target_tg_pt_gp_attr_alua_write_metadata,
3184 &target_tg_pt_gp_attr_nonop_delay_msecs,
3185 &target_tg_pt_gp_attr_trans_delay_msecs,
3186 &target_tg_pt_gp_attr_implicit_trans_secs,
3187 &target_tg_pt_gp_attr_preferred,
3188 &target_tg_pt_gp_attr_tg_pt_gp_id,
3189 &target_tg_pt_gp_attr_members,
3193 static void target_core_alua_tg_pt_gp_release(struct config_item *item)
3195 struct t10_alua_tg_pt_gp *tg_pt_gp = container_of(to_config_group(item),
3196 struct t10_alua_tg_pt_gp, tg_pt_gp_group);
3198 core_alua_free_tg_pt_gp(tg_pt_gp);
3201 static struct configfs_item_operations target_core_alua_tg_pt_gp_ops = {
3202 .release = target_core_alua_tg_pt_gp_release,
3205 static const struct config_item_type target_core_alua_tg_pt_gp_cit = {
3206 .ct_item_ops = &target_core_alua_tg_pt_gp_ops,
3207 .ct_attrs = target_core_alua_tg_pt_gp_attrs,
3208 .ct_owner = THIS_MODULE,
3211 /* End functions for struct config_item_type target_core_alua_tg_pt_gp_cit */
3213 /* Start functions for struct config_item_type tb_alua_tg_pt_gps_cit */
3215 static struct config_group *target_core_alua_create_tg_pt_gp(
3216 struct config_group *group,
3219 struct t10_alua *alua = container_of(group, struct t10_alua,
3220 alua_tg_pt_gps_group);
3221 struct t10_alua_tg_pt_gp *tg_pt_gp;
3222 struct config_group *alua_tg_pt_gp_cg = NULL;
3223 struct config_item *alua_tg_pt_gp_ci = NULL;
3225 tg_pt_gp = core_alua_allocate_tg_pt_gp(alua->t10_dev, name, 0);
3229 alua_tg_pt_gp_cg = &tg_pt_gp->tg_pt_gp_group;
3230 alua_tg_pt_gp_ci = &alua_tg_pt_gp_cg->cg_item;
3232 config_group_init_type_name(alua_tg_pt_gp_cg, name,
3233 &target_core_alua_tg_pt_gp_cit);
3235 pr_debug("Target_Core_ConfigFS: Allocated ALUA Target Port"
3236 " Group: alua/tg_pt_gps/%s\n",
3237 config_item_name(alua_tg_pt_gp_ci));
3239 return alua_tg_pt_gp_cg;
3242 static void target_core_alua_drop_tg_pt_gp(
3243 struct config_group *group,
3244 struct config_item *item)
3246 struct t10_alua_tg_pt_gp *tg_pt_gp = container_of(to_config_group(item),
3247 struct t10_alua_tg_pt_gp, tg_pt_gp_group);
3249 pr_debug("Target_Core_ConfigFS: Releasing ALUA Target Port"
3250 " Group: alua/tg_pt_gps/%s, ID: %hu\n",
3251 config_item_name(item), tg_pt_gp->tg_pt_gp_id);
3253 * core_alua_free_tg_pt_gp() is called from target_core_alua_tg_pt_gp_ops->release()
3254 * -> target_core_alua_tg_pt_gp_release().
3256 config_item_put(item);
3259 static struct configfs_group_operations target_core_alua_tg_pt_gps_group_ops = {
3260 .make_group = &target_core_alua_create_tg_pt_gp,
3261 .drop_item = &target_core_alua_drop_tg_pt_gp,
3264 TB_CIT_SETUP(dev_alua_tg_pt_gps, NULL, &target_core_alua_tg_pt_gps_group_ops, NULL);
3266 /* End functions for struct config_item_type tb_alua_tg_pt_gps_cit */
3268 /* Start functions for struct config_item_type target_core_alua_cit */
3271 * target_core_alua_cit is a ConfigFS group that lives under
3272 * /sys/kernel/config/target/core/alua. There are default groups
3273 * core/alua/lu_gps and core/alua/tg_pt_gps that are attached to
3274 * target_core_alua_cit in target_core_init_configfs() below.
3276 static const struct config_item_type target_core_alua_cit = {
3277 .ct_item_ops = NULL,
3279 .ct_owner = THIS_MODULE,
3282 /* End functions for struct config_item_type target_core_alua_cit */
3284 /* Start functions for struct config_item_type tb_dev_stat_cit */
3286 static struct config_group *target_core_stat_mkdir(
3287 struct config_group *group,
3290 return ERR_PTR(-ENOSYS);
3293 static void target_core_stat_rmdir(
3294 struct config_group *group,
3295 struct config_item *item)
3300 static struct configfs_group_operations target_core_stat_group_ops = {
3301 .make_group = &target_core_stat_mkdir,
3302 .drop_item = &target_core_stat_rmdir,
3305 TB_CIT_SETUP(dev_stat, NULL, &target_core_stat_group_ops, NULL);
3307 /* End functions for struct config_item_type tb_dev_stat_cit */
3309 /* Start functions for struct config_item_type target_core_hba_cit */
3311 static struct config_group *target_core_make_subdev(
3312 struct config_group *group,
3315 struct t10_alua_tg_pt_gp *tg_pt_gp;
3316 struct config_item *hba_ci = &group->cg_item;
3317 struct se_hba *hba = item_to_hba(hba_ci);
3318 struct target_backend *tb = hba->backend;
3319 struct se_device *dev;
3320 int errno = -ENOMEM, ret;
3322 ret = mutex_lock_interruptible(&hba->hba_access_mutex);
3324 return ERR_PTR(ret);
3326 dev = target_alloc_device(hba, name);
3330 config_group_init_type_name(&dev->dev_group, name, &tb->tb_dev_cit);
3332 config_group_init_type_name(&dev->dev_action_group, "action",
3333 &tb->tb_dev_action_cit);
3334 configfs_add_default_group(&dev->dev_action_group, &dev->dev_group);
3336 config_group_init_type_name(&dev->dev_attrib.da_group, "attrib",
3337 &tb->tb_dev_attrib_cit);
3338 configfs_add_default_group(&dev->dev_attrib.da_group, &dev->dev_group);
3340 config_group_init_type_name(&dev->dev_pr_group, "pr",
3341 &tb->tb_dev_pr_cit);
3342 configfs_add_default_group(&dev->dev_pr_group, &dev->dev_group);
3344 config_group_init_type_name(&dev->t10_wwn.t10_wwn_group, "wwn",
3345 &tb->tb_dev_wwn_cit);
3346 configfs_add_default_group(&dev->t10_wwn.t10_wwn_group,
3349 config_group_init_type_name(&dev->t10_alua.alua_tg_pt_gps_group,
3350 "alua", &tb->tb_dev_alua_tg_pt_gps_cit);
3351 configfs_add_default_group(&dev->t10_alua.alua_tg_pt_gps_group,
3354 config_group_init_type_name(&dev->dev_stat_grps.stat_group,
3355 "statistics", &tb->tb_dev_stat_cit);
3356 configfs_add_default_group(&dev->dev_stat_grps.stat_group,
3360 * Add core/$HBA/$DEV/alua/default_tg_pt_gp
3362 tg_pt_gp = core_alua_allocate_tg_pt_gp(dev, "default_tg_pt_gp", 1);
3364 goto out_free_device;
3365 dev->t10_alua.default_tg_pt_gp = tg_pt_gp;
3367 config_group_init_type_name(&tg_pt_gp->tg_pt_gp_group,
3368 "default_tg_pt_gp", &target_core_alua_tg_pt_gp_cit);
3369 configfs_add_default_group(&tg_pt_gp->tg_pt_gp_group,
3370 &dev->t10_alua.alua_tg_pt_gps_group);
3373 * Add core/$HBA/$DEV/statistics/ default groups
3375 target_stat_setup_dev_default_groups(dev);
3377 mutex_lock(&target_devices_lock);
3379 mutex_unlock(&target_devices_lock);
3381 mutex_unlock(&hba->hba_access_mutex);
3382 return &dev->dev_group;
3385 target_free_device(dev);
3387 mutex_unlock(&hba->hba_access_mutex);
3388 return ERR_PTR(errno);
3391 static void target_core_drop_subdev(
3392 struct config_group *group,
3393 struct config_item *item)
3395 struct config_group *dev_cg = to_config_group(item);
3396 struct se_device *dev =
3397 container_of(dev_cg, struct se_device, dev_group);
3400 hba = item_to_hba(&dev->se_hba->hba_group.cg_item);
3402 mutex_lock(&hba->hba_access_mutex);
3404 configfs_remove_default_groups(&dev->dev_stat_grps.stat_group);
3405 configfs_remove_default_groups(&dev->t10_alua.alua_tg_pt_gps_group);
3408 * core_alua_free_tg_pt_gp() is called from ->default_tg_pt_gp
3409 * directly from target_core_alua_tg_pt_gp_release().
3411 dev->t10_alua.default_tg_pt_gp = NULL;
3413 configfs_remove_default_groups(dev_cg);
3416 * se_dev is released from target_core_dev_item_ops->release()
3418 config_item_put(item);
3420 mutex_lock(&target_devices_lock);
3422 mutex_unlock(&target_devices_lock);
3424 mutex_unlock(&hba->hba_access_mutex);
3427 static struct configfs_group_operations target_core_hba_group_ops = {
3428 .make_group = target_core_make_subdev,
3429 .drop_item = target_core_drop_subdev,
3433 static inline struct se_hba *to_hba(struct config_item *item)
3435 return container_of(to_config_group(item), struct se_hba, hba_group);
3438 static ssize_t target_hba_info_show(struct config_item *item, char *page)
3440 struct se_hba *hba = to_hba(item);
3442 return sprintf(page, "HBA Index: %d plugin: %s version: %s\n",
3443 hba->hba_id, hba->backend->ops->name,
3444 TARGET_CORE_VERSION);
3447 static ssize_t target_hba_mode_show(struct config_item *item, char *page)
3449 struct se_hba *hba = to_hba(item);
3452 if (hba->hba_flags & HBA_FLAGS_PSCSI_MODE)
3455 return sprintf(page, "%d\n", hba_mode);
3458 static ssize_t target_hba_mode_store(struct config_item *item,
3459 const char *page, size_t count)
3461 struct se_hba *hba = to_hba(item);
3462 unsigned long mode_flag;
3465 if (hba->backend->ops->pmode_enable_hba == NULL)
3468 ret = kstrtoul(page, 0, &mode_flag);
3470 pr_err("Unable to extract hba mode flag: %d\n", ret);
3474 if (hba->dev_count) {
3475 pr_err("Unable to set hba_mode with active devices\n");
3479 ret = hba->backend->ops->pmode_enable_hba(hba, mode_flag);
3483 hba->hba_flags |= HBA_FLAGS_PSCSI_MODE;
3485 hba->hba_flags &= ~HBA_FLAGS_PSCSI_MODE;
3490 CONFIGFS_ATTR_RO(target_, hba_info);
3491 CONFIGFS_ATTR(target_, hba_mode);
3493 static void target_core_hba_release(struct config_item *item)
3495 struct se_hba *hba = container_of(to_config_group(item),
3496 struct se_hba, hba_group);
3497 core_delete_hba(hba);
3500 static struct configfs_attribute *target_core_hba_attrs[] = {
3501 &target_attr_hba_info,
3502 &target_attr_hba_mode,
3506 static struct configfs_item_operations target_core_hba_item_ops = {
3507 .release = target_core_hba_release,
3510 static const struct config_item_type target_core_hba_cit = {
3511 .ct_item_ops = &target_core_hba_item_ops,
3512 .ct_group_ops = &target_core_hba_group_ops,
3513 .ct_attrs = target_core_hba_attrs,
3514 .ct_owner = THIS_MODULE,
3517 static struct config_group *target_core_call_addhbatotarget(
3518 struct config_group *group,
3521 char *se_plugin_str, *str, *str2;
3523 char buf[TARGET_CORE_NAME_MAX_LEN] = { };
3524 unsigned long plugin_dep_id = 0;
3527 if (strlen(name) >= TARGET_CORE_NAME_MAX_LEN) {
3528 pr_err("Passed *name strlen(): %d exceeds"
3529 " TARGET_CORE_NAME_MAX_LEN: %d\n", (int)strlen(name),
3530 TARGET_CORE_NAME_MAX_LEN);
3531 return ERR_PTR(-ENAMETOOLONG);
3533 snprintf(buf, TARGET_CORE_NAME_MAX_LEN, "%s", name);
3535 str = strstr(buf, "_");
3537 pr_err("Unable to locate \"_\" for $SUBSYSTEM_PLUGIN_$HOST_ID\n");
3538 return ERR_PTR(-EINVAL);
3540 se_plugin_str = buf;
3542 * Special case for subsystem plugins that have "_" in their names.
3543 * Namely rd_direct and rd_mcp..
3545 str2 = strstr(str+1, "_");
3547 *str2 = '\0'; /* Terminate for *se_plugin_str */
3548 str2++; /* Skip to start of plugin dependent ID */
3551 *str = '\0'; /* Terminate for *se_plugin_str */
3552 str++; /* Skip to start of plugin dependent ID */
3555 ret = kstrtoul(str, 0, &plugin_dep_id);
3557 pr_err("kstrtoul() returned %d for"
3558 " plugin_dep_id\n", ret);
3559 return ERR_PTR(ret);
3562 * Load up TCM subsystem plugins if they have not already been loaded.
3564 transport_subsystem_check_init();
3566 hba = core_alloc_hba(se_plugin_str, plugin_dep_id, 0);
3568 return ERR_CAST(hba);
3570 config_group_init_type_name(&hba->hba_group, name,
3571 &target_core_hba_cit);
3573 return &hba->hba_group;
3576 static void target_core_call_delhbafromtarget(
3577 struct config_group *group,
3578 struct config_item *item)
3581 * core_delete_hba() is called from target_core_hba_item_ops->release()
3582 * -> target_core_hba_release()
3584 config_item_put(item);
3587 static struct configfs_group_operations target_core_group_ops = {
3588 .make_group = target_core_call_addhbatotarget,
3589 .drop_item = target_core_call_delhbafromtarget,
3592 static const struct config_item_type target_core_cit = {
3593 .ct_item_ops = NULL,
3594 .ct_group_ops = &target_core_group_ops,
3596 .ct_owner = THIS_MODULE,
3599 /* Stop functions for struct config_item_type target_core_hba_cit */
3601 void target_setup_backend_cits(struct target_backend *tb)
3603 target_core_setup_dev_cit(tb);
3604 target_core_setup_dev_action_cit(tb);
3605 target_core_setup_dev_attrib_cit(tb);
3606 target_core_setup_dev_pr_cit(tb);
3607 target_core_setup_dev_wwn_cit(tb);
3608 target_core_setup_dev_alua_tg_pt_gps_cit(tb);
3609 target_core_setup_dev_stat_cit(tb);
3612 static void target_init_dbroot(void)
3616 snprintf(db_root_stage, DB_ROOT_LEN, DB_ROOT_PREFERRED);
3617 fp = filp_open(db_root_stage, O_RDONLY, 0);
3619 pr_err("db_root: cannot open: %s\n", db_root_stage);
3622 if (!S_ISDIR(file_inode(fp)->i_mode)) {
3623 filp_close(fp, NULL);
3624 pr_err("db_root: not a valid directory: %s\n", db_root_stage);
3627 filp_close(fp, NULL);
3629 strncpy(db_root, db_root_stage, DB_ROOT_LEN);
3630 pr_debug("Target_Core_ConfigFS: db_root set to %s\n", db_root);
3633 static int __init target_core_init_configfs(void)
3635 struct configfs_subsystem *subsys = &target_core_fabrics;
3636 struct t10_alua_lu_gp *lu_gp;
3639 pr_debug("TARGET_CORE[0]: Loading Generic Kernel Storage"
3640 " Engine: %s on %s/%s on "UTS_RELEASE"\n",
3641 TARGET_CORE_VERSION, utsname()->sysname, utsname()->machine);
3643 config_group_init(&subsys->su_group);
3644 mutex_init(&subsys->su_mutex);
3646 ret = init_se_kmem_caches();
3650 * Create $CONFIGFS/target/core default group for HBA <-> Storage Object
3651 * and ALUA Logical Unit Group and Target Port Group infrastructure.
3653 config_group_init_type_name(&target_core_hbagroup, "core",
3655 configfs_add_default_group(&target_core_hbagroup, &subsys->su_group);
3658 * Create ALUA infrastructure under /sys/kernel/config/target/core/alua/
3660 config_group_init_type_name(&alua_group, "alua", &target_core_alua_cit);
3661 configfs_add_default_group(&alua_group, &target_core_hbagroup);
3664 * Add ALUA Logical Unit Group and Target Port Group ConfigFS
3665 * groups under /sys/kernel/config/target/core/alua/
3667 config_group_init_type_name(&alua_lu_gps_group, "lu_gps",
3668 &target_core_alua_lu_gps_cit);
3669 configfs_add_default_group(&alua_lu_gps_group, &alua_group);
3672 * Add core/alua/lu_gps/default_lu_gp
3674 lu_gp = core_alua_allocate_lu_gp("default_lu_gp", 1);
3675 if (IS_ERR(lu_gp)) {
3680 config_group_init_type_name(&lu_gp->lu_gp_group, "default_lu_gp",
3681 &target_core_alua_lu_gp_cit);
3682 configfs_add_default_group(&lu_gp->lu_gp_group, &alua_lu_gps_group);
3684 default_lu_gp = lu_gp;
3687 * Register the target_core_mod subsystem with configfs.
3689 ret = configfs_register_subsystem(subsys);
3691 pr_err("Error %d while registering subsystem %s\n",
3692 ret, subsys->su_group.cg_item.ci_namebuf);
3695 pr_debug("TARGET_CORE[0]: Initialized ConfigFS Fabric"
3696 " Infrastructure: "TARGET_CORE_VERSION" on %s/%s"
3697 " on "UTS_RELEASE"\n", utsname()->sysname, utsname()->machine);
3699 * Register built-in RAMDISK subsystem logic for virtual LUN 0
3701 ret = rd_module_init();
3705 ret = core_dev_setup_virtual_lun0();
3709 ret = target_xcopy_setup_pt();
3713 target_init_dbroot();
3718 configfs_unregister_subsystem(subsys);
3719 core_dev_release_virtual_lun0();
3722 if (default_lu_gp) {
3723 core_alua_free_lu_gp(default_lu_gp);
3724 default_lu_gp = NULL;
3726 release_se_kmem_caches();
3730 static void __exit target_core_exit_configfs(void)
3732 configfs_remove_default_groups(&alua_lu_gps_group);
3733 configfs_remove_default_groups(&alua_group);
3734 configfs_remove_default_groups(&target_core_hbagroup);
3737 * We expect subsys->su_group.default_groups to be released
3738 * by configfs subsystem provider logic..
3740 configfs_unregister_subsystem(&target_core_fabrics);
3742 core_alua_free_lu_gp(default_lu_gp);
3743 default_lu_gp = NULL;
3745 pr_debug("TARGET_CORE[0]: Released ConfigFS Fabric"
3746 " Infrastructure\n");
3748 core_dev_release_virtual_lun0();
3750 target_xcopy_release_pt();
3751 release_se_kmem_caches();
3754 MODULE_DESCRIPTION("Target_Core_Mod/ConfigFS");
3755 MODULE_AUTHOR("nab@Linux-iSCSI.org");
3756 MODULE_LICENSE("GPL");
3758 module_init(target_core_init_configfs);
3759 module_exit(target_core_exit_configfs);