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 #include "oat_file_assistant.h"
18
19 #include <sstream>
20
21 #include <sys/stat.h>
22 #include "zlib.h"
23
24 #include "android-base/stringprintf.h"
25 #include "android-base/strings.h"
26
27 #include "base/file_utils.h"
28 #include "base/logging.h" // For VLOG.
29 #include "base/macros.h"
30 #include "base/os.h"
31 #include "base/stl_util.h"
32 #include "base/string_view_cpp20.h"
33 #include "base/utils.h"
34 #include "class_linker.h"
35 #include "class_loader_context.h"
36 #include "compiler_filter.h"
37 #include "dex/art_dex_file_loader.h"
38 #include "dex/dex_file_loader.h"
39 #include "exec_utils.h"
40 #include "gc/heap.h"
41 #include "gc/space/image_space.h"
42 #include "image.h"
43 #include "oat.h"
44 #include "runtime.h"
45 #include "scoped_thread_state_change-inl.h"
46 #include "vdex_file.h"
47
48 namespace art {
49
50 using android::base::StringPrintf;
51
52 static constexpr const char* kAnonymousDexPrefix = "Anonymous-DexFile@";
53 static constexpr const char* kVdexExtension = ".vdex";
54
operator <<(std::ostream & stream,const OatFileAssistant::OatStatus status)55 std::ostream& operator << (std::ostream& stream, const OatFileAssistant::OatStatus status) {
56 switch (status) {
57 case OatFileAssistant::kOatCannotOpen:
58 stream << "kOatCannotOpen";
59 break;
60 case OatFileAssistant::kOatDexOutOfDate:
61 stream << "kOatDexOutOfDate";
62 break;
63 case OatFileAssistant::kOatBootImageOutOfDate:
64 stream << "kOatBootImageOutOfDate";
65 break;
66 case OatFileAssistant::kOatUpToDate:
67 stream << "kOatUpToDate";
68 break;
69 default:
70 UNREACHABLE();
71 }
72
73 return stream;
74 }
75
OatFileAssistant(const char * dex_location,const InstructionSet isa,bool load_executable,bool only_load_system_executable)76 OatFileAssistant::OatFileAssistant(const char* dex_location,
77 const InstructionSet isa,
78 bool load_executable,
79 bool only_load_system_executable)
80 : OatFileAssistant(dex_location,
81 isa,
82 load_executable,
83 only_load_system_executable,
84 /*vdex_fd=*/ -1,
85 /*oat_fd=*/ -1,
86 /*zip_fd=*/ -1) {}
87
88
OatFileAssistant(const char * dex_location,const InstructionSet isa,bool load_executable,bool only_load_system_executable,int vdex_fd,int oat_fd,int zip_fd)89 OatFileAssistant::OatFileAssistant(const char* dex_location,
90 const InstructionSet isa,
91 bool load_executable,
92 bool only_load_system_executable,
93 int vdex_fd,
94 int oat_fd,
95 int zip_fd)
96 : isa_(isa),
97 load_executable_(load_executable),
98 only_load_system_executable_(only_load_system_executable),
99 odex_(this, /*is_oat_location=*/ false),
100 oat_(this, /*is_oat_location=*/ true),
101 zip_fd_(zip_fd) {
102 CHECK(dex_location != nullptr) << "OatFileAssistant: null dex location";
103
104 if (zip_fd < 0) {
105 CHECK_LE(oat_fd, 0) << "zip_fd must be provided with valid oat_fd. zip_fd=" << zip_fd
106 << " oat_fd=" << oat_fd;
107 CHECK_LE(vdex_fd, 0) << "zip_fd must be provided with valid vdex_fd. zip_fd=" << zip_fd
108 << " vdex_fd=" << vdex_fd;;
109 }
110
111 dex_location_.assign(dex_location);
112
113 if (load_executable_ && isa != kRuntimeISA) {
114 LOG(WARNING) << "OatFileAssistant: Load executable specified, "
115 << "but isa is not kRuntimeISA. Will not attempt to load executable.";
116 load_executable_ = false;
117 }
118
119 // Get the odex filename.
120 std::string error_msg;
121 std::string odex_file_name;
122 if (DexLocationToOdexFilename(dex_location_, isa_, &odex_file_name, &error_msg)) {
123 odex_.Reset(odex_file_name, UseFdToReadFiles(), zip_fd, vdex_fd, oat_fd);
124 } else {
125 LOG(WARNING) << "Failed to determine odex file name: " << error_msg;
126 }
127
128 if (!UseFdToReadFiles()) {
129 // Get the oat filename.
130 std::string oat_file_name;
131 if (DexLocationToOatFilename(dex_location_, isa_, &oat_file_name, &error_msg)) {
132 oat_.Reset(oat_file_name, /*use_fd=*/ false);
133 } else {
134 LOG(WARNING) << "Failed to determine oat file name for dex location "
135 << dex_location_ << ": " << error_msg;
136 }
137 }
138
139 // Check if the dex directory is writable.
140 // This will be needed in most uses of OatFileAssistant and so it's OK to
141 // compute it eagerly. (the only use which will not make use of it is
142 // OatFileAssistant::GetStatusDump())
143 size_t pos = dex_location_.rfind('/');
144 if (pos == std::string::npos) {
145 LOG(WARNING) << "Failed to determine dex file parent directory: " << dex_location_;
146 } else if (!UseFdToReadFiles()) {
147 // We cannot test for parent access when using file descriptors. That's ok
148 // because in this case we will always pick the odex file anyway.
149 std::string parent = dex_location_.substr(0, pos);
150 if (access(parent.c_str(), W_OK) == 0) {
151 dex_parent_writable_ = true;
152 } else {
153 VLOG(oat) << "Dex parent of " << dex_location_ << " is not writable: " << strerror(errno);
154 }
155 }
156 }
157
~OatFileAssistant()158 OatFileAssistant::~OatFileAssistant() {
159 // Clean up the lock file.
160 if (flock_.get() != nullptr) {
161 unlink(flock_->GetPath().c_str());
162 }
163 }
164
UseFdToReadFiles()165 bool OatFileAssistant::UseFdToReadFiles() {
166 return zip_fd_ >= 0;
167 }
168
IsInBootClassPath()169 bool OatFileAssistant::IsInBootClassPath() {
170 // Note: We check the current boot class path, regardless of the ISA
171 // specified by the user. This is okay, because the boot class path should
172 // be the same for all ISAs.
173 // TODO: Can we verify the boot class path is the same for all ISAs?
174 Runtime* runtime = Runtime::Current();
175 ClassLinker* class_linker = runtime->GetClassLinker();
176 const auto& boot_class_path = class_linker->GetBootClassPath();
177 for (size_t i = 0; i < boot_class_path.size(); i++) {
178 if (boot_class_path[i]->GetLocation() == dex_location_) {
179 VLOG(oat) << "Dex location " << dex_location_ << " is in boot class path";
180 return true;
181 }
182 }
183 return false;
184 }
185
GetDexOptNeeded(CompilerFilter::Filter target,bool profile_changed,bool downgrade,ClassLoaderContext * class_loader_context,const std::vector<int> & context_fds)186 int OatFileAssistant::GetDexOptNeeded(CompilerFilter::Filter target,
187 bool profile_changed,
188 bool downgrade,
189 ClassLoaderContext* class_loader_context,
190 const std::vector<int>& context_fds) {
191 OatFileInfo& info = GetBestInfo();
192 DexOptNeeded dexopt_needed = info.GetDexOptNeeded(target,
193 profile_changed,
194 downgrade,
195 class_loader_context,
196 context_fds);
197 if (info.IsOatLocation() || dexopt_needed == kDex2OatFromScratch) {
198 return dexopt_needed;
199 }
200 return -dexopt_needed;
201 }
202
IsUpToDate()203 bool OatFileAssistant::IsUpToDate() {
204 return GetBestInfo().Status() == kOatUpToDate;
205 }
206
GetBestOatFile()207 std::unique_ptr<OatFile> OatFileAssistant::GetBestOatFile() {
208 return GetBestInfo().ReleaseFileForUse();
209 }
210
GetStatusDump()211 std::string OatFileAssistant::GetStatusDump() {
212 std::ostringstream status;
213 bool oat_file_exists = false;
214 bool odex_file_exists = false;
215 if (oat_.Status() != kOatCannotOpen) {
216 // If we can open the file, Filename should not return null.
217 CHECK(oat_.Filename() != nullptr);
218
219 oat_file_exists = true;
220 status << *oat_.Filename() << "[status=" << oat_.Status() << ", ";
221 const OatFile* file = oat_.GetFile();
222 if (file == nullptr) {
223 // If the file is null even though the status is not kOatCannotOpen, it
224 // means we must have a vdex file with no corresponding oat file. In
225 // this case we cannot determine the compilation filter. Indicate that
226 // we have only the vdex file instead.
227 status << "vdex-only";
228 } else {
229 status << "compilation_filter=" << CompilerFilter::NameOfFilter(file->GetCompilerFilter());
230 }
231 }
232
233 if (odex_.Status() != kOatCannotOpen) {
234 // If we can open the file, Filename should not return null.
235 CHECK(odex_.Filename() != nullptr);
236
237 odex_file_exists = true;
238 if (oat_file_exists) {
239 status << "] ";
240 }
241 status << *odex_.Filename() << "[status=" << odex_.Status() << ", ";
242 const OatFile* file = odex_.GetFile();
243 if (file == nullptr) {
244 status << "vdex-only";
245 } else {
246 status << "compilation_filter=" << CompilerFilter::NameOfFilter(file->GetCompilerFilter());
247 }
248 }
249
250 if (!oat_file_exists && !odex_file_exists) {
251 status << "invalid[";
252 }
253
254 status << "]";
255 return status.str();
256 }
257
LoadDexFiles(const OatFile & oat_file,const char * dex_location)258 std::vector<std::unique_ptr<const DexFile>> OatFileAssistant::LoadDexFiles(
259 const OatFile &oat_file, const char *dex_location) {
260 std::vector<std::unique_ptr<const DexFile>> dex_files;
261 if (LoadDexFiles(oat_file, dex_location, &dex_files)) {
262 return dex_files;
263 } else {
264 return std::vector<std::unique_ptr<const DexFile>>();
265 }
266 }
267
LoadDexFiles(const OatFile & oat_file,const std::string & dex_location,std::vector<std::unique_ptr<const DexFile>> * out_dex_files)268 bool OatFileAssistant::LoadDexFiles(
269 const OatFile &oat_file,
270 const std::string& dex_location,
271 std::vector<std::unique_ptr<const DexFile>>* out_dex_files) {
272 // Load the main dex file.
273 std::string error_msg;
274 const OatDexFile* oat_dex_file = oat_file.GetOatDexFile(
275 dex_location.c_str(), nullptr, &error_msg);
276 if (oat_dex_file == nullptr) {
277 LOG(WARNING) << error_msg;
278 return false;
279 }
280
281 std::unique_ptr<const DexFile> dex_file = oat_dex_file->OpenDexFile(&error_msg);
282 if (dex_file.get() == nullptr) {
283 LOG(WARNING) << "Failed to open dex file from oat dex file: " << error_msg;
284 return false;
285 }
286 out_dex_files->push_back(std::move(dex_file));
287
288 // Load the rest of the multidex entries
289 for (size_t i = 1;; i++) {
290 std::string multidex_dex_location = DexFileLoader::GetMultiDexLocation(i, dex_location.c_str());
291 oat_dex_file = oat_file.GetOatDexFile(multidex_dex_location.c_str(), nullptr);
292 if (oat_dex_file == nullptr) {
293 // There are no more multidex entries to load.
294 break;
295 }
296
297 dex_file = oat_dex_file->OpenDexFile(&error_msg);
298 if (dex_file.get() == nullptr) {
299 LOG(WARNING) << "Failed to open dex file from oat dex file: " << error_msg;
300 return false;
301 }
302 out_dex_files->push_back(std::move(dex_file));
303 }
304 return true;
305 }
306
HasOriginalDexFiles()307 bool OatFileAssistant::HasOriginalDexFiles() {
308 // Ensure GetRequiredDexChecksums has been run so that
309 // has_original_dex_files_ is initialized. We don't care about the result of
310 // GetRequiredDexChecksums.
311 GetRequiredDexChecksums();
312 return has_original_dex_files_;
313 }
314
OdexFileStatus()315 OatFileAssistant::OatStatus OatFileAssistant::OdexFileStatus() {
316 return odex_.Status();
317 }
318
OatFileStatus()319 OatFileAssistant::OatStatus OatFileAssistant::OatFileStatus() {
320 return oat_.Status();
321 }
322
DexChecksumUpToDate(const VdexFile & file,std::string * error_msg)323 bool OatFileAssistant::DexChecksumUpToDate(const VdexFile& file, std::string* error_msg) {
324 const std::vector<uint32_t>* required_dex_checksums = GetRequiredDexChecksums();
325 if (required_dex_checksums == nullptr) {
326 LOG(WARNING) << "Required dex checksums not found. Assuming dex checksums are up to date.";
327 return true;
328 }
329
330 uint32_t number_of_dex_files = file.GetVerifierDepsHeader().GetNumberOfDexFiles();
331 if (required_dex_checksums->size() != number_of_dex_files) {
332 *error_msg = StringPrintf("expected %zu dex files but found %u",
333 required_dex_checksums->size(),
334 number_of_dex_files);
335 return false;
336 }
337
338 for (uint32_t i = 0; i < number_of_dex_files; i++) {
339 uint32_t expected_checksum = (*required_dex_checksums)[i];
340 uint32_t actual_checksum = file.GetLocationChecksum(i);
341 if (expected_checksum != actual_checksum) {
342 std::string dex = DexFileLoader::GetMultiDexLocation(i, dex_location_.c_str());
343 *error_msg = StringPrintf("Dex checksum does not match for dex: %s."
344 "Expected: %u, actual: %u",
345 dex.c_str(),
346 expected_checksum,
347 actual_checksum);
348 return false;
349 }
350 }
351
352 return true;
353 }
354
DexChecksumUpToDate(const OatFile & file,std::string * error_msg)355 bool OatFileAssistant::DexChecksumUpToDate(const OatFile& file, std::string* error_msg) {
356 const std::vector<uint32_t>* required_dex_checksums = GetRequiredDexChecksums();
357 if (required_dex_checksums == nullptr) {
358 LOG(WARNING) << "Required dex checksums not found. Assuming dex checksums are up to date.";
359 return true;
360 }
361
362 uint32_t number_of_dex_files = file.GetOatHeader().GetDexFileCount();
363 if (required_dex_checksums->size() != number_of_dex_files) {
364 *error_msg = StringPrintf("expected %zu dex files but found %u",
365 required_dex_checksums->size(),
366 number_of_dex_files);
367 return false;
368 }
369
370 for (uint32_t i = 0; i < number_of_dex_files; i++) {
371 std::string dex = DexFileLoader::GetMultiDexLocation(i, dex_location_.c_str());
372 uint32_t expected_checksum = (*required_dex_checksums)[i];
373 const OatDexFile* oat_dex_file = file.GetOatDexFile(dex.c_str(), nullptr);
374 if (oat_dex_file == nullptr) {
375 *error_msg = StringPrintf("failed to find %s in %s", dex.c_str(), file.GetLocation().c_str());
376 return false;
377 }
378 uint32_t actual_checksum = oat_dex_file->GetDexFileLocationChecksum();
379 if (expected_checksum != actual_checksum) {
380 VLOG(oat) << "Dex checksum does not match for dex: " << dex
381 << ". Expected: " << expected_checksum
382 << ", Actual: " << actual_checksum;
383 return false;
384 }
385 }
386 return true;
387 }
388
GivenOatFileStatus(const OatFile & file)389 OatFileAssistant::OatStatus OatFileAssistant::GivenOatFileStatus(const OatFile& file) {
390 // Verify the ART_USE_READ_BARRIER state.
391 // TODO: Don't fully reject files due to read barrier state. If they contain
392 // compiled code and are otherwise okay, we should return something like
393 // kOatRelocationOutOfDate. If they don't contain compiled code, the read
394 // barrier state doesn't matter.
395 const bool is_cc = file.GetOatHeader().IsConcurrentCopying();
396 constexpr bool kRuntimeIsCC = kUseReadBarrier;
397 if (is_cc != kRuntimeIsCC) {
398 return kOatCannotOpen;
399 }
400
401 // Verify the dex checksum.
402 std::string error_msg;
403 VdexFile* vdex = file.GetVdexFile();
404 if (!DexChecksumUpToDate(*vdex, &error_msg)) {
405 LOG(ERROR) << error_msg;
406 return kOatDexOutOfDate;
407 }
408
409 CompilerFilter::Filter current_compiler_filter = file.GetCompilerFilter();
410
411 // Verify the image checksum
412 if (CompilerFilter::DependsOnImageChecksum(current_compiler_filter)) {
413 if (!ValidateBootClassPathChecksums(file)) {
414 VLOG(oat) << "Oat image checksum does not match image checksum.";
415 return kOatBootImageOutOfDate;
416 }
417 } else {
418 VLOG(oat) << "Image checksum test skipped for compiler filter " << current_compiler_filter;
419 }
420
421 // zip_file_only_contains_uncompressed_dex_ is only set during fetching the dex checksums.
422 DCHECK(required_dex_checksums_attempted_);
423 if (only_load_system_executable_ &&
424 !LocationIsOnSystem(file.GetLocation().c_str()) &&
425 file.ContainsDexCode() &&
426 zip_file_only_contains_uncompressed_dex_) {
427 LOG(ERROR) << "Not loading "
428 << dex_location_
429 << ": oat file has dex code, but APK has uncompressed dex code";
430 return kOatDexOutOfDate;
431 }
432
433 return kOatUpToDate;
434 }
435
AnonymousDexVdexLocation(const std::vector<const DexFile::Header * > & headers,InstructionSet isa,uint32_t * location_checksum,std::string * dex_location,std::string * vdex_filename)436 bool OatFileAssistant::AnonymousDexVdexLocation(const std::vector<const DexFile::Header*>& headers,
437 InstructionSet isa,
438 /* out */ uint32_t* location_checksum,
439 /* out */ std::string* dex_location,
440 /* out */ std::string* vdex_filename) {
441 uint32_t checksum = adler32(0L, Z_NULL, 0);
442 for (const DexFile::Header* header : headers) {
443 checksum = adler32_combine(checksum,
444 header->checksum_,
445 header->file_size_ - DexFile::kNumNonChecksumBytes);
446 }
447 *location_checksum = checksum;
448
449 const std::string& data_dir = Runtime::Current()->GetProcessDataDirectory();
450 if (data_dir.empty() || Runtime::Current()->IsZygote()) {
451 *dex_location = StringPrintf("%s%u", kAnonymousDexPrefix, checksum);
452 return false;
453 }
454 *dex_location = StringPrintf("%s/%s%u.jar", data_dir.c_str(), kAnonymousDexPrefix, checksum);
455
456 std::string odex_filename;
457 std::string error_msg;
458 if (!DexLocationToOdexFilename(*dex_location, isa, &odex_filename, &error_msg)) {
459 LOG(WARNING) << "Could not get odex filename for " << *dex_location << ": " << error_msg;
460 return false;
461 }
462
463 *vdex_filename = GetVdexFilename(odex_filename);
464 return true;
465 }
466
IsAnonymousVdexBasename(const std::string & basename)467 bool OatFileAssistant::IsAnonymousVdexBasename(const std::string& basename) {
468 DCHECK(basename.find('/') == std::string::npos);
469 // `basename` must have format: <kAnonymousDexPrefix><checksum><kVdexExtension>
470 if (basename.size() < strlen(kAnonymousDexPrefix) + strlen(kVdexExtension) + 1 ||
471 !android::base::StartsWith(basename.c_str(), kAnonymousDexPrefix) ||
472 !android::base::EndsWith(basename, kVdexExtension)) {
473 return false;
474 }
475 // Check that all characters between the prefix and extension are decimal digits.
476 for (size_t i = strlen(kAnonymousDexPrefix); i < basename.size() - strlen(kVdexExtension); ++i) {
477 if (!std::isdigit(basename[i])) {
478 return false;
479 }
480 }
481 return true;
482 }
483
DexLocationToOdexNames(const std::string & location,InstructionSet isa,std::string * odex_filename,std::string * oat_dir,std::string * isa_dir,std::string * error_msg)484 static bool DexLocationToOdexNames(const std::string& location,
485 InstructionSet isa,
486 std::string* odex_filename,
487 std::string* oat_dir,
488 std::string* isa_dir,
489 std::string* error_msg) {
490 CHECK(odex_filename != nullptr);
491 CHECK(error_msg != nullptr);
492
493 // The odex file name is formed by replacing the dex_location extension with
494 // .odex and inserting an oat/<isa> directory. For example:
495 // location = /foo/bar/baz.jar
496 // odex_location = /foo/bar/oat/<isa>/baz.odex
497
498 // Find the directory portion of the dex location and add the oat/<isa>
499 // directory.
500 size_t pos = location.rfind('/');
501 if (pos == std::string::npos) {
502 *error_msg = "Dex location " + location + " has no directory.";
503 return false;
504 }
505 std::string dir = location.substr(0, pos+1);
506 // Add the oat directory.
507 dir += "oat";
508 if (oat_dir != nullptr) {
509 *oat_dir = dir;
510 }
511 // Add the isa directory
512 dir += "/" + std::string(GetInstructionSetString(isa));
513 if (isa_dir != nullptr) {
514 *isa_dir = dir;
515 }
516
517 // Get the base part of the file without the extension.
518 std::string file = location.substr(pos+1);
519 pos = file.rfind('.');
520 if (pos == std::string::npos) {
521 *error_msg = "Dex location " + location + " has no extension.";
522 return false;
523 }
524 std::string base = file.substr(0, pos);
525
526 *odex_filename = dir + "/" + base + ".odex";
527 return true;
528 }
529
DexLocationToOdexFilename(const std::string & location,InstructionSet isa,std::string * odex_filename,std::string * error_msg)530 bool OatFileAssistant::DexLocationToOdexFilename(const std::string& location,
531 InstructionSet isa,
532 std::string* odex_filename,
533 std::string* error_msg) {
534 return DexLocationToOdexNames(location, isa, odex_filename, nullptr, nullptr, error_msg);
535 }
536
DexLocationToOatFilename(const std::string & location,InstructionSet isa,std::string * oat_filename,std::string * error_msg)537 bool OatFileAssistant::DexLocationToOatFilename(const std::string& location,
538 InstructionSet isa,
539 std::string* oat_filename,
540 std::string* error_msg) {
541 CHECK(oat_filename != nullptr);
542 CHECK(error_msg != nullptr);
543
544 // If ANDROID_DATA is not set, return false instead of aborting.
545 // This can occur for preopt when using a class loader context.
546 if (GetAndroidDataSafe(error_msg).empty()) {
547 *error_msg = "GetAndroidDataSafe failed: " + *error_msg;
548 return false;
549 }
550
551 std::string cache_dir = GetDalvikCache(GetInstructionSetString(isa));
552 if (cache_dir.empty()) {
553 *error_msg = "Dalvik cache directory does not exist";
554 return false;
555 }
556
557 // TODO: The oat file assistant should be the definitive place for
558 // determining the oat file name from the dex location, not
559 // GetDalvikCacheFilename.
560 return GetDalvikCacheFilename(location.c_str(), cache_dir.c_str(), oat_filename, error_msg);
561 }
562
GetRequiredDexChecksums()563 const std::vector<uint32_t>* OatFileAssistant::GetRequiredDexChecksums() {
564 if (!required_dex_checksums_attempted_) {
565 required_dex_checksums_attempted_ = true;
566 required_dex_checksums_found_ = false;
567 cached_required_dex_checksums_.clear();
568 std::string error_msg;
569 const ArtDexFileLoader dex_file_loader;
570 if (dex_file_loader.GetMultiDexChecksums(dex_location_.c_str(),
571 &cached_required_dex_checksums_,
572 &error_msg,
573 zip_fd_,
574 &zip_file_only_contains_uncompressed_dex_)) {
575 required_dex_checksums_found_ = true;
576 has_original_dex_files_ = true;
577 } else {
578 // This can happen if the original dex file has been stripped from the
579 // apk.
580 VLOG(oat) << "OatFileAssistant: " << error_msg;
581 has_original_dex_files_ = false;
582
583 // Get the checksums from the odex if we can.
584 const OatFile* odex_file = odex_.GetFile();
585 if (odex_file != nullptr) {
586 required_dex_checksums_found_ = true;
587 for (size_t i = 0; i < odex_file->GetOatHeader().GetDexFileCount(); i++) {
588 std::string dex = DexFileLoader::GetMultiDexLocation(i, dex_location_.c_str());
589 const OatDexFile* odex_dex_file = odex_file->GetOatDexFile(dex.c_str(), nullptr);
590 if (odex_dex_file == nullptr) {
591 required_dex_checksums_found_ = false;
592 break;
593 }
594 cached_required_dex_checksums_.push_back(odex_dex_file->GetDexFileLocationChecksum());
595 }
596 }
597 }
598 }
599 return required_dex_checksums_found_ ? &cached_required_dex_checksums_ : nullptr;
600 }
601
ValidateBootClassPathChecksums(const OatFile & oat_file)602 bool OatFileAssistant::ValidateBootClassPathChecksums(const OatFile& oat_file) {
603 // Get the BCP from the oat file.
604 const char* oat_boot_class_path =
605 oat_file.GetOatHeader().GetStoreValueByKey(OatHeader::kBootClassPathKey);
606 if (oat_boot_class_path == nullptr) {
607 return false;
608 }
609
610 // Check that the oat BCP is a prefix of current BCP locations and count components.
611 Runtime* runtime = Runtime::Current();
612 size_t component_count = 0u;
613 std::string_view remaining_bcp(oat_boot_class_path);
614 bool bcp_ok = false;
615 for (const std::string& location : runtime->GetBootClassPathLocations()) {
616 if (!StartsWith(remaining_bcp, location)) {
617 break;
618 }
619 remaining_bcp.remove_prefix(location.size());
620 ++component_count;
621 if (remaining_bcp.empty()) {
622 bcp_ok = true;
623 break;
624 }
625 if (!StartsWith(remaining_bcp, ":")) {
626 break;
627 }
628 remaining_bcp.remove_prefix(1u);
629 }
630 if (!bcp_ok) {
631 return false;
632 }
633
634 // Get the checksums.
635 const char* oat_boot_class_path_checksums =
636 oat_file.GetOatHeader().GetStoreValueByKey(OatHeader::kBootClassPathChecksumsKey);
637 if (oat_boot_class_path_checksums == nullptr) {
638 return false;
639 }
640
641 // Retrieve checksums for this portion of the BCP if we do not have them cached.
642 if (cached_boot_class_path_checksum_component_count_ != component_count) {
643 ArrayRef<const std::string> boot_class_path(runtime->GetBootClassPath());
644 std::string error_msg;
645 std::string boot_class_path_checksums = gc::space::ImageSpace::GetBootClassPathChecksums(
646 boot_class_path.SubArray(/* pos= */ 0u, component_count),
647 runtime->GetImageLocation(),
648 isa_,
649 runtime->GetImageSpaceLoadingOrder(),
650 &error_msg);
651 if (boot_class_path_checksums.empty()) {
652 VLOG(oat) << "No image for oat image checksum to match against.";
653
654 if (HasOriginalDexFiles()) {
655 return false;
656 }
657
658 // If there is no original dex file to fall back to, grudgingly accept
659 // the oat file. This could technically lead to crashes, but there's no
660 // way we could find a better oat file to use for this dex location,
661 // and it's better than being stuck in a boot loop with no way out.
662 // The problem will hopefully resolve itself the next time the runtime
663 // starts up.
664 LOG(WARNING) << "Dex location " << dex_location_ << " does not seem to include dex file. "
665 << "Allow oat file use. This is potentially dangerous.";
666
667 return true;
668 }
669 cached_boot_class_path_checksum_component_count_ = component_count;
670 cached_boot_class_path_checksums_ = boot_class_path_checksums;
671 }
672
673 // Compare the checksums.
674 return cached_boot_class_path_checksums_ == oat_boot_class_path_checksums;
675 }
676
GetBestInfo()677 OatFileAssistant::OatFileInfo& OatFileAssistant::GetBestInfo() {
678 // TODO(calin): Document the side effects of class loading when
679 // running dalvikvm command line.
680 if (dex_parent_writable_ || UseFdToReadFiles()) {
681 // If the parent of the dex file is writable it means that we can
682 // create the odex file. In this case we unconditionally pick the odex
683 // as the best oat file. This corresponds to the regular use case when
684 // apps gets installed or when they load private, secondary dex file.
685 // For apps on the system partition the odex location will not be
686 // writable and thus the oat location might be more up to date.
687 return odex_;
688 }
689
690 // We cannot write to the odex location. This must be a system app.
691
692 // If the oat location is usable take it.
693 if (oat_.IsUseable()) {
694 return oat_;
695 }
696
697 // The oat file is not usable but the odex file might be up to date.
698 // This is an indication that we are dealing with an up to date prebuilt
699 // (that doesn't need relocation).
700 if (odex_.Status() == kOatUpToDate) {
701 return odex_;
702 }
703
704 // The oat file is not usable and the odex file is not up to date.
705 // However we have access to the original dex file which means we can make
706 // the oat location up to date.
707 if (HasOriginalDexFiles()) {
708 return oat_;
709 }
710
711 // We got into the worst situation here:
712 // - the oat location is not usable
713 // - the prebuild odex location is not up to date
714 // - and we don't have the original dex file anymore (stripped).
715 // Pick the odex if it exists, or the oat if not.
716 return (odex_.Status() == kOatCannotOpen) ? oat_ : odex_;
717 }
718
OpenImageSpace(const OatFile * oat_file)719 std::unique_ptr<gc::space::ImageSpace> OatFileAssistant::OpenImageSpace(const OatFile* oat_file) {
720 DCHECK(oat_file != nullptr);
721 std::string art_file = ReplaceFileExtension(oat_file->GetLocation(), "art");
722 if (art_file.empty()) {
723 return nullptr;
724 }
725 std::string error_msg;
726 ScopedObjectAccess soa(Thread::Current());
727 std::unique_ptr<gc::space::ImageSpace> ret =
728 gc::space::ImageSpace::CreateFromAppImage(art_file.c_str(), oat_file, &error_msg);
729 if (ret == nullptr && (VLOG_IS_ON(image) || OS::FileExists(art_file.c_str()))) {
730 LOG(INFO) << "Failed to open app image " << art_file.c_str() << " " << error_msg;
731 }
732 return ret;
733 }
734
OatFileInfo(OatFileAssistant * oat_file_assistant,bool is_oat_location)735 OatFileAssistant::OatFileInfo::OatFileInfo(OatFileAssistant* oat_file_assistant,
736 bool is_oat_location)
737 : oat_file_assistant_(oat_file_assistant), is_oat_location_(is_oat_location)
738 {}
739
IsOatLocation()740 bool OatFileAssistant::OatFileInfo::IsOatLocation() {
741 return is_oat_location_;
742 }
743
Filename()744 const std::string* OatFileAssistant::OatFileInfo::Filename() {
745 return filename_provided_ ? &filename_ : nullptr;
746 }
747
IsUseable()748 bool OatFileAssistant::OatFileInfo::IsUseable() {
749 switch (Status()) {
750 case kOatCannotOpen:
751 case kOatDexOutOfDate:
752 case kOatBootImageOutOfDate: return false;
753
754 case kOatUpToDate: return true;
755 }
756 UNREACHABLE();
757 }
758
Status()759 OatFileAssistant::OatStatus OatFileAssistant::OatFileInfo::Status() {
760 if (!status_attempted_) {
761 status_attempted_ = true;
762 const OatFile* file = GetFile();
763 if (file == nullptr) {
764 // Check to see if there is a vdex file we can make use of.
765 std::string error_msg;
766 std::string vdex_filename = GetVdexFilename(filename_);
767 std::unique_ptr<VdexFile> vdex;
768 if (use_fd_) {
769 if (vdex_fd_ >= 0) {
770 struct stat s;
771 int rc = TEMP_FAILURE_RETRY(fstat(vdex_fd_, &s));
772 if (rc == -1) {
773 error_msg = StringPrintf("Failed getting length of the vdex file %s.", strerror(errno));
774 } else {
775 vdex = VdexFile::Open(vdex_fd_,
776 s.st_size,
777 vdex_filename,
778 /*writable=*/ false,
779 /*low_4gb=*/ false,
780 /*unquicken=*/ false,
781 &error_msg);
782 }
783 }
784 } else {
785 vdex = VdexFile::Open(vdex_filename,
786 /*writable=*/ false,
787 /*low_4gb=*/ false,
788 /*unquicken=*/ false,
789 &error_msg);
790 }
791 if (vdex == nullptr) {
792 status_ = kOatCannotOpen;
793 VLOG(oat) << "unable to open vdex file " << vdex_filename << ": " << error_msg;
794 } else {
795 if (oat_file_assistant_->DexChecksumUpToDate(*vdex, &error_msg)) {
796 // The vdex file does not contain enough information to determine
797 // whether it is up to date with respect to the boot image, so we
798 // assume it is out of date.
799 VLOG(oat) << error_msg;
800 status_ = kOatBootImageOutOfDate;
801 } else {
802 status_ = kOatDexOutOfDate;
803 }
804 }
805 } else {
806 status_ = oat_file_assistant_->GivenOatFileStatus(*file);
807 VLOG(oat) << file->GetLocation() << " is " << status_
808 << " with filter " << file->GetCompilerFilter();
809 }
810 }
811 return status_;
812 }
813
GetDexOptNeeded(CompilerFilter::Filter target,bool profile_changed,bool downgrade,ClassLoaderContext * context,const std::vector<int> & context_fds)814 OatFileAssistant::DexOptNeeded OatFileAssistant::OatFileInfo::GetDexOptNeeded(
815 CompilerFilter::Filter target,
816 bool profile_changed,
817 bool downgrade,
818 ClassLoaderContext* context,
819 const std::vector<int>& context_fds) {
820
821 bool filter_okay = CompilerFilterIsOkay(target, profile_changed, downgrade);
822 bool class_loader_context_okay = ClassLoaderContextIsOkay(context, context_fds);
823
824 // Only check the filter and relocation if the class loader context is ok.
825 // If it is not, we will return kDex2OatFromScratch as the compilation needs to be redone.
826 if (class_loader_context_okay) {
827 if (filter_okay && Status() == kOatUpToDate) {
828 // The oat file is in good shape as is.
829 return kNoDexOptNeeded;
830 }
831
832 if (IsUseable()) {
833 return kDex2OatForFilter;
834 }
835
836 if (Status() == kOatBootImageOutOfDate) {
837 return kDex2OatForBootImage;
838 }
839 }
840
841 if (oat_file_assistant_->HasOriginalDexFiles()) {
842 return kDex2OatFromScratch;
843 } else {
844 // Otherwise there is nothing we can do, even if we want to.
845 return kNoDexOptNeeded;
846 }
847 }
848
GetFile()849 const OatFile* OatFileAssistant::OatFileInfo::GetFile() {
850 CHECK(!file_released_) << "GetFile called after oat file released.";
851 if (!load_attempted_) {
852 load_attempted_ = true;
853 if (filename_provided_) {
854 bool executable = oat_file_assistant_->load_executable_;
855 if (executable && oat_file_assistant_->only_load_system_executable_) {
856 executable = LocationIsOnSystem(filename_.c_str());
857 }
858 VLOG(oat) << "Loading " << filename_ << " with executable: " << executable;
859 std::string error_msg;
860 if (use_fd_) {
861 if (oat_fd_ >= 0 && vdex_fd_ >= 0) {
862 file_.reset(OatFile::Open(zip_fd_,
863 vdex_fd_,
864 oat_fd_,
865 filename_.c_str(),
866 executable,
867 /*low_4gb=*/ false,
868 oat_file_assistant_->dex_location_.c_str(),
869 /*reservation=*/ nullptr,
870 &error_msg));
871 }
872 } else {
873 file_.reset(OatFile::Open(/*zip_fd=*/ -1,
874 filename_.c_str(),
875 filename_.c_str(),
876 executable,
877 /*low_4gb=*/ false,
878 oat_file_assistant_->dex_location_.c_str(),
879 /*reservation=*/ nullptr,
880 &error_msg));
881 }
882 if (file_.get() == nullptr) {
883 VLOG(oat) << "OatFileAssistant test for existing oat file "
884 << filename_ << ": " << error_msg;
885 } else {
886 VLOG(oat) << "Successfully loaded " << filename_ << " with executable: " << executable;
887 }
888 }
889 }
890 return file_.get();
891 }
892
CompilerFilterIsOkay(CompilerFilter::Filter target,bool profile_changed,bool downgrade)893 bool OatFileAssistant::OatFileInfo::CompilerFilterIsOkay(
894 CompilerFilter::Filter target, bool profile_changed, bool downgrade) {
895 const OatFile* file = GetFile();
896 if (file == nullptr) {
897 return false;
898 }
899
900 CompilerFilter::Filter current = file->GetCompilerFilter();
901 if (profile_changed && CompilerFilter::DependsOnProfile(current)) {
902 VLOG(oat) << "Compiler filter not okay because Profile changed";
903 return false;
904 }
905 return downgrade ? !CompilerFilter::IsBetter(current, target) :
906 CompilerFilter::IsAsGoodAs(current, target);
907 }
908
ClassLoaderContextIsOkay(ClassLoaderContext * context,const std::vector<int> & context_fds)909 bool OatFileAssistant::OatFileInfo::ClassLoaderContextIsOkay(ClassLoaderContext* context,
910 const std::vector<int>& context_fds) {
911 if (context == nullptr) {
912 VLOG(oat) << "ClassLoaderContext check ignored: null context";
913 return true;
914 }
915
916 const OatFile* file = GetFile();
917 if (file == nullptr) {
918 // No oat file means we have nothing to verify.
919 return true;
920 }
921
922 size_t dir_index = oat_file_assistant_->dex_location_.rfind('/');
923 std::string classpath_dir = (dir_index != std::string::npos)
924 ? oat_file_assistant_->dex_location_.substr(0, dir_index)
925 : "";
926
927 if (!context->OpenDexFiles(oat_file_assistant_->isa_, classpath_dir, context_fds)) {
928 VLOG(oat) << "ClassLoaderContext check failed: dex files from the context could not be opened";
929 return false;
930 }
931
932 const bool result = context->VerifyClassLoaderContextMatch(file->GetClassLoaderContext()) !=
933 ClassLoaderContext::VerificationResult::kMismatch;
934 if (!result) {
935 VLOG(oat) << "ClassLoaderContext check failed. Context was "
936 << file->GetClassLoaderContext()
937 << ". The expected context is " << context->EncodeContextForOatFile(classpath_dir);
938 }
939 return result;
940 }
941
IsExecutable()942 bool OatFileAssistant::OatFileInfo::IsExecutable() {
943 const OatFile* file = GetFile();
944 return (file != nullptr && file->IsExecutable());
945 }
946
Reset()947 void OatFileAssistant::OatFileInfo::Reset() {
948 load_attempted_ = false;
949 file_.reset();
950 status_attempted_ = false;
951 }
952
Reset(const std::string & filename,bool use_fd,int zip_fd,int vdex_fd,int oat_fd)953 void OatFileAssistant::OatFileInfo::Reset(const std::string& filename,
954 bool use_fd,
955 int zip_fd,
956 int vdex_fd,
957 int oat_fd) {
958 filename_provided_ = true;
959 filename_ = filename;
960 use_fd_ = use_fd;
961 zip_fd_ = zip_fd;
962 vdex_fd_ = vdex_fd;
963 oat_fd_ = oat_fd;
964 Reset();
965 }
966
ReleaseFile()967 std::unique_ptr<OatFile> OatFileAssistant::OatFileInfo::ReleaseFile() {
968 file_released_ = true;
969 return std::move(file_);
970 }
971
ReleaseFileForUse()972 std::unique_ptr<OatFile> OatFileAssistant::OatFileInfo::ReleaseFileForUse() {
973 if (Status() == kOatUpToDate) {
974 return ReleaseFile();
975 }
976
977 VLOG(oat) << "Oat File Assistant: No relocated oat file found,"
978 << " attempting to fall back to interpreting oat file instead.";
979
980 switch (Status()) {
981 case kOatBootImageOutOfDate:
982 // OutOfDate may be either a mismatched image, or a missing image.
983 if (oat_file_assistant_->HasOriginalDexFiles()) {
984 // If there are original dex files, it is better to use them (to avoid a potential
985 // quickening mismatch because the boot image changed).
986 break;
987 }
988 // If we do not accept the oat file, we may not have access to dex bytecode at all. Grudgingly
989 // go forward.
990 FALLTHROUGH_INTENDED;
991
992 case kOatUpToDate:
993 case kOatCannotOpen:
994 case kOatDexOutOfDate:
995 break;
996 }
997
998 return std::unique_ptr<OatFile>();
999 }
1000
1001 // TODO(calin): we could provide a more refined status here
1002 // (e.g. run from uncompressed apk, run with vdex but not oat etc). It will allow us to
1003 // track more experiments but adds extra complexity.
GetOptimizationStatus(const std::string & filename,InstructionSet isa,std::string * out_compilation_filter,std::string * out_compilation_reason)1004 void OatFileAssistant::GetOptimizationStatus(
1005 const std::string& filename,
1006 InstructionSet isa,
1007 std::string* out_compilation_filter,
1008 std::string* out_compilation_reason) {
1009 // It may not be possible to load an oat file executable (e.g., selinux restrictions). Load
1010 // non-executable and check the status manually.
1011 OatFileAssistant oat_file_assistant(filename.c_str(), isa, /*load_executable=*/ false);
1012 std::unique_ptr<OatFile> oat_file = oat_file_assistant.GetBestOatFile();
1013
1014 if (oat_file == nullptr) {
1015 *out_compilation_filter = "run-from-apk";
1016 *out_compilation_reason = "unknown";
1017 return;
1018 }
1019
1020 OatStatus status = oat_file_assistant.GivenOatFileStatus(*oat_file);
1021 const char* reason = oat_file->GetCompilationReason();
1022 *out_compilation_reason = reason == nullptr ? "unknown" : reason;
1023 switch (status) {
1024 case OatStatus::kOatUpToDate:
1025 *out_compilation_filter = CompilerFilter::NameOfFilter(oat_file->GetCompilerFilter());
1026 return;
1027
1028 case kOatCannotOpen: // This should never happen, but be robust.
1029 *out_compilation_filter = "error";
1030 *out_compilation_reason = "error";
1031 return;
1032
1033 // kOatBootImageOutOfDate - The oat file is up to date with respect to the
1034 // dex file, but is out of date with respect to the boot image.
1035 case kOatBootImageOutOfDate:
1036 FALLTHROUGH_INTENDED;
1037 case kOatDexOutOfDate:
1038 if (oat_file_assistant.HasOriginalDexFiles()) {
1039 *out_compilation_filter = "run-from-apk-fallback";
1040 } else {
1041 *out_compilation_filter = "run-from-vdex-fallback";
1042 }
1043 return;
1044 }
1045 LOG(FATAL) << "Unreachable";
1046 UNREACHABLE();
1047 }
1048
1049 } // namespace art
1050