Elliott Hughes | 2faa5f1 | 2012-01-30 14:42:07 -0800 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (C) 2011 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 | */ |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 16 | |
Brian Carlstrom | fc0e321 | 2013-07-17 14:40:12 -0700 | [diff] [blame] | 17 | #ifndef ART_RUNTIME_OAT_FILE_H_ |
| 18 | #define ART_RUNTIME_OAT_FILE_H_ |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 19 | |
Vladimir Marko | 3f5838d | 2014-08-07 18:07:18 +0100 | [diff] [blame] | 20 | #include <list> |
Brian Carlstrom | 700c8d3 | 2012-11-05 10:42:02 -0800 | [diff] [blame] | 21 | #include <string> |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 22 | #include <vector> |
| 23 | |
Vladimir Marko | 3f5838d | 2014-08-07 18:07:18 +0100 | [diff] [blame] | 24 | #include "base/mutex.h" |
Vladimir Marko | 539690a | 2014-06-05 18:36:42 +0100 | [diff] [blame] | 25 | #include "base/stringpiece.h" |
Ian Rogers | 2dd0e2c | 2013-01-24 12:42:14 -0800 | [diff] [blame] | 26 | #include "dex_file.h" |
| 27 | #include "invoke_type.h" |
| 28 | #include "mem_map.h" |
Mingyao Yang | 98d1cc8 | 2014-05-15 17:02:16 -0700 | [diff] [blame] | 29 | #include "mirror/class.h" |
Ian Rogers | 2dd0e2c | 2013-01-24 12:42:14 -0800 | [diff] [blame] | 30 | #include "oat.h" |
Brian Carlstrom | 700c8d3 | 2012-11-05 10:42:02 -0800 | [diff] [blame] | 31 | #include "os.h" |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 32 | |
| 33 | namespace art { |
| 34 | |
Brian Carlstrom | ba150c3 | 2013-08-27 17:31:03 -0700 | [diff] [blame] | 35 | class BitVector; |
Brian Carlstrom | 700c8d3 | 2012-11-05 10:42:02 -0800 | [diff] [blame] | 36 | class ElfFile; |
| 37 | class MemMap; |
| 38 | class OatMethodOffsets; |
Ian Rogers | 33e9566 | 2013-05-20 20:29:14 -0700 | [diff] [blame] | 39 | class OatHeader; |
Brian Carlstrom | 700c8d3 | 2012-11-05 10:42:02 -0800 | [diff] [blame] | 40 | |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 41 | class OatFile { |
| 42 | public: |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 43 | // Open an oat file. Returns NULL on failure. Requested base can |
| 44 | // optionally be used to request where the file should be loaded. |
| 45 | static OatFile* Open(const std::string& filename, |
Brian Carlstrom | a004aa9 | 2012-02-08 18:05:09 -0800 | [diff] [blame] | 46 | const std::string& location, |
Brian Carlstrom | f1d3455 | 2013-07-12 20:22:23 -0700 | [diff] [blame] | 47 | byte* requested_base, |
Ian Rogers | 8d31bbd | 2013-10-13 10:44:14 -0700 | [diff] [blame] | 48 | bool executable, |
| 49 | std::string* error_msg); |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 50 | |
Brian Carlstrom | 700c8d3 | 2012-11-05 10:42:02 -0800 | [diff] [blame] | 51 | // Open an oat file from an already opened File. |
Brian Carlstrom | 265091e | 2013-01-30 14:08:26 -0800 | [diff] [blame] | 52 | // Does not use dlopen underneath so cannot be used for runtime use |
| 53 | // where relocations may be required. Currently used from |
| 54 | // ImageWriter which wants to open a writable version from an existing |
| 55 | // file descriptor for patching. |
Ian Rogers | 8d31bbd | 2013-10-13 10:44:14 -0700 | [diff] [blame] | 56 | static OatFile* OpenWritable(File* file, const std::string& location, std::string* error_msg); |
Alex Light | a59dd80 | 2014-07-02 16:28:08 -0700 | [diff] [blame] | 57 | // Opens an oat file from an already opened File. Maps it PROT_READ, MAP_PRIVATE. |
| 58 | static OatFile* OpenReadable(File* file, const std::string& location, std::string* error_msg); |
Brian Carlstrom | 700c8d3 | 2012-11-05 10:42:02 -0800 | [diff] [blame] | 59 | |
| 60 | // Open an oat file backed by a std::vector with the given location. |
Brian Carlstrom | 265091e | 2013-01-30 14:08:26 -0800 | [diff] [blame] | 61 | static OatFile* OpenMemory(std::vector<uint8_t>& oat_contents, |
Ian Rogers | 8d31bbd | 2013-10-13 10:44:14 -0700 | [diff] [blame] | 62 | const std::string& location, |
| 63 | std::string* error_msg); |
Brian Carlstrom | 5b332c8 | 2012-02-01 15:02:31 -0800 | [diff] [blame] | 64 | |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 65 | ~OatFile(); |
| 66 | |
Alex Light | 53cb16b | 2014-06-12 11:26:29 -0700 | [diff] [blame] | 67 | ElfFile* GetElfFile() const { |
| 68 | CHECK_NE(reinterpret_cast<uintptr_t>(elf_file_.get()), reinterpret_cast<uintptr_t>(nullptr)) |
| 69 | << "Cannot get an elf file from " << GetLocation(); |
| 70 | return elf_file_.get(); |
| 71 | } |
| 72 | |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 73 | const std::string& GetLocation() const { |
| 74 | return location_; |
| 75 | } |
| 76 | |
| 77 | const OatHeader& GetOatHeader() const; |
| 78 | |
| 79 | class OatDexFile; |
| 80 | |
Brian Carlstrom | 3320cf4 | 2011-10-04 14:58:28 -0700 | [diff] [blame] | 81 | class OatMethod { |
| 82 | public: |
Ian Rogers | b0fa5dc | 2014-04-28 16:47:08 -0700 | [diff] [blame] | 83 | void LinkMethod(mirror::ArtMethod* method) const SHARED_LOCKS_REQUIRED(Locks::mutator_lock_); |
Brian Carlstrom | ae82698 | 2011-11-09 01:33:42 -0800 | [diff] [blame] | 84 | |
| 85 | uint32_t GetCodeOffset() const { |
| 86 | return code_offset_; |
| 87 | } |
Ian Rogers | 0c7abda | 2012-09-19 13:33:42 -0700 | [diff] [blame] | 88 | uint32_t GetNativeGcMapOffset() const { |
| 89 | return native_gc_map_offset_; |
Brian Carlstrom | e7d856b | 2012-01-11 18:10:55 -0800 | [diff] [blame] | 90 | } |
Brian Carlstrom | ae82698 | 2011-11-09 01:33:42 -0800 | [diff] [blame] | 91 | |
Ian Rogers | ef7d42f | 2014-01-06 12:55:46 -0800 | [diff] [blame] | 92 | const void* GetPortableCode() const { |
| 93 | // TODO: encode whether code is portable/quick in flags within OatMethod. |
| 94 | if (kUsePortableCompiler) { |
| 95 | return GetOatPointer<const void*>(code_offset_); |
| 96 | } else { |
| 97 | return nullptr; |
| 98 | } |
| 99 | } |
| 100 | |
| 101 | const void* GetQuickCode() const { |
| 102 | if (kUsePortableCompiler) { |
| 103 | return nullptr; |
| 104 | } else { |
| 105 | return GetOatPointer<const void*>(code_offset_); |
| 106 | } |
| 107 | } |
| 108 | |
| 109 | uint32_t GetPortableCodeSize() const { |
| 110 | // TODO: With Quick, we store the size before the code. With Portable, the code is in a .o |
| 111 | // file we don't manage ourselves. ELF symbols do have a concept of size, so we could capture |
| 112 | // that and store it somewhere, such as the OatMethod. |
| 113 | return 0; |
| 114 | } |
| 115 | uint32_t GetQuickCodeSize() const; |
Logan Chien | 0c717dd | 2012-03-28 18:31:07 +0800 | [diff] [blame] | 116 | |
Ian Rogers | 0c7abda | 2012-09-19 13:33:42 -0700 | [diff] [blame] | 117 | const uint8_t* GetNativeGcMap() const { |
| 118 | return GetOatPointer<const uint8_t*>(native_gc_map_offset_); |
Brian Carlstrom | e7d856b | 2012-01-11 18:10:55 -0800 | [diff] [blame] | 119 | } |
Logan Chien | 0c717dd | 2012-03-28 18:31:07 +0800 | [diff] [blame] | 120 | |
Vladimir Marko | 7624d25 | 2014-05-02 14:40:15 +0100 | [diff] [blame] | 121 | size_t GetFrameSizeInBytes() const; |
| 122 | uint32_t GetCoreSpillMask() const; |
| 123 | uint32_t GetFpSpillMask() const; |
Vladimir Marko | 8a63057 | 2014-04-09 18:45:35 +0100 | [diff] [blame] | 124 | uint32_t GetMappingTableOffset() const; |
| 125 | uint32_t GetVmapTableOffset() const; |
| 126 | const uint8_t* GetMappingTable() const; |
| 127 | const uint8_t* GetVmapTable() const; |
| 128 | |
Brian Carlstrom | ae82698 | 2011-11-09 01:33:42 -0800 | [diff] [blame] | 129 | // Create an OatMethod with offsets relative to the given base address |
Ian Rogers | 97b52f8 | 2014-08-14 11:34:07 -0700 | [diff] [blame^] | 130 | OatMethod(const byte* base, const uint32_t code_offset, const uint32_t gc_map_offset) |
| 131 | : begin_(base), |
| 132 | code_offset_(code_offset), |
| 133 | native_gc_map_offset_(gc_map_offset) { |
| 134 | } |
| 135 | ~OatMethod() {} |
Brian Carlstrom | 3320cf4 | 2011-10-04 14:58:28 -0700 | [diff] [blame] | 136 | |
Ian Rogers | 97b52f8 | 2014-08-14 11:34:07 -0700 | [diff] [blame^] | 137 | // A representation of an invalid OatMethod, used when an OatMethod or OatClass can't be found. |
| 138 | // See ClassLinker::FindOatMethodFor. |
| 139 | static const OatMethod Invalid() { |
| 140 | return OatMethod(nullptr, -1, -1); |
| 141 | } |
Nicolas Geoffray | 4fcdc94 | 2014-07-22 10:48:00 +0100 | [diff] [blame] | 142 | |
Brian Carlstrom | ae82698 | 2011-11-09 01:33:42 -0800 | [diff] [blame] | 143 | private: |
| 144 | template<class T> |
| 145 | T GetOatPointer(uint32_t offset) const { |
| 146 | if (offset == 0) { |
| 147 | return NULL; |
| 148 | } |
Ian Rogers | 30fab40 | 2012-01-23 15:43:46 -0800 | [diff] [blame] | 149 | return reinterpret_cast<T>(begin_ + offset); |
Brian Carlstrom | ae82698 | 2011-11-09 01:33:42 -0800 | [diff] [blame] | 150 | } |
| 151 | |
Ian Rogers | 97b52f8 | 2014-08-14 11:34:07 -0700 | [diff] [blame^] | 152 | const byte* const begin_; |
Brian Carlstrom | ae82698 | 2011-11-09 01:33:42 -0800 | [diff] [blame] | 153 | |
Ian Rogers | 97b52f8 | 2014-08-14 11:34:07 -0700 | [diff] [blame^] | 154 | const uint32_t code_offset_; |
| 155 | const uint32_t native_gc_map_offset_; |
Brian Carlstrom | ae82698 | 2011-11-09 01:33:42 -0800 | [diff] [blame] | 156 | |
| 157 | friend class OatClass; |
Brian Carlstrom | 3320cf4 | 2011-10-04 14:58:28 -0700 | [diff] [blame] | 158 | }; |
| 159 | |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 160 | class OatClass { |
| 161 | public: |
Brian Carlstrom | ba150c3 | 2013-08-27 17:31:03 -0700 | [diff] [blame] | 162 | mirror::Class::Status GetStatus() const { |
| 163 | return status_; |
| 164 | } |
| 165 | |
| 166 | OatClassType GetType() const { |
| 167 | return type_; |
| 168 | } |
Brian Carlstrom | 0755ec5 | 2012-01-11 15:19:46 -0800 | [diff] [blame] | 169 | |
Mathieu Chartier | eb8167a | 2014-05-07 15:43:14 -0700 | [diff] [blame] | 170 | // Get the OatMethod entry based on its index into the class |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 171 | // defintion. direct methods come first, followed by virtual |
| 172 | // methods. note that runtime created methods such as miranda |
| 173 | // methods are not included. |
Brian Carlstrom | aded5f7 | 2011-10-07 17:15:04 -0700 | [diff] [blame] | 174 | const OatMethod GetOatMethod(uint32_t method_index) const; |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 175 | |
Ian Rogers | 97b52f8 | 2014-08-14 11:34:07 -0700 | [diff] [blame^] | 176 | // A representation of an invalid OatClass, used when an OatClass can't be found. |
| 177 | // See ClassLinker::FindOatClass. |
| 178 | static OatClass Invalid() { |
| 179 | return OatClass(nullptr, mirror::Class::kStatusError, kOatClassNoneCompiled, 0, nullptr, |
| 180 | nullptr); |
| 181 | } |
Nicolas Geoffray | 4fcdc94 | 2014-07-22 10:48:00 +0100 | [diff] [blame] | 182 | |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 183 | private: |
Brian Carlstrom | 0755ec5 | 2012-01-11 15:19:46 -0800 | [diff] [blame] | 184 | OatClass(const OatFile* oat_file, |
Ian Rogers | 2dd0e2c | 2013-01-24 12:42:14 -0800 | [diff] [blame] | 185 | mirror::Class::Status status, |
Brian Carlstrom | ba150c3 | 2013-08-27 17:31:03 -0700 | [diff] [blame] | 186 | OatClassType type, |
| 187 | uint32_t bitmap_size, |
| 188 | const uint32_t* bitmap_pointer, |
Brian Carlstrom | 0755ec5 | 2012-01-11 15:19:46 -0800 | [diff] [blame] | 189 | const OatMethodOffsets* methods_pointer); |
Brian Carlstrom | 3320cf4 | 2011-10-04 14:58:28 -0700 | [diff] [blame] | 190 | |
Ian Rogers | 97b52f8 | 2014-08-14 11:34:07 -0700 | [diff] [blame^] | 191 | const OatFile* const oat_file_; |
Brian Carlstrom | ba150c3 | 2013-08-27 17:31:03 -0700 | [diff] [blame] | 192 | |
Ian Rogers | 97b52f8 | 2014-08-14 11:34:07 -0700 | [diff] [blame^] | 193 | const mirror::Class::Status status_; |
Brian Carlstrom | ba150c3 | 2013-08-27 17:31:03 -0700 | [diff] [blame] | 194 | |
Ian Rogers | 97b52f8 | 2014-08-14 11:34:07 -0700 | [diff] [blame^] | 195 | const OatClassType type_; |
Brian Carlstrom | ba150c3 | 2013-08-27 17:31:03 -0700 | [diff] [blame] | 196 | |
Ian Rogers | 97b52f8 | 2014-08-14 11:34:07 -0700 | [diff] [blame^] | 197 | const uint32_t* const bitmap_; |
Brian Carlstrom | ba150c3 | 2013-08-27 17:31:03 -0700 | [diff] [blame] | 198 | |
Ian Rogers | 97b52f8 | 2014-08-14 11:34:07 -0700 | [diff] [blame^] | 199 | const OatMethodOffsets* const methods_pointer_; |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 200 | |
| 201 | friend class OatDexFile; |
| 202 | }; |
| 203 | |
| 204 | class OatDexFile { |
| 205 | public: |
Brian Carlstrom | 56d947f | 2013-07-15 13:14:23 -0700 | [diff] [blame] | 206 | // Opens the DexFile referred to by this OatDexFile from within the containing OatFile. |
Ian Rogers | 8d31bbd | 2013-10-13 10:44:14 -0700 | [diff] [blame] | 207 | const DexFile* OpenDexFile(std::string* error_msg) const; |
Brian Carlstrom | 56d947f | 2013-07-15 13:14:23 -0700 | [diff] [blame] | 208 | |
| 209 | // Returns the size of the DexFile refered to by this OatDexFile. |
Ian Rogers | 05f28c6 | 2012-10-23 18:12:13 -0700 | [diff] [blame] | 210 | size_t FileSize() const; |
Brian Carlstrom | aded5f7 | 2011-10-07 17:15:04 -0700 | [diff] [blame] | 211 | |
Brian Carlstrom | 56d947f | 2013-07-15 13:14:23 -0700 | [diff] [blame] | 212 | // Returns original path of DexFile that was the source of this OatDexFile. |
Brian Carlstrom | aded5f7 | 2011-10-07 17:15:04 -0700 | [diff] [blame] | 213 | const std::string& GetDexFileLocation() const { |
| 214 | return dex_file_location_; |
| 215 | } |
Brian Carlstrom | 58ae941 | 2011-10-04 00:56:06 -0700 | [diff] [blame] | 216 | |
Brian Carlstrom | 56d947f | 2013-07-15 13:14:23 -0700 | [diff] [blame] | 217 | // Returns checksum of original DexFile that was the source of this OatDexFile; |
Brian Carlstrom | 5b332c8 | 2012-02-01 15:02:31 -0800 | [diff] [blame] | 218 | uint32_t GetDexFileLocationChecksum() const { |
| 219 | return dex_file_location_checksum_; |
Brian Carlstrom | 58ae941 | 2011-10-04 00:56:06 -0700 | [diff] [blame] | 220 | } |
| 221 | |
Brian Carlstrom | 56d947f | 2013-07-15 13:14:23 -0700 | [diff] [blame] | 222 | // Returns the OatClass for the class specified by the given DexFile class_def_index. |
Vladimir Marko | d3c5beb | 2014-04-11 16:32:51 +0100 | [diff] [blame] | 223 | OatClass GetOatClass(uint16_t class_def_index) const; |
Brian Carlstrom | 56d947f | 2013-07-15 13:14:23 -0700 | [diff] [blame] | 224 | |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 225 | ~OatDexFile(); |
Elliott Hughes | a21039c | 2012-06-21 12:09:25 -0700 | [diff] [blame] | 226 | |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 227 | private: |
| 228 | OatDexFile(const OatFile* oat_file, |
Elliott Hughes | aa6a588 | 2012-01-13 19:39:16 -0800 | [diff] [blame] | 229 | const std::string& dex_file_location, |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 230 | uint32_t dex_file_checksum, |
Brian Carlstrom | 700c8d3 | 2012-11-05 10:42:02 -0800 | [diff] [blame] | 231 | const byte* dex_file_pointer, |
Brian Carlstrom | 0755ec5 | 2012-01-11 15:19:46 -0800 | [diff] [blame] | 232 | const uint32_t* oat_class_offsets_pointer); |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 233 | |
Vladimir Marko | 539690a | 2014-06-05 18:36:42 +0100 | [diff] [blame] | 234 | const OatFile* const oat_file_; |
| 235 | const std::string dex_file_location_; |
| 236 | const uint32_t dex_file_location_checksum_; |
| 237 | const byte* const dex_file_pointer_; |
| 238 | const uint32_t* const oat_class_offsets_pointer_; |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 239 | |
| 240 | friend class OatFile; |
| 241 | DISALLOW_COPY_AND_ASSIGN(OatDexFile); |
| 242 | }; |
| 243 | |
Ian Rogers | 8d31bbd | 2013-10-13 10:44:14 -0700 | [diff] [blame] | 244 | const OatDexFile* GetOatDexFile(const char* dex_location, |
Brian Carlstrom | 756ee4e | 2013-10-03 15:46:12 -0700 | [diff] [blame] | 245 | const uint32_t* const dex_location_checksum, |
Vladimir Marko | 3f5838d | 2014-08-07 18:07:18 +0100 | [diff] [blame] | 246 | bool exception_if_not_found = true) const |
| 247 | LOCKS_EXCLUDED(secondary_lookup_lock_); |
Ian Rogers | 8d31bbd | 2013-10-13 10:44:14 -0700 | [diff] [blame] | 248 | |
Brian Carlstrom | aded5f7 | 2011-10-07 17:15:04 -0700 | [diff] [blame] | 249 | std::vector<const OatDexFile*> GetOatDexFiles() const; |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 250 | |
Ian Rogers | 30fab40 | 2012-01-23 15:43:46 -0800 | [diff] [blame] | 251 | size_t Size() const { |
| 252 | return End() - Begin(); |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 253 | } |
| 254 | |
Alex Light | 53cb16b | 2014-06-12 11:26:29 -0700 | [diff] [blame] | 255 | const byte* Begin() const; |
| 256 | const byte* End() const; |
| 257 | |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 258 | private: |
Brian Carlstrom | 700c8d3 | 2012-11-05 10:42:02 -0800 | [diff] [blame] | 259 | static void CheckLocation(const std::string& location); |
| 260 | |
| 261 | static OatFile* OpenDlopen(const std::string& elf_filename, |
| 262 | const std::string& location, |
Ian Rogers | 8d31bbd | 2013-10-13 10:44:14 -0700 | [diff] [blame] | 263 | byte* requested_base, |
| 264 | std::string* error_msg); |
Brian Carlstrom | 700c8d3 | 2012-11-05 10:42:02 -0800 | [diff] [blame] | 265 | |
| 266 | static OatFile* OpenElfFile(File* file, |
| 267 | const std::string& location, |
| 268 | byte* requested_base, |
Brian Carlstrom | f1d3455 | 2013-07-12 20:22:23 -0700 | [diff] [blame] | 269 | bool writable, |
Ian Rogers | 8d31bbd | 2013-10-13 10:44:14 -0700 | [diff] [blame] | 270 | bool executable, |
| 271 | std::string* error_msg); |
Brian Carlstrom | 700c8d3 | 2012-11-05 10:42:02 -0800 | [diff] [blame] | 272 | |
Elliott Hughes | a51a3dd | 2011-10-17 15:19:26 -0700 | [diff] [blame] | 273 | explicit OatFile(const std::string& filename); |
Ian Rogers | 8d31bbd | 2013-10-13 10:44:14 -0700 | [diff] [blame] | 274 | bool Dlopen(const std::string& elf_filename, byte* requested_base, std::string* error_msg); |
| 275 | bool ElfFileOpen(File* file, byte* requested_base, bool writable, bool executable, |
| 276 | std::string* error_msg); |
| 277 | bool Setup(std::string* error_msg); |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 278 | |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 279 | // The oat file name. |
| 280 | // |
| 281 | // The image will embed this to link its associated oat file. |
| 282 | const std::string location_; |
| 283 | |
Brian Carlstrom | 700c8d3 | 2012-11-05 10:42:02 -0800 | [diff] [blame] | 284 | // Pointer to OatHeader. |
| 285 | const byte* begin_; |
| 286 | |
| 287 | // Pointer to end of oat region for bounds checking. |
| 288 | const byte* end_; |
| 289 | |
| 290 | // Backing memory map for oat file during when opened by ElfWriter during initial compilation. |
Ian Rogers | 700a402 | 2014-05-19 16:49:03 -0700 | [diff] [blame] | 291 | std::unique_ptr<MemMap> mem_map_; |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 292 | |
Brian Carlstrom | 700c8d3 | 2012-11-05 10:42:02 -0800 | [diff] [blame] | 293 | // Backing memory map for oat file during cross compilation. |
Ian Rogers | 700a402 | 2014-05-19 16:49:03 -0700 | [diff] [blame] | 294 | std::unique_ptr<ElfFile> elf_file_; |
Brian Carlstrom | 700c8d3 | 2012-11-05 10:42:02 -0800 | [diff] [blame] | 295 | |
| 296 | // dlopen handle during runtime. |
| 297 | void* dlopen_handle_; |
| 298 | |
Vladimir Marko | 3f5838d | 2014-08-07 18:07:18 +0100 | [diff] [blame] | 299 | // NOTE: We use a StringPiece as the key type to avoid a memory allocation on every |
| 300 | // lookup with a const char* key. The StringPiece doesn't own its backing storage, |
| 301 | // therefore we're using the OatDexFile::dex_file_location_ as the backing storage |
| 302 | // for keys in oat_dex_files_ and the string_cache_ entries for the backing storage |
| 303 | // of keys in secondary_oat_dex_files_ and oat_dex_files_by_canonical_location_. |
Vladimir Marko | 539690a | 2014-06-05 18:36:42 +0100 | [diff] [blame] | 304 | typedef SafeMap<StringPiece, const OatDexFile*> Table; |
Vladimir Marko | 3f5838d | 2014-08-07 18:07:18 +0100 | [diff] [blame] | 305 | |
| 306 | // Map each plain dex file location retrieved from the oat file to its OatDexFile. |
| 307 | // This map doesn't change after it's constructed in Setup() and therefore doesn't |
| 308 | // need any locking and provides the cheapest dex file lookup for GetOatDexFile() |
| 309 | // for a very frequent use case. Never contains a nullptr value. |
| 310 | Table oat_dex_files_; // Owns the OatDexFile* values. |
| 311 | |
| 312 | // Lock guarding all members needed for secondary lookup in GetOatDexFile(). |
| 313 | mutable Mutex secondary_lookup_lock_ DEFAULT_MUTEX_ACQUIRED_AFTER; |
| 314 | |
| 315 | // If the primary oat_dex_files_ lookup fails, use a secondary map. This map stores |
| 316 | // the results of all previous secondary lookups, whether successful (non-null) or |
| 317 | // failed (null). If it doesn't contain an entry we need to calculate the canonical |
| 318 | // location and use oat_dex_files_by_canonical_location_. |
| 319 | mutable Table secondary_oat_dex_files_ GUARDED_BY(secondary_lookup_lock_); |
| 320 | |
| 321 | // Map the canonical location to an OatDexFile. This lazily constructed map is used |
| 322 | // when we're doing the secondary lookup for a given location for the first time. |
| 323 | mutable Table oat_dex_files_by_canonical_location_ GUARDED_BY(secondary_lookup_lock_); |
| 324 | |
| 325 | // Cache of strings. Contains the backing storage for keys in the secondary_oat_dex_files_ |
| 326 | // and the lazily initialized oat_dex_files_by_canonical_location_. |
| 327 | // NOTE: We're keeping references to contained strings in form of StringPiece and adding |
| 328 | // new strings to the end. The adding of a new element must not touch any previously stored |
| 329 | // elements. std::list<> and std::deque<> satisfy this requirement, std::vector<> doesn't. |
| 330 | mutable std::list<std::string> string_cache_ GUARDED_BY(secondary_lookup_lock_); |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 331 | |
| 332 | friend class OatClass; |
| 333 | friend class OatDexFile; |
Elliott Hughes | e3c845c | 2012-02-28 17:23:01 -0800 | [diff] [blame] | 334 | friend class OatDumper; // For GetBase and GetLimit |
Brian Carlstrom | e24fa61 | 2011-09-29 00:53:55 -0700 | [diff] [blame] | 335 | DISALLOW_COPY_AND_ASSIGN(OatFile); |
| 336 | }; |
| 337 | |
| 338 | } // namespace art |
| 339 | |
Brian Carlstrom | fc0e321 | 2013-07-17 14:40:12 -0700 | [diff] [blame] | 340 | #endif // ART_RUNTIME_OAT_FILE_H_ |