summaryrefslogtreecommitdiffstats
path: root/runtime/oat_file.h
diff options
context:
space:
mode:
Diffstat (limited to 'runtime/oat_file.h')
-rw-r--r--runtime/oat_file.h259
1 files changed, 259 insertions, 0 deletions
diff --git a/runtime/oat_file.h b/runtime/oat_file.h
new file mode 100644
index 0000000..0bf79a9
--- /dev/null
+++ b/runtime/oat_file.h
@@ -0,0 +1,259 @@
+/*
+ * Copyright (C) 2011 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_OAT_FILE_H_
+#define ART_SRC_OAT_FILE_H_
+
+#include <string>
+#include <vector>
+
+#include "dex_file.h"
+#include "invoke_type.h"
+#include "mem_map.h"
+#include "mirror/abstract_method.h"
+#include "oat.h"
+#include "os.h"
+
+namespace art {
+
+class ElfFile;
+class MemMap;
+class OatMethodOffsets;
+class OatHeader;
+
+class OatFile {
+ public:
+ // Returns an .odex file name next adjacent to the dex location.
+ // For example, for "/foo/bar/baz.jar", return "/foo/bar/baz.odex".
+ static std::string DexFilenameToOdexFilename(const std::string& location);
+
+ // Open an oat file. Returns NULL on failure. Requested base can
+ // optionally be used to request where the file should be loaded.
+ static OatFile* Open(const std::string& filename,
+ const std::string& location,
+ byte* requested_base);
+
+ // Open an oat file from an already opened File.
+ // Does not use dlopen underneath so cannot be used for runtime use
+ // where relocations may be required. Currently used from
+ // ImageWriter which wants to open a writable version from an existing
+ // file descriptor for patching.
+ static OatFile* OpenWritable(File* file, const std::string& location);
+
+ // Open an oat file backed by a std::vector with the given location.
+ static OatFile* OpenMemory(std::vector<uint8_t>& oat_contents,
+ const std::string& location);
+
+ ~OatFile();
+
+ const std::string& GetLocation() const {
+ return location_;
+ }
+
+ const OatHeader& GetOatHeader() const;
+
+ class OatDexFile;
+
+ class OatMethod {
+ public:
+ void LinkMethod(mirror::AbstractMethod* method) const;
+
+ uint32_t GetCodeOffset() const {
+ return code_offset_;
+ }
+ size_t GetFrameSizeInBytes() const {
+ return frame_size_in_bytes_;
+ }
+ uint32_t GetCoreSpillMask() const {
+ return core_spill_mask_;
+ }
+ uint32_t GetFpSpillMask() const {
+ return fp_spill_mask_;
+ }
+ uint32_t GetMappingTableOffset() const {
+ return mapping_table_offset_;
+ }
+ uint32_t GetVmapTableOffset() const {
+ return vmap_table_offset_;
+ }
+ uint32_t GetNativeGcMapOffset() const {
+ return native_gc_map_offset_;
+ }
+
+ const void* GetCode() const;
+ uint32_t GetCodeSize() const;
+
+ const uint32_t* GetMappingTable() const {
+ return GetOatPointer<const uint32_t*>(mapping_table_offset_);
+ }
+ const uint16_t* GetVmapTable() const {
+ return GetOatPointer<const uint16_t*>(vmap_table_offset_);
+ }
+ const uint8_t* GetNativeGcMap() const {
+ return GetOatPointer<const uint8_t*>(native_gc_map_offset_);
+ }
+
+ ~OatMethod();
+
+ // Create an OatMethod with offsets relative to the given base address
+ OatMethod(const byte* base,
+ const uint32_t code_offset,
+ const size_t frame_size_in_bytes,
+ const uint32_t core_spill_mask,
+ const uint32_t fp_spill_mask,
+ const uint32_t mapping_table_offset,
+ const uint32_t vmap_table_offset,
+ const uint32_t gc_map_offset);
+
+ private:
+ template<class T>
+ T GetOatPointer(uint32_t offset) const {
+ if (offset == 0) {
+ return NULL;
+ }
+ return reinterpret_cast<T>(begin_ + offset);
+ }
+
+ const byte* begin_;
+
+ uint32_t code_offset_;
+ size_t frame_size_in_bytes_;
+ uint32_t core_spill_mask_;
+ uint32_t fp_spill_mask_;
+ uint32_t mapping_table_offset_;
+ uint32_t vmap_table_offset_;
+ uint32_t native_gc_map_offset_;
+
+ friend class OatClass;
+ };
+
+ class OatClass {
+ public:
+ mirror::Class::Status GetStatus() const;
+
+ // get the OatMethod entry based on its index into the class
+ // defintion. direct methods come first, followed by virtual
+ // methods. note that runtime created methods such as miranda
+ // methods are not included.
+ const OatMethod GetOatMethod(uint32_t method_index) const;
+ ~OatClass();
+
+ private:
+ OatClass(const OatFile* oat_file,
+ mirror::Class::Status status,
+ const OatMethodOffsets* methods_pointer);
+
+ const OatFile* oat_file_;
+ const mirror::Class::Status status_;
+ const OatMethodOffsets* methods_pointer_;
+
+ friend class OatDexFile;
+ };
+
+ class OatDexFile {
+ public:
+ const DexFile* OpenDexFile() const;
+ const OatClass* GetOatClass(uint32_t class_def_index) const;
+ size_t FileSize() const;
+
+ const std::string& GetDexFileLocation() const {
+ return dex_file_location_;
+ }
+
+ uint32_t GetDexFileLocationChecksum() const {
+ return dex_file_location_checksum_;
+ }
+
+ ~OatDexFile();
+
+ private:
+ OatDexFile(const OatFile* oat_file,
+ const std::string& dex_file_location,
+ uint32_t dex_file_checksum,
+ const byte* dex_file_pointer,
+ const uint32_t* oat_class_offsets_pointer);
+
+ const OatFile* oat_file_;
+ std::string dex_file_location_;
+ uint32_t dex_file_location_checksum_;
+ const byte* dex_file_pointer_;
+ const uint32_t* oat_class_offsets_pointer_;
+
+ friend class OatFile;
+ DISALLOW_COPY_AND_ASSIGN(OatDexFile);
+ };
+
+ const OatDexFile* GetOatDexFile(const std::string& dex_file_location,
+ bool exception_if_not_found = true) const
+ SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
+ std::vector<const OatDexFile*> GetOatDexFiles() const;
+
+ size_t Size() const {
+ return End() - Begin();
+ }
+
+ private:
+ static void CheckLocation(const std::string& location);
+
+ static OatFile* OpenDlopen(const std::string& elf_filename,
+ const std::string& location,
+ byte* requested_base);
+
+ static OatFile* OpenElfFile(File* file,
+ const std::string& location,
+ byte* requested_base,
+ bool writable);
+
+ explicit OatFile(const std::string& filename);
+ bool Dlopen(const std::string& elf_filename, byte* requested_base);
+ bool ElfFileOpen(File* file, byte* requested_base, bool writable);
+ bool Setup();
+
+ const byte* Begin() const;
+ const byte* End() const;
+
+ // The oat file name.
+ //
+ // The image will embed this to link its associated oat file.
+ const std::string location_;
+
+ // Pointer to OatHeader.
+ const byte* begin_;
+
+ // Pointer to end of oat region for bounds checking.
+ const byte* end_;
+
+ // Backing memory map for oat file during when opened by ElfWriter during initial compilation.
+ UniquePtr<MemMap> mem_map_;
+
+ // Backing memory map for oat file during cross compilation.
+ UniquePtr<ElfFile> elf_file_;
+
+ // dlopen handle during runtime.
+ void* dlopen_handle_;
+
+ typedef SafeMap<std::string, const OatDexFile*> Table;
+ Table oat_dex_files_;
+
+ friend class OatClass;
+ friend class OatDexFile;
+ friend class OatDumper; // For GetBase and GetLimit
+ DISALLOW_COPY_AND_ASSIGN(OatFile);
+};
+
+} // namespace art
+
+#endif // ART_SRC_OAT_WRITER_H_