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;
}
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;
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.
*/ staticint core_scsi3_pr_seq_non_holder(struct se_cmd *cmd, u32 pr_reg_type, bool isid_mismatch)
{ unsignedchar *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 */
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;
}
} elseif ((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;
}
} elseif (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));
/* * 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);
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;
}
/* * Function used for handling PR registrations for ALL_TG_PT=1 and ALL_TG_PT=0 * modes.
*/ staticstruct 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, unsignedchar *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; conststruct 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;
int core_scsi3_alloc_aptpl_registration( struct t10_reservation *pr_tmpl,
u64 sa_res_key, unsignedchar *i_port, unsignedchar *isid,
u64 mapped_lun, unsignedchar *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;
/* * 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);
/* * 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_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;
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.
*/
} elseif (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);
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();
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);
/* * 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;
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;
/* * 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;
}
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);
/* * 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;
/* * 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;
/* * 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)
{ unsignedchar *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;
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;
/* * 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) {
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.