3 * (C) COPYRIGHT 2012-2015 ARM Limited. All rights reserved.
5 * This program is free software and is provided to you under the terms of the
6 * GNU General Public License version 2 as published by the Free Software
7 * Foundation, and any use by you of this program is subject to the terms
10 * A copy of the licence is included with the program, and can also be obtained
11 * from Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
12 * Boston, MA 02110-1301, USA.
21 * @file mali_kbase_sync.h
25 #ifndef MALI_KBASE_SYNC_H
26 #define MALI_KBASE_SYNC_H
30 #if LINUX_VERSION_CODE < KERNEL_VERSION(3, 17, 0)
31 /* For backwards compatiblility with kernels before 3.17. After 3.17
32 * sync_pt_parent is included in the kernel. */
33 static inline struct sync_timeline *sync_pt_parent(struct sync_pt *pt)
40 * Create a stream object.
41 * Built on top of timeline object.
42 * Exposed as a file descriptor.
43 * Life-time controlled via the file descriptor:
45 * - close to remove a ref
47 int kbase_stream_create(const char *name, int *const out_fd);
50 * Create a fence in a stream object
52 int kbase_stream_create_fence(int tl_fd);
55 * Validate a fd to be a valid fence
56 * No reference is taken.
58 * This function is only usable to catch unintentional user errors early,
59 * it does not stop malicious code changing the fd after this function returns.
61 int kbase_fence_validate(int fd);
63 /* Returns true if the specified timeline is allocated by Mali */
64 int kbase_sync_timeline_is_ours(struct sync_timeline *timeline);
66 /* Allocates a timeline for Mali
68 * One timeline should be allocated per API context.
70 struct sync_timeline *kbase_sync_timeline_alloc(const char *name);
72 /* Allocates a sync point within the timeline.
74 * The timeline must be the one allocated by kbase_sync_timeline_alloc
76 * Sync points must be triggered in *exactly* the same order as they are allocated.
78 struct sync_pt *kbase_sync_pt_alloc(struct sync_timeline *parent);
80 /* Signals a particular sync point
82 * Sync points must be triggered in *exactly* the same order as they are allocated.
84 * If they are signalled in the wrong order then a message will be printed in debug
85 * builds and otherwise attempts to signal order sync_pts will be ignored.
87 * result can be negative to indicate error, any other value is interpreted as success.
89 void kbase_sync_signal_pt(struct sync_pt *pt, int result);