1 // SPDX-License-Identifier: GPL-2.0-only
3 * Sync File validation framework
5 * Copyright (C) 2012 Google, Inc.
8 #include <linux/file.h>
10 #include <linux/uaccess.h>
11 #include <linux/slab.h>
12 #include <linux/sync_file.h>
14 #include "sync_debug.h"
16 #define CREATE_TRACE_POINTS
17 #include "sync_trace.h"
20 * SW SYNC validation framework
22 * A sync object driver that uses a 32bit counter to coordinate
23 * synchronization. Useful when there is no hardware primitive backing
24 * the synchronization.
26 * To start the framework just open:
28 * <debugfs>/sync/sw_sync
30 * That will create a sync timeline, all fences created under this timeline
31 * file descriptor will belong to the this timeline.
33 * The 'sw_sync' file can be opened many times as to create different
36 * Fences can be created with SW_SYNC_IOC_CREATE_FENCE ioctl with struct
37 * sw_sync_create_fence_data as parameter.
39 * To increment the timeline counter, SW_SYNC_IOC_INC ioctl should be used
40 * with the increment as u32. This will update the last signaled value
41 * from the timeline and signal any fence that has a seqno smaller or equal
44 * struct sw_sync_create_fence_data
45 * @value: the seqno to initialise the fence with
46 * @name: the name of the new sync point
47 * @fence: return the fd of the new sync_file with the created fence
49 struct sw_sync_create_fence_data
{
52 __s32 fence
; /* fd of new fence */
55 #define SW_SYNC_IOC_MAGIC 'W'
57 #define SW_SYNC_IOC_CREATE_FENCE _IOWR(SW_SYNC_IOC_MAGIC, 0,\
58 struct sw_sync_create_fence_data)
60 #define SW_SYNC_IOC_INC _IOW(SW_SYNC_IOC_MAGIC, 1, __u32)
62 static const struct dma_fence_ops timeline_fence_ops
;
64 static inline struct sync_pt
*dma_fence_to_sync_pt(struct dma_fence
*fence
)
66 if (fence
->ops
!= &timeline_fence_ops
)
68 return container_of(fence
, struct sync_pt
, base
);
72 * sync_timeline_create() - creates a sync object
73 * @name: sync_timeline name
75 * Creates a new sync_timeline. Returns the sync_timeline object or NULL in
78 static struct sync_timeline
*sync_timeline_create(const char *name
)
80 struct sync_timeline
*obj
;
82 obj
= kzalloc(sizeof(*obj
), GFP_KERNEL
);
86 kref_init(&obj
->kref
);
87 obj
->context
= dma_fence_context_alloc(1);
88 strlcpy(obj
->name
, name
, sizeof(obj
->name
));
90 obj
->pt_tree
= RB_ROOT
;
91 INIT_LIST_HEAD(&obj
->pt_list
);
92 spin_lock_init(&obj
->lock
);
94 sync_timeline_debug_add(obj
);
99 static void sync_timeline_free(struct kref
*kref
)
101 struct sync_timeline
*obj
=
102 container_of(kref
, struct sync_timeline
, kref
);
104 sync_timeline_debug_remove(obj
);
109 static void sync_timeline_get(struct sync_timeline
*obj
)
111 kref_get(&obj
->kref
);
114 static void sync_timeline_put(struct sync_timeline
*obj
)
116 kref_put(&obj
->kref
, sync_timeline_free
);
119 static const char *timeline_fence_get_driver_name(struct dma_fence
*fence
)
124 static const char *timeline_fence_get_timeline_name(struct dma_fence
*fence
)
126 struct sync_timeline
*parent
= dma_fence_parent(fence
);
131 static void timeline_fence_release(struct dma_fence
*fence
)
133 struct sync_pt
*pt
= dma_fence_to_sync_pt(fence
);
134 struct sync_timeline
*parent
= dma_fence_parent(fence
);
137 spin_lock_irqsave(fence
->lock
, flags
);
138 if (!list_empty(&pt
->link
)) {
140 rb_erase(&pt
->node
, &parent
->pt_tree
);
142 spin_unlock_irqrestore(fence
->lock
, flags
);
144 sync_timeline_put(parent
);
145 dma_fence_free(fence
);
148 static bool timeline_fence_signaled(struct dma_fence
*fence
)
150 struct sync_timeline
*parent
= dma_fence_parent(fence
);
152 return !__dma_fence_is_later(fence
->seqno
, parent
->value
, fence
->ops
);
155 static bool timeline_fence_enable_signaling(struct dma_fence
*fence
)
160 static void timeline_fence_value_str(struct dma_fence
*fence
,
163 snprintf(str
, size
, "%lld", fence
->seqno
);
166 static void timeline_fence_timeline_value_str(struct dma_fence
*fence
,
169 struct sync_timeline
*parent
= dma_fence_parent(fence
);
171 snprintf(str
, size
, "%d", parent
->value
);
174 static const struct dma_fence_ops timeline_fence_ops
= {
175 .get_driver_name
= timeline_fence_get_driver_name
,
176 .get_timeline_name
= timeline_fence_get_timeline_name
,
177 .enable_signaling
= timeline_fence_enable_signaling
,
178 .signaled
= timeline_fence_signaled
,
179 .release
= timeline_fence_release
,
180 .fence_value_str
= timeline_fence_value_str
,
181 .timeline_value_str
= timeline_fence_timeline_value_str
,
185 * sync_timeline_signal() - signal a status change on a sync_timeline
186 * @obj: sync_timeline to signal
187 * @inc: num to increment on timeline->value
189 * A sync implementation should call this any time one of it's fences
190 * has signaled or has an error condition.
192 static void sync_timeline_signal(struct sync_timeline
*obj
, unsigned int inc
)
194 struct sync_pt
*pt
, *next
;
196 trace_sync_timeline(obj
);
198 spin_lock_irq(&obj
->lock
);
202 list_for_each_entry_safe(pt
, next
, &obj
->pt_list
, link
) {
203 if (!timeline_fence_signaled(&pt
->base
))
206 list_del_init(&pt
->link
);
207 rb_erase(&pt
->node
, &obj
->pt_tree
);
210 * A signal callback may release the last reference to this
211 * fence, causing it to be freed. That operation has to be
212 * last to avoid a use after free inside this loop, and must
213 * be after we remove the fence from the timeline in order to
214 * prevent deadlocking on timeline->lock inside
215 * timeline_fence_release().
217 dma_fence_signal_locked(&pt
->base
);
220 spin_unlock_irq(&obj
->lock
);
224 * sync_pt_create() - creates a sync pt
225 * @obj: parent sync_timeline
226 * @value: value of the fence
228 * Creates a new sync_pt (fence) as a child of @parent. @size bytes will be
229 * allocated allowing for implementation specific data to be kept after
230 * the generic sync_timeline struct. Returns the sync_pt object or
231 * NULL in case of error.
233 static struct sync_pt
*sync_pt_create(struct sync_timeline
*obj
,
238 pt
= kzalloc(sizeof(*pt
), GFP_KERNEL
);
242 sync_timeline_get(obj
);
243 dma_fence_init(&pt
->base
, &timeline_fence_ops
, &obj
->lock
,
244 obj
->context
, value
);
245 INIT_LIST_HEAD(&pt
->link
);
247 spin_lock_irq(&obj
->lock
);
248 if (!dma_fence_is_signaled_locked(&pt
->base
)) {
249 struct rb_node
**p
= &obj
->pt_tree
.rb_node
;
250 struct rb_node
*parent
= NULL
;
253 struct sync_pt
*other
;
257 other
= rb_entry(parent
, typeof(*pt
), node
);
258 cmp
= value
- other
->base
.seqno
;
260 p
= &parent
->rb_right
;
261 } else if (cmp
< 0) {
262 p
= &parent
->rb_left
;
264 if (dma_fence_get_rcu(&other
->base
)) {
265 sync_timeline_put(obj
);
270 p
= &parent
->rb_left
;
273 rb_link_node(&pt
->node
, parent
, p
);
274 rb_insert_color(&pt
->node
, &obj
->pt_tree
);
276 parent
= rb_next(&pt
->node
);
277 list_add_tail(&pt
->link
,
278 parent
? &rb_entry(parent
, typeof(*pt
), node
)->link
: &obj
->pt_list
);
281 spin_unlock_irq(&obj
->lock
);
289 * improper use of this can result in deadlocking kernel drivers from userspace.
292 /* opening sw_sync create a new sync obj */
293 static int sw_sync_debugfs_open(struct inode
*inode
, struct file
*file
)
295 struct sync_timeline
*obj
;
296 char task_comm
[TASK_COMM_LEN
];
298 get_task_comm(task_comm
, current
);
300 obj
= sync_timeline_create(task_comm
);
304 file
->private_data
= obj
;
309 static int sw_sync_debugfs_release(struct inode
*inode
, struct file
*file
)
311 struct sync_timeline
*obj
= file
->private_data
;
312 struct sync_pt
*pt
, *next
;
314 spin_lock_irq(&obj
->lock
);
316 list_for_each_entry_safe(pt
, next
, &obj
->pt_list
, link
) {
317 dma_fence_set_error(&pt
->base
, -ENOENT
);
318 dma_fence_signal_locked(&pt
->base
);
321 spin_unlock_irq(&obj
->lock
);
323 sync_timeline_put(obj
);
327 static long sw_sync_ioctl_create_fence(struct sync_timeline
*obj
,
330 int fd
= get_unused_fd_flags(O_CLOEXEC
);
333 struct sync_file
*sync_file
;
334 struct sw_sync_create_fence_data data
;
339 if (copy_from_user(&data
, (void __user
*)arg
, sizeof(data
))) {
344 pt
= sync_pt_create(obj
, data
.value
);
350 sync_file
= sync_file_create(&pt
->base
);
351 dma_fence_put(&pt
->base
);
358 if (copy_to_user((void __user
*)arg
, &data
, sizeof(data
))) {
359 fput(sync_file
->file
);
364 fd_install(fd
, sync_file
->file
);
373 static long sw_sync_ioctl_inc(struct sync_timeline
*obj
, unsigned long arg
)
377 if (copy_from_user(&value
, (void __user
*)arg
, sizeof(value
)))
380 while (value
> INT_MAX
) {
381 sync_timeline_signal(obj
, INT_MAX
);
385 sync_timeline_signal(obj
, value
);
390 static long sw_sync_ioctl(struct file
*file
, unsigned int cmd
,
393 struct sync_timeline
*obj
= file
->private_data
;
396 case SW_SYNC_IOC_CREATE_FENCE
:
397 return sw_sync_ioctl_create_fence(obj
, arg
);
399 case SW_SYNC_IOC_INC
:
400 return sw_sync_ioctl_inc(obj
, arg
);
407 const struct file_operations sw_sync_debugfs_fops
= {
408 .open
= sw_sync_debugfs_open
,
409 .release
= sw_sync_debugfs_release
,
410 .unlocked_ioctl
= sw_sync_ioctl
,
411 .compat_ioctl
= compat_ptr_ioctl
,