1 // SPDX-License-Identifier: GPL-2.0-only 2 /* 3 * Copyright (C) 2013 Shaohua Li <[email protected]> 4 * Copyright (C) 2014 Red Hat, Inc. 5 * Copyright (C) 2015 Arrikto, Inc. 6 * Copyright (C) 2017 Chinamobile, Inc. 7 */ 8 9 #include <linux/spinlock.h> 10 #include <linux/module.h> 11 #include <linux/kernel.h> 12 #include <linux/timer.h> 13 #include <linux/parser.h> 14 #include <linux/vmalloc.h> 15 #include <linux/uio_driver.h> 16 #include <linux/xarray.h> 17 #include <linux/stringify.h> 18 #include <linux/bitops.h> 19 #include <linux/highmem.h> 20 #include <linux/configfs.h> 21 #include <linux/mutex.h> 22 #include <linux/workqueue.h> 23 #include <net/genetlink.h> 24 #include <scsi/scsi_common.h> 25 #include <scsi/scsi_proto.h> 26 #include <target/target_core_base.h> 27 #include <target/target_core_fabric.h> 28 #include <target/target_core_backend.h> 29 30 #include <linux/target_core_user.h> 31 32 /** 33 * DOC: Userspace I/O 34 * Userspace I/O 35 * ------------- 36 * 37 * Define a shared-memory interface for LIO to pass SCSI commands and 38 * data to userspace for processing. This is to allow backends that 39 * are too complex for in-kernel support to be possible. 40 * 41 * It uses the UIO framework to do a lot of the device-creation and 42 * introspection work for us. 43 * 44 * See the .h file for how the ring is laid out. Note that while the 45 * command ring is defined, the particulars of the data area are 46 * not. Offset values in the command entry point to other locations 47 * internal to the mmap-ed area. There is separate space outside the 48 * command ring for data buffers. This leaves maximum flexibility for 49 * moving buffer allocations, or even page flipping or other 50 * allocation techniques, without altering the command ring layout. 51 * 52 * SECURITY: 53 * The user process must be assumed to be malicious. There's no way to 54 * prevent it breaking the command ring protocol if it wants, but in 55 * order to prevent other issues we must only ever read *data* from 56 * the shared memory area, not offsets or sizes. This applies to 57 * command ring entries as well as the mailbox. Extra code needed for 58 * this may have a 'UAM' comment. 59 */ 60 61 #define TCMU_TIME_OUT (30 * MSEC_PER_SEC) 62 63 /* For mailbox plus cmd ring, the size is fixed 8MB */ 64 #define MB_CMDR_SIZE (8 * 1024 * 1024) 65 /* Offset of cmd ring is size of mailbox */ 66 #define CMDR_OFF sizeof(struct tcmu_mailbox) 67 #define CMDR_SIZE (MB_CMDR_SIZE - CMDR_OFF) 68 69 /* 70 * For data area, the default block size is PAGE_SIZE and 71 * the default total size is 256K * PAGE_SIZE. 72 */ 73 #define DATA_PAGES_PER_BLK 1 74 #define DATA_BLOCK_SIZE (DATA_PAGES_PER_BLK * PAGE_SIZE) 75 #define DATA_AREA_PAGES_DEF (256 * 1024) 76 77 #define TCMU_MBS_TO_PAGES(_mbs) ((size_t)_mbs << (20 - PAGE_SHIFT)) 78 #define TCMU_PAGES_TO_MBS(_pages) (_pages >> (20 - PAGE_SHIFT)) 79 80 /* 81 * Default number of global data blocks(512K * PAGE_SIZE) 82 * when the unmap thread will be started. 83 */ 84 #define TCMU_GLOBAL_MAX_PAGES_DEF (512 * 1024) 85 86 static u8 tcmu_kern_cmd_reply_supported; 87 static u8 tcmu_netlink_blocked; 88 89 static struct device *tcmu_root_device; 90 91 struct tcmu_hba { 92 u32 host_id; 93 }; 94 95 #define TCMU_CONFIG_LEN 256 96 97 static DEFINE_MUTEX(tcmu_nl_cmd_mutex); 98 static LIST_HEAD(tcmu_nl_cmd_list); 99 100 struct tcmu_dev; 101 102 struct tcmu_nl_cmd { 103 /* wake up thread waiting for reply */ 104 struct completion complete; 105 struct list_head nl_list; 106 struct tcmu_dev *udev; 107 int cmd; 108 int status; 109 }; 110 111 struct tcmu_dev { 112 struct list_head node; 113 struct kref kref; 114 115 struct se_device se_dev; 116 struct se_dev_plug se_plug; 117 118 char *name; 119 struct se_hba *hba; 120 121 #define TCMU_DEV_BIT_OPEN 0 122 #define TCMU_DEV_BIT_BROKEN 1 123 #define TCMU_DEV_BIT_BLOCKED 2 124 #define TCMU_DEV_BIT_TMR_NOTIFY 3 125 #define TCM_DEV_BIT_PLUGGED 4 126 unsigned long flags; 127 128 struct uio_info uio_info; 129 130 struct inode *inode; 131 132 uint64_t dev_size; 133 134 struct tcmu_mailbox *mb_addr; 135 void *cmdr; 136 u32 cmdr_size; 137 u32 cmdr_last_cleaned; 138 /* Offset of data area from start of mb */ 139 /* Must add data_off and mb_addr to get the address */ 140 size_t data_off; 141 int data_area_mb; 142 uint32_t max_blocks; 143 size_t mmap_pages; 144 145 struct mutex cmdr_lock; 146 struct list_head qfull_queue; 147 struct list_head tmr_queue; 148 149 uint32_t dbi_max; 150 uint32_t dbi_thresh; 151 unsigned long *data_bitmap; 152 struct xarray data_pages; 153 154 struct xarray commands; 155 156 struct timer_list cmd_timer; 157 unsigned int cmd_time_out; 158 struct list_head inflight_queue; 159 160 struct timer_list qfull_timer; 161 int qfull_time_out; 162 163 struct list_head timedout_entry; 164 165 struct tcmu_nl_cmd curr_nl_cmd; 166 167 char dev_config[TCMU_CONFIG_LEN]; 168 169 int nl_reply_supported; 170 }; 171 172 #define TCMU_DEV(_se_dev) container_of(_se_dev, struct tcmu_dev, se_dev) 173 174 struct tcmu_cmd { 175 struct se_cmd *se_cmd; 176 struct tcmu_dev *tcmu_dev; 177 struct list_head queue_entry; 178 179 uint16_t cmd_id; 180 181 /* Can't use se_cmd when cleaning up expired cmds, because if 182 cmd has been completed then accessing se_cmd is off limits */ 183 uint32_t dbi_cnt; 184 uint32_t dbi_bidi_cnt; 185 uint32_t dbi_cur; 186 uint32_t *dbi; 187 188 uint32_t data_len_bidi; 189 190 unsigned long deadline; 191 192 #define TCMU_CMD_BIT_EXPIRED 0 193 unsigned long flags; 194 }; 195 196 struct tcmu_tmr { 197 struct list_head queue_entry; 198 199 uint8_t tmr_type; 200 uint32_t tmr_cmd_cnt; 201 int16_t tmr_cmd_ids[]; 202 }; 203 204 /* 205 * To avoid dead lock the mutex lock order should always be: 206 * 207 * mutex_lock(&root_udev_mutex); 208 * ... 209 * mutex_lock(&tcmu_dev->cmdr_lock); 210 * mutex_unlock(&tcmu_dev->cmdr_lock); 211 * ... 212 * mutex_unlock(&root_udev_mutex); 213 */ 214 static DEFINE_MUTEX(root_udev_mutex); 215 static LIST_HEAD(root_udev); 216 217 static DEFINE_SPINLOCK(timed_out_udevs_lock); 218 static LIST_HEAD(timed_out_udevs); 219 220 static struct kmem_cache *tcmu_cmd_cache; 221 222 static atomic_t global_page_count = ATOMIC_INIT(0); 223 static struct delayed_work tcmu_unmap_work; 224 static int tcmu_global_max_pages = TCMU_GLOBAL_MAX_PAGES_DEF; 225 226 static int tcmu_set_global_max_data_area(const char *str, 227 const struct kernel_param *kp) 228 { 229 int ret, max_area_mb; 230 231 ret = kstrtoint(str, 10, &max_area_mb); 232 if (ret) 233 return -EINVAL; 234 235 if (max_area_mb <= 0) { 236 pr_err("global_max_data_area must be larger than 0.\n"); 237 return -EINVAL; 238 } 239 240 tcmu_global_max_pages = TCMU_MBS_TO_PAGES(max_area_mb); 241 if (atomic_read(&global_page_count) > tcmu_global_max_pages) 242 schedule_delayed_work(&tcmu_unmap_work, 0); 243 else 244 cancel_delayed_work_sync(&tcmu_unmap_work); 245 246 return 0; 247 } 248 249 static int tcmu_get_global_max_data_area(char *buffer, 250 const struct kernel_param *kp) 251 { 252 return sprintf(buffer, "%d\n", TCMU_PAGES_TO_MBS(tcmu_global_max_pages)); 253 } 254 255 static const struct kernel_param_ops tcmu_global_max_data_area_op = { 256 .set = tcmu_set_global_max_data_area, 257 .get = tcmu_get_global_max_data_area, 258 }; 259 260 module_param_cb(global_max_data_area_mb, &tcmu_global_max_data_area_op, NULL, 261 S_IWUSR | S_IRUGO); 262 MODULE_PARM_DESC(global_max_data_area_mb, 263 "Max MBs allowed to be allocated to all the tcmu device's " 264 "data areas."); 265 266 static int tcmu_get_block_netlink(char *buffer, 267 const struct kernel_param *kp) 268 { 269 return sprintf(buffer, "%s\n", tcmu_netlink_blocked ? 270 "blocked" : "unblocked"); 271 } 272 273 static int tcmu_set_block_netlink(const char *str, 274 const struct kernel_param *kp) 275 { 276 int ret; 277 u8 val; 278 279 ret = kstrtou8(str, 0, &val); 280 if (ret < 0) 281 return ret; 282 283 if (val > 1) { 284 pr_err("Invalid block netlink value %u\n", val); 285 return -EINVAL; 286 } 287 288 tcmu_netlink_blocked = val; 289 return 0; 290 } 291 292 static const struct kernel_param_ops tcmu_block_netlink_op = { 293 .set = tcmu_set_block_netlink, 294 .get = tcmu_get_block_netlink, 295 }; 296 297 module_param_cb(block_netlink, &tcmu_block_netlink_op, NULL, S_IWUSR | S_IRUGO); 298 MODULE_PARM_DESC(block_netlink, "Block new netlink commands."); 299 300 static int tcmu_fail_netlink_cmd(struct tcmu_nl_cmd *nl_cmd) 301 { 302 struct tcmu_dev *udev = nl_cmd->udev; 303 304 if (!tcmu_netlink_blocked) { 305 pr_err("Could not reset device's netlink interface. Netlink is not blocked.\n"); 306 return -EBUSY; 307 } 308 309 if (nl_cmd->cmd != TCMU_CMD_UNSPEC) { 310 pr_debug("Aborting nl cmd %d on %s\n", nl_cmd->cmd, udev->name); 311 nl_cmd->status = -EINTR; 312 list_del(&nl_cmd->nl_list); 313 complete(&nl_cmd->complete); 314 } 315 return 0; 316 } 317 318 static int tcmu_set_reset_netlink(const char *str, 319 const struct kernel_param *kp) 320 { 321 struct tcmu_nl_cmd *nl_cmd, *tmp_cmd; 322 int ret; 323 u8 val; 324 325 ret = kstrtou8(str, 0, &val); 326 if (ret < 0) 327 return ret; 328 329 if (val != 1) { 330 pr_err("Invalid reset netlink value %u\n", val); 331 return -EINVAL; 332 } 333 334 mutex_lock(&tcmu_nl_cmd_mutex); 335 list_for_each_entry_safe(nl_cmd, tmp_cmd, &tcmu_nl_cmd_list, nl_list) { 336 ret = tcmu_fail_netlink_cmd(nl_cmd); 337 if (ret) 338 break; 339 } 340 mutex_unlock(&tcmu_nl_cmd_mutex); 341 342 return ret; 343 } 344 345 static const struct kernel_param_ops tcmu_reset_netlink_op = { 346 .set = tcmu_set_reset_netlink, 347 }; 348 349 module_param_cb(reset_netlink, &tcmu_reset_netlink_op, NULL, S_IWUSR); 350 MODULE_PARM_DESC(reset_netlink, "Reset netlink commands."); 351 352 /* multicast group */ 353 enum tcmu_multicast_groups { 354 TCMU_MCGRP_CONFIG, 355 }; 356 357 static const struct genl_multicast_group tcmu_mcgrps[] = { 358 [TCMU_MCGRP_CONFIG] = { .name = "config", }, 359 }; 360 361 static struct nla_policy tcmu_attr_policy[TCMU_ATTR_MAX+1] = { 362 [TCMU_ATTR_DEVICE] = { .type = NLA_STRING }, 363 [TCMU_ATTR_MINOR] = { .type = NLA_U32 }, 364 [TCMU_ATTR_CMD_STATUS] = { .type = NLA_S32 }, 365 [TCMU_ATTR_DEVICE_ID] = { .type = NLA_U32 }, 366 [TCMU_ATTR_SUPP_KERN_CMD_REPLY] = { .type = NLA_U8 }, 367 }; 368 369 static int tcmu_genl_cmd_done(struct genl_info *info, int completed_cmd) 370 { 371 struct tcmu_dev *udev = NULL; 372 struct tcmu_nl_cmd *nl_cmd; 373 int dev_id, rc, ret = 0; 374 375 if (!info->attrs[TCMU_ATTR_CMD_STATUS] || 376 !info->attrs[TCMU_ATTR_DEVICE_ID]) { 377 printk(KERN_ERR "TCMU_ATTR_CMD_STATUS or TCMU_ATTR_DEVICE_ID not set, doing nothing\n"); 378 return -EINVAL; 379 } 380 381 dev_id = nla_get_u32(info->attrs[TCMU_ATTR_DEVICE_ID]); 382 rc = nla_get_s32(info->attrs[TCMU_ATTR_CMD_STATUS]); 383 384 mutex_lock(&tcmu_nl_cmd_mutex); 385 list_for_each_entry(nl_cmd, &tcmu_nl_cmd_list, nl_list) { 386 if (nl_cmd->udev->se_dev.dev_index == dev_id) { 387 udev = nl_cmd->udev; 388 break; 389 } 390 } 391 392 if (!udev) { 393 pr_err("tcmu nl cmd %u/%d completion could not find device with dev id %u.\n", 394 completed_cmd, rc, dev_id); 395 ret = -ENODEV; 396 goto unlock; 397 } 398 list_del(&nl_cmd->nl_list); 399 400 pr_debug("%s genl cmd done got id %d curr %d done %d rc %d stat %d\n", 401 udev->name, dev_id, nl_cmd->cmd, completed_cmd, rc, 402 nl_cmd->status); 403 404 if (nl_cmd->cmd != completed_cmd) { 405 pr_err("Mismatched commands on %s (Expecting reply for %d. Current %d).\n", 406 udev->name, completed_cmd, nl_cmd->cmd); 407 ret = -EINVAL; 408 goto unlock; 409 } 410 411 nl_cmd->status = rc; 412 complete(&nl_cmd->complete); 413 unlock: 414 mutex_unlock(&tcmu_nl_cmd_mutex); 415 return ret; 416 } 417 418 static int tcmu_genl_rm_dev_done(struct sk_buff *skb, struct genl_info *info) 419 { 420 return tcmu_genl_cmd_done(info, TCMU_CMD_REMOVED_DEVICE); 421 } 422 423 static int tcmu_genl_add_dev_done(struct sk_buff *skb, struct genl_info *info) 424 { 425 return tcmu_genl_cmd_done(info, TCMU_CMD_ADDED_DEVICE); 426 } 427 428 static int tcmu_genl_reconfig_dev_done(struct sk_buff *skb, 429 struct genl_info *info) 430 { 431 return tcmu_genl_cmd_done(info, TCMU_CMD_RECONFIG_DEVICE); 432 } 433 434 static int tcmu_genl_set_features(struct sk_buff *skb, struct genl_info *info) 435 { 436 if (info->attrs[TCMU_ATTR_SUPP_KERN_CMD_REPLY]) { 437 tcmu_kern_cmd_reply_supported = 438 nla_get_u8(info->attrs[TCMU_ATTR_SUPP_KERN_CMD_REPLY]); 439 printk(KERN_INFO "tcmu daemon: command reply support %u.\n", 440 tcmu_kern_cmd_reply_supported); 441 } 442 443 return 0; 444 } 445 446 static const struct genl_small_ops tcmu_genl_ops[] = { 447 { 448 .cmd = TCMU_CMD_SET_FEATURES, 449 .validate = GENL_DONT_VALIDATE_STRICT | GENL_DONT_VALIDATE_DUMP, 450 .flags = GENL_ADMIN_PERM, 451 .doit = tcmu_genl_set_features, 452 }, 453 { 454 .cmd = TCMU_CMD_ADDED_DEVICE_DONE, 455 .validate = GENL_DONT_VALIDATE_STRICT | GENL_DONT_VALIDATE_DUMP, 456 .flags = GENL_ADMIN_PERM, 457 .doit = tcmu_genl_add_dev_done, 458 }, 459 { 460 .cmd = TCMU_CMD_REMOVED_DEVICE_DONE, 461 .validate = GENL_DONT_VALIDATE_STRICT | GENL_DONT_VALIDATE_DUMP, 462 .flags = GENL_ADMIN_PERM, 463 .doit = tcmu_genl_rm_dev_done, 464 }, 465 { 466 .cmd = TCMU_CMD_RECONFIG_DEVICE_DONE, 467 .validate = GENL_DONT_VALIDATE_STRICT | GENL_DONT_VALIDATE_DUMP, 468 .flags = GENL_ADMIN_PERM, 469 .doit = tcmu_genl_reconfig_dev_done, 470 }, 471 }; 472 473 /* Our generic netlink family */ 474 static struct genl_family tcmu_genl_family __ro_after_init = { 475 .module = THIS_MODULE, 476 .hdrsize = 0, 477 .name = "TCM-USER", 478 .version = 2, 479 .maxattr = TCMU_ATTR_MAX, 480 .policy = tcmu_attr_policy, 481 .mcgrps = tcmu_mcgrps, 482 .n_mcgrps = ARRAY_SIZE(tcmu_mcgrps), 483 .netnsok = true, 484 .small_ops = tcmu_genl_ops, 485 .n_small_ops = ARRAY_SIZE(tcmu_genl_ops), 486 }; 487 488 #define tcmu_cmd_set_dbi_cur(cmd, index) ((cmd)->dbi_cur = (index)) 489 #define tcmu_cmd_reset_dbi_cur(cmd) tcmu_cmd_set_dbi_cur(cmd, 0) 490 #define tcmu_cmd_set_dbi(cmd, index) ((cmd)->dbi[(cmd)->dbi_cur++] = (index)) 491 #define tcmu_cmd_get_dbi(cmd) ((cmd)->dbi[(cmd)->dbi_cur++]) 492 493 static void tcmu_cmd_free_data(struct tcmu_cmd *tcmu_cmd, uint32_t len) 494 { 495 struct tcmu_dev *udev = tcmu_cmd->tcmu_dev; 496 uint32_t i; 497 498 for (i = 0; i < len; i++) 499 clear_bit(tcmu_cmd->dbi[i], udev->data_bitmap); 500 } 501 502 static inline int tcmu_get_empty_block(struct tcmu_dev *udev, 503 struct tcmu_cmd *tcmu_cmd, 504 int prev_dbi, int length, int *iov_cnt) 505 { 506 XA_STATE(xas, &udev->data_pages, 0); 507 struct page *page; 508 int i, cnt, dbi; 509 int page_cnt = DIV_ROUND_UP(length, PAGE_SIZE); 510 511 dbi = find_first_zero_bit(udev->data_bitmap, udev->dbi_thresh); 512 if (dbi == udev->dbi_thresh) 513 return -1; 514 515 /* Count the number of already allocated pages */ 516 xas_set(&xas, dbi * DATA_PAGES_PER_BLK); 517 for (cnt = 0; xas_next(&xas) && cnt < page_cnt;) 518 cnt++; 519 520 for (i = cnt; i < page_cnt; i++) { 521 /* try to get new page from the mm */ 522 page = alloc_page(GFP_NOIO); 523 if (!page) 524 break; 525 526 if (xa_store(&udev->data_pages, dbi * DATA_PAGES_PER_BLK + i, 527 page, GFP_NOIO)) { 528 __free_page(page); 529 break; 530 } 531 } 532 if (atomic_add_return(i - cnt, &global_page_count) > 533 tcmu_global_max_pages) 534 schedule_delayed_work(&tcmu_unmap_work, 0); 535 536 if (i && dbi > udev->dbi_max) 537 udev->dbi_max = dbi; 538 539 set_bit(dbi, udev->data_bitmap); 540 tcmu_cmd_set_dbi(tcmu_cmd, dbi); 541 542 if (dbi != prev_dbi + 1) 543 *iov_cnt += 1; 544 545 return i == page_cnt ? dbi : -1; 546 } 547 548 static int tcmu_get_empty_blocks(struct tcmu_dev *udev, 549 struct tcmu_cmd *tcmu_cmd, int length) 550 { 551 /* start value of dbi + 1 must not be a valid dbi */ 552 int dbi = -2; 553 int blk_len, iov_cnt = 0; 554 555 for (; length > 0; length -= DATA_BLOCK_SIZE) { 556 blk_len = min_t(int, length, DATA_BLOCK_SIZE); 557 dbi = tcmu_get_empty_block(udev, tcmu_cmd, dbi, blk_len, &iov_cnt); 558 if (dbi < 0) 559 return -1; 560 } 561 return iov_cnt; 562 } 563 564 static inline void tcmu_free_cmd(struct tcmu_cmd *tcmu_cmd) 565 { 566 kfree(tcmu_cmd->dbi); 567 kmem_cache_free(tcmu_cmd_cache, tcmu_cmd); 568 } 569 570 static inline void tcmu_cmd_set_block_cnts(struct tcmu_cmd *cmd) 571 { 572 int i, len; 573 struct se_cmd *se_cmd = cmd->se_cmd; 574 575 cmd->dbi_cnt = DIV_ROUND_UP(se_cmd->data_length, DATA_BLOCK_SIZE); 576 577 if (se_cmd->se_cmd_flags & SCF_BIDI) { 578 BUG_ON(!(se_cmd->t_bidi_data_sg && se_cmd->t_bidi_data_nents)); 579 for (i = 0, len = 0; i < se_cmd->t_bidi_data_nents; i++) 580 len += se_cmd->t_bidi_data_sg[i].length; 581 cmd->dbi_bidi_cnt = DIV_ROUND_UP(len, DATA_BLOCK_SIZE); 582 cmd->dbi_cnt += cmd->dbi_bidi_cnt; 583 cmd->data_len_bidi = len; 584 } 585 } 586 587 static int new_block_to_iov(struct tcmu_dev *udev, struct tcmu_cmd *cmd, 588 struct iovec **iov, int prev_dbi, int len) 589 { 590 /* Get the next dbi */ 591 int dbi = tcmu_cmd_get_dbi(cmd); 592 593 /* Do not add more than DATA_BLOCK_SIZE to iov */ 594 if (len > DATA_BLOCK_SIZE) 595 len = DATA_BLOCK_SIZE; 596 597 /* 598 * The following code will gather and map the blocks to the same iovec 599 * when the blocks are all next to each other. 600 */ 601 if (dbi != prev_dbi + 1) { 602 /* dbi is not next to previous dbi, so start new iov */ 603 if (prev_dbi >= 0) 604 (*iov)++; 605 /* write offset relative to mb_addr */ 606 (*iov)->iov_base = (void __user *) 607 (udev->data_off + dbi * DATA_BLOCK_SIZE); 608 } 609 (*iov)->iov_len += len; 610 611 return dbi; 612 } 613 614 static void tcmu_setup_iovs(struct tcmu_dev *udev, struct tcmu_cmd *cmd, 615 struct iovec **iov, int data_length) 616 { 617 /* start value of dbi + 1 must not be a valid dbi */ 618 int dbi = -2; 619 620 /* We prepare the IOVs for DMA_FROM_DEVICE transfer direction */ 621 for (; data_length > 0; data_length -= DATA_BLOCK_SIZE) 622 dbi = new_block_to_iov(udev, cmd, iov, dbi, data_length); 623 } 624 625 static struct tcmu_cmd *tcmu_alloc_cmd(struct se_cmd *se_cmd) 626 { 627 struct se_device *se_dev = se_cmd->se_dev; 628 struct tcmu_dev *udev = TCMU_DEV(se_dev); 629 struct tcmu_cmd *tcmu_cmd; 630 631 tcmu_cmd = kmem_cache_zalloc(tcmu_cmd_cache, GFP_NOIO); 632 if (!tcmu_cmd) 633 return NULL; 634 635 INIT_LIST_HEAD(&tcmu_cmd->queue_entry); 636 tcmu_cmd->se_cmd = se_cmd; 637 tcmu_cmd->tcmu_dev = udev; 638 639 tcmu_cmd_set_block_cnts(tcmu_cmd); 640 tcmu_cmd->dbi = kcalloc(tcmu_cmd->dbi_cnt, sizeof(uint32_t), 641 GFP_NOIO); 642 if (!tcmu_cmd->dbi) { 643 kmem_cache_free(tcmu_cmd_cache, tcmu_cmd); 644 return NULL; 645 } 646 647 return tcmu_cmd; 648 } 649 650 static inline void tcmu_flush_dcache_range(void *vaddr, size_t size) 651 { 652 unsigned long offset = offset_in_page(vaddr); 653 void *start = vaddr - offset; 654 655 size = round_up(size+offset, PAGE_SIZE); 656 657 while (size) { 658 flush_dcache_page(vmalloc_to_page(start)); 659 start += PAGE_SIZE; 660 size -= PAGE_SIZE; 661 } 662 } 663 664 /* 665 * Some ring helper functions. We don't assume size is a power of 2 so 666 * we can't use circ_buf.h. 667 */ 668 static inline size_t spc_used(size_t head, size_t tail, size_t size) 669 { 670 int diff = head - tail; 671 672 if (diff >= 0) 673 return diff; 674 else 675 return size + diff; 676 } 677 678 static inline size_t spc_free(size_t head, size_t tail, size_t size) 679 { 680 /* Keep 1 byte unused or we can't tell full from empty */ 681 return (size - spc_used(head, tail, size) - 1); 682 } 683 684 static inline size_t head_to_end(size_t head, size_t size) 685 { 686 return size - head; 687 } 688 689 #define UPDATE_HEAD(head, used, size) smp_store_release(&head, ((head % size) + used) % size) 690 691 #define TCMU_SG_TO_DATA_AREA 1 692 #define TCMU_DATA_AREA_TO_SG 2 693 694 static inline void tcmu_copy_data(struct tcmu_dev *udev, 695 struct tcmu_cmd *tcmu_cmd, uint32_t direction, 696 struct scatterlist *sg, unsigned int sg_nents, 697 struct iovec **iov, size_t data_len) 698 { 699 XA_STATE(xas, &udev->data_pages, 0); 700 /* start value of dbi + 1 must not be a valid dbi */ 701 int dbi = -2; 702 size_t page_remaining, cp_len; 703 int page_cnt, page_inx; 704 struct sg_mapping_iter sg_iter; 705 unsigned int sg_flags; 706 struct page *page; 707 void *data_page_start, *data_addr; 708 709 if (direction == TCMU_SG_TO_DATA_AREA) 710 sg_flags = SG_MITER_ATOMIC | SG_MITER_FROM_SG; 711 else 712 sg_flags = SG_MITER_ATOMIC | SG_MITER_TO_SG; 713 sg_miter_start(&sg_iter, sg, sg_nents, sg_flags); 714 715 while (data_len) { 716 if (direction == TCMU_SG_TO_DATA_AREA) 717 dbi = new_block_to_iov(udev, tcmu_cmd, iov, dbi, 718 data_len); 719 else 720 dbi = tcmu_cmd_get_dbi(tcmu_cmd); 721 722 page_cnt = DIV_ROUND_UP(data_len, PAGE_SIZE); 723 if (page_cnt > DATA_PAGES_PER_BLK) 724 page_cnt = DATA_PAGES_PER_BLK; 725 726 xas_set(&xas, dbi * DATA_PAGES_PER_BLK); 727 for (page_inx = 0; page_inx < page_cnt && data_len; page_inx++) { 728 page = xas_next(&xas); 729 730 if (direction == TCMU_DATA_AREA_TO_SG) 731 flush_dcache_page(page); 732 data_page_start = kmap_atomic(page); 733 page_remaining = PAGE_SIZE; 734 735 while (page_remaining && data_len) { 736 if (!sg_miter_next(&sg_iter)) { 737 /* set length to 0 to abort outer loop */ 738 data_len = 0; 739 pr_debug("%s: aborting data copy due to exhausted sg_list\n", 740 __func__); 741 break; 742 } 743 cp_len = min3(sg_iter.length, page_remaining, 744 data_len); 745 746 data_addr = data_page_start + 747 PAGE_SIZE - page_remaining; 748 if (direction == TCMU_SG_TO_DATA_AREA) 749 memcpy(data_addr, sg_iter.addr, cp_len); 750 else 751 memcpy(sg_iter.addr, data_addr, cp_len); 752 753 data_len -= cp_len; 754 page_remaining -= cp_len; 755 sg_iter.consumed = cp_len; 756 } 757 sg_miter_stop(&sg_iter); 758 759 kunmap_atomic(data_page_start); 760 if (direction == TCMU_SG_TO_DATA_AREA) 761 flush_dcache_page(page); 762 } 763 } 764 } 765 766 static void scatter_data_area(struct tcmu_dev *udev, struct tcmu_cmd *tcmu_cmd, 767 struct iovec **iov) 768 { 769 struct se_cmd *se_cmd = tcmu_cmd->se_cmd; 770 771 tcmu_copy_data(udev, tcmu_cmd, TCMU_SG_TO_DATA_AREA, se_cmd->t_data_sg, 772 se_cmd->t_data_nents, iov, se_cmd->data_length); 773 } 774 775 static void gather_data_area(struct tcmu_dev *udev, struct tcmu_cmd *tcmu_cmd, 776 bool bidi, uint32_t read_len) 777 { 778 struct se_cmd *se_cmd = tcmu_cmd->se_cmd; 779 struct scatterlist *data_sg; 780 unsigned int data_nents; 781 782 if (!bidi) { 783 data_sg = se_cmd->t_data_sg; 784 data_nents = se_cmd->t_data_nents; 785 } else { 786 /* 787 * For bidi case, the first count blocks are for Data-Out 788 * buffer blocks, and before gathering the Data-In buffer 789 * the Data-Out buffer blocks should be skipped. 790 */ 791 tcmu_cmd_set_dbi_cur(tcmu_cmd, 792 tcmu_cmd->dbi_cnt - tcmu_cmd->dbi_bidi_cnt); 793 794 data_sg = se_cmd->t_bidi_data_sg; 795 data_nents = se_cmd->t_bidi_data_nents; 796 } 797 798 tcmu_copy_data(udev, tcmu_cmd, TCMU_DATA_AREA_TO_SG, data_sg, 799 data_nents, NULL, read_len); 800 } 801 802 static inline size_t spc_bitmap_free(unsigned long *bitmap, uint32_t thresh) 803 { 804 return thresh - bitmap_weight(bitmap, thresh); 805 } 806 807 /* 808 * We can't queue a command until we have space available on the cmd ring. 809 * 810 * Called with ring lock held. 811 */ 812 static bool is_ring_space_avail(struct tcmu_dev *udev, size_t cmd_size) 813 { 814 struct tcmu_mailbox *mb = udev->mb_addr; 815 size_t space, cmd_needed; 816 u32 cmd_head; 817 818 tcmu_flush_dcache_range(mb, sizeof(*mb)); 819 820 cmd_head = mb->cmd_head % udev->cmdr_size; /* UAM */ 821 822 /* 823 * If cmd end-of-ring space is too small then we need space for a NOP plus 824 * original cmd - cmds are internally contiguous. 825 */ 826 if (head_to_end(cmd_head, udev->cmdr_size) >= cmd_size) 827 cmd_needed = cmd_size; 828 else 829 cmd_needed = cmd_size + head_to_end(cmd_head, udev->cmdr_size); 830 831 space = spc_free(cmd_head, udev->cmdr_last_cleaned, udev->cmdr_size); 832 if (space < cmd_needed) { 833 pr_debug("no cmd space: %u %u %u\n", cmd_head, 834 udev->cmdr_last_cleaned, udev->cmdr_size); 835 return false; 836 } 837 return true; 838 } 839 840 /* 841 * We have to allocate data buffers before we can queue a command. 842 * Returns -1 on error (not enough space) or number of needed iovs on success 843 * 844 * Called with ring lock held. 845 */ 846 static int tcmu_alloc_data_space(struct tcmu_dev *udev, struct tcmu_cmd *cmd, 847 int *iov_bidi_cnt) 848 { 849 int space, iov_cnt = 0, ret = 0; 850 851 if (!cmd->dbi_cnt) 852 goto wr_iov_cnts; 853 854 /* try to check and get the data blocks as needed */ 855 space = spc_bitmap_free(udev->data_bitmap, udev->dbi_thresh); 856 if (space < cmd->dbi_cnt) { 857 unsigned long blocks_left = 858 (udev->max_blocks - udev->dbi_thresh) + space; 859 860 if (blocks_left < cmd->dbi_cnt) { 861 pr_debug("no data space: only %lu available, but ask for %lu\n", 862 blocks_left * DATA_BLOCK_SIZE, 863 cmd->dbi_cnt * DATA_BLOCK_SIZE); 864 return -1; 865 } 866 867 udev->dbi_thresh += cmd->dbi_cnt; 868 if (udev->dbi_thresh > udev->max_blocks) 869 udev->dbi_thresh = udev->max_blocks; 870 } 871 872 iov_cnt = tcmu_get_empty_blocks(udev, cmd, cmd->se_cmd->data_length); 873 if (iov_cnt < 0) 874 return -1; 875 876 if (cmd->dbi_bidi_cnt) { 877 ret = tcmu_get_empty_blocks(udev, cmd, cmd->data_len_bidi); 878 if (ret < 0) 879 return -1; 880 } 881 wr_iov_cnts: 882 *iov_bidi_cnt = ret; 883 return iov_cnt + ret; 884 } 885 886 static inline size_t tcmu_cmd_get_base_cmd_size(size_t iov_cnt) 887 { 888 return max(offsetof(struct tcmu_cmd_entry, req.iov[iov_cnt]), 889 sizeof(struct tcmu_cmd_entry)); 890 } 891 892 static inline size_t tcmu_cmd_get_cmd_size(struct tcmu_cmd *tcmu_cmd, 893 size_t base_command_size) 894 { 895 struct se_cmd *se_cmd = tcmu_cmd->se_cmd; 896 size_t command_size; 897 898 command_size = base_command_size + 899 round_up(scsi_command_size(se_cmd->t_task_cdb), 900 TCMU_OP_ALIGN_SIZE); 901 902 WARN_ON(command_size & (TCMU_OP_ALIGN_SIZE-1)); 903 904 return command_size; 905 } 906 907 static void tcmu_setup_cmd_timer(struct tcmu_cmd *tcmu_cmd, unsigned int tmo, 908 struct timer_list *timer) 909 { 910 if (!tmo) 911 return; 912 913 tcmu_cmd->deadline = round_jiffies_up(jiffies + msecs_to_jiffies(tmo)); 914 if (!timer_pending(timer)) 915 mod_timer(timer, tcmu_cmd->deadline); 916 917 pr_debug("Timeout set up for cmd %p, dev = %s, tmo = %lu\n", tcmu_cmd, 918 tcmu_cmd->tcmu_dev->name, tmo / MSEC_PER_SEC); 919 } 920 921 static int add_to_qfull_queue(struct tcmu_cmd *tcmu_cmd) 922 { 923 struct tcmu_dev *udev = tcmu_cmd->tcmu_dev; 924 unsigned int tmo; 925 926 /* 927 * For backwards compat if qfull_time_out is not set use 928 * cmd_time_out and if that's not set use the default time out. 929 */ 930 if (!udev->qfull_time_out) 931 return -ETIMEDOUT; 932 else if (udev->qfull_time_out > 0) 933 tmo = udev->qfull_time_out; 934 else if (udev->cmd_time_out) 935 tmo = udev->cmd_time_out; 936 else 937 tmo = TCMU_TIME_OUT; 938 939 tcmu_setup_cmd_timer(tcmu_cmd, tmo, &udev->qfull_timer); 940 941 list_add_tail(&tcmu_cmd->queue_entry, &udev->qfull_queue); 942 pr_debug("adding cmd %p on dev %s to ring space wait queue\n", 943 tcmu_cmd, udev->name); 944 return 0; 945 } 946 947 static uint32_t ring_insert_padding(struct tcmu_dev *udev, size_t cmd_size) 948 { 949 struct tcmu_cmd_entry_hdr *hdr; 950 struct tcmu_mailbox *mb = udev->mb_addr; 951 uint32_t cmd_head = mb->cmd_head % udev->cmdr_size; /* UAM */ 952 953 /* Insert a PAD if end-of-ring space is too small */ 954 if (head_to_end(cmd_head, udev->cmdr_size) < cmd_size) { 955 size_t pad_size = head_to_end(cmd_head, udev->cmdr_size); 956 957 hdr = udev->cmdr + cmd_head; 958 tcmu_hdr_set_op(&hdr->len_op, TCMU_OP_PAD); 959 tcmu_hdr_set_len(&hdr->len_op, pad_size); 960 hdr->cmd_id = 0; /* not used for PAD */ 961 hdr->kflags = 0; 962 hdr->uflags = 0; 963 tcmu_flush_dcache_range(hdr, sizeof(*hdr)); 964 965 UPDATE_HEAD(mb->cmd_head, pad_size, udev->cmdr_size); 966 tcmu_flush_dcache_range(mb, sizeof(*mb)); 967 968 cmd_head = mb->cmd_head % udev->cmdr_size; /* UAM */ 969 WARN_ON(cmd_head != 0); 970 } 971 972 return cmd_head; 973 } 974 975 static void tcmu_unplug_device(struct se_dev_plug *se_plug) 976 { 977 struct se_device *se_dev = se_plug->se_dev; 978 struct tcmu_dev *udev = TCMU_DEV(se_dev); 979 980 clear_bit(TCM_DEV_BIT_PLUGGED, &udev->flags); 981 uio_event_notify(&udev->uio_info); 982 } 983 984 static struct se_dev_plug *tcmu_plug_device(struct se_device *se_dev) 985 { 986 struct tcmu_dev *udev = TCMU_DEV(se_dev); 987 988 if (!test_and_set_bit(TCM_DEV_BIT_PLUGGED, &udev->flags)) 989 return &udev->se_plug; 990 991 return NULL; 992 } 993 994 /** 995 * queue_cmd_ring - queue cmd to ring or internally 996 * @tcmu_cmd: cmd to queue 997 * @scsi_err: TCM error code if failure (-1) returned. 998 * 999 * Returns: 1000 * -1 we cannot queue internally or to the ring. 1001 * 0 success 1002 * 1 internally queued to wait for ring memory to free. 1003 */ 1004 static int queue_cmd_ring(struct tcmu_cmd *tcmu_cmd, sense_reason_t *scsi_err) 1005 { 1006 struct tcmu_dev *udev = tcmu_cmd->tcmu_dev; 1007 struct se_cmd *se_cmd = tcmu_cmd->se_cmd; 1008 size_t base_command_size, command_size; 1009 struct tcmu_mailbox *mb = udev->mb_addr; 1010 struct tcmu_cmd_entry *entry; 1011 struct iovec *iov; 1012 int iov_cnt, iov_bidi_cnt; 1013 uint32_t cmd_id, cmd_head; 1014 uint64_t cdb_off; 1015 /* size of data buffer needed */ 1016 size_t data_length = (size_t)tcmu_cmd->dbi_cnt * DATA_BLOCK_SIZE; 1017 1018 *scsi_err = TCM_NO_SENSE; 1019 1020 if (test_bit(TCMU_DEV_BIT_BLOCKED, &udev->flags)) { 1021 *scsi_err = TCM_LUN_BUSY; 1022 return -1; 1023 } 1024 1025 if (test_bit(TCMU_DEV_BIT_BROKEN, &udev->flags)) { 1026 *scsi_err = TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE; 1027 return -1; 1028 } 1029 1030 if (!list_empty(&udev->qfull_queue)) 1031 goto queue; 1032 1033 if (data_length > udev->max_blocks * DATA_BLOCK_SIZE) { 1034 pr_warn("TCMU: Request of size %zu is too big for %zu data area\n", 1035 data_length, udev->max_blocks * DATA_BLOCK_SIZE); 1036 *scsi_err = TCM_INVALID_CDB_FIELD; 1037 return -1; 1038 } 1039 1040 iov_cnt = tcmu_alloc_data_space(udev, tcmu_cmd, &iov_bidi_cnt); 1041 if (iov_cnt < 0) 1042 goto free_and_queue; 1043 1044 /* 1045 * Must be a certain minimum size for response sense info, but 1046 * also may be larger if the iov array is large. 1047 */ 1048 base_command_size = tcmu_cmd_get_base_cmd_size(iov_cnt); 1049 command_size = tcmu_cmd_get_cmd_size(tcmu_cmd, base_command_size); 1050 1051 if (command_size > (udev->cmdr_size / 2)) { 1052 pr_warn("TCMU: Request of size %zu is too big for %u cmd ring\n", 1053 command_size, udev->cmdr_size); 1054 tcmu_cmd_free_data(tcmu_cmd, tcmu_cmd->dbi_cur); 1055 *scsi_err = TCM_INVALID_CDB_FIELD; 1056 return -1; 1057 } 1058 1059 if (!is_ring_space_avail(udev, command_size)) 1060 /* 1061 * Don't leave commands partially setup because the unmap 1062 * thread might need the blocks to make forward progress. 1063 */ 1064 goto free_and_queue; 1065 1066 if (xa_alloc(&udev->commands, &cmd_id, tcmu_cmd, XA_LIMIT(1, 0xffff), 1067 GFP_NOWAIT) < 0) { 1068 pr_err("tcmu: Could not allocate cmd id.\n"); 1069 1070 tcmu_cmd_free_data(tcmu_cmd, tcmu_cmd->dbi_cnt); 1071 *scsi_err = TCM_OUT_OF_RESOURCES; 1072 return -1; 1073 } 1074 tcmu_cmd->cmd_id = cmd_id; 1075 1076 pr_debug("allocated cmd id %u for cmd %p dev %s\n", tcmu_cmd->cmd_id, 1077 tcmu_cmd, udev->name); 1078 1079 cmd_head = ring_insert_padding(udev, command_size); 1080 1081 entry = udev->cmdr + cmd_head; 1082 memset(entry, 0, command_size); 1083 tcmu_hdr_set_op(&entry->hdr.len_op, TCMU_OP_CMD); 1084 1085 /* prepare iov list and copy data to data area if necessary */ 1086 tcmu_cmd_reset_dbi_cur(tcmu_cmd); 1087 iov = &entry->req.iov[0]; 1088 1089 if (se_cmd->data_direction == DMA_TO_DEVICE || 1090 se_cmd->se_cmd_flags & SCF_BIDI) 1091 scatter_data_area(udev, tcmu_cmd, &iov); 1092 else 1093 tcmu_setup_iovs(udev, tcmu_cmd, &iov, se_cmd->data_length); 1094 1095 entry->req.iov_cnt = iov_cnt - iov_bidi_cnt; 1096 1097 /* Handle BIDI commands */ 1098 if (se_cmd->se_cmd_flags & SCF_BIDI) { 1099 iov++; 1100 tcmu_setup_iovs(udev, tcmu_cmd, &iov, tcmu_cmd->data_len_bidi); 1101 entry->req.iov_bidi_cnt = iov_bidi_cnt; 1102 } 1103 1104 tcmu_setup_cmd_timer(tcmu_cmd, udev->cmd_time_out, &udev->cmd_timer); 1105 1106 entry->hdr.cmd_id = tcmu_cmd->cmd_id; 1107 1108 tcmu_hdr_set_len(&entry->hdr.len_op, command_size); 1109 1110 /* All offsets relative to mb_addr, not start of entry! */ 1111 cdb_off = CMDR_OFF + cmd_head + base_command_size; 1112 memcpy((void *) mb + cdb_off, se_cmd->t_task_cdb, scsi_command_size(se_cmd->t_task_cdb)); 1113 entry->req.cdb_off = cdb_off; 1114 tcmu_flush_dcache_range(entry, command_size); 1115 1116 UPDATE_HEAD(mb->cmd_head, command_size, udev->cmdr_size); 1117 tcmu_flush_dcache_range(mb, sizeof(*mb)); 1118 1119 list_add_tail(&tcmu_cmd->queue_entry, &udev->inflight_queue); 1120 1121 if (!test_bit(TCM_DEV_BIT_PLUGGED, &udev->flags)) 1122 uio_event_notify(&udev->uio_info); 1123 1124 return 0; 1125 1126 free_and_queue: 1127 tcmu_cmd_free_data(tcmu_cmd, tcmu_cmd->dbi_cur); 1128 tcmu_cmd_reset_dbi_cur(tcmu_cmd); 1129 1130 queue: 1131 if (add_to_qfull_queue(tcmu_cmd)) { 1132 *scsi_err = TCM_OUT_OF_RESOURCES; 1133 return -1; 1134 } 1135 1136 return 1; 1137 } 1138 1139 /** 1140 * queue_tmr_ring - queue tmr info to ring or internally 1141 * @udev: related tcmu_dev 1142 * @tmr: tcmu_tmr containing tmr info to queue 1143 * 1144 * Returns: 1145 * 0 success 1146 * 1 internally queued to wait for ring memory to free. 1147 */ 1148 static int 1149 queue_tmr_ring(struct tcmu_dev *udev, struct tcmu_tmr *tmr) 1150 { 1151 struct tcmu_tmr_entry *entry; 1152 int cmd_size; 1153 int id_list_sz; 1154 struct tcmu_mailbox *mb = udev->mb_addr; 1155 uint32_t cmd_head; 1156 1157 if (test_bit(TCMU_DEV_BIT_BROKEN, &udev->flags)) 1158 goto out_free; 1159 1160 id_list_sz = sizeof(tmr->tmr_cmd_ids[0]) * tmr->tmr_cmd_cnt; 1161 cmd_size = round_up(sizeof(*entry) + id_list_sz, TCMU_OP_ALIGN_SIZE); 1162 1163 if (!list_empty(&udev->tmr_queue) || 1164 !is_ring_space_avail(udev, cmd_size)) { 1165 list_add_tail(&tmr->queue_entry, &udev->tmr_queue); 1166 pr_debug("adding tmr %p on dev %s to TMR ring space wait queue\n", 1167 tmr, udev->name); 1168 return 1; 1169 } 1170 1171 cmd_head = ring_insert_padding(udev, cmd_size); 1172 1173 entry = udev->cmdr + cmd_head; 1174 memset(entry, 0, cmd_size); 1175 tcmu_hdr_set_op(&entry->hdr.len_op, TCMU_OP_TMR); 1176 tcmu_hdr_set_len(&entry->hdr.len_op, cmd_size); 1177 entry->tmr_type = tmr->tmr_type; 1178 entry->cmd_cnt = tmr->tmr_cmd_cnt; 1179 memcpy(&entry->cmd_ids[0], &tmr->tmr_cmd_ids[0], id_list_sz); 1180 tcmu_flush_dcache_range(entry, cmd_size); 1181 1182 UPDATE_HEAD(mb->cmd_head, cmd_size, udev->cmdr_size); 1183 tcmu_flush_dcache_range(mb, sizeof(*mb)); 1184 1185 uio_event_notify(&udev->uio_info); 1186 1187 out_free: 1188 kfree(tmr); 1189 1190 return 0; 1191 } 1192 1193 static sense_reason_t 1194 tcmu_queue_cmd(struct se_cmd *se_cmd) 1195 { 1196 struct se_device *se_dev = se_cmd->se_dev; 1197 struct tcmu_dev *udev = TCMU_DEV(se_dev); 1198 struct tcmu_cmd *tcmu_cmd; 1199 sense_reason_t scsi_ret = TCM_CHECK_CONDITION_ABORT_CMD; 1200 int ret = -1; 1201 1202 tcmu_cmd = tcmu_alloc_cmd(se_cmd); 1203 if (!tcmu_cmd) 1204 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE; 1205 1206 mutex_lock(&udev->cmdr_lock); 1207 if (!(se_cmd->transport_state & CMD_T_ABORTED)) 1208 ret = queue_cmd_ring(tcmu_cmd, &scsi_ret); 1209 if (ret < 0) 1210 tcmu_free_cmd(tcmu_cmd); 1211 else 1212 se_cmd->priv = tcmu_cmd; 1213 mutex_unlock(&udev->cmdr_lock); 1214 return scsi_ret; 1215 } 1216 1217 static void tcmu_set_next_deadline(struct list_head *queue, 1218 struct timer_list *timer) 1219 { 1220 struct tcmu_cmd *cmd; 1221 1222 if (!list_empty(queue)) { 1223 cmd = list_first_entry(queue, struct tcmu_cmd, queue_entry); 1224 mod_timer(timer, cmd->deadline); 1225 } else 1226 del_timer(timer); 1227 } 1228 1229 static int 1230 tcmu_tmr_type(enum tcm_tmreq_table tmf) 1231 { 1232 switch (tmf) { 1233 case TMR_ABORT_TASK: return TCMU_TMR_ABORT_TASK; 1234 case TMR_ABORT_TASK_SET: return TCMU_TMR_ABORT_TASK_SET; 1235 case TMR_CLEAR_ACA: return TCMU_TMR_CLEAR_ACA; 1236 case TMR_CLEAR_TASK_SET: return TCMU_TMR_CLEAR_TASK_SET; 1237 case TMR_LUN_RESET: return TCMU_TMR_LUN_RESET; 1238 case TMR_TARGET_WARM_RESET: return TCMU_TMR_TARGET_WARM_RESET; 1239 case TMR_TARGET_COLD_RESET: return TCMU_TMR_TARGET_COLD_RESET; 1240 case TMR_LUN_RESET_PRO: return TCMU_TMR_LUN_RESET_PRO; 1241 default: return TCMU_TMR_UNKNOWN; 1242 } 1243 } 1244 1245 static void 1246 tcmu_tmr_notify(struct se_device *se_dev, enum tcm_tmreq_table tmf, 1247 struct list_head *cmd_list) 1248 { 1249 int i = 0, cmd_cnt = 0; 1250 bool unqueued = false; 1251 uint16_t *cmd_ids = NULL; 1252 struct tcmu_cmd *cmd; 1253 struct se_cmd *se_cmd; 1254 struct tcmu_tmr *tmr; 1255 struct tcmu_dev *udev = TCMU_DEV(se_dev); 1256 1257 mutex_lock(&udev->cmdr_lock); 1258 1259 /* First we check for aborted commands in qfull_queue */ 1260 list_for_each_entry(se_cmd, cmd_list, state_list) { 1261 i++; 1262 if (!se_cmd->priv) 1263 continue; 1264 cmd = se_cmd->priv; 1265 /* Commands on qfull queue have no id yet */ 1266 if (cmd->cmd_id) { 1267 cmd_cnt++; 1268 continue; 1269 } 1270 pr_debug("Removing aborted command %p from queue on dev %s.\n", 1271 cmd, udev->name); 1272 1273 list_del_init(&cmd->queue_entry); 1274 tcmu_free_cmd(cmd); 1275 se_cmd->priv = NULL; 1276 target_complete_cmd(se_cmd, SAM_STAT_TASK_ABORTED); 1277 unqueued = true; 1278 } 1279 if (unqueued) 1280 tcmu_set_next_deadline(&udev->qfull_queue, &udev->qfull_timer); 1281 1282 if (!test_bit(TCMU_DEV_BIT_TMR_NOTIFY, &udev->flags)) 1283 goto unlock; 1284 1285 pr_debug("TMR event %d on dev %s, aborted cmds %d, afflicted cmd_ids %d\n", 1286 tcmu_tmr_type(tmf), udev->name, i, cmd_cnt); 1287 1288 tmr = kmalloc(sizeof(*tmr) + cmd_cnt * sizeof(*cmd_ids), GFP_NOIO); 1289 if (!tmr) 1290 goto unlock; 1291 1292 tmr->tmr_type = tcmu_tmr_type(tmf); 1293 tmr->tmr_cmd_cnt = cmd_cnt; 1294 1295 if (cmd_cnt != 0) { 1296 cmd_cnt = 0; 1297 list_for_each_entry(se_cmd, cmd_list, state_list) { 1298 if (!se_cmd->priv) 1299 continue; 1300 cmd = se_cmd->priv; 1301 if (cmd->cmd_id) 1302 tmr->tmr_cmd_ids[cmd_cnt++] = cmd->cmd_id; 1303 } 1304 } 1305 1306 queue_tmr_ring(udev, tmr); 1307 1308 unlock: 1309 mutex_unlock(&udev->cmdr_lock); 1310 } 1311 1312 static void tcmu_handle_completion(struct tcmu_cmd *cmd, struct tcmu_cmd_entry *entry) 1313 { 1314 struct se_cmd *se_cmd = cmd->se_cmd; 1315 struct tcmu_dev *udev = cmd->tcmu_dev; 1316 bool read_len_valid = false; 1317 uint32_t read_len; 1318 1319 /* 1320 * cmd has been completed already from timeout, just reclaim 1321 * data area space and free cmd 1322 */ 1323 if (test_bit(TCMU_CMD_BIT_EXPIRED, &cmd->flags)) { 1324 WARN_ON_ONCE(se_cmd); 1325 goto out; 1326 } 1327 1328 list_del_init(&cmd->queue_entry); 1329 1330 tcmu_cmd_reset_dbi_cur(cmd); 1331 1332 if (entry->hdr.uflags & TCMU_UFLAG_UNKNOWN_OP) { 1333 pr_warn("TCMU: Userspace set UNKNOWN_OP flag on se_cmd %p\n", 1334 cmd->se_cmd); 1335 entry->rsp.scsi_status = SAM_STAT_CHECK_CONDITION; 1336 goto done; 1337 } 1338 1339 read_len = se_cmd->data_length; 1340 if (se_cmd->data_direction == DMA_FROM_DEVICE && 1341 (entry->hdr.uflags & TCMU_UFLAG_READ_LEN) && entry->rsp.read_len) { 1342 read_len_valid = true; 1343 if (entry->rsp.read_len < read_len) 1344 read_len = entry->rsp.read_len; 1345 } 1346 1347 if (entry->rsp.scsi_status == SAM_STAT_CHECK_CONDITION) { 1348 transport_copy_sense_to_cmd(se_cmd, entry->rsp.sense_buffer); 1349 if (!read_len_valid ) 1350 goto done; 1351 else 1352 se_cmd->se_cmd_flags |= SCF_TREAT_READ_AS_NORMAL; 1353 } 1354 if (se_cmd->se_cmd_flags & SCF_BIDI) { 1355 /* Get Data-In buffer before clean up */ 1356 gather_data_area(udev, cmd, true, read_len); 1357 } else if (se_cmd->data_direction == DMA_FROM_DEVICE) { 1358 gather_data_area(udev, cmd, false, read_len); 1359 } else if (se_cmd->data_direction == DMA_TO_DEVICE) { 1360 /* TODO: */ 1361 } else if (se_cmd->data_direction != DMA_NONE) { 1362 pr_warn("TCMU: data direction was %d!\n", 1363 se_cmd->data_direction); 1364 } 1365 1366 done: 1367 se_cmd->priv = NULL; 1368 if (read_len_valid) { 1369 pr_debug("read_len = %d\n", read_len); 1370 target_complete_cmd_with_length(cmd->se_cmd, 1371 entry->rsp.scsi_status, read_len); 1372 } else 1373 target_complete_cmd(cmd->se_cmd, entry->rsp.scsi_status); 1374 1375 out: 1376 tcmu_cmd_free_data(cmd, cmd->dbi_cnt); 1377 tcmu_free_cmd(cmd); 1378 } 1379 1380 static int tcmu_run_tmr_queue(struct tcmu_dev *udev) 1381 { 1382 struct tcmu_tmr *tmr, *tmp; 1383 LIST_HEAD(tmrs); 1384 1385 if (list_empty(&udev->tmr_queue)) 1386 return 1; 1387 1388 pr_debug("running %s's tmr queue\n", udev->name); 1389 1390 list_splice_init(&udev->tmr_queue, &tmrs); 1391 1392 list_for_each_entry_safe(tmr, tmp, &tmrs, queue_entry) { 1393 list_del_init(&tmr->queue_entry); 1394 1395 pr_debug("removing tmr %p on dev %s from queue\n", 1396 tmr, udev->name); 1397 1398 if (queue_tmr_ring(udev, tmr)) { 1399 pr_debug("ran out of space during tmr queue run\n"); 1400 /* 1401 * tmr was requeued, so just put all tmrs back in 1402 * the queue 1403 */ 1404 list_splice_tail(&tmrs, &udev->tmr_queue); 1405 return 0; 1406 } 1407 } 1408 1409 return 1; 1410 } 1411 1412 static unsigned int tcmu_handle_completions(struct tcmu_dev *udev) 1413 { 1414 struct tcmu_mailbox *mb; 1415 struct tcmu_cmd *cmd; 1416 bool free_space = false; 1417 1418 if (test_bit(TCMU_DEV_BIT_BROKEN, &udev->flags)) { 1419 pr_err("ring broken, not handling completions\n"); 1420 return 0; 1421 } 1422 1423 mb = udev->mb_addr; 1424 tcmu_flush_dcache_range(mb, sizeof(*mb)); 1425 1426 while (udev->cmdr_last_cleaned != READ_ONCE(mb->cmd_tail)) { 1427 1428 struct tcmu_cmd_entry *entry = udev->cmdr + udev->cmdr_last_cleaned; 1429 1430 /* 1431 * Flush max. up to end of cmd ring since current entry might 1432 * be a padding that is shorter than sizeof(*entry) 1433 */ 1434 size_t ring_left = head_to_end(udev->cmdr_last_cleaned, 1435 udev->cmdr_size); 1436 tcmu_flush_dcache_range(entry, ring_left < sizeof(*entry) ? 1437 ring_left : sizeof(*entry)); 1438 1439 free_space = true; 1440 1441 if (tcmu_hdr_get_op(entry->hdr.len_op) == TCMU_OP_PAD || 1442 tcmu_hdr_get_op(entry->hdr.len_op) == TCMU_OP_TMR) { 1443 UPDATE_HEAD(udev->cmdr_last_cleaned, 1444 tcmu_hdr_get_len(entry->hdr.len_op), 1445 udev->cmdr_size); 1446 continue; 1447 } 1448 WARN_ON(tcmu_hdr_get_op(entry->hdr.len_op) != TCMU_OP_CMD); 1449 1450 cmd = xa_erase(&udev->commands, entry->hdr.cmd_id); 1451 if (!cmd) { 1452 pr_err("cmd_id %u not found, ring is broken\n", 1453 entry->hdr.cmd_id); 1454 set_bit(TCMU_DEV_BIT_BROKEN, &udev->flags); 1455 break; 1456 } 1457 1458 tcmu_handle_completion(cmd, entry); 1459 1460 UPDATE_HEAD(udev->cmdr_last_cleaned, 1461 tcmu_hdr_get_len(entry->hdr.len_op), 1462 udev->cmdr_size); 1463 } 1464 if (free_space) 1465 free_space = tcmu_run_tmr_queue(udev); 1466 1467 if (atomic_read(&global_page_count) > tcmu_global_max_pages && 1468 xa_empty(&udev->commands) && list_empty(&udev->qfull_queue)) { 1469 /* 1470 * Allocated blocks exceeded global block limit, currently no 1471 * more pending or waiting commands so try to reclaim blocks. 1472 */ 1473 schedule_delayed_work(&tcmu_unmap_work, 0); 1474 } 1475 if (udev->cmd_time_out) 1476 tcmu_set_next_deadline(&udev->inflight_queue, &udev->cmd_timer); 1477 1478 return free_space; 1479 } 1480 1481 static void tcmu_check_expired_ring_cmd(struct tcmu_cmd *cmd) 1482 { 1483 struct se_cmd *se_cmd; 1484 1485 if (!time_after_eq(jiffies, cmd->deadline)) 1486 return; 1487 1488 set_bit(TCMU_CMD_BIT_EXPIRED, &cmd->flags); 1489 list_del_init(&cmd->queue_entry); 1490 se_cmd = cmd->se_cmd; 1491 se_cmd->priv = NULL; 1492 cmd->se_cmd = NULL; 1493 1494 pr_debug("Timing out inflight cmd %u on dev %s.\n", 1495 cmd->cmd_id, cmd->tcmu_dev->name); 1496 1497 target_complete_cmd(se_cmd, SAM_STAT_CHECK_CONDITION); 1498 } 1499 1500 static void tcmu_check_expired_queue_cmd(struct tcmu_cmd *cmd) 1501 { 1502 struct se_cmd *se_cmd; 1503 1504 if (!time_after_eq(jiffies, cmd->deadline)) 1505 return; 1506 1507 pr_debug("Timing out queued cmd %p on dev %s.\n", 1508 cmd, cmd->tcmu_dev->name); 1509 1510 list_del_init(&cmd->queue_entry); 1511 se_cmd = cmd->se_cmd; 1512 tcmu_free_cmd(cmd); 1513 1514 se_cmd->priv = NULL; 1515 target_complete_cmd(se_cmd, SAM_STAT_TASK_SET_FULL); 1516 } 1517 1518 static void tcmu_device_timedout(struct tcmu_dev *udev) 1519 { 1520 spin_lock(&timed_out_udevs_lock); 1521 if (list_empty(&udev->timedout_entry)) 1522 list_add_tail(&udev->timedout_entry, &timed_out_udevs); 1523 spin_unlock(&timed_out_udevs_lock); 1524 1525 schedule_delayed_work(&tcmu_unmap_work, 0); 1526 } 1527 1528 static void tcmu_cmd_timedout(struct timer_list *t) 1529 { 1530 struct tcmu_dev *udev = from_timer(udev, t, cmd_timer); 1531 1532 pr_debug("%s cmd timeout has expired\n", udev->name); 1533 tcmu_device_timedout(udev); 1534 } 1535 1536 static void tcmu_qfull_timedout(struct timer_list *t) 1537 { 1538 struct tcmu_dev *udev = from_timer(udev, t, qfull_timer); 1539 1540 pr_debug("%s qfull timeout has expired\n", udev->name); 1541 tcmu_device_timedout(udev); 1542 } 1543 1544 static int tcmu_attach_hba(struct se_hba *hba, u32 host_id) 1545 { 1546 struct tcmu_hba *tcmu_hba; 1547 1548 tcmu_hba = kzalloc(sizeof(struct tcmu_hba), GFP_KERNEL); 1549 if (!tcmu_hba) 1550 return -ENOMEM; 1551 1552 tcmu_hba->host_id = host_id; 1553 hba->hba_ptr = tcmu_hba; 1554 1555 return 0; 1556 } 1557 1558 static void tcmu_detach_hba(struct se_hba *hba) 1559 { 1560 kfree(hba->hba_ptr); 1561 hba->hba_ptr = NULL; 1562 } 1563 1564 static struct se_device *tcmu_alloc_device(struct se_hba *hba, const char *name) 1565 { 1566 struct tcmu_dev *udev; 1567 1568 udev = kzalloc(sizeof(struct tcmu_dev), GFP_KERNEL); 1569 if (!udev) 1570 return NULL; 1571 kref_init(&udev->kref); 1572 1573 udev->name = kstrdup(name, GFP_KERNEL); 1574 if (!udev->name) { 1575 kfree(udev); 1576 return NULL; 1577 } 1578 1579 udev->hba = hba; 1580 udev->cmd_time_out = TCMU_TIME_OUT; 1581 udev->qfull_time_out = -1; 1582 1583 udev->max_blocks = DATA_AREA_PAGES_DEF / DATA_PAGES_PER_BLK; 1584 udev->data_area_mb = TCMU_PAGES_TO_MBS(DATA_AREA_PAGES_DEF); 1585 mutex_init(&udev->cmdr_lock); 1586 1587 INIT_LIST_HEAD(&udev->node); 1588 INIT_LIST_HEAD(&udev->timedout_entry); 1589 INIT_LIST_HEAD(&udev->qfull_queue); 1590 INIT_LIST_HEAD(&udev->tmr_queue); 1591 INIT_LIST_HEAD(&udev->inflight_queue); 1592 xa_init_flags(&udev->commands, XA_FLAGS_ALLOC1); 1593 1594 timer_setup(&udev->qfull_timer, tcmu_qfull_timedout, 0); 1595 timer_setup(&udev->cmd_timer, tcmu_cmd_timedout, 0); 1596 1597 xa_init(&udev->data_pages); 1598 1599 return &udev->se_dev; 1600 } 1601 1602 static void tcmu_dev_call_rcu(struct rcu_head *p) 1603 { 1604 struct se_device *dev = container_of(p, struct se_device, rcu_head); 1605 struct tcmu_dev *udev = TCMU_DEV(dev); 1606 1607 kfree(udev->uio_info.name); 1608 kfree(udev->name); 1609 kfree(udev); 1610 } 1611 1612 static int tcmu_check_and_free_pending_cmd(struct tcmu_cmd *cmd) 1613 { 1614 if (test_bit(TCMU_CMD_BIT_EXPIRED, &cmd->flags)) { 1615 kmem_cache_free(tcmu_cmd_cache, cmd); 1616 return 0; 1617 } 1618 return -EINVAL; 1619 } 1620 1621 static u32 tcmu_blocks_release(struct xarray *blocks, unsigned long first, 1622 unsigned long last) 1623 { 1624 XA_STATE(xas, blocks, first * DATA_PAGES_PER_BLK); 1625 struct page *page; 1626 u32 pages_freed = 0; 1627 1628 xas_lock(&xas); 1629 xas_for_each(&xas, page, (last + 1) * DATA_PAGES_PER_BLK - 1) { 1630 xas_store(&xas, NULL); 1631 __free_page(page); 1632 pages_freed++; 1633 } 1634 xas_unlock(&xas); 1635 1636 atomic_sub(pages_freed, &global_page_count); 1637 1638 return pages_freed; 1639 } 1640 1641 static void tcmu_remove_all_queued_tmr(struct tcmu_dev *udev) 1642 { 1643 struct tcmu_tmr *tmr, *tmp; 1644 1645 list_for_each_entry_safe(tmr, tmp, &udev->tmr_queue, queue_entry) { 1646 list_del_init(&tmr->queue_entry); 1647 kfree(tmr); 1648 } 1649 } 1650 1651 static void tcmu_dev_kref_release(struct kref *kref) 1652 { 1653 struct tcmu_dev *udev = container_of(kref, struct tcmu_dev, kref); 1654 struct se_device *dev = &udev->se_dev; 1655 struct tcmu_cmd *cmd; 1656 bool all_expired = true; 1657 unsigned long i; 1658 1659 vfree(udev->mb_addr); 1660 udev->mb_addr = NULL; 1661 1662 spin_lock_bh(&timed_out_udevs_lock); 1663 if (!list_empty(&udev->timedout_entry)) 1664 list_del(&udev->timedout_entry); 1665 spin_unlock_bh(&timed_out_udevs_lock); 1666 1667 /* Upper layer should drain all requests before calling this */ 1668 mutex_lock(&udev->cmdr_lock); 1669 xa_for_each(&udev->commands, i, cmd) { 1670 if (tcmu_check_and_free_pending_cmd(cmd) != 0) 1671 all_expired = false; 1672 } 1673 /* There can be left over TMR cmds. Remove them. */ 1674 tcmu_remove_all_queued_tmr(udev); 1675 if (!list_empty(&udev->qfull_queue)) 1676 all_expired = false; 1677 xa_destroy(&udev->commands); 1678 WARN_ON(!all_expired); 1679 1680 tcmu_blocks_release(&udev->data_pages, 0, udev->dbi_max); 1681 bitmap_free(udev->data_bitmap); 1682 mutex_unlock(&udev->cmdr_lock); 1683 1684 pr_debug("dev_kref_release\n"); 1685 1686 call_rcu(&dev->rcu_head, tcmu_dev_call_rcu); 1687 } 1688 1689 static void run_qfull_queue(struct tcmu_dev *udev, bool fail) 1690 { 1691 struct tcmu_cmd *tcmu_cmd, *tmp_cmd; 1692 LIST_HEAD(cmds); 1693 sense_reason_t scsi_ret; 1694 int ret; 1695 1696 if (list_empty(&udev->qfull_queue)) 1697 return; 1698 1699 pr_debug("running %s's cmdr queue forcefail %d\n", udev->name, fail); 1700 1701 list_splice_init(&udev->qfull_queue, &cmds); 1702 1703 list_for_each_entry_safe(tcmu_cmd, tmp_cmd, &cmds, queue_entry) { 1704 list_del_init(&tcmu_cmd->queue_entry); 1705 1706 pr_debug("removing cmd %p on dev %s from queue\n", 1707 tcmu_cmd, udev->name); 1708 1709 if (fail) { 1710 /* 1711 * We were not able to even start the command, so 1712 * fail with busy to allow a retry in case runner 1713 * was only temporarily down. If the device is being 1714 * removed then LIO core will do the right thing and 1715 * fail the retry. 1716 */ 1717 tcmu_cmd->se_cmd->priv = NULL; 1718 target_complete_cmd(tcmu_cmd->se_cmd, SAM_STAT_BUSY); 1719 tcmu_free_cmd(tcmu_cmd); 1720 continue; 1721 } 1722 1723 ret = queue_cmd_ring(tcmu_cmd, &scsi_ret); 1724 if (ret < 0) { 1725 pr_debug("cmd %p on dev %s failed with %u\n", 1726 tcmu_cmd, udev->name, scsi_ret); 1727 /* 1728 * Ignore scsi_ret for now. target_complete_cmd 1729 * drops it. 1730 */ 1731 tcmu_cmd->se_cmd->priv = NULL; 1732 target_complete_cmd(tcmu_cmd->se_cmd, 1733 SAM_STAT_CHECK_CONDITION); 1734 tcmu_free_cmd(tcmu_cmd); 1735 } else if (ret > 0) { 1736 pr_debug("ran out of space during cmdr queue run\n"); 1737 /* 1738 * cmd was requeued, so just put all cmds back in 1739 * the queue 1740 */ 1741 list_splice_tail(&cmds, &udev->qfull_queue); 1742 break; 1743 } 1744 } 1745 1746 tcmu_set_next_deadline(&udev->qfull_queue, &udev->qfull_timer); 1747 } 1748 1749 static int tcmu_irqcontrol(struct uio_info *info, s32 irq_on) 1750 { 1751 struct tcmu_dev *udev = container_of(info, struct tcmu_dev, uio_info); 1752 1753 mutex_lock(&udev->cmdr_lock); 1754 if (tcmu_handle_completions(udev)) 1755 run_qfull_queue(udev, false); 1756 mutex_unlock(&udev->cmdr_lock); 1757 1758 return 0; 1759 } 1760 1761 /* 1762 * mmap code from uio.c. Copied here because we want to hook mmap() 1763 * and this stuff must come along. 1764 */ 1765 static int tcmu_find_mem_index(struct vm_area_struct *vma) 1766 { 1767 struct tcmu_dev *udev = vma->vm_private_data; 1768 struct uio_info *info = &udev->uio_info; 1769 1770 if (vma->vm_pgoff < MAX_UIO_MAPS) { 1771 if (info->mem[vma->vm_pgoff].size == 0) 1772 return -1; 1773 return (int)vma->vm_pgoff; 1774 } 1775 return -1; 1776 } 1777 1778 static struct page *tcmu_try_get_data_page(struct tcmu_dev *udev, uint32_t dpi) 1779 { 1780 struct page *page; 1781 1782 mutex_lock(&udev->cmdr_lock); 1783 page = xa_load(&udev->data_pages, dpi); 1784 if (likely(page)) { 1785 mutex_unlock(&udev->cmdr_lock); 1786 return page; 1787 } 1788 1789 /* 1790 * Userspace messed up and passed in a address not in the 1791 * data iov passed to it. 1792 */ 1793 pr_err("Invalid addr to data page mapping (dpi %u) on device %s\n", 1794 dpi, udev->name); 1795 mutex_unlock(&udev->cmdr_lock); 1796 1797 return NULL; 1798 } 1799 1800 static void tcmu_vma_open(struct vm_area_struct *vma) 1801 { 1802 struct tcmu_dev *udev = vma->vm_private_data; 1803 1804 pr_debug("vma_open\n"); 1805 1806 kref_get(&udev->kref); 1807 } 1808 1809 static void tcmu_vma_close(struct vm_area_struct *vma) 1810 { 1811 struct tcmu_dev *udev = vma->vm_private_data; 1812 1813 pr_debug("vma_close\n"); 1814 1815 /* release ref from tcmu_vma_open */ 1816 kref_put(&udev->kref, tcmu_dev_kref_release); 1817 } 1818 1819 static vm_fault_t tcmu_vma_fault(struct vm_fault *vmf) 1820 { 1821 struct tcmu_dev *udev = vmf->vma->vm_private_data; 1822 struct uio_info *info = &udev->uio_info; 1823 struct page *page; 1824 unsigned long offset; 1825 void *addr; 1826 1827 int mi = tcmu_find_mem_index(vmf->vma); 1828 if (mi < 0) 1829 return VM_FAULT_SIGBUS; 1830 1831 /* 1832 * We need to subtract mi because userspace uses offset = N*PAGE_SIZE 1833 * to use mem[N]. 1834 */ 1835 offset = (vmf->pgoff - mi) << PAGE_SHIFT; 1836 1837 if (offset < udev->data_off) { 1838 /* For the vmalloc()ed cmd area pages */ 1839 addr = (void *)(unsigned long)info->mem[mi].addr + offset; 1840 page = vmalloc_to_page(addr); 1841 } else { 1842 uint32_t dpi; 1843 1844 /* For the dynamically growing data area pages */ 1845 dpi = (offset - udev->data_off) / PAGE_SIZE; 1846 page = tcmu_try_get_data_page(udev, dpi); 1847 if (!page) 1848 return VM_FAULT_SIGBUS; 1849 } 1850 1851 get_page(page); 1852 vmf->page = page; 1853 return 0; 1854 } 1855 1856 static const struct vm_operations_struct tcmu_vm_ops = { 1857 .open = tcmu_vma_open, 1858 .close = tcmu_vma_close, 1859 .fault = tcmu_vma_fault, 1860 }; 1861 1862 static int tcmu_mmap(struct uio_info *info, struct vm_area_struct *vma) 1863 { 1864 struct tcmu_dev *udev = container_of(info, struct tcmu_dev, uio_info); 1865 1866 vma->vm_flags |= VM_DONTEXPAND | VM_DONTDUMP; 1867 vma->vm_ops = &tcmu_vm_ops; 1868 1869 vma->vm_private_data = udev; 1870 1871 /* Ensure the mmap is exactly the right size */ 1872 if (vma_pages(vma) != udev->mmap_pages) 1873 return -EINVAL; 1874 1875 tcmu_vma_open(vma); 1876 1877 return 0; 1878 } 1879 1880 static int tcmu_open(struct uio_info *info, struct inode *inode) 1881 { 1882 struct tcmu_dev *udev = container_of(info, struct tcmu_dev, uio_info); 1883 1884 /* O_EXCL not supported for char devs, so fake it? */ 1885 if (test_and_set_bit(TCMU_DEV_BIT_OPEN, &udev->flags)) 1886 return -EBUSY; 1887 1888 udev->inode = inode; 1889 1890 pr_debug("open\n"); 1891 1892 return 0; 1893 } 1894 1895 static int tcmu_release(struct uio_info *info, struct inode *inode) 1896 { 1897 struct tcmu_dev *udev = container_of(info, struct tcmu_dev, uio_info); 1898 1899 clear_bit(TCMU_DEV_BIT_OPEN, &udev->flags); 1900 1901 pr_debug("close\n"); 1902 1903 return 0; 1904 } 1905 1906 static int tcmu_init_genl_cmd_reply(struct tcmu_dev *udev, int cmd) 1907 { 1908 struct tcmu_nl_cmd *nl_cmd = &udev->curr_nl_cmd; 1909 1910 if (!tcmu_kern_cmd_reply_supported) 1911 return 0; 1912 1913 if (udev->nl_reply_supported <= 0) 1914 return 0; 1915 1916 mutex_lock(&tcmu_nl_cmd_mutex); 1917 1918 if (tcmu_netlink_blocked) { 1919 mutex_unlock(&tcmu_nl_cmd_mutex); 1920 pr_warn("Failing nl cmd %d on %s. Interface is blocked.\n", cmd, 1921 udev->name); 1922 return -EAGAIN; 1923 } 1924 1925 if (nl_cmd->cmd != TCMU_CMD_UNSPEC) { 1926 mutex_unlock(&tcmu_nl_cmd_mutex); 1927 pr_warn("netlink cmd %d already executing on %s\n", 1928 nl_cmd->cmd, udev->name); 1929 return -EBUSY; 1930 } 1931 1932 memset(nl_cmd, 0, sizeof(*nl_cmd)); 1933 nl_cmd->cmd = cmd; 1934 nl_cmd->udev = udev; 1935 init_completion(&nl_cmd->complete); 1936 INIT_LIST_HEAD(&nl_cmd->nl_list); 1937 1938 list_add_tail(&nl_cmd->nl_list, &tcmu_nl_cmd_list); 1939 1940 mutex_unlock(&tcmu_nl_cmd_mutex); 1941 return 0; 1942 } 1943 1944 static void tcmu_destroy_genl_cmd_reply(struct tcmu_dev *udev) 1945 { 1946 struct tcmu_nl_cmd *nl_cmd = &udev->curr_nl_cmd; 1947 1948 if (!tcmu_kern_cmd_reply_supported) 1949 return; 1950 1951 if (udev->nl_reply_supported <= 0) 1952 return; 1953 1954 mutex_lock(&tcmu_nl_cmd_mutex); 1955 1956 list_del(&nl_cmd->nl_list); 1957 memset(nl_cmd, 0, sizeof(*nl_cmd)); 1958 1959 mutex_unlock(&tcmu_nl_cmd_mutex); 1960 } 1961 1962 static int tcmu_wait_genl_cmd_reply(struct tcmu_dev *udev) 1963 { 1964 struct tcmu_nl_cmd *nl_cmd = &udev->curr_nl_cmd; 1965 int ret; 1966 1967 if (!tcmu_kern_cmd_reply_supported) 1968 return 0; 1969 1970 if (udev->nl_reply_supported <= 0) 1971 return 0; 1972 1973 pr_debug("sleeping for nl reply\n"); 1974 wait_for_completion(&nl_cmd->complete); 1975 1976 mutex_lock(&tcmu_nl_cmd_mutex); 1977 nl_cmd->cmd = TCMU_CMD_UNSPEC; 1978 ret = nl_cmd->status; 1979 mutex_unlock(&tcmu_nl_cmd_mutex); 1980 1981 return ret; 1982 } 1983 1984 static int tcmu_netlink_event_init(struct tcmu_dev *udev, 1985 enum tcmu_genl_cmd cmd, 1986 struct sk_buff **buf, void **hdr) 1987 { 1988 struct sk_buff *skb; 1989 void *msg_header; 1990 int ret = -ENOMEM; 1991 1992 skb = genlmsg_new(NLMSG_GOODSIZE, GFP_KERNEL); 1993 if (!skb) 1994 return ret; 1995 1996 msg_header = genlmsg_put(skb, 0, 0, &tcmu_genl_family, 0, cmd); 1997 if (!msg_header) 1998 goto free_skb; 1999 2000 ret = nla_put_string(skb, TCMU_ATTR_DEVICE, udev->uio_info.name); 2001 if (ret < 0) 2002 goto free_skb; 2003 2004 ret = nla_put_u32(skb, TCMU_ATTR_MINOR, udev->uio_info.uio_dev->minor); 2005 if (ret < 0) 2006 goto free_skb; 2007 2008 ret = nla_put_u32(skb, TCMU_ATTR_DEVICE_ID, udev->se_dev.dev_index); 2009 if (ret < 0) 2010 goto free_skb; 2011 2012 *buf = skb; 2013 *hdr = msg_header; 2014 return ret; 2015 2016 free_skb: 2017 nlmsg_free(skb); 2018 return ret; 2019 } 2020 2021 static int tcmu_netlink_event_send(struct tcmu_dev *udev, 2022 enum tcmu_genl_cmd cmd, 2023 struct sk_buff *skb, void *msg_header) 2024 { 2025 int ret; 2026 2027 genlmsg_end(skb, msg_header); 2028 2029 ret = tcmu_init_genl_cmd_reply(udev, cmd); 2030 if (ret) { 2031 nlmsg_free(skb); 2032 return ret; 2033 } 2034 2035 ret = genlmsg_multicast_allns(&tcmu_genl_family, skb, 0, 2036 TCMU_MCGRP_CONFIG, GFP_KERNEL); 2037 2038 /* Wait during an add as the listener may not be up yet */ 2039 if (ret == 0 || 2040 (ret == -ESRCH && cmd == TCMU_CMD_ADDED_DEVICE)) 2041 return tcmu_wait_genl_cmd_reply(udev); 2042 else 2043 tcmu_destroy_genl_cmd_reply(udev); 2044 2045 return ret; 2046 } 2047 2048 static int tcmu_send_dev_add_event(struct tcmu_dev *udev) 2049 { 2050 struct sk_buff *skb = NULL; 2051 void *msg_header = NULL; 2052 int ret = 0; 2053 2054 ret = tcmu_netlink_event_init(udev, TCMU_CMD_ADDED_DEVICE, &skb, 2055 &msg_header); 2056 if (ret < 0) 2057 return ret; 2058 return tcmu_netlink_event_send(udev, TCMU_CMD_ADDED_DEVICE, skb, 2059 msg_header); 2060 } 2061 2062 static int tcmu_send_dev_remove_event(struct tcmu_dev *udev) 2063 { 2064 struct sk_buff *skb = NULL; 2065 void *msg_header = NULL; 2066 int ret = 0; 2067 2068 ret = tcmu_netlink_event_init(udev, TCMU_CMD_REMOVED_DEVICE, 2069 &skb, &msg_header); 2070 if (ret < 0) 2071 return ret; 2072 return tcmu_netlink_event_send(udev, TCMU_CMD_REMOVED_DEVICE, 2073 skb, msg_header); 2074 } 2075 2076 static int tcmu_update_uio_info(struct tcmu_dev *udev) 2077 { 2078 struct tcmu_hba *hba = udev->hba->hba_ptr; 2079 struct uio_info *info; 2080 char *str; 2081 2082 info = &udev->uio_info; 2083 2084 if (udev->dev_config[0]) 2085 str = kasprintf(GFP_KERNEL, "tcm-user/%u/%s/%s", hba->host_id, 2086 udev->name, udev->dev_config); 2087 else 2088 str = kasprintf(GFP_KERNEL, "tcm-user/%u/%s", hba->host_id, 2089 udev->name); 2090 if (!str) 2091 return -ENOMEM; 2092 2093 /* If the old string exists, free it */ 2094 kfree(info->name); 2095 info->name = str; 2096 2097 return 0; 2098 } 2099 2100 static int tcmu_configure_device(struct se_device *dev) 2101 { 2102 struct tcmu_dev *udev = TCMU_DEV(dev); 2103 struct uio_info *info; 2104 struct tcmu_mailbox *mb; 2105 size_t data_size; 2106 int ret = 0; 2107 2108 ret = tcmu_update_uio_info(udev); 2109 if (ret) 2110 return ret; 2111 2112 info = &udev->uio_info; 2113 2114 mutex_lock(&udev->cmdr_lock); 2115 udev->data_bitmap = bitmap_zalloc(udev->max_blocks, GFP_KERNEL); 2116 mutex_unlock(&udev->cmdr_lock); 2117 if (!udev->data_bitmap) { 2118 ret = -ENOMEM; 2119 goto err_bitmap_alloc; 2120 } 2121 2122 mb = vzalloc(MB_CMDR_SIZE); 2123 if (!mb) { 2124 ret = -ENOMEM; 2125 goto err_vzalloc; 2126 } 2127 2128 /* mailbox fits in first part of CMDR space */ 2129 udev->mb_addr = mb; 2130 udev->cmdr = (void *)mb + CMDR_OFF; 2131 udev->cmdr_size = CMDR_SIZE; 2132 udev->data_off = MB_CMDR_SIZE; 2133 data_size = TCMU_MBS_TO_PAGES(udev->data_area_mb) << PAGE_SHIFT; 2134 udev->mmap_pages = (data_size + MB_CMDR_SIZE) >> PAGE_SHIFT; 2135 udev->dbi_thresh = 0; /* Default in Idle state */ 2136 2137 /* Initialise the mailbox of the ring buffer */ 2138 mb->version = TCMU_MAILBOX_VERSION; 2139 mb->flags = TCMU_MAILBOX_FLAG_CAP_OOOC | 2140 TCMU_MAILBOX_FLAG_CAP_READ_LEN | 2141 TCMU_MAILBOX_FLAG_CAP_TMR; 2142 mb->cmdr_off = CMDR_OFF; 2143 mb->cmdr_size = udev->cmdr_size; 2144 2145 WARN_ON(!PAGE_ALIGNED(udev->data_off)); 2146 WARN_ON(data_size % PAGE_SIZE); 2147 2148 info->version = __stringify(TCMU_MAILBOX_VERSION); 2149 2150 info->mem[0].name = "tcm-user command & data buffer"; 2151 info->mem[0].addr = (phys_addr_t)(uintptr_t)udev->mb_addr; 2152 info->mem[0].size = data_size + MB_CMDR_SIZE; 2153 info->mem[0].memtype = UIO_MEM_NONE; 2154 2155 info->irqcontrol = tcmu_irqcontrol; 2156 info->irq = UIO_IRQ_CUSTOM; 2157 2158 info->mmap = tcmu_mmap; 2159 info->open = tcmu_open; 2160 info->release = tcmu_release; 2161 2162 ret = uio_register_device(tcmu_root_device, info); 2163 if (ret) 2164 goto err_register; 2165 2166 /* User can set hw_block_size before enable the device */ 2167 if (dev->dev_attrib.hw_block_size == 0) 2168 dev->dev_attrib.hw_block_size = 512; 2169 /* Other attributes can be configured in userspace */ 2170 if (!dev->dev_attrib.hw_max_sectors) 2171 dev->dev_attrib.hw_max_sectors = 128; 2172 if (!dev->dev_attrib.emulate_write_cache) 2173 dev->dev_attrib.emulate_write_cache = 0; 2174 dev->dev_attrib.hw_queue_depth = 128; 2175 2176 /* If user didn't explicitly disable netlink reply support, use 2177 * module scope setting. 2178 */ 2179 if (udev->nl_reply_supported >= 0) 2180 udev->nl_reply_supported = tcmu_kern_cmd_reply_supported; 2181 2182 /* 2183 * Get a ref incase userspace does a close on the uio device before 2184 * LIO has initiated tcmu_free_device. 2185 */ 2186 kref_get(&udev->kref); 2187 2188 ret = tcmu_send_dev_add_event(udev); 2189 if (ret) 2190 goto err_netlink; 2191 2192 mutex_lock(&root_udev_mutex); 2193 list_add(&udev->node, &root_udev); 2194 mutex_unlock(&root_udev_mutex); 2195 2196 return 0; 2197 2198 err_netlink: 2199 kref_put(&udev->kref, tcmu_dev_kref_release); 2200 uio_unregister_device(&udev->uio_info); 2201 err_register: 2202 vfree(udev->mb_addr); 2203 udev->mb_addr = NULL; 2204 err_vzalloc: 2205 bitmap_free(udev->data_bitmap); 2206 udev->data_bitmap = NULL; 2207 err_bitmap_alloc: 2208 kfree(info->name); 2209 info->name = NULL; 2210 2211 return ret; 2212 } 2213 2214 static void tcmu_free_device(struct se_device *dev) 2215 { 2216 struct tcmu_dev *udev = TCMU_DEV(dev); 2217 2218 /* release ref from init */ 2219 kref_put(&udev->kref, tcmu_dev_kref_release); 2220 } 2221 2222 static void tcmu_destroy_device(struct se_device *dev) 2223 { 2224 struct tcmu_dev *udev = TCMU_DEV(dev); 2225 2226 del_timer_sync(&udev->cmd_timer); 2227 del_timer_sync(&udev->qfull_timer); 2228 2229 mutex_lock(&root_udev_mutex); 2230 list_del(&udev->node); 2231 mutex_unlock(&root_udev_mutex); 2232 2233 tcmu_send_dev_remove_event(udev); 2234 2235 uio_unregister_device(&udev->uio_info); 2236 2237 /* release ref from configure */ 2238 kref_put(&udev->kref, tcmu_dev_kref_release); 2239 } 2240 2241 static void tcmu_unblock_dev(struct tcmu_dev *udev) 2242 { 2243 mutex_lock(&udev->cmdr_lock); 2244 clear_bit(TCMU_DEV_BIT_BLOCKED, &udev->flags); 2245 mutex_unlock(&udev->cmdr_lock); 2246 } 2247 2248 static void tcmu_block_dev(struct tcmu_dev *udev) 2249 { 2250 mutex_lock(&udev->cmdr_lock); 2251 2252 if (test_and_set_bit(TCMU_DEV_BIT_BLOCKED, &udev->flags)) 2253 goto unlock; 2254 2255 /* complete IO that has executed successfully */ 2256 tcmu_handle_completions(udev); 2257 /* fail IO waiting to be queued */ 2258 run_qfull_queue(udev, true); 2259 2260 unlock: 2261 mutex_unlock(&udev->cmdr_lock); 2262 } 2263 2264 static void tcmu_reset_ring(struct tcmu_dev *udev, u8 err_level) 2265 { 2266 struct tcmu_mailbox *mb; 2267 struct tcmu_cmd *cmd; 2268 unsigned long i; 2269 2270 mutex_lock(&udev->cmdr_lock); 2271 2272 xa_for_each(&udev->commands, i, cmd) { 2273 pr_debug("removing cmd %u on dev %s from ring (is expired %d)\n", 2274 cmd->cmd_id, udev->name, 2275 test_bit(TCMU_CMD_BIT_EXPIRED, &cmd->flags)); 2276 2277 xa_erase(&udev->commands, i); 2278 if (!test_bit(TCMU_CMD_BIT_EXPIRED, &cmd->flags)) { 2279 WARN_ON(!cmd->se_cmd); 2280 list_del_init(&cmd->queue_entry); 2281 cmd->se_cmd->priv = NULL; 2282 if (err_level == 1) { 2283 /* 2284 * Userspace was not able to start the 2285 * command or it is retryable. 2286 */ 2287 target_complete_cmd(cmd->se_cmd, SAM_STAT_BUSY); 2288 } else { 2289 /* hard failure */ 2290 target_complete_cmd(cmd->se_cmd, 2291 SAM_STAT_CHECK_CONDITION); 2292 } 2293 } 2294 tcmu_cmd_free_data(cmd, cmd->dbi_cnt); 2295 tcmu_free_cmd(cmd); 2296 } 2297 2298 mb = udev->mb_addr; 2299 tcmu_flush_dcache_range(mb, sizeof(*mb)); 2300 pr_debug("mb last %u head %u tail %u\n", udev->cmdr_last_cleaned, 2301 mb->cmd_tail, mb->cmd_head); 2302 2303 udev->cmdr_last_cleaned = 0; 2304 mb->cmd_tail = 0; 2305 mb->cmd_head = 0; 2306 tcmu_flush_dcache_range(mb, sizeof(*mb)); 2307 clear_bit(TCMU_DEV_BIT_BROKEN, &udev->flags); 2308 2309 del_timer(&udev->cmd_timer); 2310 2311 /* 2312 * ring is empty and qfull queue never contains aborted commands. 2313 * So TMRs in tmr queue do not contain relevant cmd_ids. 2314 * After a ring reset userspace should do a fresh start, so 2315 * even LUN RESET message is no longer relevant. 2316 * Therefore remove all TMRs from qfull queue 2317 */ 2318 tcmu_remove_all_queued_tmr(udev); 2319 2320 run_qfull_queue(udev, false); 2321 2322 mutex_unlock(&udev->cmdr_lock); 2323 } 2324 2325 enum { 2326 Opt_dev_config, Opt_dev_size, Opt_hw_block_size, Opt_hw_max_sectors, 2327 Opt_nl_reply_supported, Opt_max_data_area_mb, Opt_err, 2328 }; 2329 2330 static match_table_t tokens = { 2331 {Opt_dev_config, "dev_config=%s"}, 2332 {Opt_dev_size, "dev_size=%s"}, 2333 {Opt_hw_block_size, "hw_block_size=%d"}, 2334 {Opt_hw_max_sectors, "hw_max_sectors=%d"}, 2335 {Opt_nl_reply_supported, "nl_reply_supported=%d"}, 2336 {Opt_max_data_area_mb, "max_data_area_mb=%d"}, 2337 {Opt_err, NULL} 2338 }; 2339 2340 static int tcmu_set_dev_attrib(substring_t *arg, u32 *dev_attrib) 2341 { 2342 int val, ret; 2343 2344 ret = match_int(arg, &val); 2345 if (ret < 0) { 2346 pr_err("match_int() failed for dev attrib. Error %d.\n", 2347 ret); 2348 return ret; 2349 } 2350 2351 if (val <= 0) { 2352 pr_err("Invalid dev attrib value %d. Must be greater than zero.\n", 2353 val); 2354 return -EINVAL; 2355 } 2356 *dev_attrib = val; 2357 return 0; 2358 } 2359 2360 static int tcmu_set_max_blocks_param(struct tcmu_dev *udev, substring_t *arg) 2361 { 2362 int val, ret; 2363 2364 ret = match_int(arg, &val); 2365 if (ret < 0) { 2366 pr_err("match_int() failed for max_data_area_mb=. Error %d.\n", 2367 ret); 2368 return ret; 2369 } 2370 if (val <= 0) { 2371 pr_err("Invalid max_data_area %d.\n", val); 2372 return -EINVAL; 2373 } 2374 if (val > TCMU_PAGES_TO_MBS(tcmu_global_max_pages)) { 2375 pr_err("%d is too large. Adjusting max_data_area_mb to global limit of %u\n", 2376 val, TCMU_PAGES_TO_MBS(tcmu_global_max_pages)); 2377 val = TCMU_PAGES_TO_MBS(tcmu_global_max_pages); 2378 } 2379 if (TCMU_MBS_TO_PAGES(val) < DATA_PAGES_PER_BLK) { 2380 pr_err("Invalid max_data_area %d (%zu pages): smaller than data_pages_per_blk (%d pages).\n", 2381 val, TCMU_MBS_TO_PAGES(val), DATA_PAGES_PER_BLK); 2382 return -EINVAL; 2383 } 2384 2385 mutex_lock(&udev->cmdr_lock); 2386 if (udev->data_bitmap) { 2387 pr_err("Cannot set max_data_area_mb after it has been enabled.\n"); 2388 ret = -EINVAL; 2389 goto unlock; 2390 } 2391 2392 udev->data_area_mb = val; 2393 udev->max_blocks = TCMU_MBS_TO_PAGES(val) / DATA_PAGES_PER_BLK; 2394 2395 unlock: 2396 mutex_unlock(&udev->cmdr_lock); 2397 return ret; 2398 } 2399 2400 static ssize_t tcmu_set_configfs_dev_params(struct se_device *dev, 2401 const char *page, ssize_t count) 2402 { 2403 struct tcmu_dev *udev = TCMU_DEV(dev); 2404 char *orig, *ptr, *opts; 2405 substring_t args[MAX_OPT_ARGS]; 2406 int ret = 0, token; 2407 2408 opts = kstrdup(page, GFP_KERNEL); 2409 if (!opts) 2410 return -ENOMEM; 2411 2412 orig = opts; 2413 2414 while ((ptr = strsep(&opts, ",\n")) != NULL) { 2415 if (!*ptr) 2416 continue; 2417 2418 token = match_token(ptr, tokens, args); 2419 switch (token) { 2420 case Opt_dev_config: 2421 if (match_strlcpy(udev->dev_config, &args[0], 2422 TCMU_CONFIG_LEN) == 0) { 2423 ret = -EINVAL; 2424 break; 2425 } 2426 pr_debug("TCMU: Referencing Path: %s\n", udev->dev_config); 2427 break; 2428 case Opt_dev_size: 2429 ret = match_u64(&args[0], &udev->dev_size); 2430 if (ret < 0) 2431 pr_err("match_u64() failed for dev_size=. Error %d.\n", 2432 ret); 2433 break; 2434 case Opt_hw_block_size: 2435 ret = tcmu_set_dev_attrib(&args[0], 2436 &(dev->dev_attrib.hw_block_size)); 2437 break; 2438 case Opt_hw_max_sectors: 2439 ret = tcmu_set_dev_attrib(&args[0], 2440 &(dev->dev_attrib.hw_max_sectors)); 2441 break; 2442 case Opt_nl_reply_supported: 2443 ret = match_int(&args[0], &udev->nl_reply_supported); 2444 if (ret < 0) 2445 pr_err("match_int() failed for nl_reply_supported=. Error %d.\n", 2446 ret); 2447 break; 2448 case Opt_max_data_area_mb: 2449 ret = tcmu_set_max_blocks_param(udev, &args[0]); 2450 break; 2451 default: 2452 break; 2453 } 2454 2455 if (ret) 2456 break; 2457 } 2458 2459 kfree(orig); 2460 return (!ret) ? count : ret; 2461 } 2462 2463 static ssize_t tcmu_show_configfs_dev_params(struct se_device *dev, char *b) 2464 { 2465 struct tcmu_dev *udev = TCMU_DEV(dev); 2466 ssize_t bl = 0; 2467 2468 bl = sprintf(b + bl, "Config: %s ", 2469 udev->dev_config[0] ? udev->dev_config : "NULL"); 2470 bl += sprintf(b + bl, "Size: %llu ", udev->dev_size); 2471 bl += sprintf(b + bl, "MaxDataAreaMB: %u\n", udev->data_area_mb); 2472 2473 return bl; 2474 } 2475 2476 static sector_t tcmu_get_blocks(struct se_device *dev) 2477 { 2478 struct tcmu_dev *udev = TCMU_DEV(dev); 2479 2480 return div_u64(udev->dev_size - dev->dev_attrib.block_size, 2481 dev->dev_attrib.block_size); 2482 } 2483 2484 static sense_reason_t 2485 tcmu_parse_cdb(struct se_cmd *cmd) 2486 { 2487 return passthrough_parse_cdb(cmd, tcmu_queue_cmd); 2488 } 2489 2490 static ssize_t tcmu_cmd_time_out_show(struct config_item *item, char *page) 2491 { 2492 struct se_dev_attrib *da = container_of(to_config_group(item), 2493 struct se_dev_attrib, da_group); 2494 struct tcmu_dev *udev = TCMU_DEV(da->da_dev); 2495 2496 return snprintf(page, PAGE_SIZE, "%lu\n", udev->cmd_time_out / MSEC_PER_SEC); 2497 } 2498 2499 static ssize_t tcmu_cmd_time_out_store(struct config_item *item, const char *page, 2500 size_t count) 2501 { 2502 struct se_dev_attrib *da = container_of(to_config_group(item), 2503 struct se_dev_attrib, da_group); 2504 struct tcmu_dev *udev = container_of(da->da_dev, 2505 struct tcmu_dev, se_dev); 2506 u32 val; 2507 int ret; 2508 2509 if (da->da_dev->export_count) { 2510 pr_err("Unable to set tcmu cmd_time_out while exports exist\n"); 2511 return -EINVAL; 2512 } 2513 2514 ret = kstrtou32(page, 0, &val); 2515 if (ret < 0) 2516 return ret; 2517 2518 udev->cmd_time_out = val * MSEC_PER_SEC; 2519 return count; 2520 } 2521 CONFIGFS_ATTR(tcmu_, cmd_time_out); 2522 2523 static ssize_t tcmu_qfull_time_out_show(struct config_item *item, char *page) 2524 { 2525 struct se_dev_attrib *da = container_of(to_config_group(item), 2526 struct se_dev_attrib, da_group); 2527 struct tcmu_dev *udev = TCMU_DEV(da->da_dev); 2528 2529 return snprintf(page, PAGE_SIZE, "%ld\n", udev->qfull_time_out <= 0 ? 2530 udev->qfull_time_out : 2531 udev->qfull_time_out / MSEC_PER_SEC); 2532 } 2533 2534 static ssize_t tcmu_qfull_time_out_store(struct config_item *item, 2535 const char *page, size_t count) 2536 { 2537 struct se_dev_attrib *da = container_of(to_config_group(item), 2538 struct se_dev_attrib, da_group); 2539 struct tcmu_dev *udev = TCMU_DEV(da->da_dev); 2540 s32 val; 2541 int ret; 2542 2543 ret = kstrtos32(page, 0, &val); 2544 if (ret < 0) 2545 return ret; 2546 2547 if (val >= 0) { 2548 udev->qfull_time_out = val * MSEC_PER_SEC; 2549 } else if (val == -1) { 2550 udev->qfull_time_out = val; 2551 } else { 2552 printk(KERN_ERR "Invalid qfull timeout value %d\n", val); 2553 return -EINVAL; 2554 } 2555 return count; 2556 } 2557 CONFIGFS_ATTR(tcmu_, qfull_time_out); 2558 2559 static ssize_t tcmu_max_data_area_mb_show(struct config_item *item, char *page) 2560 { 2561 struct se_dev_attrib *da = container_of(to_config_group(item), 2562 struct se_dev_attrib, da_group); 2563 struct tcmu_dev *udev = TCMU_DEV(da->da_dev); 2564 2565 return snprintf(page, PAGE_SIZE, "%u\n", udev->data_area_mb); 2566 } 2567 CONFIGFS_ATTR_RO(tcmu_, max_data_area_mb); 2568 2569 static ssize_t tcmu_dev_config_show(struct config_item *item, char *page) 2570 { 2571 struct se_dev_attrib *da = container_of(to_config_group(item), 2572 struct se_dev_attrib, da_group); 2573 struct tcmu_dev *udev = TCMU_DEV(da->da_dev); 2574 2575 return snprintf(page, PAGE_SIZE, "%s\n", udev->dev_config); 2576 } 2577 2578 static int tcmu_send_dev_config_event(struct tcmu_dev *udev, 2579 const char *reconfig_data) 2580 { 2581 struct sk_buff *skb = NULL; 2582 void *msg_header = NULL; 2583 int ret = 0; 2584 2585 ret = tcmu_netlink_event_init(udev, TCMU_CMD_RECONFIG_DEVICE, 2586 &skb, &msg_header); 2587 if (ret < 0) 2588 return ret; 2589 ret = nla_put_string(skb, TCMU_ATTR_DEV_CFG, reconfig_data); 2590 if (ret < 0) { 2591 nlmsg_free(skb); 2592 return ret; 2593 } 2594 return tcmu_netlink_event_send(udev, TCMU_CMD_RECONFIG_DEVICE, 2595 skb, msg_header); 2596 } 2597 2598 2599 static ssize_t tcmu_dev_config_store(struct config_item *item, const char *page, 2600 size_t count) 2601 { 2602 struct se_dev_attrib *da = container_of(to_config_group(item), 2603 struct se_dev_attrib, da_group); 2604 struct tcmu_dev *udev = TCMU_DEV(da->da_dev); 2605 int ret, len; 2606 2607 len = strlen(page); 2608 if (!len || len > TCMU_CONFIG_LEN - 1) 2609 return -EINVAL; 2610 2611 /* Check if device has been configured before */ 2612 if (target_dev_configured(&udev->se_dev)) { 2613 ret = tcmu_send_dev_config_event(udev, page); 2614 if (ret) { 2615 pr_err("Unable to reconfigure device\n"); 2616 return ret; 2617 } 2618 strlcpy(udev->dev_config, page, TCMU_CONFIG_LEN); 2619 2620 ret = tcmu_update_uio_info(udev); 2621 if (ret) 2622 return ret; 2623 return count; 2624 } 2625 strlcpy(udev->dev_config, page, TCMU_CONFIG_LEN); 2626 2627 return count; 2628 } 2629 CONFIGFS_ATTR(tcmu_, dev_config); 2630 2631 static ssize_t tcmu_dev_size_show(struct config_item *item, char *page) 2632 { 2633 struct se_dev_attrib *da = container_of(to_config_group(item), 2634 struct se_dev_attrib, da_group); 2635 struct tcmu_dev *udev = TCMU_DEV(da->da_dev); 2636 2637 return snprintf(page, PAGE_SIZE, "%llu\n", udev->dev_size); 2638 } 2639 2640 static int tcmu_send_dev_size_event(struct tcmu_dev *udev, u64 size) 2641 { 2642 struct sk_buff *skb = NULL; 2643 void *msg_header = NULL; 2644 int ret = 0; 2645 2646 ret = tcmu_netlink_event_init(udev, TCMU_CMD_RECONFIG_DEVICE, 2647 &skb, &msg_header); 2648 if (ret < 0) 2649 return ret; 2650 ret = nla_put_u64_64bit(skb, TCMU_ATTR_DEV_SIZE, 2651 size, TCMU_ATTR_PAD); 2652 if (ret < 0) { 2653 nlmsg_free(skb); 2654 return ret; 2655 } 2656 return tcmu_netlink_event_send(udev, TCMU_CMD_RECONFIG_DEVICE, 2657 skb, msg_header); 2658 } 2659 2660 static ssize_t tcmu_dev_size_store(struct config_item *item, const char *page, 2661 size_t count) 2662 { 2663 struct se_dev_attrib *da = container_of(to_config_group(item), 2664 struct se_dev_attrib, da_group); 2665 struct tcmu_dev *udev = TCMU_DEV(da->da_dev); 2666 u64 val; 2667 int ret; 2668 2669 ret = kstrtou64(page, 0, &val); 2670 if (ret < 0) 2671 return ret; 2672 2673 /* Check if device has been configured before */ 2674 if (target_dev_configured(&udev->se_dev)) { 2675 ret = tcmu_send_dev_size_event(udev, val); 2676 if (ret) { 2677 pr_err("Unable to reconfigure device\n"); 2678 return ret; 2679 } 2680 } 2681 udev->dev_size = val; 2682 return count; 2683 } 2684 CONFIGFS_ATTR(tcmu_, dev_size); 2685 2686 static ssize_t tcmu_nl_reply_supported_show(struct config_item *item, 2687 char *page) 2688 { 2689 struct se_dev_attrib *da = container_of(to_config_group(item), 2690 struct se_dev_attrib, da_group); 2691 struct tcmu_dev *udev = TCMU_DEV(da->da_dev); 2692 2693 return snprintf(page, PAGE_SIZE, "%d\n", udev->nl_reply_supported); 2694 } 2695 2696 static ssize_t tcmu_nl_reply_supported_store(struct config_item *item, 2697 const char *page, size_t count) 2698 { 2699 struct se_dev_attrib *da = container_of(to_config_group(item), 2700 struct se_dev_attrib, da_group); 2701 struct tcmu_dev *udev = TCMU_DEV(da->da_dev); 2702 s8 val; 2703 int ret; 2704 2705 ret = kstrtos8(page, 0, &val); 2706 if (ret < 0) 2707 return ret; 2708 2709 udev->nl_reply_supported = val; 2710 return count; 2711 } 2712 CONFIGFS_ATTR(tcmu_, nl_reply_supported); 2713 2714 static ssize_t tcmu_emulate_write_cache_show(struct config_item *item, 2715 char *page) 2716 { 2717 struct se_dev_attrib *da = container_of(to_config_group(item), 2718 struct se_dev_attrib, da_group); 2719 2720 return snprintf(page, PAGE_SIZE, "%i\n", da->emulate_write_cache); 2721 } 2722 2723 static int tcmu_send_emulate_write_cache(struct tcmu_dev *udev, u8 val) 2724 { 2725 struct sk_buff *skb = NULL; 2726 void *msg_header = NULL; 2727 int ret = 0; 2728 2729 ret = tcmu_netlink_event_init(udev, TCMU_CMD_RECONFIG_DEVICE, 2730 &skb, &msg_header); 2731 if (ret < 0) 2732 return ret; 2733 ret = nla_put_u8(skb, TCMU_ATTR_WRITECACHE, val); 2734 if (ret < 0) { 2735 nlmsg_free(skb); 2736 return ret; 2737 } 2738 return tcmu_netlink_event_send(udev, TCMU_CMD_RECONFIG_DEVICE, 2739 skb, msg_header); 2740 } 2741 2742 static ssize_t tcmu_emulate_write_cache_store(struct config_item *item, 2743 const char *page, size_t count) 2744 { 2745 struct se_dev_attrib *da = container_of(to_config_group(item), 2746 struct se_dev_attrib, da_group); 2747 struct tcmu_dev *udev = TCMU_DEV(da->da_dev); 2748 u8 val; 2749 int ret; 2750 2751 ret = kstrtou8(page, 0, &val); 2752 if (ret < 0) 2753 return ret; 2754 2755 /* Check if device has been configured before */ 2756 if (target_dev_configured(&udev->se_dev)) { 2757 ret = tcmu_send_emulate_write_cache(udev, val); 2758 if (ret) { 2759 pr_err("Unable to reconfigure device\n"); 2760 return ret; 2761 } 2762 } 2763 2764 da->emulate_write_cache = val; 2765 return count; 2766 } 2767 CONFIGFS_ATTR(tcmu_, emulate_write_cache); 2768 2769 static ssize_t tcmu_tmr_notification_show(struct config_item *item, char *page) 2770 { 2771 struct se_dev_attrib *da = container_of(to_config_group(item), 2772 struct se_dev_attrib, da_group); 2773 struct tcmu_dev *udev = TCMU_DEV(da->da_dev); 2774 2775 return snprintf(page, PAGE_SIZE, "%i\n", 2776 test_bit(TCMU_DEV_BIT_TMR_NOTIFY, &udev->flags)); 2777 } 2778 2779 static ssize_t tcmu_tmr_notification_store(struct config_item *item, 2780 const char *page, size_t count) 2781 { 2782 struct se_dev_attrib *da = container_of(to_config_group(item), 2783 struct se_dev_attrib, da_group); 2784 struct tcmu_dev *udev = TCMU_DEV(da->da_dev); 2785 u8 val; 2786 int ret; 2787 2788 ret = kstrtou8(page, 0, &val); 2789 if (ret < 0) 2790 return ret; 2791 if (val > 1) 2792 return -EINVAL; 2793 2794 if (val) 2795 set_bit(TCMU_DEV_BIT_TMR_NOTIFY, &udev->flags); 2796 else 2797 clear_bit(TCMU_DEV_BIT_TMR_NOTIFY, &udev->flags); 2798 return count; 2799 } 2800 CONFIGFS_ATTR(tcmu_, tmr_notification); 2801 2802 static ssize_t tcmu_block_dev_show(struct config_item *item, char *page) 2803 { 2804 struct se_device *se_dev = container_of(to_config_group(item), 2805 struct se_device, 2806 dev_action_group); 2807 struct tcmu_dev *udev = TCMU_DEV(se_dev); 2808 2809 if (test_bit(TCMU_DEV_BIT_BLOCKED, &udev->flags)) 2810 return snprintf(page, PAGE_SIZE, "%s\n", "blocked"); 2811 else 2812 return snprintf(page, PAGE_SIZE, "%s\n", "unblocked"); 2813 } 2814 2815 static ssize_t tcmu_block_dev_store(struct config_item *item, const char *page, 2816 size_t count) 2817 { 2818 struct se_device *se_dev = container_of(to_config_group(item), 2819 struct se_device, 2820 dev_action_group); 2821 struct tcmu_dev *udev = TCMU_DEV(se_dev); 2822 u8 val; 2823 int ret; 2824 2825 if (!target_dev_configured(&udev->se_dev)) { 2826 pr_err("Device is not configured.\n"); 2827 return -EINVAL; 2828 } 2829 2830 ret = kstrtou8(page, 0, &val); 2831 if (ret < 0) 2832 return ret; 2833 2834 if (val > 1) { 2835 pr_err("Invalid block value %d\n", val); 2836 return -EINVAL; 2837 } 2838 2839 if (!val) 2840 tcmu_unblock_dev(udev); 2841 else 2842 tcmu_block_dev(udev); 2843 return count; 2844 } 2845 CONFIGFS_ATTR(tcmu_, block_dev); 2846 2847 static ssize_t tcmu_reset_ring_store(struct config_item *item, const char *page, 2848 size_t count) 2849 { 2850 struct se_device *se_dev = container_of(to_config_group(item), 2851 struct se_device, 2852 dev_action_group); 2853 struct tcmu_dev *udev = TCMU_DEV(se_dev); 2854 u8 val; 2855 int ret; 2856 2857 if (!target_dev_configured(&udev->se_dev)) { 2858 pr_err("Device is not configured.\n"); 2859 return -EINVAL; 2860 } 2861 2862 ret = kstrtou8(page, 0, &val); 2863 if (ret < 0) 2864 return ret; 2865 2866 if (val != 1 && val != 2) { 2867 pr_err("Invalid reset ring value %d\n", val); 2868 return -EINVAL; 2869 } 2870 2871 tcmu_reset_ring(udev, val); 2872 return count; 2873 } 2874 CONFIGFS_ATTR_WO(tcmu_, reset_ring); 2875 2876 static struct configfs_attribute *tcmu_attrib_attrs[] = { 2877 &tcmu_attr_cmd_time_out, 2878 &tcmu_attr_qfull_time_out, 2879 &tcmu_attr_max_data_area_mb, 2880 &tcmu_attr_dev_config, 2881 &tcmu_attr_dev_size, 2882 &tcmu_attr_emulate_write_cache, 2883 &tcmu_attr_tmr_notification, 2884 &tcmu_attr_nl_reply_supported, 2885 NULL, 2886 }; 2887 2888 static struct configfs_attribute **tcmu_attrs; 2889 2890 static struct configfs_attribute *tcmu_action_attrs[] = { 2891 &tcmu_attr_block_dev, 2892 &tcmu_attr_reset_ring, 2893 NULL, 2894 }; 2895 2896 static struct target_backend_ops tcmu_ops = { 2897 .name = "user", 2898 .owner = THIS_MODULE, 2899 .transport_flags_default = TRANSPORT_FLAG_PASSTHROUGH, 2900 .transport_flags_changeable = TRANSPORT_FLAG_PASSTHROUGH_PGR | 2901 TRANSPORT_FLAG_PASSTHROUGH_ALUA, 2902 .attach_hba = tcmu_attach_hba, 2903 .detach_hba = tcmu_detach_hba, 2904 .alloc_device = tcmu_alloc_device, 2905 .configure_device = tcmu_configure_device, 2906 .destroy_device = tcmu_destroy_device, 2907 .free_device = tcmu_free_device, 2908 .unplug_device = tcmu_unplug_device, 2909 .plug_device = tcmu_plug_device, 2910 .parse_cdb = tcmu_parse_cdb, 2911 .tmr_notify = tcmu_tmr_notify, 2912 .set_configfs_dev_params = tcmu_set_configfs_dev_params, 2913 .show_configfs_dev_params = tcmu_show_configfs_dev_params, 2914 .get_device_type = sbc_get_device_type, 2915 .get_blocks = tcmu_get_blocks, 2916 .tb_dev_action_attrs = tcmu_action_attrs, 2917 }; 2918 2919 static void find_free_blocks(void) 2920 { 2921 struct tcmu_dev *udev; 2922 loff_t off; 2923 u32 pages_freed, total_pages_freed = 0; 2924 u32 start, end, block, total_blocks_freed = 0; 2925 2926 if (atomic_read(&global_page_count) <= tcmu_global_max_pages) 2927 return; 2928 2929 mutex_lock(&root_udev_mutex); 2930 list_for_each_entry(udev, &root_udev, node) { 2931 mutex_lock(&udev->cmdr_lock); 2932 2933 if (!target_dev_configured(&udev->se_dev)) { 2934 mutex_unlock(&udev->cmdr_lock); 2935 continue; 2936 } 2937 2938 /* Try to complete the finished commands first */ 2939 if (tcmu_handle_completions(udev)) 2940 run_qfull_queue(udev, false); 2941 2942 /* Skip the udevs in idle */ 2943 if (!udev->dbi_thresh) { 2944 mutex_unlock(&udev->cmdr_lock); 2945 continue; 2946 } 2947 2948 end = udev->dbi_max + 1; 2949 block = find_last_bit(udev->data_bitmap, end); 2950 if (block == udev->dbi_max) { 2951 /* 2952 * The last bit is dbi_max, so it is not possible 2953 * reclaim any blocks. 2954 */ 2955 mutex_unlock(&udev->cmdr_lock); 2956 continue; 2957 } else if (block == end) { 2958 /* The current udev will goto idle state */ 2959 udev->dbi_thresh = start = 0; 2960 udev->dbi_max = 0; 2961 } else { 2962 udev->dbi_thresh = start = block + 1; 2963 udev->dbi_max = block; 2964 } 2965 2966 /* Here will truncate the data area from off */ 2967 off = udev->data_off + start * DATA_BLOCK_SIZE; 2968 unmap_mapping_range(udev->inode->i_mapping, off, 0, 1); 2969 2970 /* Release the block pages */ 2971 pages_freed = tcmu_blocks_release(&udev->data_pages, start, end - 1); 2972 mutex_unlock(&udev->cmdr_lock); 2973 2974 total_pages_freed += pages_freed; 2975 total_blocks_freed += end - start; 2976 pr_debug("Freed %u pages (total %u) from %u blocks (total %u) from %s.\n", 2977 pages_freed, total_pages_freed, end - start, 2978 total_blocks_freed, udev->name); 2979 } 2980 mutex_unlock(&root_udev_mutex); 2981 2982 if (atomic_read(&global_page_count) > tcmu_global_max_pages) 2983 schedule_delayed_work(&tcmu_unmap_work, msecs_to_jiffies(5000)); 2984 } 2985 2986 static void check_timedout_devices(void) 2987 { 2988 struct tcmu_dev *udev, *tmp_dev; 2989 struct tcmu_cmd *cmd, *tmp_cmd; 2990 LIST_HEAD(devs); 2991 2992 spin_lock_bh(&timed_out_udevs_lock); 2993 list_splice_init(&timed_out_udevs, &devs); 2994 2995 list_for_each_entry_safe(udev, tmp_dev, &devs, timedout_entry) { 2996 list_del_init(&udev->timedout_entry); 2997 spin_unlock_bh(&timed_out_udevs_lock); 2998 2999 mutex_lock(&udev->cmdr_lock); 3000 3001 /* 3002 * If cmd_time_out is disabled but qfull is set deadline 3003 * will only reflect the qfull timeout. Ignore it. 3004 */ 3005 if (udev->cmd_time_out) { 3006 list_for_each_entry_safe(cmd, tmp_cmd, 3007 &udev->inflight_queue, 3008 queue_entry) { 3009 tcmu_check_expired_ring_cmd(cmd); 3010 } 3011 tcmu_set_next_deadline(&udev->inflight_queue, 3012 &udev->cmd_timer); 3013 } 3014 list_for_each_entry_safe(cmd, tmp_cmd, &udev->qfull_queue, 3015 queue_entry) { 3016 tcmu_check_expired_queue_cmd(cmd); 3017 } 3018 tcmu_set_next_deadline(&udev->qfull_queue, &udev->qfull_timer); 3019 3020 mutex_unlock(&udev->cmdr_lock); 3021 3022 spin_lock_bh(&timed_out_udevs_lock); 3023 } 3024 3025 spin_unlock_bh(&timed_out_udevs_lock); 3026 } 3027 3028 static void tcmu_unmap_work_fn(struct work_struct *work) 3029 { 3030 check_timedout_devices(); 3031 find_free_blocks(); 3032 } 3033 3034 static int __init tcmu_module_init(void) 3035 { 3036 int ret, i, k, len = 0; 3037 3038 BUILD_BUG_ON((sizeof(struct tcmu_cmd_entry) % TCMU_OP_ALIGN_SIZE) != 0); 3039 3040 INIT_DELAYED_WORK(&tcmu_unmap_work, tcmu_unmap_work_fn); 3041 3042 tcmu_cmd_cache = kmem_cache_create("tcmu_cmd_cache", 3043 sizeof(struct tcmu_cmd), 3044 __alignof__(struct tcmu_cmd), 3045 0, NULL); 3046 if (!tcmu_cmd_cache) 3047 return -ENOMEM; 3048 3049 tcmu_root_device = root_device_register("tcm_user"); 3050 if (IS_ERR(tcmu_root_device)) { 3051 ret = PTR_ERR(tcmu_root_device); 3052 goto out_free_cache; 3053 } 3054 3055 ret = genl_register_family(&tcmu_genl_family); 3056 if (ret < 0) { 3057 goto out_unreg_device; 3058 } 3059 3060 for (i = 0; passthrough_attrib_attrs[i] != NULL; i++) 3061 len += sizeof(struct configfs_attribute *); 3062 for (i = 0; passthrough_pr_attrib_attrs[i] != NULL; i++) 3063 len += sizeof(struct configfs_attribute *); 3064 for (i = 0; tcmu_attrib_attrs[i] != NULL; i++) 3065 len += sizeof(struct configfs_attribute *); 3066 len += sizeof(struct configfs_attribute *); 3067 3068 tcmu_attrs = kzalloc(len, GFP_KERNEL); 3069 if (!tcmu_attrs) { 3070 ret = -ENOMEM; 3071 goto out_unreg_genl; 3072 } 3073 3074 for (i = 0; passthrough_attrib_attrs[i] != NULL; i++) 3075 tcmu_attrs[i] = passthrough_attrib_attrs[i]; 3076 for (k = 0; passthrough_pr_attrib_attrs[k] != NULL; k++) 3077 tcmu_attrs[i++] = passthrough_pr_attrib_attrs[k]; 3078 for (k = 0; tcmu_attrib_attrs[k] != NULL; k++) 3079 tcmu_attrs[i++] = tcmu_attrib_attrs[k]; 3080 tcmu_ops.tb_dev_attrib_attrs = tcmu_attrs; 3081 3082 ret = transport_backend_register(&tcmu_ops); 3083 if (ret) 3084 goto out_attrs; 3085 3086 return 0; 3087 3088 out_attrs: 3089 kfree(tcmu_attrs); 3090 out_unreg_genl: 3091 genl_unregister_family(&tcmu_genl_family); 3092 out_unreg_device: 3093 root_device_unregister(tcmu_root_device); 3094 out_free_cache: 3095 kmem_cache_destroy(tcmu_cmd_cache); 3096 3097 return ret; 3098 } 3099 3100 static void __exit tcmu_module_exit(void) 3101 { 3102 cancel_delayed_work_sync(&tcmu_unmap_work); 3103 target_backend_unregister(&tcmu_ops); 3104 kfree(tcmu_attrs); 3105 genl_unregister_family(&tcmu_genl_family); 3106 root_device_unregister(tcmu_root_device); 3107 kmem_cache_destroy(tcmu_cmd_cache); 3108 } 3109 3110 MODULE_DESCRIPTION("TCM USER subsystem plugin"); 3111 MODULE_AUTHOR("Shaohua Li <[email protected]>"); 3112 MODULE_AUTHOR("Andy Grover <[email protected]>"); 3113 MODULE_LICENSE("GPL"); 3114 3115 module_init(tcmu_module_init); 3116 module_exit(tcmu_module_exit); 3117