summaryrefslogtreecommitdiffstats
path: root/runtime/mem_map.h
diff options
context:
space:
mode:
Diffstat (limited to 'runtime/mem_map.h')
-rw-r--r--runtime/mem_map.h104
1 files changed, 104 insertions, 0 deletions
diff --git a/runtime/mem_map.h b/runtime/mem_map.h
new file mode 100644
index 0000000000..2eb7772705
--- /dev/null
+++ b/runtime/mem_map.h
@@ -0,0 +1,104 @@
+/*
+ * Copyright (C) 2008 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#ifndef ART_SRC_MEM_MAP_H_
+#define ART_SRC_MEM_MAP_H_
+
+#include <string>
+
+#include <stddef.h>
+#include <sys/mman.h> // For the PROT_* and MAP_* constants.
+#include <sys/types.h>
+
+#include "globals.h"
+
+namespace art {
+
+// Used to keep track of mmap segments.
+class MemMap {
+ public:
+ // Request an anonymous region of length 'byte_count' and a requested base address.
+ // Use NULL as the requested base address if you don't care.
+ //
+ // The word "anonymous" in this context means "not backed by a file". The supplied
+ // 'ashmem_name' will be used -- on systems that support it -- to give the mapping
+ // a name.
+ //
+ // On success, returns returns a MemMap instance. On failure, returns a NULL;
+ static MemMap* MapAnonymous(const char* ashmem_name, byte* addr, size_t byte_count, int prot);
+
+ // Map part of a file, taking care of non-page aligned offsets. The
+ // "start" offset is absolute, not relative.
+ //
+ // On success, returns returns a MemMap instance. On failure, returns a NULL;
+ static MemMap* MapFile(size_t byte_count, int prot, int flags, int fd, off_t start) {
+ return MapFileAtAddress(NULL, byte_count, prot, flags, fd, start, false);
+ }
+
+ // Map part of a file, taking care of non-page aligned offsets. The
+ // "start" offset is absolute, not relative. This version allows
+ // requesting a specific address for the base of the mapping.
+ //
+ // On success, returns returns a MemMap instance. On failure, returns a NULL;
+ static MemMap* MapFileAtAddress(
+ byte* addr, size_t byte_count, int prot, int flags, int fd, off_t start, bool reuse);
+
+ // Releases the memory mapping
+ ~MemMap();
+
+ bool Protect(int prot);
+
+ bool ProtectRegion(uint8_t* addr, size_t length, int prot);
+
+ int GetProtect() const {
+ return prot_;
+ }
+
+ byte* Begin() const {
+ return begin_;
+ }
+
+ size_t Size() const {
+ return size_;
+ }
+
+ byte* End() const {
+ return Begin() + Size();
+ }
+
+ bool HasAddress(const void* addr) const {
+ return Begin() <= addr && addr < End();
+ }
+
+ // Trim by unmapping pages at the end of the map.
+ void UnMapAtEnd(byte* new_end);
+
+ private:
+ MemMap(const std::string& name, byte* begin, size_t size, void* base_begin, size_t base_size,
+ int prot);
+
+ std::string name_;
+ byte* const begin_; // Start of data.
+ size_t size_; // Length of data.
+
+ void* const base_begin_; // Page-aligned base address.
+ const size_t base_size_; // Length of mapping.
+ int prot_; // Protection of the map.
+};
+
+} // namespace art
+
+#endif // ART_SRC_MEM_MAP_H_