1 // SPDX-License-Identifier: GPL-2.0-only
3 * fence-chain: chain fences together in a timeline
5 * Copyright (C) 2018 Advanced Micro Devices, Inc.
10 #include <linux/dma-fence-chain.h>
12 static bool dma_fence_chain_enable_signaling(struct dma_fence *fence);
15 * dma_fence_chain_get_prev - use RCU to get a reference to the previous fence
16 * @chain: chain node to get the previous node from
18 * Use dma_fence_get_rcu_safe to get a reference to the previous fence of the
21 static struct dma_fence *dma_fence_chain_get_prev(struct dma_fence_chain *chain)
23 struct dma_fence *prev;
26 prev = dma_fence_get_rcu_safe(&chain->prev);
32 * dma_fence_chain_walk - chain walking function
33 * @fence: current chain node
35 * Walk the chain to the next node. Returns the next fence or NULL if we are at
36 * the end of the chain. Garbage collects chain nodes which are already
39 struct dma_fence *dma_fence_chain_walk(struct dma_fence *fence)
41 struct dma_fence_chain *chain, *prev_chain;
42 struct dma_fence *prev, *replacement, *tmp;
44 chain = to_dma_fence_chain(fence);
50 while ((prev = dma_fence_chain_get_prev(chain))) {
52 prev_chain = to_dma_fence_chain(prev);
54 if (!dma_fence_is_signaled(prev_chain->fence))
57 replacement = dma_fence_chain_get_prev(prev_chain);
59 if (!dma_fence_is_signaled(prev))
65 tmp = cmpxchg((void **)&chain->prev, (void *)prev, (void *)replacement);
69 dma_fence_put(replacement);
76 EXPORT_SYMBOL(dma_fence_chain_walk);
79 * dma_fence_chain_find_seqno - find fence chain node by seqno
80 * @pfence: pointer to the chain node where to start
81 * @seqno: the sequence number to search for
83 * Advance the fence pointer to the chain node which will signal this sequence
84 * number. If no sequence number is provided then this is a no-op.
86 * Returns EINVAL if the fence is not a chain node or the sequence number has
87 * not yet advanced far enough.
89 int dma_fence_chain_find_seqno(struct dma_fence **pfence, uint64_t seqno)
91 struct dma_fence_chain *chain;
96 chain = to_dma_fence_chain(*pfence);
97 if (!chain || chain->base.seqno < seqno)
100 dma_fence_chain_for_each(*pfence, &chain->base) {
101 if ((*pfence)->context != chain->base.context ||
102 to_dma_fence_chain(*pfence)->prev_seqno < seqno)
105 dma_fence_put(&chain->base);
109 EXPORT_SYMBOL(dma_fence_chain_find_seqno);
111 static const char *dma_fence_chain_get_driver_name(struct dma_fence *fence)
113 return "dma_fence_chain";
116 static const char *dma_fence_chain_get_timeline_name(struct dma_fence *fence)
121 static void dma_fence_chain_irq_work(struct irq_work *work)
123 struct dma_fence_chain *chain;
125 chain = container_of(work, typeof(*chain), work);
127 /* Try to rearm the callback */
128 if (!dma_fence_chain_enable_signaling(&chain->base))
129 /* Ok, we are done. No more unsignaled fences left */
130 dma_fence_signal(&chain->base);
131 dma_fence_put(&chain->base);
134 static void dma_fence_chain_cb(struct dma_fence *f, struct dma_fence_cb *cb)
136 struct dma_fence_chain *chain;
138 chain = container_of(cb, typeof(*chain), cb);
139 irq_work_queue(&chain->work);
143 static bool dma_fence_chain_enable_signaling(struct dma_fence *fence)
145 struct dma_fence_chain *head = to_dma_fence_chain(fence);
147 dma_fence_get(&head->base);
148 dma_fence_chain_for_each(fence, &head->base) {
149 struct dma_fence_chain *chain = to_dma_fence_chain(fence);
150 struct dma_fence *f = chain ? chain->fence : fence;
153 if (!dma_fence_add_callback(f, &head->cb, dma_fence_chain_cb)) {
154 dma_fence_put(fence);
159 dma_fence_put(&head->base);
163 static bool dma_fence_chain_signaled(struct dma_fence *fence)
165 dma_fence_chain_for_each(fence, fence) {
166 struct dma_fence_chain *chain = to_dma_fence_chain(fence);
167 struct dma_fence *f = chain ? chain->fence : fence;
169 if (!dma_fence_is_signaled(f)) {
170 dma_fence_put(fence);
178 static void dma_fence_chain_release(struct dma_fence *fence)
180 struct dma_fence_chain *chain = to_dma_fence_chain(fence);
182 dma_fence_put(rcu_dereference_protected(chain->prev, true));
183 dma_fence_put(chain->fence);
184 dma_fence_free(fence);
187 const struct dma_fence_ops dma_fence_chain_ops = {
188 .use_64bit_seqno = true,
189 .get_driver_name = dma_fence_chain_get_driver_name,
190 .get_timeline_name = dma_fence_chain_get_timeline_name,
191 .enable_signaling = dma_fence_chain_enable_signaling,
192 .signaled = dma_fence_chain_signaled,
193 .release = dma_fence_chain_release,
195 EXPORT_SYMBOL(dma_fence_chain_ops);
198 * dma_fence_chain_init - initialize a fence chain
199 * @chain: the chain node to initialize
200 * @prev: the previous fence
201 * @fence: the current fence
203 * Initialize a new chain node and either start a new chain or add the node to
204 * the existing chain of the previous fence.
206 void dma_fence_chain_init(struct dma_fence_chain *chain,
207 struct dma_fence *prev,
208 struct dma_fence *fence,
211 struct dma_fence_chain *prev_chain = to_dma_fence_chain(prev);
214 spin_lock_init(&chain->lock);
215 rcu_assign_pointer(chain->prev, prev);
216 chain->fence = fence;
217 chain->prev_seqno = 0;
218 init_irq_work(&chain->work, dma_fence_chain_irq_work);
220 /* Try to reuse the context of the previous chain node. */
221 if (prev_chain && __dma_fence_is_later(seqno, prev->seqno, prev->ops)) {
222 context = prev->context;
223 chain->prev_seqno = prev->seqno;
225 context = dma_fence_context_alloc(1);
226 /* Make sure that we always have a valid sequence number. */
228 seqno = max(prev->seqno, seqno);
231 dma_fence_init(&chain->base, &dma_fence_chain_ops,
232 &chain->lock, context, seqno);
234 EXPORT_SYMBOL(dma_fence_chain_init);