• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright (C) 2007 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 "install/install.h"
18 
19 #include <ctype.h>
20 #include <errno.h>
21 #include <fcntl.h>
22 #include <inttypes.h>
23 #include <limits.h>
24 #include <string.h>
25 #include <sys/stat.h>
26 #include <sys/wait.h>
27 #include <unistd.h>
28 
29 #include <algorithm>
30 #include <atomic>
31 #include <chrono>
32 #include <condition_variable>
33 #include <filesystem>
34 #include <functional>
35 #include <limits>
36 #include <mutex>
37 #include <thread>
38 #include <vector>
39 
40 #include <android-base/file.h>
41 #include <android-base/logging.h>
42 #include <android-base/parsedouble.h>
43 #include <android-base/parseint.h>
44 #include <android-base/properties.h>
45 #include <android-base/stringprintf.h>
46 #include <android-base/strings.h>
47 #include <android-base/unique_fd.h>
48 
49 #include "install/spl_check.h"
50 #include "install/wipe_data.h"
51 #include "otautil/error_code.h"
52 #include "otautil/package.h"
53 #include "otautil/paths.h"
54 #include "otautil/sysutil.h"
55 #include "otautil/verifier.h"
56 #include "private/setup_commands.h"
57 #include "recovery_ui/ui.h"
58 #include "recovery_utils/roots.h"
59 #include "recovery_utils/thermalutil.h"
60 
61 using namespace std::chrono_literals;
62 
63 static constexpr int kRecoveryApiVersion = 3;
64 // We define RECOVERY_API_VERSION in Android.mk, which will be picked up by build system and packed
65 // into target_files.zip. Assert the version defined in code and in Android.mk are consistent.
66 static_assert(kRecoveryApiVersion == RECOVERY_API_VERSION, "Mismatching recovery API versions.");
67 
68 // Default allocation of progress bar segments to operations
69 static constexpr int VERIFICATION_PROGRESS_TIME = 60;
70 static constexpr float VERIFICATION_PROGRESS_FRACTION = 0.25;
71 // The charater used to separate dynamic fingerprints. e.x. sargo|aosp-sargo
72 static const char* FINGERPRING_SEPARATOR = "|";
73 static std::condition_variable finish_log_temperature;
74 static bool isInStringList(const std::string& target_token, const std::string& str_list,
75                            const std::string& deliminator);
76 
ReadMetadataFromPackage(ZipArchiveHandle zip,std::map<std::string,std::string> * metadata)77 bool ReadMetadataFromPackage(ZipArchiveHandle zip, std::map<std::string, std::string>* metadata) {
78   CHECK(metadata != nullptr);
79 
80   static constexpr const char* METADATA_PATH = "META-INF/com/android/metadata";
81   ZipEntry64 entry;
82   if (FindEntry(zip, METADATA_PATH, &entry) != 0) {
83     LOG(ERROR) << "Failed to find " << METADATA_PATH;
84     return false;
85   }
86 
87   uint32_t length = entry.uncompressed_length;
88   std::string metadata_string(length, '\0');
89   int32_t err =
90       ExtractToMemory(zip, &entry, reinterpret_cast<uint8_t*>(&metadata_string[0]), length);
91   if (err != 0) {
92     LOG(ERROR) << "Failed to extract " << METADATA_PATH << ": " << ErrorCodeString(err);
93     return false;
94   }
95 
96   for (const std::string& line : android::base::Split(metadata_string, "\n")) {
97     size_t eq = line.find('=');
98     if (eq != std::string::npos) {
99       metadata->emplace(android::base::Trim(line.substr(0, eq)),
100                         android::base::Trim(line.substr(eq + 1)));
101     }
102   }
103 
104   return true;
105 }
106 
107 // Gets the value for the given key in |metadata|. Returns an emtpy string if the key isn't
108 // present.
get_value(const std::map<std::string,std::string> & metadata,const std::string & key)109 static std::string get_value(const std::map<std::string, std::string>& metadata,
110                              const std::string& key) {
111   const auto& it = metadata.find(key);
112   return (it == metadata.end()) ? "" : it->second;
113 }
114 
OtaTypeToString(OtaType type)115 static std::string OtaTypeToString(OtaType type) {
116   switch (type) {
117     case OtaType::AB:
118       return "AB";
119     case OtaType::BLOCK:
120       return "BLOCK";
121     case OtaType::BRICK:
122       return "BRICK";
123   }
124 }
125 
126 // Read the build.version.incremental of src/tgt from the metadata and log it to last_install.
ReadSourceTargetBuild(const std::map<std::string,std::string> & metadata,std::vector<std::string> * log_buffer)127 static void ReadSourceTargetBuild(const std::map<std::string, std::string>& metadata,
128                                   std::vector<std::string>* log_buffer) {
129   // Examples of the pre-build and post-build strings in metadata:
130   //   pre-build-incremental=2943039
131   //   post-build-incremental=2951741
132   auto source_build = get_value(metadata, "pre-build-incremental");
133   if (!source_build.empty()) {
134     log_buffer->push_back("source_build: " + source_build);
135   }
136 
137   auto target_build = get_value(metadata, "post-build-incremental");
138   if (!target_build.empty()) {
139     log_buffer->push_back("target_build: " + target_build);
140   }
141 }
142 
143 // Checks the build version, fingerprint and timestamp in the metadata of the A/B package.
144 // Downgrading is not allowed unless explicitly enabled in the package and only for
145 // incremental packages.
CheckAbSpecificMetadata(const std::map<std::string,std::string> & metadata)146 static bool CheckAbSpecificMetadata(const std::map<std::string, std::string>& metadata) {
147   // Incremental updates should match the current build.
148   auto device_pre_build = android::base::GetProperty("ro.build.version.incremental", "");
149   auto pkg_pre_build = get_value(metadata, "pre-build-incremental");
150   if (!pkg_pre_build.empty() && pkg_pre_build != device_pre_build) {
151     LOG(ERROR) << "Package is for source build " << pkg_pre_build << " but expected "
152                << device_pre_build;
153     return false;
154   }
155 
156   auto device_fingerprint = android::base::GetProperty("ro.build.fingerprint", "");
157   auto pkg_pre_build_fingerprint = get_value(metadata, "pre-build");
158   if (!pkg_pre_build_fingerprint.empty() &&
159       !isInStringList(device_fingerprint, pkg_pre_build_fingerprint, FINGERPRING_SEPARATOR)) {
160     LOG(ERROR) << "Package is for source build " << pkg_pre_build_fingerprint << " but expected "
161                << device_fingerprint;
162     return false;
163   }
164 
165   // Check for downgrade version.
166   int64_t build_timestamp =
167       android::base::GetIntProperty("ro.build.date.utc", std::numeric_limits<int64_t>::max());
168   int64_t pkg_post_timestamp = 0;
169   // We allow to full update to the same version we are running, in case there
170   // is a problem with the current copy of that version.
171   auto pkg_post_timestamp_string = get_value(metadata, "post-timestamp");
172   if (pkg_post_timestamp_string.empty() ||
173       !android::base::ParseInt(pkg_post_timestamp_string, &pkg_post_timestamp) ||
174       pkg_post_timestamp < build_timestamp) {
175     if (get_value(metadata, "ota-downgrade") != "yes") {
176       LOG(ERROR) << "Update package is older than the current build, expected a build "
177                     "newer than timestamp "
178                  << build_timestamp << " but package has timestamp " << pkg_post_timestamp
179                  << " and downgrade not allowed.";
180       return false;
181     }
182     if (pkg_pre_build_fingerprint.empty()) {
183       LOG(ERROR) << "Downgrade package must have a pre-build version set, not allowed.";
184       return false;
185     }
186   }
187 
188   return true;
189 }
190 
CheckPackageMetadata(const std::map<std::string,std::string> & metadata,OtaType ota_type)191 bool CheckPackageMetadata(const std::map<std::string, std::string>& metadata, OtaType ota_type) {
192   auto package_ota_type = get_value(metadata, "ota-type");
193   auto expected_ota_type = OtaTypeToString(ota_type);
194   if (ota_type != OtaType::AB && ota_type != OtaType::BRICK) {
195     LOG(INFO) << "Skip package metadata check for ota type " << expected_ota_type;
196     return true;
197   }
198 
199   if (package_ota_type != expected_ota_type) {
200     LOG(ERROR) << "Unexpected ota package type, expects " << expected_ota_type << ", actual "
201                << package_ota_type;
202     return false;
203   }
204 
205   auto device = android::base::GetProperty("ro.product.device", "");
206   auto pkg_device = get_value(metadata, "pre-device");
207   // device name can be a | separated list, so need to check
208   if (pkg_device.empty() || !isInStringList(device, pkg_device, FINGERPRING_SEPARATOR)) {
209     LOG(ERROR) << "Package is for product " << pkg_device << " but expected " << device;
210     return false;
211   }
212 
213   // We allow the package to not have any serialno; and we also allow it to carry multiple serial
214   // numbers split by "|"; e.g. serialno=serialno1|serialno2|serialno3 ... We will fail the
215   // verification if the device's serialno doesn't match any of these carried numbers.
216   auto pkg_serial_no = get_value(metadata, "serialno");
217   if (!pkg_serial_no.empty()) {
218     auto device_serial_no = android::base::GetProperty("ro.serialno", "");
219     bool serial_number_match = false;
220     for (const auto& number : android::base::Split(pkg_serial_no, "|")) {
221       if (device_serial_no == android::base::Trim(number)) {
222         serial_number_match = true;
223       }
224     }
225     if (!serial_number_match) {
226       LOG(ERROR) << "Package is for serial " << pkg_serial_no;
227       return false;
228     }
229   }
230 
231   if (ota_type == OtaType::AB) {
232     return CheckAbSpecificMetadata(metadata);
233   }
234 
235   return true;
236 }
237 
ExtractPayloadProperties(ZipArchiveHandle zip)238 static std::string ExtractPayloadProperties(ZipArchiveHandle zip) {
239   // For A/B updates we extract the payload properties to a buffer and obtain the RAW payload offset
240   // in the zip file.
241   static constexpr const char* AB_OTA_PAYLOAD_PROPERTIES = "payload_properties.txt";
242   ZipEntry64 properties_entry;
243   if (FindEntry(zip, AB_OTA_PAYLOAD_PROPERTIES, &properties_entry) != 0) {
244     LOG(ERROR) << "Failed to find " << AB_OTA_PAYLOAD_PROPERTIES;
245     return {};
246   }
247   auto properties_entry_length = properties_entry.uncompressed_length;
248   if (properties_entry_length > std::numeric_limits<size_t>::max()) {
249     LOG(ERROR) << "Failed to extract " << AB_OTA_PAYLOAD_PROPERTIES
250                << " because's uncompressed size exceeds size of address space. "
251                << properties_entry_length;
252     return {};
253   }
254   std::string payload_properties(properties_entry_length, '\0');
255   int32_t err =
256       ExtractToMemory(zip, &properties_entry, reinterpret_cast<uint8_t*>(payload_properties.data()),
257                       properties_entry_length);
258   if (err != 0) {
259     LOG(ERROR) << "Failed to extract " << AB_OTA_PAYLOAD_PROPERTIES << ": " << ErrorCodeString(err);
260     return {};
261   }
262   return payload_properties;
263 }
264 
SetUpAbUpdateCommands(const std::string & package,ZipArchiveHandle zip,int status_fd,std::vector<std::string> * cmd)265 bool SetUpAbUpdateCommands(const std::string& package, ZipArchiveHandle zip, int status_fd,
266                            std::vector<std::string>* cmd) {
267   CHECK(cmd != nullptr);
268 
269   // For A/B updates we extract the payload properties to a buffer and obtain the RAW payload offset
270   // in the zip file.
271   const auto payload_properties = ExtractPayloadProperties(zip);
272   if (payload_properties.empty()) {
273     return false;
274   }
275 
276   static constexpr const char* AB_OTA_PAYLOAD = "payload.bin";
277   ZipEntry64 payload_entry;
278   if (FindEntry(zip, AB_OTA_PAYLOAD, &payload_entry) != 0) {
279     LOG(ERROR) << "Failed to find " << AB_OTA_PAYLOAD;
280     return false;
281   }
282   long payload_offset = payload_entry.offset;
283   *cmd = {
284     "/system/bin/update_engine_sideload",
285     "--payload=file://" + package,
286     android::base::StringPrintf("--offset=%ld", payload_offset),
287     "--headers=" + std::string(payload_properties.begin(), payload_properties.end()),
288     android::base::StringPrintf("--status_fd=%d", status_fd),
289   };
290   return true;
291 }
292 
SetUpNonAbUpdateCommands(const std::string & package,ZipArchiveHandle zip,int retry_count,int status_fd,std::vector<std::string> * cmd)293 bool SetUpNonAbUpdateCommands(const std::string& package, ZipArchiveHandle zip, int retry_count,
294                               int status_fd, std::vector<std::string>* cmd) {
295   CHECK(cmd != nullptr);
296 
297   // In non-A/B updates we extract the update binary from the package.
298   static constexpr const char* UPDATE_BINARY_NAME = "META-INF/com/google/android/update-binary";
299   ZipEntry64 binary_entry;
300   if (FindEntry(zip, UPDATE_BINARY_NAME, &binary_entry) != 0) {
301     LOG(ERROR) << "Failed to find update binary " << UPDATE_BINARY_NAME;
302     return false;
303   }
304 
305   const std::string binary_path = Paths::Get().temporary_update_binary();
306   unlink(binary_path.c_str());
307   android::base::unique_fd fd(
308       open(binary_path.c_str(), O_CREAT | O_WRONLY | O_TRUNC | O_CLOEXEC, 0755));
309   if (fd == -1) {
310     PLOG(ERROR) << "Failed to create " << binary_path;
311     return false;
312   }
313 
314   if (auto error = ExtractEntryToFile(zip, &binary_entry, fd); error != 0) {
315     LOG(ERROR) << "Failed to extract " << UPDATE_BINARY_NAME << ": " << ErrorCodeString(error);
316     return false;
317   }
318 
319   // When executing the update binary contained in the package, the arguments passed are:
320   //   - the version number for this interface
321   //   - an FD to which the program can write in order to update the progress bar.
322   //   - the name of the package zip file.
323   //   - an optional argument "retry" if this update is a retry of a failed update attempt.
324   *cmd = {
325     binary_path,
326     std::to_string(kRecoveryApiVersion),
327     std::to_string(status_fd),
328     package,
329   };
330   if (retry_count > 0) {
331     cmd->push_back("retry");
332   }
333   return true;
334 }
335 
log_max_temperature(int * max_temperature,const std::atomic<bool> & logger_finished)336 static void log_max_temperature(int* max_temperature, const std::atomic<bool>& logger_finished) {
337   CHECK(max_temperature != nullptr);
338   std::mutex mtx;
339   std::unique_lock<std::mutex> lck(mtx);
340   while (!logger_finished.load() &&
341          finish_log_temperature.wait_for(lck, 20s) == std::cv_status::timeout) {
342     *max_temperature = std::max(*max_temperature, GetMaxValueFromThermalZone());
343   }
344 }
345 
PerformPowerwashIfRequired(ZipArchiveHandle zip,Device * device)346 static bool PerformPowerwashIfRequired(ZipArchiveHandle zip, Device *device) {
347   const auto payload_properties = ExtractPayloadProperties(zip);
348   if (payload_properties.find("POWERWASH=1") != std::string::npos) {
349     LOG(INFO) << "Payload properties has POWERWASH=1, wiping userdata...";
350     return WipeData(device);
351   }
352   return true;
353 }
354 
355 // If the package contains an update binary, extract it and run it.
TryUpdateBinary(Package * package,bool * wipe_cache,std::vector<std::string> * log_buffer,int retry_count,int * max_temperature,Device * device)356 static InstallResult TryUpdateBinary(Package* package, bool* wipe_cache,
357                                      std::vector<std::string>* log_buffer, int retry_count,
358                                      int* max_temperature, Device* device) {
359   auto ui = device->GetUI();
360   std::map<std::string, std::string> metadata;
361   auto zip = package->GetZipArchiveHandle();
362   if (!ReadMetadataFromPackage(zip, &metadata)) {
363     LOG(ERROR) << "Failed to parse metadata in the zip file";
364     return INSTALL_CORRUPT;
365   }
366 
367   bool package_is_ab = get_value(metadata, "ota-type") == OtaTypeToString(OtaType::AB);
368   bool device_supports_ab = android::base::GetBoolProperty("ro.build.ab_update", false);
369   bool ab_device_supports_nonab =
370       android::base::GetBoolProperty("ro.virtual_ab.allow_non_ab", false);
371   bool device_only_supports_ab = device_supports_ab && !ab_device_supports_nonab;
372 
373   const auto current_spl = android::base::GetProperty("ro.build.version.security_patch", "");
374   if (ViolatesSPLDowngrade(zip, current_spl)) {
375     LOG(ERROR) << "Denying OTA because it's SPL downgrade";
376     return INSTALL_ERROR;
377   }
378 
379   if (package_is_ab) {
380     CHECK(package->GetType() == PackageType::kFile);
381   }
382 
383   // Verify against the metadata in the package first. Expects A/B metadata if:
384   // Package declares itself as an A/B package
385   // Package does not declare itself as an A/B package, but device only supports A/B;
386   //   still calls CheckPackageMetadata to get a meaningful error message.
387   if (package_is_ab || device_only_supports_ab) {
388     if (!CheckPackageMetadata(metadata, OtaType::AB)) {
389       log_buffer->push_back(android::base::StringPrintf("error: %d", kUpdateBinaryCommandFailure));
390       return INSTALL_ERROR;
391     }
392   }
393 
394   ReadSourceTargetBuild(metadata, log_buffer);
395 
396   // The updater in child process writes to the pipe to communicate with recovery.
397   android::base::unique_fd pipe_read, pipe_write;
398   // Explicitly disable O_CLOEXEC using 0 as the flags (last) parameter to Pipe
399   // so that the child updater process will recieve a non-closed fd.
400   if (!android::base::Pipe(&pipe_read, &pipe_write, 0)) {
401     PLOG(ERROR) << "Failed to create pipe for updater-recovery communication";
402     return INSTALL_CORRUPT;
403   }
404 
405   // The updater-recovery communication protocol.
406   //
407   //   progress <frac> <secs>
408   //       fill up the next <frac> part of of the progress bar over <secs> seconds. If <secs> is
409   //       zero, use `set_progress` commands to manually control the progress of this segment of the
410   //       bar.
411   //
412   //   set_progress <frac>
413   //       <frac> should be between 0.0 and 1.0; sets the progress bar within the segment defined by
414   //       the most recent progress command.
415   //
416   //   ui_print <string>
417   //       display <string> on the screen.
418   //
419   //   wipe_cache
420   //       a wipe of cache will be performed following a successful installation.
421   //
422   //   clear_display
423   //       turn off the text display.
424   //
425   //   enable_reboot
426   //       packages can explicitly request that they want the user to be able to reboot during
427   //       installation (useful for debugging packages that don't exit).
428   //
429   //   retry_update
430   //       updater encounters some issue during the update. It requests a reboot to retry the same
431   //       package automatically.
432   //
433   //   log <string>
434   //       updater requests logging the string (e.g. cause of the failure).
435   //
436 
437   std::string package_path = package->GetPath();
438 
439   std::vector<std::string> args;
440   if (auto setup_result =
441           package_is_ab
442               ? SetUpAbUpdateCommands(package_path, zip, pipe_write.get(), &args)
443               : SetUpNonAbUpdateCommands(package_path, zip, retry_count, pipe_write.get(), &args);
444       !setup_result) {
445     log_buffer->push_back(android::base::StringPrintf("error: %d", kUpdateBinaryCommandFailure));
446     return INSTALL_CORRUPT;
447   }
448 
449   pid_t pid = fork();
450   if (pid == -1) {
451     PLOG(ERROR) << "Failed to fork update binary";
452     log_buffer->push_back(android::base::StringPrintf("error: %d", kForkUpdateBinaryFailure));
453     return INSTALL_ERROR;
454   }
455 
456   if (pid == 0) {
457     umask(022);
458     pipe_read.reset();
459 
460     // Convert the std::string vector to a NULL-terminated char* vector suitable for execv.
461     auto chr_args = StringVectorToNullTerminatedArray(args);
462     execv(chr_args[0], chr_args.data());
463     // We shouldn't use LOG/PLOG in the forked process, since they may cause the child process to
464     // hang. This deadlock results from an improperly copied mutex in the ui functions.
465     // (Bug: 34769056)
466     fprintf(stdout, "E:Can't run %s (%s)\n", chr_args[0], strerror(errno));
467     _exit(EXIT_FAILURE);
468   }
469   pipe_write.reset();
470 
471   std::atomic<bool> logger_finished(false);
472   std::thread temperature_logger(log_max_temperature, max_temperature, std::ref(logger_finished));
473 
474   *wipe_cache = false;
475   bool retry_update = false;
476 
477   char buffer[1024];
478   FILE* from_child = android::base::Fdopen(std::move(pipe_read), "r");
479   while (fgets(buffer, sizeof(buffer), from_child) != nullptr) {
480     std::string line(buffer);
481     size_t space = line.find_first_of(" \n");
482     std::string command(line.substr(0, space));
483     if (command.empty()) continue;
484 
485     // Get rid of the leading and trailing space and/or newline.
486     std::string args = space == std::string::npos ? "" : android::base::Trim(line.substr(space));
487 
488     if (command == "progress") {
489       std::vector<std::string> tokens = android::base::Split(args, " ");
490       double fraction;
491       int seconds;
492       if (tokens.size() == 2 && android::base::ParseDouble(tokens[0].c_str(), &fraction) &&
493           android::base::ParseInt(tokens[1], &seconds)) {
494         ui->ShowProgress(fraction * (1 - VERIFICATION_PROGRESS_FRACTION), seconds);
495       } else {
496         LOG(ERROR) << "invalid \"progress\" parameters: " << line;
497       }
498     } else if (command == "set_progress") {
499       std::vector<std::string> tokens = android::base::Split(args, " ");
500       double fraction;
501       if (tokens.size() == 1 && android::base::ParseDouble(tokens[0].c_str(), &fraction)) {
502         ui->SetProgress(fraction);
503       } else {
504         LOG(ERROR) << "invalid \"set_progress\" parameters: " << line;
505       }
506     } else if (command == "ui_print") {
507       ui->PrintOnScreenOnly("%s\n", args.c_str());
508       fflush(stdout);
509     } else if (command == "wipe_cache") {
510       *wipe_cache = true;
511     } else if (command == "clear_display") {
512       ui->SetBackground(RecoveryUI::NONE);
513     } else if (command == "enable_reboot") {
514       // packages can explicitly request that they want the user
515       // to be able to reboot during installation (useful for
516       // debugging packages that don't exit).
517       ui->SetEnableReboot(true);
518     } else if (command == "retry_update") {
519       retry_update = true;
520     } else if (command == "log") {
521       if (!args.empty()) {
522         // Save the logging request from updater and write to last_install later.
523         log_buffer->push_back(args);
524       } else {
525         LOG(ERROR) << "invalid \"log\" parameters: " << line;
526       }
527     } else {
528       LOG(ERROR) << "unknown command [" << command << "]";
529     }
530   }
531   fclose(from_child);
532 
533   int status;
534   waitpid(pid, &status, 0);
535 
536   logger_finished.store(true);
537   finish_log_temperature.notify_one();
538   temperature_logger.join();
539 
540   if (retry_update) {
541     return INSTALL_RETRY;
542   }
543   if (WIFEXITED(status)) {
544     if (WEXITSTATUS(status) != EXIT_SUCCESS) {
545       LOG(ERROR) << "Error in " << package_path << " (status " << WEXITSTATUS(status) << ")";
546       return INSTALL_ERROR;
547     }
548   } else if (WIFSIGNALED(status)) {
549     LOG(ERROR) << "Error in " << package_path << " (killed by signal " << WTERMSIG(status) << ")";
550     return INSTALL_ERROR;
551   } else {
552     LOG(FATAL) << "Invalid status code " << status;
553   }
554   PerformPowerwashIfRequired(zip, device);
555 
556   return INSTALL_SUCCESS;
557 }
558 
VerifyAndInstallPackage(Package * package,bool * wipe_cache,std::vector<std::string> * log_buffer,int retry_count,int * max_temperature,Device * device)559 static InstallResult VerifyAndInstallPackage(Package* package, bool* wipe_cache,
560                                              std::vector<std::string>* log_buffer, int retry_count,
561                                              int* max_temperature, Device* device) {
562   auto ui = device->GetUI();
563   ui->SetBackground(RecoveryUI::INSTALLING_UPDATE);
564   // Give verification half the progress bar...
565   ui->SetProgressType(RecoveryUI::DETERMINATE);
566   ui->ShowProgress(VERIFICATION_PROGRESS_FRACTION, VERIFICATION_PROGRESS_TIME);
567 
568   // Verify package.
569   if (!verify_package(package, ui)) {
570     log_buffer->push_back(android::base::StringPrintf("error: %d", kZipVerificationFailure));
571     return INSTALL_CORRUPT;
572   }
573 
574   // Verify and install the contents of the package.
575   ui->Print("Installing update...\n");
576   if (retry_count > 0) {
577     ui->Print("Retry attempt: %d\n", retry_count);
578   }
579   ui->SetEnableReboot(false);
580   auto result =
581       TryUpdateBinary(package, wipe_cache, log_buffer, retry_count, max_temperature, device);
582   ui->SetEnableReboot(true);
583   ui->Print("\n");
584 
585   return result;
586 }
587 
InstallPackage(Package * package,const std::string_view package_id,bool should_wipe_cache,int retry_count,Device * device)588 InstallResult InstallPackage(Package* package, const std::string_view package_id,
589                              bool should_wipe_cache, int retry_count, Device* device) {
590   auto ui = device->GetUI();
591   auto start = std::chrono::system_clock::now();
592 
593   int start_temperature = GetMaxValueFromThermalZone();
594   int max_temperature = start_temperature;
595 
596   InstallResult result;
597   std::vector<std::string> log_buffer;
598 
599   ui->Print("Supported API: %d\n", kRecoveryApiVersion);
600 
601   ui->Print("Finding update package...\n");
602   LOG(INFO) << "Update package id: " << package_id;
603   if (!package) {
604     log_buffer.push_back(android::base::StringPrintf("error: %d", kMapFileFailure));
605     result = INSTALL_CORRUPT;
606   } else if (setup_install_mounts() != 0) {
607     LOG(ERROR) << "failed to set up expected mounts for install; aborting";
608     result = INSTALL_ERROR;
609   } else {
610     bool updater_wipe_cache = false;
611     result = VerifyAndInstallPackage(package, &updater_wipe_cache, &log_buffer, retry_count,
612                                      &max_temperature, device);
613     should_wipe_cache = should_wipe_cache || updater_wipe_cache;
614   }
615 
616   // Measure the time spent to apply OTA update in seconds.
617   std::chrono::duration<double> duration = std::chrono::system_clock::now() - start;
618   int time_total = static_cast<int>(duration.count());
619 
620   bool has_cache = volume_for_mount_point("/cache") != nullptr;
621   // Skip logging the uncrypt_status on devices without /cache.
622   if (has_cache) {
623     static constexpr const char* UNCRYPT_STATUS = "/cache/recovery/uncrypt_status";
624     if (ensure_path_mounted(UNCRYPT_STATUS) != 0) {
625       LOG(WARNING) << "Can't mount " << UNCRYPT_STATUS;
626     } else {
627       std::string uncrypt_status;
628       if (!android::base::ReadFileToString(UNCRYPT_STATUS, &uncrypt_status)) {
629         PLOG(WARNING) << "failed to read uncrypt status";
630       } else if (!android::base::StartsWith(uncrypt_status, "uncrypt_")) {
631         LOG(WARNING) << "corrupted uncrypt_status: " << uncrypt_status;
632       } else {
633         log_buffer.push_back(android::base::Trim(uncrypt_status));
634       }
635     }
636   }
637 
638   // The first two lines need to be the package name and install result.
639   std::vector<std::string> log_header = {
640     std::string(package_id),
641     result == INSTALL_SUCCESS ? "1" : "0",
642     "time_total: " + std::to_string(time_total),
643     "retry: " + std::to_string(retry_count),
644   };
645 
646   int end_temperature = GetMaxValueFromThermalZone();
647   max_temperature = std::max(end_temperature, max_temperature);
648   if (start_temperature > 0) {
649     log_buffer.push_back("temperature_start: " + std::to_string(start_temperature));
650   }
651   if (end_temperature > 0) {
652     log_buffer.push_back("temperature_end: " + std::to_string(end_temperature));
653   }
654   if (max_temperature > 0) {
655     log_buffer.push_back("temperature_max: " + std::to_string(max_temperature));
656   }
657 
658   std::string log_content =
659       android::base::Join(log_header, "\n") + "\n" + android::base::Join(log_buffer, "\n") + "\n";
660   const std::string& install_file = Paths::Get().temporary_install_file();
661   if (!android::base::WriteStringToFile(log_content, install_file)) {
662     PLOG(ERROR) << "failed to write " << install_file;
663   }
664 
665   // Write a copy into last_log.
666   LOG(INFO) << log_content;
667 
668   if (result == INSTALL_SUCCESS && should_wipe_cache) {
669     if (!WipeCache(ui, nullptr)) {
670       result = INSTALL_ERROR;
671     }
672   }
673 
674   return result;
675 }
676 
verify_package(Package * package,RecoveryUI * ui)677 bool verify_package(Package* package, RecoveryUI* ui) {
678   static constexpr const char* CERTIFICATE_ZIP_FILE = "/system/etc/security/otacerts.zip";
679   std::vector<Certificate> loaded_keys = LoadKeysFromZipfile(CERTIFICATE_ZIP_FILE);
680   if (loaded_keys.empty()) {
681     LOG(ERROR) << "Failed to load keys";
682     return false;
683   }
684   LOG(INFO) << loaded_keys.size() << " key(s) loaded from " << CERTIFICATE_ZIP_FILE;
685 
686   // Verify package.
687   ui->Print("Verifying update package...\n");
688   auto t0 = std::chrono::system_clock::now();
689   int err = verify_file(package, loaded_keys);
690   std::chrono::duration<double> duration = std::chrono::system_clock::now() - t0;
691   ui->Print("Update package verification took %.1f s (result %d).\n", duration.count(), err);
692   if (err != VERIFY_SUCCESS) {
693     LOG(ERROR) << "Signature verification failed";
694     LOG(ERROR) << "error: " << kZipVerificationFailure;
695     return false;
696   }
697   return true;
698 }
699 
SetupPackageMount(const std::string & package_path,bool * should_use_fuse)700 bool SetupPackageMount(const std::string& package_path, bool* should_use_fuse) {
701   CHECK(should_use_fuse != nullptr);
702 
703   if (package_path.empty()) {
704     return false;
705   }
706 
707   *should_use_fuse = true;
708   if (package_path[0] == '@') {
709     auto block_map_path = package_path.substr(1);
710     if (ensure_path_mounted(block_map_path) != 0) {
711       LOG(ERROR) << "Failed to mount " << block_map_path;
712       return false;
713     }
714     // uncrypt only produces block map only if the package stays on /data.
715     *should_use_fuse = false;
716     return true;
717   }
718 
719   // Package is not a block map file.
720   if (ensure_path_mounted(package_path) != 0) {
721     LOG(ERROR) << "Failed to mount " << package_path;
722     return false;
723   }
724 
725   // Reject the package if the input path doesn't equal the canonicalized path.
726   // e.g. /cache/../sdcard/update_package.
727   std::error_code ec;
728   auto canonical_path = std::filesystem::canonical(package_path, ec);
729   if (ec) {
730     LOG(ERROR) << "Failed to get canonical of " << package_path << ", " << ec.message();
731     return false;
732   }
733   if (canonical_path.string() != package_path) {
734     LOG(ERROR) << "Installation aborts. The canonical path " << canonical_path.string()
735                << " doesn't equal the original path " << package_path;
736     return false;
737   }
738 
739   constexpr const char* CACHE_ROOT = "/cache";
740   if (android::base::StartsWith(package_path, CACHE_ROOT)) {
741     *should_use_fuse = false;
742   }
743   return true;
744 }
745 
746 // Check if `target_token` is in string `str_list`, where `str_list` is expected to be a
747 // list delimited by `deliminator`
748 // E.X. isInStringList("a", "a|b|c|d", "|") => true
749 // E.X. isInStringList("abc", "abc", "|") => true
isInStringList(const std::string & target_token,const std::string & str_list,const std::string & deliminator)750 static bool isInStringList(const std::string& target_token, const std::string& str_list,
751                            const std::string& deliminator) {
752   if (target_token.length() > str_list.length()) {
753     return false;
754   } else if (target_token.length() == str_list.length() || deliminator.length() == 0) {
755     return target_token == str_list;
756   }
757   auto&& list = android::base::Split(str_list, deliminator);
758   return std::find(list.begin(), list.end(), target_token) != list.end();
759 }
760