1 /*
2  * Copyright 2006 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 #ifndef _OTAUTIL_SYSUTIL
18 #define _OTAUTIL_SYSUTIL
19 
20 #include <sys/types.h>
21 
22 #include <vector>
23 
24 struct MappedRange {
25   void* addr;
26   size_t length;
27 };
28 
29 /*
30  * Use this to keep track of mapped segments.
31  */
32 struct MemMapping {
33   unsigned char* addr; /* start of data */
34   size_t length;       /* length of data */
35 
36   std::vector<MappedRange> ranges;
37 };
38 
39 /*
40  * Map a file into a private, read-only memory segment.  If 'fn'
41  * begins with an '@' character, it is a map of blocks to be mapped,
42  * otherwise it is treated as an ordinary file.
43  *
44  * On success, "pMap" is filled in, and zero is returned.
45  */
46 int sysMapFile(const char* fn, MemMapping* pMap);
47 
48 /*
49  * Release the pages associated with a shared memory segment.
50  *
51  * This does not free "pMap"; it just releases the memory.
52  */
53 void sysReleaseMap(MemMapping* pMap);
54 
55 #endif  // _OTAUTIL_SYSUTIL
56