target_core_tmr.c 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388
  1. /*******************************************************************************
  2. * Filename: target_core_tmr.c
  3. *
  4. * This file contains SPC-3 task management infrastructure
  5. *
  6. * (c) Copyright 2009-2013 Datera, Inc.
  7. *
  8. * Nicholas A. Bellinger <nab@kernel.org>
  9. *
  10. * This program is free software; you can redistribute it and/or modify
  11. * it under the terms of the GNU General Public License as published by
  12. * the Free Software Foundation; either version 2 of the License, or
  13. * (at your option) any later version.
  14. *
  15. * This program is distributed in the hope that it will be useful,
  16. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  17. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  18. * GNU General Public License for more details.
  19. *
  20. * You should have received a copy of the GNU General Public License
  21. * along with this program; if not, write to the Free Software
  22. * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  23. *
  24. ******************************************************************************/
  25. #include <linux/slab.h>
  26. #include <linux/spinlock.h>
  27. #include <linux/list.h>
  28. #include <linux/export.h>
  29. #include <target/target_core_base.h>
  30. #include <target/target_core_backend.h>
  31. #include <target/target_core_fabric.h>
  32. #include "target_core_internal.h"
  33. #include "target_core_alua.h"
  34. #include "target_core_pr.h"
  35. int core_tmr_alloc_req(
  36. struct se_cmd *se_cmd,
  37. void *fabric_tmr_ptr,
  38. u8 function,
  39. gfp_t gfp_flags)
  40. {
  41. struct se_tmr_req *tmr;
  42. tmr = kzalloc(sizeof(struct se_tmr_req), gfp_flags);
  43. if (!tmr) {
  44. pr_err("Unable to allocate struct se_tmr_req\n");
  45. return -ENOMEM;
  46. }
  47. se_cmd->se_cmd_flags |= SCF_SCSI_TMR_CDB;
  48. se_cmd->se_tmr_req = tmr;
  49. tmr->task_cmd = se_cmd;
  50. tmr->fabric_tmr_ptr = fabric_tmr_ptr;
  51. tmr->function = function;
  52. INIT_LIST_HEAD(&tmr->tmr_list);
  53. return 0;
  54. }
  55. EXPORT_SYMBOL(core_tmr_alloc_req);
  56. void core_tmr_release_req(struct se_tmr_req *tmr)
  57. {
  58. struct se_device *dev = tmr->tmr_dev;
  59. unsigned long flags;
  60. if (dev) {
  61. spin_lock_irqsave(&dev->se_tmr_lock, flags);
  62. list_del(&tmr->tmr_list);
  63. spin_unlock_irqrestore(&dev->se_tmr_lock, flags);
  64. }
  65. kfree(tmr);
  66. }
  67. static void core_tmr_handle_tas_abort(
  68. struct se_node_acl *tmr_nacl,
  69. struct se_cmd *cmd,
  70. int tas)
  71. {
  72. bool remove = true;
  73. /*
  74. * TASK ABORTED status (TAS) bit support
  75. */
  76. if ((tmr_nacl && (tmr_nacl != cmd->se_sess->se_node_acl)) && tas) {
  77. remove = false;
  78. transport_send_task_abort(cmd);
  79. }
  80. transport_cmd_finish_abort(cmd, remove);
  81. }
  82. static int target_check_cdb_and_preempt(struct list_head *list,
  83. struct se_cmd *cmd)
  84. {
  85. struct t10_pr_registration *reg;
  86. if (!list)
  87. return 0;
  88. list_for_each_entry(reg, list, pr_reg_abort_list) {
  89. if (reg->pr_res_key == cmd->pr_res_key)
  90. return 0;
  91. }
  92. return 1;
  93. }
  94. void core_tmr_abort_task(
  95. struct se_device *dev,
  96. struct se_tmr_req *tmr,
  97. struct se_session *se_sess)
  98. {
  99. struct se_cmd *se_cmd;
  100. unsigned long flags;
  101. u64 ref_tag;
  102. spin_lock_irqsave(&se_sess->sess_cmd_lock, flags);
  103. list_for_each_entry(se_cmd, &se_sess->sess_cmd_list, se_cmd_list) {
  104. if (dev != se_cmd->se_dev)
  105. continue;
  106. /* skip task management functions, including tmr->task_cmd */
  107. if (se_cmd->se_cmd_flags & SCF_SCSI_TMR_CDB)
  108. continue;
  109. ref_tag = se_cmd->tag;
  110. if (tmr->ref_task_tag != ref_tag)
  111. continue;
  112. printk("ABORT_TASK: Found referenced %s task_tag: %llu\n",
  113. se_cmd->se_tfo->get_fabric_name(), ref_tag);
  114. spin_lock(&se_cmd->t_state_lock);
  115. if (se_cmd->transport_state & CMD_T_COMPLETE) {
  116. printk("ABORT_TASK: ref_tag: %llu already complete,"
  117. " skipping\n", ref_tag);
  118. spin_unlock(&se_cmd->t_state_lock);
  119. spin_unlock_irqrestore(&se_sess->sess_cmd_lock, flags);
  120. goto out;
  121. }
  122. se_cmd->transport_state |= CMD_T_ABORTED;
  123. spin_unlock(&se_cmd->t_state_lock);
  124. list_del_init(&se_cmd->se_cmd_list);
  125. kref_get(&se_cmd->cmd_kref);
  126. spin_unlock_irqrestore(&se_sess->sess_cmd_lock, flags);
  127. cancel_work_sync(&se_cmd->work);
  128. transport_wait_for_tasks(se_cmd);
  129. target_put_sess_cmd(se_cmd);
  130. transport_cmd_finish_abort(se_cmd, true);
  131. printk("ABORT_TASK: Sending TMR_FUNCTION_COMPLETE for"
  132. " ref_tag: %llu\n", ref_tag);
  133. tmr->response = TMR_FUNCTION_COMPLETE;
  134. return;
  135. }
  136. spin_unlock_irqrestore(&se_sess->sess_cmd_lock, flags);
  137. out:
  138. printk("ABORT_TASK: Sending TMR_TASK_DOES_NOT_EXIST for ref_tag: %lld\n",
  139. tmr->ref_task_tag);
  140. tmr->response = TMR_TASK_DOES_NOT_EXIST;
  141. }
  142. static void core_tmr_drain_tmr_list(
  143. struct se_device *dev,
  144. struct se_tmr_req *tmr,
  145. struct list_head *preempt_and_abort_list)
  146. {
  147. LIST_HEAD(drain_tmr_list);
  148. struct se_tmr_req *tmr_p, *tmr_pp;
  149. struct se_cmd *cmd;
  150. unsigned long flags;
  151. /*
  152. * Release all pending and outgoing TMRs aside from the received
  153. * LUN_RESET tmr..
  154. */
  155. spin_lock_irqsave(&dev->se_tmr_lock, flags);
  156. list_for_each_entry_safe(tmr_p, tmr_pp, &dev->dev_tmr_list, tmr_list) {
  157. /*
  158. * Allow the received TMR to return with FUNCTION_COMPLETE.
  159. */
  160. if (tmr_p == tmr)
  161. continue;
  162. cmd = tmr_p->task_cmd;
  163. if (!cmd) {
  164. pr_err("Unable to locate struct se_cmd for TMR\n");
  165. continue;
  166. }
  167. /*
  168. * If this function was called with a valid pr_res_key
  169. * parameter (eg: for PROUT PREEMPT_AND_ABORT service action
  170. * skip non regisration key matching TMRs.
  171. */
  172. if (target_check_cdb_and_preempt(preempt_and_abort_list, cmd))
  173. continue;
  174. spin_lock(&cmd->t_state_lock);
  175. if (!(cmd->transport_state & CMD_T_ACTIVE)) {
  176. spin_unlock(&cmd->t_state_lock);
  177. continue;
  178. }
  179. if (cmd->t_state == TRANSPORT_ISTATE_PROCESSING) {
  180. spin_unlock(&cmd->t_state_lock);
  181. continue;
  182. }
  183. spin_unlock(&cmd->t_state_lock);
  184. list_move_tail(&tmr_p->tmr_list, &drain_tmr_list);
  185. }
  186. spin_unlock_irqrestore(&dev->se_tmr_lock, flags);
  187. list_for_each_entry_safe(tmr_p, tmr_pp, &drain_tmr_list, tmr_list) {
  188. list_del_init(&tmr_p->tmr_list);
  189. cmd = tmr_p->task_cmd;
  190. pr_debug("LUN_RESET: %s releasing TMR %p Function: 0x%02x,"
  191. " Response: 0x%02x, t_state: %d\n",
  192. (preempt_and_abort_list) ? "Preempt" : "", tmr_p,
  193. tmr_p->function, tmr_p->response, cmd->t_state);
  194. transport_cmd_finish_abort(cmd, 1);
  195. }
  196. }
  197. static void core_tmr_drain_state_list(
  198. struct se_device *dev,
  199. struct se_cmd *prout_cmd,
  200. struct se_node_acl *tmr_nacl,
  201. int tas,
  202. struct list_head *preempt_and_abort_list)
  203. {
  204. LIST_HEAD(drain_task_list);
  205. struct se_cmd *cmd, *next;
  206. unsigned long flags;
  207. /*
  208. * Complete outstanding commands with TASK_ABORTED SAM status.
  209. *
  210. * This is following sam4r17, section 5.6 Aborting commands, Table 38
  211. * for TMR LUN_RESET:
  212. *
  213. * a) "Yes" indicates that each command that is aborted on an I_T nexus
  214. * other than the one that caused the SCSI device condition is
  215. * completed with TASK ABORTED status, if the TAS bit is set to one in
  216. * the Control mode page (see SPC-4). "No" indicates that no status is
  217. * returned for aborted commands.
  218. *
  219. * d) If the logical unit reset is caused by a particular I_T nexus
  220. * (e.g., by a LOGICAL UNIT RESET task management function), then "yes"
  221. * (TASK_ABORTED status) applies.
  222. *
  223. * Otherwise (e.g., if triggered by a hard reset), "no"
  224. * (no TASK_ABORTED SAM status) applies.
  225. *
  226. * Note that this seems to be independent of TAS (Task Aborted Status)
  227. * in the Control Mode Page.
  228. */
  229. spin_lock_irqsave(&dev->execute_task_lock, flags);
  230. list_for_each_entry_safe(cmd, next, &dev->state_list, state_list) {
  231. /*
  232. * For PREEMPT_AND_ABORT usage, only process commands
  233. * with a matching reservation key.
  234. */
  235. if (target_check_cdb_and_preempt(preempt_and_abort_list, cmd))
  236. continue;
  237. /*
  238. * Not aborting PROUT PREEMPT_AND_ABORT CDB..
  239. */
  240. if (prout_cmd == cmd)
  241. continue;
  242. list_move_tail(&cmd->state_list, &drain_task_list);
  243. cmd->state_active = false;
  244. }
  245. spin_unlock_irqrestore(&dev->execute_task_lock, flags);
  246. while (!list_empty(&drain_task_list)) {
  247. cmd = list_entry(drain_task_list.next, struct se_cmd, state_list);
  248. list_del(&cmd->state_list);
  249. pr_debug("LUN_RESET: %s cmd: %p"
  250. " ITT/CmdSN: 0x%08llx/0x%08x, i_state: %d, t_state: %d"
  251. "cdb: 0x%02x\n",
  252. (preempt_and_abort_list) ? "Preempt" : "", cmd,
  253. cmd->tag, 0,
  254. cmd->se_tfo->get_cmd_state(cmd), cmd->t_state,
  255. cmd->t_task_cdb[0]);
  256. pr_debug("LUN_RESET: ITT[0x%08llx] - pr_res_key: 0x%016Lx"
  257. " -- CMD_T_ACTIVE: %d"
  258. " CMD_T_STOP: %d CMD_T_SENT: %d\n",
  259. cmd->tag, cmd->pr_res_key,
  260. (cmd->transport_state & CMD_T_ACTIVE) != 0,
  261. (cmd->transport_state & CMD_T_STOP) != 0,
  262. (cmd->transport_state & CMD_T_SENT) != 0);
  263. /*
  264. * If the command may be queued onto a workqueue cancel it now.
  265. *
  266. * This is equivalent to removal from the execute queue in the
  267. * loop above, but we do it down here given that
  268. * cancel_work_sync may block.
  269. */
  270. if (cmd->t_state == TRANSPORT_COMPLETE)
  271. cancel_work_sync(&cmd->work);
  272. spin_lock_irqsave(&cmd->t_state_lock, flags);
  273. target_stop_cmd(cmd, &flags);
  274. cmd->transport_state |= CMD_T_ABORTED;
  275. spin_unlock_irqrestore(&cmd->t_state_lock, flags);
  276. core_tmr_handle_tas_abort(tmr_nacl, cmd, tas);
  277. }
  278. }
  279. int core_tmr_lun_reset(
  280. struct se_device *dev,
  281. struct se_tmr_req *tmr,
  282. struct list_head *preempt_and_abort_list,
  283. struct se_cmd *prout_cmd)
  284. {
  285. struct se_node_acl *tmr_nacl = NULL;
  286. struct se_portal_group *tmr_tpg = NULL;
  287. int tas;
  288. /*
  289. * TASK_ABORTED status bit, this is configurable via ConfigFS
  290. * struct se_device attributes. spc4r17 section 7.4.6 Control mode page
  291. *
  292. * A task aborted status (TAS) bit set to zero specifies that aborted
  293. * tasks shall be terminated by the device server without any response
  294. * to the application client. A TAS bit set to one specifies that tasks
  295. * aborted by the actions of an I_T nexus other than the I_T nexus on
  296. * which the command was received shall be completed with TASK ABORTED
  297. * status (see SAM-4).
  298. */
  299. tas = dev->dev_attrib.emulate_tas;
  300. /*
  301. * Determine if this se_tmr is coming from a $FABRIC_MOD
  302. * or struct se_device passthrough..
  303. */
  304. if (tmr && tmr->task_cmd && tmr->task_cmd->se_sess) {
  305. tmr_nacl = tmr->task_cmd->se_sess->se_node_acl;
  306. tmr_tpg = tmr->task_cmd->se_sess->se_tpg;
  307. if (tmr_nacl && tmr_tpg) {
  308. pr_debug("LUN_RESET: TMR caller fabric: %s"
  309. " initiator port %s\n",
  310. tmr_tpg->se_tpg_tfo->get_fabric_name(),
  311. tmr_nacl->initiatorname);
  312. }
  313. }
  314. pr_debug("LUN_RESET: %s starting for [%s], tas: %d\n",
  315. (preempt_and_abort_list) ? "Preempt" : "TMR",
  316. dev->transport->name, tas);
  317. core_tmr_drain_tmr_list(dev, tmr, preempt_and_abort_list);
  318. core_tmr_drain_state_list(dev, prout_cmd, tmr_nacl, tas,
  319. preempt_and_abort_list);
  320. /*
  321. * Clear any legacy SPC-2 reservation when called during
  322. * LOGICAL UNIT RESET
  323. */
  324. if (!preempt_and_abort_list &&
  325. (dev->dev_reservation_flags & DRF_SPC2_RESERVATIONS)) {
  326. spin_lock(&dev->dev_reservation_lock);
  327. dev->dev_reserved_node_acl = NULL;
  328. dev->dev_reservation_flags &= ~DRF_SPC2_RESERVATIONS;
  329. spin_unlock(&dev->dev_reservation_lock);
  330. pr_debug("LUN_RESET: SCSI-2 Released reservation\n");
  331. }
  332. atomic_long_inc(&dev->num_resets);
  333. pr_debug("LUN_RESET: %s for [%s] Complete\n",
  334. (preempt_and_abort_list) ? "Preempt" : "TMR",
  335. dev->transport->name);
  336. return 0;
  337. }