13a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org/************************************************************************** 23a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * 33a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * Copyright 2007 Tungsten Graphics, Inc., Cedar Park, Texas. 43a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * All Rights Reserved. 53a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * 63a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * Permission is hereby granted, free of charge, to any person obtaining a 73a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * copy of this software and associated documentation files (the 83a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * "Software"), to deal in the Software without restriction, including 93a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * without limitation the rights to use, copy, modify, merge, publish, 103a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * distribute, sub license, and/or sell copies of the Software, and to 113a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * permit persons to whom the Software is furnished to do so, subject to 123a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * the following conditions: 133a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * 143a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * The above copyright notice and this permission notice (including the 153a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * next paragraph) shall be included in all copies or substantial portions 163a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * of the Software. 173a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * 183a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 193a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 203a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. 213a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * IN NO EVENT SHALL TUNGSTEN GRAPHICS AND/OR ITS SUPPLIERS BE LIABLE FOR 223a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, 233a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 243a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 253a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * 263a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org **************************************************************************/ 273a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org 283a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org/** 293a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * \file 303a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * Buffer fencing. 313a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * 323a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * "Fenced buffers" is actually a misnomer. They should be referred as 333a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * "fenceable buffers", i.e, buffers that can be fenced, but I couldn't find 343a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * the word "fenceable" in the dictionary. 353a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * 363a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * A "fenced buffer" is a decorator around a normal buffer, which adds two 373a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * special properties: 383a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * - the ability for the destruction to be delayed by a fence; 393a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * - reference counting. 403a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * 413a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * Usually DMA buffers have a life-time that will extend the life-time of its 423a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * handle. The end-of-life is dictated by the fence signalling. 433a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * 443a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * Between the handle's destruction, and the fence signalling, the buffer is 453a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * stored in a fenced buffer list. 463a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * 473a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * \author Jose Fonseca <jrfonseca@tungstengraphics.com> 483a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org */ 493a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org 503a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org#ifndef PB_BUFFER_FENCED_H_ 513a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org#define PB_BUFFER_FENCED_H_ 523a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org 533a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org 543a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org#include "util/u_debug.h" 553a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org 563a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org 573a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org#ifdef __cplusplus 583a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.orgextern "C" { 593a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org#endif 603a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org 613a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org 623a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.orgstruct pipe_fence_handle; 633a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org 643a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org 653a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org/** 663a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * List of buffers which are awaiting fence signalling. 673a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org */ 683a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.orgstruct fenced_buffer_list; 693a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org 703a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org 713a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.orgstruct pb_fence_ops 723a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org{ 733a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org void (*destroy)( struct pb_fence_ops *ops ); 743a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org 753a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org /** Set ptr = fence, with reference counting */ 763a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org void (*fence_reference)( struct pb_fence_ops *ops, 773a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org struct pipe_fence_handle **ptr, 783a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org struct pipe_fence_handle *fence ); 793a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org 803a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org /** 813a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * Checks whether the fence has been signalled. 823a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * \param flags driver-specific meaning 833a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * \return zero on success. 843a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org */ 853a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org int (*fence_signalled)( struct pb_fence_ops *ops, 863a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org struct pipe_fence_handle *fence, 873a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org unsigned flag ); 883a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org 893a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org /** 903a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * Wait for the fence to finish. 913a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * \param flags driver-specific meaning 923a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org * \return zero on success. 933a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org */ 943a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org int (*fence_finish)( struct pb_fence_ops *ops, 953a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org struct pipe_fence_handle *fence, 963a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org unsigned flag ); 973a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org}; 983a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org 993a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org 1003a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org#ifdef __cplusplus 1013a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org} 1023a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org#endif 1033a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org 1043a0db227ffe90888ad760c61a63226988c974e0apatrick@chromium.org#endif /*PB_BUFFER_FENCED_H_*/ 105