pb_buffer_fenced.h revision b47836225185c8d2e2ccf3e191230304709d0a57
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 * 47b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * \author Jos� 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 54b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca#include <assert.h> 55b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 56b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 57b47836225185c8d2e2ccf3e191230304709d0a57José Fonsecastruct pipe_winsys; 58b47836225185c8d2e2ccf3e191230304709d0a57José Fonsecastruct pipe_buffer; 59b47836225185c8d2e2ccf3e191230304709d0a57José Fonsecastruct pipe_fence_handle; 60b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 61b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 62b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca/** 63b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * List of buffers which are awaiting fence signalling. 64b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca */ 65b47836225185c8d2e2ccf3e191230304709d0a57José Fonsecastruct fenced_buffer_list; 66b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 67b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 68b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca/** 69b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * The fenced buffer's virtual function table. 70b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * 71b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * NOTE: Made public for debugging purposes. 72b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca */ 73b47836225185c8d2e2ccf3e191230304709d0a57José Fonsecaextern const struct pipe_buffer_vtbl fenced_buffer_vtbl; 74b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 75b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 76b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca/** 77b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * Create a fenced buffer list. 78b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * 79b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * See also fenced_bufmgr_create for a more convenient way to use this. 80b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca */ 81b47836225185c8d2e2ccf3e191230304709d0a57José Fonsecastruct fenced_buffer_list * 82b47836225185c8d2e2ccf3e191230304709d0a57José Fonsecafenced_buffer_list_create(struct pipe_winsys *winsys); 83b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 84b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 85b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca/** 86b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * Walk the fenced buffer list to check and free signalled buffers. 87b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca */ 88b47836225185c8d2e2ccf3e191230304709d0a57José Fonsecavoid 89b47836225185c8d2e2ccf3e191230304709d0a57José Fonsecafenced_buffer_list_check_free(struct fenced_buffer_list *fenced_list, 90b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca int wait); 91b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 92b47836225185c8d2e2ccf3e191230304709d0a57José Fonsecavoid 93b47836225185c8d2e2ccf3e191230304709d0a57José Fonsecafenced_buffer_list_destroy(struct fenced_buffer_list *fenced_list); 94b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 95b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 96b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca/** 97b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * Wrap a buffer in a fenced buffer. 98b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * 99b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * NOTE: this will not increase the buffer reference count. 100b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca */ 101b47836225185c8d2e2ccf3e191230304709d0a57José Fonsecastruct pipe_buffer * 102b47836225185c8d2e2ccf3e191230304709d0a57José Fonsecafenced_buffer_create(struct fenced_buffer_list *fenced, 103b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca struct pipe_buffer *buffer); 104b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 105b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 106b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca/** 107b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * Set a buffer's fence. 108b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * 109b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * NOTE: Although it takes a generic pipe buffer argument, it will fail 110b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * on everything but buffers returned by fenced_buffer_create. 111b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca */ 112b47836225185c8d2e2ccf3e191230304709d0a57José Fonsecavoid 113b47836225185c8d2e2ccf3e191230304709d0a57José Fonsecabuffer_fence(struct pipe_buffer *buf, 114b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca struct pipe_fence_handle *fence); 115b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 116b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 117b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca/** 118b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * Remove the buffer's fence. 119b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * 120b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * NOTE: Although it takes a generic pipe buffer argument, it will fail 121b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * on everything but buffers returned by fenced_buffer_create. 122b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca */ 123b47836225185c8d2e2ccf3e191230304709d0a57José Fonsecavoid 124b47836225185c8d2e2ccf3e191230304709d0a57José Fonsecabuffer_unfence(struct pipe_buffer *buf); 125b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 126b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 127b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca/** 128b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * Wait for the buffer fence to signal. 129b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * 130b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca * See also pipe_winsys::fence_finish(). 131b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca */ 132b47836225185c8d2e2ccf3e191230304709d0a57José Fonsecaint 133b47836225185c8d2e2ccf3e191230304709d0a57José Fonsecabuffer_finish(struct pipe_buffer *buf, 134b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca unsigned flag); 135b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 136b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 137b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca 138b47836225185c8d2e2ccf3e191230304709d0a57José Fonseca#endif /*PB_BUFFER_FENCED_H_*/ 139