Sometimes we want to know whether a buffer is busy and wait for it (bo_wait). However, sometimes it would be more useful to be able to query whether a buffer is busy and being either read or written, and wait until it's stopped being either read or written. The point of this is to be able to avoid unnecessary waiting, e.g. if a GPU has written something to a buffer and is now reading that buffer, and a CPU wants to map that buffer for read, it needs to only wait for the last write. If there were no write, there wouldn't be any waiting needed. This, or course, requires user space drivers to send read/write flags with each relocation (like we have read/write domains in radeon, so we can actually use those for something useful now). Now how this patch works: The read/write flags should passed to ttm_validate_buffer. TTM maintains separate sync objects of the last read and write for each buffer, in addition to the sync object of the last use of a buffer. ttm_bo_wait then operates with one the sync objects. Signed-off-by: Marek Olšák <maraeo@gmail.com> Reviewed-by: Jerome Glisse <jglisse@redhat.com> Signed-off-by: Dave Airlie <airlied@redhat.com>
118 lines
4.3 KiB
C
118 lines
4.3 KiB
C
/**************************************************************************
|
|
*
|
|
* Copyright (c) 2006-2009 VMware, Inc., Palo Alto, CA., USA
|
|
* All Rights Reserved.
|
|
*
|
|
* 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, sub license, 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 NON-INFRINGEMENT. IN NO EVENT SHALL
|
|
* THE COPYRIGHT HOLDERS, AUTHORS AND/OR ITS SUPPLIERS 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.
|
|
*
|
|
**************************************************************************/
|
|
/*
|
|
* Authors: Thomas Hellstrom <thellstrom-at-vmware-dot-com>
|
|
*/
|
|
|
|
#ifndef _TTM_EXECBUF_UTIL_H_
|
|
#define _TTM_EXECBUF_UTIL_H_
|
|
|
|
#include "ttm/ttm_bo_api.h"
|
|
#include <linux/list.h>
|
|
|
|
/**
|
|
* struct ttm_validate_buffer
|
|
*
|
|
* @head: list head for thread-private list.
|
|
* @bo: refcounted buffer object pointer.
|
|
* @new_sync_obj_arg: New sync_obj_arg for @bo, to be used once
|
|
* adding a new sync object.
|
|
* @usage Indicates how @bo is used by the device.
|
|
* @reserved: Indicates whether @bo has been reserved for validation.
|
|
* @removed: Indicates whether @bo has been removed from lru lists.
|
|
* @put_count: Number of outstanding references on bo::list_kref.
|
|
* @old_sync_obj: Pointer to a sync object about to be unreferenced
|
|
* @old_sync_obj_read: Pointer to a read sync object about to be unreferenced.
|
|
* @old_sync_obj_write: Pointer to a write sync object about to be unreferenced.
|
|
*/
|
|
|
|
struct ttm_validate_buffer {
|
|
struct list_head head;
|
|
struct ttm_buffer_object *bo;
|
|
void *new_sync_obj_arg;
|
|
enum ttm_buffer_usage usage;
|
|
bool reserved;
|
|
bool removed;
|
|
int put_count;
|
|
void *old_sync_obj;
|
|
void *old_sync_obj_read;
|
|
void *old_sync_obj_write;
|
|
};
|
|
|
|
/**
|
|
* function ttm_eu_backoff_reservation
|
|
*
|
|
* @list: thread private list of ttm_validate_buffer structs.
|
|
*
|
|
* Undoes all buffer validation reservations for bos pointed to by
|
|
* the list entries.
|
|
*/
|
|
|
|
extern void ttm_eu_backoff_reservation(struct list_head *list);
|
|
|
|
/**
|
|
* function ttm_eu_reserve_buffers
|
|
*
|
|
* @list: thread private list of ttm_validate_buffer structs.
|
|
*
|
|
* Tries to reserve bos pointed to by the list entries for validation.
|
|
* If the function returns 0, all buffers are marked as "unfenced",
|
|
* taken off the lru lists and are not synced for write CPU usage.
|
|
*
|
|
* If the function detects a deadlock due to multiple threads trying to
|
|
* reserve the same buffers in reverse order, all threads except one will
|
|
* back off and retry. This function may sleep while waiting for
|
|
* CPU write reservations to be cleared, and for other threads to
|
|
* unreserve their buffers.
|
|
*
|
|
* This function may return -ERESTART or -EAGAIN if the calling process
|
|
* receives a signal while waiting. In that case, no buffers on the list
|
|
* will be reserved upon return.
|
|
*
|
|
* Buffers reserved by this function should be unreserved by
|
|
* a call to either ttm_eu_backoff_reservation() or
|
|
* ttm_eu_fence_buffer_objects() when command submission is complete or
|
|
* has failed.
|
|
*/
|
|
|
|
extern int ttm_eu_reserve_buffers(struct list_head *list);
|
|
|
|
/**
|
|
* function ttm_eu_fence_buffer_objects.
|
|
*
|
|
* @list: thread private list of ttm_validate_buffer structs.
|
|
* @sync_obj: The new sync object for the buffers.
|
|
*
|
|
* This function should be called when command submission is complete, and
|
|
* it will add a new sync object to bos pointed to by entries on @list.
|
|
* It also unreserves all buffers, putting them on lru lists.
|
|
*
|
|
*/
|
|
|
|
extern void ttm_eu_fence_buffer_objects(struct list_head *list, void *sync_obj);
|
|
|
|
#endif
|