1 /*
2  * Copyright (c) 2011-2014, The Linux Foundation. All rights reserved.
3 
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions are
6  * met:
7  *   * Redistributions of source code must retain the above copyright
8  *     notice, this list of conditions and the following disclaimer.
9  *   * Redistributions in binary form must reproduce the above
10  *     copyright notice, this list of conditions and the following
11  *     disclaimer in the documentation and/or other materials provided
12  *     with the distribution.
13  *   * Neither the name of The Linux Foundation nor the names of its
14  *     contributors may be used to endorse or promote products derived
15  *     from this software without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED
18  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
19  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT
20  * ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS
21  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
22  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
23  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
24  * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
25  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
26  * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
27  * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28  */
29 
30 #ifndef GRALLOC_MEMALLOC_H
31 #define GRALLOC_MEMALLOC_H
32 
33 #include <stdlib.h>
34 
35 namespace gralloc {
36 
37 enum {
38     CACHE_CLEAN = 0x1,
39     CACHE_INVALIDATE,
40     CACHE_CLEAN_AND_INVALIDATE,
41 };
42 
43 struct alloc_data {
44     void           *base;
45     int            fd;
46     unsigned int   offset;
47     unsigned int   size;
48     unsigned int   align;
49     uintptr_t      pHandle;
50     bool           uncached;
51     unsigned int   flags;
52     unsigned int   heapId;
53     int            allocType;
54 };
55 
56 class IMemAlloc {
57 
58     public:
59     // Allocate buffer - fill in the alloc_data
60     // structure and pass it in. Mapped address
61     // and fd are returned in the alloc_data struct
62     virtual int alloc_buffer(alloc_data& data) = 0;
63 
64     // Free buffer
65     virtual int free_buffer(void *base, unsigned int size,
66                             unsigned int offset, int fd) = 0;
67 
68     // Map buffer
69     virtual int map_buffer(void **pBase, unsigned int size,
70                            unsigned int offset, int fd) = 0;
71 
72     // Unmap buffer
73     virtual int unmap_buffer(void *base, unsigned int size,
74                              unsigned int offset) = 0;
75 
76     // Clean and invalidate
77     virtual int clean_buffer(void *base, unsigned int size,
78                              unsigned int offset, int fd, int op) = 0;
79 
80     // Destructor
~IMemAlloc()81     virtual ~IMemAlloc() {};
82 
83     enum {
84         FD_INIT = -1,
85     };
86 
87 };
88 
89 } // end gralloc namespace
90 #endif // GRALLOC_MEMALLOC_H
91