| /* |
| * Copyright © 2021 Intel Corporation |
| * |
| * Permission is hereby granted, free of charge, to any person obtaining a |
| * copy of this software and associated documentation files (the "Software"), |
| * to deal in the Software without restriction, including without limitation |
| * the rights to use, copy, modify, merge, publish, distribute, sublicense, |
| * and/or sell copies of the Software, and to permit persons to whom the |
| * Software is furnished to do so, subject to the following conditions: |
| * |
| * The above copyright notice and this permission notice (including the next |
| * paragraph) shall be included in all copies or substantial portions of the |
| * Software. |
| * |
| * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
| * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
| * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
| * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
| * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
| * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS |
| * IN THE SOFTWARE. |
| */ |
| #ifndef VK_SYNC_TIMELINE_H |
| #define VK_SYNC_TIMELINE_H |
| |
| #include "c11/threads.h" |
| #include "util/list.h" |
| #include "util/macros.h" |
| |
| #include "vk_sync.h" |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif |
| |
| struct vk_sync_timeline_type { |
| struct vk_sync_type sync; |
| |
| /* Type of each individual time point */ |
| const struct vk_sync_type *point_sync_type; |
| }; |
| |
| struct vk_sync_timeline_type |
| vk_sync_timeline_get_type(const struct vk_sync_type *point_sync_type); |
| |
| struct vk_sync_timeline_point { |
| struct vk_sync_timeline *timeline; |
| |
| struct list_head link; |
| |
| uint64_t value; |
| |
| int refcount; |
| bool pending; |
| |
| struct vk_sync sync; |
| }; |
| |
| /** Implements a timeline vk_sync type on top of a binary vk_sync |
| * |
| * This is used for emulating VK_KHR_timeline_semaphores for implementations |
| * whose kernel driver do not yet support timeline syncobj. Since it's a |
| * requirement for Vulkan 1.2, it's useful to have an emulation like this. |
| * |
| * The driver should never see a vk_sync_timeline object. Instead, converting |
| * from vk_sync_timeline to a binary vk_sync for a particular time point is |
| * handled by common code. All a driver needs to do is declare its preferred |
| * binary vk_sync_type for emulation as follows: |
| * |
| * const struct vk_sync_type anv_bo_sync_type = { |
| * ... |
| * }; |
| * VK_DECL_TIMELINE_TYPE(anv_bo_timeline_sync_type, &anv_bo_sync_type); |
| * |
| * and then anv_bo_timeline_sync_type.sync can be used as a sync type to |
| * provide timelines. |
| */ |
| struct vk_sync_timeline { |
| struct vk_sync sync; |
| |
| mtx_t mutex; |
| cnd_t cond; |
| |
| uint64_t highest_past; |
| uint64_t highest_pending; |
| |
| struct list_head pending_points; |
| struct list_head free_points; |
| }; |
| |
| VkResult vk_sync_timeline_init(struct vk_device *device, |
| struct vk_sync *sync, |
| uint64_t initial_value); |
| |
| VkResult vk_sync_timeline_alloc_point(struct vk_device *device, |
| struct vk_sync_timeline *timeline, |
| uint64_t value, |
| struct vk_sync_timeline_point **point_out); |
| |
| void vk_sync_timeline_point_free(struct vk_device *device, |
| struct vk_sync_timeline_point *point); |
| |
| VkResult vk_sync_timeline_point_install(struct vk_device *device, |
| struct vk_sync_timeline_point *point); |
| |
| VkResult vk_sync_timeline_get_point(struct vk_device *device, |
| struct vk_sync_timeline *timeline, |
| uint64_t wait_value, |
| struct vk_sync_timeline_point **point_out); |
| |
| void vk_sync_timeline_point_release(struct vk_device *device, |
| struct vk_sync_timeline_point *point); |
| |
| static inline bool |
| vk_sync_type_is_vk_sync_timeline(const struct vk_sync_type *type) |
| { |
| return type->init == vk_sync_timeline_init; |
| } |
| |
| static inline struct vk_sync_timeline * |
| vk_sync_as_timeline(struct vk_sync *sync) |
| { |
| if (!vk_sync_type_is_vk_sync_timeline(sync->type)) |
| return NULL; |
| |
| return container_of(sync, struct vk_sync_timeline, sync); |
| } |
| |
| #ifdef __cplusplus |
| } |
| #endif |
| |
| #endif /* VK_SYNC_TIMELINE_H */ |