mem_map.h revision 30fab40ee5a07af6b8c3b6b0e9438071695a57f4
1db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom/* 2db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom * Copyright (C) 2008 The Android Open Source Project 3db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom * 4db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom * Licensed under the Apache License, Version 2.0 (the "License"); 5db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom * you may not use this file except in compliance with the License. 6db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom * You may obtain a copy of the License at 7db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom * 8db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom * http://www.apache.org/licenses/LICENSE-2.0 9db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom * 10db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom * Unless required by applicable law or agreed to in writing, software 11db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom * distributed under the License is distributed on an "AS IS" BASIS, 12db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom * See the License for the specific language governing permissions and 14db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom * limitations under the License. 15db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom */ 16db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom 17db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom#ifndef ART_SRC_MEM_MAP_H_ 18db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom#define ART_SRC_MEM_MAP_H_ 19db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom 2027ec961a1da540ba7f16c07a682585ab167317adBrian Carlstrom#include <stddef.h> 2127ec961a1da540ba7f16c07a682585ab167317adBrian Carlstrom#include <sys/types.h> 22db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom 2327ec961a1da540ba7f16c07a682585ab167317adBrian Carlstrom#include "globals.h" 24db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom 25db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstromnamespace art { 26db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom 27db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom// Used to keep track of mmap segments. 28db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstromclass MemMap { 29db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom public: 30db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom 314a289ed61242964b921434de7d375f46480472a1Brian Carlstrom // Request an anonymous region of a specified length and a requested base address. 326c9c06dbb0b16714079afaedbebd3d548aa832b2Elliott Hughes // Use NULL as the requested base address if you don't care. 336c9c06dbb0b16714079afaedbebd3d548aa832b2Elliott Hughes // 346c9c06dbb0b16714079afaedbebd3d548aa832b2Elliott Hughes // The word "anonymous" in this context means "not backed by a file". The supplied 356c9c06dbb0b16714079afaedbebd3d548aa832b2Elliott Hughes // 'ashmem_name' will be used -- on systems that support it -- to give the mapping 366c9c06dbb0b16714079afaedbebd3d548aa832b2Elliott Hughes // a name. 374a289ed61242964b921434de7d375f46480472a1Brian Carlstrom // 384a289ed61242964b921434de7d375f46480472a1Brian Carlstrom // On success, returns returns a MemMap instance. On failure, returns a NULL; 3989521898b56f2ebc3fb68acfb6bc6dde9b6f5c38Brian Carlstrom static MemMap* MapAnonymous(const char* ashmem_name, byte* addr, size_t length, int prot); 40db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom 41db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom // Map part of a file, taking care of non-page aligned offsets. The 42db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom // "start" offset is absolute, not relative. 43db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom // 44db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom // On success, returns returns a MemMap instance. On failure, returns a NULL; 4589521898b56f2ebc3fb68acfb6bc6dde9b6f5c38Brian Carlstrom static MemMap* MapFile(size_t length, int prot, int flags, int fd, off_t start) { 4689521898b56f2ebc3fb68acfb6bc6dde9b6f5c38Brian Carlstrom return MapFileAtAddress(NULL, length, prot, flags, fd, start); 474a289ed61242964b921434de7d375f46480472a1Brian Carlstrom } 484a289ed61242964b921434de7d375f46480472a1Brian Carlstrom 494a289ed61242964b921434de7d375f46480472a1Brian Carlstrom // Map part of a file, taking care of non-page aligned offsets. The 504a289ed61242964b921434de7d375f46480472a1Brian Carlstrom // "start" offset is absolute, not relative. This version allows 514a289ed61242964b921434de7d375f46480472a1Brian Carlstrom // requesting a specific address for the base of the mapping. 524a289ed61242964b921434de7d375f46480472a1Brian Carlstrom // 534a289ed61242964b921434de7d375f46480472a1Brian Carlstrom // On success, returns returns a MemMap instance. On failure, returns a NULL; 5489521898b56f2ebc3fb68acfb6bc6dde9b6f5c38Brian Carlstrom static MemMap* MapFileAtAddress( 5589521898b56f2ebc3fb68acfb6bc6dde9b6f5c38Brian Carlstrom byte* addr, size_t length, int prot, int flags, int fd, off_t start); 56db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom 5727ec961a1da540ba7f16c07a682585ab167317adBrian Carlstrom // Releases the memory mapping 5827ec961a1da540ba7f16c07a682585ab167317adBrian Carlstrom ~MemMap(); 59db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom 6030fab40ee5a07af6b8c3b6b0e9438071695a57f4Ian Rogers byte* Begin() const { 6130fab40ee5a07af6b8c3b6b0e9438071695a57f4Ian Rogers return begin_; 62db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom } 63db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom 6430fab40ee5a07af6b8c3b6b0e9438071695a57f4Ian Rogers size_t Size() const { 6530fab40ee5a07af6b8c3b6b0e9438071695a57f4Ian Rogers return size_; 66db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom } 67db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom 6830fab40ee5a07af6b8c3b6b0e9438071695a57f4Ian Rogers byte* End() const { 6930fab40ee5a07af6b8c3b6b0e9438071695a57f4Ian Rogers return begin_ + size_; 70b765be0d656c3073402693aeaf64e95a0e49f218Brian Carlstrom } 71b765be0d656c3073402693aeaf64e95a0e49f218Brian Carlstrom 72db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom private: 7330fab40ee5a07af6b8c3b6b0e9438071695a57f4Ian Rogers MemMap(byte* begin, size_t size, void* base_begin, size_t base_size); 74db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom 7530fab40ee5a07af6b8c3b6b0e9438071695a57f4Ian Rogers byte* const begin_; // start of data 7630fab40ee5a07af6b8c3b6b0e9438071695a57f4Ian Rogers const size_t size_; // length of data 77db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom 7830fab40ee5a07af6b8c3b6b0e9438071695a57f4Ian Rogers void* const base_begin_; // page-aligned base address 7930fab40ee5a07af6b8c3b6b0e9438071695a57f4Ian Rogers const size_t base_size_; // length of mapping 80db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom}; 81db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom 82db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom} // namespace art 83db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom 84db4d54081f09abcbe97ffdf615874f2809a9e777Brian Carlstrom#endif // ART_SRC_MEM_MAP_H_ 85