pb_validate.h File Reference

Buffer validation. More...

Include dependency graph for pb_validate.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
enum pipe_error	pb_validate_add_buffer (struct pb_validate *vl, struct pb_buffer *buf)
enum pipe_error	pb_validate_validate (struct pb_validate *vl)
	Validate all buffers for hardware access.
void	pb_validate_fence (struct pb_validate *vl, struct pipe_fence_handle *fence)
	Fence all buffers and clear the list.
struct pb_validate *	pb_validate_create (void)
void	pb_validate_destroy (struct pb_validate *vl)

---

Detailed Description

Buffer validation.

Author:

Jose Fonseca <jrfonseca@tungstengraphics.com>

Definition in file pb_validate.h.

---

Function Documentation

enum pipe_error pb_validate_add_buffer	(	struct pb_validate *	vl,
		struct pb_buffer *	buf
	)

Definition at line 58 of file pb_validate.c.

References assert, pb_validate::buffers, pb_reference(), PIPE_ERROR, PIPE_ERROR_OUT_OF_MEMORY, PIPE_OK, REALLOC, pb_validate::size, and pb_validate::used.

{
   assert(buf);
   if(!buf)
      return PIPE_ERROR;

   /* We only need to store one reference for each buffer, so avoid storing
    * consecutive references for the same buffer. It might not be the more 
    * common pasttern, but it is easy to implement.
    */
   if(vl->used && vl->buffers[vl->used - 1] == buf) {
      return PIPE_OK;
   }
   
   /* Grow the table */
   if(vl->used == vl->size) {
      unsigned new_size;
      struct pb_buffer **new_buffers;
      
      new_size = vl->size * 2;
      if(!new_size)
         return PIPE_ERROR_OUT_OF_MEMORY;

      new_buffers = (struct pb_buffer **)REALLOC(vl->buffers,
                                                 vl->size*sizeof(struct pb_buffer *),
                                                 new_size*sizeof(struct pb_buffer *));
      if(!new_buffers)
         return PIPE_ERROR_OUT_OF_MEMORY;
      
      memset(new_buffers + vl->size, 0, (new_size - vl->size)*sizeof(struct pb_buffer *));
      
      vl->size = new_size;
      vl->buffers = new_buffers;
   }
   
   assert(!vl->buffers[vl->used]);
   pb_reference(&vl->buffers[vl->used], buf);
   ++vl->used;
   
   return PIPE_OK;
}

struct pb_validate* pb_validate_create

(

void

)

[read]

Definition at line 136 of file pb_validate.c.

References pb_validate::buffers, CALLOC, CALLOC_STRUCT, FREE, PB_VALIDATE_INITIAL_SIZE, and pb_validate::size.

{
   struct pb_validate *vl;
   
   vl = CALLOC_STRUCT(pb_validate);
   if(!vl)
      return NULL;
   
   vl->size = PB_VALIDATE_INITIAL_SIZE;
   vl->buffers = (struct pb_buffer **)CALLOC(vl->size, sizeof(struct pb_buffer *));
   if(!vl->buffers) {
      FREE(vl);
      return NULL;
   }

   return vl;
}

void pb_validate_destroy

(

struct pb_validate *

vl

)

Definition at line 125 of file pb_validate.c.

References pb_validate::buffers, FREE, pb_reference(), and pb_validate::used.

{
   unsigned i;
   for(i = 0; i < vl->used; ++i)
      pb_reference(&vl->buffers[i], NULL);
   FREE(vl->buffers);
   FREE(vl);
}

void pb_validate_fence	(	struct pb_validate *	vl,
		struct pipe_fence_handle *	fence
	)

Fence all buffers and clear the list.

Should be called right before issuing commands to the hardware.

Definition at line 112 of file pb_validate.c.

References buffer_fence(), pb_validate::buffers, pb_reference(), and pb_validate::used.

{
   unsigned i;
   for(i = 0; i < vl->used; ++i) {
      buffer_fence(vl->buffers[i], fence);
      pb_reference(&vl->buffers[i], NULL);
   }
   vl->used = 0;
}

enum pipe_error pb_validate_validate

(

struct pb_validate *

vl

)

Validate all buffers for hardware access.

Should be called right before issuing commands to the hardware.

Definition at line 103 of file pb_validate.c.

References PIPE_OK.

{
   /* FIXME: go through each buffer, ensure its not mapped, its address is 
    * available -- requires a new pb_buffer interface */
   return PIPE_OK;
}

---