• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright (C) 2014 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 ART_COMPILER_ELF_PATCHER_H_
18 #define ART_COMPILER_ELF_PATCHER_H_
19 
20 #include "base/mutex.h"
21 #include "driver/compiler_driver.h"
22 #include "elf_file.h"
23 #include "mirror/art_method.h"
24 #include "mirror/class.h"
25 #include "mirror/object.h"
26 #include "oat_file.h"
27 #include "oat.h"
28 #include "os.h"
29 
30 namespace art {
31 
32 class ElfPatcher {
33  public:
34   typedef void* (*ImageAddressCallback)(void* data, mirror::Object* obj);
35 
36   static bool Patch(const CompilerDriver* driver, ElfFile* elf_file,
37                     const std::string& oat_location,
38                     ImageAddressCallback cb, void* cb_data,
39                     std::string* error_msg)
40       SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
41 
42   static bool Patch(const CompilerDriver* driver, ElfFile* elf_file,
43                     const OatFile* oat_file, uintptr_t oat_data_begin,
44                     ImageAddressCallback cb, void* cb_data,
45                     std::string* error_msg)
46       SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
47 
Patch(const CompilerDriver * driver,ElfFile * elf_file,const std::string & oat_location,std::string * error_msg)48   static bool Patch(const CompilerDriver* driver, ElfFile* elf_file,
49                     const std::string& oat_location,
50                     std::string* error_msg)
51       SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) {
52     return ElfPatcher::Patch(driver, elf_file, oat_location,
53                              DefaultImageAddressCallback, nullptr, error_msg);
54   }
55 
Patch(const CompilerDriver * driver,ElfFile * elf_file,const OatFile * oat_file,uintptr_t oat_data_begin,std::string * error_msg)56   static bool Patch(const CompilerDriver* driver, ElfFile* elf_file,
57                     const OatFile* oat_file, uintptr_t oat_data_begin,
58                     std::string* error_msg)
59       SHARED_LOCKS_REQUIRED(Locks::mutator_lock_) {
60     return ElfPatcher::Patch(driver, elf_file, oat_file, oat_data_begin,
61                              DefaultImageAddressCallback, nullptr, error_msg);
62   }
63 
64  private:
ElfPatcher(const CompilerDriver * driver,ElfFile * elf_file,const OatFile * oat_file,OatHeader * oat_header,uintptr_t oat_data_begin,ImageAddressCallback cb,void * cb_data,std::string * error_msg)65   ElfPatcher(const CompilerDriver* driver, ElfFile* elf_file, const OatFile* oat_file,
66              OatHeader* oat_header, uintptr_t oat_data_begin,
67              ImageAddressCallback cb, void* cb_data, std::string* error_msg)
68       : compiler_driver_(driver), elf_file_(elf_file), oat_file_(oat_file),
69         oat_header_(oat_header), oat_data_begin_(oat_data_begin), get_image_address_(cb),
70         cb_data_(cb_data), error_msg_(error_msg),
71         write_patches_(compiler_driver_->GetCompilerOptions().GetIncludePatchInformation()) {}
~ElfPatcher()72   ~ElfPatcher() {}
73 
DefaultImageAddressCallback(void * data_unused,mirror::Object * obj)74   static void* DefaultImageAddressCallback(void* data_unused, mirror::Object* obj) {
75     return static_cast<void*>(obj);
76   }
77 
78   bool PatchElf()
79       SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
80 
81   mirror::ArtMethod* GetTargetMethod(const CompilerDriver::CallPatchInformation* patch)
82       SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
83 
84   mirror::Class* GetTargetType(const CompilerDriver::TypePatchInformation* patch)
85       SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
86 
87   void AddPatch(uintptr_t off);
88 
89   void SetPatchLocation(const CompilerDriver::PatchInformation* patch, uint32_t value)
90       SHARED_LOCKS_REQUIRED(Locks::mutator_lock_);
91 
92   // Takes the pointer into the oat_file_ and get the pointer in to the ElfFile.
93   uint32_t* GetPatchLocation(uintptr_t patch_ptr);
94 
95   bool WriteOutPatchData();
96 
GetBaseAddressFor(const OatFile * f)97   uintptr_t GetBaseAddressFor(const OatFile* f) {
98     if (f == oat_file_) {
99       return oat_data_begin_;
100     } else {
101       return reinterpret_cast<uintptr_t>(f->Begin());
102     }
103   }
104 
105   const CompilerDriver* compiler_driver_;
106 
107   // The elf_file containing the oat_data we are patching up
108   ElfFile* elf_file_;
109 
110   // The oat_file that is actually loaded.
111   const OatFile* oat_file_;
112 
113   // The oat_header_ within the elf_file_
114   OatHeader* oat_header_;
115 
116   // Where the elf_file will be loaded during normal runs.
117   uintptr_t oat_data_begin_;
118 
119   // Callback to get image addresses.
120   ImageAddressCallback get_image_address_;
121   void* cb_data_;
122 
123   std::string* error_msg_;
124   std::vector<uintptr_t> patches_;
125   std::set<uintptr_t> patches_set_;
126   bool write_patches_;
127 
128   DISALLOW_COPY_AND_ASSIGN(ElfPatcher);
129 };
130 
131 }  // namespace art
132 #endif  // ART_COMPILER_ELF_PATCHER_H_
133