blob: 0e3cccf133249687c5eb3e132911c5cc7d5728d3 [file] [log] [blame]
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -08001/*
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
xunchang24788852019-03-22 16:08:52 -070017#include "install/install.h"
Tao Bao20c581e2016-12-28 20:55:51 -080018
Doug Zongkerb2ee9202009-06-04 10:24:53 -070019#include <ctype.h>
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080020#include <errno.h>
21#include <fcntl.h>
Alex Deymo4e29ce02016-08-12 13:43:04 -070022#include <inttypes.h>
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080023#include <limits.h>
Elliott Hughes26dbad22015-01-28 12:09:05 -080024#include <string.h>
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080025#include <sys/stat.h>
Doug Zongkerb2ee9202009-06-04 10:24:53 -070026#include <sys/wait.h>
27#include <unistd.h>
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080028
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -070029#include <algorithm>
Tianjie Xu37957102017-06-07 17:59:55 -070030#include <atomic>
Elliott Hughes8febafa2016-04-13 16:39:56 -070031#include <chrono>
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -070032#include <condition_variable>
Tao Bao5e535012017-03-16 17:37:38 -070033#include <functional>
Alex Deymo4344d632016-08-03 21:03:53 -070034#include <limits>
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -070035#include <mutex>
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -070036#include <thread>
Tao Bao71e3e092016-02-02 14:02:27 -080037#include <vector>
38
Tianjie Xue16e7992016-09-09 10:55:44 -070039#include <android-base/file.h>
40#include <android-base/logging.h>
Tao Bao20c581e2016-12-28 20:55:51 -080041#include <android-base/parsedouble.h>
Tianjie Xub0ddae52016-06-08 14:30:04 -070042#include <android-base/parseint.h>
Tao Baoefc35592017-01-08 22:45:47 -080043#include <android-base/properties.h>
Tianjie Xu16255832016-04-30 11:49:59 -070044#include <android-base/stringprintf.h>
45#include <android-base/strings.h>
Tao Baocf60a442018-06-18 14:56:20 -070046#include <android-base/unique_fd.h>
Tao Bao919d2c92017-04-10 16:55:57 -070047#include <vintf/VintfObjectRecovery.h>
Tianjie Xu16255832016-04-30 11:49:59 -070048
xunchang24788852019-03-22 16:08:52 -070049#include "install/package.h"
50#include "install/verifier.h"
xunchang388d2532019-04-12 16:22:15 -070051#include "install/wipe_data.h"
Tao Bao1fc5bf32017-10-06 07:43:41 -070052#include "otautil/error_code.h"
Tao Bao641fa972018-04-25 18:59:40 -070053#include "otautil/paths.h"
xunchang24788852019-03-22 16:08:52 -070054#include "otautil/roots.h"
Tao Bao17054c02018-05-03 22:41:23 -070055#include "otautil/sysutil.h"
56#include "otautil/thermalutil.h"
xunchang24788852019-03-22 16:08:52 -070057#include "private/setup_commands.h"
Tianjie Xu8f397302018-08-20 13:40:47 -070058#include "recovery_ui/ui.h"
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080059
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -070060using namespace std::chrono_literals;
61
xunchang24788852019-03-22 16:08:52 -070062static constexpr int kRecoveryApiVersion = 3;
63// Assert the version defined in code and in Android.mk are consistent.
64static_assert(kRecoveryApiVersion == RECOVERY_API_VERSION, "Mismatching recovery API versions.");
65
Doug Zongker74406302011-10-28 15:13:10 -070066// Default allocation of progress bar segments to operations
Tao Bao20c581e2016-12-28 20:55:51 -080067static constexpr int VERIFICATION_PROGRESS_TIME = 60;
68static constexpr float VERIFICATION_PROGRESS_FRACTION = 0.25;
Doug Zongker74406302011-10-28 15:13:10 -070069
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -070070static std::condition_variable finish_log_temperature;
71
Tianjie Xu93b5bf22018-10-25 10:39:01 -070072bool ReadMetadataFromPackage(ZipArchiveHandle zip, std::map<std::string, std::string>* metadata) {
Tao Bao8a7afcc2017-04-18 22:05:50 -070073 CHECK(metadata != nullptr);
Tianjie Xub0ddae52016-06-08 14:30:04 -070074
Tao Bao8a7afcc2017-04-18 22:05:50 -070075 static constexpr const char* METADATA_PATH = "META-INF/com/android/metadata";
76 ZipString path(METADATA_PATH);
77 ZipEntry entry;
78 if (FindEntry(zip, path, &entry) != 0) {
79 LOG(ERROR) << "Failed to find " << METADATA_PATH;
80 return false;
81 }
82
83 uint32_t length = entry.uncompressed_length;
Tianjie Xu93b5bf22018-10-25 10:39:01 -070084 std::string metadata_string(length, '\0');
85 int32_t err =
86 ExtractToMemory(zip, &entry, reinterpret_cast<uint8_t*>(&metadata_string[0]), length);
Tao Bao8a7afcc2017-04-18 22:05:50 -070087 if (err != 0) {
88 LOG(ERROR) << "Failed to extract " << METADATA_PATH << ": " << ErrorCodeString(err);
89 return false;
90 }
Tianjie Xu93b5bf22018-10-25 10:39:01 -070091
92 for (const std::string& line : android::base::Split(metadata_string, "\n")) {
93 size_t eq = line.find('=');
94 if (eq != std::string::npos) {
95 metadata->emplace(android::base::Trim(line.substr(0, eq)),
96 android::base::Trim(line.substr(eq + 1)));
97 }
98 }
99
Tao Bao8a7afcc2017-04-18 22:05:50 -0700100 return true;
Yabin Cui6faf0262016-06-09 14:09:39 -0700101}
102
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700103// Gets the value for the given key in |metadata|. Returns an emtpy string if the key isn't
104// present.
105static std::string get_value(const std::map<std::string, std::string>& metadata,
106 const std::string& key) {
107 const auto& it = metadata.find(key);
108 return (it == metadata.end()) ? "" : it->second;
109}
110
111static std::string OtaTypeToString(OtaType type) {
112 switch (type) {
113 case OtaType::AB:
114 return "AB";
115 case OtaType::BLOCK:
116 return "BLOCK";
117 case OtaType::BRICK:
118 return "BRICK";
Tao Bao8a7afcc2017-04-18 22:05:50 -0700119 }
Tianjie Xub0ddae52016-06-08 14:30:04 -0700120}
121
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700122// Read the build.version.incremental of src/tgt from the metadata and log it to last_install.
123static void ReadSourceTargetBuild(const std::map<std::string, std::string>& metadata,
124 std::vector<std::string>* log_buffer) {
125 // Examples of the pre-build and post-build strings in metadata:
126 // pre-build-incremental=2943039
127 // post-build-incremental=2951741
128 auto source_build = get_value(metadata, "pre-build-incremental");
129 if (!source_build.empty()) {
130 log_buffer->push_back("source_build: " + source_build);
Tao Baoefc35592017-01-08 22:45:47 -0800131 }
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700132
133 auto target_build = get_value(metadata, "post-build-incremental");
134 if (!target_build.empty()) {
135 log_buffer->push_back("target_build: " + target_build);
136 }
137}
138
139// Checks the build version, fingerprint and timestamp in the metadata of the A/B package.
140// Downgrading is not allowed unless explicitly enabled in the package and only for
Tao Baocf60a442018-06-18 14:56:20 -0700141// incremental packages.
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700142static int CheckAbSpecificMetadata(const std::map<std::string, std::string>& metadata) {
Tao Baoefc35592017-01-08 22:45:47 -0800143 // Incremental updates should match the current build.
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700144 auto device_pre_build = android::base::GetProperty("ro.build.version.incremental", "");
145 auto pkg_pre_build = get_value(metadata, "pre-build-incremental");
146 if (!pkg_pre_build.empty() && pkg_pre_build != device_pre_build) {
147 LOG(ERROR) << "Package is for source build " << pkg_pre_build << " but expected "
148 << device_pre_build;
Tao Baoefc35592017-01-08 22:45:47 -0800149 return INSTALL_ERROR;
150 }
Alex Deymo4344d632016-08-03 21:03:53 -0700151
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700152 auto device_fingerprint = android::base::GetProperty("ro.build.fingerprint", "");
153 auto pkg_pre_build_fingerprint = get_value(metadata, "pre-build");
154 if (!pkg_pre_build_fingerprint.empty() && pkg_pre_build_fingerprint != device_fingerprint) {
Tao Baoefc35592017-01-08 22:45:47 -0800155 LOG(ERROR) << "Package is for source build " << pkg_pre_build_fingerprint << " but expected "
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700156 << device_fingerprint;
Tao Baoefc35592017-01-08 22:45:47 -0800157 return INSTALL_ERROR;
158 }
Alex Deymo4344d632016-08-03 21:03:53 -0700159
bigbiff26d5d5f2020-03-23 09:56:16 -0400160<<<<<<< HEAD:install.cpp
161=======
Tao Baoefc35592017-01-08 22:45:47 -0800162 // Check for downgrade version.
163 int64_t build_timestamp =
164 android::base::GetIntProperty("ro.build.date.utc", std::numeric_limits<int64_t>::max());
165 int64_t pkg_post_timestamp = 0;
166 // We allow to full update to the same version we are running, in case there
167 // is a problem with the current copy of that version.
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700168 auto pkg_post_timestamp_string = get_value(metadata, "post-timestamp");
169 if (pkg_post_timestamp_string.empty() ||
170 !android::base::ParseInt(pkg_post_timestamp_string, &pkg_post_timestamp) ||
Tao Baoefc35592017-01-08 22:45:47 -0800171 pkg_post_timestamp < build_timestamp) {
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700172 if (get_value(metadata, "ota-downgrade") != "yes") {
Tao Baoefc35592017-01-08 22:45:47 -0800173 LOG(ERROR) << "Update package is older than the current build, expected a build "
174 "newer than timestamp "
175 << build_timestamp << " but package has timestamp " << pkg_post_timestamp
176 << " and downgrade not allowed.";
177 return INSTALL_ERROR;
178 }
179 if (pkg_pre_build_fingerprint.empty()) {
180 LOG(ERROR) << "Downgrade package must have a pre-build version set, not allowed.";
181 return INSTALL_ERROR;
Alex Deymo4344d632016-08-03 21:03:53 -0700182 }
183 }
184
bigbiff26d5d5f2020-03-23 09:56:16 -0400185>>>>>>> android-10.0.0_r25:install/install.cpp
Tao Baoefc35592017-01-08 22:45:47 -0800186 return 0;
Alex Deymo4344d632016-08-03 21:03:53 -0700187}
188
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700189int CheckPackageMetadata(const std::map<std::string, std::string>& metadata, OtaType ota_type) {
190 auto package_ota_type = get_value(metadata, "ota-type");
191 auto expected_ota_type = OtaTypeToString(ota_type);
192 if (ota_type != OtaType::AB && ota_type != OtaType::BRICK) {
193 LOG(INFO) << "Skip package metadata check for ota type " << expected_ota_type;
194 return 0;
195 }
196
197 if (package_ota_type != expected_ota_type) {
198 LOG(ERROR) << "Unexpected ota package type, expects " << expected_ota_type << ", actual "
199 << package_ota_type;
200 return INSTALL_ERROR;
201 }
202
203 auto device = android::base::GetProperty("ro.product.device", "");
204 auto pkg_device = get_value(metadata, "pre-device");
205 if (pkg_device != device || pkg_device.empty()) {
206 LOG(ERROR) << "Package is for product " << pkg_device << " but expected " << device;
Alex Deymo4344d632016-08-03 21:03:53 -0700207 return INSTALL_ERROR;
208 }
209
210 // We allow the package to not have any serialno; and we also allow it to carry multiple serial
211 // numbers split by "|"; e.g. serialno=serialno1|serialno2|serialno3 ... We will fail the
212 // verification if the device's serialno doesn't match any of these carried numbers.
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700213 auto pkg_serial_no = get_value(metadata, "serialno");
Alex Deymo4344d632016-08-03 21:03:53 -0700214 if (!pkg_serial_no.empty()) {
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700215 auto device_serial_no = android::base::GetProperty("ro.serialno", "");
216 bool serial_number_match = false;
217 for (const auto& number : android::base::Split(pkg_serial_no, "|")) {
218 if (device_serial_no == android::base::Trim(number)) {
219 serial_number_match = true;
Alex Deymo4344d632016-08-03 21:03:53 -0700220 }
221 }
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700222 if (!serial_number_match) {
Alex Deymo4344d632016-08-03 21:03:53 -0700223 LOG(ERROR) << "Package is for serial " << pkg_serial_no;
224 return INSTALL_ERROR;
225 }
Alex Deymo4344d632016-08-03 21:03:53 -0700226 }
227
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700228 if (ota_type == OtaType::AB) {
229 return CheckAbSpecificMetadata(metadata);
Alex Deymo4344d632016-08-03 21:03:53 -0700230 }
231
Alex Deymo4344d632016-08-03 21:03:53 -0700232 return 0;
233}
234
Tao Baocf60a442018-06-18 14:56:20 -0700235int SetUpAbUpdateCommands(const std::string& package, ZipArchiveHandle zip, int status_fd,
Tao Bao00d57572017-05-02 15:48:54 -0700236 std::vector<std::string>* cmd) {
Tao Baobc4b1fe2017-04-17 16:46:05 -0700237 CHECK(cmd != nullptr);
Alex Deymo4344d632016-08-03 21:03:53 -0700238
Tao Baobc4b1fe2017-04-17 16:46:05 -0700239 // 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 ZipString property_name(AB_OTA_PAYLOAD_PROPERTIES);
243 ZipEntry properties_entry;
244 if (FindEntry(zip, property_name, &properties_entry) != 0) {
245 LOG(ERROR) << "Failed to find " << AB_OTA_PAYLOAD_PROPERTIES;
246 return INSTALL_CORRUPT;
247 }
248 uint32_t properties_entry_length = properties_entry.uncompressed_length;
249 std::vector<uint8_t> payload_properties(properties_entry_length);
250 int32_t err =
251 ExtractToMemory(zip, &properties_entry, payload_properties.data(), properties_entry_length);
252 if (err != 0) {
253 LOG(ERROR) << "Failed to extract " << AB_OTA_PAYLOAD_PROPERTIES << ": " << ErrorCodeString(err);
254 return INSTALL_CORRUPT;
255 }
Alex Deymo4344d632016-08-03 21:03:53 -0700256
Tao Baobc4b1fe2017-04-17 16:46:05 -0700257 static constexpr const char* AB_OTA_PAYLOAD = "payload.bin";
258 ZipString payload_name(AB_OTA_PAYLOAD);
259 ZipEntry payload_entry;
260 if (FindEntry(zip, payload_name, &payload_entry) != 0) {
261 LOG(ERROR) << "Failed to find " << AB_OTA_PAYLOAD;
262 return INSTALL_CORRUPT;
263 }
264 long payload_offset = payload_entry.offset;
265 *cmd = {
Tao Bao2cc9bbb2018-08-14 12:34:46 -0700266 "/system/bin/update_engine_sideload",
Tao Bao00d57572017-05-02 15:48:54 -0700267 "--payload=file://" + package,
Tao Baobc4b1fe2017-04-17 16:46:05 -0700268 android::base::StringPrintf("--offset=%ld", payload_offset),
269 "--headers=" + std::string(payload_properties.begin(), payload_properties.end()),
270 android::base::StringPrintf("--status_fd=%d", status_fd),
271 };
272 return 0;
Alex Deymo4344d632016-08-03 21:03:53 -0700273}
274
Tao Baocf60a442018-06-18 14:56:20 -0700275int SetUpNonAbUpdateCommands(const std::string& package, ZipArchiveHandle zip, int retry_count,
276 int status_fd, std::vector<std::string>* cmd) {
Tao Baobc4b1fe2017-04-17 16:46:05 -0700277 CHECK(cmd != nullptr);
Doug Zongkerb2ee9202009-06-04 10:24:53 -0700278
Tao Baocf60a442018-06-18 14:56:20 -0700279 // In non-A/B updates we extract the update binary from the package.
Tao Baobc4b1fe2017-04-17 16:46:05 -0700280 static constexpr const char* UPDATE_BINARY_NAME = "META-INF/com/google/android/update-binary";
281 ZipString binary_name(UPDATE_BINARY_NAME);
282 ZipEntry binary_entry;
283 if (FindEntry(zip, binary_name, &binary_entry) != 0) {
284 LOG(ERROR) << "Failed to find update binary " << UPDATE_BINARY_NAME;
285 return INSTALL_CORRUPT;
286 }
Doug Zongkerb2ee9202009-06-04 10:24:53 -0700287
Tao Baocf60a442018-06-18 14:56:20 -0700288 const std::string binary_path = Paths::Get().temporary_update_binary();
Tao Bao00d57572017-05-02 15:48:54 -0700289 unlink(binary_path.c_str());
Tao Baocf60a442018-06-18 14:56:20 -0700290 android::base::unique_fd fd(
291 open(binary_path.c_str(), O_CREAT | O_WRONLY | O_TRUNC | O_CLOEXEC, 0755));
Tao Baobc4b1fe2017-04-17 16:46:05 -0700292 if (fd == -1) {
Tao Bao00d57572017-05-02 15:48:54 -0700293 PLOG(ERROR) << "Failed to create " << binary_path;
Tao Baobc4b1fe2017-04-17 16:46:05 -0700294 return INSTALL_ERROR;
295 }
Doug Zongkerb2ee9202009-06-04 10:24:53 -0700296
Tao Baobc4b1fe2017-04-17 16:46:05 -0700297 int32_t error = ExtractEntryToFile(zip, &binary_entry, fd);
Tao Baobc4b1fe2017-04-17 16:46:05 -0700298 if (error != 0) {
299 LOG(ERROR) << "Failed to extract " << UPDATE_BINARY_NAME << ": " << ErrorCodeString(error);
300 return INSTALL_ERROR;
301 }
302
Tao Bao6fcd2082019-01-16 09:29:17 -0800303 // When executing the update binary contained in the package, the arguments passed are:
304 // - the version number for this interface
305 // - an FD to which the program can write in order to update the progress bar.
306 // - the name of the package zip file.
307 // - an optional argument "retry" if this update is a retry of a failed update attempt.
Tao Baobc4b1fe2017-04-17 16:46:05 -0700308 *cmd = {
Tao Bao00d57572017-05-02 15:48:54 -0700309 binary_path,
Tao Baobd0ddcd2017-05-04 13:03:18 -0700310 std::to_string(kRecoveryApiVersion),
Tao Baobc4b1fe2017-04-17 16:46:05 -0700311 std::to_string(status_fd),
Tao Bao00d57572017-05-02 15:48:54 -0700312 package,
Tao Baobc4b1fe2017-04-17 16:46:05 -0700313 };
314 if (retry_count > 0) {
315 cmd->push_back("retry");
316 }
317 return 0;
Alex Deymo4344d632016-08-03 21:03:53 -0700318}
Alex Deymo4344d632016-08-03 21:03:53 -0700319
Tianjie Xu37957102017-06-07 17:59:55 -0700320static void log_max_temperature(int* max_temperature, const std::atomic<bool>& logger_finished) {
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -0700321 CHECK(max_temperature != nullptr);
322 std::mutex mtx;
323 std::unique_lock<std::mutex> lck(mtx);
Tianjie Xu37957102017-06-07 17:59:55 -0700324 while (!logger_finished.load() &&
325 finish_log_temperature.wait_for(lck, 20s) == std::cv_status::timeout) {
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -0700326 *max_temperature = std::max(*max_temperature, GetMaxValueFromThermalZone());
327 }
328}
329
Alex Deymo4344d632016-08-03 21:03:53 -0700330// If the package contains an update binary, extract it and run it.
Tao Bao00d57572017-05-02 15:48:54 -0700331static int try_update_binary(const std::string& package, ZipArchiveHandle zip, bool* wipe_cache,
Tao Bao29ee69b2017-05-01 12:23:17 -0700332 std::vector<std::string>* log_buffer, int retry_count,
xunchang24788852019-03-22 16:08:52 -0700333 int* max_temperature, RecoveryUI* ui) {
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700334 std::map<std::string, std::string> metadata;
335 if (!ReadMetadataFromPackage(zip, &metadata)) {
336 LOG(ERROR) << "Failed to parse metadata in the zip file";
337 return INSTALL_CORRUPT;
Tao Bao20c581e2016-12-28 20:55:51 -0800338 }
Doug Zongkerb2ee9202009-06-04 10:24:53 -0700339
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700340 bool is_ab = android::base::GetBoolProperty("ro.build.ab_update", false);
341 // Verifies against the metadata in the package first.
342 if (int check_status = is_ab ? CheckPackageMetadata(metadata, OtaType::AB) : 0;
343 check_status != 0) {
344 log_buffer->push_back(android::base::StringPrintf("error: %d", kUpdateBinaryCommandFailure));
345 return check_status;
346 }
347
348 ReadSourceTargetBuild(metadata, log_buffer);
Tianjie Xu16255832016-04-30 11:49:59 -0700349
Tao Bao6fcd2082019-01-16 09:29:17 -0800350 // The updater in child process writes to the pipe to communicate with recovery.
351 android::base::unique_fd pipe_read, pipe_write;
Bill Peckham08ba1ad2019-03-28 18:42:13 -0700352 // Explicitly disable O_CLOEXEC using 0 as the flags (last) parameter to Pipe
353 // so that the child updater process will recieve a non-closed fd.
354 if (!android::base::Pipe(&pipe_read, &pipe_write, 0)) {
Tao Bao6fcd2082019-01-16 09:29:17 -0800355 PLOG(ERROR) << "Failed to create pipe for updater-recovery communication";
356 return INSTALL_CORRUPT;
357 }
358
359 // The updater-recovery communication protocol.
Tao Bao20c581e2016-12-28 20:55:51 -0800360 //
Tao Bao6fcd2082019-01-16 09:29:17 -0800361 // progress <frac> <secs>
362 // fill up the next <frac> part of of the progress bar over <secs> seconds. If <secs> is
363 // zero, use `set_progress` commands to manually control the progress of this segment of the
364 // bar.
Tao Bao20c581e2016-12-28 20:55:51 -0800365 //
Tao Bao6fcd2082019-01-16 09:29:17 -0800366 // set_progress <frac>
367 // <frac> should be between 0.0 and 1.0; sets the progress bar within the segment defined by
368 // the most recent progress command.
Tao Bao20c581e2016-12-28 20:55:51 -0800369 //
Tao Bao6fcd2082019-01-16 09:29:17 -0800370 // ui_print <string>
371 // display <string> on the screen.
Tao Bao20c581e2016-12-28 20:55:51 -0800372 //
Tao Bao6fcd2082019-01-16 09:29:17 -0800373 // wipe_cache
374 // a wipe of cache will be performed following a successful installation.
Tao Bao20c581e2016-12-28 20:55:51 -0800375 //
Tao Bao6fcd2082019-01-16 09:29:17 -0800376 // clear_display
377 // turn off the text display.
Tao Bao20c581e2016-12-28 20:55:51 -0800378 //
Tao Bao6fcd2082019-01-16 09:29:17 -0800379 // enable_reboot
380 // packages can explicitly request that they want the user to be able to reboot during
381 // installation (useful for debugging packages that don't exit).
Tao Bao20c581e2016-12-28 20:55:51 -0800382 //
Tao Bao6fcd2082019-01-16 09:29:17 -0800383 // retry_update
384 // updater encounters some issue during the update. It requests a reboot to retry the same
385 // package automatically.
Tao Bao20c581e2016-12-28 20:55:51 -0800386 //
Tao Bao6fcd2082019-01-16 09:29:17 -0800387 // log <string>
388 // updater requests logging the string (e.g. cause of the failure).
Tao Bao20c581e2016-12-28 20:55:51 -0800389 //
Doug Zongkerd9c9d102009-06-12 12:24:39 -0700390
Doug Zongker99916f02014-01-13 14:16:58 -0800391 std::vector<std::string> args;
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700392 if (int update_status =
Tao Bao6fcd2082019-01-16 09:29:17 -0800393 is_ab ? SetUpAbUpdateCommands(package, zip, pipe_write.get(), &args)
394 : SetUpNonAbUpdateCommands(package, zip, retry_count, pipe_write.get(), &args);
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700395 update_status != 0) {
Tianjie Xu3fec8c62017-08-23 00:18:07 -0700396 log_buffer->push_back(android::base::StringPrintf("error: %d", kUpdateBinaryCommandFailure));
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700397 return update_status;
Tao Bao20c581e2016-12-28 20:55:51 -0800398 }
Doug Zongkerd9c9d102009-06-12 12:24:39 -0700399
Tao Bao20c581e2016-12-28 20:55:51 -0800400 pid_t pid = fork();
Tao Bao20c581e2016-12-28 20:55:51 -0800401 if (pid == -1) {
Tao Bao20c581e2016-12-28 20:55:51 -0800402 PLOG(ERROR) << "Failed to fork update binary";
Tianjie Xu3fec8c62017-08-23 00:18:07 -0700403 log_buffer->push_back(android::base::StringPrintf("error: %d", kForkUpdateBinaryFailure));
Tao Bao20c581e2016-12-28 20:55:51 -0800404 return INSTALL_ERROR;
405 }
406
407 if (pid == 0) {
408 umask(022);
Tao Bao6fcd2082019-01-16 09:29:17 -0800409 pipe_read.reset();
410
411 // Convert the std::string vector to a NULL-terminated char* vector suitable for execv.
412 auto chr_args = StringVectorToNullTerminatedArray(args);
Tao Bao3d69f0d2018-12-20 09:44:06 -0800413 execv(chr_args[0], chr_args.data());
Tao Bao6fcd2082019-01-16 09:29:17 -0800414 // We shouldn't use LOG/PLOG in the forked process, since they may cause the child process to
415 // hang. This deadlock results from an improperly copied mutex in the ui functions.
416 // (Bug: 34769056)
Tianjie Xuab1abae2017-01-30 16:48:52 -0800417 fprintf(stdout, "E:Can't run %s (%s)\n", chr_args[0], strerror(errno));
Tao Bao3da88012017-02-03 13:09:23 -0800418 _exit(EXIT_FAILURE);
Tao Bao20c581e2016-12-28 20:55:51 -0800419 }
Tao Bao6fcd2082019-01-16 09:29:17 -0800420 pipe_write.reset();
Tao Bao20c581e2016-12-28 20:55:51 -0800421
Tianjie Xu37957102017-06-07 17:59:55 -0700422 std::atomic<bool> logger_finished(false);
423 std::thread temperature_logger(log_max_temperature, max_temperature, std::ref(logger_finished));
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -0700424
Tao Bao20c581e2016-12-28 20:55:51 -0800425 *wipe_cache = false;
426 bool retry_update = false;
427
428 char buffer[1024];
Tao Bao6fcd2082019-01-16 09:29:17 -0800429 FILE* from_child = android::base::Fdopen(std::move(pipe_read), "r");
Tao Bao20c581e2016-12-28 20:55:51 -0800430 while (fgets(buffer, sizeof(buffer), from_child) != nullptr) {
431 std::string line(buffer);
432 size_t space = line.find_first_of(" \n");
433 std::string command(line.substr(0, space));
434 if (command.empty()) continue;
435
436 // Get rid of the leading and trailing space and/or newline.
437 std::string args = space == std::string::npos ? "" : android::base::Trim(line.substr(space));
438
439 if (command == "progress") {
440 std::vector<std::string> tokens = android::base::Split(args, " ");
441 double fraction;
442 int seconds;
443 if (tokens.size() == 2 && android::base::ParseDouble(tokens[0].c_str(), &fraction) &&
444 android::base::ParseInt(tokens[1], &seconds)) {
445 ui->ShowProgress(fraction * (1 - VERIFICATION_PROGRESS_FRACTION), seconds);
446 } else {
447 LOG(ERROR) << "invalid \"progress\" parameters: " << line;
448 }
449 } else if (command == "set_progress") {
450 std::vector<std::string> tokens = android::base::Split(args, " ");
451 double fraction;
452 if (tokens.size() == 1 && android::base::ParseDouble(tokens[0].c_str(), &fraction)) {
453 ui->SetProgress(fraction);
454 } else {
455 LOG(ERROR) << "invalid \"set_progress\" parameters: " << line;
456 }
457 } else if (command == "ui_print") {
Tao Baof0136422017-01-21 13:03:25 -0800458 ui->PrintOnScreenOnly("%s\n", args.c_str());
Tao Bao20c581e2016-12-28 20:55:51 -0800459 fflush(stdout);
460 } else if (command == "wipe_cache") {
461 *wipe_cache = true;
462 } else if (command == "clear_display") {
463 ui->SetBackground(RecoveryUI::NONE);
464 } else if (command == "enable_reboot") {
465 // packages can explicitly request that they want the user
466 // to be able to reboot during installation (useful for
467 // debugging packages that don't exit).
468 ui->SetEnableReboot(true);
469 } else if (command == "retry_update") {
470 retry_update = true;
471 } else if (command == "log") {
472 if (!args.empty()) {
473 // Save the logging request from updater and write to last_install later.
Tao Bao29ee69b2017-05-01 12:23:17 -0700474 log_buffer->push_back(args);
Tao Bao20c581e2016-12-28 20:55:51 -0800475 } else {
476 LOG(ERROR) << "invalid \"log\" parameters: " << line;
477 }
478 } else {
479 LOG(ERROR) << "unknown command [" << command << "]";
Doug Zongkerd0181b82011-10-19 10:51:12 -0700480 }
Tao Bao20c581e2016-12-28 20:55:51 -0800481 }
482 fclose(from_child);
Doug Zongker02ec6b82012-08-22 17:26:40 -0700483
Tao Bao20c581e2016-12-28 20:55:51 -0800484 int status;
485 waitpid(pid, &status, 0);
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -0700486
Tianjie Xu37957102017-06-07 17:59:55 -0700487 logger_finished.store(true);
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -0700488 finish_log_temperature.notify_one();
489 temperature_logger.join();
490
Tao Bao20c581e2016-12-28 20:55:51 -0800491 if (retry_update) {
492 return INSTALL_RETRY;
493 }
Tao Baoe7b775c2018-11-07 15:13:30 -0800494 if (WIFEXITED(status)) {
495 if (WEXITSTATUS(status) != EXIT_SUCCESS) {
496 LOG(ERROR) << "Error in " << package << " (status " << WEXITSTATUS(status) << ")";
497 return INSTALL_ERROR;
498 }
499 } else if (WIFSIGNALED(status)) {
500 LOG(ERROR) << "Error in " << package << " (killed by signal " << WTERMSIG(status) << ")";
Tao Bao20c581e2016-12-28 20:55:51 -0800501 return INSTALL_ERROR;
Tao Baoe7b775c2018-11-07 15:13:30 -0800502 } else {
503 LOG(FATAL) << "Invalid status code " << status;
Tao Bao20c581e2016-12-28 20:55:51 -0800504 }
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800505
Tao Bao20c581e2016-12-28 20:55:51 -0800506 return INSTALL_SUCCESS;
Doug Zongker74406302011-10-28 15:13:10 -0700507}
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800508
Tao Bao1d866052017-04-10 16:55:57 -0700509// Verifes the compatibility info in a Treble-compatible package. Returns true directly if the
510// entry doesn't exist. Note that the compatibility info is packed in a zip file inside the OTA
511// package.
512bool verify_package_compatibility(ZipArchiveHandle package_zip) {
513 LOG(INFO) << "Verifying package compatibility...";
514
515 static constexpr const char* COMPATIBILITY_ZIP_ENTRY = "compatibility.zip";
516 ZipString compatibility_entry_name(COMPATIBILITY_ZIP_ENTRY);
517 ZipEntry compatibility_entry;
518 if (FindEntry(package_zip, compatibility_entry_name, &compatibility_entry) != 0) {
519 LOG(INFO) << "Package doesn't contain " << COMPATIBILITY_ZIP_ENTRY << " entry";
520 return true;
521 }
522
523 std::string zip_content(compatibility_entry.uncompressed_length, '\0');
524 int32_t ret;
525 if ((ret = ExtractToMemory(package_zip, &compatibility_entry,
526 reinterpret_cast<uint8_t*>(&zip_content[0]),
527 compatibility_entry.uncompressed_length)) != 0) {
528 LOG(ERROR) << "Failed to read " << COMPATIBILITY_ZIP_ENTRY << ": " << ErrorCodeString(ret);
529 return false;
530 }
531
532 ZipArchiveHandle zip_handle;
533 ret = OpenArchiveFromMemory(static_cast<void*>(const_cast<char*>(zip_content.data())),
534 zip_content.size(), COMPATIBILITY_ZIP_ENTRY, &zip_handle);
535 if (ret != 0) {
536 LOG(ERROR) << "Failed to OpenArchiveFromMemory: " << ErrorCodeString(ret);
537 return false;
538 }
539
540 // Iterate all the entries inside COMPATIBILITY_ZIP_ENTRY and read the contents.
541 void* cookie;
542 ret = StartIteration(zip_handle, &cookie, nullptr, nullptr);
543 if (ret != 0) {
544 LOG(ERROR) << "Failed to start iterating zip entries: " << ErrorCodeString(ret);
545 CloseArchive(zip_handle);
546 return false;
547 }
548 std::unique_ptr<void, decltype(&EndIteration)> guard(cookie, EndIteration);
549
550 std::vector<std::string> compatibility_info;
551 ZipEntry info_entry;
552 ZipString info_name;
553 while (Next(cookie, &info_entry, &info_name) == 0) {
554 std::string content(info_entry.uncompressed_length, '\0');
555 int32_t ret = ExtractToMemory(zip_handle, &info_entry, reinterpret_cast<uint8_t*>(&content[0]),
556 info_entry.uncompressed_length);
557 if (ret != 0) {
558 LOG(ERROR) << "Failed to read " << info_name.name << ": " << ErrorCodeString(ret);
559 CloseArchive(zip_handle);
560 return false;
561 }
562 compatibility_info.emplace_back(std::move(content));
563 }
Tao Bao1d866052017-04-10 16:55:57 -0700564 CloseArchive(zip_handle);
565
Tao Bao919d2c92017-04-10 16:55:57 -0700566 // VintfObjectRecovery::CheckCompatibility returns zero on success.
567 std::string err;
568 int result = android::vintf::VintfObjectRecovery::CheckCompatibility(compatibility_info, &err);
569 if (result == 0) {
570 return true;
571 }
572
573 LOG(ERROR) << "Failed to verify package compatibility (result " << result << "): " << err;
574 return false;
Tao Bao1d866052017-04-10 16:55:57 -0700575}
576
Tao Bao29ee69b2017-05-01 12:23:17 -0700577static int really_install_package(const std::string& path, bool* wipe_cache, bool needs_mount,
578 std::vector<std::string>* log_buffer, int retry_count,
xunchang24788852019-03-22 16:08:52 -0700579 int* max_temperature, RecoveryUI* ui) {
Tao Bao29ee69b2017-05-01 12:23:17 -0700580 ui->SetBackground(RecoveryUI::INSTALLING_UPDATE);
581 ui->Print("Finding update package...\n");
582 // Give verification half the progress bar...
583 ui->SetProgressType(RecoveryUI::DETERMINATE);
584 ui->ShowProgress(VERIFICATION_PROGRESS_FRACTION, VERIFICATION_PROGRESS_TIME);
585 LOG(INFO) << "Update location: " << path;
Doug Zongker60151a22009-08-12 18:30:03 -0700586
Tao Bao29ee69b2017-05-01 12:23:17 -0700587 // Map the update package into memory.
588 ui->Print("Opening update package...\n");
Doug Zongker60151a22009-08-12 18:30:03 -0700589
Tao Bao29ee69b2017-05-01 12:23:17 -0700590 if (needs_mount) {
591 if (path[0] == '@') {
Yifan Hongd81b8e32018-12-17 14:29:06 -0800592 ensure_path_mounted(path.substr(1));
Tao Bao29ee69b2017-05-01 12:23:17 -0700593 } else {
Yifan Hongd81b8e32018-12-17 14:29:06 -0800594 ensure_path_mounted(path);
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800595 }
Tao Bao29ee69b2017-05-01 12:23:17 -0700596 }
Doug Zongker60151a22009-08-12 18:30:03 -0700597
xunchangf07ed2e2019-02-25 14:14:01 -0800598 auto package = Package::CreateMemoryPackage(
599 path, std::bind(&RecoveryUI::SetProgress, ui, std::placeholders::_1));
600 if (!package) {
Tianjie Xu3fec8c62017-08-23 00:18:07 -0700601 log_buffer->push_back(android::base::StringPrintf("error: %d", kMapFileFailure));
Tao Bao29ee69b2017-05-01 12:23:17 -0700602 return INSTALL_CORRUPT;
603 }
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800604
Tao Bao29ee69b2017-05-01 12:23:17 -0700605 // Verify package.
xunchang24788852019-03-22 16:08:52 -0700606 if (!verify_package(package.get(), ui)) {
Tao Bao29ee69b2017-05-01 12:23:17 -0700607 log_buffer->push_back(android::base::StringPrintf("error: %d", kZipVerificationFailure));
Tao Bao29ee69b2017-05-01 12:23:17 -0700608 return INSTALL_CORRUPT;
609 }
Doug Zongker99916f02014-01-13 14:16:58 -0800610
Tao Bao29ee69b2017-05-01 12:23:17 -0700611 // Try to open the package.
xunchangf07ed2e2019-02-25 14:14:01 -0800612 ZipArchiveHandle zip = package->GetZipArchiveHandle();
613 if (!zip) {
Tao Bao29ee69b2017-05-01 12:23:17 -0700614 log_buffer->push_back(android::base::StringPrintf("error: %d", kZipOpenFailure));
Tao Bao29ee69b2017-05-01 12:23:17 -0700615 return INSTALL_CORRUPT;
616 }
617
Tao Bao032403f2019-03-18 13:22:50 -0700618 // Additionally verify the compatibility of the package if it's a fresh install.
619 if (retry_count == 0 && !verify_package_compatibility(zip)) {
Tao Bao29ee69b2017-05-01 12:23:17 -0700620 log_buffer->push_back(android::base::StringPrintf("error: %d", kPackageCompatibilityFailure));
Tao Bao29ee69b2017-05-01 12:23:17 -0700621 return INSTALL_CORRUPT;
622 }
623
624 // Verify and install the contents of the package.
625 ui->Print("Installing update...\n");
626 if (retry_count > 0) {
627 ui->Print("Retry attempt: %d\n", retry_count);
628 }
629 ui->SetEnableReboot(false);
xunchang24788852019-03-22 16:08:52 -0700630 int result =
631 try_update_binary(path, zip, wipe_cache, log_buffer, retry_count, max_temperature, ui);
Tao Bao29ee69b2017-05-01 12:23:17 -0700632 ui->SetEnableReboot(true);
633 ui->Print("\n");
634
Tao Bao29ee69b2017-05-01 12:23:17 -0700635 return result;
Doug Zongker469243e2011-04-12 09:28:10 -0700636}
Doug Zongker239ac6a2013-08-20 16:03:25 -0700637
xunchang388d2532019-04-12 16:22:15 -0700638int install_package(const std::string& path, bool should_wipe_cache, bool needs_mount,
639 int retry_count, RecoveryUI* ui) {
Tao Bao29ee69b2017-05-01 12:23:17 -0700640 CHECK(!path.empty());
Tao Bao29ee69b2017-05-01 12:23:17 -0700641
Tao Baof8119fb2017-04-18 21:35:12 -0700642 auto start = std::chrono::system_clock::now();
Doug Zongker239ac6a2013-08-20 16:03:25 -0700643
Tao Baof8119fb2017-04-18 21:35:12 -0700644 int start_temperature = GetMaxValueFromThermalZone();
645 int max_temperature = start_temperature;
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -0700646
Tao Baof8119fb2017-04-18 21:35:12 -0700647 int result;
648 std::vector<std::string> log_buffer;
649 if (setup_install_mounts() != 0) {
650 LOG(ERROR) << "failed to set up expected mounts for install; aborting";
651 result = INSTALL_ERROR;
652 } else {
xunchang388d2532019-04-12 16:22:15 -0700653 bool updater_wipe_cache = false;
654 result = really_install_package(path, &updater_wipe_cache, needs_mount, &log_buffer,
655 retry_count, &max_temperature, ui);
656 should_wipe_cache = should_wipe_cache || updater_wipe_cache;
Tao Baof8119fb2017-04-18 21:35:12 -0700657 }
658
659 // Measure the time spent to apply OTA update in seconds.
660 std::chrono::duration<double> duration = std::chrono::system_clock::now() - start;
661 int time_total = static_cast<int>(duration.count());
662
Tao Bao3e18f2b2017-09-29 17:11:13 -0700663 bool has_cache = volume_for_mount_point("/cache") != nullptr;
Tao Baof8119fb2017-04-18 21:35:12 -0700664 // Skip logging the uncrypt_status on devices without /cache.
665 if (has_cache) {
666 static constexpr const char* UNCRYPT_STATUS = "/cache/recovery/uncrypt_status";
667 if (ensure_path_mounted(UNCRYPT_STATUS) != 0) {
668 LOG(WARNING) << "Can't mount " << UNCRYPT_STATUS;
Doug Zongker469243e2011-04-12 09:28:10 -0700669 } else {
Tao Baof8119fb2017-04-18 21:35:12 -0700670 std::string uncrypt_status;
671 if (!android::base::ReadFileToString(UNCRYPT_STATUS, &uncrypt_status)) {
672 PLOG(WARNING) << "failed to read uncrypt status";
673 } else if (!android::base::StartsWith(uncrypt_status, "uncrypt_")) {
674 LOG(WARNING) << "corrupted uncrypt_status: " << uncrypt_status;
Tianjie Xua2867782017-03-24 14:13:56 -0700675 } else {
Tao Baof8119fb2017-04-18 21:35:12 -0700676 log_buffer.push_back(android::base::Trim(uncrypt_status));
Tianjie Xua2867782017-03-24 14:13:56 -0700677 }
Doug Zongker469243e2011-04-12 09:28:10 -0700678 }
Tao Baof8119fb2017-04-18 21:35:12 -0700679 }
Tao Baobadaac42016-09-26 11:39:14 -0700680
Tao Baof8119fb2017-04-18 21:35:12 -0700681 // The first two lines need to be the package name and install result.
682 std::vector<std::string> log_header = {
683 path,
684 result == INSTALL_SUCCESS ? "1" : "0",
685 "time_total: " + std::to_string(time_total),
686 "retry: " + std::to_string(retry_count),
687 };
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -0700688
Tao Baof8119fb2017-04-18 21:35:12 -0700689 int end_temperature = GetMaxValueFromThermalZone();
690 max_temperature = std::max(end_temperature, max_temperature);
691 if (start_temperature > 0) {
692 log_buffer.push_back("temperature_start: " + std::to_string(start_temperature));
693 }
694 if (end_temperature > 0) {
695 log_buffer.push_back("temperature_end: " + std::to_string(end_temperature));
696 }
697 if (max_temperature > 0) {
698 log_buffer.push_back("temperature_max: " + std::to_string(max_temperature));
699 }
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -0700700
Tao Baof8119fb2017-04-18 21:35:12 -0700701 std::string log_content =
702 android::base::Join(log_header, "\n") + "\n" + android::base::Join(log_buffer, "\n") + "\n";
Tao Bao641fa972018-04-25 18:59:40 -0700703 const std::string& install_file = Paths::Get().temporary_install_file();
Tao Baof8119fb2017-04-18 21:35:12 -0700704 if (!android::base::WriteStringToFile(log_content, install_file)) {
705 PLOG(ERROR) << "failed to write " << install_file;
706 }
Tao Baobadaac42016-09-26 11:39:14 -0700707
Tao Baof8119fb2017-04-18 21:35:12 -0700708 // Write a copy into last_log.
709 LOG(INFO) << log_content;
Tao Baobadaac42016-09-26 11:39:14 -0700710
xunchang388d2532019-04-12 16:22:15 -0700711 if (result == INSTALL_SUCCESS && should_wipe_cache) {
712 if (!WipeCache(ui, nullptr)) {
713 result = INSTALL_ERROR;
714 }
715 }
716
Tao Baof8119fb2017-04-18 21:35:12 -0700717 return result;
Doug Zongker469243e2011-04-12 09:28:10 -0700718}
Yabin Cui6faf0262016-06-09 14:09:39 -0700719
xunchang24788852019-03-22 16:08:52 -0700720bool verify_package(Package* package, RecoveryUI* ui) {
Tianjie Xue1d02fb2018-10-19 15:52:17 -0700721 static constexpr const char* CERTIFICATE_ZIP_FILE = "/system/etc/security/otacerts.zip";
722 std::vector<Certificate> loaded_keys = LoadKeysFromZipfile(CERTIFICATE_ZIP_FILE);
723 if (loaded_keys.empty()) {
Tao Bao5e535012017-03-16 17:37:38 -0700724 LOG(ERROR) << "Failed to load keys";
725 return false;
726 }
Tianjie Xue1d02fb2018-10-19 15:52:17 -0700727 LOG(INFO) << loaded_keys.size() << " key(s) loaded from " << CERTIFICATE_ZIP_FILE;
Yabin Cui6faf0262016-06-09 14:09:39 -0700728
Tao Bao5e535012017-03-16 17:37:38 -0700729 // Verify package.
730 ui->Print("Verifying update package...\n");
731 auto t0 = std::chrono::system_clock::now();
xunchangf07ed2e2019-02-25 14:14:01 -0800732 int err = verify_file(package, loaded_keys);
Tao Bao5e535012017-03-16 17:37:38 -0700733 std::chrono::duration<double> duration = std::chrono::system_clock::now() - t0;
734 ui->Print("Update package verification took %.1f s (result %d).\n", duration.count(), err);
735 if (err != VERIFY_SUCCESS) {
736 LOG(ERROR) << "Signature verification failed";
737 LOG(ERROR) << "error: " << kZipVerificationFailure;
738 return false;
739 }
740 return true;
Yabin Cui6faf0262016-06-09 14:09:39 -0700741}