Merge tag 'for-linus' of git://git.kernel.org/pub/scm/virt/kvm/kvm
[linux-2.6-microblaze.git] / drivers / dma-buf / dma-buf.c
1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3  * Framework for buffer objects that can be shared across devices/subsystems.
4  *
5  * Copyright(C) 2011 Linaro Limited. All rights reserved.
6  * Author: Sumit Semwal <sumit.semwal@ti.com>
7  *
8  * Many thanks to linaro-mm-sig list, and specially
9  * Arnd Bergmann <arnd@arndb.de>, Rob Clark <rob@ti.com> and
10  * Daniel Vetter <daniel@ffwll.ch> for their support in creation and
11  * refining of this idea.
12  */
13
14 #include <linux/fs.h>
15 #include <linux/slab.h>
16 #include <linux/dma-buf.h>
17 #include <linux/dma-fence.h>
18 #include <linux/anon_inodes.h>
19 #include <linux/export.h>
20 #include <linux/debugfs.h>
21 #include <linux/module.h>
22 #include <linux/seq_file.h>
23 #include <linux/poll.h>
24 #include <linux/dma-resv.h>
25 #include <linux/mm.h>
26 #include <linux/mount.h>
27 #include <linux/pseudo_fs.h>
28
29 #include <uapi/linux/dma-buf.h>
30 #include <uapi/linux/magic.h>
31
32 static inline int is_dma_buf_file(struct file *);
33
34 struct dma_buf_list {
35         struct list_head head;
36         struct mutex lock;
37 };
38
39 static struct dma_buf_list db_list;
40
41 static char *dmabuffs_dname(struct dentry *dentry, char *buffer, int buflen)
42 {
43         struct dma_buf *dmabuf;
44         char name[DMA_BUF_NAME_LEN];
45         size_t ret = 0;
46
47         dmabuf = dentry->d_fsdata;
48         spin_lock(&dmabuf->name_lock);
49         if (dmabuf->name)
50                 ret = strlcpy(name, dmabuf->name, DMA_BUF_NAME_LEN);
51         spin_unlock(&dmabuf->name_lock);
52
53         return dynamic_dname(dentry, buffer, buflen, "/%s:%s",
54                              dentry->d_name.name, ret > 0 ? name : "");
55 }
56
57 static void dma_buf_release(struct dentry *dentry)
58 {
59         struct dma_buf *dmabuf;
60
61         dmabuf = dentry->d_fsdata;
62         if (unlikely(!dmabuf))
63                 return;
64
65         BUG_ON(dmabuf->vmapping_counter);
66
67         /*
68          * Any fences that a dma-buf poll can wait on should be signaled
69          * before releasing dma-buf. This is the responsibility of each
70          * driver that uses the reservation objects.
71          *
72          * If you hit this BUG() it means someone dropped their ref to the
73          * dma-buf while still having pending operation to the buffer.
74          */
75         BUG_ON(dmabuf->cb_shared.active || dmabuf->cb_excl.active);
76
77         dmabuf->ops->release(dmabuf);
78
79         if (dmabuf->resv == (struct dma_resv *)&dmabuf[1])
80                 dma_resv_fini(dmabuf->resv);
81
82         module_put(dmabuf->owner);
83         kfree(dmabuf->name);
84         kfree(dmabuf);
85 }
86
87 static int dma_buf_file_release(struct inode *inode, struct file *file)
88 {
89         struct dma_buf *dmabuf;
90
91         if (!is_dma_buf_file(file))
92                 return -EINVAL;
93
94         dmabuf = file->private_data;
95
96         mutex_lock(&db_list.lock);
97         list_del(&dmabuf->list_node);
98         mutex_unlock(&db_list.lock);
99
100         return 0;
101 }
102
103 static const struct dentry_operations dma_buf_dentry_ops = {
104         .d_dname = dmabuffs_dname,
105         .d_release = dma_buf_release,
106 };
107
108 static struct vfsmount *dma_buf_mnt;
109
110 static int dma_buf_fs_init_context(struct fs_context *fc)
111 {
112         struct pseudo_fs_context *ctx;
113
114         ctx = init_pseudo(fc, DMA_BUF_MAGIC);
115         if (!ctx)
116                 return -ENOMEM;
117         ctx->dops = &dma_buf_dentry_ops;
118         return 0;
119 }
120
121 static struct file_system_type dma_buf_fs_type = {
122         .name = "dmabuf",
123         .init_fs_context = dma_buf_fs_init_context,
124         .kill_sb = kill_anon_super,
125 };
126
127 static int dma_buf_mmap_internal(struct file *file, struct vm_area_struct *vma)
128 {
129         struct dma_buf *dmabuf;
130
131         if (!is_dma_buf_file(file))
132                 return -EINVAL;
133
134         dmabuf = file->private_data;
135
136         /* check if buffer supports mmap */
137         if (!dmabuf->ops->mmap)
138                 return -EINVAL;
139
140         /* check for overflowing the buffer's size */
141         if (vma->vm_pgoff + vma_pages(vma) >
142             dmabuf->size >> PAGE_SHIFT)
143                 return -EINVAL;
144
145         return dmabuf->ops->mmap(dmabuf, vma);
146 }
147
148 static loff_t dma_buf_llseek(struct file *file, loff_t offset, int whence)
149 {
150         struct dma_buf *dmabuf;
151         loff_t base;
152
153         if (!is_dma_buf_file(file))
154                 return -EBADF;
155
156         dmabuf = file->private_data;
157
158         /* only support discovering the end of the buffer,
159            but also allow SEEK_SET to maintain the idiomatic
160            SEEK_END(0), SEEK_CUR(0) pattern */
161         if (whence == SEEK_END)
162                 base = dmabuf->size;
163         else if (whence == SEEK_SET)
164                 base = 0;
165         else
166                 return -EINVAL;
167
168         if (offset != 0)
169                 return -EINVAL;
170
171         return base + offset;
172 }
173
174 /**
175  * DOC: implicit fence polling
176  *
177  * To support cross-device and cross-driver synchronization of buffer access
178  * implicit fences (represented internally in the kernel with &struct dma_fence)
179  * can be attached to a &dma_buf. The glue for that and a few related things are
180  * provided in the &dma_resv structure.
181  *
182  * Userspace can query the state of these implicitly tracked fences using poll()
183  * and related system calls:
184  *
185  * - Checking for EPOLLIN, i.e. read access, can be use to query the state of the
186  *   most recent write or exclusive fence.
187  *
188  * - Checking for EPOLLOUT, i.e. write access, can be used to query the state of
189  *   all attached fences, shared and exclusive ones.
190  *
191  * Note that this only signals the completion of the respective fences, i.e. the
192  * DMA transfers are complete. Cache flushing and any other necessary
193  * preparations before CPU access can begin still need to happen.
194  */
195
196 static void dma_buf_poll_cb(struct dma_fence *fence, struct dma_fence_cb *cb)
197 {
198         struct dma_buf_poll_cb_t *dcb = (struct dma_buf_poll_cb_t *)cb;
199         unsigned long flags;
200
201         spin_lock_irqsave(&dcb->poll->lock, flags);
202         wake_up_locked_poll(dcb->poll, dcb->active);
203         dcb->active = 0;
204         spin_unlock_irqrestore(&dcb->poll->lock, flags);
205 }
206
207 static __poll_t dma_buf_poll(struct file *file, poll_table *poll)
208 {
209         struct dma_buf *dmabuf;
210         struct dma_resv *resv;
211         struct dma_resv_list *fobj;
212         struct dma_fence *fence_excl;
213         __poll_t events;
214         unsigned shared_count, seq;
215
216         dmabuf = file->private_data;
217         if (!dmabuf || !dmabuf->resv)
218                 return EPOLLERR;
219
220         resv = dmabuf->resv;
221
222         poll_wait(file, &dmabuf->poll, poll);
223
224         events = poll_requested_events(poll) & (EPOLLIN | EPOLLOUT);
225         if (!events)
226                 return 0;
227
228 retry:
229         seq = read_seqcount_begin(&resv->seq);
230         rcu_read_lock();
231
232         fobj = rcu_dereference(resv->fence);
233         if (fobj)
234                 shared_count = fobj->shared_count;
235         else
236                 shared_count = 0;
237         fence_excl = rcu_dereference(resv->fence_excl);
238         if (read_seqcount_retry(&resv->seq, seq)) {
239                 rcu_read_unlock();
240                 goto retry;
241         }
242
243         if (fence_excl && (!(events & EPOLLOUT) || shared_count == 0)) {
244                 struct dma_buf_poll_cb_t *dcb = &dmabuf->cb_excl;
245                 __poll_t pevents = EPOLLIN;
246
247                 if (shared_count == 0)
248                         pevents |= EPOLLOUT;
249
250                 spin_lock_irq(&dmabuf->poll.lock);
251                 if (dcb->active) {
252                         dcb->active |= pevents;
253                         events &= ~pevents;
254                 } else
255                         dcb->active = pevents;
256                 spin_unlock_irq(&dmabuf->poll.lock);
257
258                 if (events & pevents) {
259                         if (!dma_fence_get_rcu(fence_excl)) {
260                                 /* force a recheck */
261                                 events &= ~pevents;
262                                 dma_buf_poll_cb(NULL, &dcb->cb);
263                         } else if (!dma_fence_add_callback(fence_excl, &dcb->cb,
264                                                            dma_buf_poll_cb)) {
265                                 events &= ~pevents;
266                                 dma_fence_put(fence_excl);
267                         } else {
268                                 /*
269                                  * No callback queued, wake up any additional
270                                  * waiters.
271                                  */
272                                 dma_fence_put(fence_excl);
273                                 dma_buf_poll_cb(NULL, &dcb->cb);
274                         }
275                 }
276         }
277
278         if ((events & EPOLLOUT) && shared_count > 0) {
279                 struct dma_buf_poll_cb_t *dcb = &dmabuf->cb_shared;
280                 int i;
281
282                 /* Only queue a new callback if no event has fired yet */
283                 spin_lock_irq(&dmabuf->poll.lock);
284                 if (dcb->active)
285                         events &= ~EPOLLOUT;
286                 else
287                         dcb->active = EPOLLOUT;
288                 spin_unlock_irq(&dmabuf->poll.lock);
289
290                 if (!(events & EPOLLOUT))
291                         goto out;
292
293                 for (i = 0; i < shared_count; ++i) {
294                         struct dma_fence *fence = rcu_dereference(fobj->shared[i]);
295
296                         if (!dma_fence_get_rcu(fence)) {
297                                 /*
298                                  * fence refcount dropped to zero, this means
299                                  * that fobj has been freed
300                                  *
301                                  * call dma_buf_poll_cb and force a recheck!
302                                  */
303                                 events &= ~EPOLLOUT;
304                                 dma_buf_poll_cb(NULL, &dcb->cb);
305                                 break;
306                         }
307                         if (!dma_fence_add_callback(fence, &dcb->cb,
308                                                     dma_buf_poll_cb)) {
309                                 dma_fence_put(fence);
310                                 events &= ~EPOLLOUT;
311                                 break;
312                         }
313                         dma_fence_put(fence);
314                 }
315
316                 /* No callback queued, wake up any additional waiters. */
317                 if (i == shared_count)
318                         dma_buf_poll_cb(NULL, &dcb->cb);
319         }
320
321 out:
322         rcu_read_unlock();
323         return events;
324 }
325
326 /**
327  * dma_buf_set_name - Set a name to a specific dma_buf to track the usage.
328  * The name of the dma-buf buffer can only be set when the dma-buf is not
329  * attached to any devices. It could theoritically support changing the
330  * name of the dma-buf if the same piece of memory is used for multiple
331  * purpose between different devices.
332  *
333  * @dmabuf: [in]     dmabuf buffer that will be renamed.
334  * @buf:    [in]     A piece of userspace memory that contains the name of
335  *                   the dma-buf.
336  *
337  * Returns 0 on success. If the dma-buf buffer is already attached to
338  * devices, return -EBUSY.
339  *
340  */
341 static long dma_buf_set_name(struct dma_buf *dmabuf, const char __user *buf)
342 {
343         char *name = strndup_user(buf, DMA_BUF_NAME_LEN);
344         long ret = 0;
345
346         if (IS_ERR(name))
347                 return PTR_ERR(name);
348
349         dma_resv_lock(dmabuf->resv, NULL);
350         if (!list_empty(&dmabuf->attachments)) {
351                 ret = -EBUSY;
352                 kfree(name);
353                 goto out_unlock;
354         }
355         spin_lock(&dmabuf->name_lock);
356         kfree(dmabuf->name);
357         dmabuf->name = name;
358         spin_unlock(&dmabuf->name_lock);
359
360 out_unlock:
361         dma_resv_unlock(dmabuf->resv);
362         return ret;
363 }
364
365 static long dma_buf_ioctl(struct file *file,
366                           unsigned int cmd, unsigned long arg)
367 {
368         struct dma_buf *dmabuf;
369         struct dma_buf_sync sync;
370         enum dma_data_direction direction;
371         int ret;
372
373         dmabuf = file->private_data;
374
375         switch (cmd) {
376         case DMA_BUF_IOCTL_SYNC:
377                 if (copy_from_user(&sync, (void __user *) arg, sizeof(sync)))
378                         return -EFAULT;
379
380                 if (sync.flags & ~DMA_BUF_SYNC_VALID_FLAGS_MASK)
381                         return -EINVAL;
382
383                 switch (sync.flags & DMA_BUF_SYNC_RW) {
384                 case DMA_BUF_SYNC_READ:
385                         direction = DMA_FROM_DEVICE;
386                         break;
387                 case DMA_BUF_SYNC_WRITE:
388                         direction = DMA_TO_DEVICE;
389                         break;
390                 case DMA_BUF_SYNC_RW:
391                         direction = DMA_BIDIRECTIONAL;
392                         break;
393                 default:
394                         return -EINVAL;
395                 }
396
397                 if (sync.flags & DMA_BUF_SYNC_END)
398                         ret = dma_buf_end_cpu_access(dmabuf, direction);
399                 else
400                         ret = dma_buf_begin_cpu_access(dmabuf, direction);
401
402                 return ret;
403
404         case DMA_BUF_SET_NAME_A:
405         case DMA_BUF_SET_NAME_B:
406                 return dma_buf_set_name(dmabuf, (const char __user *)arg);
407
408         default:
409                 return -ENOTTY;
410         }
411 }
412
413 static void dma_buf_show_fdinfo(struct seq_file *m, struct file *file)
414 {
415         struct dma_buf *dmabuf = file->private_data;
416
417         seq_printf(m, "size:\t%zu\n", dmabuf->size);
418         /* Don't count the temporary reference taken inside procfs seq_show */
419         seq_printf(m, "count:\t%ld\n", file_count(dmabuf->file) - 1);
420         seq_printf(m, "exp_name:\t%s\n", dmabuf->exp_name);
421         spin_lock(&dmabuf->name_lock);
422         if (dmabuf->name)
423                 seq_printf(m, "name:\t%s\n", dmabuf->name);
424         spin_unlock(&dmabuf->name_lock);
425 }
426
427 static const struct file_operations dma_buf_fops = {
428         .release        = dma_buf_file_release,
429         .mmap           = dma_buf_mmap_internal,
430         .llseek         = dma_buf_llseek,
431         .poll           = dma_buf_poll,
432         .unlocked_ioctl = dma_buf_ioctl,
433         .compat_ioctl   = compat_ptr_ioctl,
434         .show_fdinfo    = dma_buf_show_fdinfo,
435 };
436
437 /*
438  * is_dma_buf_file - Check if struct file* is associated with dma_buf
439  */
440 static inline int is_dma_buf_file(struct file *file)
441 {
442         return file->f_op == &dma_buf_fops;
443 }
444
445 static struct file *dma_buf_getfile(struct dma_buf *dmabuf, int flags)
446 {
447         struct file *file;
448         struct inode *inode = alloc_anon_inode(dma_buf_mnt->mnt_sb);
449
450         if (IS_ERR(inode))
451                 return ERR_CAST(inode);
452
453         inode->i_size = dmabuf->size;
454         inode_set_bytes(inode, dmabuf->size);
455
456         file = alloc_file_pseudo(inode, dma_buf_mnt, "dmabuf",
457                                  flags, &dma_buf_fops);
458         if (IS_ERR(file))
459                 goto err_alloc_file;
460         file->f_flags = flags & (O_ACCMODE | O_NONBLOCK);
461         file->private_data = dmabuf;
462         file->f_path.dentry->d_fsdata = dmabuf;
463
464         return file;
465
466 err_alloc_file:
467         iput(inode);
468         return file;
469 }
470
471 /**
472  * DOC: dma buf device access
473  *
474  * For device DMA access to a shared DMA buffer the usual sequence of operations
475  * is fairly simple:
476  *
477  * 1. The exporter defines his exporter instance using
478  *    DEFINE_DMA_BUF_EXPORT_INFO() and calls dma_buf_export() to wrap a private
479  *    buffer object into a &dma_buf. It then exports that &dma_buf to userspace
480  *    as a file descriptor by calling dma_buf_fd().
481  *
482  * 2. Userspace passes this file-descriptors to all drivers it wants this buffer
483  *    to share with: First the filedescriptor is converted to a &dma_buf using
484  *    dma_buf_get(). Then the buffer is attached to the device using
485  *    dma_buf_attach().
486  *
487  *    Up to this stage the exporter is still free to migrate or reallocate the
488  *    backing storage.
489  *
490  * 3. Once the buffer is attached to all devices userspace can initiate DMA
491  *    access to the shared buffer. In the kernel this is done by calling
492  *    dma_buf_map_attachment() and dma_buf_unmap_attachment().
493  *
494  * 4. Once a driver is done with a shared buffer it needs to call
495  *    dma_buf_detach() (after cleaning up any mappings) and then release the
496  *    reference acquired with dma_buf_get() by calling dma_buf_put().
497  *
498  * For the detailed semantics exporters are expected to implement see
499  * &dma_buf_ops.
500  */
501
502 /**
503  * dma_buf_export - Creates a new dma_buf, and associates an anon file
504  * with this buffer, so it can be exported.
505  * Also connect the allocator specific data and ops to the buffer.
506  * Additionally, provide a name string for exporter; useful in debugging.
507  *
508  * @exp_info:   [in]    holds all the export related information provided
509  *                      by the exporter. see &struct dma_buf_export_info
510  *                      for further details.
511  *
512  * Returns, on success, a newly created struct dma_buf object, which wraps the
513  * supplied private data and operations for struct dma_buf_ops. On either
514  * missing ops, or error in allocating struct dma_buf, will return negative
515  * error.
516  *
517  * For most cases the easiest way to create @exp_info is through the
518  * %DEFINE_DMA_BUF_EXPORT_INFO macro.
519  */
520 struct dma_buf *dma_buf_export(const struct dma_buf_export_info *exp_info)
521 {
522         struct dma_buf *dmabuf;
523         struct dma_resv *resv = exp_info->resv;
524         struct file *file;
525         size_t alloc_size = sizeof(struct dma_buf);
526         int ret;
527
528         if (!exp_info->resv)
529                 alloc_size += sizeof(struct dma_resv);
530         else
531                 /* prevent &dma_buf[1] == dma_buf->resv */
532                 alloc_size += 1;
533
534         if (WARN_ON(!exp_info->priv
535                           || !exp_info->ops
536                           || !exp_info->ops->map_dma_buf
537                           || !exp_info->ops->unmap_dma_buf
538                           || !exp_info->ops->release)) {
539                 return ERR_PTR(-EINVAL);
540         }
541
542         if (WARN_ON(exp_info->ops->cache_sgt_mapping &&
543                     (exp_info->ops->pin || exp_info->ops->unpin)))
544                 return ERR_PTR(-EINVAL);
545
546         if (WARN_ON(!exp_info->ops->pin != !exp_info->ops->unpin))
547                 return ERR_PTR(-EINVAL);
548
549         if (!try_module_get(exp_info->owner))
550                 return ERR_PTR(-ENOENT);
551
552         dmabuf = kzalloc(alloc_size, GFP_KERNEL);
553         if (!dmabuf) {
554                 ret = -ENOMEM;
555                 goto err_module;
556         }
557
558         dmabuf->priv = exp_info->priv;
559         dmabuf->ops = exp_info->ops;
560         dmabuf->size = exp_info->size;
561         dmabuf->exp_name = exp_info->exp_name;
562         dmabuf->owner = exp_info->owner;
563         spin_lock_init(&dmabuf->name_lock);
564         init_waitqueue_head(&dmabuf->poll);
565         dmabuf->cb_excl.poll = dmabuf->cb_shared.poll = &dmabuf->poll;
566         dmabuf->cb_excl.active = dmabuf->cb_shared.active = 0;
567
568         if (!resv) {
569                 resv = (struct dma_resv *)&dmabuf[1];
570                 dma_resv_init(resv);
571         }
572         dmabuf->resv = resv;
573
574         file = dma_buf_getfile(dmabuf, exp_info->flags);
575         if (IS_ERR(file)) {
576                 ret = PTR_ERR(file);
577                 goto err_dmabuf;
578         }
579
580         file->f_mode |= FMODE_LSEEK;
581         dmabuf->file = file;
582
583         mutex_init(&dmabuf->lock);
584         INIT_LIST_HEAD(&dmabuf->attachments);
585
586         mutex_lock(&db_list.lock);
587         list_add(&dmabuf->list_node, &db_list.head);
588         mutex_unlock(&db_list.lock);
589
590         return dmabuf;
591
592 err_dmabuf:
593         kfree(dmabuf);
594 err_module:
595         module_put(exp_info->owner);
596         return ERR_PTR(ret);
597 }
598 EXPORT_SYMBOL_GPL(dma_buf_export);
599
600 /**
601  * dma_buf_fd - returns a file descriptor for the given struct dma_buf
602  * @dmabuf:     [in]    pointer to dma_buf for which fd is required.
603  * @flags:      [in]    flags to give to fd
604  *
605  * On success, returns an associated 'fd'. Else, returns error.
606  */
607 int dma_buf_fd(struct dma_buf *dmabuf, int flags)
608 {
609         int fd;
610
611         if (!dmabuf || !dmabuf->file)
612                 return -EINVAL;
613
614         fd = get_unused_fd_flags(flags);
615         if (fd < 0)
616                 return fd;
617
618         fd_install(fd, dmabuf->file);
619
620         return fd;
621 }
622 EXPORT_SYMBOL_GPL(dma_buf_fd);
623
624 /**
625  * dma_buf_get - returns the struct dma_buf related to an fd
626  * @fd: [in]    fd associated with the struct dma_buf to be returned
627  *
628  * On success, returns the struct dma_buf associated with an fd; uses
629  * file's refcounting done by fget to increase refcount. returns ERR_PTR
630  * otherwise.
631  */
632 struct dma_buf *dma_buf_get(int fd)
633 {
634         struct file *file;
635
636         file = fget(fd);
637
638         if (!file)
639                 return ERR_PTR(-EBADF);
640
641         if (!is_dma_buf_file(file)) {
642                 fput(file);
643                 return ERR_PTR(-EINVAL);
644         }
645
646         return file->private_data;
647 }
648 EXPORT_SYMBOL_GPL(dma_buf_get);
649
650 /**
651  * dma_buf_put - decreases refcount of the buffer
652  * @dmabuf:     [in]    buffer to reduce refcount of
653  *
654  * Uses file's refcounting done implicitly by fput().
655  *
656  * If, as a result of this call, the refcount becomes 0, the 'release' file
657  * operation related to this fd is called. It calls &dma_buf_ops.release vfunc
658  * in turn, and frees the memory allocated for dmabuf when exported.
659  */
660 void dma_buf_put(struct dma_buf *dmabuf)
661 {
662         if (WARN_ON(!dmabuf || !dmabuf->file))
663                 return;
664
665         fput(dmabuf->file);
666 }
667 EXPORT_SYMBOL_GPL(dma_buf_put);
668
669 static void mangle_sg_table(struct sg_table *sg_table)
670 {
671 #ifdef CONFIG_DMABUF_DEBUG
672         int i;
673         struct scatterlist *sg;
674
675         /* To catch abuse of the underlying struct page by importers mix
676          * up the bits, but take care to preserve the low SG_ bits to
677          * not corrupt the sgt. The mixing is undone in __unmap_dma_buf
678          * before passing the sgt back to the exporter. */
679         for_each_sgtable_sg(sg_table, sg, i)
680                 sg->page_link ^= ~0xffUL;
681 #endif
682
683 }
684 static struct sg_table * __map_dma_buf(struct dma_buf_attachment *attach,
685                                        enum dma_data_direction direction)
686 {
687         struct sg_table *sg_table;
688
689         sg_table = attach->dmabuf->ops->map_dma_buf(attach, direction);
690
691         if (!IS_ERR_OR_NULL(sg_table))
692                 mangle_sg_table(sg_table);
693
694         return sg_table;
695 }
696
697 /**
698  * dma_buf_dynamic_attach - Add the device to dma_buf's attachments list
699  * @dmabuf:             [in]    buffer to attach device to.
700  * @dev:                [in]    device to be attached.
701  * @importer_ops:       [in]    importer operations for the attachment
702  * @importer_priv:      [in]    importer private pointer for the attachment
703  *
704  * Returns struct dma_buf_attachment pointer for this attachment. Attachments
705  * must be cleaned up by calling dma_buf_detach().
706  *
707  * Optionally this calls &dma_buf_ops.attach to allow device-specific attach
708  * functionality.
709  *
710  * Returns:
711  *
712  * A pointer to newly created &dma_buf_attachment on success, or a negative
713  * error code wrapped into a pointer on failure.
714  *
715  * Note that this can fail if the backing storage of @dmabuf is in a place not
716  * accessible to @dev, and cannot be moved to a more suitable place. This is
717  * indicated with the error code -EBUSY.
718  */
719 struct dma_buf_attachment *
720 dma_buf_dynamic_attach(struct dma_buf *dmabuf, struct device *dev,
721                        const struct dma_buf_attach_ops *importer_ops,
722                        void *importer_priv)
723 {
724         struct dma_buf_attachment *attach;
725         int ret;
726
727         if (WARN_ON(!dmabuf || !dev))
728                 return ERR_PTR(-EINVAL);
729
730         if (WARN_ON(importer_ops && !importer_ops->move_notify))
731                 return ERR_PTR(-EINVAL);
732
733         attach = kzalloc(sizeof(*attach), GFP_KERNEL);
734         if (!attach)
735                 return ERR_PTR(-ENOMEM);
736
737         attach->dev = dev;
738         attach->dmabuf = dmabuf;
739         if (importer_ops)
740                 attach->peer2peer = importer_ops->allow_peer2peer;
741         attach->importer_ops = importer_ops;
742         attach->importer_priv = importer_priv;
743
744         if (dmabuf->ops->attach) {
745                 ret = dmabuf->ops->attach(dmabuf, attach);
746                 if (ret)
747                         goto err_attach;
748         }
749         dma_resv_lock(dmabuf->resv, NULL);
750         list_add(&attach->node, &dmabuf->attachments);
751         dma_resv_unlock(dmabuf->resv);
752
753         /* When either the importer or the exporter can't handle dynamic
754          * mappings we cache the mapping here to avoid issues with the
755          * reservation object lock.
756          */
757         if (dma_buf_attachment_is_dynamic(attach) !=
758             dma_buf_is_dynamic(dmabuf)) {
759                 struct sg_table *sgt;
760
761                 if (dma_buf_is_dynamic(attach->dmabuf)) {
762                         dma_resv_lock(attach->dmabuf->resv, NULL);
763                         ret = dma_buf_pin(attach);
764                         if (ret)
765                                 goto err_unlock;
766                 }
767
768                 sgt = __map_dma_buf(attach, DMA_BIDIRECTIONAL);
769                 if (!sgt)
770                         sgt = ERR_PTR(-ENOMEM);
771                 if (IS_ERR(sgt)) {
772                         ret = PTR_ERR(sgt);
773                         goto err_unpin;
774                 }
775                 if (dma_buf_is_dynamic(attach->dmabuf))
776                         dma_resv_unlock(attach->dmabuf->resv);
777                 attach->sgt = sgt;
778                 attach->dir = DMA_BIDIRECTIONAL;
779         }
780
781         return attach;
782
783 err_attach:
784         kfree(attach);
785         return ERR_PTR(ret);
786
787 err_unpin:
788         if (dma_buf_is_dynamic(attach->dmabuf))
789                 dma_buf_unpin(attach);
790
791 err_unlock:
792         if (dma_buf_is_dynamic(attach->dmabuf))
793                 dma_resv_unlock(attach->dmabuf->resv);
794
795         dma_buf_detach(dmabuf, attach);
796         return ERR_PTR(ret);
797 }
798 EXPORT_SYMBOL_GPL(dma_buf_dynamic_attach);
799
800 /**
801  * dma_buf_attach - Wrapper for dma_buf_dynamic_attach
802  * @dmabuf:     [in]    buffer to attach device to.
803  * @dev:        [in]    device to be attached.
804  *
805  * Wrapper to call dma_buf_dynamic_attach() for drivers which still use a static
806  * mapping.
807  */
808 struct dma_buf_attachment *dma_buf_attach(struct dma_buf *dmabuf,
809                                           struct device *dev)
810 {
811         return dma_buf_dynamic_attach(dmabuf, dev, NULL, NULL);
812 }
813 EXPORT_SYMBOL_GPL(dma_buf_attach);
814
815 static void __unmap_dma_buf(struct dma_buf_attachment *attach,
816                             struct sg_table *sg_table,
817                             enum dma_data_direction direction)
818 {
819         /* uses XOR, hence this unmangles */
820         mangle_sg_table(sg_table);
821
822         attach->dmabuf->ops->unmap_dma_buf(attach, sg_table, direction);
823 }
824
825 /**
826  * dma_buf_detach - Remove the given attachment from dmabuf's attachments list
827  * @dmabuf:     [in]    buffer to detach from.
828  * @attach:     [in]    attachment to be detached; is free'd after this call.
829  *
830  * Clean up a device attachment obtained by calling dma_buf_attach().
831  *
832  * Optionally this calls &dma_buf_ops.detach for device-specific detach.
833  */
834 void dma_buf_detach(struct dma_buf *dmabuf, struct dma_buf_attachment *attach)
835 {
836         if (WARN_ON(!dmabuf || !attach))
837                 return;
838
839         if (attach->sgt) {
840                 if (dma_buf_is_dynamic(attach->dmabuf))
841                         dma_resv_lock(attach->dmabuf->resv, NULL);
842
843                 __unmap_dma_buf(attach, attach->sgt, attach->dir);
844
845                 if (dma_buf_is_dynamic(attach->dmabuf)) {
846                         dma_buf_unpin(attach);
847                         dma_resv_unlock(attach->dmabuf->resv);
848                 }
849         }
850
851         dma_resv_lock(dmabuf->resv, NULL);
852         list_del(&attach->node);
853         dma_resv_unlock(dmabuf->resv);
854         if (dmabuf->ops->detach)
855                 dmabuf->ops->detach(dmabuf, attach);
856
857         kfree(attach);
858 }
859 EXPORT_SYMBOL_GPL(dma_buf_detach);
860
861 /**
862  * dma_buf_pin - Lock down the DMA-buf
863  * @attach:     [in]    attachment which should be pinned
864  *
865  * Only dynamic importers (who set up @attach with dma_buf_dynamic_attach()) may
866  * call this, and only for limited use cases like scanout and not for temporary
867  * pin operations. It is not permitted to allow userspace to pin arbitrary
868  * amounts of buffers through this interface.
869  *
870  * Buffers must be unpinned by calling dma_buf_unpin().
871  *
872  * Returns:
873  * 0 on success, negative error code on failure.
874  */
875 int dma_buf_pin(struct dma_buf_attachment *attach)
876 {
877         struct dma_buf *dmabuf = attach->dmabuf;
878         int ret = 0;
879
880         WARN_ON(!dma_buf_attachment_is_dynamic(attach));
881
882         dma_resv_assert_held(dmabuf->resv);
883
884         if (dmabuf->ops->pin)
885                 ret = dmabuf->ops->pin(attach);
886
887         return ret;
888 }
889 EXPORT_SYMBOL_GPL(dma_buf_pin);
890
891 /**
892  * dma_buf_unpin - Unpin a DMA-buf
893  * @attach:     [in]    attachment which should be unpinned
894  *
895  * This unpins a buffer pinned by dma_buf_pin() and allows the exporter to move
896  * any mapping of @attach again and inform the importer through
897  * &dma_buf_attach_ops.move_notify.
898  */
899 void dma_buf_unpin(struct dma_buf_attachment *attach)
900 {
901         struct dma_buf *dmabuf = attach->dmabuf;
902
903         WARN_ON(!dma_buf_attachment_is_dynamic(attach));
904
905         dma_resv_assert_held(dmabuf->resv);
906
907         if (dmabuf->ops->unpin)
908                 dmabuf->ops->unpin(attach);
909 }
910 EXPORT_SYMBOL_GPL(dma_buf_unpin);
911
912 /**
913  * dma_buf_map_attachment - Returns the scatterlist table of the attachment;
914  * mapped into _device_ address space. Is a wrapper for map_dma_buf() of the
915  * dma_buf_ops.
916  * @attach:     [in]    attachment whose scatterlist is to be returned
917  * @direction:  [in]    direction of DMA transfer
918  *
919  * Returns sg_table containing the scatterlist to be returned; returns ERR_PTR
920  * on error. May return -EINTR if it is interrupted by a signal.
921  *
922  * On success, the DMA addresses and lengths in the returned scatterlist are
923  * PAGE_SIZE aligned.
924  *
925  * A mapping must be unmapped by using dma_buf_unmap_attachment(). Note that
926  * the underlying backing storage is pinned for as long as a mapping exists,
927  * therefore users/importers should not hold onto a mapping for undue amounts of
928  * time.
929  */
930 struct sg_table *dma_buf_map_attachment(struct dma_buf_attachment *attach,
931                                         enum dma_data_direction direction)
932 {
933         struct sg_table *sg_table;
934         int r;
935
936         might_sleep();
937
938         if (WARN_ON(!attach || !attach->dmabuf))
939                 return ERR_PTR(-EINVAL);
940
941         if (dma_buf_attachment_is_dynamic(attach))
942                 dma_resv_assert_held(attach->dmabuf->resv);
943
944         if (attach->sgt) {
945                 /*
946                  * Two mappings with different directions for the same
947                  * attachment are not allowed.
948                  */
949                 if (attach->dir != direction &&
950                     attach->dir != DMA_BIDIRECTIONAL)
951                         return ERR_PTR(-EBUSY);
952
953                 return attach->sgt;
954         }
955
956         if (dma_buf_is_dynamic(attach->dmabuf)) {
957                 dma_resv_assert_held(attach->dmabuf->resv);
958                 if (!IS_ENABLED(CONFIG_DMABUF_MOVE_NOTIFY)) {
959                         r = dma_buf_pin(attach);
960                         if (r)
961                                 return ERR_PTR(r);
962                 }
963         }
964
965         sg_table = __map_dma_buf(attach, direction);
966         if (!sg_table)
967                 sg_table = ERR_PTR(-ENOMEM);
968
969         if (IS_ERR(sg_table) && dma_buf_is_dynamic(attach->dmabuf) &&
970              !IS_ENABLED(CONFIG_DMABUF_MOVE_NOTIFY))
971                 dma_buf_unpin(attach);
972
973         if (!IS_ERR(sg_table) && attach->dmabuf->ops->cache_sgt_mapping) {
974                 attach->sgt = sg_table;
975                 attach->dir = direction;
976         }
977
978 #ifdef CONFIG_DMA_API_DEBUG
979         if (!IS_ERR(sg_table)) {
980                 struct scatterlist *sg;
981                 u64 addr;
982                 int len;
983                 int i;
984
985                 for_each_sgtable_dma_sg(sg_table, sg, i) {
986                         addr = sg_dma_address(sg);
987                         len = sg_dma_len(sg);
988                         if (!PAGE_ALIGNED(addr) || !PAGE_ALIGNED(len)) {
989                                 pr_debug("%s: addr %llx or len %x is not page aligned!\n",
990                                          __func__, addr, len);
991                         }
992                 }
993         }
994 #endif /* CONFIG_DMA_API_DEBUG */
995
996         return sg_table;
997 }
998 EXPORT_SYMBOL_GPL(dma_buf_map_attachment);
999
1000 /**
1001  * dma_buf_unmap_attachment - unmaps and decreases usecount of the buffer;might
1002  * deallocate the scatterlist associated. Is a wrapper for unmap_dma_buf() of
1003  * dma_buf_ops.
1004  * @attach:     [in]    attachment to unmap buffer from
1005  * @sg_table:   [in]    scatterlist info of the buffer to unmap
1006  * @direction:  [in]    direction of DMA transfer
1007  *
1008  * This unmaps a DMA mapping for @attached obtained by dma_buf_map_attachment().
1009  */
1010 void dma_buf_unmap_attachment(struct dma_buf_attachment *attach,
1011                                 struct sg_table *sg_table,
1012                                 enum dma_data_direction direction)
1013 {
1014         might_sleep();
1015
1016         if (WARN_ON(!attach || !attach->dmabuf || !sg_table))
1017                 return;
1018
1019         if (dma_buf_attachment_is_dynamic(attach))
1020                 dma_resv_assert_held(attach->dmabuf->resv);
1021
1022         if (attach->sgt == sg_table)
1023                 return;
1024
1025         if (dma_buf_is_dynamic(attach->dmabuf))
1026                 dma_resv_assert_held(attach->dmabuf->resv);
1027
1028         __unmap_dma_buf(attach, sg_table, direction);
1029
1030         if (dma_buf_is_dynamic(attach->dmabuf) &&
1031             !IS_ENABLED(CONFIG_DMABUF_MOVE_NOTIFY))
1032                 dma_buf_unpin(attach);
1033 }
1034 EXPORT_SYMBOL_GPL(dma_buf_unmap_attachment);
1035
1036 /**
1037  * dma_buf_move_notify - notify attachments that DMA-buf is moving
1038  *
1039  * @dmabuf:     [in]    buffer which is moving
1040  *
1041  * Informs all attachmenst that they need to destroy and recreated all their
1042  * mappings.
1043  */
1044 void dma_buf_move_notify(struct dma_buf *dmabuf)
1045 {
1046         struct dma_buf_attachment *attach;
1047
1048         dma_resv_assert_held(dmabuf->resv);
1049
1050         list_for_each_entry(attach, &dmabuf->attachments, node)
1051                 if (attach->importer_ops)
1052                         attach->importer_ops->move_notify(attach);
1053 }
1054 EXPORT_SYMBOL_GPL(dma_buf_move_notify);
1055
1056 /**
1057  * DOC: cpu access
1058  *
1059  * There are mutliple reasons for supporting CPU access to a dma buffer object:
1060  *
1061  * - Fallback operations in the kernel, for example when a device is connected
1062  *   over USB and the kernel needs to shuffle the data around first before
1063  *   sending it away. Cache coherency is handled by braketing any transactions
1064  *   with calls to dma_buf_begin_cpu_access() and dma_buf_end_cpu_access()
1065  *   access.
1066  *
1067  *   Since for most kernel internal dma-buf accesses need the entire buffer, a
1068  *   vmap interface is introduced. Note that on very old 32-bit architectures
1069  *   vmalloc space might be limited and result in vmap calls failing.
1070  *
1071  *   Interfaces::
1072  *
1073  *      void \*dma_buf_vmap(struct dma_buf \*dmabuf)
1074  *      void dma_buf_vunmap(struct dma_buf \*dmabuf, void \*vaddr)
1075  *
1076  *   The vmap call can fail if there is no vmap support in the exporter, or if
1077  *   it runs out of vmalloc space. Note that the dma-buf layer keeps a reference
1078  *   count for all vmap access and calls down into the exporter's vmap function
1079  *   only when no vmapping exists, and only unmaps it once. Protection against
1080  *   concurrent vmap/vunmap calls is provided by taking the &dma_buf.lock mutex.
1081  *
1082  * - For full compatibility on the importer side with existing userspace
1083  *   interfaces, which might already support mmap'ing buffers. This is needed in
1084  *   many processing pipelines (e.g. feeding a software rendered image into a
1085  *   hardware pipeline, thumbnail creation, snapshots, ...). Also, Android's ION
1086  *   framework already supported this and for DMA buffer file descriptors to
1087  *   replace ION buffers mmap support was needed.
1088  *
1089  *   There is no special interfaces, userspace simply calls mmap on the dma-buf
1090  *   fd. But like for CPU access there's a need to braket the actual access,
1091  *   which is handled by the ioctl (DMA_BUF_IOCTL_SYNC). Note that
1092  *   DMA_BUF_IOCTL_SYNC can fail with -EAGAIN or -EINTR, in which case it must
1093  *   be restarted.
1094  *
1095  *   Some systems might need some sort of cache coherency management e.g. when
1096  *   CPU and GPU domains are being accessed through dma-buf at the same time.
1097  *   To circumvent this problem there are begin/end coherency markers, that
1098  *   forward directly to existing dma-buf device drivers vfunc hooks. Userspace
1099  *   can make use of those markers through the DMA_BUF_IOCTL_SYNC ioctl. The
1100  *   sequence would be used like following:
1101  *
1102  *     - mmap dma-buf fd
1103  *     - for each drawing/upload cycle in CPU 1. SYNC_START ioctl, 2. read/write
1104  *       to mmap area 3. SYNC_END ioctl. This can be repeated as often as you
1105  *       want (with the new data being consumed by say the GPU or the scanout
1106  *       device)
1107  *     - munmap once you don't need the buffer any more
1108  *
1109  *    For correctness and optimal performance, it is always required to use
1110  *    SYNC_START and SYNC_END before and after, respectively, when accessing the
1111  *    mapped address. Userspace cannot rely on coherent access, even when there
1112  *    are systems where it just works without calling these ioctls.
1113  *
1114  * - And as a CPU fallback in userspace processing pipelines.
1115  *
1116  *   Similar to the motivation for kernel cpu access it is again important that
1117  *   the userspace code of a given importing subsystem can use the same
1118  *   interfaces with a imported dma-buf buffer object as with a native buffer
1119  *   object. This is especially important for drm where the userspace part of
1120  *   contemporary OpenGL, X, and other drivers is huge, and reworking them to
1121  *   use a different way to mmap a buffer rather invasive.
1122  *
1123  *   The assumption in the current dma-buf interfaces is that redirecting the
1124  *   initial mmap is all that's needed. A survey of some of the existing
1125  *   subsystems shows that no driver seems to do any nefarious thing like
1126  *   syncing up with outstanding asynchronous processing on the device or
1127  *   allocating special resources at fault time. So hopefully this is good
1128  *   enough, since adding interfaces to intercept pagefaults and allow pte
1129  *   shootdowns would increase the complexity quite a bit.
1130  *
1131  *   Interface::
1132  *
1133  *      int dma_buf_mmap(struct dma_buf \*, struct vm_area_struct \*,
1134  *                     unsigned long);
1135  *
1136  *   If the importing subsystem simply provides a special-purpose mmap call to
1137  *   set up a mapping in userspace, calling do_mmap with &dma_buf.file will
1138  *   equally achieve that for a dma-buf object.
1139  */
1140
1141 static int __dma_buf_begin_cpu_access(struct dma_buf *dmabuf,
1142                                       enum dma_data_direction direction)
1143 {
1144         bool write = (direction == DMA_BIDIRECTIONAL ||
1145                       direction == DMA_TO_DEVICE);
1146         struct dma_resv *resv = dmabuf->resv;
1147         long ret;
1148
1149         /* Wait on any implicit rendering fences */
1150         ret = dma_resv_wait_timeout_rcu(resv, write, true,
1151                                                   MAX_SCHEDULE_TIMEOUT);
1152         if (ret < 0)
1153                 return ret;
1154
1155         return 0;
1156 }
1157
1158 /**
1159  * dma_buf_begin_cpu_access - Must be called before accessing a dma_buf from the
1160  * cpu in the kernel context. Calls begin_cpu_access to allow exporter-specific
1161  * preparations. Coherency is only guaranteed in the specified range for the
1162  * specified access direction.
1163  * @dmabuf:     [in]    buffer to prepare cpu access for.
1164  * @direction:  [in]    length of range for cpu access.
1165  *
1166  * After the cpu access is complete the caller should call
1167  * dma_buf_end_cpu_access(). Only when cpu access is braketed by both calls is
1168  * it guaranteed to be coherent with other DMA access.
1169  *
1170  * This function will also wait for any DMA transactions tracked through
1171  * implicit synchronization in &dma_buf.resv. For DMA transactions with explicit
1172  * synchronization this function will only ensure cache coherency, callers must
1173  * ensure synchronization with such DMA transactions on their own.
1174  *
1175  * Can return negative error values, returns 0 on success.
1176  */
1177 int dma_buf_begin_cpu_access(struct dma_buf *dmabuf,
1178                              enum dma_data_direction direction)
1179 {
1180         int ret = 0;
1181
1182         if (WARN_ON(!dmabuf))
1183                 return -EINVAL;
1184
1185         might_lock(&dmabuf->resv->lock.base);
1186
1187         if (dmabuf->ops->begin_cpu_access)
1188                 ret = dmabuf->ops->begin_cpu_access(dmabuf, direction);
1189
1190         /* Ensure that all fences are waited upon - but we first allow
1191          * the native handler the chance to do so more efficiently if it
1192          * chooses. A double invocation here will be reasonably cheap no-op.
1193          */
1194         if (ret == 0)
1195                 ret = __dma_buf_begin_cpu_access(dmabuf, direction);
1196
1197         return ret;
1198 }
1199 EXPORT_SYMBOL_GPL(dma_buf_begin_cpu_access);
1200
1201 /**
1202  * dma_buf_end_cpu_access - Must be called after accessing a dma_buf from the
1203  * cpu in the kernel context. Calls end_cpu_access to allow exporter-specific
1204  * actions. Coherency is only guaranteed in the specified range for the
1205  * specified access direction.
1206  * @dmabuf:     [in]    buffer to complete cpu access for.
1207  * @direction:  [in]    length of range for cpu access.
1208  *
1209  * This terminates CPU access started with dma_buf_begin_cpu_access().
1210  *
1211  * Can return negative error values, returns 0 on success.
1212  */
1213 int dma_buf_end_cpu_access(struct dma_buf *dmabuf,
1214                            enum dma_data_direction direction)
1215 {
1216         int ret = 0;
1217
1218         WARN_ON(!dmabuf);
1219
1220         might_lock(&dmabuf->resv->lock.base);
1221
1222         if (dmabuf->ops->end_cpu_access)
1223                 ret = dmabuf->ops->end_cpu_access(dmabuf, direction);
1224
1225         return ret;
1226 }
1227 EXPORT_SYMBOL_GPL(dma_buf_end_cpu_access);
1228
1229
1230 /**
1231  * dma_buf_mmap - Setup up a userspace mmap with the given vma
1232  * @dmabuf:     [in]    buffer that should back the vma
1233  * @vma:        [in]    vma for the mmap
1234  * @pgoff:      [in]    offset in pages where this mmap should start within the
1235  *                      dma-buf buffer.
1236  *
1237  * This function adjusts the passed in vma so that it points at the file of the
1238  * dma_buf operation. It also adjusts the starting pgoff and does bounds
1239  * checking on the size of the vma. Then it calls the exporters mmap function to
1240  * set up the mapping.
1241  *
1242  * Can return negative error values, returns 0 on success.
1243  */
1244 int dma_buf_mmap(struct dma_buf *dmabuf, struct vm_area_struct *vma,
1245                  unsigned long pgoff)
1246 {
1247         if (WARN_ON(!dmabuf || !vma))
1248                 return -EINVAL;
1249
1250         /* check if buffer supports mmap */
1251         if (!dmabuf->ops->mmap)
1252                 return -EINVAL;
1253
1254         /* check for offset overflow */
1255         if (pgoff + vma_pages(vma) < pgoff)
1256                 return -EOVERFLOW;
1257
1258         /* check for overflowing the buffer's size */
1259         if (pgoff + vma_pages(vma) >
1260             dmabuf->size >> PAGE_SHIFT)
1261                 return -EINVAL;
1262
1263         /* readjust the vma */
1264         vma_set_file(vma, dmabuf->file);
1265         vma->vm_pgoff = pgoff;
1266
1267         return dmabuf->ops->mmap(dmabuf, vma);
1268 }
1269 EXPORT_SYMBOL_GPL(dma_buf_mmap);
1270
1271 /**
1272  * dma_buf_vmap - Create virtual mapping for the buffer object into kernel
1273  * address space. Same restrictions as for vmap and friends apply.
1274  * @dmabuf:     [in]    buffer to vmap
1275  * @map:        [out]   returns the vmap pointer
1276  *
1277  * This call may fail due to lack of virtual mapping address space.
1278  * These calls are optional in drivers. The intended use for them
1279  * is for mapping objects linear in kernel space for high use objects.
1280  *
1281  * To ensure coherency users must call dma_buf_begin_cpu_access() and
1282  * dma_buf_end_cpu_access() around any cpu access performed through this
1283  * mapping.
1284  *
1285  * Returns 0 on success, or a negative errno code otherwise.
1286  */
1287 int dma_buf_vmap(struct dma_buf *dmabuf, struct dma_buf_map *map)
1288 {
1289         struct dma_buf_map ptr;
1290         int ret = 0;
1291
1292         dma_buf_map_clear(map);
1293
1294         if (WARN_ON(!dmabuf))
1295                 return -EINVAL;
1296
1297         if (!dmabuf->ops->vmap)
1298                 return -EINVAL;
1299
1300         mutex_lock(&dmabuf->lock);
1301         if (dmabuf->vmapping_counter) {
1302                 dmabuf->vmapping_counter++;
1303                 BUG_ON(dma_buf_map_is_null(&dmabuf->vmap_ptr));
1304                 *map = dmabuf->vmap_ptr;
1305                 goto out_unlock;
1306         }
1307
1308         BUG_ON(dma_buf_map_is_set(&dmabuf->vmap_ptr));
1309
1310         ret = dmabuf->ops->vmap(dmabuf, &ptr);
1311         if (WARN_ON_ONCE(ret))
1312                 goto out_unlock;
1313
1314         dmabuf->vmap_ptr = ptr;
1315         dmabuf->vmapping_counter = 1;
1316
1317         *map = dmabuf->vmap_ptr;
1318
1319 out_unlock:
1320         mutex_unlock(&dmabuf->lock);
1321         return ret;
1322 }
1323 EXPORT_SYMBOL_GPL(dma_buf_vmap);
1324
1325 /**
1326  * dma_buf_vunmap - Unmap a vmap obtained by dma_buf_vmap.
1327  * @dmabuf:     [in]    buffer to vunmap
1328  * @map:        [in]    vmap pointer to vunmap
1329  */
1330 void dma_buf_vunmap(struct dma_buf *dmabuf, struct dma_buf_map *map)
1331 {
1332         if (WARN_ON(!dmabuf))
1333                 return;
1334
1335         BUG_ON(dma_buf_map_is_null(&dmabuf->vmap_ptr));
1336         BUG_ON(dmabuf->vmapping_counter == 0);
1337         BUG_ON(!dma_buf_map_is_equal(&dmabuf->vmap_ptr, map));
1338
1339         mutex_lock(&dmabuf->lock);
1340         if (--dmabuf->vmapping_counter == 0) {
1341                 if (dmabuf->ops->vunmap)
1342                         dmabuf->ops->vunmap(dmabuf, map);
1343                 dma_buf_map_clear(&dmabuf->vmap_ptr);
1344         }
1345         mutex_unlock(&dmabuf->lock);
1346 }
1347 EXPORT_SYMBOL_GPL(dma_buf_vunmap);
1348
1349 #ifdef CONFIG_DEBUG_FS
1350 static int dma_buf_debug_show(struct seq_file *s, void *unused)
1351 {
1352         int ret;
1353         struct dma_buf *buf_obj;
1354         struct dma_buf_attachment *attach_obj;
1355         struct dma_resv *robj;
1356         struct dma_resv_list *fobj;
1357         struct dma_fence *fence;
1358         unsigned seq;
1359         int count = 0, attach_count, shared_count, i;
1360         size_t size = 0;
1361
1362         ret = mutex_lock_interruptible(&db_list.lock);
1363
1364         if (ret)
1365                 return ret;
1366
1367         seq_puts(s, "\nDma-buf Objects:\n");
1368         seq_printf(s, "%-8s\t%-8s\t%-8s\t%-8s\texp_name\t%-8s\n",
1369                    "size", "flags", "mode", "count", "ino");
1370
1371         list_for_each_entry(buf_obj, &db_list.head, list_node) {
1372
1373                 ret = dma_resv_lock_interruptible(buf_obj->resv, NULL);
1374                 if (ret)
1375                         goto error_unlock;
1376
1377                 seq_printf(s, "%08zu\t%08x\t%08x\t%08ld\t%s\t%08lu\t%s\n",
1378                                 buf_obj->size,
1379                                 buf_obj->file->f_flags, buf_obj->file->f_mode,
1380                                 file_count(buf_obj->file),
1381                                 buf_obj->exp_name,
1382                                 file_inode(buf_obj->file)->i_ino,
1383                                 buf_obj->name ?: "");
1384
1385                 robj = buf_obj->resv;
1386                 while (true) {
1387                         seq = read_seqcount_begin(&robj->seq);
1388                         rcu_read_lock();
1389                         fobj = rcu_dereference(robj->fence);
1390                         shared_count = fobj ? fobj->shared_count : 0;
1391                         fence = rcu_dereference(robj->fence_excl);
1392                         if (!read_seqcount_retry(&robj->seq, seq))
1393                                 break;
1394                         rcu_read_unlock();
1395                 }
1396
1397                 if (fence)
1398                         seq_printf(s, "\tExclusive fence: %s %s %ssignalled\n",
1399                                    fence->ops->get_driver_name(fence),
1400                                    fence->ops->get_timeline_name(fence),
1401                                    dma_fence_is_signaled(fence) ? "" : "un");
1402                 for (i = 0; i < shared_count; i++) {
1403                         fence = rcu_dereference(fobj->shared[i]);
1404                         if (!dma_fence_get_rcu(fence))
1405                                 continue;
1406                         seq_printf(s, "\tShared fence: %s %s %ssignalled\n",
1407                                    fence->ops->get_driver_name(fence),
1408                                    fence->ops->get_timeline_name(fence),
1409                                    dma_fence_is_signaled(fence) ? "" : "un");
1410                         dma_fence_put(fence);
1411                 }
1412                 rcu_read_unlock();
1413
1414                 seq_puts(s, "\tAttached Devices:\n");
1415                 attach_count = 0;
1416
1417                 list_for_each_entry(attach_obj, &buf_obj->attachments, node) {
1418                         seq_printf(s, "\t%s\n", dev_name(attach_obj->dev));
1419                         attach_count++;
1420                 }
1421                 dma_resv_unlock(buf_obj->resv);
1422
1423                 seq_printf(s, "Total %d devices attached\n\n",
1424                                 attach_count);
1425
1426                 count++;
1427                 size += buf_obj->size;
1428         }
1429
1430         seq_printf(s, "\nTotal %d objects, %zu bytes\n", count, size);
1431
1432         mutex_unlock(&db_list.lock);
1433         return 0;
1434
1435 error_unlock:
1436         mutex_unlock(&db_list.lock);
1437         return ret;
1438 }
1439
1440 DEFINE_SHOW_ATTRIBUTE(dma_buf_debug);
1441
1442 static struct dentry *dma_buf_debugfs_dir;
1443
1444 static int dma_buf_init_debugfs(void)
1445 {
1446         struct dentry *d;
1447         int err = 0;
1448
1449         d = debugfs_create_dir("dma_buf", NULL);
1450         if (IS_ERR(d))
1451                 return PTR_ERR(d);
1452
1453         dma_buf_debugfs_dir = d;
1454
1455         d = debugfs_create_file("bufinfo", S_IRUGO, dma_buf_debugfs_dir,
1456                                 NULL, &dma_buf_debug_fops);
1457         if (IS_ERR(d)) {
1458                 pr_debug("dma_buf: debugfs: failed to create node bufinfo\n");
1459                 debugfs_remove_recursive(dma_buf_debugfs_dir);
1460                 dma_buf_debugfs_dir = NULL;
1461                 err = PTR_ERR(d);
1462         }
1463
1464         return err;
1465 }
1466
1467 static void dma_buf_uninit_debugfs(void)
1468 {
1469         debugfs_remove_recursive(dma_buf_debugfs_dir);
1470 }
1471 #else
1472 static inline int dma_buf_init_debugfs(void)
1473 {
1474         return 0;
1475 }
1476 static inline void dma_buf_uninit_debugfs(void)
1477 {
1478 }
1479 #endif
1480
1481 static int __init dma_buf_init(void)
1482 {
1483         dma_buf_mnt = kern_mount(&dma_buf_fs_type);
1484         if (IS_ERR(dma_buf_mnt))
1485                 return PTR_ERR(dma_buf_mnt);
1486
1487         mutex_init(&db_list.lock);
1488         INIT_LIST_HEAD(&db_list.head);
1489         dma_buf_init_debugfs();
1490         return 0;
1491 }
1492 subsys_initcall(dma_buf_init);
1493
1494 static void __exit dma_buf_deinit(void)
1495 {
1496         dma_buf_uninit_debugfs();
1497         kern_unmount(dma_buf_mnt);
1498 }
1499 __exitcall(dma_buf_deinit);