blob: bb8c3b82572e1d0ed3c5ed6260391323a442bf14 [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>
Tianjie Xucd8faf72019-08-06 12:32:05 -070033#include <filesystem>
Tao Bao5e535012017-03-16 17:37:38 -070034#include <functional>
Alex Deymo4344d632016-08-03 21:03:53 -070035#include <limits>
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -070036#include <mutex>
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -070037#include <thread>
Tao Bao71e3e092016-02-02 14:02:27 -080038#include <vector>
39
Tianjie Xue16e7992016-09-09 10:55:44 -070040#include <android-base/file.h>
41#include <android-base/logging.h>
Tao Bao20c581e2016-12-28 20:55:51 -080042#include <android-base/parsedouble.h>
Tianjie Xub0ddae52016-06-08 14:30:04 -070043#include <android-base/parseint.h>
Tao Baoefc35592017-01-08 22:45:47 -080044#include <android-base/properties.h>
Tianjie Xu16255832016-04-30 11:49:59 -070045#include <android-base/stringprintf.h>
46#include <android-base/strings.h>
Tao Baocf60a442018-06-18 14:56:20 -070047#include <android-base/unique_fd.h>
Tianjie Xu16255832016-04-30 11:49:59 -070048
Kelvin Zhang33c62fc2021-05-14 17:15:50 -040049#include "install/spl_check.h"
xunchang316e9712019-04-12 16:22:15 -070050#include "install/wipe_data.h"
Tao Bao1fc5bf32017-10-06 07:43:41 -070051#include "otautil/error_code.h"
Jacky Liu068329e2021-12-21 00:32:50 +080052#include "otautil/package.h"
Tao Bao641fa972018-04-25 18:59:40 -070053#include "otautil/paths.h"
Tao Bao17054c02018-05-03 22:41:23 -070054#include "otautil/sysutil.h"
Jacky Liu068329e2021-12-21 00:32:50 +080055#include "otautil/verifier.h"
xunchang24788852019-03-22 16:08:52 -070056#include "private/setup_commands.h"
Tianjie Xu8f397302018-08-20 13:40:47 -070057#include "recovery_ui/ui.h"
Tao Baoe3f09a72019-10-01 11:55:36 -070058#include "recovery_utils/roots.h"
59#include "recovery_utils/thermalutil.h"
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080060
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -070061using namespace std::chrono_literals;
62
xunchang24788852019-03-22 16:08:52 -070063static constexpr int kRecoveryApiVersion = 3;
Tianjie Xu164c60a2019-05-15 13:59:39 -070064// 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.
xunchang24788852019-03-22 16:08:52 -070066static_assert(kRecoveryApiVersion == RECOVERY_API_VERSION, "Mismatching recovery API versions.");
67
Doug Zongker74406302011-10-28 15:13:10 -070068// Default allocation of progress bar segments to operations
Tao Bao20c581e2016-12-28 20:55:51 -080069static constexpr int VERIFICATION_PROGRESS_TIME = 60;
70static constexpr float VERIFICATION_PROGRESS_FRACTION = 0.25;
Kelvin Zhange1ae78c2020-06-26 11:06:00 -040071// The charater used to separate dynamic fingerprints. e.x. sargo|aosp-sargo
72static const char* FINGERPRING_SEPARATOR = "|";
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -070073static std::condition_variable finish_log_temperature;
Kelvin Zhange1ae78c2020-06-26 11:06:00 -040074static bool isInStringList(const std::string& target_token, const std::string& str_list,
75 const std::string& deliminator);
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -070076
Tianjie Xu93b5bf22018-10-25 10:39:01 -070077bool ReadMetadataFromPackage(ZipArchiveHandle zip, std::map<std::string, std::string>* metadata) {
Tao Bao8a7afcc2017-04-18 22:05:50 -070078 CHECK(metadata != nullptr);
Tianjie Xub0ddae52016-06-08 14:30:04 -070079
Tao Bao8a7afcc2017-04-18 22:05:50 -070080 static constexpr const char* METADATA_PATH = "META-INF/com/android/metadata";
Kelvin Zhang4f811302020-09-16 14:06:12 -040081 ZipEntry64 entry;
Elliott Hughesa86dddb2019-05-03 22:52:37 -070082 if (FindEntry(zip, METADATA_PATH, &entry) != 0) {
Tao Bao8a7afcc2017-04-18 22:05:50 -070083 LOG(ERROR) << "Failed to find " << METADATA_PATH;
84 return false;
85 }
86
87 uint32_t length = entry.uncompressed_length;
Tianjie Xu93b5bf22018-10-25 10:39:01 -070088 std::string metadata_string(length, '\0');
89 int32_t err =
90 ExtractToMemory(zip, &entry, reinterpret_cast<uint8_t*>(&metadata_string[0]), length);
Tao Bao8a7afcc2017-04-18 22:05:50 -070091 if (err != 0) {
92 LOG(ERROR) << "Failed to extract " << METADATA_PATH << ": " << ErrorCodeString(err);
93 return false;
94 }
Tianjie Xu93b5bf22018-10-25 10:39:01 -070095
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
Tao Bao8a7afcc2017-04-18 22:05:50 -0700104 return true;
Yabin Cui6faf0262016-06-09 14:09:39 -0700105}
106
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700107// Gets the value for the given key in |metadata|. Returns an emtpy string if the key isn't
108// present.
109static 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
115static 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";
Tao Bao8a7afcc2017-04-18 22:05:50 -0700123 }
Tianjie Xub0ddae52016-06-08 14:30:04 -0700124}
125
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700126// Read the build.version.incremental of src/tgt from the metadata and log it to last_install.
127static 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
Tao Baocf60a442018-06-18 14:56:20 -0700145// incremental packages.
Tao Bao36c72762019-04-30 00:25:41 -0700146static bool CheckAbSpecificMetadata(const std::map<std::string, std::string>& metadata) {
Tao Baoefc35592017-01-08 22:45:47 -0800147 // Incremental updates should match the current build.
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700148 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;
Tao Bao36c72762019-04-30 00:25:41 -0700153 return false;
Tao Baoefc35592017-01-08 22:45:47 -0800154 }
Alex Deymo4344d632016-08-03 21:03:53 -0700155
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700156 auto device_fingerprint = android::base::GetProperty("ro.build.fingerprint", "");
157 auto pkg_pre_build_fingerprint = get_value(metadata, "pre-build");
Kelvin Zhange1ae78c2020-06-26 11:06:00 -0400158 if (!pkg_pre_build_fingerprint.empty() &&
159 !isInStringList(device_fingerprint, pkg_pre_build_fingerprint, FINGERPRING_SEPARATOR)) {
Tao Baoefc35592017-01-08 22:45:47 -0800160 LOG(ERROR) << "Package is for source build " << pkg_pre_build_fingerprint << " but expected "
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700161 << device_fingerprint;
Tao Bao36c72762019-04-30 00:25:41 -0700162 return false;
Tao Baoefc35592017-01-08 22:45:47 -0800163 }
Alex Deymo4344d632016-08-03 21:03:53 -0700164
Tao Baoefc35592017-01-08 22:45:47 -0800165 // 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.
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700171 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) ||
Tao Baoefc35592017-01-08 22:45:47 -0800174 pkg_post_timestamp < build_timestamp) {
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700175 if (get_value(metadata, "ota-downgrade") != "yes") {
Tao Baoefc35592017-01-08 22:45:47 -0800176 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.";
Tao Bao36c72762019-04-30 00:25:41 -0700180 return false;
Tao Baoefc35592017-01-08 22:45:47 -0800181 }
182 if (pkg_pre_build_fingerprint.empty()) {
183 LOG(ERROR) << "Downgrade package must have a pre-build version set, not allowed.";
Tao Bao36c72762019-04-30 00:25:41 -0700184 return false;
Tao Baoefc35592017-01-08 22:45:47 -0800185 }
186 }
187
Tao Bao36c72762019-04-30 00:25:41 -0700188 return true;
Alex Deymo4344d632016-08-03 21:03:53 -0700189}
190
Tao Bao36c72762019-04-30 00:25:41 -0700191bool CheckPackageMetadata(const std::map<std::string, std::string>& metadata, OtaType ota_type) {
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700192 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;
Tao Bao36c72762019-04-30 00:25:41 -0700196 return true;
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700197 }
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;
Tao Bao36c72762019-04-30 00:25:41 -0700202 return false;
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700203 }
204
205 auto device = android::base::GetProperty("ro.product.device", "");
206 auto pkg_device = get_value(metadata, "pre-device");
Kelvin Zhange1ae78c2020-06-26 11:06:00 -0400207 // device name can be a | separated list, so need to check
208 if (pkg_device.empty() || !isInStringList(device, pkg_device, FINGERPRING_SEPARATOR)) {
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700209 LOG(ERROR) << "Package is for product " << pkg_device << " but expected " << device;
Tao Bao36c72762019-04-30 00:25:41 -0700210 return false;
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700211 }
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;
Tao Bao36c72762019-04-30 00:25:41 -0700227 return false;
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700228 }
229 }
230
231 if (ota_type == OtaType::AB) {
232 return CheckAbSpecificMetadata(metadata);
233 }
234
Tao Bao36c72762019-04-30 00:25:41 -0700235 return true;
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700236}
237
Tao Bao36c72762019-04-30 00:25:41 -0700238bool SetUpAbUpdateCommands(const std::string& package, ZipArchiveHandle zip, int status_fd,
239 std::vector<std::string>* cmd) {
Tao Baobc4b1fe2017-04-17 16:46:05 -0700240 CHECK(cmd != nullptr);
Alex Deymo4344d632016-08-03 21:03:53 -0700241
Tao Baobc4b1fe2017-04-17 16:46:05 -0700242 // For A/B updates we extract the payload properties to a buffer and obtain the RAW payload offset
243 // in the zip file.
244 static constexpr const char* AB_OTA_PAYLOAD_PROPERTIES = "payload_properties.txt";
Kelvin Zhang4f811302020-09-16 14:06:12 -0400245 ZipEntry64 properties_entry;
Elliott Hughesa86dddb2019-05-03 22:52:37 -0700246 if (FindEntry(zip, AB_OTA_PAYLOAD_PROPERTIES, &properties_entry) != 0) {
Tao Baobc4b1fe2017-04-17 16:46:05 -0700247 LOG(ERROR) << "Failed to find " << AB_OTA_PAYLOAD_PROPERTIES;
Tao Bao36c72762019-04-30 00:25:41 -0700248 return false;
Tao Baobc4b1fe2017-04-17 16:46:05 -0700249 }
Kelvin Zhangd1ba38f2020-09-17 11:32:29 -0400250 auto properties_entry_length = properties_entry.uncompressed_length;
251 if (properties_entry_length > std::numeric_limits<size_t>::max()) {
252 LOG(ERROR) << "Failed to extract " << AB_OTA_PAYLOAD_PROPERTIES
253 << " because's uncompressed size exceeds size of address space. "
254 << properties_entry_length;
255 return false;
256 }
Tao Baobc4b1fe2017-04-17 16:46:05 -0700257 std::vector<uint8_t> payload_properties(properties_entry_length);
258 int32_t err =
259 ExtractToMemory(zip, &properties_entry, payload_properties.data(), properties_entry_length);
260 if (err != 0) {
261 LOG(ERROR) << "Failed to extract " << AB_OTA_PAYLOAD_PROPERTIES << ": " << ErrorCodeString(err);
Tao Bao36c72762019-04-30 00:25:41 -0700262 return false;
Tao Baobc4b1fe2017-04-17 16:46:05 -0700263 }
Alex Deymo4344d632016-08-03 21:03:53 -0700264
Tao Baobc4b1fe2017-04-17 16:46:05 -0700265 static constexpr const char* AB_OTA_PAYLOAD = "payload.bin";
Kelvin Zhang4f811302020-09-16 14:06:12 -0400266 ZipEntry64 payload_entry;
Elliott Hughesa86dddb2019-05-03 22:52:37 -0700267 if (FindEntry(zip, AB_OTA_PAYLOAD, &payload_entry) != 0) {
Tao Baobc4b1fe2017-04-17 16:46:05 -0700268 LOG(ERROR) << "Failed to find " << AB_OTA_PAYLOAD;
Tao Bao36c72762019-04-30 00:25:41 -0700269 return false;
Tao Baobc4b1fe2017-04-17 16:46:05 -0700270 }
271 long payload_offset = payload_entry.offset;
272 *cmd = {
Tao Bao2cc9bbb2018-08-14 12:34:46 -0700273 "/system/bin/update_engine_sideload",
Tao Bao00d57572017-05-02 15:48:54 -0700274 "--payload=file://" + package,
Tao Baobc4b1fe2017-04-17 16:46:05 -0700275 android::base::StringPrintf("--offset=%ld", payload_offset),
276 "--headers=" + std::string(payload_properties.begin(), payload_properties.end()),
277 android::base::StringPrintf("--status_fd=%d", status_fd),
278 };
Tao Bao36c72762019-04-30 00:25:41 -0700279 return true;
Alex Deymo4344d632016-08-03 21:03:53 -0700280}
281
Tao Bao36c72762019-04-30 00:25:41 -0700282bool SetUpNonAbUpdateCommands(const std::string& package, ZipArchiveHandle zip, int retry_count,
283 int status_fd, std::vector<std::string>* cmd) {
Tao Baobc4b1fe2017-04-17 16:46:05 -0700284 CHECK(cmd != nullptr);
Doug Zongkerb2ee9202009-06-04 10:24:53 -0700285
Tao Baocf60a442018-06-18 14:56:20 -0700286 // In non-A/B updates we extract the update binary from the package.
Tao Baobc4b1fe2017-04-17 16:46:05 -0700287 static constexpr const char* UPDATE_BINARY_NAME = "META-INF/com/google/android/update-binary";
Kelvin Zhang4f811302020-09-16 14:06:12 -0400288 ZipEntry64 binary_entry;
Elliott Hughesa86dddb2019-05-03 22:52:37 -0700289 if (FindEntry(zip, UPDATE_BINARY_NAME, &binary_entry) != 0) {
Tao Baobc4b1fe2017-04-17 16:46:05 -0700290 LOG(ERROR) << "Failed to find update binary " << UPDATE_BINARY_NAME;
Tao Bao36c72762019-04-30 00:25:41 -0700291 return false;
Tao Baobc4b1fe2017-04-17 16:46:05 -0700292 }
Doug Zongkerb2ee9202009-06-04 10:24:53 -0700293
Tao Baocf60a442018-06-18 14:56:20 -0700294 const std::string binary_path = Paths::Get().temporary_update_binary();
Tao Bao00d57572017-05-02 15:48:54 -0700295 unlink(binary_path.c_str());
Tao Baocf60a442018-06-18 14:56:20 -0700296 android::base::unique_fd fd(
297 open(binary_path.c_str(), O_CREAT | O_WRONLY | O_TRUNC | O_CLOEXEC, 0755));
Tao Baobc4b1fe2017-04-17 16:46:05 -0700298 if (fd == -1) {
Tao Bao00d57572017-05-02 15:48:54 -0700299 PLOG(ERROR) << "Failed to create " << binary_path;
Tao Bao36c72762019-04-30 00:25:41 -0700300 return false;
Tao Baobc4b1fe2017-04-17 16:46:05 -0700301 }
Doug Zongkerb2ee9202009-06-04 10:24:53 -0700302
Tao Bao36c72762019-04-30 00:25:41 -0700303 if (auto error = ExtractEntryToFile(zip, &binary_entry, fd); error != 0) {
Tao Baobc4b1fe2017-04-17 16:46:05 -0700304 LOG(ERROR) << "Failed to extract " << UPDATE_BINARY_NAME << ": " << ErrorCodeString(error);
Tao Bao36c72762019-04-30 00:25:41 -0700305 return false;
Tao Baobc4b1fe2017-04-17 16:46:05 -0700306 }
307
Tao Bao6fcd2082019-01-16 09:29:17 -0800308 // When executing the update binary contained in the package, the arguments passed are:
309 // - the version number for this interface
310 // - an FD to which the program can write in order to update the progress bar.
311 // - the name of the package zip file.
312 // - an optional argument "retry" if this update is a retry of a failed update attempt.
Tao Baobc4b1fe2017-04-17 16:46:05 -0700313 *cmd = {
Tao Bao00d57572017-05-02 15:48:54 -0700314 binary_path,
Tao Baobd0ddcd2017-05-04 13:03:18 -0700315 std::to_string(kRecoveryApiVersion),
Tao Baobc4b1fe2017-04-17 16:46:05 -0700316 std::to_string(status_fd),
Tao Bao00d57572017-05-02 15:48:54 -0700317 package,
Tao Baobc4b1fe2017-04-17 16:46:05 -0700318 };
319 if (retry_count > 0) {
320 cmd->push_back("retry");
321 }
Tao Bao36c72762019-04-30 00:25:41 -0700322 return true;
Alex Deymo4344d632016-08-03 21:03:53 -0700323}
Alex Deymo4344d632016-08-03 21:03:53 -0700324
Tianjie Xu37957102017-06-07 17:59:55 -0700325static void log_max_temperature(int* max_temperature, const std::atomic<bool>& logger_finished) {
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -0700326 CHECK(max_temperature != nullptr);
327 std::mutex mtx;
328 std::unique_lock<std::mutex> lck(mtx);
Tianjie Xu37957102017-06-07 17:59:55 -0700329 while (!logger_finished.load() &&
330 finish_log_temperature.wait_for(lck, 20s) == std::cv_status::timeout) {
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -0700331 *max_temperature = std::max(*max_temperature, GetMaxValueFromThermalZone());
332 }
333}
334
Alex Deymo4344d632016-08-03 21:03:53 -0700335// If the package contains an update binary, extract it and run it.
Tianjie Xu980f92e2019-06-11 15:43:43 -0700336static InstallResult TryUpdateBinary(Package* package, bool* wipe_cache,
337 std::vector<std::string>* log_buffer, int retry_count,
338 int* max_temperature, RecoveryUI* ui) {
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700339 std::map<std::string, std::string> metadata;
Tianjie Xu980f92e2019-06-11 15:43:43 -0700340 auto zip = package->GetZipArchiveHandle();
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700341 if (!ReadMetadataFromPackage(zip, &metadata)) {
342 LOG(ERROR) << "Failed to parse metadata in the zip file";
343 return INSTALL_CORRUPT;
344 }
345
Yifan Hongf2af5622020-04-27 20:16:18 -0700346 bool package_is_ab = get_value(metadata, "ota-type") == OtaTypeToString(OtaType::AB);
347 bool device_supports_ab = android::base::GetBoolProperty("ro.build.ab_update", false);
348 bool ab_device_supports_nonab =
349 android::base::GetBoolProperty("ro.virtual_ab.allow_non_ab", false);
350 bool device_only_supports_ab = device_supports_ab && !ab_device_supports_nonab;
351
Kelvin Zhang33c62fc2021-05-14 17:15:50 -0400352 const auto current_spl = android::base::GetProperty("ro.build.version.security_patch", "");
353 if (ViolatesSPLDowngrade(zip, current_spl)) {
354 LOG(ERROR) << "Denying OTA because it's SPL downgrade";
355 return INSTALL_ERROR;
356 }
357
Yifan Hongf2af5622020-04-27 20:16:18 -0700358 if (package_is_ab) {
Tianjie Xu980f92e2019-06-11 15:43:43 -0700359 CHECK(package->GetType() == PackageType::kFile);
360 }
361
Yifan Hongf2af5622020-04-27 20:16:18 -0700362 // Verify against the metadata in the package first. Expects A/B metadata if:
363 // Package declares itself as an A/B package
364 // Package does not declare itself as an A/B package, but device only supports A/B;
365 // still calls CheckPackageMetadata to get a meaningful error message.
366 if (package_is_ab || device_only_supports_ab) {
367 if (!CheckPackageMetadata(metadata, OtaType::AB)) {
368 log_buffer->push_back(android::base::StringPrintf("error: %d", kUpdateBinaryCommandFailure));
369 return INSTALL_ERROR;
370 }
Tianjie Xu93b5bf22018-10-25 10:39:01 -0700371 }
372
373 ReadSourceTargetBuild(metadata, log_buffer);
Alex Deymo4344d632016-08-03 21:03:53 -0700374
Tao Bao6fcd2082019-01-16 09:29:17 -0800375 // The updater in child process writes to the pipe to communicate with recovery.
376 android::base::unique_fd pipe_read, pipe_write;
Bill Peckham08ba1ad2019-03-28 18:42:13 -0700377 // Explicitly disable O_CLOEXEC using 0 as the flags (last) parameter to Pipe
378 // so that the child updater process will recieve a non-closed fd.
379 if (!android::base::Pipe(&pipe_read, &pipe_write, 0)) {
Tao Bao6fcd2082019-01-16 09:29:17 -0800380 PLOG(ERROR) << "Failed to create pipe for updater-recovery communication";
381 return INSTALL_CORRUPT;
382 }
383
384 // The updater-recovery communication protocol.
385 //
386 // progress <frac> <secs>
387 // fill up the next <frac> part of of the progress bar over <secs> seconds. If <secs> is
388 // zero, use `set_progress` commands to manually control the progress of this segment of the
389 // bar.
390 //
391 // set_progress <frac>
392 // <frac> should be between 0.0 and 1.0; sets the progress bar within the segment defined by
393 // the most recent progress command.
394 //
395 // ui_print <string>
396 // display <string> on the screen.
397 //
398 // wipe_cache
399 // a wipe of cache will be performed following a successful installation.
400 //
401 // clear_display
402 // turn off the text display.
403 //
404 // enable_reboot
405 // packages can explicitly request that they want the user to be able to reboot during
406 // installation (useful for debugging packages that don't exit).
407 //
408 // retry_update
409 // updater encounters some issue during the update. It requests a reboot to retry the same
410 // package automatically.
411 //
412 // log <string>
413 // updater requests logging the string (e.g. cause of the failure).
414 //
415
Tianjie Xu980f92e2019-06-11 15:43:43 -0700416 std::string package_path = package->GetPath();
417
Tao Bao20c581e2016-12-28 20:55:51 -0800418 std::vector<std::string> args;
Tao Bao36c72762019-04-30 00:25:41 -0700419 if (auto setup_result =
Yifan Hongf2af5622020-04-27 20:16:18 -0700420 package_is_ab
421 ? SetUpAbUpdateCommands(package_path, zip, pipe_write.get(), &args)
422 : SetUpNonAbUpdateCommands(package_path, zip, retry_count, pipe_write.get(), &args);
Tao Bao36c72762019-04-30 00:25:41 -0700423 !setup_result) {
Tianjie Xu3fec8c62017-08-23 00:18:07 -0700424 log_buffer->push_back(android::base::StringPrintf("error: %d", kUpdateBinaryCommandFailure));
Tao Bao36c72762019-04-30 00:25:41 -0700425 return INSTALL_CORRUPT;
Tao Bao20c581e2016-12-28 20:55:51 -0800426 }
Doug Zongkerb2ee9202009-06-04 10:24:53 -0700427
Tao Bao20c581e2016-12-28 20:55:51 -0800428 pid_t pid = fork();
Tao Bao20c581e2016-12-28 20:55:51 -0800429 if (pid == -1) {
Tao Bao20c581e2016-12-28 20:55:51 -0800430 PLOG(ERROR) << "Failed to fork update binary";
Tianjie Xu3fec8c62017-08-23 00:18:07 -0700431 log_buffer->push_back(android::base::StringPrintf("error: %d", kForkUpdateBinaryFailure));
Tao Bao20c581e2016-12-28 20:55:51 -0800432 return INSTALL_ERROR;
433 }
434
435 if (pid == 0) {
436 umask(022);
Tao Bao6fcd2082019-01-16 09:29:17 -0800437 pipe_read.reset();
438
439 // Convert the std::string vector to a NULL-terminated char* vector suitable for execv.
440 auto chr_args = StringVectorToNullTerminatedArray(args);
Tao Bao3d69f0d2018-12-20 09:44:06 -0800441 execv(chr_args[0], chr_args.data());
Tao Bao6fcd2082019-01-16 09:29:17 -0800442 // We shouldn't use LOG/PLOG in the forked process, since they may cause the child process to
443 // hang. This deadlock results from an improperly copied mutex in the ui functions.
444 // (Bug: 34769056)
Tianjie Xuab1abae2017-01-30 16:48:52 -0800445 fprintf(stdout, "E:Can't run %s (%s)\n", chr_args[0], strerror(errno));
Tao Bao3da88012017-02-03 13:09:23 -0800446 _exit(EXIT_FAILURE);
Tao Bao20c581e2016-12-28 20:55:51 -0800447 }
Tao Bao6fcd2082019-01-16 09:29:17 -0800448 pipe_write.reset();
Tao Bao20c581e2016-12-28 20:55:51 -0800449
Tianjie Xu37957102017-06-07 17:59:55 -0700450 std::atomic<bool> logger_finished(false);
451 std::thread temperature_logger(log_max_temperature, max_temperature, std::ref(logger_finished));
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -0700452
Tao Bao20c581e2016-12-28 20:55:51 -0800453 *wipe_cache = false;
454 bool retry_update = false;
455
456 char buffer[1024];
Tao Bao6fcd2082019-01-16 09:29:17 -0800457 FILE* from_child = android::base::Fdopen(std::move(pipe_read), "r");
Tao Bao20c581e2016-12-28 20:55:51 -0800458 while (fgets(buffer, sizeof(buffer), from_child) != nullptr) {
459 std::string line(buffer);
460 size_t space = line.find_first_of(" \n");
461 std::string command(line.substr(0, space));
462 if (command.empty()) continue;
463
464 // Get rid of the leading and trailing space and/or newline.
465 std::string args = space == std::string::npos ? "" : android::base::Trim(line.substr(space));
466
467 if (command == "progress") {
468 std::vector<std::string> tokens = android::base::Split(args, " ");
469 double fraction;
470 int seconds;
471 if (tokens.size() == 2 && android::base::ParseDouble(tokens[0].c_str(), &fraction) &&
472 android::base::ParseInt(tokens[1], &seconds)) {
473 ui->ShowProgress(fraction * (1 - VERIFICATION_PROGRESS_FRACTION), seconds);
474 } else {
475 LOG(ERROR) << "invalid \"progress\" parameters: " << line;
476 }
477 } else if (command == "set_progress") {
478 std::vector<std::string> tokens = android::base::Split(args, " ");
479 double fraction;
480 if (tokens.size() == 1 && android::base::ParseDouble(tokens[0].c_str(), &fraction)) {
481 ui->SetProgress(fraction);
482 } else {
483 LOG(ERROR) << "invalid \"set_progress\" parameters: " << line;
484 }
485 } else if (command == "ui_print") {
Tao Baof0136422017-01-21 13:03:25 -0800486 ui->PrintOnScreenOnly("%s\n", args.c_str());
Tao Bao20c581e2016-12-28 20:55:51 -0800487 fflush(stdout);
488 } else if (command == "wipe_cache") {
489 *wipe_cache = true;
490 } else if (command == "clear_display") {
491 ui->SetBackground(RecoveryUI::NONE);
492 } else if (command == "enable_reboot") {
493 // packages can explicitly request that they want the user
494 // to be able to reboot during installation (useful for
495 // debugging packages that don't exit).
496 ui->SetEnableReboot(true);
497 } else if (command == "retry_update") {
498 retry_update = true;
499 } else if (command == "log") {
500 if (!args.empty()) {
501 // Save the logging request from updater and write to last_install later.
Tao Bao29ee69b2017-05-01 12:23:17 -0700502 log_buffer->push_back(args);
Tao Bao20c581e2016-12-28 20:55:51 -0800503 } else {
504 LOG(ERROR) << "invalid \"log\" parameters: " << line;
505 }
506 } else {
507 LOG(ERROR) << "unknown command [" << command << "]";
Doug Zongkerb2ee9202009-06-04 10:24:53 -0700508 }
Tao Bao20c581e2016-12-28 20:55:51 -0800509 }
510 fclose(from_child);
Doug Zongkerb2ee9202009-06-04 10:24:53 -0700511
Tao Bao20c581e2016-12-28 20:55:51 -0800512 int status;
513 waitpid(pid, &status, 0);
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -0700514
Tianjie Xu37957102017-06-07 17:59:55 -0700515 logger_finished.store(true);
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -0700516 finish_log_temperature.notify_one();
517 temperature_logger.join();
518
Tao Bao20c581e2016-12-28 20:55:51 -0800519 if (retry_update) {
520 return INSTALL_RETRY;
521 }
Tao Baoe7b775c2018-11-07 15:13:30 -0800522 if (WIFEXITED(status)) {
523 if (WEXITSTATUS(status) != EXIT_SUCCESS) {
Tianjie Xu980f92e2019-06-11 15:43:43 -0700524 LOG(ERROR) << "Error in " << package_path << " (status " << WEXITSTATUS(status) << ")";
Tao Baoe7b775c2018-11-07 15:13:30 -0800525 return INSTALL_ERROR;
526 }
527 } else if (WIFSIGNALED(status)) {
Tianjie Xu980f92e2019-06-11 15:43:43 -0700528 LOG(ERROR) << "Error in " << package_path << " (killed by signal " << WTERMSIG(status) << ")";
Tao Bao20c581e2016-12-28 20:55:51 -0800529 return INSTALL_ERROR;
Tao Baoe7b775c2018-11-07 15:13:30 -0800530 } else {
531 LOG(FATAL) << "Invalid status code " << status;
Tao Bao20c581e2016-12-28 20:55:51 -0800532 }
Doug Zongkerb2ee9202009-06-04 10:24:53 -0700533
Tao Bao20c581e2016-12-28 20:55:51 -0800534 return INSTALL_SUCCESS;
Doug Zongkerb2ee9202009-06-04 10:24:53 -0700535}
536
Tianjie Xu980f92e2019-06-11 15:43:43 -0700537static InstallResult VerifyAndInstallPackage(Package* package, bool* wipe_cache,
538 std::vector<std::string>* log_buffer, int retry_count,
539 int* max_temperature, RecoveryUI* ui) {
Tao Bao29ee69b2017-05-01 12:23:17 -0700540 ui->SetBackground(RecoveryUI::INSTALLING_UPDATE);
Tao Bao29ee69b2017-05-01 12:23:17 -0700541 // Give verification half the progress bar...
542 ui->SetProgressType(RecoveryUI::DETERMINATE);
543 ui->ShowProgress(VERIFICATION_PROGRESS_FRACTION, VERIFICATION_PROGRESS_TIME);
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800544
Tao Bao29ee69b2017-05-01 12:23:17 -0700545 // Verify package.
Tianjie Xu980f92e2019-06-11 15:43:43 -0700546 if (!verify_package(package, ui)) {
Tao Bao29ee69b2017-05-01 12:23:17 -0700547 log_buffer->push_back(android::base::StringPrintf("error: %d", kZipVerificationFailure));
Tao Bao29ee69b2017-05-01 12:23:17 -0700548 return INSTALL_CORRUPT;
549 }
Doug Zongker60151a22009-08-12 18:30:03 -0700550
Tao Bao29ee69b2017-05-01 12:23:17 -0700551 // Verify and install the contents of the package.
552 ui->Print("Installing update...\n");
553 if (retry_count > 0) {
554 ui->Print("Retry attempt: %d\n", retry_count);
555 }
556 ui->SetEnableReboot(false);
Tianjie Xu980f92e2019-06-11 15:43:43 -0700557 auto result = TryUpdateBinary(package, wipe_cache, log_buffer, retry_count, max_temperature, ui);
Tao Bao29ee69b2017-05-01 12:23:17 -0700558 ui->SetEnableReboot(true);
559 ui->Print("\n");
560
Tao Bao29ee69b2017-05-01 12:23:17 -0700561 return result;
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800562}
Doug Zongker469243e2011-04-12 09:28:10 -0700563
Tianjie Xu980f92e2019-06-11 15:43:43 -0700564InstallResult InstallPackage(Package* package, const std::string_view package_id,
565 bool should_wipe_cache, int retry_count, RecoveryUI* ui) {
Tao Baof8119fb2017-04-18 21:35:12 -0700566 auto start = std::chrono::system_clock::now();
Tao Bao682c34b2015-04-07 17:16:35 -0700567
Tao Baof8119fb2017-04-18 21:35:12 -0700568 int start_temperature = GetMaxValueFromThermalZone();
569 int max_temperature = start_temperature;
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -0700570
Tao Baoadc99ef2019-04-29 23:48:02 -0700571 InstallResult result;
Tao Baof8119fb2017-04-18 21:35:12 -0700572 std::vector<std::string> log_buffer;
Tianjie Xu980f92e2019-06-11 15:43:43 -0700573
Tianjie Xu164c60a2019-05-15 13:59:39 -0700574 ui->Print("Supported API: %d\n", kRecoveryApiVersion);
575
Tianjie Xu980f92e2019-06-11 15:43:43 -0700576 ui->Print("Finding update package...\n");
577 LOG(INFO) << "Update package id: " << package_id;
578 if (!package) {
579 log_buffer.push_back(android::base::StringPrintf("error: %d", kMapFileFailure));
580 result = INSTALL_CORRUPT;
581 } else if (setup_install_mounts() != 0) {
Tao Baof8119fb2017-04-18 21:35:12 -0700582 LOG(ERROR) << "failed to set up expected mounts for install; aborting";
583 result = INSTALL_ERROR;
584 } else {
xunchang316e9712019-04-12 16:22:15 -0700585 bool updater_wipe_cache = false;
Tianjie Xu980f92e2019-06-11 15:43:43 -0700586 result = VerifyAndInstallPackage(package, &updater_wipe_cache, &log_buffer, retry_count,
587 &max_temperature, ui);
xunchang316e9712019-04-12 16:22:15 -0700588 should_wipe_cache = should_wipe_cache || updater_wipe_cache;
Tao Baof8119fb2017-04-18 21:35:12 -0700589 }
590
591 // Measure the time spent to apply OTA update in seconds.
592 std::chrono::duration<double> duration = std::chrono::system_clock::now() - start;
593 int time_total = static_cast<int>(duration.count());
594
Tao Bao3e18f2b2017-09-29 17:11:13 -0700595 bool has_cache = volume_for_mount_point("/cache") != nullptr;
Tao Baof8119fb2017-04-18 21:35:12 -0700596 // Skip logging the uncrypt_status on devices without /cache.
597 if (has_cache) {
598 static constexpr const char* UNCRYPT_STATUS = "/cache/recovery/uncrypt_status";
599 if (ensure_path_mounted(UNCRYPT_STATUS) != 0) {
600 LOG(WARNING) << "Can't mount " << UNCRYPT_STATUS;
Doug Zongker239ac6a2013-08-20 16:03:25 -0700601 } else {
Tao Baof8119fb2017-04-18 21:35:12 -0700602 std::string uncrypt_status;
603 if (!android::base::ReadFileToString(UNCRYPT_STATUS, &uncrypt_status)) {
604 PLOG(WARNING) << "failed to read uncrypt status";
605 } else if (!android::base::StartsWith(uncrypt_status, "uncrypt_")) {
606 LOG(WARNING) << "corrupted uncrypt_status: " << uncrypt_status;
Tianjie Xua2867782017-03-24 14:13:56 -0700607 } else {
Tao Baof8119fb2017-04-18 21:35:12 -0700608 log_buffer.push_back(android::base::Trim(uncrypt_status));
Tianjie Xua2867782017-03-24 14:13:56 -0700609 }
Doug Zongker469243e2011-04-12 09:28:10 -0700610 }
Tao Baof8119fb2017-04-18 21:35:12 -0700611 }
Tao Baobadaac42016-09-26 11:39:14 -0700612
Tao Baof8119fb2017-04-18 21:35:12 -0700613 // The first two lines need to be the package name and install result.
614 std::vector<std::string> log_header = {
Tianjie Xu980f92e2019-06-11 15:43:43 -0700615 std::string(package_id),
Tao Baof8119fb2017-04-18 21:35:12 -0700616 result == INSTALL_SUCCESS ? "1" : "0",
617 "time_total: " + std::to_string(time_total),
618 "retry: " + std::to_string(retry_count),
619 };
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -0700620
Tao Baof8119fb2017-04-18 21:35:12 -0700621 int end_temperature = GetMaxValueFromThermalZone();
622 max_temperature = std::max(end_temperature, max_temperature);
623 if (start_temperature > 0) {
624 log_buffer.push_back("temperature_start: " + std::to_string(start_temperature));
625 }
626 if (end_temperature > 0) {
627 log_buffer.push_back("temperature_end: " + std::to_string(end_temperature));
628 }
629 if (max_temperature > 0) {
630 log_buffer.push_back("temperature_max: " + std::to_string(max_temperature));
631 }
Tianjie Xu3ee2b9d2017-03-27 14:12:26 -0700632
Tao Baof8119fb2017-04-18 21:35:12 -0700633 std::string log_content =
634 android::base::Join(log_header, "\n") + "\n" + android::base::Join(log_buffer, "\n") + "\n";
Tao Bao641fa972018-04-25 18:59:40 -0700635 const std::string& install_file = Paths::Get().temporary_install_file();
Tao Baof8119fb2017-04-18 21:35:12 -0700636 if (!android::base::WriteStringToFile(log_content, install_file)) {
637 PLOG(ERROR) << "failed to write " << install_file;
638 }
Tao Baobadaac42016-09-26 11:39:14 -0700639
Tao Baof8119fb2017-04-18 21:35:12 -0700640 // Write a copy into last_log.
641 LOG(INFO) << log_content;
Tao Baobadaac42016-09-26 11:39:14 -0700642
xunchang316e9712019-04-12 16:22:15 -0700643 if (result == INSTALL_SUCCESS && should_wipe_cache) {
644 if (!WipeCache(ui, nullptr)) {
645 result = INSTALL_ERROR;
646 }
647 }
648
Tao Baof8119fb2017-04-18 21:35:12 -0700649 return result;
Doug Zongker469243e2011-04-12 09:28:10 -0700650}
Yabin Cui6faf0262016-06-09 14:09:39 -0700651
xunchang24788852019-03-22 16:08:52 -0700652bool verify_package(Package* package, RecoveryUI* ui) {
Tianjie Xue1d02fb2018-10-19 15:52:17 -0700653 static constexpr const char* CERTIFICATE_ZIP_FILE = "/system/etc/security/otacerts.zip";
654 std::vector<Certificate> loaded_keys = LoadKeysFromZipfile(CERTIFICATE_ZIP_FILE);
655 if (loaded_keys.empty()) {
Tao Bao5e535012017-03-16 17:37:38 -0700656 LOG(ERROR) << "Failed to load keys";
657 return false;
658 }
Tianjie Xue1d02fb2018-10-19 15:52:17 -0700659 LOG(INFO) << loaded_keys.size() << " key(s) loaded from " << CERTIFICATE_ZIP_FILE;
Yabin Cui6faf0262016-06-09 14:09:39 -0700660
Tao Bao5e535012017-03-16 17:37:38 -0700661 // Verify package.
662 ui->Print("Verifying update package...\n");
663 auto t0 = std::chrono::system_clock::now();
xunchangf07ed2e2019-02-25 14:14:01 -0800664 int err = verify_file(package, loaded_keys);
Tao Bao5e535012017-03-16 17:37:38 -0700665 std::chrono::duration<double> duration = std::chrono::system_clock::now() - t0;
666 ui->Print("Update package verification took %.1f s (result %d).\n", duration.count(), err);
667 if (err != VERIFY_SUCCESS) {
668 LOG(ERROR) << "Signature verification failed";
669 LOG(ERROR) << "error: " << kZipVerificationFailure;
670 return false;
671 }
672 return true;
Yabin Cui6faf0262016-06-09 14:09:39 -0700673}
Tianjie Xucd8faf72019-08-06 12:32:05 -0700674
675bool SetupPackageMount(const std::string& package_path, bool* should_use_fuse) {
676 CHECK(should_use_fuse != nullptr);
677
678 if (package_path.empty()) {
679 return false;
680 }
681
682 *should_use_fuse = true;
683 if (package_path[0] == '@') {
684 auto block_map_path = package_path.substr(1);
685 if (ensure_path_mounted(block_map_path) != 0) {
686 LOG(ERROR) << "Failed to mount " << block_map_path;
687 return false;
688 }
689 // uncrypt only produces block map only if the package stays on /data.
690 *should_use_fuse = false;
691 return true;
692 }
693
694 // Package is not a block map file.
695 if (ensure_path_mounted(package_path) != 0) {
696 LOG(ERROR) << "Failed to mount " << package_path;
697 return false;
698 }
699
700 // Reject the package if the input path doesn't equal the canonicalized path.
701 // e.g. /cache/../sdcard/update_package.
702 std::error_code ec;
703 auto canonical_path = std::filesystem::canonical(package_path, ec);
704 if (ec) {
705 LOG(ERROR) << "Failed to get canonical of " << package_path << ", " << ec.message();
706 return false;
707 }
708 if (canonical_path.string() != package_path) {
709 LOG(ERROR) << "Installation aborts. The canonical path " << canonical_path.string()
710 << " doesn't equal the original path " << package_path;
711 return false;
712 }
713
714 constexpr const char* CACHE_ROOT = "/cache";
715 if (android::base::StartsWith(package_path, CACHE_ROOT)) {
716 *should_use_fuse = false;
717 }
718 return true;
719}
Kelvin Zhange1ae78c2020-06-26 11:06:00 -0400720
721// Check if `target_token` is in string `str_list`, where `str_list` is expected to be a
722// list delimited by `deliminator`
723// E.X. isInStringList("a", "a|b|c|d", "|") => true
724// E.X. isInStringList("abc", "abc", "|") => true
725static bool isInStringList(const std::string& target_token, const std::string& str_list,
726 const std::string& deliminator) {
727 if (target_token.length() > str_list.length()) {
728 return false;
729 } else if (target_token.length() == str_list.length() || deliminator.length() == 0) {
730 return target_token == str_list;
731 }
732 auto&& list = android::base::Split(str_list, deliminator);
733 return std::find(list.begin(), list.end(), target_token) != list.end();
734}