src/gallium/auxiliary/pipebuffer/pb_cache.h

   1 /**************************************************************************
   2  *
   3  * Copyright 2007-2008 VMware, Inc.
   4  * Copyright 2015 Advanced Micro Devices, Inc.
   5  * All Rights Reserved.
   6  *
   7  * Permission is hereby granted, free of charge, to any person obtaining a
   8  * copy of this software and associated documentation files (the
   9  * "Software"), to deal in the Software without restriction, including
  10  * without limitation the rights to use, copy, modify, merge, publish,
  11  * distribute, sub license, and/or sell copies of the Software, and to
  12  * permit persons to whom the Software is furnished to do so, subject to
  13  * the following conditions:
  14  *
  15  * The above copyright notice and this permission notice (including the
  16  * next paragraph) shall be included in all copies or substantial portions
  17  * of the Software.
  18  *
  19  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  20  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  21  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
  22  * IN NO EVENT SHALL AUTHORS AND/OR ITS SUPPLIERS BE LIABLE FOR
  23  * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
  24  * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
  25  * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  26  *
  27  **************************************************************************/
  28
  29 #ifndef PB_CACHE_H
  30 #define PB_CACHE_H
  31
  32 #include "pb_buffer.h"
  33 #include "util/list.h"
  34 #include "os/os_thread.h"
  35
  36 /**
  37  * Statically inserted into the driver-specific buffer structure.
  38  */
  39 struct pb_cache_entry
  40 {
  41    struct list_head head;
  42    struct pb_buffer *buffer; /**< Pointer to the structure this is part of. */
  43    struct pb_cache *mgr;
  44    int64_t start, end; /**< Caching time interval */
  45 };
  46
  47 struct pb_cache
  48 {
  49    struct list_head cache;
  50    pipe_mutex mutex;
  51    uint64_t cache_size;
  52    uint64_t max_cache_size;
  53    unsigned usecs;
  54    unsigned num_buffers;
  55    unsigned bypass_usage;
  56    float size_factor;
  57
  58    void (*destroy_buffer)(struct pb_buffer *buf);
  59    bool (*can_reclaim)(struct pb_buffer *buf);
  60 };
  61
  62 void pb_cache_add_buffer(struct pb_cache_entry *entry);
  63 struct pb_buffer *pb_cache_reclaim_buffer(struct pb_cache *mgr, pb_size size,
  64                                        unsigned alignment, unsigned usage);
  65 void pb_cache_release_all_buffers(struct pb_cache *mgr);
  66 void pb_cache_init_entry(struct pb_cache *mgr, struct pb_cache_entry *entry,
  67                          struct pb_buffer *buf);
  68 void pb_cache_init(struct pb_cache *mgr, uint usecs, float size_factor,
  69                    unsigned bypass_usage, uint64_t maximum_cache_size,
  70                    void (*destroy_buffer)(struct pb_buffer *buf),
  71                    bool (*can_reclaim)(struct pb_buffer *buf));
  72 void pb_cache_deinit(struct pb_cache *mgr);
  73
  74 #endif