drivers/target/target_core_tpg.c

   1 /*******************************************************************************
   2  * Filename:  target_core_tpg.c
   3  *
   4  * This file contains generic Target Portal Group related functions.
   5  *
   6  * (c) Copyright 2002-2013 Datera, Inc.
   7  *
   8  * Nicholas A. Bellinger <nab@kernel.org>
   9  *
  10  * This program is free software; you can redistribute it and/or modify
  11  * it under the terms of the GNU General Public License as published by
  12  * the Free Software Foundation; either version 2 of the License, or
  13  * (at your option) any later version.
  14  *
  15  * This program is distributed in the hope that it will be useful,
  16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18  * GNU General Public License for more details.
  19  *
  20  * You should have received a copy of the GNU General Public License
  21  * along with this program; if not, write to the Free Software
  22  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  23  *
  24  ******************************************************************************/
  25
  26 #include <linux/net.h>
  27 #include <linux/string.h>
  28 #include <linux/timer.h>
  29 #include <linux/slab.h>
  30 #include <linux/spinlock.h>
  31 #include <linux/in.h>
  32 #include <linux/export.h>
  33 #include <net/sock.h>
  34 #include <net/tcp.h>
  35 #include <scsi/scsi_proto.h>
  36
  37 #include <target/target_core_base.h>
  38 #include <target/target_core_backend.h>
  39 #include <target/target_core_fabric.h>
  40
  41 #include "target_core_internal.h"
  42 #include "target_core_alua.h"
  43 #include "target_core_pr.h"
  44 #include "target_core_ua.h"
  45
  46 extern struct se_device *g_lun0_dev;
  47
  48 static DEFINE_SPINLOCK(tpg_lock);
  49 static LIST_HEAD(tpg_list);
  50
  51 /*      __core_tpg_get_initiator_node_acl():
  52  *
  53  *      mutex_lock(&tpg->acl_node_mutex); must be held when calling
  54  */
  55 struct se_node_acl *__core_tpg_get_initiator_node_acl(
  56         struct se_portal_group *tpg,
  57         const char *initiatorname)
  58 {
  59         struct se_node_acl *acl;
  60
  61         list_for_each_entry(acl, &tpg->acl_node_list, acl_list) {
  62                 if (!strcmp(acl->initiatorname, initiatorname))
  63                         return acl;
  64         }
  65
  66         return NULL;
  67 }
  68
  69 /*      core_tpg_get_initiator_node_acl():
  70  *
  71  *
  72  */
  73 struct se_node_acl *core_tpg_get_initiator_node_acl(
  74         struct se_portal_group *tpg,
  75         unsigned char *initiatorname)
  76 {
  77         struct se_node_acl *acl;
  78         /*
  79          * Obtain se_node_acl->acl_kref using fabric driver provided
  80          * initiatorname[] during node acl endpoint lookup driven by
  81          * new se_session login.
  82          *
  83          * The reference is held until se_session shutdown -> release
  84          * occurs via fabric driver invoked transport_deregister_session()
  85          * or transport_free_session() code.
  86          */
  87         mutex_lock(&tpg->acl_node_mutex);
  88         acl = __core_tpg_get_initiator_node_acl(tpg, initiatorname);
  89         if (acl) {
  90                 if (!kref_get_unless_zero(&acl->acl_kref))
  91                         acl = NULL;
  92         }
  93         mutex_unlock(&tpg->acl_node_mutex);
  94
  95         return acl;
  96 }
  97 EXPORT_SYMBOL(core_tpg_get_initiator_node_acl);
  98
  99 void core_allocate_nexus_loss_ua(
 100         struct se_node_acl *nacl)
 101 {
 102         struct se_dev_entry *deve;
 103
 104         if (!nacl)
 105                 return;
 106
 107         rcu_read_lock();
 108         hlist_for_each_entry_rcu(deve, &nacl->lun_entry_hlist, link)
 109                 core_scsi3_ua_allocate(deve, 0x29,
 110                         ASCQ_29H_NEXUS_LOSS_OCCURRED);
 111         rcu_read_unlock();
 112 }
 113 EXPORT_SYMBOL(core_allocate_nexus_loss_ua);
 114
 115 /*      core_tpg_add_node_to_devs():
 116  *
 117  *
 118  */
 119 void core_tpg_add_node_to_devs(
 120         struct se_node_acl *acl,
 121         struct se_portal_group *tpg,
 122         struct se_lun *lun_orig)
 123 {
 124         bool lun_access_ro = true;
 125         struct se_lun *lun;
 126         struct se_device *dev;
 127
 128         mutex_lock(&tpg->tpg_lun_mutex);
 129         hlist_for_each_entry_rcu(lun, &tpg->tpg_lun_hlist, link) {
 130                 if (lun_orig && lun != lun_orig)
 131                         continue;
 132
 133                 dev = rcu_dereference_check(lun->lun_se_dev,
 134                                             lockdep_is_held(&tpg->tpg_lun_mutex));
 135                 /*
 136                  * By default in LIO-Target $FABRIC_MOD,
 137                  * demo_mode_write_protect is ON, or READ_ONLY;
 138                  */
 139                 if (!tpg->se_tpg_tfo->tpg_check_demo_mode_write_protect(tpg)) {
 140                         lun_access_ro = false;
 141                 } else {
 142                         /*
 143                          * Allow only optical drives to issue R/W in default RO
 144                          * demo mode.
 145                          */
 146                         if (dev->transport->get_device_type(dev) == TYPE_DISK)
 147                                 lun_access_ro = true;
 148                         else
 149                                 lun_access_ro = false;
 150                 }
 151
 152                 pr_debug("TARGET_CORE[%s]->TPG[%u]_LUN[%llu] - Adding %s"
 153                         " access for LUN in Demo Mode\n",
 154                         tpg->se_tpg_tfo->fabric_name,
 155                         tpg->se_tpg_tfo->tpg_get_tag(tpg), lun->unpacked_lun,
 156                         lun_access_ro ? "READ-ONLY" : "READ-WRITE");
 157
 158                 core_enable_device_list_for_node(lun, NULL, lun->unpacked_lun,
 159                                                  lun_access_ro, acl, tpg);
 160                 /*
 161                  * Check to see if there are any existing persistent reservation
 162                  * APTPL pre-registrations that need to be enabled for this dynamic
 163                  * LUN ACL now..
 164                  */
 165                 core_scsi3_check_aptpl_registration(dev, tpg, lun, acl,
 166                                                     lun->unpacked_lun);
 167         }
 168         mutex_unlock(&tpg->tpg_lun_mutex);
 169 }
 170
 171 static void
 172 target_set_nacl_queue_depth(struct se_portal_group *tpg,
 173                             struct se_node_acl *acl, u32 queue_depth)
 174 {
 175         acl->queue_depth = queue_depth;
 176
 177         if (!acl->queue_depth) {
 178                 pr_warn("Queue depth for %s Initiator Node: %s is 0,"
 179                         "defaulting to 1.\n", tpg->se_tpg_tfo->fabric_name,
 180                         acl->initiatorname);
 181                 acl->queue_depth = 1;
 182         }
 183 }
 184
 185 static struct se_node_acl *target_alloc_node_acl(struct se_portal_group *tpg,
 186                 const unsigned char *initiatorname)
 187 {
 188         struct se_node_acl *acl;
 189         u32 queue_depth;
 190
 191         acl = kzalloc(max(sizeof(*acl), tpg->se_tpg_tfo->node_acl_size),
 192                         GFP_KERNEL);
 193         if (!acl)
 194                 return NULL;
 195
 196         INIT_LIST_HEAD(&acl->acl_list);
 197         INIT_LIST_HEAD(&acl->acl_sess_list);
 198         INIT_HLIST_HEAD(&acl->lun_entry_hlist);
 199         kref_init(&acl->acl_kref);
 200         init_completion(&acl->acl_free_comp);
 201         spin_lock_init(&acl->nacl_sess_lock);
 202         mutex_init(&acl->lun_entry_mutex);
 203         atomic_set(&acl->acl_pr_ref_count, 0);
 204
 205         if (tpg->se_tpg_tfo->tpg_get_default_depth)
 206                 queue_depth = tpg->se_tpg_tfo->tpg_get_default_depth(tpg);
 207         else
 208                 queue_depth = 1;
 209         target_set_nacl_queue_depth(tpg, acl, queue_depth);
 210
 211         snprintf(acl->initiatorname, TRANSPORT_IQN_LEN, "%s", initiatorname);
 212         acl->se_tpg = tpg;
 213         acl->acl_index = scsi_get_new_index(SCSI_AUTH_INTR_INDEX);
 214
 215         tpg->se_tpg_tfo->set_default_node_attributes(acl);
 216
 217         return acl;
 218 }
 219
 220 static void target_add_node_acl(struct se_node_acl *acl)
 221 {
 222         struct se_portal_group *tpg = acl->se_tpg;
 223
 224         mutex_lock(&tpg->acl_node_mutex);
 225         list_add_tail(&acl->acl_list, &tpg->acl_node_list);
 226         mutex_unlock(&tpg->acl_node_mutex);
 227
 228         pr_debug("%s_TPG[%hu] - Added %s ACL with TCQ Depth: %d for %s"
 229                 " Initiator Node: %s\n",
 230                 tpg->se_tpg_tfo->fabric_name,
 231                 tpg->se_tpg_tfo->tpg_get_tag(tpg),
 232                 acl->dynamic_node_acl ? "DYNAMIC" : "",
 233                 acl->queue_depth,
 234                 tpg->se_tpg_tfo->fabric_name,
 235                 acl->initiatorname);
 236 }
 237
 238 bool target_tpg_has_node_acl(struct se_portal_group *tpg,
 239                              const char *initiatorname)
 240 {
 241         struct se_node_acl *acl;
 242         bool found = false;
 243
 244         mutex_lock(&tpg->acl_node_mutex);
 245         list_for_each_entry(acl, &tpg->acl_node_list, acl_list) {
 246                 if (!strcmp(acl->initiatorname, initiatorname)) {
 247                         found = true;
 248                         break;
 249                 }
 250         }
 251         mutex_unlock(&tpg->acl_node_mutex);
 252
 253         return found;
 254 }
 255 EXPORT_SYMBOL(target_tpg_has_node_acl);
 256
 257 struct se_node_acl *core_tpg_check_initiator_node_acl(
 258         struct se_portal_group *tpg,
 259         unsigned char *initiatorname)
 260 {
 261         struct se_node_acl *acl;
 262
 263         acl = core_tpg_get_initiator_node_acl(tpg, initiatorname);
 264         if (acl)
 265                 return acl;
 266
 267         if (!tpg->se_tpg_tfo->tpg_check_demo_mode(tpg))
 268                 return NULL;
 269
 270         acl = target_alloc_node_acl(tpg, initiatorname);
 271         if (!acl)
 272                 return NULL;
 273         /*
 274          * When allocating a dynamically generated node_acl, go ahead
 275          * and take the extra kref now before returning to the fabric
 276          * driver caller.
 277          *
 278          * Note this reference will be released at session shutdown
 279          * time within transport_free_session() code.
 280          */
 281         kref_get(&acl->acl_kref);
 282         acl->dynamic_node_acl = 1;
 283
 284         /*
 285          * Here we only create demo-mode MappedLUNs from the active
 286          * TPG LUNs if the fabric is not explicitly asking for
 287          * tpg_check_demo_mode_login_only() == 1.
 288          */
 289         if ((tpg->se_tpg_tfo->tpg_check_demo_mode_login_only == NULL) ||
 290             (tpg->se_tpg_tfo->tpg_check_demo_mode_login_only(tpg) != 1))
 291                 core_tpg_add_node_to_devs(acl, tpg, NULL);
 292
 293         target_add_node_acl(acl);
 294         return acl;
 295 }
 296 EXPORT_SYMBOL(core_tpg_check_initiator_node_acl);
 297
 298 void core_tpg_wait_for_nacl_pr_ref(struct se_node_acl *nacl)
 299 {
 300         while (atomic_read(&nacl->acl_pr_ref_count) != 0)
 301                 cpu_relax();
 302 }
 303
 304 struct se_node_acl *core_tpg_add_initiator_node_acl(
 305         struct se_portal_group *tpg,
 306         const char *initiatorname)
 307 {
 308         struct se_node_acl *acl;
 309
 310         mutex_lock(&tpg->acl_node_mutex);
 311         acl = __core_tpg_get_initiator_node_acl(tpg, initiatorname);
 312         if (acl) {
 313                 if (acl->dynamic_node_acl) {
 314                         acl->dynamic_node_acl = 0;
 315                         pr_debug("%s_TPG[%u] - Replacing dynamic ACL"
 316                                 " for %s\n", tpg->se_tpg_tfo->fabric_name,
 317                                 tpg->se_tpg_tfo->tpg_get_tag(tpg), initiatorname);
 318                         mutex_unlock(&tpg->acl_node_mutex);
 319                         return acl;
 320                 }
 321
 322                 pr_err("ACL entry for %s Initiator"
 323                         " Node %s already exists for TPG %u, ignoring"
 324                         " request.\n",  tpg->se_tpg_tfo->fabric_name,
 325                         initiatorname, tpg->se_tpg_tfo->tpg_get_tag(tpg));
 326                 mutex_unlock(&tpg->acl_node_mutex);
 327                 return ERR_PTR(-EEXIST);
 328         }
 329         mutex_unlock(&tpg->acl_node_mutex);
 330
 331         acl = target_alloc_node_acl(tpg, initiatorname);
 332         if (!acl)
 333                 return ERR_PTR(-ENOMEM);
 334
 335         target_add_node_acl(acl);
 336         return acl;
 337 }
 338
 339 static void target_shutdown_sessions(struct se_node_acl *acl)
 340 {
 341         struct se_session *sess;
 342         unsigned long flags;
 343
 344 restart:
 345         spin_lock_irqsave(&acl->nacl_sess_lock, flags);
 346         list_for_each_entry(sess, &acl->acl_sess_list, sess_acl_list) {
 347                 if (sess->sess_tearing_down)
 348                         continue;
 349
 350                 list_del_init(&sess->sess_acl_list);
 351                 spin_unlock_irqrestore(&acl->nacl_sess_lock, flags);
 352
 353                 if (acl->se_tpg->se_tpg_tfo->close_session)
 354                         acl->se_tpg->se_tpg_tfo->close_session(sess);
 355                 goto restart;
 356         }
 357         spin_unlock_irqrestore(&acl->nacl_sess_lock, flags);
 358 }
 359
 360 void core_tpg_del_initiator_node_acl(struct se_node_acl *acl)
 361 {
 362         struct se_portal_group *tpg = acl->se_tpg;
 363
 364         mutex_lock(&tpg->acl_node_mutex);
 365         if (acl->dynamic_node_acl)
 366                 acl->dynamic_node_acl = 0;
 367         list_del_init(&acl->acl_list);
 368         mutex_unlock(&tpg->acl_node_mutex);
 369
 370         target_shutdown_sessions(acl);
 371
 372         target_put_nacl(acl);
 373         /*
 374          * Wait for last target_put_nacl() to complete in target_complete_nacl()
 375          * for active fabric session transport_deregister_session() callbacks.
 376          */
 377         wait_for_completion(&acl->acl_free_comp);
 378
 379         core_tpg_wait_for_nacl_pr_ref(acl);
 380         core_free_device_list_for_node(acl, tpg);
 381
 382         pr_debug("%s_TPG[%hu] - Deleted ACL with TCQ Depth: %d for %s"
 383                 " Initiator Node: %s\n", tpg->se_tpg_tfo->fabric_name,
 384                 tpg->se_tpg_tfo->tpg_get_tag(tpg), acl->queue_depth,
 385                 tpg->se_tpg_tfo->fabric_name, acl->initiatorname);
 386
 387         kfree(acl);
 388 }
 389
 390 /*      core_tpg_set_initiator_node_queue_depth():
 391  *
 392  *
 393  */
 394 int core_tpg_set_initiator_node_queue_depth(
 395         struct se_node_acl *acl,
 396         u32 queue_depth)
 397 {
 398         struct se_portal_group *tpg = acl->se_tpg;
 399
 400         /*
 401          * Allow the setting of se_node_acl queue_depth to be idempotent,
 402          * and not force a session shutdown event if the value is not
 403          * changing.
 404          */
 405         if (acl->queue_depth == queue_depth)
 406                 return 0;
 407         /*
 408          * User has requested to change the queue depth for a Initiator Node.
 409          * Change the value in the Node's struct se_node_acl, and call
 410          * target_set_nacl_queue_depth() to set the new queue depth.
 411          */
 412         target_set_nacl_queue_depth(tpg, acl, queue_depth);
 413
 414         /*
 415          * Shutdown all pending sessions to force session reinstatement.
 416          */
 417         target_shutdown_sessions(acl);
 418
 419         pr_debug("Successfully changed queue depth to: %d for Initiator"
 420                 " Node: %s on %s Target Portal Group: %u\n", acl->queue_depth,
 421                 acl->initiatorname, tpg->se_tpg_tfo->fabric_name,
 422                 tpg->se_tpg_tfo->tpg_get_tag(tpg));
 423
 424         return 0;
 425 }
 426 EXPORT_SYMBOL(core_tpg_set_initiator_node_queue_depth);
 427
 428 /*      core_tpg_set_initiator_node_tag():
 429  *
 430  *      Initiator nodeacl tags are not used internally, but may be used by
 431  *      userspace to emulate aliases or groups.
 432  *      Returns length of newly-set tag or -EINVAL.
 433  */
 434 int core_tpg_set_initiator_node_tag(
 435         struct se_portal_group *tpg,
 436         struct se_node_acl *acl,
 437         const char *new_tag)
 438 {
 439         if (strlen(new_tag) >= MAX_ACL_TAG_SIZE)
 440                 return -EINVAL;
 441
 442         if (!strncmp("NULL", new_tag, 4)) {
 443                 acl->acl_tag[0] = '\0';
 444                 return 0;
 445         }
 446
 447         return snprintf(acl->acl_tag, MAX_ACL_TAG_SIZE, "%s", new_tag);
 448 }
 449 EXPORT_SYMBOL(core_tpg_set_initiator_node_tag);
 450
 451 static void core_tpg_lun_ref_release(struct percpu_ref *ref)
 452 {
 453         struct se_lun *lun = container_of(ref, struct se_lun, lun_ref);
 454
 455         complete(&lun->lun_shutdown_comp);
 456 }
 457
 458 /* Does not change se_wwn->priv. */
 459 int core_tpg_register(
 460         struct se_wwn *se_wwn,
 461         struct se_portal_group *se_tpg,
 462         int proto_id)
 463 {
 464         int ret;
 465
 466         if (!se_tpg)
 467                 return -EINVAL;
 468         /*
 469          * For the typical case where core_tpg_register() is called by a
 470          * fabric driver from target_core_fabric_ops->fabric_make_tpg()
 471          * configfs context, use the original tf_ops pointer already saved
 472          * by target-core in target_fabric_make_wwn().
 473          *
 474          * Otherwise, for special cases like iscsi-target discovery TPGs
 475          * the caller is responsible for setting ->se_tpg_tfo ahead of
 476          * calling core_tpg_register().
 477          */
 478         if (se_wwn)
 479                 se_tpg->se_tpg_tfo = se_wwn->wwn_tf->tf_ops;
 480
 481         if (!se_tpg->se_tpg_tfo) {
 482                 pr_err("Unable to locate se_tpg->se_tpg_tfo pointer\n");
 483                 return -EINVAL;
 484         }
 485
 486         INIT_HLIST_HEAD(&se_tpg->tpg_lun_hlist);
 487         se_tpg->proto_id = proto_id;
 488         se_tpg->se_tpg_wwn = se_wwn;
 489         atomic_set(&se_tpg->tpg_pr_ref_count, 0);
 490         INIT_LIST_HEAD(&se_tpg->acl_node_list);
 491         INIT_LIST_HEAD(&se_tpg->se_tpg_node);
 492         INIT_LIST_HEAD(&se_tpg->tpg_sess_list);
 493         spin_lock_init(&se_tpg->session_lock);
 494         mutex_init(&se_tpg->tpg_lun_mutex);
 495         mutex_init(&se_tpg->acl_node_mutex);
 496
 497         if (se_tpg->proto_id >= 0) {
 498                 se_tpg->tpg_virt_lun0 = core_tpg_alloc_lun(se_tpg, 0);
 499                 if (IS_ERR(se_tpg->tpg_virt_lun0))
 500                         return PTR_ERR(se_tpg->tpg_virt_lun0);
 501
 502                 ret = core_tpg_add_lun(se_tpg, se_tpg->tpg_virt_lun0,
 503                                 true, g_lun0_dev);
 504                 if (ret < 0) {
 505                         kfree(se_tpg->tpg_virt_lun0);
 506                         return ret;
 507                 }
 508         }
 509
 510         spin_lock_bh(&tpg_lock);
 511         list_add_tail(&se_tpg->se_tpg_node, &tpg_list);
 512         spin_unlock_bh(&tpg_lock);
 513
 514         pr_debug("TARGET_CORE[%s]: Allocated portal_group for endpoint: %s, "
 515                  "Proto: %d, Portal Tag: %u\n", se_tpg->se_tpg_tfo->fabric_name,
 516                 se_tpg->se_tpg_tfo->tpg_get_wwn(se_tpg) ?
 517                 se_tpg->se_tpg_tfo->tpg_get_wwn(se_tpg) : NULL,
 518                 se_tpg->proto_id, se_tpg->se_tpg_tfo->tpg_get_tag(se_tpg));
 519
 520         return 0;
 521 }
 522 EXPORT_SYMBOL(core_tpg_register);
 523
 524 int core_tpg_deregister(struct se_portal_group *se_tpg)
 525 {
 526         const struct target_core_fabric_ops *tfo = se_tpg->se_tpg_tfo;
 527         struct se_node_acl *nacl, *nacl_tmp;
 528         LIST_HEAD(node_list);
 529
 530         pr_debug("TARGET_CORE[%s]: Deallocating portal_group for endpoint: %s, "
 531                  "Proto: %d, Portal Tag: %u\n", tfo->fabric_name,
 532                 tfo->tpg_get_wwn(se_tpg) ? tfo->tpg_get_wwn(se_tpg) : NULL,
 533                 se_tpg->proto_id, tfo->tpg_get_tag(se_tpg));
 534
 535         spin_lock_bh(&tpg_lock);
 536         list_del(&se_tpg->se_tpg_node);
 537         spin_unlock_bh(&tpg_lock);
 538
 539         while (atomic_read(&se_tpg->tpg_pr_ref_count) != 0)
 540                 cpu_relax();
 541
 542         mutex_lock(&se_tpg->acl_node_mutex);
 543         list_splice_init(&se_tpg->acl_node_list, &node_list);
 544         mutex_unlock(&se_tpg->acl_node_mutex);
 545         /*
 546          * Release any remaining demo-mode generated se_node_acl that have
 547          * not been released because of TFO->tpg_check_demo_mode_cache() == 1
 548          * in transport_deregister_session().
 549          */
 550         list_for_each_entry_safe(nacl, nacl_tmp, &node_list, acl_list) {
 551                 list_del_init(&nacl->acl_list);
 552
 553                 core_tpg_wait_for_nacl_pr_ref(nacl);
 554                 core_free_device_list_for_node(nacl, se_tpg);
 555                 kfree(nacl);
 556         }
 557
 558         if (se_tpg->proto_id >= 0) {
 559                 core_tpg_remove_lun(se_tpg, se_tpg->tpg_virt_lun0);
 560                 kfree_rcu(se_tpg->tpg_virt_lun0, rcu_head);
 561         }
 562
 563         return 0;
 564 }
 565 EXPORT_SYMBOL(core_tpg_deregister);
 566
 567 struct se_lun *core_tpg_alloc_lun(
 568         struct se_portal_group *tpg,
 569         u64 unpacked_lun)
 570 {
 571         struct se_lun *lun;
 572
 573         lun = kzalloc(sizeof(*lun), GFP_KERNEL);
 574         if (!lun) {
 575                 pr_err("Unable to allocate se_lun memory\n");
 576                 return ERR_PTR(-ENOMEM);
 577         }
 578         lun->unpacked_lun = unpacked_lun;
 579         atomic_set(&lun->lun_acl_count, 0);
 580         init_completion(&lun->lun_shutdown_comp);
 581         INIT_LIST_HEAD(&lun->lun_deve_list);
 582         INIT_LIST_HEAD(&lun->lun_dev_link);
 583         atomic_set(&lun->lun_tg_pt_secondary_offline, 0);
 584         spin_lock_init(&lun->lun_deve_lock);
 585         mutex_init(&lun->lun_tg_pt_md_mutex);
 586         INIT_LIST_HEAD(&lun->lun_tg_pt_gp_link);
 587         spin_lock_init(&lun->lun_tg_pt_gp_lock);
 588         lun->lun_tpg = tpg;
 589
 590         return lun;
 591 }
 592
 593 int core_tpg_add_lun(
 594         struct se_portal_group *tpg,
 595         struct se_lun *lun,
 596         bool lun_access_ro,
 597         struct se_device *dev)
 598 {
 599         int ret;
 600
 601         ret = percpu_ref_init(&lun->lun_ref, core_tpg_lun_ref_release, 0,
 602                               GFP_KERNEL);
 603         if (ret < 0)
 604                 goto out;
 605
 606         ret = core_alloc_rtpi(lun, dev);
 607         if (ret)
 608                 goto out_kill_ref;
 609
 610         if (!(dev->transport->transport_flags &
 611              TRANSPORT_FLAG_PASSTHROUGH_ALUA) &&
 612             !(dev->se_hba->hba_flags & HBA_FLAGS_INTERNAL_USE))
 613                 target_attach_tg_pt_gp(lun, dev->t10_alua.default_tg_pt_gp);
 614
 615         mutex_lock(&tpg->tpg_lun_mutex);
 616
 617         spin_lock(&dev->se_port_lock);
 618         lun->lun_index = dev->dev_index;
 619         rcu_assign_pointer(lun->lun_se_dev, dev);
 620         dev->export_count++;
 621         list_add_tail(&lun->lun_dev_link, &dev->dev_sep_list);
 622         spin_unlock(&dev->se_port_lock);
 623
 624         if (dev->dev_flags & DF_READ_ONLY)
 625                 lun->lun_access_ro = true;
 626         else
 627                 lun->lun_access_ro = lun_access_ro;
 628         if (!(dev->se_hba->hba_flags & HBA_FLAGS_INTERNAL_USE))
 629                 hlist_add_head_rcu(&lun->link, &tpg->tpg_lun_hlist);
 630         mutex_unlock(&tpg->tpg_lun_mutex);
 631
 632         return 0;
 633
 634 out_kill_ref:
 635         percpu_ref_exit(&lun->lun_ref);
 636 out:
 637         return ret;
 638 }
 639
 640 void core_tpg_remove_lun(
 641         struct se_portal_group *tpg,
 642         struct se_lun *lun)
 643 {
 644         /*
 645          * rcu_dereference_raw protected by se_lun->lun_group symlink
 646          * reference to se_device->dev_group.
 647          */
 648         struct se_device *dev = rcu_dereference_raw(lun->lun_se_dev);
 649
 650         lun->lun_shutdown = true;
 651
 652         core_clear_lun_from_tpg(lun, tpg);
 653         /*
 654          * Wait for any active I/O references to percpu se_lun->lun_ref to
 655          * be released.  Also, se_lun->lun_ref is now used by PR and ALUA
 656          * logic when referencing a remote target port during ALL_TGT_PT=1
 657          * and generating UNIT_ATTENTIONs for ALUA access state transition.
 658          */
 659         transport_clear_lun_ref(lun);
 660
 661         mutex_lock(&tpg->tpg_lun_mutex);
 662         if (lun->lun_se_dev) {
 663                 target_detach_tg_pt_gp(lun);
 664
 665                 spin_lock(&dev->se_port_lock);
 666                 list_del(&lun->lun_dev_link);
 667                 dev->export_count--;
 668                 rcu_assign_pointer(lun->lun_se_dev, NULL);
 669                 spin_unlock(&dev->se_port_lock);
 670         }
 671         if (!(dev->se_hba->hba_flags & HBA_FLAGS_INTERNAL_USE))
 672                 hlist_del_rcu(&lun->link);
 673
 674         lun->lun_shutdown = false;
 675         mutex_unlock(&tpg->tpg_lun_mutex);
 676
 677         percpu_ref_exit(&lun->lun_ref);
 678 }