1 // SPDX-License-Identifier: GPL-2.0-only
3 * drivers/dma-buf/sync_file.c
5 * Copyright (C) 2012 Google, Inc.
8 #include <linux/dma-fence-unwrap.h>
9 #include <linux/export.h>
10 #include <linux/file.h>
12 #include <linux/kernel.h>
13 #include <linux/poll.h>
14 #include <linux/sched.h>
15 #include <linux/slab.h>
16 #include <linux/uaccess.h>
17 #include <linux/anon_inodes.h>
18 #include <linux/sync_file.h>
19 #include <uapi/linux/sync_file.h>
21 static const struct file_operations sync_file_fops;
23 static struct sync_file *sync_file_alloc(void)
25 struct sync_file *sync_file;
27 sync_file = kzalloc(sizeof(*sync_file), GFP_KERNEL);
31 sync_file->file = anon_inode_getfile("sync_file", &sync_file_fops,
33 if (IS_ERR(sync_file->file))
36 init_waitqueue_head(&sync_file->wq);
38 INIT_LIST_HEAD(&sync_file->cb.node);
47 static void fence_check_cb_func(struct dma_fence *f, struct dma_fence_cb *cb)
49 struct sync_file *sync_file;
51 sync_file = container_of(cb, struct sync_file, cb);
53 wake_up_all(&sync_file->wq);
57 * sync_file_create() - creates a sync file
58 * @fence: fence to add to the sync_fence
60 * Creates a sync_file containg @fence. This function acquires and additional
61 * reference of @fence for the newly-created &sync_file, if it succeeds. The
62 * sync_file can be released with fput(sync_file->file). Returns the
63 * sync_file or NULL in case of error.
65 struct sync_file *sync_file_create(struct dma_fence *fence)
67 struct sync_file *sync_file;
69 sync_file = sync_file_alloc();
73 sync_file->fence = dma_fence_get(fence);
77 EXPORT_SYMBOL(sync_file_create);
79 static struct sync_file *sync_file_fdget(int fd)
81 struct file *file = fget(fd);
86 if (file->f_op != &sync_file_fops)
89 return file->private_data;
97 * sync_file_get_fence - get the fence related to the sync_file fd
98 * @fd: sync_file fd to get the fence from
100 * Ensures @fd references a valid sync_file and returns a fence that
101 * represents all fence in the sync_file. On error NULL is returned.
103 struct dma_fence *sync_file_get_fence(int fd)
105 struct sync_file *sync_file;
106 struct dma_fence *fence;
108 sync_file = sync_file_fdget(fd);
112 fence = dma_fence_get(sync_file->fence);
113 fput(sync_file->file);
117 EXPORT_SYMBOL(sync_file_get_fence);
120 * sync_file_get_name - get the name of the sync_file
121 * @sync_file: sync_file to get the fence from
122 * @buf: destination buffer to copy sync_file name into
123 * @len: available size of destination buffer.
125 * Each sync_file may have a name assigned either by the user (when merging
126 * sync_files together) or created from the fence it contains. In the latter
127 * case construction of the name is deferred until use, and so requires
128 * sync_file_get_name().
130 * Returns: a string representing the name.
132 char *sync_file_get_name(struct sync_file *sync_file, char *buf, int len)
134 if (sync_file->user_name[0]) {
135 strscpy(buf, sync_file->user_name, len);
137 struct dma_fence *fence = sync_file->fence;
139 snprintf(buf, len, "%s-%s%llu-%lld",
140 fence->ops->get_driver_name(fence),
141 fence->ops->get_timeline_name(fence),
150 * sync_file_merge() - merge two sync_files
151 * @name: name of new fence
155 * Creates a new sync_file which contains copies of all the fences in both
156 * @a and @b. @a and @b remain valid, independent sync_file. Returns the
157 * new merged sync_file or NULL in case of error.
159 static struct sync_file *sync_file_merge(const char *name, struct sync_file *a,
162 struct sync_file *sync_file;
163 struct dma_fence *fence;
165 sync_file = sync_file_alloc();
169 fence = dma_fence_unwrap_merge(a->fence, b->fence);
171 fput(sync_file->file);
174 sync_file->fence = fence;
175 strscpy(sync_file->user_name, name, sizeof(sync_file->user_name));
179 static int sync_file_release(struct inode *inode, struct file *file)
181 struct sync_file *sync_file = file->private_data;
183 if (test_bit(POLL_ENABLED, &sync_file->flags))
184 dma_fence_remove_callback(sync_file->fence, &sync_file->cb);
185 dma_fence_put(sync_file->fence);
191 static __poll_t sync_file_poll(struct file *file, poll_table *wait)
193 struct sync_file *sync_file = file->private_data;
195 poll_wait(file, &sync_file->wq, wait);
197 if (list_empty(&sync_file->cb.node) &&
198 !test_and_set_bit(POLL_ENABLED, &sync_file->flags)) {
199 if (dma_fence_add_callback(sync_file->fence, &sync_file->cb,
200 fence_check_cb_func) < 0)
201 wake_up_all(&sync_file->wq);
204 return dma_fence_is_signaled(sync_file->fence) ? EPOLLIN : 0;
207 static long sync_file_ioctl_merge(struct sync_file *sync_file,
210 int fd = get_unused_fd_flags(O_CLOEXEC);
212 struct sync_file *fence2, *fence3;
213 struct sync_merge_data data;
218 if (copy_from_user(&data, (void __user *)arg, sizeof(data))) {
223 if (data.flags || data.pad) {
228 fence2 = sync_file_fdget(data.fd2);
234 data.name[sizeof(data.name) - 1] = '\0';
235 fence3 = sync_file_merge(data.name, sync_file, fence2);
242 if (copy_to_user((void __user *)arg, &data, sizeof(data))) {
247 fd_install(fd, fence3->file);
262 static int sync_fill_fence_info(struct dma_fence *fence,
263 struct sync_fence_info *info)
265 strscpy(info->obj_name, fence->ops->get_timeline_name(fence),
266 sizeof(info->obj_name));
267 strscpy(info->driver_name, fence->ops->get_driver_name(fence),
268 sizeof(info->driver_name));
270 info->status = dma_fence_get_status(fence);
271 while (test_bit(DMA_FENCE_FLAG_SIGNALED_BIT, &fence->flags) &&
272 !test_bit(DMA_FENCE_FLAG_TIMESTAMP_BIT, &fence->flags))
275 test_bit(DMA_FENCE_FLAG_TIMESTAMP_BIT, &fence->flags) ?
276 ktime_to_ns(fence->timestamp) :
282 static long sync_file_ioctl_fence_info(struct sync_file *sync_file,
285 struct sync_fence_info *fence_info = NULL;
286 struct dma_fence_unwrap iter;
287 struct sync_file_info info;
288 unsigned int num_fences;
289 struct dma_fence *fence;
293 if (copy_from_user(&info, (void __user *)arg, sizeof(info)))
296 if (info.flags || info.pad)
300 dma_fence_unwrap_for_each(fence, &iter, sync_file->fence)
304 * Passing num_fences = 0 means that userspace doesn't want to
305 * retrieve any sync_fence_info. If num_fences = 0 we skip filling
306 * sync_fence_info and return the actual number of fences on
309 if (!info.num_fences) {
310 info.status = dma_fence_get_status(sync_file->fence);
316 if (info.num_fences < num_fences)
319 size = num_fences * sizeof(*fence_info);
320 fence_info = kzalloc(size, GFP_KERNEL);
325 dma_fence_unwrap_for_each(fence, &iter, sync_file->fence) {
328 status = sync_fill_fence_info(fence, &fence_info[num_fences++]);
329 info.status = info.status <= 0 ? info.status : status;
332 if (copy_to_user(u64_to_user_ptr(info.sync_fence_info), fence_info,
339 sync_file_get_name(sync_file, info.name, sizeof(info.name));
340 info.num_fences = num_fences;
342 if (copy_to_user((void __user *)arg, &info, sizeof(info)))
353 static long sync_file_ioctl(struct file *file, unsigned int cmd,
356 struct sync_file *sync_file = file->private_data;
360 return sync_file_ioctl_merge(sync_file, arg);
362 case SYNC_IOC_FILE_INFO:
363 return sync_file_ioctl_fence_info(sync_file, arg);
370 static const struct file_operations sync_file_fops = {
371 .release = sync_file_release,
372 .poll = sync_file_poll,
373 .unlocked_ioctl = sync_file_ioctl,
374 .compat_ioctl = compat_ptr_ioctl,