Quellcodebibliothek Statistik Leitseite products/sources/formale Sprachen/C/Linux/drivers/target/   (Open Source Betriebssystem Version 6.17.9©)  Datei vom 24.10.2025 mit Größe 124 kB image not shown  

Quelle  target_core_pr.c   Sprache: C

 
// SPDX-License-Identifier: GPL-2.0-or-later
/*******************************************************************************
 * Filename:  target_core_pr.c
 *
 * This file contains SPC-3 compliant persistent reservations and
 * legacy SPC-2 reservations with compatible reservation handling (CRH=1)
 *
 * (c) Copyright 2009-2013 Datera, Inc.
 *
 * Nicholas A. Bellinger <nab@kernel.org>
 *
 ******************************************************************************/


#include <linux/slab.h>
#include <linux/spinlock.h>
#include <linux/list.h>
#include <linux/vmalloc.h>
#include <linux/file.h>
#include <linux/fcntl.h>
#include <linux/fs.h>
#include <scsi/scsi_proto.h>
#include <linux/unaligned.h>

#include <target/target_core_base.h>
#include <target/target_core_backend.h>
#include <target/target_core_fabric.h>

#include "target_core_internal.h"
#include "target_core_pr.h"
#include "target_core_ua.h"

/*
 * Used for Specify Initiator Ports Capable Bit (SPEC_I_PT)
 */

struct pr_transport_id_holder {
 struct t10_pr_registration *dest_pr_reg;
 struct se_portal_group *dest_tpg;
 struct se_node_acl *dest_node_acl;
 struct se_dev_entry *dest_se_deve;
 struct list_head dest_list;
};

void core_pr_dump_initiator_port(
 struct t10_pr_registration *pr_reg,
 char *buf,
 u32 size)
{
 if (!pr_reg->isid_present_at_reg) {
  buf[0] = '\0';
  return;
 }

 snprintf(buf, size, ",i,0x%s", pr_reg->pr_reg_isid);
}

enum register_type {
 REGISTER,
 REGISTER_AND_IGNORE_EXISTING_KEY,
 REGISTER_AND_MOVE,
};

enum preempt_type {
 PREEMPT,
 PREEMPT_AND_ABORT,
};

static void __core_scsi3_complete_pro_release(struct se_device *, struct se_node_acl *,
           struct t10_pr_registration *, intint);

static int is_reservation_holder(
 struct t10_pr_registration *pr_res_holder,
 struct t10_pr_registration *pr_reg)
{
 int pr_res_type;

 if (pr_res_holder) {
  pr_res_type = pr_res_holder->pr_res_type;

  return pr_res_holder == pr_reg ||
         pr_res_type == PR_TYPE_WRITE_EXCLUSIVE_ALLREG ||
         pr_res_type == PR_TYPE_EXCLUSIVE_ACCESS_ALLREG;
 }
 return 0;
}

static sense_reason_t
target_scsi2_reservation_check(struct se_cmd *cmd)
{
 struct se_device *dev = cmd->se_dev;
 struct se_session *sess = cmd->se_sess;

 switch (cmd->t_task_cdb[0]) {
 case INQUIRY:
 case RELEASE_6:
 case RELEASE_10:
  return 0;
 default:
  break;
 }

 if (!dev->reservation_holder || !sess)
  return 0;

 if (dev->reservation_holder->se_node_acl != sess->se_node_acl)
  return TCM_RESERVATION_CONFLICT;

 if (dev->dev_reservation_flags & DRF_SPC2_RESERVATIONS_WITH_ISID) {
  if (dev->dev_res_bin_isid != sess->sess_bin_isid)
   return TCM_RESERVATION_CONFLICT;
 }

 return 0;
}

static struct t10_pr_registration *core_scsi3_locate_pr_reg(struct se_device *,
     struct se_node_acl *, struct se_session *);
static void core_scsi3_put_pr_reg(struct t10_pr_registration *);

static int target_check_scsi2_reservation_conflict(struct se_cmd *cmd)
{
 struct se_session *se_sess = cmd->se_sess;
 struct se_device *dev = cmd->se_dev;
 struct t10_pr_registration *pr_reg;
 struct t10_reservation *pr_tmpl = &dev->t10_pr;
 int conflict = 0;

 pr_reg = core_scsi3_locate_pr_reg(cmd->se_dev, se_sess->se_node_acl,
   se_sess);
 if (pr_reg) {
  /*
 * From spc4r17 5.7.3 Exceptions to SPC-2 RESERVE and RELEASE
 * behavior
 *
 * A RESERVE(6) or RESERVE(10) command shall complete with GOOD
 * status, but no reservation shall be established and the
 * persistent reservation shall not be changed, if the command
 * is received from a) and b) below.
 *
 * A RELEASE(6) or RELEASE(10) command shall complete with GOOD
 * status, but the persistent reservation shall not be released,
 * if the command is received from a) and b)
 *
 * a) An I_T nexus that is a persistent reservation holder; or
 * b) An I_T nexus that is registered if a registrants only or
 *    all registrants type persistent reservation is present.
 *
 * In all other cases, a RESERVE(6) command, RESERVE(10) command,
 * RELEASE(6) command, or RELEASE(10) command shall be processed
 * as defined in SPC-2.
 */

  if (pr_reg->pr_res_holder) {
   core_scsi3_put_pr_reg(pr_reg);
   return 1;
  }
  if ((pr_reg->pr_res_type == PR_TYPE_WRITE_EXCLUSIVE_REGONLY) ||
      (pr_reg->pr_res_type == PR_TYPE_EXCLUSIVE_ACCESS_REGONLY) ||
      (pr_reg->pr_res_type == PR_TYPE_WRITE_EXCLUSIVE_ALLREG) ||
      (pr_reg->pr_res_type == PR_TYPE_EXCLUSIVE_ACCESS_ALLREG)) {
   core_scsi3_put_pr_reg(pr_reg);
   return 1;
  }
  core_scsi3_put_pr_reg(pr_reg);
  conflict = 1;
 } else {
  /*
 * Following spc2r20 5.5.1 Reservations overview:
 *
 * If a logical unit has executed a PERSISTENT RESERVE OUT
 * command with the REGISTER or the REGISTER AND IGNORE
 * EXISTING KEY service action and is still registered by any
 * initiator, all RESERVE commands and all RELEASE commands
 * regardless of initiator shall conflict and shall terminate
 * with a RESERVATION CONFLICT status.
 */

  spin_lock(&pr_tmpl->registration_lock);
  conflict = (list_empty(&pr_tmpl->registration_list)) ? 0 : 1;
  spin_unlock(&pr_tmpl->registration_lock);
 }

 if (conflict) {
  pr_err("Received legacy SPC-2 RESERVE/RELEASE"
   " while active SPC-3 registrations exist,"
   " returning RESERVATION_CONFLICT\n");
  return -EBUSY;
 }

 return 0;
}

void target_release_reservation(struct se_device *dev)
{
 dev->reservation_holder = NULL;
 dev->dev_reservation_flags &= ~DRF_SPC2_RESERVATIONS;
 if (dev->dev_reservation_flags & DRF_SPC2_RESERVATIONS_WITH_ISID) {
  dev->dev_res_bin_isid = 0;
  dev->dev_reservation_flags &= ~DRF_SPC2_RESERVATIONS_WITH_ISID;
 }
}

sense_reason_t
target_scsi2_reservation_release(struct se_cmd *cmd)
{
 struct se_device *dev = cmd->se_dev;
 struct se_session *sess = cmd->se_sess;
 struct se_portal_group *tpg;
 int rc;

 if (!sess || !sess->se_tpg)
  goto out;
 rc = target_check_scsi2_reservation_conflict(cmd);
 if (rc == 1)
  goto out;
 if (rc < 0)
  return TCM_RESERVATION_CONFLICT;

 spin_lock(&dev->dev_reservation_lock);
 if (!dev->reservation_holder || !sess)
  goto out_unlock;

 if (dev->reservation_holder->se_node_acl != sess->se_node_acl)
  goto out_unlock;

 if (dev->dev_res_bin_isid != sess->sess_bin_isid)
  goto out_unlock;

 target_release_reservation(dev);
 tpg = sess->se_tpg;
 pr_debug("SCSI-2 Released reservation for %s LUN: %llu ->"
  " MAPPED LUN: %llu for %s\n",
  tpg->se_tpg_tfo->fabric_name,
  cmd->se_lun->unpacked_lun, cmd->orig_fe_lun,
  sess->se_node_acl->initiatorname);

out_unlock:
 spin_unlock(&dev->dev_reservation_lock);
out:
 target_complete_cmd(cmd, SAM_STAT_GOOD);
 return 0;
}

sense_reason_t
target_scsi2_reservation_reserve(struct se_cmd *cmd)
{
 struct se_device *dev = cmd->se_dev;
 struct se_session *sess = cmd->se_sess;
 struct se_portal_group *tpg;
 sense_reason_t ret = 0;
 int rc;

 if ((cmd->t_task_cdb[1] & 0x01) &&
     (cmd->t_task_cdb[1] & 0x02)) {
  pr_err("LongIO and Obsolete Bits set, returning ILLEGAL_REQUEST\n");
  return TCM_UNSUPPORTED_SCSI_OPCODE;
 }
 /*
 * This is currently the case for target_core_mod passthrough struct se_cmd
 * ops
 */

 if (!sess || !sess->se_tpg)
  goto out;
 rc = target_check_scsi2_reservation_conflict(cmd);
 if (rc == 1)
  goto out;

 if (rc < 0)
  return TCM_RESERVATION_CONFLICT;

 tpg = sess->se_tpg;
 spin_lock(&dev->dev_reservation_lock);
 if (dev->reservation_holder &&
     dev->reservation_holder->se_node_acl != sess->se_node_acl) {
  pr_err("SCSI-2 RESERVATION CONFLICT for %s fabric\n",
   tpg->se_tpg_tfo->fabric_name);
  pr_err("Original reserver LUN: %llu %s\n",
   cmd->se_lun->unpacked_lun,
   dev->reservation_holder->se_node_acl->initiatorname);
  pr_err("Current attempt - LUN: %llu -> MAPPED LUN: %llu"
   " from %s \n", cmd->se_lun->unpacked_lun,
   cmd->orig_fe_lun,
   sess->se_node_acl->initiatorname);
  ret = TCM_RESERVATION_CONFLICT;
  goto out_unlock;
 }

 dev->reservation_holder = sess;
 dev->dev_reservation_flags |= DRF_SPC2_RESERVATIONS;
 if (sess->sess_bin_isid != 0) {
  dev->dev_res_bin_isid = sess->sess_bin_isid;
  dev->dev_reservation_flags |= DRF_SPC2_RESERVATIONS_WITH_ISID;
 }
 pr_debug("SCSI-2 Reserved %s LUN: %llu -> MAPPED LUN: %llu"
  " for %s\n", tpg->se_tpg_tfo->fabric_name,
  cmd->se_lun->unpacked_lun, cmd->orig_fe_lun,
  sess->se_node_acl->initiatorname);

out_unlock:
 spin_unlock(&dev->dev_reservation_lock);
out:
 if (!ret)
  target_complete_cmd(cmd, SAM_STAT_GOOD);
 return ret;
}


/*
 * Begin SPC-3/SPC-4 Persistent Reservations emulation support
 *
 * This function is called by those initiator ports who are *NOT*
 * the active PR reservation holder when a reservation is present.
 */

static int core_scsi3_pr_seq_non_holder(struct se_cmd *cmd, u32 pr_reg_type,
     bool isid_mismatch)
{
 unsigned char *cdb = cmd->t_task_cdb;
 struct se_session *se_sess = cmd->se_sess;
 struct se_node_acl *nacl = se_sess->se_node_acl;
 int other_cdb = 0;
 int registered_nexus = 0, ret = 1; /* Conflict by default */
 int all_reg = 0, reg_only = 0; /* ALL_REG, REG_ONLY */
 int we = 0; /* Write Exclusive */
 int legacy = 0; /* Act like a legacy device and return
 * RESERVATION CONFLICT on some CDBs */


 if (isid_mismatch) {
  registered_nexus = 0;
 } else {
  struct se_dev_entry *se_deve;

  rcu_read_lock();
  se_deve = target_nacl_find_deve(nacl, cmd->orig_fe_lun);
  if (se_deve)
   registered_nexus = test_bit(DEF_PR_REG_ACTIVE,
          &se_deve->deve_flags);
  rcu_read_unlock();
 }

 switch (pr_reg_type) {
 case PR_TYPE_WRITE_EXCLUSIVE:
  we = 1;
  fallthrough;
 case PR_TYPE_EXCLUSIVE_ACCESS:
  /*
 * Some commands are only allowed for the persistent reservation
 * holder.
 */

  break;
 case PR_TYPE_WRITE_EXCLUSIVE_REGONLY:
  we = 1;
  fallthrough;
 case PR_TYPE_EXCLUSIVE_ACCESS_REGONLY:
  /*
 * Some commands are only allowed for registered I_T Nexuses.
 */

  reg_only = 1;
  break;
 case PR_TYPE_WRITE_EXCLUSIVE_ALLREG:
  we = 1;
  fallthrough;
 case PR_TYPE_EXCLUSIVE_ACCESS_ALLREG:
  /*
 * Each registered I_T Nexus is a reservation holder.
 */

  all_reg = 1;
  break;
 default:
  return -EINVAL;
 }
 /*
 * Referenced from spc4r17 table 45 for *NON* PR holder access
 */

 switch (cdb[0]) {
 case SECURITY_PROTOCOL_IN:
  if (registered_nexus)
   return 0;
  ret = (we) ? 0 : 1;
  break;
 case MODE_SENSE:
 case MODE_SENSE_10:
 case READ_ATTRIBUTE:
 case READ_BUFFER:
 case RECEIVE_DIAGNOSTIC:
  if (legacy) {
   ret = 1;
   break;
  }
  if (registered_nexus) {
   ret = 0;
   break;
  }
  ret = (we) ? 0 : 1; /* Allowed Write Exclusive */
  break;
 case PERSISTENT_RESERVE_OUT:
  /*
 * This follows PERSISTENT_RESERVE_OUT service actions that
 * are allowed in the presence of various reservations.
 * See spc4r17, table 46
 */

  switch (cdb[1] & 0x1f) {
  case PRO_CLEAR:
  case PRO_PREEMPT:
  case PRO_PREEMPT_AND_ABORT:
   ret = (registered_nexus) ? 0 : 1;
   break;
  case PRO_REGISTER:
  case PRO_REGISTER_AND_IGNORE_EXISTING_KEY:
   ret = 0;
   break;
  case PRO_REGISTER_AND_MOVE:
  case PRO_RESERVE:
   ret = 1;
   break;
  case PRO_RELEASE:
   ret = (registered_nexus) ? 0 : 1;
   break;
  default:
   pr_err("Unknown PERSISTENT_RESERVE_OUT service"
    " action: 0x%02x\n", cdb[1] & 0x1f);
   return -EINVAL;
  }
  break;
 case RELEASE_6:
 case RELEASE_10:
  /* Handled by CRH=1 in target_scsi2_reservation_release() */
  ret = 0;
  break;
 case RESERVE_6:
 case RESERVE_10:
  /* Handled by CRH=1 in target_scsi2_reservation_reserve() */
  ret = 0;
  break;
 case TEST_UNIT_READY:
  ret = (legacy) ? 1 : 0; /* Conflict for legacy */
  break;
 case MAINTENANCE_IN:
  switch (cdb[1] & 0x1f) {
  case MI_MANAGEMENT_PROTOCOL_IN:
   if (registered_nexus) {
    ret = 0;
    break;
   }
   ret = (we) ? 0 : 1; /* Allowed Write Exclusive */
   break;
  case MI_REPORT_SUPPORTED_OPERATION_CODES:
  case MI_REPORT_SUPPORTED_TASK_MANAGEMENT_FUNCTIONS:
   if (legacy) {
    ret = 1;
    break;
   }
   if (registered_nexus) {
    ret = 0;
    break;
   }
   ret = (we) ? 0 : 1; /* Allowed Write Exclusive */
   break;
  case MI_REPORT_ALIASES:
  case MI_REPORT_IDENTIFYING_INFORMATION:
  case MI_REPORT_PRIORITY:
  case MI_REPORT_TARGET_PGS:
  case MI_REPORT_TIMESTAMP:
   ret = 0; /* Allowed */
   break;
  default:
   pr_err("Unknown MI Service Action: 0x%02x\n",
    (cdb[1] & 0x1f));
   return -EINVAL;
  }
  break;
 case ACCESS_CONTROL_IN:
 case ACCESS_CONTROL_OUT:
 case INQUIRY:
 case LOG_SENSE:
 case SERVICE_ACTION_IN_12:
 case READ_CAPACITY:
 case REPORT_LUNS:
 case REQUEST_SENSE:
 case PERSISTENT_RESERVE_IN:
  ret = 0; /*/ Allowed CDBs */
  break;
 default:
  other_cdb = 1;
  break;
 }
 /*
 * Case where the CDB is explicitly allowed in the above switch
 * statement.
 */

 if (!ret && !other_cdb) {
  pr_debug("Allowing explicit CDB: 0x%02x for %s"
   " reservation holder\n", cdb[0],
   core_scsi3_pr_dump_type(pr_reg_type));

  return ret;
 }
 /*
 * Check if write exclusive initiator ports *NOT* holding the
 * WRITE_EXCLUSIVE_* reservation.
 */

 if (we && !registered_nexus) {
  if (cmd->data_direction == DMA_TO_DEVICE) {
   /*
 * Conflict for write exclusive
 */

   pr_debug("%s Conflict for unregistered nexus"
    " %s CDB: 0x%02x to %s reservation\n",
    transport_dump_cmd_direction(cmd),
    se_sess->se_node_acl->initiatorname, cdb[0],
    core_scsi3_pr_dump_type(pr_reg_type));
   return 1;
  } else {
   /*
 * Allow non WRITE CDBs for all Write Exclusive
 * PR TYPEs to pass for registered and
 * non-registered_nexuxes NOT holding the reservation.
 *
 * We only make noise for the unregisterd nexuses,
 * as we expect registered non-reservation holding
 * nexuses to issue CDBs.
 */


   if (!registered_nexus) {
    pr_debug("Allowing implicit CDB: 0x%02x"
     " for %s reservation on unregistered"
     " nexus\n", cdb[0],
     core_scsi3_pr_dump_type(pr_reg_type));
   }

   return 0;
  }
 } else if ((reg_only) || (all_reg)) {
  if (registered_nexus) {
   /*
 * For PR_*_REG_ONLY and PR_*_ALL_REG reservations,
 * allow commands from registered nexuses.
 */


   pr_debug("Allowing implicit CDB: 0x%02x for %s"
    " reservation\n", cdb[0],
    core_scsi3_pr_dump_type(pr_reg_type));

   return 0;
  }
       } else if (we && registered_nexus) {
               /*
                * Reads are allowed for Write Exclusive locks
                * from all registrants.
                */

               if (cmd->data_direction == DMA_FROM_DEVICE) {
                       pr_debug("Allowing READ CDB: 0x%02x for %s"
                               " reservation\n", cdb[0],
                               core_scsi3_pr_dump_type(pr_reg_type));

                       return 0;
               }
 }
 pr_debug("%s Conflict for %sregistered nexus %s CDB: 0x%2x"
  " for %s reservation\n", transport_dump_cmd_direction(cmd),
  (registered_nexus) ? "" : "un",
  se_sess->se_node_acl->initiatorname, cdb[0],
  core_scsi3_pr_dump_type(pr_reg_type));

 return 1; /* Conflict by default */
}

static sense_reason_t
target_scsi3_pr_reservation_check(struct se_cmd *cmd)
{
 struct se_device *dev = cmd->se_dev;
 struct se_session *sess = cmd->se_sess;
 u32 pr_reg_type;
 bool isid_mismatch = false;

 if (!dev->dev_pr_res_holder)
  return 0;

 pr_reg_type = dev->dev_pr_res_holder->pr_res_type;
 cmd->pr_res_key = dev->dev_pr_res_holder->pr_res_key;
 if (dev->dev_pr_res_holder->pr_reg_nacl != sess->se_node_acl)
  goto check_nonholder;

 if (dev->dev_pr_res_holder->isid_present_at_reg) {
  if (dev->dev_pr_res_holder->pr_reg_bin_isid !=
      sess->sess_bin_isid) {
   isid_mismatch = true;
   goto check_nonholder;
  }
 }

 return 0;

check_nonholder:
 if (core_scsi3_pr_seq_non_holder(cmd, pr_reg_type, isid_mismatch))
  return TCM_RESERVATION_CONFLICT;
 return 0;
}

static u32 core_scsi3_pr_generation(struct se_device *dev)
{
 u32 prg;

 /*
 * PRGeneration field shall contain the value of a 32-bit wrapping
 * counter mainted by the device server.
 *
 * Note that this is done regardless of Active Persist across
 * Target PowerLoss (APTPL)
 *
 * See spc4r17 section 6.3.12 READ_KEYS service action
 */

 spin_lock(&dev->dev_reservation_lock);
 prg = dev->t10_pr.pr_generation++;
 spin_unlock(&dev->dev_reservation_lock);

 return prg;
}

static struct t10_pr_registration *__core_scsi3_do_alloc_registration(
 struct se_device *dev,
 struct se_node_acl *nacl,
 struct se_lun *lun,
 struct se_dev_entry *dest_deve,
 u64 mapped_lun,
 unsigned char *isid,
 u64 sa_res_key,
 int all_tg_pt,
 int aptpl)
{
 struct t10_pr_registration *pr_reg;

 pr_reg = kmem_cache_zalloc(t10_pr_reg_cache, GFP_ATOMIC);
 if (!pr_reg) {
  pr_err("Unable to allocate struct t10_pr_registration\n");
  return NULL;
 }

 INIT_LIST_HEAD(&pr_reg->pr_reg_list);
 INIT_LIST_HEAD(&pr_reg->pr_reg_abort_list);
 INIT_LIST_HEAD(&pr_reg->pr_reg_aptpl_list);
 INIT_LIST_HEAD(&pr_reg->pr_reg_atp_list);
 INIT_LIST_HEAD(&pr_reg->pr_reg_atp_mem_list);
 atomic_set(&pr_reg->pr_res_holders, 0);
 pr_reg->pr_reg_nacl = nacl;
 /*
 * For destination registrations for ALL_TG_PT=1 and SPEC_I_PT=1,
 * the se_dev_entry->pr_ref will have been already obtained by
 * core_get_se_deve_from_rtpi() or __core_scsi3_alloc_registration().
 *
 * Otherwise, locate se_dev_entry now and obtain a reference until
 * registration completes in __core_scsi3_add_registration().
 */

 if (dest_deve) {
  pr_reg->pr_reg_deve = dest_deve;
 } else {
  rcu_read_lock();
  pr_reg->pr_reg_deve = target_nacl_find_deve(nacl, mapped_lun);
  if (!pr_reg->pr_reg_deve) {
   rcu_read_unlock();
   pr_err("Unable to locate PR deve %s mapped_lun: %llu\n",
    nacl->initiatorname, mapped_lun);
   kmem_cache_free(t10_pr_reg_cache, pr_reg);
   return NULL;
  }
  kref_get(&pr_reg->pr_reg_deve->pr_kref);
  rcu_read_unlock();
 }
 pr_reg->pr_res_mapped_lun = mapped_lun;
 pr_reg->pr_aptpl_target_lun = lun->unpacked_lun;
 pr_reg->tg_pt_sep_rtpi = lun->lun_tpg->tpg_rtpi;
 pr_reg->pr_res_key = sa_res_key;
 pr_reg->pr_reg_all_tg_pt = all_tg_pt;
 pr_reg->pr_reg_aptpl = aptpl;
 /*
 * If an ISID value for this SCSI Initiator Port exists,
 * save it to the registration now.
 */

 if (isid != NULL) {
  pr_reg->pr_reg_bin_isid = get_unaligned_be64(isid);
  snprintf(pr_reg->pr_reg_isid, PR_REG_ISID_LEN, "%s", isid);
  pr_reg->isid_present_at_reg = 1;
 }

 return pr_reg;
}

static int core_scsi3_lunacl_depend_item(struct se_dev_entry *);
static void core_scsi3_lunacl_undepend_item(struct se_dev_entry *);

/*
 * Function used for handling PR registrations for ALL_TG_PT=1 and ALL_TG_PT=0
 * modes.
 */

static struct t10_pr_registration *__core_scsi3_alloc_registration(
 struct se_device *dev,
 struct se_node_acl *nacl,
 struct se_lun *lun,
 struct se_dev_entry *deve,
 u64 mapped_lun,
 unsigned char *isid,
 u64 sa_res_key,
 int all_tg_pt,
 int aptpl)
{
 struct se_dev_entry *deve_tmp;
 struct se_node_acl *nacl_tmp;
 struct se_lun_acl *lacl_tmp;
 struct se_lun *lun_tmp, *next, *dest_lun;
 const struct target_core_fabric_ops *tfo = nacl->se_tpg->se_tpg_tfo;
 struct t10_pr_registration *pr_reg, *pr_reg_atp, *pr_reg_tmp, *pr_reg_tmp_safe;
 int ret;
 /*
 * Create a registration for the I_T Nexus upon which the
 * PROUT REGISTER was received.
 */

 pr_reg = __core_scsi3_do_alloc_registration(dev, nacl, lun, deve, mapped_lun,
          isid, sa_res_key, all_tg_pt,
          aptpl);
 if (!pr_reg)
  return NULL;
 /*
 * Return pointer to pr_reg for ALL_TG_PT=0
 */

 if (!all_tg_pt)
  return pr_reg;
 /*
 * Create list of matching SCSI Initiator Port registrations
 * for ALL_TG_PT=1
 */

 spin_lock(&dev->se_port_lock);
 list_for_each_entry_safe(lun_tmp, next, &dev->dev_sep_list, lun_dev_link) {
  if (!percpu_ref_tryget_live(&lun_tmp->lun_ref))
   continue;
  spin_unlock(&dev->se_port_lock);

  spin_lock(&lun_tmp->lun_deve_lock);
  list_for_each_entry(deve_tmp, &lun_tmp->lun_deve_list, lun_link) {
   /*
 * This pointer will be NULL for demo mode MappedLUNs
 * that have not been make explicit via a ConfigFS
 * MappedLUN group for the SCSI Initiator Node ACL.
 */

   if (!deve_tmp->se_lun_acl)
    continue;

   lacl_tmp = deve_tmp->se_lun_acl;
   nacl_tmp = lacl_tmp->se_lun_nacl;
   /*
 * Skip the matching struct se_node_acl that is allocated
 * above..
 */

   if (nacl == nacl_tmp)
    continue;
   /*
 * Only perform PR registrations for target ports on
 * the same fabric module as the REGISTER w/ ALL_TG_PT=1
 * arrived.
 */

   if (tfo != nacl_tmp->se_tpg->se_tpg_tfo)
    continue;
   /*
 * Look for a matching Initiator Node ACL in ASCII format
 */

   if (strcmp(nacl->initiatorname, nacl_tmp->initiatorname))
    continue;

   kref_get(&deve_tmp->pr_kref);
   spin_unlock(&lun_tmp->lun_deve_lock);
   /*
 * Grab a configfs group dependency that is released
 * for the exception path at label out: below, or upon
 * completion of adding ALL_TG_PT=1 registrations in
 * __core_scsi3_add_registration()
 */

   ret = core_scsi3_lunacl_depend_item(deve_tmp);
   if (ret < 0) {
    pr_err("core_scsi3_lunacl_depend"
      "_item() failed\n");
    percpu_ref_put(&lun_tmp->lun_ref);
    kref_put(&deve_tmp->pr_kref, target_pr_kref_release);
    goto out;
   }
   /*
 * Located a matching SCSI Initiator Port on a different
 * port, allocate the pr_reg_atp and attach it to the
 * pr_reg->pr_reg_atp_list that will be processed once
 * the original *pr_reg is processed in
 * __core_scsi3_add_registration()
 */

   dest_lun = deve_tmp->se_lun;

   pr_reg_atp = __core_scsi3_do_alloc_registration(dev,
      nacl_tmp, dest_lun, deve_tmp,
      deve_tmp->mapped_lun, NULL,
      sa_res_key, all_tg_pt, aptpl);
   if (!pr_reg_atp) {
    percpu_ref_put(&lun_tmp->lun_ref);
    core_scsi3_lunacl_undepend_item(deve_tmp);
    goto out;
   }

   list_add_tail(&pr_reg_atp->pr_reg_atp_mem_list,
          &pr_reg->pr_reg_atp_list);
   spin_lock(&lun_tmp->lun_deve_lock);
  }
  spin_unlock(&lun_tmp->lun_deve_lock);

  spin_lock(&dev->se_port_lock);
  percpu_ref_put(&lun_tmp->lun_ref);
 }
 spin_unlock(&dev->se_port_lock);

 return pr_reg;
out:
 list_for_each_entry_safe(pr_reg_tmp, pr_reg_tmp_safe,
   &pr_reg->pr_reg_atp_list, pr_reg_atp_mem_list) {
  list_del(&pr_reg_tmp->pr_reg_atp_mem_list);
  core_scsi3_lunacl_undepend_item(pr_reg_tmp->pr_reg_deve);
  kmem_cache_free(t10_pr_reg_cache, pr_reg_tmp);
 }
 kmem_cache_free(t10_pr_reg_cache, pr_reg);
 return NULL;
}

int core_scsi3_alloc_aptpl_registration(
 struct t10_reservation *pr_tmpl,
 u64 sa_res_key,
 unsigned char *i_port,
 unsigned char *isid,
 u64 mapped_lun,
 unsigned char *t_port,
 u16 tpgt,
 u64 target_lun,
 int res_holder,
 int all_tg_pt,
 u8 type)
{
 struct t10_pr_registration *pr_reg;

 if (!i_port || !t_port || !sa_res_key) {
  pr_err("Illegal parameters for APTPL registration\n");
  return -EINVAL;
 }

 pr_reg = kmem_cache_zalloc(t10_pr_reg_cache, GFP_KERNEL);
 if (!pr_reg) {
  pr_err("Unable to allocate struct t10_pr_registration\n");
  return -ENOMEM;
 }

 INIT_LIST_HEAD(&pr_reg->pr_reg_list);
 INIT_LIST_HEAD(&pr_reg->pr_reg_abort_list);
 INIT_LIST_HEAD(&pr_reg->pr_reg_aptpl_list);
 INIT_LIST_HEAD(&pr_reg->pr_reg_atp_list);
 INIT_LIST_HEAD(&pr_reg->pr_reg_atp_mem_list);
 atomic_set(&pr_reg->pr_res_holders, 0);
 pr_reg->pr_reg_nacl = NULL;
 pr_reg->pr_reg_deve = NULL;
 pr_reg->pr_res_mapped_lun = mapped_lun;
 pr_reg->pr_aptpl_target_lun = target_lun;
 pr_reg->pr_res_key = sa_res_key;
 pr_reg->pr_reg_all_tg_pt = all_tg_pt;
 pr_reg->pr_reg_aptpl = 1;
 pr_reg->pr_res_scope = 0; /* Always LUN_SCOPE */
 pr_reg->pr_res_type = type;
 /*
 * If an ISID value had been saved in APTPL metadata for this
 * SCSI Initiator Port, restore it now.
 */

 if (isid != NULL) {
  pr_reg->pr_reg_bin_isid = get_unaligned_be64(isid);
  snprintf(pr_reg->pr_reg_isid, PR_REG_ISID_LEN, "%s", isid);
  pr_reg->isid_present_at_reg = 1;
 }
 /*
 * Copy the i_port and t_port information from caller.
 */

 snprintf(pr_reg->pr_iport, PR_APTPL_MAX_IPORT_LEN, "%s", i_port);
 snprintf(pr_reg->pr_tport, PR_APTPL_MAX_TPORT_LEN, "%s", t_port);
 pr_reg->pr_reg_tpgt = tpgt;
 /*
 * Set pr_res_holder from caller, the pr_reg who is the reservation
 * holder will get it's pointer set in core_scsi3_aptpl_reserve() once
 * the Initiator Node LUN ACL from the fabric module is created for
 * this registration.
 */

 pr_reg->pr_res_holder = res_holder;

 list_add_tail(&pr_reg->pr_reg_aptpl_list, &pr_tmpl->aptpl_reg_list);
 pr_debug("SPC-3 PR APTPL Successfully added registration%s from"
   " metadata\n", (res_holder) ? "+reservation" : "");
 return 0;
}

static void core_scsi3_aptpl_reserve(
 struct se_device *dev,
 struct se_portal_group *tpg,
 struct se_node_acl *node_acl,
 struct t10_pr_registration *pr_reg)
{
 char i_buf[PR_REG_ISID_ID_LEN] = { };

 core_pr_dump_initiator_port(pr_reg, i_buf, PR_REG_ISID_ID_LEN);

 spin_lock(&dev->dev_reservation_lock);
 dev->dev_pr_res_holder = pr_reg;
 spin_unlock(&dev->dev_reservation_lock);

 pr_debug("SPC-3 PR [%s] Service Action: APTPL RESERVE created"
  " new reservation holder TYPE: %s ALL_TG_PT: %d\n",
  tpg->se_tpg_tfo->fabric_name,
  core_scsi3_pr_dump_type(pr_reg->pr_res_type),
  (pr_reg->pr_reg_all_tg_pt) ? 1 : 0);
 pr_debug("SPC-3 PR [%s] RESERVE Node: %s%s\n",
  tpg->se_tpg_tfo->fabric_name, node_acl->initiatorname,
  i_buf);
}

static void __core_scsi3_add_registration(struct se_device *, struct se_node_acl *,
    struct t10_pr_registration *, enum register_type, int);

static int __core_scsi3_check_aptpl_registration(
 struct se_device *dev,
 struct se_portal_group *tpg,
 struct se_lun *lun,
 u64 target_lun,
 struct se_node_acl *nacl,
 u64 mapped_lun)
{
 struct t10_pr_registration *pr_reg, *pr_reg_tmp;
 struct t10_reservation *pr_tmpl = &dev->t10_pr;
 unsigned char i_port[PR_APTPL_MAX_IPORT_LEN] = { };
 unsigned char t_port[PR_APTPL_MAX_TPORT_LEN] = { };
 u16 tpgt;

 /*
 * Copy Initiator Port information from struct se_node_acl
 */

 snprintf(i_port, PR_APTPL_MAX_IPORT_LEN, "%s", nacl->initiatorname);
 snprintf(t_port, PR_APTPL_MAX_TPORT_LEN, "%s",
   tpg->se_tpg_tfo->tpg_get_wwn(tpg));
 tpgt = tpg->se_tpg_tfo->tpg_get_tag(tpg);
 /*
 * Look for the matching registrations+reservation from those
 * created from APTPL metadata.  Note that multiple registrations
 * may exist for fabrics that use ISIDs in their SCSI Initiator Port
 * TransportIDs.
 */

 spin_lock(&pr_tmpl->aptpl_reg_lock);
 list_for_each_entry_safe(pr_reg, pr_reg_tmp, &pr_tmpl->aptpl_reg_list,
    pr_reg_aptpl_list) {

  if (!strcmp(pr_reg->pr_iport, i_port) &&
       (pr_reg->pr_res_mapped_lun == mapped_lun) &&
      !(strcmp(pr_reg->pr_tport, t_port)) &&
       (pr_reg->pr_reg_tpgt == tpgt) &&
       (pr_reg->pr_aptpl_target_lun == target_lun)) {
   /*
 * Obtain the ->pr_reg_deve pointer + reference, that
 * is released by __core_scsi3_add_registration() below.
 */

   rcu_read_lock();
   pr_reg->pr_reg_deve = target_nacl_find_deve(nacl, mapped_lun);
   if (!pr_reg->pr_reg_deve) {
    pr_err("Unable to locate PR APTPL %s mapped_lun:"
     " %llu\n", nacl->initiatorname, mapped_lun);
    rcu_read_unlock();
    continue;
   }
   kref_get(&pr_reg->pr_reg_deve->pr_kref);
   rcu_read_unlock();

   pr_reg->pr_reg_nacl = nacl;
   pr_reg->tg_pt_sep_rtpi = lun->lun_tpg->tpg_rtpi;
   list_del(&pr_reg->pr_reg_aptpl_list);
   spin_unlock(&pr_tmpl->aptpl_reg_lock);
   /*
 * At this point all of the pointers in *pr_reg will
 * be setup, so go ahead and add the registration.
 */

   __core_scsi3_add_registration(dev, nacl, pr_reg, 0, 0);
   /*
 * If this registration is the reservation holder,
 * make that happen now..
 */

   if (pr_reg->pr_res_holder)
    core_scsi3_aptpl_reserve(dev, tpg,
      nacl, pr_reg);
   /*
 * Reenable pr_aptpl_active to accept new metadata
 * updates once the SCSI device is active again..
 */

   spin_lock(&pr_tmpl->aptpl_reg_lock);
   pr_tmpl->pr_aptpl_active = 1;
  }
 }
 spin_unlock(&pr_tmpl->aptpl_reg_lock);

 return 0;
}

int core_scsi3_check_aptpl_registration(
 struct se_device *dev,
 struct se_portal_group *tpg,
 struct se_lun *lun,
 struct se_node_acl *nacl,
 u64 mapped_lun)
{
 if (dev->dev_reservation_flags & DRF_SPC2_RESERVATIONS)
  return 0;

 return __core_scsi3_check_aptpl_registration(dev, tpg, lun,
           lun->unpacked_lun, nacl,
           mapped_lun);
}

static void __core_scsi3_dump_registration(
 const struct target_core_fabric_ops *tfo,
 struct se_device *dev,
 struct se_node_acl *nacl,
 struct t10_pr_registration *pr_reg,
 enum register_type register_type)
{
 struct se_portal_group *se_tpg = nacl->se_tpg;
 char i_buf[PR_REG_ISID_ID_LEN] = { };

 core_pr_dump_initiator_port(pr_reg, i_buf, PR_REG_ISID_ID_LEN);

 pr_debug("SPC-3 PR [%s] Service Action: REGISTER%s Initiator"
  " Node: %s%s\n", tfo->fabric_name, (register_type == REGISTER_AND_MOVE) ?
  "_AND_MOVE" : (register_type == REGISTER_AND_IGNORE_EXISTING_KEY) ?
  "_AND_IGNORE_EXISTING_KEY" : "", nacl->initiatorname,
  i_buf);
 pr_debug("SPC-3 PR [%s] registration on Target Port: %s,0x%04x\n",
   tfo->fabric_name, tfo->tpg_get_wwn(se_tpg),
  tfo->tpg_get_tag(se_tpg));
 pr_debug("SPC-3 PR [%s] for %s TCM Subsystem %s Object Target"
  " Port(s)\n",  tfo->fabric_name,
  (pr_reg->pr_reg_all_tg_pt) ? "ALL" : "SINGLE",
  dev->transport->name);
 pr_debug("SPC-3 PR [%s] SA Res Key: 0x%016Lx PRgeneration:"
  " 0x%08x APTPL: %d\n", tfo->fabric_name,
  pr_reg->pr_res_key, pr_reg->pr_res_generation,
  pr_reg->pr_reg_aptpl);
}

static void __core_scsi3_add_registration(
 struct se_device *dev,
 struct se_node_acl *nacl,
 struct t10_pr_registration *pr_reg,
 enum register_type register_type,
 int register_move)
{
 const struct target_core_fabric_ops *tfo = nacl->se_tpg->se_tpg_tfo;
 struct t10_pr_registration *pr_reg_tmp, *pr_reg_tmp_safe;
 struct t10_reservation *pr_tmpl = &dev->t10_pr;
 struct se_dev_entry *deve;

 /*
 * Increment PRgeneration counter for struct se_device upon a successful
 * REGISTER, see spc4r17 section 6.3.2 READ_KEYS service action
 *
 * Also, when register_move = 1 for PROUT REGISTER_AND_MOVE service
 * action, the struct se_device->dev_reservation_lock will already be held,
 * so we do not call core_scsi3_pr_generation() which grabs the lock
 * for the REGISTER.
 */

 pr_reg->pr_res_generation = (register_move) ?
   dev->t10_pr.pr_generation++ :
   core_scsi3_pr_generation(dev);

 spin_lock(&pr_tmpl->registration_lock);
 list_add_tail(&pr_reg->pr_reg_list, &pr_tmpl->registration_list);

 __core_scsi3_dump_registration(tfo, dev, nacl, pr_reg, register_type);
 spin_unlock(&pr_tmpl->registration_lock);
 /*
 * Skip extra processing for ALL_TG_PT=0 or REGISTER_AND_MOVE.
 */

 if (!pr_reg->pr_reg_all_tg_pt || register_move)
  goto out;
 /*
 * Walk pr_reg->pr_reg_atp_list and add registrations for ALL_TG_PT=1
 * allocated in __core_scsi3_alloc_registration()
 */

 list_for_each_entry_safe(pr_reg_tmp, pr_reg_tmp_safe,
   &pr_reg->pr_reg_atp_list, pr_reg_atp_mem_list) {
  struct se_node_acl *nacl_tmp = pr_reg_tmp->pr_reg_nacl;

  list_del(&pr_reg_tmp->pr_reg_atp_mem_list);

  pr_reg_tmp->pr_res_generation = core_scsi3_pr_generation(dev);

  spin_lock(&pr_tmpl->registration_lock);
  list_add_tail(&pr_reg_tmp->pr_reg_list,
         &pr_tmpl->registration_list);

  __core_scsi3_dump_registration(tfo, dev, nacl_tmp, pr_reg_tmp,
            register_type);
  spin_unlock(&pr_tmpl->registration_lock);
  /*
 * Drop configfs group dependency reference and deve->pr_kref
 * obtained from  __core_scsi3_alloc_registration() code.
 */

  rcu_read_lock();
  deve = pr_reg_tmp->pr_reg_deve;
  if (deve) {
   set_bit(DEF_PR_REG_ACTIVE, &deve->deve_flags);
   core_scsi3_lunacl_undepend_item(deve);
   pr_reg_tmp->pr_reg_deve = NULL;
  }
  rcu_read_unlock();
 }
out:
 /*
 * Drop deve->pr_kref obtained in __core_scsi3_do_alloc_registration()
 */

 rcu_read_lock();
 deve = pr_reg->pr_reg_deve;
 if (deve) {
  set_bit(DEF_PR_REG_ACTIVE, &deve->deve_flags);
  kref_put(&deve->pr_kref, target_pr_kref_release);
  pr_reg->pr_reg_deve = NULL;
 }
 rcu_read_unlock();
}

static int core_scsi3_alloc_registration(
 struct se_device *dev,
 struct se_node_acl *nacl,
 struct se_lun *lun,
 struct se_dev_entry *deve,
 u64 mapped_lun,
 unsigned char *isid,
 u64 sa_res_key,
 int all_tg_pt,
 int aptpl,
 enum register_type register_type,
 int register_move)
{
 struct t10_pr_registration *pr_reg;

 pr_reg = __core_scsi3_alloc_registration(dev, nacl, lun, deve, mapped_lun,
       isid, sa_res_key, all_tg_pt,
       aptpl);
 if (!pr_reg)
  return -EPERM;

 __core_scsi3_add_registration(dev, nacl, pr_reg,
   register_type, register_move);
 return 0;
}

static struct t10_pr_registration *__core_scsi3_locate_pr_reg(
 struct se_device *dev,
 struct se_node_acl *nacl,
 unsigned char *isid)
{
 struct t10_reservation *pr_tmpl = &dev->t10_pr;
 struct t10_pr_registration *pr_reg, *pr_reg_tmp;

 spin_lock(&pr_tmpl->registration_lock);
 list_for_each_entry_safe(pr_reg, pr_reg_tmp,
   &pr_tmpl->registration_list, pr_reg_list) {
  /*
 * First look for a matching struct se_node_acl
 */

  if (pr_reg->pr_reg_nacl != nacl)
   continue;

  /*
 * If this registration does NOT contain a fabric provided
 * ISID, then we have found a match.
 */

  if (!pr_reg->isid_present_at_reg) {
   atomic_inc_mb(&pr_reg->pr_res_holders);
   spin_unlock(&pr_tmpl->registration_lock);
   return pr_reg;
  }
  /*
 * If the *pr_reg contains a fabric defined ISID for multi-value
 * SCSI Initiator Port TransportIDs, then we expect a valid
 * matching ISID to be provided by the local SCSI Initiator Port.
 */

  if (!isid)
   continue;
  if (strcmp(isid, pr_reg->pr_reg_isid))
   continue;

  atomic_inc_mb(&pr_reg->pr_res_holders);
  spin_unlock(&pr_tmpl->registration_lock);
  return pr_reg;
 }
 spin_unlock(&pr_tmpl->registration_lock);

 return NULL;
}

static struct t10_pr_registration *core_scsi3_locate_pr_reg(
 struct se_device *dev,
 struct se_node_acl *nacl,
 struct se_session *sess)
{
 struct se_portal_group *tpg = nacl->se_tpg;
 unsigned char buf[PR_REG_ISID_LEN] = { };
 unsigned char *isid_ptr = NULL;

 if (tpg->se_tpg_tfo->sess_get_initiator_sid != NULL) {
  tpg->se_tpg_tfo->sess_get_initiator_sid(sess, &buf[0],
     PR_REG_ISID_LEN);
  isid_ptr = &buf[0];
 }

 return __core_scsi3_locate_pr_reg(dev, nacl, isid_ptr);
}

static void core_scsi3_put_pr_reg(struct t10_pr_registration *pr_reg)
{
 atomic_dec_mb(&pr_reg->pr_res_holders);
}

static int core_scsi3_check_implicit_release(
 struct se_device *dev,
 struct t10_pr_registration *pr_reg)
{
 struct se_node_acl *nacl = pr_reg->pr_reg_nacl;
 struct t10_pr_registration *pr_res_holder;
 int ret = 0;

 spin_lock(&dev->dev_reservation_lock);
 pr_res_holder = dev->dev_pr_res_holder;
 if (!pr_res_holder) {
  spin_unlock(&dev->dev_reservation_lock);
  return ret;
 }
 if (pr_res_holder == pr_reg) {
  /*
 * Perform an implicit RELEASE if the registration that
 * is being released is holding the reservation.
 *
 * From spc4r17, section 5.7.11.1:
 *
 * e) If the I_T nexus is the persistent reservation holder
 *    and the persistent reservation is not an all registrants
 *    type, then a PERSISTENT RESERVE OUT command with REGISTER
 *    service action or REGISTER AND  IGNORE EXISTING KEY
 *    service action with the SERVICE ACTION RESERVATION KEY
 *    field set to zero (see 5.7.11.3).
 */

  __core_scsi3_complete_pro_release(dev, nacl, pr_reg, 0, 1);
  ret = 1;
  /*
 * For 'All Registrants' reservation types, all existing
 * registrations are still processed as reservation holders
 * in core_scsi3_pr_seq_non_holder() after the initial
 * reservation holder is implicitly released here.
 */

 } else if (pr_reg->pr_reg_all_tg_pt &&
    (!strcmp(pr_res_holder->pr_reg_nacl->initiatorname,
     pr_reg->pr_reg_nacl->initiatorname)) &&
    (pr_res_holder->pr_res_key == pr_reg->pr_res_key)) {
  pr_err("SPC-3 PR: Unable to perform ALL_TG_PT=1"
   " UNREGISTER while existing reservation with matching"
   " key 0x%016Lx is present from another SCSI Initiator"
   " Port\n", pr_reg->pr_res_key);
  ret = -EPERM;
 }
 spin_unlock(&dev->dev_reservation_lock);

 return ret;
}

static void __core_scsi3_free_registration(
 struct se_device *dev,
 struct t10_pr_registration *pr_reg,
 struct list_head *preempt_and_abort_list,
 int dec_holders)
 __releases(&pr_tmpl->registration_lock)
 __acquires(&pr_tmpl->registration_lock)
{
 const struct target_core_fabric_ops *tfo =
   pr_reg->pr_reg_nacl->se_tpg->se_tpg_tfo;
 struct t10_reservation *pr_tmpl = &dev->t10_pr;
 struct se_node_acl *nacl = pr_reg->pr_reg_nacl;
 struct se_dev_entry *deve;
 char i_buf[PR_REG_ISID_ID_LEN] = { };

 lockdep_assert_held(&pr_tmpl->registration_lock);

 core_pr_dump_initiator_port(pr_reg, i_buf, PR_REG_ISID_ID_LEN);

 if (!list_empty(&pr_reg->pr_reg_list))
  list_del(&pr_reg->pr_reg_list);
 /*
 * Caller accessing *pr_reg using core_scsi3_locate_pr_reg(),
 * so call core_scsi3_put_pr_reg() to decrement our reference.
 */

 if (dec_holders)
  core_scsi3_put_pr_reg(pr_reg);

 spin_unlock(&pr_tmpl->registration_lock);
 /*
 * Wait until all reference from any other I_T nexuses for this
 * *pr_reg have been released.  Because list_del() is called above,
 * the last core_scsi3_put_pr_reg(pr_reg) will release this reference
 * count back to zero, and we release *pr_reg.
 */

 while (atomic_read(&pr_reg->pr_res_holders) != 0) {
  pr_debug("SPC-3 PR [%s] waiting for pr_res_holders\n",
    tfo->fabric_name);
  cpu_relax();
 }

 rcu_read_lock();
 deve = target_nacl_find_deve(nacl, pr_reg->pr_res_mapped_lun);
 if (deve)
  clear_bit(DEF_PR_REG_ACTIVE, &deve->deve_flags);
 rcu_read_unlock();

 spin_lock(&pr_tmpl->registration_lock);
 pr_debug("SPC-3 PR [%s] Service Action: UNREGISTER Initiator"
  " Node: %s%s\n", tfo->fabric_name,
  pr_reg->pr_reg_nacl->initiatorname,
  i_buf);
 pr_debug("SPC-3 PR [%s] for %s TCM Subsystem %s Object Target"
  " Port(s)\n", tfo->fabric_name,
  (pr_reg->pr_reg_all_tg_pt) ? "ALL" : "SINGLE",
  dev->transport->name);
 pr_debug("SPC-3 PR [%s] SA Res Key: 0x%016Lx PRgeneration:"
  " 0x%08x\n", tfo->fabric_name, pr_reg->pr_res_key,
  pr_reg->pr_res_generation);

 if (!preempt_and_abort_list) {
  pr_reg->pr_reg_deve = NULL;
  pr_reg->pr_reg_nacl = NULL;
  kmem_cache_free(t10_pr_reg_cache, pr_reg);
  return;
 }
 /*
 * For PREEMPT_AND_ABORT, the list of *pr_reg in preempt_and_abort_list
 * are released once the ABORT_TASK_SET has completed..
 */

 list_add_tail(&pr_reg->pr_reg_abort_list, preempt_and_abort_list);
}

void core_scsi3_free_pr_reg_from_nacl(
 struct se_device *dev,
 struct se_node_acl *nacl)
{
 struct t10_reservation *pr_tmpl = &dev->t10_pr;
 struct t10_pr_registration *pr_reg, *pr_reg_tmp, *pr_res_holder;
 bool free_reg = false;
 /*
 * If the passed se_node_acl matches the reservation holder,
 * release the reservation.
 */

 spin_lock(&dev->dev_reservation_lock);
 pr_res_holder = dev->dev_pr_res_holder;
 if ((pr_res_holder != NULL) &&
     (pr_res_holder->pr_reg_nacl == nacl)) {
  __core_scsi3_complete_pro_release(dev, nacl, pr_res_holder, 0, 1);
  free_reg = true;
 }
 spin_unlock(&dev->dev_reservation_lock);
 /*
 * Release any registration associated with the struct se_node_acl.
 */

 spin_lock(&pr_tmpl->registration_lock);
 if (pr_res_holder && free_reg)
  __core_scsi3_free_registration(dev, pr_res_holder, NULL, 0);

 list_for_each_entry_safe(pr_reg, pr_reg_tmp,
   &pr_tmpl->registration_list, pr_reg_list) {

  if (pr_reg->pr_reg_nacl != nacl)
   continue;

  __core_scsi3_free_registration(dev, pr_reg, NULL, 0);
 }
 spin_unlock(&pr_tmpl->registration_lock);
}

void core_scsi3_free_all_registrations(
 struct se_device *dev)
{
 struct t10_reservation *pr_tmpl = &dev->t10_pr;
 struct t10_pr_registration *pr_reg, *pr_reg_tmp, *pr_res_holder;

 spin_lock(&dev->dev_reservation_lock);
 pr_res_holder = dev->dev_pr_res_holder;
 if (pr_res_holder != NULL) {
  struct se_node_acl *pr_res_nacl = pr_res_holder->pr_reg_nacl;
  __core_scsi3_complete_pro_release(dev, pr_res_nacl,
        pr_res_holder, 0, 0);
 }
 spin_unlock(&dev->dev_reservation_lock);

 spin_lock(&pr_tmpl->registration_lock);
 list_for_each_entry_safe(pr_reg, pr_reg_tmp,
   &pr_tmpl->registration_list, pr_reg_list) {

  __core_scsi3_free_registration(dev, pr_reg, NULL, 0);
 }
 spin_unlock(&pr_tmpl->registration_lock);

 spin_lock(&pr_tmpl->aptpl_reg_lock);
 list_for_each_entry_safe(pr_reg, pr_reg_tmp, &pr_tmpl->aptpl_reg_list,
    pr_reg_aptpl_list) {
  list_del(&pr_reg->pr_reg_aptpl_list);
  kmem_cache_free(t10_pr_reg_cache, pr_reg);
 }
 spin_unlock(&pr_tmpl->aptpl_reg_lock);
}

static int core_scsi3_tpg_depend_item(struct se_portal_group *tpg)
{
 return target_depend_item(&tpg->tpg_group.cg_item);
}

static void core_scsi3_tpg_undepend_item(struct se_portal_group *tpg)
{
 target_undepend_item(&tpg->tpg_group.cg_item);
 atomic_dec_mb(&tpg->tpg_pr_ref_count);
}

static int core_scsi3_nodeacl_depend_item(struct se_node_acl *nacl)
{
 if (nacl->dynamic_node_acl)
  return 0;
 return target_depend_item(&nacl->acl_group.cg_item);
}

static void core_scsi3_nodeacl_undepend_item(struct se_node_acl *nacl)
{
 if (!nacl->dynamic_node_acl)
  target_undepend_item(&nacl->acl_group.cg_item);
 atomic_dec_mb(&nacl->acl_pr_ref_count);
}

static int core_scsi3_lunacl_depend_item(struct se_dev_entry *se_deve)
{
 /*
 * For nacl->dynamic_node_acl=1
 */

 if (!se_deve->se_lun_acl)
  return 0;

 return target_depend_item(&se_deve->se_lun_acl->se_lun_group.cg_item);
}

static void core_scsi3_lunacl_undepend_item(struct se_dev_entry *se_deve)
{
 /*
 * For nacl->dynamic_node_acl=1
 */

 if (!se_deve->se_lun_acl) {
  kref_put(&se_deve->pr_kref, target_pr_kref_release);
  return;
 }

 target_undepend_item(&se_deve->se_lun_acl->se_lun_group.cg_item);
 kref_put(&se_deve->pr_kref, target_pr_kref_release);
}

static sense_reason_t
core_scsi3_decode_spec_i_port(
 struct se_cmd *cmd,
 struct se_portal_group *tpg,
 unsigned char *l_isid,
 u64 sa_res_key,
 int all_tg_pt,
 int aptpl)
{
 struct se_device *dev = cmd->se_dev;
 struct se_portal_group *dest_tpg = NULL, *tmp_tpg;
 struct se_session *se_sess = cmd->se_sess;
 struct se_node_acl *dest_node_acl = NULL;
 struct se_dev_entry *dest_se_deve = NULL;
 struct t10_pr_registration *dest_pr_reg, *local_pr_reg, *pr_reg_e;
 struct t10_pr_registration *pr_reg_tmp, *pr_reg_tmp_safe;
 LIST_HEAD(tid_dest_list);
 struct pr_transport_id_holder *tidh_new, *tidh, *tidh_tmp;
 unsigned char *buf, *ptr, proto_ident;
 unsigned char i_str[TRANSPORT_IQN_LEN];
 char *iport_ptr = NULL, i_buf[PR_REG_ISID_ID_LEN];
 sense_reason_t ret;
 u32 tpdl, tid_len = 0;
 u32 dest_rtpi = 0;
 bool tid_found;

 /*
 * Allocate a struct pr_transport_id_holder and setup the
 * local_node_acl pointer and add to struct list_head tid_dest_list
 * for add registration processing in the loop of tid_dest_list below.
 */

 tidh_new = kzalloc(sizeof(struct pr_transport_id_holder), GFP_KERNEL);
 if (!tidh_new) {
  pr_err("Unable to allocate tidh_new\n");
  return TCM_INSUFFICIENT_REGISTRATION_RESOURCES;
 }
 INIT_LIST_HEAD(&tidh_new->dest_list);
 tidh_new->dest_tpg = tpg;
 tidh_new->dest_node_acl = se_sess->se_node_acl;

 local_pr_reg = __core_scsi3_alloc_registration(cmd->se_dev,
    se_sess->se_node_acl, cmd->se_lun,
    NULL, cmd->orig_fe_lun, l_isid,
    sa_res_key, all_tg_pt, aptpl);
 if (!local_pr_reg) {
  kfree(tidh_new);
  return TCM_INSUFFICIENT_REGISTRATION_RESOURCES;
 }

 if (core_scsi3_lunacl_depend_item(local_pr_reg->pr_reg_deve)) {
  kfree(tidh_new);
  kref_put(&local_pr_reg->pr_reg_deve->pr_kref,
    target_pr_kref_release);
  kmem_cache_free(t10_pr_reg_cache, local_pr_reg);
  return TCM_INSUFFICIENT_REGISTRATION_RESOURCES;
 }

 tidh_new->dest_pr_reg = local_pr_reg;
 list_add_tail(&tidh_new->dest_list, &tid_dest_list);

 if (cmd->data_length < 28) {
  pr_warn("SPC-PR: Received PR OUT parameter list"
   " length too small: %u\n", cmd->data_length);
  ret = TCM_INVALID_PARAMETER_LIST;
  goto out;
 }

 buf = transport_kmap_data_sg(cmd);
 if (!buf) {
  ret = TCM_INSUFFICIENT_REGISTRATION_RESOURCES;
  goto out;
 }

 /*
 * For a PERSISTENT RESERVE OUT specify initiator ports payload,
 * first extract TransportID Parameter Data Length, and make sure
 * the value matches up to the SCSI expected data transfer length.
 */

 tpdl = get_unaligned_be32(&buf[24]);

 if ((tpdl + 28) != cmd->data_length) {
  pr_err("SPC-3 PR: Illegal tpdl: %u + 28 byte header"
   " does not equal CDB data_length: %u\n", tpdl,
   cmd->data_length);
  ret = TCM_INVALID_PARAMETER_LIST;
  goto out_unmap;
 }
 /*
 * Start processing the received transport IDs using the
 * receiving I_T Nexus portal's fabric dependent methods to
 * obtain the SCSI Initiator Port/Device Identifiers.
 */

 ptr = &buf[28];

 while (tpdl > 0) {
  struct se_lun *dest_lun, *tmp_lun;

  proto_ident = (ptr[0] & 0x0f);
  dest_tpg = NULL;

  spin_lock(&dev->se_port_lock);
  list_for_each_entry(tmp_lun, &dev->dev_sep_list, lun_dev_link) {
   tmp_tpg = tmp_lun->lun_tpg;

   /*
 * Look for the matching proto_ident provided by
 * the received TransportID
 */

   if (tmp_tpg->proto_id != proto_ident)
    continue;
   dest_rtpi = tmp_lun->lun_tpg->tpg_rtpi;

   iport_ptr = NULL;
   tid_found = target_parse_pr_out_transport_id(tmp_tpg,
     ptr, &tid_len, &iport_ptr, i_str);
   if (!tid_found)
    continue;
   /*
 * Determine if this SCSI device server requires that
 * SCSI Intiatior TransportID w/ ISIDs is enforced
 * for fabric modules (iSCSI) requiring them.
 */

   if (tpg->se_tpg_tfo->sess_get_initiator_sid &&
       dev->dev_attrib.enforce_pr_isids &&
       !iport_ptr) {
    pr_warn("SPC-PR: enforce_pr_isids is set but a isid has not been sent in the SPEC_I_PT data for %s.",
     i_str);
    ret = TCM_INVALID_PARAMETER_LIST;
    spin_unlock(&dev->se_port_lock);
    goto out_unmap;
   }

   atomic_inc_mb(&tmp_tpg->tpg_pr_ref_count);
   spin_unlock(&dev->se_port_lock);

   if (core_scsi3_tpg_depend_item(tmp_tpg)) {
    pr_err(" core_scsi3_tpg_depend_item()"
     " for tmp_tpg\n");
    atomic_dec_mb(&tmp_tpg->tpg_pr_ref_count);
    ret = TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE;
    goto out_unmap;
   }
   /*
 * Locate the destination initiator ACL to be registered
 * from the decoded fabric module specific TransportID
 * at *i_str.
 */

   mutex_lock(&tmp_tpg->acl_node_mutex);
   dest_node_acl = __core_tpg_get_initiator_node_acl(
      tmp_tpg, i_str);
   if (dest_node_acl)
    atomic_inc_mb(&dest_node_acl->acl_pr_ref_count);
   mutex_unlock(&tmp_tpg->acl_node_mutex);

   if (!dest_node_acl) {
    core_scsi3_tpg_undepend_item(tmp_tpg);
    spin_lock(&dev->se_port_lock);
    continue;
   }

   if (core_scsi3_nodeacl_depend_item(dest_node_acl)) {
    pr_err("configfs_depend_item() failed"
     " for dest_node_acl->acl_group\n");
    atomic_dec_mb(&dest_node_acl->acl_pr_ref_count);
    core_scsi3_tpg_undepend_item(tmp_tpg);
    ret = TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE;
    goto out_unmap;
   }

   dest_tpg = tmp_tpg;
   pr_debug("SPC-3 PR SPEC_I_PT: Located %s Node: %s Port RTPI: %u\n",
    dest_tpg->se_tpg_tfo->fabric_name,
    dest_node_acl->initiatorname, dest_rtpi);

   spin_lock(&dev->se_port_lock);
   break;
  }
  spin_unlock(&dev->se_port_lock);

  if (!dest_tpg) {
   pr_err("SPC-3 PR SPEC_I_PT: Unable to locate"
     " dest_tpg\n");
   ret = TCM_INVALID_PARAMETER_LIST;
   goto out_unmap;
  }

  pr_debug("SPC-3 PR SPEC_I_PT: Got %s data_length: %u tpdl: %u"
   " tid_len: %d for %s + %s\n",
   dest_tpg->se_tpg_tfo->fabric_name, cmd->data_length,
   tpdl, tid_len, i_str, iport_ptr);

  if (tid_len > tpdl) {
   pr_err("SPC-3 PR SPEC_I_PT: Illegal tid_len:"
    " %u for Transport ID: %s\n", tid_len, ptr);
   core_scsi3_nodeacl_undepend_item(dest_node_acl);
   core_scsi3_tpg_undepend_item(dest_tpg);
   ret = TCM_INVALID_PARAMETER_LIST;
   goto out_unmap;
  }
  /*
 * Locate the desintation struct se_dev_entry pointer for matching
 * RELATIVE TARGET PORT IDENTIFIER on the receiving I_T Nexus
 * Target Port.
 */

  dest_se_deve = core_get_se_deve_from_rtpi(dest_node_acl,
     dest_rtpi);
  if (!dest_se_deve) {
   pr_err("Unable to locate %s dest_se_deve from destination RTPI: %u\n",
    dest_tpg->se_tpg_tfo->fabric_name,
    dest_rtpi);

   core_scsi3_nodeacl_undepend_item(dest_node_acl);
   core_scsi3_tpg_undepend_item(dest_tpg);
   ret = TCM_INVALID_PARAMETER_LIST;
   goto out_unmap;
  }

  if (core_scsi3_lunacl_depend_item(dest_se_deve)) {
   pr_err("core_scsi3_lunacl_depend_item()"
     " failed\n");
   kref_put(&dest_se_deve->pr_kref, target_pr_kref_release);
   core_scsi3_nodeacl_undepend_item(dest_node_acl);
   core_scsi3_tpg_undepend_item(dest_tpg);
   ret = TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE;
   goto out_unmap;
  }

  pr_debug("SPC-3 PR SPEC_I_PT: Located %s Node: %s"
   " dest_se_deve mapped_lun: %llu\n",
   dest_tpg->se_tpg_tfo->fabric_name,
   dest_node_acl->initiatorname, dest_se_deve->mapped_lun);

  /*
 * Skip any TransportIDs that already have a registration for
 * this target port.
 */

  pr_reg_e = __core_scsi3_locate_pr_reg(dev, dest_node_acl,
     iport_ptr);
  if (pr_reg_e) {
   core_scsi3_put_pr_reg(pr_reg_e);
   core_scsi3_lunacl_undepend_item(dest_se_deve);
   core_scsi3_nodeacl_undepend_item(dest_node_acl);
   core_scsi3_tpg_undepend_item(dest_tpg);
   ptr += tid_len;
   tpdl -= tid_len;
   tid_len = 0;
   continue;
  }
  /*
 * Allocate a struct pr_transport_id_holder and setup
 * the dest_node_acl and dest_se_deve pointers for the
 * loop below.
 */

  tidh_new = kzalloc(sizeof(struct pr_transport_id_holder),
    GFP_KERNEL);
  if (!tidh_new) {
   pr_err("Unable to allocate tidh_new\n");
   core_scsi3_lunacl_undepend_item(dest_se_deve);
   core_scsi3_nodeacl_undepend_item(dest_node_acl);
   core_scsi3_tpg_undepend_item(dest_tpg);
   ret = TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE;
   goto out_unmap;
  }
  INIT_LIST_HEAD(&tidh_new->dest_list);
  tidh_new->dest_tpg = dest_tpg;
  tidh_new->dest_node_acl = dest_node_acl;
  tidh_new->dest_se_deve = dest_se_deve;

  /*
 * Allocate, but do NOT add the registration for the
 * TransportID referenced SCSI Initiator port.  This
 * done because of the following from spc4r17 in section
 * 6.14.3 wrt SPEC_I_PT:
 *
 * "If a registration fails for any initiator port (e.g., if th
 * logical unit does not have enough resources available to
 * hold the registration information), no registrations shall be
 * made, and the command shall be terminated with
 * CHECK CONDITION status."
 *
 * That means we call __core_scsi3_alloc_registration() here,
 * and then call __core_scsi3_add_registration() in the
 * 2nd loop which will never fail.
 */

  dest_lun = dest_se_deve->se_lun;

  dest_pr_reg = __core_scsi3_alloc_registration(cmd->se_dev,
     dest_node_acl, dest_lun, dest_se_deve,
     dest_se_deve->mapped_lun, iport_ptr,
     sa_res_key, all_tg_pt, aptpl);
  if (!dest_pr_reg) {
   core_scsi3_lunacl_undepend_item(dest_se_deve);
   core_scsi3_nodeacl_undepend_item(dest_node_acl);
   core_scsi3_tpg_undepend_item(dest_tpg);
   kfree(tidh_new);
   ret = TCM_INSUFFICIENT_REGISTRATION_RESOURCES;
   goto out_unmap;
  }
  tidh_new->dest_pr_reg = dest_pr_reg;
  list_add_tail(&tidh_new->dest_list, &tid_dest_list);

  ptr += tid_len;
  tpdl -= tid_len;
  tid_len = 0;

 }

 transport_kunmap_data_sg(cmd);

 /*
 * Go ahead and create a registrations from tid_dest_list for the
 * SPEC_I_PT provided TransportID for the *tidh referenced dest_node_acl
 * and dest_se_deve.
 *
 * The SA Reservation Key from the PROUT is set for the
 * registration, and ALL_TG_PT is also passed.  ALL_TG_PT=1
 * means that the TransportID Initiator port will be
 * registered on all of the target ports in the SCSI target device
 * ALL_TG_PT=0 means the registration will only be for the
 * SCSI target port the PROUT REGISTER with SPEC_I_PT=1
 * was received.
 */

 list_for_each_entry_safe(tidh, tidh_tmp, &tid_dest_list, dest_list) {
  dest_tpg = tidh->dest_tpg;
  dest_node_acl = tidh->dest_node_acl;
  dest_se_deve = tidh->dest_se_deve;
  dest_pr_reg = tidh->dest_pr_reg;

  list_del(&tidh->dest_list);
  kfree(tidh);

  memset(i_buf, 0, PR_REG_ISID_ID_LEN);
  core_pr_dump_initiator_port(dest_pr_reg, i_buf, PR_REG_ISID_ID_LEN);

  __core_scsi3_add_registration(cmd->se_dev, dest_node_acl,
     dest_pr_reg, 0, 0);

  pr_debug("SPC-3 PR [%s] SPEC_I_PT: Successfully"
   " registered Transport ID for Node: %s%s Mapped LUN:"
   " %llu\n", dest_tpg->se_tpg_tfo->fabric_name,
   dest_node_acl->initiatorname, i_buf, (dest_se_deve) ?
   dest_se_deve->mapped_lun : 0);

  if (dest_pr_reg == local_pr_reg)
   continue;

  core_scsi3_nodeacl_undepend_item(dest_node_acl);
  core_scsi3_tpg_undepend_item(dest_tpg);
 }

 return 0;
out_unmap:
 transport_kunmap_data_sg(cmd);
out:
 /*
 * For the failure case, release everything from tid_dest_list
 * including *dest_pr_reg and the configfs dependances..
 */

 list_for_each_entry_safe(tidh, tidh_tmp, &tid_dest_list, dest_list) {
  bool is_local = false;

  dest_tpg = tidh->dest_tpg;
  dest_node_acl = tidh->dest_node_acl;
  dest_se_deve = tidh->dest_se_deve;
  dest_pr_reg = tidh->dest_pr_reg;

  if (dest_pr_reg == local_pr_reg)
   is_local = true;

  list_del(&tidh->dest_list);
  kfree(tidh);
  /*
 * Release any extra ALL_TG_PT=1 registrations for
 * the SPEC_I_PT=1 case.
 */

  list_for_each_entry_safe(pr_reg_tmp, pr_reg_tmp_safe,
    &dest_pr_reg->pr_reg_atp_list,
    pr_reg_atp_mem_list) {
   list_del(&pr_reg_tmp->pr_reg_atp_mem_list);
   core_scsi3_lunacl_undepend_item(pr_reg_tmp->pr_reg_deve);
   kmem_cache_free(t10_pr_reg_cache, pr_reg_tmp);
  }

  kmem_cache_free(t10_pr_reg_cache, dest_pr_reg);

  if (dest_se_deve)
   core_scsi3_lunacl_undepend_item(dest_se_deve);

  if (is_local)
   continue;

  core_scsi3_nodeacl_undepend_item(dest_node_acl);
  core_scsi3_tpg_undepend_item(dest_tpg);
 }
 return ret;
}

static int core_scsi3_update_aptpl_buf(
 struct se_device *dev,
 unsigned char *buf,
 u32 pr_aptpl_buf_len)
{
 struct se_portal_group *tpg;
 struct t10_pr_registration *pr_reg;
 unsigned char tmp[512], isid_buf[32];
 ssize_t len = 0;
 int reg_count = 0;
 int ret = 0;

 spin_lock(&dev->dev_reservation_lock);
 spin_lock(&dev->t10_pr.registration_lock);
 /*
 * Walk the registration list..
 */

 list_for_each_entry(pr_reg, &dev->t10_pr.registration_list,
   pr_reg_list) {

  tmp[0] = '\0';
  isid_buf[0] = '\0';
  tpg = pr_reg->pr_reg_nacl->se_tpg;
  /*
 * Write out any ISID value to APTPL metadata that was included
 * in the original registration.
 */

  if (pr_reg->isid_present_at_reg)
   snprintf(isid_buf, 32, "initiator_sid=%s\n",
     pr_reg->pr_reg_isid);
  /*
 * Include special metadata if the pr_reg matches the
 * reservation holder.
 */

  if (dev->dev_pr_res_holder == pr_reg) {
   snprintf(tmp, 512, "PR_REG_START: %d"
    "\ninitiator_fabric=%s\n"
    "initiator_node=%s\n%s"
    "sa_res_key=%llu\n"
    "res_holder=1\nres_type=%02x\n"
    "res_scope=%02x\nres_all_tg_pt=%d\n"
    "mapped_lun=%llu\n", reg_count,
    tpg->se_tpg_tfo->fabric_name,
    pr_reg->pr_reg_nacl->initiatorname, isid_buf,
    pr_reg->pr_res_key, pr_reg->pr_res_type,
    pr_reg->pr_res_scope, pr_reg->pr_reg_all_tg_pt,
    pr_reg->pr_res_mapped_lun);
  } else {
   snprintf(tmp, 512, "PR_REG_START: %d\n"
    "initiator_fabric=%s\ninitiator_node=%s\n%s"
    "sa_res_key=%llu\nres_holder=0\n"
    "res_all_tg_pt=%d\nmapped_lun=%llu\n",
    reg_count, tpg->se_tpg_tfo->fabric_name,
    pr_reg->pr_reg_nacl->initiatorname, isid_buf,
    pr_reg->pr_res_key, pr_reg->pr_reg_all_tg_pt,
    pr_reg->pr_res_mapped_lun);
  }

  if ((len + strlen(tmp) >= pr_aptpl_buf_len)) {
   pr_err("Unable to update renaming APTPL metadata,"
          " reallocating larger buffer\n");
   ret = -EMSGSIZE;
   goto out;
  }
  len += sprintf(buf+len, "%s", tmp);

  /*
 * Include information about the associated SCSI target port.
 */

  snprintf(tmp, 512, "target_fabric=%s\ntarget_node=%s\n"
   "tpgt=%hu\nport_rtpi=%hu\ntarget_lun=%llu\nPR_REG_END:"
   " %d\n", tpg->se_tpg_tfo->fabric_name,
   tpg->se_tpg_tfo->tpg_get_wwn(tpg),
   tpg->se_tpg_tfo->tpg_get_tag(tpg),
   pr_reg->tg_pt_sep_rtpi, pr_reg->pr_aptpl_target_lun,
   reg_count);

  if ((len + strlen(tmp) >= pr_aptpl_buf_len)) {
   pr_err("Unable to update renaming APTPL metadata,"
          " reallocating larger buffer\n");
   ret = -EMSGSIZE;
   goto out;
  }
  len += sprintf(buf+len, "%s", tmp);
  reg_count++;
 }

 if (!reg_count)
  len += sprintf(buf+len, "No Registrations or Reservations");

out:
 spin_unlock(&dev->t10_pr.registration_lock);
 spin_unlock(&dev->dev_reservation_lock);

 return ret;
}

static int __core_scsi3_write_aptpl_to_file(
 struct se_device *dev,
 unsigned char *buf)
{
 struct t10_wwn *wwn = &dev->t10_wwn;
 struct file *file;
 int flags = O_RDWR | O_CREAT | O_TRUNC;
 char *path;
 u32 pr_aptpl_buf_len;
 int ret;
 loff_t pos = 0;

 path = kasprintf(GFP_KERNEL, "%s/pr/aptpl_%s", db_root,
   &wwn->unit_serial[0]);
 if (!path)
  return -ENOMEM;

 file = filp_open(path, flags, 0600);
 if (IS_ERR(file)) {
  pr_err("filp_open(%s) for APTPL metadata"
   " failed\n", path);
  kfree(path);
  return PTR_ERR(file);
 }

 pr_aptpl_buf_len = (strlen(buf) + 1); /* Add extra for NULL */

 ret = kernel_write(file, buf, pr_aptpl_buf_len, &pos);

 if (ret < 0)
  pr_debug("Error writing APTPL metadata file: %s\n", path);
 fput(file);
 kfree(path);

 return (ret < 0) ? -EIO : 0;
}

/*
 * Clear the APTPL metadata if APTPL has been disabled, otherwise
 * write out the updated metadata to struct file for this SCSI device.
 */

static sense_reason_t core_scsi3_update_and_write_aptpl(struct se_device *dev, bool aptpl)
{
 unsigned char *buf;
 int rc, len = PR_APTPL_BUF_LEN;

 if (!aptpl) {
  char *null_buf = "No Registrations or Reservations\n";

  rc = __core_scsi3_write_aptpl_to_file(dev, null_buf);
  dev->t10_pr.pr_aptpl_active = 0;
  pr_debug("SPC-3 PR: Set APTPL Bit Deactivated\n");

  if (rc)
   return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE;

  return 0;
 }
retry:
 buf = vzalloc(len);
 if (!buf)
  return TCM_OUT_OF_RESOURCES;

 rc = core_scsi3_update_aptpl_buf(dev, buf, len);
 if (rc < 0) {
  vfree(buf);
  len *= 2;
  goto retry;
 }

 rc = __core_scsi3_write_aptpl_to_file(dev, buf);
 if (rc != 0) {
  pr_err("SPC-3 PR: Could not update APTPL\n");
  vfree(buf);
  return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE;
 }
 dev->t10_pr.pr_aptpl_active = 1;
 vfree(buf);
 pr_debug("SPC-3 PR: Set APTPL Bit Activated\n");
 return 0;
}

static sense_reason_t
core_scsi3_emulate_pro_register(struct se_cmd *cmd, u64 res_key, u64 sa_res_key,
  bool aptpl, bool all_tg_pt, bool spec_i_pt, enum register_type register_type)
{
 struct se_session *se_sess = cmd->se_sess;
 struct se_device *dev = cmd->se_dev;
 struct se_lun *se_lun = cmd->se_lun;
 struct se_portal_group *se_tpg;
 struct t10_pr_registration *pr_reg, *pr_reg_p, *pr_reg_tmp;
 struct t10_reservation *pr_tmpl = &dev->t10_pr;
 unsigned char isid_buf[PR_REG_ISID_LEN] = { };
 unsigned char *isid_ptr = NULL;
 sense_reason_t ret = TCM_NO_SENSE;
 int pr_holder = 0, type;

 if (!se_sess || !se_lun) {
  pr_err("SPC-3 PR: se_sess || struct se_lun is NULL!\n");
  return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE;
 }
 se_tpg = se_sess->se_tpg;

 if (se_tpg->se_tpg_tfo->sess_get_initiator_sid) {
  se_tpg->se_tpg_tfo->sess_get_initiator_sid(se_sess, &isid_buf[0],
    PR_REG_ISID_LEN);
  isid_ptr = &isid_buf[0];
 }
 /*
 * Follow logic from spc4r17 Section 5.7.7, Register Behaviors Table 47
 */

 pr_reg = core_scsi3_locate_pr_reg(dev, se_sess->se_node_acl, se_sess);
 if (!pr_reg) {
  if (res_key) {
   pr_warn("SPC-3 PR: Reservation Key non-zero"
    " for SA REGISTER, returning CONFLICT\n");
   return TCM_RESERVATION_CONFLICT;
  }
  /*
 * Do nothing but return GOOD status.
 */

  if (!sa_res_key)
   return 0;

  if (!spec_i_pt) {
   /*
 * Perform the Service Action REGISTER on the Initiator
 * Port Endpoint that the PRO was received from on the
 * Logical Unit of the SCSI device server.
 */

   if (core_scsi3_alloc_registration(cmd->se_dev,
     se_sess->se_node_acl, cmd->se_lun,
     NULL, cmd->orig_fe_lun, isid_ptr,
     sa_res_key, all_tg_pt, aptpl,
     register_type, 0)) {
    pr_err("Unable to allocate"
     " struct t10_pr_registration\n");
    return TCM_INSUFFICIENT_REGISTRATION_RESOURCES;
   }
  } else {
   /*
 * Register both the Initiator port that received
 * PROUT SA REGISTER + SPEC_I_PT=1 and extract SCSI
 * TransportID from Parameter list and loop through
 * fabric dependent parameter list while calling
 * logic from of core_scsi3_alloc_registration() for
 * each TransportID provided SCSI Initiator Port/Device
 */

   ret = core_scsi3_decode_spec_i_port(cmd, se_tpg,
     isid_ptr, sa_res_key, all_tg_pt, aptpl);
   if (ret != 0)
    return ret;
  }
  return core_scsi3_update_and_write_aptpl(dev, aptpl);
 }

 /* ok, existing registration */

 if ((register_type == REGISTER) && (res_key != pr_reg->pr_res_key)) {
  pr_err("SPC-3 PR REGISTER: Received"
         " res_key: 0x%016Lx does not match"
         " existing SA REGISTER res_key:"
         " 0x%016Lx\n", res_key,
         pr_reg->pr_res_key);
  ret = TCM_RESERVATION_CONFLICT;
  goto out;
 }

 if (spec_i_pt) {
  pr_err("SPC-3 PR REGISTER: SPEC_I_PT"
   " set on a registered nexus\n");
  ret = TCM_INVALID_PARAMETER_LIST;
  goto out;
 }

 /*
 * An existing ALL_TG_PT=1 registration being released
 * must also set ALL_TG_PT=1 in the incoming PROUT.
 */

 if (pr_reg->pr_reg_all_tg_pt && !all_tg_pt) {
  pr_err("SPC-3 PR REGISTER: ALL_TG_PT=1"
   " registration exists, but ALL_TG_PT=1 bit not"
   " present in received PROUT\n");
  ret = TCM_INVALID_CDB_FIELD;
  goto out;
 }

 /*
 * sa_res_key=1 Change Reservation Key for registered I_T Nexus.
 */

 if (sa_res_key) {
  /*
 * Increment PRgeneration counter for struct se_device"
 * upon a successful REGISTER, see spc4r17 section 6.3.2
 * READ_KEYS service action.
 */

  pr_reg->pr_res_generation = core_scsi3_pr_generation(cmd->se_dev);
  pr_reg->pr_res_key = sa_res_key;
  pr_debug("SPC-3 PR [%s] REGISTER%s: Changed Reservation"
    " Key for %s to: 0x%016Lx PRgeneration:"
    " 0x%08x\n", cmd->se_tfo->fabric_name,
    (register_type == REGISTER_AND_IGNORE_EXISTING_KEY) ? "_AND_IGNORE_EXISTING_KEY" : "",
    pr_reg->pr_reg_nacl->initiatorname,
    pr_reg->pr_res_key, pr_reg->pr_res_generation);

 } else {
  /*
 * sa_res_key=0 Unregister Reservation Key for registered I_T Nexus.
 */

  type = pr_reg->pr_res_type;
  pr_holder = core_scsi3_check_implicit_release(cmd->se_dev,
             pr_reg);
  if (pr_holder < 0) {
   ret = TCM_RESERVATION_CONFLICT;
   goto out;
  }

  spin_lock(&pr_tmpl->registration_lock);
  /*
 * Release all ALL_TG_PT=1 for the matching SCSI Initiator Port
 * and matching pr_res_key.
 */

  if (pr_reg->pr_reg_all_tg_pt) {
   list_for_each_entry_safe(pr_reg_p, pr_reg_tmp,
     &pr_tmpl->registration_list,
     pr_reg_list) {

    if (!pr_reg_p->pr_reg_all_tg_pt)
     continue;
    if (pr_reg_p->pr_res_key != res_key)
     continue;
    if (pr_reg == pr_reg_p)
     continue;
    if (strcmp(pr_reg->pr_reg_nacl->initiatorname,
        pr_reg_p->pr_reg_nacl->initiatorname))
     continue;

    __core_scsi3_free_registration(dev,
      pr_reg_p, NULL, 0);
   }
  }

  /*
 * Release the calling I_T Nexus registration now..
 */

  __core_scsi3_free_registration(cmd->se_dev, pr_reg, NULL, 1);
  pr_reg = NULL;

  /*
 * From spc4r17, section 5.7.11.3 Unregistering
 *
 * If the persistent reservation is a registrants only
 * type, the device server shall establish a unit
 * attention condition for the initiator port associated
 * with every registered I_T nexus except for the I_T
 * nexus on which the PERSISTENT RESERVE OUT command was
 * received, with the additional sense code set to
 * RESERVATIONS RELEASED.
 */

  if (pr_holder &&
      (type == PR_TYPE_WRITE_EXCLUSIVE_REGONLY ||
       type == PR_TYPE_EXCLUSIVE_ACCESS_REGONLY)) {
   list_for_each_entry(pr_reg_p,
     &pr_tmpl->registration_list,
     pr_reg_list) {

    target_ua_allocate_lun(
     pr_reg_p->pr_reg_nacl,
     pr_reg_p->pr_res_mapped_lun,
     0x2A,
     ASCQ_2AH_RESERVATIONS_RELEASED);
   }
  }

  spin_unlock(&pr_tmpl->registration_lock);
 }

 ret = core_scsi3_update_and_write_aptpl(dev, aptpl);

out:
 if (pr_reg)
  core_scsi3_put_pr_reg(pr_reg);
 return ret;
}

unsigned char *core_scsi3_pr_dump_type(int type)
{
 switch (type) {
 case PR_TYPE_WRITE_EXCLUSIVE:
  return "Write Exclusive Access";
 case PR_TYPE_EXCLUSIVE_ACCESS:
  return "Exclusive Access";
 case PR_TYPE_WRITE_EXCLUSIVE_REGONLY:
  return "Write Exclusive Access, Registrants Only";
 case PR_TYPE_EXCLUSIVE_ACCESS_REGONLY:
  return "Exclusive Access, Registrants Only";
 case PR_TYPE_WRITE_EXCLUSIVE_ALLREG:
  return "Write Exclusive Access, All Registrants";
 case PR_TYPE_EXCLUSIVE_ACCESS_ALLREG:
  return "Exclusive Access, All Registrants";
 default:
  break;
 }

 return "Unknown SPC-3 PR Type";
}

static sense_reason_t
core_scsi3_pro_reserve(struct se_cmd *cmd, int type, int scope, u64 res_key)
{
 struct se_device *dev = cmd->se_dev;
 struct se_session *se_sess = cmd->se_sess;
 struct se_lun *se_lun = cmd->se_lun;
 struct t10_pr_registration *pr_reg, *pr_res_holder;
 struct t10_reservation *pr_tmpl = &dev->t10_pr;
 char i_buf[PR_REG_ISID_ID_LEN] = { };
 sense_reason_t ret;

 if (!se_sess || !se_lun) {
  pr_err("SPC-3 PR: se_sess || struct se_lun is NULL!\n");
--> --------------------

--> maximum size reached

--> --------------------

Messung V0.5
C=96 H=95 G=95

¤ Dauer der Verarbeitung: 0.19 Sekunden  ¤

*© Formatika GbR, Deutschland






Wurzel

Suchen

Beweissystem der NASA

Beweissystem Isabelle

NIST Cobol Testsuite

Cephes Mathematical Library

Wiener Entwicklungsmethode

Haftungshinweis

Die Informationen auf dieser Webseite wurden nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit, noch Qualität der bereit gestellten Informationen zugesichert.

Bemerkung:

Die farbliche Syntaxdarstellung und die Messung sind noch experimentell.