1b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca/************************************************************************** 2b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * 3b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * Copyright 2007 Tungsten Graphics, Inc., Cedar Park, Texas. 4b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * All Rights Reserved. 5b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * 6b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * Permission is hereby granted, free of charge, to any person obtaining a 7b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * copy of this software and associated documentation files (the 8b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * "Software"), to deal in the Software without restriction, including 9b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * without limitation the rights to use, copy, modify, merge, publish, 10b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * distribute, sub license, and/or sell copies of the Software, and to 11b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * permit persons to whom the Software is furnished to do so, subject to 12b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * the following conditions: 13b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * 14b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * The above copyright notice and this permission notice (including the 15b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * next paragraph) shall be included in all copies or substantial portions 16b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * of the Software. 17b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * 18b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 19b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 20b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. 21b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * IN NO EVENT SHALL TUNGSTEN GRAPHICS AND/OR ITS SUPPLIERS BE LIABLE FOR 22b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, 23b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 24b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 25b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * 26b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca **************************************************************************/ 27b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 28b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca/** 29b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * \file 30b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * Buffer fencing. 31b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * 32b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * "Fenced buffers" is actually a misnomer. They should be referred as 33b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * "fenceable buffers", i.e, buffers that can be fenced, but I couldn't find 34b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * the word "fenceable" in the dictionary. 35b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * 36b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * A "fenced buffer" is a decorator around a normal buffer, which adds two 37b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * special properties: 38b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * - the ability for the destruction to be delayed by a fence; 39b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * - reference counting. 40b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * 41b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * Usually DMA buffers have a life-time that will extend the life-time of its 42b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * handle. The end-of-life is dictated by the fence signalling. 43b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * 44b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * Between the handle's destruction, and the fence signalling, the buffer is 45b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * stored in a fenced buffer list. 46b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * 47e06474dbae6979177629fb6187331291ff230c65José Fonseca * \author Jose Fonseca <jrfonseca@tungstengraphics.com> 48b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca */ 49b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 50b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca#ifndef PB_BUFFER_FENCED_H_ 51b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca#define PB_BUFFER_FENCED_H_ 52b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 53b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 54ea4bf267e4b023b08043f91ac44592fed1736e7fJosé Fonseca#include "util/u_debug.h" 55b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 56b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 57d6229d7f1fda03d3c73998505b0facf6e3d5b882José Fonseca#ifdef __cplusplus 58d6229d7f1fda03d3c73998505b0facf6e3d5b882José Fonsecaextern "C" { 59d6229d7f1fda03d3c73998505b0facf6e3d5b882José Fonseca#endif 60d6229d7f1fda03d3c73998505b0facf6e3d5b882José Fonseca 61d6229d7f1fda03d3c73998505b0facf6e3d5b882José Fonseca 62b47836225185c8d2e2ccf3e191230304709d0a57José Fonsecastruct pipe_fence_handle; 63b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 64b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 65b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca/** 66b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * List of buffers which are awaiting fence signalling. 67b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca */ 68b47836225185c8d2e2ccf3e191230304709d0a57José Fonsecastruct fenced_buffer_list; 69b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 70b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 7100ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonsecastruct pb_fence_ops 7200ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca{ 7300ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca void (*destroy)( struct pb_fence_ops *ops ); 7400ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca 7500ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca /** Set ptr = fence, with reference counting */ 7600ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca void (*fence_reference)( struct pb_fence_ops *ops, 7700ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca struct pipe_fence_handle **ptr, 7800ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca struct pipe_fence_handle *fence ); 7900ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca 8000ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca /** 8100ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca * Checks whether the fence has been signalled. 8200ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca * \param flags driver-specific meaning 8300ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca * \return zero on success. 8400ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca */ 8500ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca int (*fence_signalled)( struct pb_fence_ops *ops, 8600ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca struct pipe_fence_handle *fence, 8700ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca unsigned flag ); 8800ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca 8900ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca /** 9000ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca * Wait for the fence to finish. 9100ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca * \param flags driver-specific meaning 9200ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca * \return zero on success. 9300ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca */ 9400ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca int (*fence_finish)( struct pb_fence_ops *ops, 9500ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca struct pipe_fence_handle *fence, 9600ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca unsigned flag ); 9700ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca}; 9800ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca 9900ee308ab3e7da2a2939845e0f0a24b8a0925025José Fonseca 100d6229d7f1fda03d3c73998505b0facf6e3d5b882José Fonseca#ifdef __cplusplus 101d6229d7f1fda03d3c73998505b0facf6e3d5b882José Fonseca} 102d6229d7f1fda03d3c73998505b0facf6e3d5b882José Fonseca#endif 103d6229d7f1fda03d3c73998505b0facf6e3d5b882José Fonseca 104b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca#endif /*PB_BUFFER_FENCED_H_*/ 105