2 * Copyright (C) 2012-2014 ARM Limited. All rights reserved.
4 * This program is free software and is provided to you under the terms of the GNU General Public License version 2
5 * as published by the Free Software Foundation, and any use by you of this program is subject to the terms of such GNU licence.
7 * A copy of the licence is included with the program, and can also be obtained from Free Software
8 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
14 * Mali interface for Linux sync objects.
20 #if defined(CONFIG_SYNC)
22 #include <linux/seq_file.h>
23 #include <linux/version.h>
24 #if LINUX_VERSION_CODE < KERNEL_VERSION(3, 10, 0)
25 #include <linux/sync.h>
33 struct mali_sync_flag;
37 * Create a sync timeline.
39 * @param name Name of the sync timeline.
40 * @return The new sync timeline if successful, NULL if not.
42 struct sync_timeline *mali_sync_timeline_create(struct mali_timeline *timeline, const char *name);
45 * Check if sync timeline belongs to Mali.
47 * @param sync_tl Sync timeline to check.
48 * @return MALI_TRUE if sync timeline belongs to Mali, MALI_FALSE if not.
50 mali_bool mali_sync_timeline_is_ours(struct sync_timeline *sync_tl);
53 * Creates a file descriptor representing the sync fence. Will release sync fence if allocation of
54 * file descriptor fails.
56 * @param sync_fence Sync fence.
57 * @return File descriptor representing sync fence if successful, or -1 if not.
59 s32 mali_sync_fence_fd_alloc(struct sync_fence *sync_fence);
62 * Merges two sync fences. Both input sync fences will be released.
64 * @param sync_fence1 First sync fence.
65 * @param sync_fence2 Second sync fence.
66 * @return New sync fence that is the result of the merger if successful, or NULL if not.
68 struct sync_fence *mali_sync_fence_merge(struct sync_fence *sync_fence1, struct sync_fence *sync_fence2);
71 * Create a sync fence that is already signaled.
73 * @param tl Sync timeline.
74 * @return New signaled sync fence if successful, NULL if not.
76 struct sync_fence *mali_sync_timeline_create_signaled_fence(struct sync_timeline *sync_tl);
81 * @param sync_tl Sync timeline.
82 * @param point Point on Mali timeline.
83 * @return New sync flag if successful, NULL if not.
85 struct mali_sync_flag *mali_sync_flag_create(struct sync_timeline *sync_tl, u32 point);
88 * Grab sync flag reference.
90 * @param flag Sync flag.
92 void mali_sync_flag_get(struct mali_sync_flag *flag);
95 * Release sync flag reference. If this was the last reference, the sync flag will be freed.
97 * @param flag Sync flag.
99 void mali_sync_flag_put(struct mali_sync_flag *flag);
102 * Signal sync flag. All sync fences created from this flag will be signaled.
104 * @param flag Sync flag to signal.
105 * @param error Negative error code, or 0 if no error.
107 void mali_sync_flag_signal(struct mali_sync_flag *flag, int error);
110 * Create a sync fence attached to given sync flag.
112 * @param flag Sync flag.
113 * @return New sync fence if successful, NULL if not.
115 struct sync_fence *mali_sync_flag_create_fence(struct mali_sync_flag *flag);
117 #endif /* defined(CONFIG_SYNC) */
119 #endif /* _MALI_SYNC_H_ */