xref: /linux/drivers/dma/idxd/cdev.c (revision 1cf2704242180351d156fb48c334b319ae6b0759)
1 // SPDX-License-Identifier: GPL-2.0
2 /* Copyright(c) 2019 Intel Corporation. All rights rsvd. */
3 #include <linux/init.h>
4 #include <linux/kernel.h>
5 #include <linux/module.h>
6 #include <linux/pci.h>
7 #include <linux/device.h>
8 #include <linux/sched/task.h>
9 #include <linux/io-64-nonatomic-lo-hi.h>
10 #include <linux/cdev.h>
11 #include <linux/fs.h>
12 #include <linux/poll.h>
13 #include <linux/iommu.h>
14 #include <linux/highmem.h>
15 #include <uapi/linux/idxd.h>
16 #include <linux/xarray.h>
17 #include "registers.h"
18 #include "idxd.h"
19 
20 struct idxd_cdev_context {
21 	const char *name;
22 	dev_t devt;
23 	struct ida minor_ida;
24 };
25 
26 /*
27  * Since user file names are global in DSA devices, define their ida's as
28  * global to avoid conflict file names.
29  */
30 static DEFINE_IDA(file_ida);
31 static DEFINE_MUTEX(ida_lock);
32 
33 /*
34  * ictx is an array based off of accelerator types. enum idxd_type
35  * is used as index
36  */
37 static struct idxd_cdev_context ictx[IDXD_TYPE_MAX] = {
38 	{ .name = "dsa" },
39 	{ .name = "iax" }
40 };
41 
42 struct idxd_user_context {
43 	struct idxd_wq *wq;
44 	struct task_struct *task;
45 	unsigned int pasid;
46 	struct mm_struct *mm;
47 	unsigned int flags;
48 	struct iommu_sva *sva;
49 	struct idxd_dev idxd_dev;
50 	u64 counters[COUNTER_MAX];
51 	int id;
52 	pid_t pid;
53 };
54 
55 static void idxd_cdev_evl_drain_pasid(struct idxd_wq *wq, u32 pasid);
56 static void idxd_xa_pasid_remove(struct idxd_user_context *ctx);
57 
58 static inline struct idxd_user_context *dev_to_uctx(struct device *dev)
59 {
60 	struct idxd_dev *idxd_dev = confdev_to_idxd_dev(dev);
61 
62 	return container_of(idxd_dev, struct idxd_user_context, idxd_dev);
63 }
64 
65 static ssize_t cr_faults_show(struct device *dev, struct device_attribute *attr, char *buf)
66 {
67 	struct idxd_user_context *ctx = dev_to_uctx(dev);
68 
69 	return sysfs_emit(buf, "%llu\n", ctx->counters[COUNTER_FAULTS]);
70 }
71 static DEVICE_ATTR_RO(cr_faults);
72 
73 static ssize_t cr_fault_failures_show(struct device *dev,
74 				      struct device_attribute *attr, char *buf)
75 {
76 	struct idxd_user_context *ctx = dev_to_uctx(dev);
77 
78 	return sysfs_emit(buf, "%llu\n", ctx->counters[COUNTER_FAULT_FAILS]);
79 }
80 static DEVICE_ATTR_RO(cr_fault_failures);
81 
82 static ssize_t pid_show(struct device *dev, struct device_attribute *attr, char *buf)
83 {
84 	struct idxd_user_context *ctx = dev_to_uctx(dev);
85 
86 	return sysfs_emit(buf, "%u\n", ctx->pid);
87 }
88 static DEVICE_ATTR_RO(pid);
89 
90 static struct attribute *cdev_file_attributes[] = {
91 	&dev_attr_cr_faults.attr,
92 	&dev_attr_cr_fault_failures.attr,
93 	&dev_attr_pid.attr,
94 	NULL
95 };
96 
97 static umode_t cdev_file_attr_visible(struct kobject *kobj, struct attribute *a, int n)
98 {
99 	struct device *dev = container_of(kobj, typeof(*dev), kobj);
100 	struct idxd_user_context *ctx = dev_to_uctx(dev);
101 	struct idxd_wq *wq = ctx->wq;
102 
103 	if (!wq_pasid_enabled(wq))
104 		return 0;
105 
106 	return a->mode;
107 }
108 
109 static const struct attribute_group cdev_file_attribute_group = {
110 	.attrs = cdev_file_attributes,
111 	.is_visible = cdev_file_attr_visible,
112 };
113 
114 static const struct attribute_group *cdev_file_attribute_groups[] = {
115 	&cdev_file_attribute_group,
116 	NULL
117 };
118 
119 static void idxd_file_dev_release(struct device *dev)
120 {
121 	struct idxd_user_context *ctx = dev_to_uctx(dev);
122 	struct idxd_wq *wq = ctx->wq;
123 	struct idxd_device *idxd = wq->idxd;
124 	int rc;
125 
126 	mutex_lock(&ida_lock);
127 	ida_free(&file_ida, ctx->id);
128 	mutex_unlock(&ida_lock);
129 
130 	/* Wait for in-flight operations to complete. */
131 	if (wq_shared(wq)) {
132 		idxd_device_drain_pasid(idxd, ctx->pasid);
133 	} else {
134 		if (device_user_pasid_enabled(idxd)) {
135 			/* The wq disable in the disable pasid function will drain the wq */
136 			rc = idxd_wq_disable_pasid(wq);
137 			if (rc < 0)
138 				dev_err(dev, "wq disable pasid failed.\n");
139 		} else {
140 			idxd_wq_drain(wq);
141 		}
142 	}
143 
144 	if (ctx->sva) {
145 		idxd_cdev_evl_drain_pasid(wq, ctx->pasid);
146 		iommu_sva_unbind_device(ctx->sva);
147 		idxd_xa_pasid_remove(ctx);
148 	}
149 	kfree(ctx);
150 	mutex_lock(&wq->wq_lock);
151 	idxd_wq_put(wq);
152 	mutex_unlock(&wq->wq_lock);
153 }
154 
155 static const struct device_type idxd_cdev_file_type = {
156 	.name = "idxd_file",
157 	.release = idxd_file_dev_release,
158 	.groups = cdev_file_attribute_groups,
159 };
160 
161 static void idxd_cdev_dev_release(struct device *dev)
162 {
163 	struct idxd_cdev *idxd_cdev = dev_to_cdev(dev);
164 	struct idxd_cdev_context *cdev_ctx;
165 	struct idxd_wq *wq = idxd_cdev->wq;
166 
167 	cdev_ctx = &ictx[wq->idxd->data->type];
168 	ida_free(&cdev_ctx->minor_ida, idxd_cdev->minor);
169 	kfree(idxd_cdev);
170 }
171 
172 static const struct device_type idxd_cdev_device_type = {
173 	.name = "idxd_cdev",
174 	.release = idxd_cdev_dev_release,
175 };
176 
177 static inline struct idxd_cdev *inode_idxd_cdev(struct inode *inode)
178 {
179 	struct cdev *cdev = inode->i_cdev;
180 
181 	return container_of(cdev, struct idxd_cdev, cdev);
182 }
183 
184 static inline struct idxd_wq *inode_wq(struct inode *inode)
185 {
186 	struct idxd_cdev *idxd_cdev = inode_idxd_cdev(inode);
187 
188 	return idxd_cdev->wq;
189 }
190 
191 static void idxd_xa_pasid_remove(struct idxd_user_context *ctx)
192 {
193 	struct idxd_wq *wq = ctx->wq;
194 	void *ptr;
195 
196 	mutex_lock(&wq->uc_lock);
197 	ptr = xa_cmpxchg(&wq->upasid_xa, ctx->pasid, ctx, NULL, GFP_KERNEL);
198 	if (ptr != (void *)ctx)
199 		dev_warn(&wq->idxd->pdev->dev, "xarray cmpxchg failed for pasid %u\n",
200 			 ctx->pasid);
201 	mutex_unlock(&wq->uc_lock);
202 }
203 
204 void idxd_user_counter_increment(struct idxd_wq *wq, u32 pasid, int index)
205 {
206 	struct idxd_user_context *ctx;
207 
208 	if (index >= COUNTER_MAX)
209 		return;
210 
211 	mutex_lock(&wq->uc_lock);
212 	ctx = xa_load(&wq->upasid_xa, pasid);
213 	if (!ctx) {
214 		mutex_unlock(&wq->uc_lock);
215 		return;
216 	}
217 	ctx->counters[index]++;
218 	mutex_unlock(&wq->uc_lock);
219 }
220 
221 static int idxd_cdev_open(struct inode *inode, struct file *filp)
222 {
223 	struct idxd_user_context *ctx;
224 	struct idxd_device *idxd;
225 	struct idxd_wq *wq;
226 	struct device *dev, *fdev;
227 	int rc = 0;
228 	struct iommu_sva *sva;
229 	unsigned int pasid;
230 	struct idxd_cdev *idxd_cdev;
231 
232 	wq = inode_wq(inode);
233 	idxd = wq->idxd;
234 	dev = &idxd->pdev->dev;
235 
236 	dev_dbg(dev, "%s called: %d\n", __func__, idxd_wq_refcount(wq));
237 
238 	ctx = kzalloc(sizeof(*ctx), GFP_KERNEL);
239 	if (!ctx)
240 		return -ENOMEM;
241 
242 	mutex_lock(&wq->wq_lock);
243 
244 	if (idxd_wq_refcount(wq) > 0 && wq_dedicated(wq)) {
245 		rc = -EBUSY;
246 		goto failed;
247 	}
248 
249 	ctx->wq = wq;
250 	filp->private_data = ctx;
251 	ctx->pid = current->pid;
252 
253 	if (device_user_pasid_enabled(idxd)) {
254 		sva = iommu_sva_bind_device(dev, current->mm);
255 		if (IS_ERR(sva)) {
256 			rc = PTR_ERR(sva);
257 			dev_err(dev, "pasid allocation failed: %d\n", rc);
258 			goto failed;
259 		}
260 
261 		pasid = iommu_sva_get_pasid(sva);
262 		if (pasid == IOMMU_PASID_INVALID) {
263 			rc = -EINVAL;
264 			goto failed_get_pasid;
265 		}
266 
267 		ctx->sva = sva;
268 		ctx->pasid = pasid;
269 		ctx->mm = current->mm;
270 
271 		mutex_lock(&wq->uc_lock);
272 		rc = xa_insert(&wq->upasid_xa, pasid, ctx, GFP_KERNEL);
273 		mutex_unlock(&wq->uc_lock);
274 		if (rc < 0)
275 			dev_warn(dev, "PASID entry already exist in xarray.\n");
276 
277 		if (wq_dedicated(wq)) {
278 			rc = idxd_wq_set_pasid(wq, pasid);
279 			if (rc < 0) {
280 				dev_err(dev, "wq set pasid failed: %d\n", rc);
281 				goto failed_set_pasid;
282 			}
283 		}
284 	}
285 
286 	idxd_cdev = wq->idxd_cdev;
287 	mutex_lock(&ida_lock);
288 	ctx->id = ida_alloc(&file_ida, GFP_KERNEL);
289 	mutex_unlock(&ida_lock);
290 	if (ctx->id < 0) {
291 		dev_warn(dev, "ida alloc failure\n");
292 		goto failed_ida;
293 	}
294 	ctx->idxd_dev.type  = IDXD_DEV_CDEV_FILE;
295 	fdev = user_ctx_dev(ctx);
296 	device_initialize(fdev);
297 	fdev->parent = cdev_dev(idxd_cdev);
298 	fdev->bus = &dsa_bus_type;
299 	fdev->type = &idxd_cdev_file_type;
300 
301 	rc = dev_set_name(fdev, "file%d", ctx->id);
302 	if (rc < 0) {
303 		dev_warn(dev, "set name failure\n");
304 		goto failed_dev_name;
305 	}
306 
307 	rc = device_add(fdev);
308 	if (rc < 0) {
309 		dev_warn(dev, "file device add failure\n");
310 		goto failed_dev_add;
311 	}
312 
313 	idxd_wq_get(wq);
314 	mutex_unlock(&wq->wq_lock);
315 	return 0;
316 
317 failed_dev_add:
318 failed_dev_name:
319 	put_device(fdev);
320 failed_ida:
321 failed_set_pasid:
322 	if (device_user_pasid_enabled(idxd))
323 		idxd_xa_pasid_remove(ctx);
324 failed_get_pasid:
325 	if (device_user_pasid_enabled(idxd))
326 		iommu_sva_unbind_device(sva);
327 failed:
328 	mutex_unlock(&wq->wq_lock);
329 	kfree(ctx);
330 	return rc;
331 }
332 
333 static void idxd_cdev_evl_drain_pasid(struct idxd_wq *wq, u32 pasid)
334 {
335 	struct idxd_device *idxd = wq->idxd;
336 	struct idxd_evl *evl = idxd->evl;
337 	union evl_status_reg status;
338 	u16 h, t, size;
339 	int ent_size = evl_ent_size(idxd);
340 	struct __evl_entry *entry_head;
341 
342 	if (!evl)
343 		return;
344 
345 	mutex_lock(&evl->lock);
346 	status.bits = ioread64(idxd->reg_base + IDXD_EVLSTATUS_OFFSET);
347 	t = status.tail;
348 	h = status.head;
349 	size = evl->size;
350 
351 	while (h != t) {
352 		entry_head = (struct __evl_entry *)(evl->log + (h * ent_size));
353 		if (entry_head->pasid == pasid && entry_head->wq_idx == wq->id)
354 			set_bit(h, evl->bmap);
355 		h = (h + 1) % size;
356 	}
357 	drain_workqueue(wq->wq);
358 	mutex_unlock(&evl->lock);
359 }
360 
361 static int idxd_cdev_release(struct inode *node, struct file *filep)
362 {
363 	struct idxd_user_context *ctx = filep->private_data;
364 	struct idxd_wq *wq = ctx->wq;
365 	struct idxd_device *idxd = wq->idxd;
366 	struct device *dev = &idxd->pdev->dev;
367 
368 	dev_dbg(dev, "%s called\n", __func__);
369 	filep->private_data = NULL;
370 
371 	device_unregister(user_ctx_dev(ctx));
372 
373 	return 0;
374 }
375 
376 static int check_vma(struct idxd_wq *wq, struct vm_area_struct *vma,
377 		     const char *func)
378 {
379 	struct device *dev = &wq->idxd->pdev->dev;
380 
381 	if ((vma->vm_end - vma->vm_start) > PAGE_SIZE) {
382 		dev_info_ratelimited(dev,
383 				     "%s: %s: mapping too large: %lu\n",
384 				     current->comm, func,
385 				     vma->vm_end - vma->vm_start);
386 		return -EINVAL;
387 	}
388 
389 	return 0;
390 }
391 
392 static int idxd_cdev_mmap(struct file *filp, struct vm_area_struct *vma)
393 {
394 	struct idxd_user_context *ctx = filp->private_data;
395 	struct idxd_wq *wq = ctx->wq;
396 	struct idxd_device *idxd = wq->idxd;
397 	struct pci_dev *pdev = idxd->pdev;
398 	phys_addr_t base = pci_resource_start(pdev, IDXD_WQ_BAR);
399 	unsigned long pfn;
400 	int rc;
401 
402 	dev_dbg(&pdev->dev, "%s called\n", __func__);
403 	rc = check_vma(wq, vma, __func__);
404 	if (rc < 0)
405 		return rc;
406 
407 	vm_flags_set(vma, VM_DONTCOPY);
408 	pfn = (base + idxd_get_wq_portal_full_offset(wq->id,
409 				IDXD_PORTAL_LIMITED)) >> PAGE_SHIFT;
410 	vma->vm_page_prot = pgprot_noncached(vma->vm_page_prot);
411 	vma->vm_private_data = ctx;
412 
413 	return io_remap_pfn_range(vma, vma->vm_start, pfn, PAGE_SIZE,
414 			vma->vm_page_prot);
415 }
416 
417 static __poll_t idxd_cdev_poll(struct file *filp,
418 			       struct poll_table_struct *wait)
419 {
420 	struct idxd_user_context *ctx = filp->private_data;
421 	struct idxd_wq *wq = ctx->wq;
422 	struct idxd_device *idxd = wq->idxd;
423 	__poll_t out = 0;
424 
425 	poll_wait(filp, &wq->err_queue, wait);
426 	spin_lock(&idxd->dev_lock);
427 	if (idxd->sw_err.valid)
428 		out = EPOLLIN | EPOLLRDNORM;
429 	spin_unlock(&idxd->dev_lock);
430 
431 	return out;
432 }
433 
434 static const struct file_operations idxd_cdev_fops = {
435 	.owner = THIS_MODULE,
436 	.open = idxd_cdev_open,
437 	.release = idxd_cdev_release,
438 	.mmap = idxd_cdev_mmap,
439 	.poll = idxd_cdev_poll,
440 };
441 
442 int idxd_cdev_get_major(struct idxd_device *idxd)
443 {
444 	return MAJOR(ictx[idxd->data->type].devt);
445 }
446 
447 int idxd_wq_add_cdev(struct idxd_wq *wq)
448 {
449 	struct idxd_device *idxd = wq->idxd;
450 	struct idxd_cdev *idxd_cdev;
451 	struct cdev *cdev;
452 	struct device *dev;
453 	struct idxd_cdev_context *cdev_ctx;
454 	int rc, minor;
455 
456 	idxd_cdev = kzalloc(sizeof(*idxd_cdev), GFP_KERNEL);
457 	if (!idxd_cdev)
458 		return -ENOMEM;
459 
460 	idxd_cdev->idxd_dev.type = IDXD_DEV_CDEV;
461 	idxd_cdev->wq = wq;
462 	cdev = &idxd_cdev->cdev;
463 	dev = cdev_dev(idxd_cdev);
464 	cdev_ctx = &ictx[wq->idxd->data->type];
465 	minor = ida_alloc_max(&cdev_ctx->minor_ida, MINORMASK, GFP_KERNEL);
466 	if (minor < 0) {
467 		kfree(idxd_cdev);
468 		return minor;
469 	}
470 	idxd_cdev->minor = minor;
471 
472 	device_initialize(dev);
473 	dev->parent = wq_confdev(wq);
474 	dev->bus = &dsa_bus_type;
475 	dev->type = &idxd_cdev_device_type;
476 	dev->devt = MKDEV(MAJOR(cdev_ctx->devt), minor);
477 
478 	rc = dev_set_name(dev, "%s/wq%u.%u", idxd->data->name_prefix, idxd->id, wq->id);
479 	if (rc < 0)
480 		goto err;
481 
482 	wq->idxd_cdev = idxd_cdev;
483 	cdev_init(cdev, &idxd_cdev_fops);
484 	rc = cdev_device_add(cdev, dev);
485 	if (rc) {
486 		dev_dbg(&wq->idxd->pdev->dev, "cdev_add failed: %d\n", rc);
487 		goto err;
488 	}
489 
490 	return 0;
491 
492  err:
493 	put_device(dev);
494 	wq->idxd_cdev = NULL;
495 	return rc;
496 }
497 
498 void idxd_wq_del_cdev(struct idxd_wq *wq)
499 {
500 	struct idxd_cdev *idxd_cdev;
501 
502 	idxd_cdev = wq->idxd_cdev;
503 	ida_destroy(&file_ida);
504 	wq->idxd_cdev = NULL;
505 	cdev_device_del(&idxd_cdev->cdev, cdev_dev(idxd_cdev));
506 	put_device(cdev_dev(idxd_cdev));
507 }
508 
509 static int idxd_user_drv_probe(struct idxd_dev *idxd_dev)
510 {
511 	struct device *dev = &idxd_dev->conf_dev;
512 	struct idxd_wq *wq = idxd_dev_to_wq(idxd_dev);
513 	struct idxd_device *idxd = wq->idxd;
514 	int rc;
515 
516 	if (idxd->state != IDXD_DEV_ENABLED)
517 		return -ENXIO;
518 
519 	/*
520 	 * User type WQ is enabled only when SVA is enabled for two reasons:
521 	 *   - If no IOMMU or IOMMU Passthrough without SVA, userspace
522 	 *     can directly access physical address through the WQ.
523 	 *   - The IDXD cdev driver does not provide any ways to pin
524 	 *     user pages and translate the address from user VA to IOVA or
525 	 *     PA without IOMMU SVA. Therefore the application has no way
526 	 *     to instruct the device to perform DMA function. This makes
527 	 *     the cdev not usable for normal application usage.
528 	 */
529 	if (!device_user_pasid_enabled(idxd)) {
530 		idxd->cmd_status = IDXD_SCMD_WQ_USER_NO_IOMMU;
531 		dev_dbg(&idxd->pdev->dev,
532 			"User type WQ cannot be enabled without SVA.\n");
533 
534 		return -EOPNOTSUPP;
535 	}
536 
537 	mutex_lock(&wq->wq_lock);
538 
539 	if (!idxd_wq_driver_name_match(wq, dev)) {
540 		idxd->cmd_status = IDXD_SCMD_WQ_NO_DRV_NAME;
541 		rc = -ENODEV;
542 		goto wq_err;
543 	}
544 
545 	wq->wq = create_workqueue(dev_name(wq_confdev(wq)));
546 	if (!wq->wq) {
547 		rc = -ENOMEM;
548 		goto wq_err;
549 	}
550 
551 	wq->type = IDXD_WQT_USER;
552 	rc = idxd_drv_enable_wq(wq);
553 	if (rc < 0)
554 		goto err;
555 
556 	rc = idxd_wq_add_cdev(wq);
557 	if (rc < 0) {
558 		idxd->cmd_status = IDXD_SCMD_CDEV_ERR;
559 		goto err_cdev;
560 	}
561 
562 	idxd->cmd_status = 0;
563 	mutex_unlock(&wq->wq_lock);
564 	return 0;
565 
566 err_cdev:
567 	idxd_drv_disable_wq(wq);
568 err:
569 	destroy_workqueue(wq->wq);
570 	wq->type = IDXD_WQT_NONE;
571 wq_err:
572 	mutex_unlock(&wq->wq_lock);
573 	return rc;
574 }
575 
576 static void idxd_user_drv_remove(struct idxd_dev *idxd_dev)
577 {
578 	struct idxd_wq *wq = idxd_dev_to_wq(idxd_dev);
579 
580 	mutex_lock(&wq->wq_lock);
581 	idxd_wq_del_cdev(wq);
582 	idxd_drv_disable_wq(wq);
583 	wq->type = IDXD_WQT_NONE;
584 	destroy_workqueue(wq->wq);
585 	wq->wq = NULL;
586 	mutex_unlock(&wq->wq_lock);
587 }
588 
589 static enum idxd_dev_type dev_types[] = {
590 	IDXD_DEV_WQ,
591 	IDXD_DEV_NONE,
592 };
593 
594 struct idxd_device_driver idxd_user_drv = {
595 	.probe = idxd_user_drv_probe,
596 	.remove = idxd_user_drv_remove,
597 	.name = "user",
598 	.type = dev_types,
599 };
600 EXPORT_SYMBOL_GPL(idxd_user_drv);
601 
602 int idxd_cdev_register(void)
603 {
604 	int rc, i;
605 
606 	for (i = 0; i < IDXD_TYPE_MAX; i++) {
607 		ida_init(&ictx[i].minor_ida);
608 		rc = alloc_chrdev_region(&ictx[i].devt, 0, MINORMASK,
609 					 ictx[i].name);
610 		if (rc)
611 			goto err_free_chrdev_region;
612 	}
613 
614 	return 0;
615 
616 err_free_chrdev_region:
617 	for (i--; i >= 0; i--)
618 		unregister_chrdev_region(ictx[i].devt, MINORMASK);
619 
620 	return rc;
621 }
622 
623 void idxd_cdev_remove(void)
624 {
625 	int i;
626 
627 	for (i = 0; i < IDXD_TYPE_MAX; i++) {
628 		unregister_chrdev_region(ictx[i].devt, MINORMASK);
629 		ida_destroy(&ictx[i].minor_ida);
630 	}
631 }
632 
633 /**
634  * idxd_copy_cr - copy completion record to user address space found by wq and
635  *		  PASID
636  * @wq:		work queue
637  * @pasid:	PASID
638  * @addr:	user fault address to write
639  * @cr:		completion record
640  * @len:	number of bytes to copy
641  *
642  * This is called by a work that handles completion record fault.
643  *
644  * Return: number of bytes copied.
645  */
646 int idxd_copy_cr(struct idxd_wq *wq, ioasid_t pasid, unsigned long addr,
647 		 void *cr, int len)
648 {
649 	struct device *dev = &wq->idxd->pdev->dev;
650 	int left = len, status_size = 1;
651 	struct idxd_user_context *ctx;
652 	struct mm_struct *mm;
653 
654 	mutex_lock(&wq->uc_lock);
655 
656 	ctx = xa_load(&wq->upasid_xa, pasid);
657 	if (!ctx) {
658 		dev_warn(dev, "No user context\n");
659 		goto out;
660 	}
661 
662 	mm = ctx->mm;
663 	/*
664 	 * The completion record fault handling work is running in kernel
665 	 * thread context. It temporarily switches to the mm to copy cr
666 	 * to addr in the mm.
667 	 */
668 	kthread_use_mm(mm);
669 	left = copy_to_user((void __user *)addr + status_size, cr + status_size,
670 			    len - status_size);
671 	/*
672 	 * Copy status only after the rest of completion record is copied
673 	 * successfully so that the user gets the complete completion record
674 	 * when a non-zero status is polled.
675 	 */
676 	if (!left) {
677 		u8 status;
678 
679 		/*
680 		 * Ensure that the completion record's status field is written
681 		 * after the rest of the completion record has been written.
682 		 * This ensures that the user receives the correct completion
683 		 * record information once polling for a non-zero status.
684 		 */
685 		wmb();
686 		status = *(u8 *)cr;
687 		if (put_user(status, (u8 __user *)addr))
688 			left += status_size;
689 	} else {
690 		left += status_size;
691 	}
692 	kthread_unuse_mm(mm);
693 
694 out:
695 	mutex_unlock(&wq->uc_lock);
696 
697 	return len - left;
698 }
699