2 * Copyright 2017 Red Hat
3 * Parts ported from amdgpu (fence wait code).
4 * Copyright 2016 Advanced Micro Devices, Inc.
6 * Permission is hereby granted, free of charge, to any person obtaining a
7 * copy of this software and associated documentation files (the "Software"),
8 * to deal in the Software without restriction, including without limitation
9 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
10 * and/or sell copies of the Software, and to permit persons to whom the
11 * Software is furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice (including the next
14 * paragraph) shall be included in all copies or substantial portions of the
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
20 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
22 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
32 * DRM synchronisation objects (syncobj, see struct &drm_syncobj) provide a
33 * container for a synchronization primitive which can be used by userspace
34 * to explicitly synchronize GPU commands, can be shared between userspace
35 * processes, and can be shared between different DRM drivers.
36 * Their primary use-case is to implement Vulkan fences and semaphores.
37 * The syncobj userspace API provides ioctls for several operations:
39 * - Creation and destruction of syncobjs
40 * - Import and export of syncobjs to/from a syncobj file descriptor
41 * - Import and export a syncobj's underlying fence to/from a sync file
42 * - Reset a syncobj (set its fence to NULL)
43 * - Signal a syncobj (set a trivially signaled fence)
44 * - Wait for a syncobj's fence to appear and be signaled
46 * The syncobj userspace API also provides operations to manipulate a syncobj
47 * in terms of a timeline of struct &dma_fence_chain rather than a single
48 * struct &dma_fence, through the following operations:
50 * - Signal a given point on the timeline
51 * - Wait for a given point to appear and/or be signaled
52 * - Import and export from/to a given point of a timeline
54 * At it's core, a syncobj is simply a wrapper around a pointer to a struct
55 * &dma_fence which may be NULL.
56 * When a syncobj is first created, its pointer is either NULL or a pointer
57 * to an already signaled fence depending on whether the
58 * &DRM_SYNCOBJ_CREATE_SIGNALED flag is passed to
59 * &DRM_IOCTL_SYNCOBJ_CREATE.
61 * If the syncobj is considered as a binary (its state is either signaled or
62 * unsignaled) primitive, when GPU work is enqueued in a DRM driver to signal
63 * the syncobj, the syncobj's fence is replaced with a fence which will be
64 * signaled by the completion of that work.
65 * If the syncobj is considered as a timeline primitive, when GPU work is
66 * enqueued in a DRM driver to signal the a given point of the syncobj, a new
67 * struct &dma_fence_chain pointing to the DRM driver's fence and also
68 * pointing to the previous fence that was in the syncobj. The new struct
69 * &dma_fence_chain fence replace the syncobj's fence and will be signaled by
70 * completion of the DRM driver's work and also any work associated with the
71 * fence previously in the syncobj.
73 * When GPU work which waits on a syncobj is enqueued in a DRM driver, at the
74 * time the work is enqueued, it waits on the syncobj's fence before
75 * submitting the work to hardware. That fence is either :
77 * - The syncobj's current fence if the syncobj is considered as a binary
79 * - The struct &dma_fence associated with a given point if the syncobj is
80 * considered as a timeline primitive.
82 * If the syncobj's fence is NULL or not present in the syncobj's timeline,
83 * the enqueue operation is expected to fail.
85 * With binary syncobj, all manipulation of the syncobjs's fence happens in
86 * terms of the current fence at the time the ioctl is called by userspace
87 * regardless of whether that operation is an immediate host-side operation
88 * (signal or reset) or or an operation which is enqueued in some driver
89 * queue. &DRM_IOCTL_SYNCOBJ_RESET and &DRM_IOCTL_SYNCOBJ_SIGNAL can be used
90 * to manipulate a syncobj from the host by resetting its pointer to NULL or
91 * setting its pointer to a fence which is already signaled.
93 * With a timeline syncobj, all manipulation of the synobj's fence happens in
94 * terms of a u64 value referring to point in the timeline. See
95 * dma_fence_chain_find_seqno() to see how a given point is found in the
98 * Note that applications should be careful to always use timeline set of
99 * ioctl() when dealing with syncobj considered as timeline. Using a binary
100 * set of ioctl() with a syncobj considered as timeline could result incorrect
101 * synchronization. The use of binary syncobj is supported through the
102 * timeline set of ioctl() by using a point value of 0, this will reproduce
103 * the behavior of the binary set of ioctl() (for example replace the
104 * syncobj's fence when signaling).
107 * Host-side wait on syncobjs
108 * --------------------------
110 * &DRM_IOCTL_SYNCOBJ_WAIT takes an array of syncobj handles and does a
111 * host-side wait on all of the syncobj fences simultaneously.
112 * If &DRM_SYNCOBJ_WAIT_FLAGS_WAIT_ALL is set, the wait ioctl will wait on
113 * all of the syncobj fences to be signaled before it returns.
114 * Otherwise, it returns once at least one syncobj fence has been signaled
115 * and the index of a signaled fence is written back to the client.
117 * Unlike the enqueued GPU work dependencies which fail if they see a NULL
118 * fence in a syncobj, if &DRM_SYNCOBJ_WAIT_FLAGS_WAIT_FOR_SUBMIT is set,
119 * the host-side wait will first wait for the syncobj to receive a non-NULL
120 * fence and then wait on that fence.
121 * If &DRM_SYNCOBJ_WAIT_FLAGS_WAIT_FOR_SUBMIT is not set and any one of the
122 * syncobjs in the array has a NULL fence, -EINVAL will be returned.
123 * Assuming the syncobj starts off with a NULL fence, this allows a client
124 * to do a host wait in one thread (or process) which waits on GPU work
125 * submitted in another thread (or process) without having to manually
126 * synchronize between the two.
127 * This requirement is inherited from the Vulkan fence API.
129 * Similarly, &DRM_IOCTL_SYNCOBJ_TIMELINE_WAIT takes an array of syncobj
130 * handles as well as an array of u64 points and does a host-side wait on all
131 * of syncobj fences at the given points simultaneously.
133 * &DRM_IOCTL_SYNCOBJ_TIMELINE_WAIT also adds the ability to wait for a given
134 * fence to materialize on the timeline without waiting for the fence to be
135 * signaled by using the &DRM_SYNCOBJ_WAIT_FLAGS_WAIT_AVAILABLE flag. This
136 * requirement is inherited from the wait-before-signal behavior required by
137 * the Vulkan timeline semaphore API.
140 * Import/export of syncobjs
141 * -------------------------
143 * &DRM_IOCTL_SYNCOBJ_FD_TO_HANDLE and &DRM_IOCTL_SYNCOBJ_HANDLE_TO_FD
144 * provide two mechanisms for import/export of syncobjs.
146 * The first lets the client import or export an entire syncobj to a file
148 * These fd's are opaque and have no other use case, except passing the
149 * syncobj between processes.
150 * All exported file descriptors and any syncobj handles created as a
151 * result of importing those file descriptors own a reference to the
152 * same underlying struct &drm_syncobj and the syncobj can be used
153 * persistently across all the processes with which it is shared.
154 * The syncobj is freed only once the last reference is dropped.
155 * Unlike dma-buf, importing a syncobj creates a new handle (with its own
156 * reference) for every import instead of de-duplicating.
157 * The primary use-case of this persistent import/export is for shared
158 * Vulkan fences and semaphores.
160 * The second import/export mechanism, which is indicated by
161 * &DRM_SYNCOBJ_FD_TO_HANDLE_FLAGS_IMPORT_SYNC_FILE or
162 * &DRM_SYNCOBJ_HANDLE_TO_FD_FLAGS_EXPORT_SYNC_FILE lets the client
163 * import/export the syncobj's current fence from/to a &sync_file.
164 * When a syncobj is exported to a sync file, that sync file wraps the
165 * sycnobj's fence at the time of export and any later signal or reset
166 * operations on the syncobj will not affect the exported sync file.
167 * When a sync file is imported into a syncobj, the syncobj's fence is set
168 * to the fence wrapped by that sync file.
169 * Because sync files are immutable, resetting or signaling the syncobj
170 * will not affect any sync files whose fences have been imported into the
174 * Import/export of timeline points in timeline syncobjs
175 * -----------------------------------------------------
177 * &DRM_IOCTL_SYNCOBJ_TRANSFER provides a mechanism to transfer a struct
178 * &dma_fence_chain of a syncobj at a given u64 point to another u64 point
179 * into another syncobj.
181 * Note that if you want to transfer a struct &dma_fence_chain from a given
182 * point on a timeline syncobj from/into a binary syncobj, you can use the
183 * point 0 to mean take/replace the fence in the syncobj.
186 #include <linux/anon_inodes.h>
187 #include <linux/file.h>
188 #include <linux/fs.h>
189 #include <linux/sched/signal.h>
190 #include <linux/sync_file.h>
191 #include <linux/uaccess.h>
194 #include <drm/drm_drv.h>
195 #include <drm/drm_file.h>
196 #include <drm/drm_gem.h>
197 #include <drm/drm_print.h>
198 #include <drm/drm_syncobj.h>
199 #include <drm/drm_utils.h>
201 #include "drm_internal.h"
203 struct syncobj_wait_entry
{
204 struct list_head node
;
205 struct task_struct
*task
;
206 struct dma_fence
*fence
;
207 struct dma_fence_cb fence_cb
;
211 static void syncobj_wait_syncobj_func(struct drm_syncobj
*syncobj
,
212 struct syncobj_wait_entry
*wait
);
215 * drm_syncobj_find - lookup and reference a sync object.
216 * @file_private: drm file private pointer
217 * @handle: sync object handle to lookup.
219 * Returns a reference to the syncobj pointed to by handle or NULL. The
220 * reference must be released by calling drm_syncobj_put().
222 struct drm_syncobj
*drm_syncobj_find(struct drm_file
*file_private
,
225 struct drm_syncobj
*syncobj
;
227 spin_lock(&file_private
->syncobj_table_lock
);
229 /* Check if we currently have a reference on the object */
230 syncobj
= idr_find(&file_private
->syncobj_idr
, handle
);
232 drm_syncobj_get(syncobj
);
234 spin_unlock(&file_private
->syncobj_table_lock
);
238 EXPORT_SYMBOL(drm_syncobj_find
);
240 static void drm_syncobj_fence_add_wait(struct drm_syncobj
*syncobj
,
241 struct syncobj_wait_entry
*wait
)
243 struct dma_fence
*fence
;
248 spin_lock(&syncobj
->lock
);
249 /* We've already tried once to get a fence and failed. Now that we
250 * have the lock, try one more time just to be sure we don't add a
251 * callback when a fence has already been set.
253 fence
= dma_fence_get(rcu_dereference_protected(syncobj
->fence
, 1));
254 if (!fence
|| dma_fence_chain_find_seqno(&fence
, wait
->point
)) {
255 dma_fence_put(fence
);
256 list_add_tail(&wait
->node
, &syncobj
->cb_list
);
258 wait
->fence
= dma_fence_get_stub();
262 spin_unlock(&syncobj
->lock
);
265 static void drm_syncobj_remove_wait(struct drm_syncobj
*syncobj
,
266 struct syncobj_wait_entry
*wait
)
268 if (!wait
->node
.next
)
271 spin_lock(&syncobj
->lock
);
272 list_del_init(&wait
->node
);
273 spin_unlock(&syncobj
->lock
);
277 * drm_syncobj_add_point - add new timeline point to the syncobj
278 * @syncobj: sync object to add timeline point do
279 * @chain: chain node to use to add the point
280 * @fence: fence to encapsulate in the chain node
281 * @point: sequence number to use for the point
283 * Add the chain node as new timeline point to the syncobj.
285 void drm_syncobj_add_point(struct drm_syncobj
*syncobj
,
286 struct dma_fence_chain
*chain
,
287 struct dma_fence
*fence
,
290 struct syncobj_wait_entry
*cur
, *tmp
;
291 struct dma_fence
*prev
;
293 dma_fence_get(fence
);
295 spin_lock(&syncobj
->lock
);
297 prev
= drm_syncobj_fence_get(syncobj
);
298 /* You are adding an unorder point to timeline, which could cause payload returned from query_ioctl is 0! */
299 if (prev
&& prev
->seqno
>= point
)
300 DRM_DEBUG("You are adding an unorder point to timeline!\n");
301 dma_fence_chain_init(chain
, prev
, fence
, point
);
302 rcu_assign_pointer(syncobj
->fence
, &chain
->base
);
304 list_for_each_entry_safe(cur
, tmp
, &syncobj
->cb_list
, node
)
305 syncobj_wait_syncobj_func(syncobj
, cur
);
306 spin_unlock(&syncobj
->lock
);
308 /* Walk the chain once to trigger garbage collection */
309 dma_fence_chain_for_each(fence
, prev
);
312 EXPORT_SYMBOL(drm_syncobj_add_point
);
315 * drm_syncobj_replace_fence - replace fence in a sync object.
316 * @syncobj: Sync object to replace fence in
317 * @fence: fence to install in sync file.
319 * This replaces the fence on a sync object.
321 void drm_syncobj_replace_fence(struct drm_syncobj
*syncobj
,
322 struct dma_fence
*fence
)
324 struct dma_fence
*old_fence
;
325 struct syncobj_wait_entry
*cur
, *tmp
;
328 dma_fence_get(fence
);
330 spin_lock(&syncobj
->lock
);
332 old_fence
= rcu_dereference_protected(syncobj
->fence
,
333 lockdep_is_held(&syncobj
->lock
));
334 rcu_assign_pointer(syncobj
->fence
, fence
);
336 if (fence
!= old_fence
) {
337 list_for_each_entry_safe(cur
, tmp
, &syncobj
->cb_list
, node
)
338 syncobj_wait_syncobj_func(syncobj
, cur
);
341 spin_unlock(&syncobj
->lock
);
343 dma_fence_put(old_fence
);
345 EXPORT_SYMBOL(drm_syncobj_replace_fence
);
348 * drm_syncobj_assign_null_handle - assign a stub fence to the sync object
349 * @syncobj: sync object to assign the fence on
351 * Assign a already signaled stub fence to the sync object.
353 static void drm_syncobj_assign_null_handle(struct drm_syncobj
*syncobj
)
355 struct dma_fence
*fence
= dma_fence_get_stub();
357 drm_syncobj_replace_fence(syncobj
, fence
);
358 dma_fence_put(fence
);
361 /* 5s default for wait submission */
362 #define DRM_SYNCOBJ_WAIT_FOR_SUBMIT_TIMEOUT 5000000000ULL
364 * drm_syncobj_find_fence - lookup and reference the fence in a sync object
365 * @file_private: drm file private pointer
366 * @handle: sync object handle to lookup.
367 * @point: timeline point
368 * @flags: DRM_SYNCOBJ_WAIT_FLAGS_WAIT_FOR_SUBMIT or not
369 * @fence: out parameter for the fence
371 * This is just a convenience function that combines drm_syncobj_find() and
372 * drm_syncobj_fence_get().
374 * Returns 0 on success or a negative error value on failure. On success @fence
375 * contains a reference to the fence, which must be released by calling
378 int drm_syncobj_find_fence(struct drm_file
*file_private
,
379 u32 handle
, u64 point
, u64 flags
,
380 struct dma_fence
**fence
)
382 struct drm_syncobj
*syncobj
= drm_syncobj_find(file_private
, handle
);
383 struct syncobj_wait_entry wait
;
384 u64 timeout
= nsecs_to_jiffies64(DRM_SYNCOBJ_WAIT_FOR_SUBMIT_TIMEOUT
);
390 *fence
= drm_syncobj_fence_get(syncobj
);
391 drm_syncobj_put(syncobj
);
394 ret
= dma_fence_chain_find_seqno(fence
, point
);
397 dma_fence_put(*fence
);
402 if (!(flags
& DRM_SYNCOBJ_WAIT_FLAGS_WAIT_FOR_SUBMIT
))
405 memset(&wait
, 0, sizeof(wait
));
408 drm_syncobj_fence_add_wait(syncobj
, &wait
);
411 set_current_state(TASK_INTERRUPTIBLE
);
421 if (signal_pending(current
)) {
426 timeout
= schedule_timeout(timeout
);
429 __set_current_state(TASK_RUNNING
);
433 drm_syncobj_remove_wait(syncobj
, &wait
);
437 EXPORT_SYMBOL(drm_syncobj_find_fence
);
440 * drm_syncobj_free - free a sync object.
441 * @kref: kref to free.
443 * Only to be called from kref_put in drm_syncobj_put.
445 void drm_syncobj_free(struct kref
*kref
)
447 struct drm_syncobj
*syncobj
= container_of(kref
,
450 drm_syncobj_replace_fence(syncobj
, NULL
);
453 EXPORT_SYMBOL(drm_syncobj_free
);
456 * drm_syncobj_create - create a new syncobj
457 * @out_syncobj: returned syncobj
458 * @flags: DRM_SYNCOBJ_* flags
459 * @fence: if non-NULL, the syncobj will represent this fence
461 * This is the first function to create a sync object. After creating, drivers
462 * probably want to make it available to userspace, either through
463 * drm_syncobj_get_handle() or drm_syncobj_get_fd().
465 * Returns 0 on success or a negative error value on failure.
467 int drm_syncobj_create(struct drm_syncobj
**out_syncobj
, uint32_t flags
,
468 struct dma_fence
*fence
)
470 struct drm_syncobj
*syncobj
;
472 syncobj
= kzalloc(sizeof(struct drm_syncobj
), GFP_KERNEL
);
476 kref_init(&syncobj
->refcount
);
477 INIT_LIST_HEAD(&syncobj
->cb_list
);
478 spin_lock_init(&syncobj
->lock
);
480 if (flags
& DRM_SYNCOBJ_CREATE_SIGNALED
)
481 drm_syncobj_assign_null_handle(syncobj
);
484 drm_syncobj_replace_fence(syncobj
, fence
);
486 *out_syncobj
= syncobj
;
489 EXPORT_SYMBOL(drm_syncobj_create
);
492 * drm_syncobj_get_handle - get a handle from a syncobj
493 * @file_private: drm file private pointer
494 * @syncobj: Sync object to export
495 * @handle: out parameter with the new handle
497 * Exports a sync object created with drm_syncobj_create() as a handle on
498 * @file_private to userspace.
500 * Returns 0 on success or a negative error value on failure.
502 int drm_syncobj_get_handle(struct drm_file
*file_private
,
503 struct drm_syncobj
*syncobj
, u32
*handle
)
507 /* take a reference to put in the idr */
508 drm_syncobj_get(syncobj
);
510 idr_preload(GFP_KERNEL
);
511 spin_lock(&file_private
->syncobj_table_lock
);
512 ret
= idr_alloc(&file_private
->syncobj_idr
, syncobj
, 1, 0, GFP_NOWAIT
);
513 spin_unlock(&file_private
->syncobj_table_lock
);
518 drm_syncobj_put(syncobj
);
525 EXPORT_SYMBOL(drm_syncobj_get_handle
);
527 static int drm_syncobj_create_as_handle(struct drm_file
*file_private
,
528 u32
*handle
, uint32_t flags
)
531 struct drm_syncobj
*syncobj
;
533 ret
= drm_syncobj_create(&syncobj
, flags
, NULL
);
537 ret
= drm_syncobj_get_handle(file_private
, syncobj
, handle
);
538 drm_syncobj_put(syncobj
);
542 static int drm_syncobj_destroy(struct drm_file
*file_private
,
545 struct drm_syncobj
*syncobj
;
547 spin_lock(&file_private
->syncobj_table_lock
);
548 syncobj
= idr_remove(&file_private
->syncobj_idr
, handle
);
549 spin_unlock(&file_private
->syncobj_table_lock
);
554 drm_syncobj_put(syncobj
);
558 static int drm_syncobj_file_release(struct inode
*inode
, struct file
*file
)
560 struct drm_syncobj
*syncobj
= file
->private_data
;
562 drm_syncobj_put(syncobj
);
566 static const struct file_operations drm_syncobj_file_fops
= {
567 .release
= drm_syncobj_file_release
,
571 * drm_syncobj_get_fd - get a file descriptor from a syncobj
572 * @syncobj: Sync object to export
573 * @p_fd: out parameter with the new file descriptor
575 * Exports a sync object created with drm_syncobj_create() as a file descriptor.
577 * Returns 0 on success or a negative error value on failure.
579 int drm_syncobj_get_fd(struct drm_syncobj
*syncobj
, int *p_fd
)
584 fd
= get_unused_fd_flags(O_CLOEXEC
);
588 file
= anon_inode_getfile("syncobj_file",
589 &drm_syncobj_file_fops
,
593 return PTR_ERR(file
);
596 drm_syncobj_get(syncobj
);
597 fd_install(fd
, file
);
602 EXPORT_SYMBOL(drm_syncobj_get_fd
);
604 static int drm_syncobj_handle_to_fd(struct drm_file
*file_private
,
605 u32 handle
, int *p_fd
)
607 struct drm_syncobj
*syncobj
= drm_syncobj_find(file_private
, handle
);
613 ret
= drm_syncobj_get_fd(syncobj
, p_fd
);
614 drm_syncobj_put(syncobj
);
618 static int drm_syncobj_fd_to_handle(struct drm_file
*file_private
,
621 struct drm_syncobj
*syncobj
;
622 struct fd f
= fdget(fd
);
628 if (f
.file
->f_op
!= &drm_syncobj_file_fops
) {
633 /* take a reference to put in the idr */
634 syncobj
= f
.file
->private_data
;
635 drm_syncobj_get(syncobj
);
637 idr_preload(GFP_KERNEL
);
638 spin_lock(&file_private
->syncobj_table_lock
);
639 ret
= idr_alloc(&file_private
->syncobj_idr
, syncobj
, 1, 0, GFP_NOWAIT
);
640 spin_unlock(&file_private
->syncobj_table_lock
);
647 drm_syncobj_put(syncobj
);
653 static int drm_syncobj_import_sync_file_fence(struct drm_file
*file_private
,
656 struct dma_fence
*fence
= sync_file_get_fence(fd
);
657 struct drm_syncobj
*syncobj
;
662 syncobj
= drm_syncobj_find(file_private
, handle
);
664 dma_fence_put(fence
);
668 drm_syncobj_replace_fence(syncobj
, fence
);
669 dma_fence_put(fence
);
670 drm_syncobj_put(syncobj
);
674 static int drm_syncobj_export_sync_file(struct drm_file
*file_private
,
675 int handle
, int *p_fd
)
678 struct dma_fence
*fence
;
679 struct sync_file
*sync_file
;
680 int fd
= get_unused_fd_flags(O_CLOEXEC
);
685 ret
= drm_syncobj_find_fence(file_private
, handle
, 0, 0, &fence
);
689 sync_file
= sync_file_create(fence
);
691 dma_fence_put(fence
);
698 fd_install(fd
, sync_file
->file
);
707 * drm_syncobj_open - initalizes syncobj file-private structures at devnode open time
708 * @file_private: drm file-private structure to set up
710 * Called at device open time, sets up the structure for handling refcounting
714 drm_syncobj_open(struct drm_file
*file_private
)
716 idr_init_base(&file_private
->syncobj_idr
, 1);
717 spin_lock_init(&file_private
->syncobj_table_lock
);
721 drm_syncobj_release_handle(int id
, void *ptr
, void *data
)
723 struct drm_syncobj
*syncobj
= ptr
;
725 drm_syncobj_put(syncobj
);
730 * drm_syncobj_release - release file-private sync object resources
731 * @file_private: drm file-private structure to clean up
733 * Called at close time when the filp is going away.
735 * Releases any remaining references on objects by this filp.
738 drm_syncobj_release(struct drm_file
*file_private
)
740 idr_for_each(&file_private
->syncobj_idr
,
741 &drm_syncobj_release_handle
, file_private
);
742 idr_destroy(&file_private
->syncobj_idr
);
746 drm_syncobj_create_ioctl(struct drm_device
*dev
, void *data
,
747 struct drm_file
*file_private
)
749 struct drm_syncobj_create
*args
= data
;
751 if (!drm_core_check_feature(dev
, DRIVER_SYNCOBJ
))
754 /* no valid flags yet */
755 if (args
->flags
& ~DRM_SYNCOBJ_CREATE_SIGNALED
)
758 return drm_syncobj_create_as_handle(file_private
,
759 &args
->handle
, args
->flags
);
763 drm_syncobj_destroy_ioctl(struct drm_device
*dev
, void *data
,
764 struct drm_file
*file_private
)
766 struct drm_syncobj_destroy
*args
= data
;
768 if (!drm_core_check_feature(dev
, DRIVER_SYNCOBJ
))
771 /* make sure padding is empty */
774 return drm_syncobj_destroy(file_private
, args
->handle
);
778 drm_syncobj_handle_to_fd_ioctl(struct drm_device
*dev
, void *data
,
779 struct drm_file
*file_private
)
781 struct drm_syncobj_handle
*args
= data
;
783 if (!drm_core_check_feature(dev
, DRIVER_SYNCOBJ
))
789 if (args
->flags
!= 0 &&
790 args
->flags
!= DRM_SYNCOBJ_HANDLE_TO_FD_FLAGS_EXPORT_SYNC_FILE
)
793 if (args
->flags
& DRM_SYNCOBJ_HANDLE_TO_FD_FLAGS_EXPORT_SYNC_FILE
)
794 return drm_syncobj_export_sync_file(file_private
, args
->handle
,
797 return drm_syncobj_handle_to_fd(file_private
, args
->handle
,
802 drm_syncobj_fd_to_handle_ioctl(struct drm_device
*dev
, void *data
,
803 struct drm_file
*file_private
)
805 struct drm_syncobj_handle
*args
= data
;
807 if (!drm_core_check_feature(dev
, DRIVER_SYNCOBJ
))
813 if (args
->flags
!= 0 &&
814 args
->flags
!= DRM_SYNCOBJ_FD_TO_HANDLE_FLAGS_IMPORT_SYNC_FILE
)
817 if (args
->flags
& DRM_SYNCOBJ_FD_TO_HANDLE_FLAGS_IMPORT_SYNC_FILE
)
818 return drm_syncobj_import_sync_file_fence(file_private
,
822 return drm_syncobj_fd_to_handle(file_private
, args
->fd
,
826 static int drm_syncobj_transfer_to_timeline(struct drm_file
*file_private
,
827 struct drm_syncobj_transfer
*args
)
829 struct drm_syncobj
*timeline_syncobj
= NULL
;
830 struct dma_fence
*fence
;
831 struct dma_fence_chain
*chain
;
834 timeline_syncobj
= drm_syncobj_find(file_private
, args
->dst_handle
);
835 if (!timeline_syncobj
) {
838 ret
= drm_syncobj_find_fence(file_private
, args
->src_handle
,
839 args
->src_point
, args
->flags
,
843 chain
= kzalloc(sizeof(struct dma_fence_chain
), GFP_KERNEL
);
848 drm_syncobj_add_point(timeline_syncobj
, chain
, fence
, args
->dst_point
);
850 dma_fence_put(fence
);
852 drm_syncobj_put(timeline_syncobj
);
858 drm_syncobj_transfer_to_binary(struct drm_file
*file_private
,
859 struct drm_syncobj_transfer
*args
)
861 struct drm_syncobj
*binary_syncobj
= NULL
;
862 struct dma_fence
*fence
;
865 binary_syncobj
= drm_syncobj_find(file_private
, args
->dst_handle
);
868 ret
= drm_syncobj_find_fence(file_private
, args
->src_handle
,
869 args
->src_point
, args
->flags
, &fence
);
872 drm_syncobj_replace_fence(binary_syncobj
, fence
);
873 dma_fence_put(fence
);
875 drm_syncobj_put(binary_syncobj
);
880 drm_syncobj_transfer_ioctl(struct drm_device
*dev
, void *data
,
881 struct drm_file
*file_private
)
883 struct drm_syncobj_transfer
*args
= data
;
886 if (!drm_core_check_feature(dev
, DRIVER_SYNCOBJ_TIMELINE
))
893 ret
= drm_syncobj_transfer_to_timeline(file_private
, args
);
895 ret
= drm_syncobj_transfer_to_binary(file_private
, args
);
900 static void syncobj_wait_fence_func(struct dma_fence
*fence
,
901 struct dma_fence_cb
*cb
)
903 struct syncobj_wait_entry
*wait
=
904 container_of(cb
, struct syncobj_wait_entry
, fence_cb
);
906 wake_up_process(wait
->task
);
909 static void syncobj_wait_syncobj_func(struct drm_syncobj
*syncobj
,
910 struct syncobj_wait_entry
*wait
)
912 struct dma_fence
*fence
;
914 /* This happens inside the syncobj lock */
915 fence
= rcu_dereference_protected(syncobj
->fence
,
916 lockdep_is_held(&syncobj
->lock
));
917 dma_fence_get(fence
);
918 if (!fence
|| dma_fence_chain_find_seqno(&fence
, wait
->point
)) {
919 dma_fence_put(fence
);
922 wait
->fence
= dma_fence_get_stub();
927 wake_up_process(wait
->task
);
928 list_del_init(&wait
->node
);
931 static signed long drm_syncobj_array_wait_timeout(struct drm_syncobj
**syncobjs
,
932 void __user
*user_points
,
938 struct syncobj_wait_entry
*entries
;
939 struct dma_fence
*fence
;
941 uint32_t signaled_count
, i
;
943 points
= kmalloc_array(count
, sizeof(*points
), GFP_KERNEL
);
948 memset(points
, 0, count
* sizeof(uint64_t));
950 } else if (copy_from_user(points
, user_points
,
951 sizeof(uint64_t) * count
)) {
953 goto err_free_points
;
956 entries
= kcalloc(count
, sizeof(*entries
), GFP_KERNEL
);
959 goto err_free_points
;
961 /* Walk the list of sync objects and initialize entries. We do
962 * this up-front so that we can properly return -EINVAL if there is
963 * a syncobj with a missing fence and then never have the chance of
964 * returning -EINVAL again.
967 for (i
= 0; i
< count
; ++i
) {
968 struct dma_fence
*fence
;
970 entries
[i
].task
= current
;
971 entries
[i
].point
= points
[i
];
972 fence
= drm_syncobj_fence_get(syncobjs
[i
]);
973 if (!fence
|| dma_fence_chain_find_seqno(&fence
, points
[i
])) {
974 dma_fence_put(fence
);
975 if (flags
& DRM_SYNCOBJ_WAIT_FLAGS_WAIT_FOR_SUBMIT
) {
979 goto cleanup_entries
;
984 entries
[i
].fence
= fence
;
986 entries
[i
].fence
= dma_fence_get_stub();
988 if ((flags
& DRM_SYNCOBJ_WAIT_FLAGS_WAIT_AVAILABLE
) ||
989 dma_fence_is_signaled(entries
[i
].fence
)) {
990 if (signaled_count
== 0 && idx
)
996 if (signaled_count
== count
||
997 (signaled_count
> 0 &&
998 !(flags
& DRM_SYNCOBJ_WAIT_FLAGS_WAIT_ALL
)))
999 goto cleanup_entries
;
1001 /* There's a very annoying laxness in the dma_fence API here, in
1002 * that backends are not required to automatically report when a
1003 * fence is signaled prior to fence->ops->enable_signaling() being
1004 * called. So here if we fail to match signaled_count, we need to
1005 * fallthough and try a 0 timeout wait!
1008 if (flags
& DRM_SYNCOBJ_WAIT_FLAGS_WAIT_FOR_SUBMIT
) {
1009 for (i
= 0; i
< count
; ++i
)
1010 drm_syncobj_fence_add_wait(syncobjs
[i
], &entries
[i
]);
1014 set_current_state(TASK_INTERRUPTIBLE
);
1017 for (i
= 0; i
< count
; ++i
) {
1018 fence
= entries
[i
].fence
;
1022 if ((flags
& DRM_SYNCOBJ_WAIT_FLAGS_WAIT_AVAILABLE
) ||
1023 dma_fence_is_signaled(fence
) ||
1024 (!entries
[i
].fence_cb
.func
&&
1025 dma_fence_add_callback(fence
,
1026 &entries
[i
].fence_cb
,
1027 syncobj_wait_fence_func
))) {
1028 /* The fence has been signaled */
1029 if (flags
& DRM_SYNCOBJ_WAIT_FLAGS_WAIT_ALL
) {
1039 if (signaled_count
== count
)
1047 if (signal_pending(current
)) {
1048 timeout
= -ERESTARTSYS
;
1052 timeout
= schedule_timeout(timeout
);
1056 __set_current_state(TASK_RUNNING
);
1059 for (i
= 0; i
< count
; ++i
) {
1060 drm_syncobj_remove_wait(syncobjs
[i
], &entries
[i
]);
1061 if (entries
[i
].fence_cb
.func
)
1062 dma_fence_remove_callback(entries
[i
].fence
,
1063 &entries
[i
].fence_cb
);
1064 dma_fence_put(entries
[i
].fence
);
1075 * drm_timeout_abs_to_jiffies - calculate jiffies timeout from absolute value
1077 * @timeout_nsec: timeout nsec component in ns, 0 for poll
1079 * Calculate the timeout in jiffies from an absolute time in sec/nsec.
1081 signed long drm_timeout_abs_to_jiffies(int64_t timeout_nsec
)
1083 ktime_t abs_timeout
, now
;
1084 u64 timeout_ns
, timeout_jiffies64
;
1086 /* make 0 timeout means poll - absolute 0 doesn't seem valid */
1087 if (timeout_nsec
== 0)
1090 abs_timeout
= ns_to_ktime(timeout_nsec
);
1093 if (!ktime_after(abs_timeout
, now
))
1096 timeout_ns
= ktime_to_ns(ktime_sub(abs_timeout
, now
));
1098 timeout_jiffies64
= nsecs_to_jiffies64(timeout_ns
);
1099 /* clamp timeout to avoid infinite timeout */
1100 if (timeout_jiffies64
>= MAX_SCHEDULE_TIMEOUT
- 1)
1101 return MAX_SCHEDULE_TIMEOUT
- 1;
1103 return timeout_jiffies64
+ 1;
1105 EXPORT_SYMBOL(drm_timeout_abs_to_jiffies
);
1107 static int drm_syncobj_array_wait(struct drm_device
*dev
,
1108 struct drm_file
*file_private
,
1109 struct drm_syncobj_wait
*wait
,
1110 struct drm_syncobj_timeline_wait
*timeline_wait
,
1111 struct drm_syncobj
**syncobjs
, bool timeline
)
1113 signed long timeout
= 0;
1114 uint32_t first
= ~0;
1117 timeout
= drm_timeout_abs_to_jiffies(wait
->timeout_nsec
);
1118 timeout
= drm_syncobj_array_wait_timeout(syncobjs
,
1120 wait
->count_handles
,
1125 wait
->first_signaled
= first
;
1127 timeout
= drm_timeout_abs_to_jiffies(timeline_wait
->timeout_nsec
);
1128 timeout
= drm_syncobj_array_wait_timeout(syncobjs
,
1129 u64_to_user_ptr(timeline_wait
->points
),
1130 timeline_wait
->count_handles
,
1131 timeline_wait
->flags
,
1135 timeline_wait
->first_signaled
= first
;
1140 static int drm_syncobj_array_find(struct drm_file
*file_private
,
1141 void __user
*user_handles
,
1142 uint32_t count_handles
,
1143 struct drm_syncobj
***syncobjs_out
)
1145 uint32_t i
, *handles
;
1146 struct drm_syncobj
**syncobjs
;
1149 handles
= kmalloc_array(count_handles
, sizeof(*handles
), GFP_KERNEL
);
1150 if (handles
== NULL
)
1153 if (copy_from_user(handles
, user_handles
,
1154 sizeof(uint32_t) * count_handles
)) {
1156 goto err_free_handles
;
1159 syncobjs
= kmalloc_array(count_handles
, sizeof(*syncobjs
), GFP_KERNEL
);
1160 if (syncobjs
== NULL
) {
1162 goto err_free_handles
;
1165 for (i
= 0; i
< count_handles
; i
++) {
1166 syncobjs
[i
] = drm_syncobj_find(file_private
, handles
[i
]);
1169 goto err_put_syncobjs
;
1174 *syncobjs_out
= syncobjs
;
1179 drm_syncobj_put(syncobjs
[i
]);
1187 static void drm_syncobj_array_free(struct drm_syncobj
**syncobjs
,
1192 for (i
= 0; i
< count
; i
++)
1193 drm_syncobj_put(syncobjs
[i
]);
1198 drm_syncobj_wait_ioctl(struct drm_device
*dev
, void *data
,
1199 struct drm_file
*file_private
)
1201 struct drm_syncobj_wait
*args
= data
;
1202 struct drm_syncobj
**syncobjs
;
1205 if (!drm_core_check_feature(dev
, DRIVER_SYNCOBJ
))
1208 if (args
->flags
& ~(DRM_SYNCOBJ_WAIT_FLAGS_WAIT_ALL
|
1209 DRM_SYNCOBJ_WAIT_FLAGS_WAIT_FOR_SUBMIT
))
1212 if (args
->count_handles
== 0)
1215 ret
= drm_syncobj_array_find(file_private
,
1216 u64_to_user_ptr(args
->handles
),
1217 args
->count_handles
,
1222 ret
= drm_syncobj_array_wait(dev
, file_private
,
1223 args
, NULL
, syncobjs
, false);
1225 drm_syncobj_array_free(syncobjs
, args
->count_handles
);
1231 drm_syncobj_timeline_wait_ioctl(struct drm_device
*dev
, void *data
,
1232 struct drm_file
*file_private
)
1234 struct drm_syncobj_timeline_wait
*args
= data
;
1235 struct drm_syncobj
**syncobjs
;
1238 if (!drm_core_check_feature(dev
, DRIVER_SYNCOBJ_TIMELINE
))
1241 if (args
->flags
& ~(DRM_SYNCOBJ_WAIT_FLAGS_WAIT_ALL
|
1242 DRM_SYNCOBJ_WAIT_FLAGS_WAIT_FOR_SUBMIT
|
1243 DRM_SYNCOBJ_WAIT_FLAGS_WAIT_AVAILABLE
))
1246 if (args
->count_handles
== 0)
1249 ret
= drm_syncobj_array_find(file_private
,
1250 u64_to_user_ptr(args
->handles
),
1251 args
->count_handles
,
1256 ret
= drm_syncobj_array_wait(dev
, file_private
,
1257 NULL
, args
, syncobjs
, true);
1259 drm_syncobj_array_free(syncobjs
, args
->count_handles
);
1266 drm_syncobj_reset_ioctl(struct drm_device
*dev
, void *data
,
1267 struct drm_file
*file_private
)
1269 struct drm_syncobj_array
*args
= data
;
1270 struct drm_syncobj
**syncobjs
;
1274 if (!drm_core_check_feature(dev
, DRIVER_SYNCOBJ
))
1280 if (args
->count_handles
== 0)
1283 ret
= drm_syncobj_array_find(file_private
,
1284 u64_to_user_ptr(args
->handles
),
1285 args
->count_handles
,
1290 for (i
= 0; i
< args
->count_handles
; i
++)
1291 drm_syncobj_replace_fence(syncobjs
[i
], NULL
);
1293 drm_syncobj_array_free(syncobjs
, args
->count_handles
);
1299 drm_syncobj_signal_ioctl(struct drm_device
*dev
, void *data
,
1300 struct drm_file
*file_private
)
1302 struct drm_syncobj_array
*args
= data
;
1303 struct drm_syncobj
**syncobjs
;
1307 if (!drm_core_check_feature(dev
, DRIVER_SYNCOBJ
))
1313 if (args
->count_handles
== 0)
1316 ret
= drm_syncobj_array_find(file_private
,
1317 u64_to_user_ptr(args
->handles
),
1318 args
->count_handles
,
1323 for (i
= 0; i
< args
->count_handles
; i
++)
1324 drm_syncobj_assign_null_handle(syncobjs
[i
]);
1326 drm_syncobj_array_free(syncobjs
, args
->count_handles
);
1332 drm_syncobj_timeline_signal_ioctl(struct drm_device
*dev
, void *data
,
1333 struct drm_file
*file_private
)
1335 struct drm_syncobj_timeline_array
*args
= data
;
1336 struct drm_syncobj
**syncobjs
;
1337 struct dma_fence_chain
**chains
;
1342 if (!drm_core_check_feature(dev
, DRIVER_SYNCOBJ_TIMELINE
))
1345 if (args
->flags
!= 0)
1348 if (args
->count_handles
== 0)
1351 ret
= drm_syncobj_array_find(file_private
,
1352 u64_to_user_ptr(args
->handles
),
1353 args
->count_handles
,
1358 points
= kmalloc_array(args
->count_handles
, sizeof(*points
),
1364 if (!u64_to_user_ptr(args
->points
)) {
1365 memset(points
, 0, args
->count_handles
* sizeof(uint64_t));
1366 } else if (copy_from_user(points
, u64_to_user_ptr(args
->points
),
1367 sizeof(uint64_t) * args
->count_handles
)) {
1372 chains
= kmalloc_array(args
->count_handles
, sizeof(void *), GFP_KERNEL
);
1377 for (i
= 0; i
< args
->count_handles
; i
++) {
1378 chains
[i
] = kzalloc(sizeof(struct dma_fence_chain
), GFP_KERNEL
);
1380 for (j
= 0; j
< i
; j
++)
1387 for (i
= 0; i
< args
->count_handles
; i
++) {
1388 struct dma_fence
*fence
= dma_fence_get_stub();
1390 drm_syncobj_add_point(syncobjs
[i
], chains
[i
],
1392 dma_fence_put(fence
);
1399 drm_syncobj_array_free(syncobjs
, args
->count_handles
);
1404 int drm_syncobj_query_ioctl(struct drm_device
*dev
, void *data
,
1405 struct drm_file
*file_private
)
1407 struct drm_syncobj_timeline_array
*args
= data
;
1408 struct drm_syncobj
**syncobjs
;
1409 uint64_t __user
*points
= u64_to_user_ptr(args
->points
);
1413 if (!drm_core_check_feature(dev
, DRIVER_SYNCOBJ_TIMELINE
))
1416 if (args
->flags
& ~DRM_SYNCOBJ_QUERY_FLAGS_LAST_SUBMITTED
)
1419 if (args
->count_handles
== 0)
1422 ret
= drm_syncobj_array_find(file_private
,
1423 u64_to_user_ptr(args
->handles
),
1424 args
->count_handles
,
1429 for (i
= 0; i
< args
->count_handles
; i
++) {
1430 struct dma_fence_chain
*chain
;
1431 struct dma_fence
*fence
;
1434 fence
= drm_syncobj_fence_get(syncobjs
[i
]);
1435 chain
= to_dma_fence_chain(fence
);
1437 struct dma_fence
*iter
, *last_signaled
=
1438 dma_fence_get(fence
);
1441 DRM_SYNCOBJ_QUERY_FLAGS_LAST_SUBMITTED
) {
1442 point
= fence
->seqno
;
1444 dma_fence_chain_for_each(iter
, fence
) {
1445 if (iter
->context
!= fence
->context
) {
1446 dma_fence_put(iter
);
1447 /* It is most likely that timeline has
1448 * unorder points. */
1451 dma_fence_put(last_signaled
);
1452 last_signaled
= dma_fence_get(iter
);
1454 point
= dma_fence_is_signaled(last_signaled
) ?
1455 last_signaled
->seqno
:
1456 to_dma_fence_chain(last_signaled
)->prev_seqno
;
1458 dma_fence_put(last_signaled
);
1462 dma_fence_put(fence
);
1463 ret
= copy_to_user(&points
[i
], &point
, sizeof(uint64_t));
1464 ret
= ret
? -EFAULT
: 0;
1468 drm_syncobj_array_free(syncobjs
, args
->count_handles
);