target_core_user.c 29 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167
  1. /*
  2. * Copyright (C) 2013 Shaohua Li <shli@kernel.org>
  3. * Copyright (C) 2014 Red Hat, Inc.
  4. *
  5. * This program is free software; you can redistribute it and/or modify it
  6. * under the terms and conditions of the GNU General Public License,
  7. * version 2, as published by the Free Software Foundation.
  8. *
  9. * This program is distributed in the hope it will be useful, but WITHOUT
  10. * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  11. * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
  12. * more details.
  13. *
  14. * You should have received a copy of the GNU General Public License along with
  15. * this program; if not, write to the Free Software Foundation, Inc.,
  16. * 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
  17. */
  18. #include <linux/spinlock.h>
  19. #include <linux/module.h>
  20. #include <linux/idr.h>
  21. #include <linux/timer.h>
  22. #include <linux/parser.h>
  23. #include <scsi/scsi.h>
  24. #include <scsi/scsi_host.h>
  25. #include <linux/uio_driver.h>
  26. #include <net/genetlink.h>
  27. #include <target/target_core_base.h>
  28. #include <target/target_core_fabric.h>
  29. #include <target/target_core_backend.h>
  30. #include <linux/target_core_user.h>
  31. /*
  32. * Define a shared-memory interface for LIO to pass SCSI commands and
  33. * data to userspace for processing. This is to allow backends that
  34. * are too complex for in-kernel support to be possible.
  35. *
  36. * It uses the UIO framework to do a lot of the device-creation and
  37. * introspection work for us.
  38. *
  39. * See the .h file for how the ring is laid out. Note that while the
  40. * command ring is defined, the particulars of the data area are
  41. * not. Offset values in the command entry point to other locations
  42. * internal to the mmap()ed area. There is separate space outside the
  43. * command ring for data buffers. This leaves maximum flexibility for
  44. * moving buffer allocations, or even page flipping or other
  45. * allocation techniques, without altering the command ring layout.
  46. *
  47. * SECURITY:
  48. * The user process must be assumed to be malicious. There's no way to
  49. * prevent it breaking the command ring protocol if it wants, but in
  50. * order to prevent other issues we must only ever read *data* from
  51. * the shared memory area, not offsets or sizes. This applies to
  52. * command ring entries as well as the mailbox. Extra code needed for
  53. * this may have a 'UAM' comment.
  54. */
  55. #define TCMU_TIME_OUT (30 * MSEC_PER_SEC)
  56. #define CMDR_SIZE (16 * 4096)
  57. #define DATA_SIZE (257 * 4096)
  58. #define TCMU_RING_SIZE (CMDR_SIZE + DATA_SIZE)
  59. static struct device *tcmu_root_device;
  60. struct tcmu_hba {
  61. u32 host_id;
  62. };
  63. /* User wants all cmds or just some */
  64. enum passthru_level {
  65. TCMU_PASS_ALL = 0,
  66. TCMU_PASS_IO,
  67. TCMU_PASS_INVALID,
  68. };
  69. #define TCMU_CONFIG_LEN 256
  70. struct tcmu_dev {
  71. struct se_device se_dev;
  72. char *name;
  73. struct se_hba *hba;
  74. #define TCMU_DEV_BIT_OPEN 0
  75. #define TCMU_DEV_BIT_BROKEN 1
  76. unsigned long flags;
  77. enum passthru_level pass_level;
  78. struct uio_info uio_info;
  79. struct tcmu_mailbox *mb_addr;
  80. size_t dev_size;
  81. u32 cmdr_size;
  82. u32 cmdr_last_cleaned;
  83. /* Offset of data ring from start of mb */
  84. size_t data_off;
  85. size_t data_size;
  86. /* Ring head + tail values. */
  87. /* Must add data_off and mb_addr to get the address */
  88. size_t data_head;
  89. size_t data_tail;
  90. wait_queue_head_t wait_cmdr;
  91. /* TODO should this be a mutex? */
  92. spinlock_t cmdr_lock;
  93. struct idr commands;
  94. spinlock_t commands_lock;
  95. struct timer_list timeout;
  96. char dev_config[TCMU_CONFIG_LEN];
  97. };
  98. #define TCMU_DEV(_se_dev) container_of(_se_dev, struct tcmu_dev, se_dev)
  99. #define CMDR_OFF sizeof(struct tcmu_mailbox)
  100. struct tcmu_cmd {
  101. struct se_cmd *se_cmd;
  102. struct tcmu_dev *tcmu_dev;
  103. uint16_t cmd_id;
  104. /* Can't use se_cmd->data_length when cleaning up expired cmds, because if
  105. cmd has been completed then accessing se_cmd is off limits */
  106. size_t data_length;
  107. unsigned long deadline;
  108. #define TCMU_CMD_BIT_EXPIRED 0
  109. unsigned long flags;
  110. };
  111. static struct kmem_cache *tcmu_cmd_cache;
  112. /* multicast group */
  113. enum tcmu_multicast_groups {
  114. TCMU_MCGRP_CONFIG,
  115. };
  116. static const struct genl_multicast_group tcmu_mcgrps[] = {
  117. [TCMU_MCGRP_CONFIG] = { .name = "config", },
  118. };
  119. /* Our generic netlink family */
  120. static struct genl_family tcmu_genl_family = {
  121. .id = GENL_ID_GENERATE,
  122. .hdrsize = 0,
  123. .name = "TCM-USER",
  124. .version = 1,
  125. .maxattr = TCMU_ATTR_MAX,
  126. .mcgrps = tcmu_mcgrps,
  127. .n_mcgrps = ARRAY_SIZE(tcmu_mcgrps),
  128. };
  129. static struct tcmu_cmd *tcmu_alloc_cmd(struct se_cmd *se_cmd)
  130. {
  131. struct se_device *se_dev = se_cmd->se_dev;
  132. struct tcmu_dev *udev = TCMU_DEV(se_dev);
  133. struct tcmu_cmd *tcmu_cmd;
  134. int cmd_id;
  135. tcmu_cmd = kmem_cache_zalloc(tcmu_cmd_cache, GFP_KERNEL);
  136. if (!tcmu_cmd)
  137. return NULL;
  138. tcmu_cmd->se_cmd = se_cmd;
  139. tcmu_cmd->tcmu_dev = udev;
  140. tcmu_cmd->data_length = se_cmd->data_length;
  141. tcmu_cmd->deadline = jiffies + msecs_to_jiffies(TCMU_TIME_OUT);
  142. idr_preload(GFP_KERNEL);
  143. spin_lock_irq(&udev->commands_lock);
  144. cmd_id = idr_alloc(&udev->commands, tcmu_cmd, 0,
  145. USHRT_MAX, GFP_NOWAIT);
  146. spin_unlock_irq(&udev->commands_lock);
  147. idr_preload_end();
  148. if (cmd_id < 0) {
  149. kmem_cache_free(tcmu_cmd_cache, tcmu_cmd);
  150. return NULL;
  151. }
  152. tcmu_cmd->cmd_id = cmd_id;
  153. return tcmu_cmd;
  154. }
  155. static inline void tcmu_flush_dcache_range(void *vaddr, size_t size)
  156. {
  157. unsigned long offset = (unsigned long) vaddr & ~PAGE_MASK;
  158. size = round_up(size+offset, PAGE_SIZE);
  159. vaddr -= offset;
  160. while (size) {
  161. flush_dcache_page(virt_to_page(vaddr));
  162. size -= PAGE_SIZE;
  163. }
  164. }
  165. /*
  166. * Some ring helper functions. We don't assume size is a power of 2 so
  167. * we can't use circ_buf.h.
  168. */
  169. static inline size_t spc_used(size_t head, size_t tail, size_t size)
  170. {
  171. int diff = head - tail;
  172. if (diff >= 0)
  173. return diff;
  174. else
  175. return size + diff;
  176. }
  177. static inline size_t spc_free(size_t head, size_t tail, size_t size)
  178. {
  179. /* Keep 1 byte unused or we can't tell full from empty */
  180. return (size - spc_used(head, tail, size) - 1);
  181. }
  182. static inline size_t head_to_end(size_t head, size_t size)
  183. {
  184. return size - head;
  185. }
  186. #define UPDATE_HEAD(head, used, size) smp_store_release(&head, ((head % size) + used) % size)
  187. /*
  188. * We can't queue a command until we have space available on the cmd ring *and* space
  189. * space avail on the data ring.
  190. *
  191. * Called with ring lock held.
  192. */
  193. static bool is_ring_space_avail(struct tcmu_dev *udev, size_t cmd_size, size_t data_needed)
  194. {
  195. struct tcmu_mailbox *mb = udev->mb_addr;
  196. size_t space;
  197. u32 cmd_head;
  198. size_t cmd_needed;
  199. tcmu_flush_dcache_range(mb, sizeof(*mb));
  200. cmd_head = mb->cmd_head % udev->cmdr_size; /* UAM */
  201. /*
  202. * If cmd end-of-ring space is too small then we need space for a NOP plus
  203. * original cmd - cmds are internally contiguous.
  204. */
  205. if (head_to_end(cmd_head, udev->cmdr_size) >= cmd_size)
  206. cmd_needed = cmd_size;
  207. else
  208. cmd_needed = cmd_size + head_to_end(cmd_head, udev->cmdr_size);
  209. space = spc_free(cmd_head, udev->cmdr_last_cleaned, udev->cmdr_size);
  210. if (space < cmd_needed) {
  211. pr_debug("no cmd space: %u %u %u\n", cmd_head,
  212. udev->cmdr_last_cleaned, udev->cmdr_size);
  213. return false;
  214. }
  215. space = spc_free(udev->data_head, udev->data_tail, udev->data_size);
  216. if (space < data_needed) {
  217. pr_debug("no data space: %zu %zu %zu\n", udev->data_head,
  218. udev->data_tail, udev->data_size);
  219. return false;
  220. }
  221. return true;
  222. }
  223. static int tcmu_queue_cmd_ring(struct tcmu_cmd *tcmu_cmd)
  224. {
  225. struct tcmu_dev *udev = tcmu_cmd->tcmu_dev;
  226. struct se_cmd *se_cmd = tcmu_cmd->se_cmd;
  227. size_t base_command_size, command_size;
  228. struct tcmu_mailbox *mb;
  229. struct tcmu_cmd_entry *entry;
  230. int i;
  231. struct scatterlist *sg;
  232. struct iovec *iov;
  233. int iov_cnt = 0;
  234. uint32_t cmd_head;
  235. uint64_t cdb_off;
  236. if (test_bit(TCMU_DEV_BIT_BROKEN, &udev->flags))
  237. return -EINVAL;
  238. /*
  239. * Must be a certain minimum size for response sense info, but
  240. * also may be larger if the iov array is large.
  241. *
  242. * iovs = sgl_nents+1, for end-of-ring case, plus another 1
  243. * b/c size == offsetof one-past-element.
  244. */
  245. base_command_size = max(offsetof(struct tcmu_cmd_entry,
  246. req.iov[se_cmd->t_data_nents + 2]),
  247. sizeof(struct tcmu_cmd_entry));
  248. command_size = base_command_size
  249. + round_up(scsi_command_size(se_cmd->t_task_cdb), TCMU_OP_ALIGN_SIZE);
  250. WARN_ON(command_size & (TCMU_OP_ALIGN_SIZE-1));
  251. spin_lock_irq(&udev->cmdr_lock);
  252. mb = udev->mb_addr;
  253. cmd_head = mb->cmd_head % udev->cmdr_size; /* UAM */
  254. if ((command_size > (udev->cmdr_size / 2))
  255. || tcmu_cmd->data_length > (udev->data_size - 1))
  256. pr_warn("TCMU: Request of size %zu/%zu may be too big for %u/%zu "
  257. "cmd/data ring buffers\n", command_size, tcmu_cmd->data_length,
  258. udev->cmdr_size, udev->data_size);
  259. while (!is_ring_space_avail(udev, command_size, tcmu_cmd->data_length)) {
  260. int ret;
  261. DEFINE_WAIT(__wait);
  262. prepare_to_wait(&udev->wait_cmdr, &__wait, TASK_INTERRUPTIBLE);
  263. pr_debug("sleeping for ring space\n");
  264. spin_unlock_irq(&udev->cmdr_lock);
  265. ret = schedule_timeout(msecs_to_jiffies(TCMU_TIME_OUT));
  266. finish_wait(&udev->wait_cmdr, &__wait);
  267. if (!ret) {
  268. pr_warn("tcmu: command timed out\n");
  269. return -ETIMEDOUT;
  270. }
  271. spin_lock_irq(&udev->cmdr_lock);
  272. /* We dropped cmdr_lock, cmd_head is stale */
  273. cmd_head = mb->cmd_head % udev->cmdr_size; /* UAM */
  274. }
  275. /* Insert a PAD if end-of-ring space is too small */
  276. if (head_to_end(cmd_head, udev->cmdr_size) < command_size) {
  277. size_t pad_size = head_to_end(cmd_head, udev->cmdr_size);
  278. entry = (void *) mb + CMDR_OFF + cmd_head;
  279. tcmu_flush_dcache_range(entry, sizeof(*entry));
  280. tcmu_hdr_set_op(&entry->hdr, TCMU_OP_PAD);
  281. tcmu_hdr_set_len(&entry->hdr, pad_size);
  282. UPDATE_HEAD(mb->cmd_head, pad_size, udev->cmdr_size);
  283. cmd_head = mb->cmd_head % udev->cmdr_size; /* UAM */
  284. WARN_ON(cmd_head != 0);
  285. }
  286. entry = (void *) mb + CMDR_OFF + cmd_head;
  287. tcmu_flush_dcache_range(entry, sizeof(*entry));
  288. tcmu_hdr_set_op(&entry->hdr, TCMU_OP_CMD);
  289. tcmu_hdr_set_len(&entry->hdr, command_size);
  290. entry->cmd_id = tcmu_cmd->cmd_id;
  291. /*
  292. * Fix up iovecs, and handle if allocation in data ring wrapped.
  293. */
  294. iov = &entry->req.iov[0];
  295. for_each_sg(se_cmd->t_data_sg, sg, se_cmd->t_data_nents, i) {
  296. size_t copy_bytes = min((size_t)sg->length,
  297. head_to_end(udev->data_head, udev->data_size));
  298. void *from = kmap_atomic(sg_page(sg)) + sg->offset;
  299. void *to = (void *) mb + udev->data_off + udev->data_head;
  300. if (tcmu_cmd->se_cmd->data_direction == DMA_TO_DEVICE) {
  301. memcpy(to, from, copy_bytes);
  302. tcmu_flush_dcache_range(to, copy_bytes);
  303. }
  304. /* Even iov_base is relative to mb_addr */
  305. iov->iov_len = copy_bytes;
  306. iov->iov_base = (void *) udev->data_off + udev->data_head;
  307. iov_cnt++;
  308. iov++;
  309. UPDATE_HEAD(udev->data_head, copy_bytes, udev->data_size);
  310. /* Uh oh, we wrapped the buffer. Must split sg across 2 iovs. */
  311. if (sg->length != copy_bytes) {
  312. from += copy_bytes;
  313. copy_bytes = sg->length - copy_bytes;
  314. iov->iov_len = copy_bytes;
  315. iov->iov_base = (void *) udev->data_off + udev->data_head;
  316. if (se_cmd->data_direction == DMA_TO_DEVICE) {
  317. to = (void *) mb + udev->data_off + udev->data_head;
  318. memcpy(to, from, copy_bytes);
  319. tcmu_flush_dcache_range(to, copy_bytes);
  320. }
  321. iov_cnt++;
  322. iov++;
  323. UPDATE_HEAD(udev->data_head, copy_bytes, udev->data_size);
  324. }
  325. kunmap_atomic(from);
  326. }
  327. entry->req.iov_cnt = iov_cnt;
  328. /* All offsets relative to mb_addr, not start of entry! */
  329. cdb_off = CMDR_OFF + cmd_head + base_command_size;
  330. memcpy((void *) mb + cdb_off, se_cmd->t_task_cdb, scsi_command_size(se_cmd->t_task_cdb));
  331. entry->req.cdb_off = cdb_off;
  332. tcmu_flush_dcache_range(entry, sizeof(*entry));
  333. UPDATE_HEAD(mb->cmd_head, command_size, udev->cmdr_size);
  334. tcmu_flush_dcache_range(mb, sizeof(*mb));
  335. spin_unlock_irq(&udev->cmdr_lock);
  336. /* TODO: only if FLUSH and FUA? */
  337. uio_event_notify(&udev->uio_info);
  338. mod_timer(&udev->timeout,
  339. round_jiffies_up(jiffies + msecs_to_jiffies(TCMU_TIME_OUT)));
  340. return 0;
  341. }
  342. static int tcmu_queue_cmd(struct se_cmd *se_cmd)
  343. {
  344. struct se_device *se_dev = se_cmd->se_dev;
  345. struct tcmu_dev *udev = TCMU_DEV(se_dev);
  346. struct tcmu_cmd *tcmu_cmd;
  347. int ret;
  348. tcmu_cmd = tcmu_alloc_cmd(se_cmd);
  349. if (!tcmu_cmd)
  350. return -ENOMEM;
  351. ret = tcmu_queue_cmd_ring(tcmu_cmd);
  352. if (ret < 0) {
  353. pr_err("TCMU: Could not queue command\n");
  354. spin_lock_irq(&udev->commands_lock);
  355. idr_remove(&udev->commands, tcmu_cmd->cmd_id);
  356. spin_unlock_irq(&udev->commands_lock);
  357. kmem_cache_free(tcmu_cmd_cache, tcmu_cmd);
  358. }
  359. return ret;
  360. }
  361. static void tcmu_handle_completion(struct tcmu_cmd *cmd, struct tcmu_cmd_entry *entry)
  362. {
  363. struct se_cmd *se_cmd = cmd->se_cmd;
  364. struct tcmu_dev *udev = cmd->tcmu_dev;
  365. if (test_bit(TCMU_CMD_BIT_EXPIRED, &cmd->flags)) {
  366. /* cmd has been completed already from timeout, just reclaim data
  367. ring space */
  368. UPDATE_HEAD(udev->data_tail, cmd->data_length, udev->data_size);
  369. return;
  370. }
  371. if (entry->rsp.scsi_status == SAM_STAT_CHECK_CONDITION) {
  372. memcpy(se_cmd->sense_buffer, entry->rsp.sense_buffer,
  373. se_cmd->scsi_sense_length);
  374. UPDATE_HEAD(udev->data_tail, cmd->data_length, udev->data_size);
  375. }
  376. else if (se_cmd->data_direction == DMA_FROM_DEVICE) {
  377. struct scatterlist *sg;
  378. int i;
  379. /* It'd be easier to look at entry's iovec again, but UAM */
  380. for_each_sg(se_cmd->t_data_sg, sg, se_cmd->t_data_nents, i) {
  381. size_t copy_bytes;
  382. void *to;
  383. void *from;
  384. copy_bytes = min((size_t)sg->length,
  385. head_to_end(udev->data_tail, udev->data_size));
  386. to = kmap_atomic(sg_page(sg)) + sg->offset;
  387. WARN_ON(sg->length + sg->offset > PAGE_SIZE);
  388. from = (void *) udev->mb_addr + udev->data_off + udev->data_tail;
  389. tcmu_flush_dcache_range(from, copy_bytes);
  390. memcpy(to, from, copy_bytes);
  391. UPDATE_HEAD(udev->data_tail, copy_bytes, udev->data_size);
  392. /* Uh oh, wrapped the data buffer for this sg's data */
  393. if (sg->length != copy_bytes) {
  394. from = (void *) udev->mb_addr + udev->data_off + udev->data_tail;
  395. WARN_ON(udev->data_tail);
  396. to += copy_bytes;
  397. copy_bytes = sg->length - copy_bytes;
  398. tcmu_flush_dcache_range(from, copy_bytes);
  399. memcpy(to, from, copy_bytes);
  400. UPDATE_HEAD(udev->data_tail, copy_bytes, udev->data_size);
  401. }
  402. kunmap_atomic(to);
  403. }
  404. } else if (se_cmd->data_direction == DMA_TO_DEVICE) {
  405. UPDATE_HEAD(udev->data_tail, cmd->data_length, udev->data_size);
  406. } else {
  407. pr_warn("TCMU: data direction was %d!\n", se_cmd->data_direction);
  408. }
  409. target_complete_cmd(cmd->se_cmd, entry->rsp.scsi_status);
  410. cmd->se_cmd = NULL;
  411. kmem_cache_free(tcmu_cmd_cache, cmd);
  412. }
  413. static unsigned int tcmu_handle_completions(struct tcmu_dev *udev)
  414. {
  415. struct tcmu_mailbox *mb;
  416. LIST_HEAD(cpl_cmds);
  417. unsigned long flags;
  418. int handled = 0;
  419. if (test_bit(TCMU_DEV_BIT_BROKEN, &udev->flags)) {
  420. pr_err("ring broken, not handling completions\n");
  421. return 0;
  422. }
  423. spin_lock_irqsave(&udev->cmdr_lock, flags);
  424. mb = udev->mb_addr;
  425. tcmu_flush_dcache_range(mb, sizeof(*mb));
  426. while (udev->cmdr_last_cleaned != ACCESS_ONCE(mb->cmd_tail)) {
  427. struct tcmu_cmd_entry *entry = (void *) mb + CMDR_OFF + udev->cmdr_last_cleaned;
  428. struct tcmu_cmd *cmd;
  429. tcmu_flush_dcache_range(entry, sizeof(*entry));
  430. if (tcmu_hdr_get_op(&entry->hdr) == TCMU_OP_PAD) {
  431. UPDATE_HEAD(udev->cmdr_last_cleaned, tcmu_hdr_get_len(&entry->hdr), udev->cmdr_size);
  432. continue;
  433. }
  434. WARN_ON(tcmu_hdr_get_op(&entry->hdr) != TCMU_OP_CMD);
  435. spin_lock(&udev->commands_lock);
  436. cmd = idr_find(&udev->commands, entry->cmd_id);
  437. if (cmd)
  438. idr_remove(&udev->commands, cmd->cmd_id);
  439. spin_unlock(&udev->commands_lock);
  440. if (!cmd) {
  441. pr_err("cmd_id not found, ring is broken\n");
  442. set_bit(TCMU_DEV_BIT_BROKEN, &udev->flags);
  443. break;
  444. }
  445. tcmu_handle_completion(cmd, entry);
  446. UPDATE_HEAD(udev->cmdr_last_cleaned, tcmu_hdr_get_len(&entry->hdr), udev->cmdr_size);
  447. handled++;
  448. }
  449. if (mb->cmd_tail == mb->cmd_head)
  450. del_timer(&udev->timeout); /* no more pending cmds */
  451. spin_unlock_irqrestore(&udev->cmdr_lock, flags);
  452. wake_up(&udev->wait_cmdr);
  453. return handled;
  454. }
  455. static int tcmu_check_expired_cmd(int id, void *p, void *data)
  456. {
  457. struct tcmu_cmd *cmd = p;
  458. if (test_bit(TCMU_CMD_BIT_EXPIRED, &cmd->flags))
  459. return 0;
  460. if (!time_after(cmd->deadline, jiffies))
  461. return 0;
  462. set_bit(TCMU_CMD_BIT_EXPIRED, &cmd->flags);
  463. target_complete_cmd(cmd->se_cmd, SAM_STAT_CHECK_CONDITION);
  464. cmd->se_cmd = NULL;
  465. kmem_cache_free(tcmu_cmd_cache, cmd);
  466. return 0;
  467. }
  468. static void tcmu_device_timedout(unsigned long data)
  469. {
  470. struct tcmu_dev *udev = (struct tcmu_dev *)data;
  471. unsigned long flags;
  472. int handled;
  473. handled = tcmu_handle_completions(udev);
  474. pr_warn("%d completions handled from timeout\n", handled);
  475. spin_lock_irqsave(&udev->commands_lock, flags);
  476. idr_for_each(&udev->commands, tcmu_check_expired_cmd, NULL);
  477. spin_unlock_irqrestore(&udev->commands_lock, flags);
  478. /*
  479. * We don't need to wakeup threads on wait_cmdr since they have their
  480. * own timeout.
  481. */
  482. }
  483. static int tcmu_attach_hba(struct se_hba *hba, u32 host_id)
  484. {
  485. struct tcmu_hba *tcmu_hba;
  486. tcmu_hba = kzalloc(sizeof(struct tcmu_hba), GFP_KERNEL);
  487. if (!tcmu_hba)
  488. return -ENOMEM;
  489. tcmu_hba->host_id = host_id;
  490. hba->hba_ptr = tcmu_hba;
  491. return 0;
  492. }
  493. static void tcmu_detach_hba(struct se_hba *hba)
  494. {
  495. kfree(hba->hba_ptr);
  496. hba->hba_ptr = NULL;
  497. }
  498. static struct se_device *tcmu_alloc_device(struct se_hba *hba, const char *name)
  499. {
  500. struct tcmu_dev *udev;
  501. udev = kzalloc(sizeof(struct tcmu_dev), GFP_KERNEL);
  502. if (!udev)
  503. return NULL;
  504. udev->name = kstrdup(name, GFP_KERNEL);
  505. if (!udev->name) {
  506. kfree(udev);
  507. return NULL;
  508. }
  509. udev->hba = hba;
  510. init_waitqueue_head(&udev->wait_cmdr);
  511. spin_lock_init(&udev->cmdr_lock);
  512. idr_init(&udev->commands);
  513. spin_lock_init(&udev->commands_lock);
  514. setup_timer(&udev->timeout, tcmu_device_timedout,
  515. (unsigned long)udev);
  516. udev->pass_level = TCMU_PASS_ALL;
  517. return &udev->se_dev;
  518. }
  519. static int tcmu_irqcontrol(struct uio_info *info, s32 irq_on)
  520. {
  521. struct tcmu_dev *tcmu_dev = container_of(info, struct tcmu_dev, uio_info);
  522. tcmu_handle_completions(tcmu_dev);
  523. return 0;
  524. }
  525. /*
  526. * mmap code from uio.c. Copied here because we want to hook mmap()
  527. * and this stuff must come along.
  528. */
  529. static int tcmu_find_mem_index(struct vm_area_struct *vma)
  530. {
  531. struct tcmu_dev *udev = vma->vm_private_data;
  532. struct uio_info *info = &udev->uio_info;
  533. if (vma->vm_pgoff < MAX_UIO_MAPS) {
  534. if (info->mem[vma->vm_pgoff].size == 0)
  535. return -1;
  536. return (int)vma->vm_pgoff;
  537. }
  538. return -1;
  539. }
  540. static int tcmu_vma_fault(struct vm_area_struct *vma, struct vm_fault *vmf)
  541. {
  542. struct tcmu_dev *udev = vma->vm_private_data;
  543. struct uio_info *info = &udev->uio_info;
  544. struct page *page;
  545. unsigned long offset;
  546. void *addr;
  547. int mi = tcmu_find_mem_index(vma);
  548. if (mi < 0)
  549. return VM_FAULT_SIGBUS;
  550. /*
  551. * We need to subtract mi because userspace uses offset = N*PAGE_SIZE
  552. * to use mem[N].
  553. */
  554. offset = (vmf->pgoff - mi) << PAGE_SHIFT;
  555. addr = (void *)(unsigned long)info->mem[mi].addr + offset;
  556. if (info->mem[mi].memtype == UIO_MEM_LOGICAL)
  557. page = virt_to_page(addr);
  558. else
  559. page = vmalloc_to_page(addr);
  560. get_page(page);
  561. vmf->page = page;
  562. return 0;
  563. }
  564. static const struct vm_operations_struct tcmu_vm_ops = {
  565. .fault = tcmu_vma_fault,
  566. };
  567. static int tcmu_mmap(struct uio_info *info, struct vm_area_struct *vma)
  568. {
  569. struct tcmu_dev *udev = container_of(info, struct tcmu_dev, uio_info);
  570. vma->vm_flags |= VM_DONTEXPAND | VM_DONTDUMP;
  571. vma->vm_ops = &tcmu_vm_ops;
  572. vma->vm_private_data = udev;
  573. /* Ensure the mmap is exactly the right size */
  574. if (vma_pages(vma) != (TCMU_RING_SIZE >> PAGE_SHIFT))
  575. return -EINVAL;
  576. return 0;
  577. }
  578. static int tcmu_open(struct uio_info *info, struct inode *inode)
  579. {
  580. struct tcmu_dev *udev = container_of(info, struct tcmu_dev, uio_info);
  581. /* O_EXCL not supported for char devs, so fake it? */
  582. if (test_and_set_bit(TCMU_DEV_BIT_OPEN, &udev->flags))
  583. return -EBUSY;
  584. pr_debug("open\n");
  585. return 0;
  586. }
  587. static int tcmu_release(struct uio_info *info, struct inode *inode)
  588. {
  589. struct tcmu_dev *udev = container_of(info, struct tcmu_dev, uio_info);
  590. clear_bit(TCMU_DEV_BIT_OPEN, &udev->flags);
  591. pr_debug("close\n");
  592. return 0;
  593. }
  594. static int tcmu_netlink_event(enum tcmu_genl_cmd cmd, const char *name, int minor)
  595. {
  596. struct sk_buff *skb;
  597. void *msg_header;
  598. int ret = -ENOMEM;
  599. skb = genlmsg_new(NLMSG_GOODSIZE, GFP_KERNEL);
  600. if (!skb)
  601. return ret;
  602. msg_header = genlmsg_put(skb, 0, 0, &tcmu_genl_family, 0, cmd);
  603. if (!msg_header)
  604. goto free_skb;
  605. ret = nla_put_string(skb, TCMU_ATTR_DEVICE, name);
  606. if (ret < 0)
  607. goto free_skb;
  608. ret = nla_put_u32(skb, TCMU_ATTR_MINOR, minor);
  609. if (ret < 0)
  610. goto free_skb;
  611. ret = genlmsg_end(skb, msg_header);
  612. if (ret < 0)
  613. goto free_skb;
  614. ret = genlmsg_multicast(&tcmu_genl_family, skb, 0,
  615. TCMU_MCGRP_CONFIG, GFP_KERNEL);
  616. /* We don't care if no one is listening */
  617. if (ret == -ESRCH)
  618. ret = 0;
  619. return ret;
  620. free_skb:
  621. nlmsg_free(skb);
  622. return ret;
  623. }
  624. static int tcmu_configure_device(struct se_device *dev)
  625. {
  626. struct tcmu_dev *udev = TCMU_DEV(dev);
  627. struct tcmu_hba *hba = udev->hba->hba_ptr;
  628. struct uio_info *info;
  629. struct tcmu_mailbox *mb;
  630. size_t size;
  631. size_t used;
  632. int ret = 0;
  633. char *str;
  634. info = &udev->uio_info;
  635. size = snprintf(NULL, 0, "tcm-user/%u/%s/%s", hba->host_id, udev->name,
  636. udev->dev_config);
  637. size += 1; /* for \0 */
  638. str = kmalloc(size, GFP_KERNEL);
  639. if (!str)
  640. return -ENOMEM;
  641. used = snprintf(str, size, "tcm-user/%u/%s", hba->host_id, udev->name);
  642. if (udev->dev_config[0])
  643. snprintf(str + used, size - used, "/%s", udev->dev_config);
  644. info->name = str;
  645. udev->mb_addr = vzalloc(TCMU_RING_SIZE);
  646. if (!udev->mb_addr) {
  647. ret = -ENOMEM;
  648. goto err_vzalloc;
  649. }
  650. /* mailbox fits in first part of CMDR space */
  651. udev->cmdr_size = CMDR_SIZE - CMDR_OFF;
  652. udev->data_off = CMDR_SIZE;
  653. udev->data_size = TCMU_RING_SIZE - CMDR_SIZE;
  654. mb = udev->mb_addr;
  655. mb->version = 1;
  656. mb->cmdr_off = CMDR_OFF;
  657. mb->cmdr_size = udev->cmdr_size;
  658. WARN_ON(!PAGE_ALIGNED(udev->data_off));
  659. WARN_ON(udev->data_size % PAGE_SIZE);
  660. info->version = "1";
  661. info->mem[0].name = "tcm-user command & data buffer";
  662. info->mem[0].addr = (phys_addr_t) udev->mb_addr;
  663. info->mem[0].size = TCMU_RING_SIZE;
  664. info->mem[0].memtype = UIO_MEM_VIRTUAL;
  665. info->irqcontrol = tcmu_irqcontrol;
  666. info->irq = UIO_IRQ_CUSTOM;
  667. info->mmap = tcmu_mmap;
  668. info->open = tcmu_open;
  669. info->release = tcmu_release;
  670. ret = uio_register_device(tcmu_root_device, info);
  671. if (ret)
  672. goto err_register;
  673. /* Other attributes can be configured in userspace */
  674. dev->dev_attrib.hw_block_size = 512;
  675. dev->dev_attrib.hw_max_sectors = 128;
  676. dev->dev_attrib.hw_queue_depth = 128;
  677. ret = tcmu_netlink_event(TCMU_CMD_ADDED_DEVICE, udev->uio_info.name,
  678. udev->uio_info.uio_dev->minor);
  679. if (ret)
  680. goto err_netlink;
  681. return 0;
  682. err_netlink:
  683. uio_unregister_device(&udev->uio_info);
  684. err_register:
  685. vfree(udev->mb_addr);
  686. err_vzalloc:
  687. kfree(info->name);
  688. return ret;
  689. }
  690. static int tcmu_check_pending_cmd(int id, void *p, void *data)
  691. {
  692. struct tcmu_cmd *cmd = p;
  693. if (test_bit(TCMU_CMD_BIT_EXPIRED, &cmd->flags))
  694. return 0;
  695. return -EINVAL;
  696. }
  697. static void tcmu_free_device(struct se_device *dev)
  698. {
  699. struct tcmu_dev *udev = TCMU_DEV(dev);
  700. int i;
  701. del_timer_sync(&udev->timeout);
  702. vfree(udev->mb_addr);
  703. /* Upper layer should drain all requests before calling this */
  704. spin_lock_irq(&udev->commands_lock);
  705. i = idr_for_each(&udev->commands, tcmu_check_pending_cmd, NULL);
  706. idr_destroy(&udev->commands);
  707. spin_unlock_irq(&udev->commands_lock);
  708. WARN_ON(i);
  709. /* Device was configured */
  710. if (udev->uio_info.uio_dev) {
  711. tcmu_netlink_event(TCMU_CMD_REMOVED_DEVICE, udev->uio_info.name,
  712. udev->uio_info.uio_dev->minor);
  713. uio_unregister_device(&udev->uio_info);
  714. kfree(udev->uio_info.name);
  715. kfree(udev->name);
  716. }
  717. kfree(udev);
  718. }
  719. enum {
  720. Opt_dev_config, Opt_dev_size, Opt_err, Opt_pass_level,
  721. };
  722. static match_table_t tokens = {
  723. {Opt_dev_config, "dev_config=%s"},
  724. {Opt_dev_size, "dev_size=%u"},
  725. {Opt_pass_level, "pass_level=%u"},
  726. {Opt_err, NULL}
  727. };
  728. static ssize_t tcmu_set_configfs_dev_params(struct se_device *dev,
  729. const char *page, ssize_t count)
  730. {
  731. struct tcmu_dev *udev = TCMU_DEV(dev);
  732. char *orig, *ptr, *opts, *arg_p;
  733. substring_t args[MAX_OPT_ARGS];
  734. int ret = 0, token;
  735. int arg;
  736. opts = kstrdup(page, GFP_KERNEL);
  737. if (!opts)
  738. return -ENOMEM;
  739. orig = opts;
  740. while ((ptr = strsep(&opts, ",\n")) != NULL) {
  741. if (!*ptr)
  742. continue;
  743. token = match_token(ptr, tokens, args);
  744. switch (token) {
  745. case Opt_dev_config:
  746. if (match_strlcpy(udev->dev_config, &args[0],
  747. TCMU_CONFIG_LEN) == 0) {
  748. ret = -EINVAL;
  749. break;
  750. }
  751. pr_debug("TCMU: Referencing Path: %s\n", udev->dev_config);
  752. break;
  753. case Opt_dev_size:
  754. arg_p = match_strdup(&args[0]);
  755. if (!arg_p) {
  756. ret = -ENOMEM;
  757. break;
  758. }
  759. ret = kstrtoul(arg_p, 0, (unsigned long *) &udev->dev_size);
  760. kfree(arg_p);
  761. if (ret < 0)
  762. pr_err("kstrtoul() failed for dev_size=\n");
  763. break;
  764. case Opt_pass_level:
  765. match_int(args, &arg);
  766. if (arg >= TCMU_PASS_INVALID) {
  767. pr_warn("TCMU: Invalid pass_level: %d\n", arg);
  768. break;
  769. }
  770. pr_debug("TCMU: Setting pass_level to %d\n", arg);
  771. udev->pass_level = arg;
  772. break;
  773. default:
  774. break;
  775. }
  776. }
  777. kfree(orig);
  778. return (!ret) ? count : ret;
  779. }
  780. static ssize_t tcmu_show_configfs_dev_params(struct se_device *dev, char *b)
  781. {
  782. struct tcmu_dev *udev = TCMU_DEV(dev);
  783. ssize_t bl = 0;
  784. bl = sprintf(b + bl, "Config: %s ",
  785. udev->dev_config[0] ? udev->dev_config : "NULL");
  786. bl += sprintf(b + bl, "Size: %zu PassLevel: %u\n",
  787. udev->dev_size, udev->pass_level);
  788. return bl;
  789. }
  790. static sector_t tcmu_get_blocks(struct se_device *dev)
  791. {
  792. struct tcmu_dev *udev = TCMU_DEV(dev);
  793. return div_u64(udev->dev_size - dev->dev_attrib.block_size,
  794. dev->dev_attrib.block_size);
  795. }
  796. static sense_reason_t
  797. tcmu_execute_rw(struct se_cmd *se_cmd, struct scatterlist *sgl, u32 sgl_nents,
  798. enum dma_data_direction data_direction)
  799. {
  800. int ret;
  801. ret = tcmu_queue_cmd(se_cmd);
  802. if (ret != 0)
  803. return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE;
  804. else
  805. return TCM_NO_SENSE;
  806. }
  807. static sense_reason_t
  808. tcmu_pass_op(struct se_cmd *se_cmd)
  809. {
  810. int ret = tcmu_queue_cmd(se_cmd);
  811. if (ret != 0)
  812. return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE;
  813. else
  814. return TCM_NO_SENSE;
  815. }
  816. static struct sbc_ops tcmu_sbc_ops = {
  817. .execute_rw = tcmu_execute_rw,
  818. .execute_sync_cache = tcmu_pass_op,
  819. .execute_write_same = tcmu_pass_op,
  820. .execute_write_same_unmap = tcmu_pass_op,
  821. .execute_unmap = tcmu_pass_op,
  822. };
  823. static sense_reason_t
  824. tcmu_parse_cdb(struct se_cmd *cmd)
  825. {
  826. unsigned char *cdb = cmd->t_task_cdb;
  827. struct tcmu_dev *udev = TCMU_DEV(cmd->se_dev);
  828. sense_reason_t ret;
  829. switch (udev->pass_level) {
  830. case TCMU_PASS_ALL:
  831. /* We're just like pscsi, then */
  832. /*
  833. * For REPORT LUNS we always need to emulate the response, for everything
  834. * else, pass it up.
  835. */
  836. switch (cdb[0]) {
  837. case REPORT_LUNS:
  838. cmd->execute_cmd = spc_emulate_report_luns;
  839. break;
  840. case READ_6:
  841. case READ_10:
  842. case READ_12:
  843. case READ_16:
  844. case WRITE_6:
  845. case WRITE_10:
  846. case WRITE_12:
  847. case WRITE_16:
  848. case WRITE_VERIFY:
  849. cmd->se_cmd_flags |= SCF_SCSI_DATA_CDB;
  850. /* FALLTHROUGH */
  851. default:
  852. cmd->execute_cmd = tcmu_pass_op;
  853. }
  854. ret = TCM_NO_SENSE;
  855. break;
  856. case TCMU_PASS_IO:
  857. ret = sbc_parse_cdb(cmd, &tcmu_sbc_ops);
  858. break;
  859. default:
  860. pr_err("Unknown tcm-user pass level %d\n", udev->pass_level);
  861. ret = TCM_CHECK_CONDITION_ABORT_CMD;
  862. }
  863. return ret;
  864. }
  865. static struct se_subsystem_api tcmu_template = {
  866. .name = "user",
  867. .inquiry_prod = "USER",
  868. .inquiry_rev = TCMU_VERSION,
  869. .owner = THIS_MODULE,
  870. .transport_type = TRANSPORT_PLUGIN_VHBA_PDEV,
  871. .attach_hba = tcmu_attach_hba,
  872. .detach_hba = tcmu_detach_hba,
  873. .alloc_device = tcmu_alloc_device,
  874. .configure_device = tcmu_configure_device,
  875. .free_device = tcmu_free_device,
  876. .parse_cdb = tcmu_parse_cdb,
  877. .set_configfs_dev_params = tcmu_set_configfs_dev_params,
  878. .show_configfs_dev_params = tcmu_show_configfs_dev_params,
  879. .get_device_type = sbc_get_device_type,
  880. .get_blocks = tcmu_get_blocks,
  881. };
  882. static int __init tcmu_module_init(void)
  883. {
  884. int ret;
  885. BUILD_BUG_ON((sizeof(struct tcmu_cmd_entry) % TCMU_OP_ALIGN_SIZE) != 0);
  886. tcmu_cmd_cache = kmem_cache_create("tcmu_cmd_cache",
  887. sizeof(struct tcmu_cmd),
  888. __alignof__(struct tcmu_cmd),
  889. 0, NULL);
  890. if (!tcmu_cmd_cache)
  891. return -ENOMEM;
  892. tcmu_root_device = root_device_register("tcm_user");
  893. if (IS_ERR(tcmu_root_device)) {
  894. ret = PTR_ERR(tcmu_root_device);
  895. goto out_free_cache;
  896. }
  897. ret = genl_register_family(&tcmu_genl_family);
  898. if (ret < 0) {
  899. goto out_unreg_device;
  900. }
  901. ret = transport_subsystem_register(&tcmu_template);
  902. if (ret)
  903. goto out_unreg_genl;
  904. return 0;
  905. out_unreg_genl:
  906. genl_unregister_family(&tcmu_genl_family);
  907. out_unreg_device:
  908. root_device_unregister(tcmu_root_device);
  909. out_free_cache:
  910. kmem_cache_destroy(tcmu_cmd_cache);
  911. return ret;
  912. }
  913. static void __exit tcmu_module_exit(void)
  914. {
  915. transport_subsystem_release(&tcmu_template);
  916. genl_unregister_family(&tcmu_genl_family);
  917. root_device_unregister(tcmu_root_device);
  918. kmem_cache_destroy(tcmu_cmd_cache);
  919. }
  920. MODULE_DESCRIPTION("TCM USER subsystem plugin");
  921. MODULE_AUTHOR("Shaohua Li <shli@kernel.org>");
  922. MODULE_AUTHOR("Andy Grover <agrover@redhat.com>");
  923. MODULE_LICENSE("GPL");
  924. module_init(tcmu_module_init);
  925. module_exit(tcmu_module_exit);