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     int            allocType;
53 };
54 
55 class IMemAlloc {
56 
57     public:
58     // Allocate buffer - fill in the alloc_data
59     // structure and pass it in. Mapped address
60     // and fd are returned in the alloc_data struct
61     virtual int alloc_buffer(alloc_data& data) = 0;
62 
63     // Free buffer
64     virtual int free_buffer(void *base, unsigned int size,
65                             unsigned int offset, int fd) = 0;
66 
67     // Map buffer
68     virtual int map_buffer(void **pBase, unsigned int size,
69                            unsigned int offset, int fd) = 0;
70 
71     // Unmap buffer
72     virtual int unmap_buffer(void *base, unsigned int size,
73                              unsigned int offset) = 0;
74 
75     // Clean and invalidate
76     virtual int clean_buffer(void *base, unsigned int size,
77                              unsigned int offset, int fd, int op) = 0;
78 
79     // Destructor
~IMemAlloc()80     virtual ~IMemAlloc() {};
81 
82     enum {
83         FD_INIT = -1,
84     };
85 
86 };
87 
88 } // end gralloc namespace
89 #endif // GRALLOC_MEMALLOC_H
90