blob: dbbac7a7db1c68b531dd1155c9611aa69dfc7e05 [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
17#include <ctype.h>
Doug Zongker7c3ae452013-05-14 11:03:02 -070018#include <dirent.h>
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080019#include <errno.h>
20#include <fcntl.h>
21#include <getopt.h>
Tao Bao862a4c12016-06-02 11:16:50 -070022#include <inttypes.h>
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080023#include <limits.h>
Tao Bao862a4c12016-06-02 11:16:50 -070024#include <linux/fs.h>
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080025#include <linux/input.h>
Doug Zongker7c3ae452013-05-14 11:03:02 -070026#include <stdarg.h>
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080027#include <stdio.h>
28#include <stdlib.h>
29#include <string.h>
Patrick Tjincd055ee2014-12-09 11:26:40 -080030#include <sys/klog.h>
Doug Zongker23ceeea2010-07-08 17:27:55 -070031#include <sys/stat.h>
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080032#include <sys/types.h>
Tao Baocdcf28f2016-01-13 15:05:20 -080033#include <sys/wait.h>
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080034#include <time.h>
35#include <unistd.h>
36
Tao Baoc4a18ef2017-02-10 00:13:30 -080037#include <algorithm>
Tao Bao04ca4262015-09-10 15:32:24 -070038#include <chrono>
Tao Baoc4a18ef2017-02-10 00:13:30 -080039#include <memory>
Tao Bao862a4c12016-06-02 11:16:50 -070040#include <string>
41#include <vector>
Tao Bao04ca4262015-09-10 15:32:24 -070042
Elliott Hughes4b166f02015-12-04 15:30:20 -080043#include <android-base/file.h>
Tianjie Xu7b0ad9c2016-08-05 18:00:04 -070044#include <android-base/logging.h>
Tianjie Xu3c62b672016-02-05 18:25:58 -080045#include <android-base/parseint.h>
Elliott Hughescb220402016-09-23 15:30:55 -070046#include <android-base/properties.h>
Elliott Hughes4b166f02015-12-04 15:30:20 -080047#include <android-base/stringprintf.h>
Tao Bao862a4c12016-06-02 11:16:50 -070048#include <android-base/strings.h>
49#include <android-base/unique_fd.h>
Yabin Cui8b309f62016-06-24 18:22:02 -070050#include <bootloader_message/bootloader_message.h>
Tao Bao75238632015-05-27 14:46:17 -070051#include <cutils/android_reboot.h>
Elliott Hughescb220402016-09-23 15:30:55 -070052#include <cutils/properties.h> /* for property_list */
Elliott Hughes4bbd5bf2016-04-01 18:24:39 -070053#include <healthd/BatteryMonitor.h>
Mark Salyzyna4f701a2016-03-09 14:58:16 -080054#include <private/android_logger.h> /* private pmsg functions */
Tao Baoe1905ad2017-03-22 14:57:04 -070055#include <private/android_filesystem_config.h> /* for AID_SYSTEM */
Jeff Vander Stoepe35926e2017-06-14 15:30:39 -070056#include <selinux/android.h>
Elliott Hughes4bbd5bf2016-04-01 18:24:39 -070057#include <selinux/label.h>
58#include <selinux/selinux.h>
Tianjie Xu8cf5c8f2016-09-08 20:10:11 -070059#include <ziparchive/zip_archive.h>
Yabin Cui99281df2016-02-17 12:21:52 -080060
Tao Bao75238632015-05-27 14:46:17 -070061#include "adb_install.h"
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080062#include "common.h"
Tao Bao75238632015-05-27 14:46:17 -070063#include "device.h"
64#include "fuse_sdcard_provider.h"
65#include "fuse_sideload.h"
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080066#include "install.h"
Josh Gaoacb2a2f2016-08-26 18:24:34 -070067#include "minadbd/minadbd.h"
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080068#include "minui/minui.h"
Tianjie Xu8cf5c8f2016-09-08 20:10:11 -070069#include "otautil/DirUtil.h"
Tao Bao1fc5bf32017-10-06 07:43:41 -070070#include "otautil/error_code.h"
Tao Bao641fa972018-04-25 18:59:40 -070071#include "otautil/paths.h"
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080072#include "roots.h"
Tianjie Xue113e4d2016-10-21 17:46:13 -070073#include "rotate_logs.h"
Doug Zongker211aebc2011-10-28 15:13:10 -070074#include "screen_ui.h"
Sen Jiangd5304492016-12-09 16:20:49 -080075#include "stub_ui.h"
Tianjie Xue113e4d2016-10-21 17:46:13 -070076#include "ui.h"
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080077
78static const struct option OPTIONS[] = {
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080079 { "update_package", required_argument, NULL, 'u' },
Tianjie Xu3c62b672016-02-05 18:25:58 -080080 { "retry_count", required_argument, NULL, 'n' },
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080081 { "wipe_data", no_argument, NULL, 'w' },
82 { "wipe_cache", no_argument, NULL, 'c' },
Doug Zongker4bc98062010-09-03 11:00:13 -070083 { "show_text", no_argument, NULL, 't' },
Tao Baoc679f932015-03-30 09:43:49 -070084 { "sideload", no_argument, NULL, 's' },
85 { "sideload_auto_reboot", no_argument, NULL, 'a' },
Doug Zongkere5d5ac72012-04-12 11:01:22 -070086 { "just_exit", no_argument, NULL, 'x' },
Doug Zongker02ec6b82012-08-22 17:26:40 -070087 { "locale", required_argument, NULL, 'l' },
Doug Zongkerb1d12632014-03-18 10:32:12 -070088 { "shutdown_after", no_argument, NULL, 'p' },
Jeff Sharkeya6e13ae2014-09-24 11:46:17 -070089 { "reason", required_argument, NULL, 'r' },
Tianjie Xu35926c42016-04-28 18:06:26 -070090 { "security", no_argument, NULL, 'e'},
Yabin Cui8b309f62016-06-24 18:22:02 -070091 { "wipe_ab", no_argument, NULL, 0 },
Yabin Cuifd99a312016-06-09 14:09:39 -070092 { "wipe_package_size", required_argument, NULL, 0 },
Paul Crowley08404b42016-12-19 13:04:23 -080093 { "prompt_and_wipe_data", no_argument, NULL, 0 },
Doug Zongker988500b2009-10-06 14:41:38 -070094 { NULL, 0, NULL, 0 },
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -080095};
96
Tianjie Xu06e57ac2016-07-11 14:04:08 -070097// More bootreasons can be found in "system/core/bootstat/bootstat.cpp".
98static const std::vector<std::string> bootreason_blacklist {
99 "kernel_panic",
100 "Panic",
101};
102
Doug Zongker6d0d7ac2013-07-09 13:34:55 -0700103static const char *CACHE_LOG_DIR = "/cache/recovery";
Doug Zongkerd4208f92010-09-20 12:16:13 -0700104static const char *COMMAND_FILE = "/cache/recovery/command";
Doug Zongkerd4208f92010-09-20 12:16:13 -0700105static const char *LOG_FILE = "/cache/recovery/log";
Doug Zongkerd0181b82011-10-19 10:51:12 -0700106static const char *LAST_INSTALL_FILE = "/cache/recovery/last_install";
Doug Zongker8b240cc2012-08-29 15:19:29 -0700107static const char *LOCALE_FILE = "/cache/recovery/last_locale";
Paul Lawrence661f8a62016-02-25 12:42:19 -0800108static const char *CONVERT_FBE_DIR = "/tmp/convert_fbe";
109static const char *CONVERT_FBE_FILE = "/tmp/convert_fbe/convert_fbe";
Michael Ward9d2629c2011-06-23 22:14:24 -0700110static const char *CACHE_ROOT = "/cache";
Paul Lawrenced0db3372015-11-05 13:38:40 -0800111static const char *DATA_ROOT = "/data";
Paul Crowley3b4d5162016-06-08 13:51:41 -0700112static const char* METADATA_ROOT = "/metadata";
Doug Zongkerd4208f92010-09-20 12:16:13 -0700113static const char *SDCARD_ROOT = "/sdcard";
Tao Baof0124322015-04-11 02:04:11 +0000114static const char *LAST_KMSG_FILE = "/cache/recovery/last_kmsg";
Tao Baobef39712015-05-04 18:50:27 -0700115static const char *LAST_LOG_FILE = "/cache/recovery/last_log";
Tianjie Xu69575552017-05-16 15:51:46 -0700116// We will try to apply the update package 5 times at most in case of an I/O error or
117// bspatch | imgpatch error.
118static const int RETRY_LIMIT = 4;
Yabin Cui99281df2016-02-17 12:21:52 -0800119static const int BATTERY_READ_TIMEOUT_IN_SEC = 10;
120// GmsCore enters recovery mode to install package when having enough battery
121// percentage. Normally, the threshold is 40% without charger and 20% with charger.
122// So we should check battery with a slightly lower limitation.
123static const int BATTERY_OK_PERCENTAGE = 20;
124static const int BATTERY_WITH_CHARGER_OK_PERCENTAGE = 15;
Tao Baoac9d94d2016-11-03 11:37:15 -0700125static constexpr const char* RECOVERY_WIPE = "/etc/recovery.wipe";
Tianjie Xu2078b222017-03-22 12:27:26 -0700126static constexpr const char* DEFAULT_LOCALE = "en-US";
Nick Kralevicha9ad0322014-10-22 18:38:48 -0700127
Tao Baobd0ddcd2017-05-04 13:03:18 -0700128// We define RECOVERY_API_VERSION in Android.mk, which will be picked up by build system and packed
129// into target_files.zip. Assert the version defined in code and in Android.mk are consistent.
130static_assert(kRecoveryApiVersion == RECOVERY_API_VERSION, "Mismatching recovery API versions.");
131
Tao Baoac9d94d2016-11-03 11:37:15 -0700132static std::string locale;
Dan Albert8584fcf2016-10-27 03:08:08 +0000133static bool has_cache = false;
Tao Baoc0319b62016-10-13 15:17:04 -0700134
Tao Baoac9d94d2016-11-03 11:37:15 -0700135RecoveryUI* ui = nullptr;
136bool modified_flash = false;
Tao Baoa8d72bc2016-12-25 18:46:50 -0800137std::string stage;
Tao Baoac9d94d2016-11-03 11:37:15 -0700138const char* reason = nullptr;
139struct selabel_handle* sehandle;
140
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800141/*
142 * The recovery tool communicates with the main system through /cache files.
143 * /cache/recovery/command - INPUT - command line for tool, one arg per line
144 * /cache/recovery/log - OUTPUT - combined log file from recovery run(s)
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800145 *
146 * The arguments which may be supplied in the recovery.command file:
Doug Zongkerd4208f92010-09-20 12:16:13 -0700147 * --update_package=path - verify install an OTA package file
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800148 * --wipe_data - erase user data (and cache), then reboot
Paul Crowley08404b42016-12-19 13:04:23 -0800149 * --prompt_and_wipe_data - prompt the user that data is corrupt,
150 * with their consent erase user data (and cache), then reboot
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800151 * --wipe_cache - wipe cache (but not user data), then reboot
Oscar Montemayor05231562009-11-30 08:40:57 -0800152 * --set_encrypted_filesystem=on|off - enables / diasables encrypted fs
Doug Zongkere5d5ac72012-04-12 11:01:22 -0700153 * --just_exit - do nothing; exit and reboot
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800154 *
155 * After completing, we remove /cache/recovery/command and reboot.
156 * Arguments may also be supplied in the bootloader control block (BCB).
157 * These important scenarios must be safely restartable at any point:
158 *
159 * FACTORY RESET
160 * 1. user selects "factory reset"
161 * 2. main system writes "--wipe_data" to /cache/recovery/command
162 * 3. main system reboots into recovery
163 * 4. get_args() writes BCB with "boot-recovery" and "--wipe_data"
164 * -- after this, rebooting will restart the erase --
Doug Zongkerd4208f92010-09-20 12:16:13 -0700165 * 5. erase_volume() reformats /data
166 * 6. erase_volume() reformats /cache
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800167 * 7. finish_recovery() erases BCB
168 * -- after this, rebooting will restart the main system --
169 * 8. main() calls reboot() to boot main system
170 *
171 * OTA INSTALL
172 * 1. main system downloads OTA package to /cache/some-filename.zip
Doug Zongker9b125b02010-09-22 12:01:37 -0700173 * 2. main system writes "--update_package=/cache/some-filename.zip"
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800174 * 3. main system reboots into recovery
175 * 4. get_args() writes BCB with "boot-recovery" and "--update_package=..."
176 * -- after this, rebooting will attempt to reinstall the update --
177 * 5. install_package() attempts to install the update
178 * NOTE: the package install must itself be restartable from any point
179 * 6. finish_recovery() erases BCB
180 * -- after this, rebooting will (try to) restart the main system --
181 * 7. ** if install failed **
182 * 7a. prompt_and_wait() shows an error icon and waits for the user
Tao Baoc0336392016-12-13 22:29:49 -0800183 * 7b. the user reboots (pulling the battery, etc) into the main system
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800184 */
185
Tao Baoac3d1ed2017-07-23 00:01:02 -0700186// Open a given path, mounting partitions as necessary.
Tao Bao641fa972018-04-25 18:59:40 -0700187FILE* fopen_path(const std::string& path, const char* mode) {
188 if (ensure_path_mounted(path.c_str()) != 0) {
Tao Baoac3d1ed2017-07-23 00:01:02 -0700189 LOG(ERROR) << "Can't mount " << path;
190 return nullptr;
191 }
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800192
Tao Baoac3d1ed2017-07-23 00:01:02 -0700193 // When writing, try to create the containing directory, if necessary. Use generous permissions,
194 // the system (init.rc) will reset them.
195 if (strchr("wa", mode[0])) {
196 mkdir_recursively(path, 0777, true, sehandle);
197 }
Tao Bao641fa972018-04-25 18:59:40 -0700198 return fopen(path.c_str(), mode);
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800199}
200
Tao Bao04ca4262015-09-10 15:32:24 -0700201// close a file, log an error if the error indicator is set
Tao Bao641fa972018-04-25 18:59:40 -0700202static void check_and_fclose(FILE* fp, const std::string& name) {
203 fflush(fp);
204 if (fsync(fileno(fp)) == -1) {
205 PLOG(ERROR) << "Failed to fsync " << name;
206 }
207 if (ferror(fp)) {
208 PLOG(ERROR) << "Error in " << name;
209 }
210 fclose(fp);
Tao Bao04ca4262015-09-10 15:32:24 -0700211}
212
Elliott Hughesf14af802015-02-10 14:46:14 -0800213bool is_ro_debuggable() {
Elliott Hughescb220402016-09-23 15:30:55 -0700214 return android::base::GetBoolProperty("ro.debuggable", false);
Elliott Hughesf14af802015-02-10 14:46:14 -0800215}
216
Dmitri Plotnikov8706a982017-04-18 08:28:26 -0700217bool reboot(const std::string& command) {
218 std::string cmd = command;
219 if (android::base::GetBoolProperty("ro.boot.quiescent", false)) {
220 cmd += ",quiescent";
221 }
222 return android::base::SetProperty(ANDROID_RB_PROPERTY, cmd);
223}
224
Nick Kralevicha9ad0322014-10-22 18:38:48 -0700225static void redirect_stdio(const char* filename) {
Tao Bao04ca4262015-09-10 15:32:24 -0700226 int pipefd[2];
227 if (pipe(pipefd) == -1) {
Tianjie Xu7b0ad9c2016-08-05 18:00:04 -0700228 PLOG(ERROR) << "pipe failed";
Nick Kralevicha9ad0322014-10-22 18:38:48 -0700229
Tao Bao04ca4262015-09-10 15:32:24 -0700230 // Fall back to traditional logging mode without timestamps.
231 // If these fail, there's not really anywhere to complain...
232 freopen(filename, "a", stdout); setbuf(stdout, NULL);
233 freopen(filename, "a", stderr); setbuf(stderr, NULL);
234
235 return;
236 }
237
238 pid_t pid = fork();
239 if (pid == -1) {
Tianjie Xu7b0ad9c2016-08-05 18:00:04 -0700240 PLOG(ERROR) << "fork failed";
Tao Bao04ca4262015-09-10 15:32:24 -0700241
242 // Fall back to traditional logging mode without timestamps.
243 // If these fail, there's not really anywhere to complain...
244 freopen(filename, "a", stdout); setbuf(stdout, NULL);
245 freopen(filename, "a", stderr); setbuf(stderr, NULL);
246
247 return;
248 }
249
250 if (pid == 0) {
251 /// Close the unused write end.
252 close(pipefd[1]);
253
254 auto start = std::chrono::steady_clock::now();
255
256 // Child logger to actually write to the log file.
Tianjie Xude6735e2017-07-10 15:13:33 -0700257 FILE* log_fp = fopen(filename, "ae");
Tao Bao04ca4262015-09-10 15:32:24 -0700258 if (log_fp == nullptr) {
Tianjie Xu7b0ad9c2016-08-05 18:00:04 -0700259 PLOG(ERROR) << "fopen \"" << filename << "\" failed";
Tao Bao04ca4262015-09-10 15:32:24 -0700260 close(pipefd[0]);
Tao Bao3da88012017-02-03 13:09:23 -0800261 _exit(EXIT_FAILURE);
Tao Bao04ca4262015-09-10 15:32:24 -0700262 }
263
264 FILE* pipe_fp = fdopen(pipefd[0], "r");
265 if (pipe_fp == nullptr) {
Tianjie Xu7b0ad9c2016-08-05 18:00:04 -0700266 PLOG(ERROR) << "fdopen failed";
Tao Bao04ca4262015-09-10 15:32:24 -0700267 check_and_fclose(log_fp, filename);
268 close(pipefd[0]);
Tao Bao3da88012017-02-03 13:09:23 -0800269 _exit(EXIT_FAILURE);
Tao Bao04ca4262015-09-10 15:32:24 -0700270 }
271
272 char* line = nullptr;
273 size_t len = 0;
274 while (getline(&line, &len, pipe_fp) != -1) {
275 auto now = std::chrono::steady_clock::now();
276 double duration = std::chrono::duration_cast<std::chrono::duration<double>>(
277 now - start).count();
278 if (line[0] == '\n') {
279 fprintf(log_fp, "[%12.6lf]\n", duration);
280 } else {
281 fprintf(log_fp, "[%12.6lf] %s", duration, line);
282 }
283 fflush(log_fp);
284 }
285
Tianjie Xu7b0ad9c2016-08-05 18:00:04 -0700286 PLOG(ERROR) << "getline failed";
Tao Bao04ca4262015-09-10 15:32:24 -0700287
288 free(line);
289 check_and_fclose(log_fp, filename);
290 close(pipefd[0]);
Tao Bao3da88012017-02-03 13:09:23 -0800291 _exit(EXIT_FAILURE);
Tao Bao04ca4262015-09-10 15:32:24 -0700292 } else {
293 // Redirect stdout/stderr to the logger process.
294 // Close the unused read end.
295 close(pipefd[0]);
296
297 setbuf(stdout, nullptr);
298 setbuf(stderr, nullptr);
299
300 if (dup2(pipefd[1], STDOUT_FILENO) == -1) {
Tianjie Xu7b0ad9c2016-08-05 18:00:04 -0700301 PLOG(ERROR) << "dup2 stdout failed";
Tao Bao04ca4262015-09-10 15:32:24 -0700302 }
303 if (dup2(pipefd[1], STDERR_FILENO) == -1) {
Tianjie Xu7b0ad9c2016-08-05 18:00:04 -0700304 PLOG(ERROR) << "dup2 stderr failed";
Tao Bao04ca4262015-09-10 15:32:24 -0700305 }
306
307 close(pipefd[1]);
308 }
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800309}
310
311// command line args come from, in decreasing precedence:
312// - the actual command line
313// - the bootloader control block (one per line, after "recovery")
314// - the contents of COMMAND_FILE (one per line)
Tao Baof0ed1592016-12-02 11:32:19 -0800315static std::vector<std::string> get_args(const int argc, char** const argv) {
316 CHECK_GT(argc, 0);
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800317
Tao Baof0ed1592016-12-02 11:32:19 -0800318 bootloader_message boot = {};
319 std::string err;
320 if (!read_bootloader_message(&boot, &err)) {
321 LOG(ERROR) << err;
322 // If fails, leave a zeroed bootloader_message.
323 boot = {};
324 }
Tao Baoa8d72bc2016-12-25 18:46:50 -0800325 stage = std::string(boot.stage);
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800326
Tao Baof0ed1592016-12-02 11:32:19 -0800327 if (boot.command[0] != 0) {
328 std::string boot_command = std::string(boot.command, sizeof(boot.command));
329 LOG(INFO) << "Boot command: " << boot_command;
330 }
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800331
Tao Baof0ed1592016-12-02 11:32:19 -0800332 if (boot.status[0] != 0) {
333 std::string boot_status = std::string(boot.status, sizeof(boot.status));
334 LOG(INFO) << "Boot status: " << boot_status;
335 }
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800336
Tao Baof0ed1592016-12-02 11:32:19 -0800337 std::vector<std::string> args(argv, argv + argc);
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800338
Tao Baof0ed1592016-12-02 11:32:19 -0800339 // --- if arguments weren't supplied, look in the bootloader control block
Tao Bao570af9d2017-01-09 10:29:59 -0800340 if (args.size() == 1) {
Tao Baof0ed1592016-12-02 11:32:19 -0800341 boot.recovery[sizeof(boot.recovery) - 1] = '\0'; // Ensure termination
342 std::string boot_recovery(boot.recovery);
343 std::vector<std::string> tokens = android::base::Split(boot_recovery, "\n");
344 if (!tokens.empty() && tokens[0] == "recovery") {
345 for (auto it = tokens.begin() + 1; it != tokens.end(); it++) {
346 // Skip empty and '\0'-filled tokens.
347 if (!it->empty() && (*it)[0] != '\0') args.push_back(std::move(*it));
348 }
349 LOG(INFO) << "Got " << args.size() << " arguments from boot message";
350 } else if (boot.recovery[0] != 0) {
351 LOG(ERROR) << "Bad boot message: \"" << boot_recovery << "\"";
352 }
353 }
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800354
Tao Baof0ed1592016-12-02 11:32:19 -0800355 // --- if that doesn't work, try the command file (if we have /cache).
Tao Bao570af9d2017-01-09 10:29:59 -0800356 if (args.size() == 1 && has_cache) {
Tao Baof0ed1592016-12-02 11:32:19 -0800357 std::string content;
Tao Bao7d34fa12016-12-08 18:10:48 -0800358 if (ensure_path_mounted(COMMAND_FILE) == 0 &&
359 android::base::ReadFileToString(COMMAND_FILE, &content)) {
Tao Baof0ed1592016-12-02 11:32:19 -0800360 std::vector<std::string> tokens = android::base::Split(content, "\n");
Tao Bao7d34fa12016-12-08 18:10:48 -0800361 // All the arguments in COMMAND_FILE are needed (unlike the BCB message,
362 // COMMAND_FILE doesn't use filename as the first argument).
363 for (auto it = tokens.begin(); it != tokens.end(); it++) {
Tao Baof0ed1592016-12-02 11:32:19 -0800364 // Skip empty and '\0'-filled tokens.
365 if (!it->empty() && (*it)[0] != '\0') args.push_back(std::move(*it));
366 }
367 LOG(INFO) << "Got " << args.size() << " arguments from " << COMMAND_FILE;
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800368 }
Tao Baof0ed1592016-12-02 11:32:19 -0800369 }
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800370
Tao Baof0ed1592016-12-02 11:32:19 -0800371 // Write the arguments (excluding the filename in args[0]) back into the
372 // bootloader control block. So the device will always boot into recovery to
373 // finish the pending work, until finish_recovery() is called.
374 std::vector<std::string> options(args.cbegin() + 1, args.cend());
Tao Bao2292db82016-12-13 21:53:31 -0800375 if (!update_bootloader_message(options, &err)) {
376 LOG(ERROR) << "Failed to set BCB message: " << err;
Tao Baof0ed1592016-12-02 11:32:19 -0800377 }
378
379 return args;
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800380}
381
Tao Bao2292db82016-12-13 21:53:31 -0800382// Set the BCB to reboot back into recovery (it won't resume the install from
383// sdcard though).
384static void set_sdcard_update_bootloader_message() {
385 std::vector<std::string> options;
386 std::string err;
387 if (!update_bootloader_message(options, &err)) {
388 LOG(ERROR) << "Failed to set BCB message: " << err;
389 }
Doug Zongker34c98df2009-08-18 12:05:45 -0700390}
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800391
Tao Baobef39712015-05-04 18:50:27 -0700392// Read from kernel log into buffer and write out to file.
393static void save_kernel_log(const char* destination) {
394 int klog_buf_len = klogctl(KLOG_SIZE_BUFFER, 0, 0);
Patrick Tjincd055ee2014-12-09 11:26:40 -0800395 if (klog_buf_len <= 0) {
Tianjie Xu7b0ad9c2016-08-05 18:00:04 -0700396 PLOG(ERROR) << "Error getting klog size";
Patrick Tjincd055ee2014-12-09 11:26:40 -0800397 return;
398 }
399
Tao Baobef39712015-05-04 18:50:27 -0700400 std::string buffer(klog_buf_len, 0);
401 int n = klogctl(KLOG_READ_ALL, &buffer[0], klog_buf_len);
402 if (n == -1) {
Tianjie Xu7b0ad9c2016-08-05 18:00:04 -0700403 PLOG(ERROR) << "Error in reading klog";
Patrick Tjincd055ee2014-12-09 11:26:40 -0800404 return;
405 }
Tao Baobef39712015-05-04 18:50:27 -0700406 buffer.resize(n);
407 android::base::WriteStringToFile(buffer, destination);
Patrick Tjincd055ee2014-12-09 11:26:40 -0800408}
409
Tao Bao641fa972018-04-25 18:59:40 -0700410// Writes content to the current pmsg session.
411static ssize_t __pmsg_write(const std::string& filename, const std::string& buf) {
412 return __android_log_pmsg_file_write(LOG_ID_SYSTEM, ANDROID_LOG_INFO, filename.c_str(),
413 buf.data(), buf.size());
Mark Salyzyna4f701a2016-03-09 14:58:16 -0800414}
415
Tao Bao641fa972018-04-25 18:59:40 -0700416static void copy_log_file_to_pmsg(const std::string& source, const std::string& destination) {
417 std::string content;
418 android::base::ReadFileToString(source, &content);
419 __pmsg_write(destination, content);
Mark Salyzyna4f701a2016-03-09 14:58:16 -0800420}
421
Tao Baof0124322015-04-11 02:04:11 +0000422// How much of the temp log we have copied to the copy in cache.
Chih-Hung Hsieh54a27472016-04-18 11:30:55 -0700423static off_t tmplog_offset = 0;
Tao Baof0124322015-04-11 02:04:11 +0000424
Tao Bao641fa972018-04-25 18:59:40 -0700425static void copy_log_file(const std::string& source, const std::string& destination, bool append) {
Tianjie Xude6735e2017-07-10 15:13:33 -0700426 FILE* dest_fp = fopen_path(destination, append ? "ae" : "we");
427 if (dest_fp == nullptr) {
428 PLOG(ERROR) << "Can't open " << destination;
429 } else {
Tao Bao641fa972018-04-25 18:59:40 -0700430 FILE* source_fp = fopen(source.c_str(), "re");
Tianjie Xude6735e2017-07-10 15:13:33 -0700431 if (source_fp != nullptr) {
432 if (append) {
433 fseeko(source_fp, tmplog_offset, SEEK_SET); // Since last write
434 }
435 char buf[4096];
436 size_t bytes;
437 while ((bytes = fread(buf, 1, sizeof(buf), source_fp)) != 0) {
438 fwrite(buf, 1, bytes, dest_fp);
439 }
440 if (append) {
441 tmplog_offset = ftello(source_fp);
442 }
443 check_and_fclose(source_fp, source);
Doug Zongker2c3539e2010-09-29 13:21:30 -0700444 }
Tianjie Xude6735e2017-07-10 15:13:33 -0700445 check_and_fclose(dest_fp, destination);
446 }
Doug Zongker2c3539e2010-09-29 13:21:30 -0700447}
448
Tao Bao682c34b2015-04-07 17:16:35 -0700449static void copy_logs() {
Tao Bao641fa972018-04-25 18:59:40 -0700450 // We only rotate and record the log of the current session if there are actual attempts to modify
451 // the flash, such as wipes, installs from BCB or menu selections. This is to avoid unnecessary
452 // rotation (and possible deletion) of log files, if it does not do anything loggable.
453 if (!modified_flash) {
454 return;
455 }
Tao Bao682c34b2015-04-07 17:16:35 -0700456
Tao Bao641fa972018-04-25 18:59:40 -0700457 // Always write to pmsg, this allows the OTA logs to be caught in `logcat -L`.
458 copy_log_file_to_pmsg(Paths::Get().temporary_log_file(), LAST_LOG_FILE);
459 copy_log_file_to_pmsg(Paths::Get().temporary_install_file(), LAST_INSTALL_FILE);
Mark Salyzyna4f701a2016-03-09 14:58:16 -0800460
Tao Bao641fa972018-04-25 18:59:40 -0700461 // We can do nothing for now if there's no /cache partition.
462 if (!has_cache) {
463 return;
464 }
Mark Salyzyna4f701a2016-03-09 14:58:16 -0800465
Tao Bao641fa972018-04-25 18:59:40 -0700466 ensure_path_mounted(LAST_LOG_FILE);
467 ensure_path_mounted(LAST_KMSG_FILE);
468 rotate_logs(LAST_LOG_FILE, LAST_KMSG_FILE);
Tao Bao682c34b2015-04-07 17:16:35 -0700469
Tao Bao641fa972018-04-25 18:59:40 -0700470 // Copy logs to cache so the system can find out what happened.
471 copy_log_file(Paths::Get().temporary_log_file(), LOG_FILE, true);
472 copy_log_file(Paths::Get().temporary_log_file(), LAST_LOG_FILE, false);
473 copy_log_file(Paths::Get().temporary_install_file(), LAST_INSTALL_FILE, false);
474 save_kernel_log(LAST_KMSG_FILE);
475 chmod(LOG_FILE, 0600);
476 chown(LOG_FILE, AID_SYSTEM, AID_SYSTEM);
477 chmod(LAST_KMSG_FILE, 0600);
478 chown(LAST_KMSG_FILE, AID_SYSTEM, AID_SYSTEM);
479 chmod(LAST_LOG_FILE, 0640);
480 chmod(LAST_INSTALL_FILE, 0644);
481 sync();
Doug Zongkerf24fd7e2013-07-02 11:43:25 -0700482}
483
Tao Baoec579032017-07-21 12:13:15 -0700484// Clear the recovery command and prepare to boot a (hopefully working) system,
Tianjie Xuc14d95d2016-03-24 11:50:34 -0700485// copy our log file to cache as well (for the system to read). This function is
486// idempotent: call it as many times as you like.
Tao Baoac9d94d2016-11-03 11:37:15 -0700487static void finish_recovery() {
Tao Baoec579032017-07-21 12:13:15 -0700488 // Save the locale to cache, so if recovery is next started up without a '--locale' argument
489 // (e.g., directly from the bootloader) it will use the last-known locale.
490 if (!locale.empty() && has_cache) {
491 LOG(INFO) << "Saving locale \"" << locale << "\"";
492 if (ensure_path_mounted(LOCALE_FILE) != 0) {
493 LOG(ERROR) << "Failed to mount " << LOCALE_FILE;
494 } else if (!android::base::WriteStringToFile(locale, LOCALE_FILE)) {
495 PLOG(ERROR) << "Failed to save locale to " << LOCALE_FILE;
Doug Zongker4f33e552012-08-23 13:16:12 -0700496 }
Tao Baoec579032017-07-21 12:13:15 -0700497 }
Doug Zongker4f33e552012-08-23 13:16:12 -0700498
Tao Baoec579032017-07-21 12:13:15 -0700499 copy_logs();
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800500
Tao Baoec579032017-07-21 12:13:15 -0700501 // Reset to normal system boot so recovery won't cycle indefinitely.
502 std::string err;
503 if (!clear_bootloader_message(&err)) {
504 LOG(ERROR) << "Failed to clear BCB message: " << err;
505 }
506
507 // Remove the command file, so recovery won't repeat indefinitely.
508 if (has_cache) {
509 if (ensure_path_mounted(COMMAND_FILE) != 0 || (unlink(COMMAND_FILE) && errno != ENOENT)) {
510 LOG(WARNING) << "Can't unlink " << COMMAND_FILE;
Yabin Cui8b309f62016-06-24 18:22:02 -0700511 }
Tao Baoec579032017-07-21 12:13:15 -0700512 ensure_path_unmounted(CACHE_ROOT);
513 }
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800514
Tao Baoec579032017-07-21 12:13:15 -0700515 sync(); // For good measure.
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800516}
517
Tao Bao3f5a3822016-12-13 11:14:37 -0800518struct saved_log_file {
519 std::string name;
520 struct stat sb;
521 std::string data;
522};
Doug Zongker6d0d7ac2013-07-09 13:34:55 -0700523
Elliott Hughes945548e2015-06-05 17:59:56 -0700524static bool erase_volume(const char* volume) {
Tao Bao3f5a3822016-12-13 11:14:37 -0800525 bool is_cache = (strcmp(volume, CACHE_ROOT) == 0);
526 bool is_data = (strcmp(volume, DATA_ROOT) == 0);
Doug Zongker6d0d7ac2013-07-09 13:34:55 -0700527
Tao Bao3f5a3822016-12-13 11:14:37 -0800528 ui->SetBackground(RecoveryUI::ERASING);
529 ui->SetProgressType(RecoveryUI::INDETERMINATE);
Doug Zongker6d0d7ac2013-07-09 13:34:55 -0700530
Tao Bao3f5a3822016-12-13 11:14:37 -0800531 std::vector<saved_log_file> log_files;
Doug Zongker6d0d7ac2013-07-09 13:34:55 -0700532
Tao Bao3f5a3822016-12-13 11:14:37 -0800533 if (is_cache) {
534 // If we're reformatting /cache, we load any past logs
535 // (i.e. "/cache/recovery/last_*") and the current log
536 // ("/cache/recovery/log") into memory, so we can restore them after
537 // the reformat.
Doug Zongker6d0d7ac2013-07-09 13:34:55 -0700538
Tao Bao3f5a3822016-12-13 11:14:37 -0800539 ensure_path_mounted(volume);
Doug Zongker6d0d7ac2013-07-09 13:34:55 -0700540
Tao Bao3f5a3822016-12-13 11:14:37 -0800541 struct dirent* de;
542 std::unique_ptr<DIR, decltype(&closedir)> d(opendir(CACHE_LOG_DIR), closedir);
543 if (d) {
544 while ((de = readdir(d.get())) != nullptr) {
545 if (strncmp(de->d_name, "last_", 5) == 0 || strcmp(de->d_name, "log") == 0) {
546 std::string path = android::base::StringPrintf("%s/%s", CACHE_LOG_DIR, de->d_name);
547
548 struct stat sb;
549 if (stat(path.c_str(), &sb) == 0) {
550 // truncate files to 512kb
551 if (sb.st_size > (1 << 19)) {
552 sb.st_size = 1 << 19;
Doug Zongker6d0d7ac2013-07-09 13:34:55 -0700553 }
Tao Bao3f5a3822016-12-13 11:14:37 -0800554
555 std::string data(sb.st_size, '\0');
Tianjie Xude6735e2017-07-10 15:13:33 -0700556 FILE* f = fopen(path.c_str(), "rbe");
Tao Bao3f5a3822016-12-13 11:14:37 -0800557 fread(&data[0], 1, data.size(), f);
558 fclose(f);
559
560 log_files.emplace_back(saved_log_file{ path, sb, data });
561 }
Doug Zongker6d0d7ac2013-07-09 13:34:55 -0700562 }
Tao Bao3f5a3822016-12-13 11:14:37 -0800563 }
Paul Lawrenced0db3372015-11-05 13:38:40 -0800564 } else {
Tao Bao3f5a3822016-12-13 11:14:37 -0800565 if (errno != ENOENT) {
566 PLOG(ERROR) << "Failed to opendir " << CACHE_LOG_DIR;
567 }
Paul Lawrenced0db3372015-11-05 13:38:40 -0800568 }
Tao Bao3f5a3822016-12-13 11:14:37 -0800569 }
Doug Zongkerd0181b82011-10-19 10:51:12 -0700570
Tao Bao3f5a3822016-12-13 11:14:37 -0800571 ui->Print("Formatting %s...\n", volume);
572
573 ensure_path_unmounted(volume);
574
575 int result;
576
577 if (is_data && reason && strcmp(reason, "convert_fbe") == 0) {
578 // Create convert_fbe breadcrumb file to signal to init
579 // to convert to file based encryption, not full disk encryption
580 if (mkdir(CONVERT_FBE_DIR, 0700) != 0) {
581 ui->Print("Failed to make convert_fbe dir %s\n", strerror(errno));
582 return true;
583 }
Tianjie Xude6735e2017-07-10 15:13:33 -0700584 FILE* f = fopen(CONVERT_FBE_FILE, "wbe");
Tao Bao3f5a3822016-12-13 11:14:37 -0800585 if (!f) {
586 ui->Print("Failed to convert to file encryption %s\n", strerror(errno));
587 return true;
588 }
589 fclose(f);
590 result = format_volume(volume, CONVERT_FBE_DIR);
591 remove(CONVERT_FBE_FILE);
592 rmdir(CONVERT_FBE_DIR);
593 } else {
594 result = format_volume(volume);
595 }
596
597 if (is_cache) {
598 // Re-create the log dir and write back the log entries.
599 if (ensure_path_mounted(CACHE_LOG_DIR) == 0 &&
Tao Baoac3d1ed2017-07-23 00:01:02 -0700600 mkdir_recursively(CACHE_LOG_DIR, 0777, false, sehandle) == 0) {
Tao Bao3f5a3822016-12-13 11:14:37 -0800601 for (const auto& log : log_files) {
602 if (!android::base::WriteStringToFile(log.data, log.name, log.sb.st_mode, log.sb.st_uid,
603 log.sb.st_gid)) {
604 PLOG(ERROR) << "Failed to write to " << log.name;
Doug Zongker6d0d7ac2013-07-09 13:34:55 -0700605 }
Tao Bao3f5a3822016-12-13 11:14:37 -0800606 }
607 } else {
608 PLOG(ERROR) << "Failed to mount / create " << CACHE_LOG_DIR;
Doug Zongker2c3539e2010-09-29 13:21:30 -0700609 }
610
Tao Bao3f5a3822016-12-13 11:14:37 -0800611 // Any part of the log we'd copied to cache is now gone.
612 // Reset the pointer so we copy from the beginning of the temp
613 // log.
614 tmplog_offset = 0;
615 copy_logs();
616 }
617
618 return (result == 0);
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800619}
620
Tao Baofc5499f2017-02-23 19:06:53 -0800621// Display a menu with the specified 'headers' and 'items'. Device specific HandleMenuKey() may
622// return a positive number beyond the given range. Caller sets 'menu_only' to true to ensure only
Tao Bao50dd5322017-03-07 14:57:04 -0800623// a menu item gets selected. 'initial_selection' controls the initial cursor location. Returns the
624// (non-negative) chosen item number, or -1 if timed out waiting for input.
Tao Baofc5499f2017-02-23 19:06:53 -0800625static int get_menu_selection(const char* const* headers, const char* const* items, bool menu_only,
626 int initial_selection, Device* device) {
627 // Throw away keys pressed previously, so user doesn't accidentally trigger menu items.
628 ui->FlushKeys();
Doug Zongkerf93d8162009-09-22 15:16:02 -0700629
Tao Baofc5499f2017-02-23 19:06:53 -0800630 ui->StartMenu(headers, items, initial_selection);
Tao Bao50dd5322017-03-07 14:57:04 -0800631
Tao Baofc5499f2017-02-23 19:06:53 -0800632 int selected = initial_selection;
633 int chosen_item = -1;
Tao Baofc5499f2017-02-23 19:06:53 -0800634 while (chosen_item < 0) {
635 int key = ui->WaitKey();
Tao Bao50dd5322017-03-07 14:57:04 -0800636 if (key == -1) { // WaitKey() timed out.
Tao Baofc5499f2017-02-23 19:06:53 -0800637 if (ui->WasTextEverVisible()) {
638 continue;
639 } else {
Tao Bao50dd5322017-03-07 14:57:04 -0800640 LOG(INFO) << "Timed out waiting for key input; rebooting.";
Tao Baofc5499f2017-02-23 19:06:53 -0800641 ui->EndMenu();
Tao Bao50dd5322017-03-07 14:57:04 -0800642 return -1;
Tao Baofc5499f2017-02-23 19:06:53 -0800643 }
Doug Zongkerf93d8162009-09-22 15:16:02 -0700644 }
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800645
Tao Baofc5499f2017-02-23 19:06:53 -0800646 bool visible = ui->IsTextVisible();
647 int action = device->HandleMenuKey(key, visible);
648
649 if (action < 0) {
650 switch (action) {
651 case Device::kHighlightUp:
652 selected = ui->SelectMenu(--selected);
653 break;
654 case Device::kHighlightDown:
655 selected = ui->SelectMenu(++selected);
656 break;
657 case Device::kInvokeItem:
658 chosen_item = selected;
659 break;
660 case Device::kNoAction:
661 break;
662 }
663 } else if (!menu_only) {
664 chosen_item = action;
665 }
666 }
667
668 ui->EndMenu();
669 return chosen_item;
Doug Zongkerf93d8162009-09-22 15:16:02 -0700670}
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800671
Tao Baoc4a18ef2017-02-10 00:13:30 -0800672// Returns the selected filename, or an empty string.
673static std::string browse_directory(const std::string& path, Device* device) {
674 ensure_path_mounted(path.c_str());
Doug Zongker8674a722010-09-15 11:08:23 -0700675
Tao Baoc4a18ef2017-02-10 00:13:30 -0800676 std::unique_ptr<DIR, decltype(&closedir)> d(opendir(path.c_str()), closedir);
677 if (!d) {
678 PLOG(ERROR) << "error opening " << path;
679 return "";
680 }
Doug Zongkerc18eeb82010-09-21 16:49:26 -0700681
Tao Baoc4a18ef2017-02-10 00:13:30 -0800682 std::vector<std::string> dirs;
683 std::vector<std::string> zips = { "../" }; // "../" is always the first entry.
684
685 dirent* de;
686 while ((de = readdir(d.get())) != nullptr) {
687 std::string name(de->d_name);
688
689 if (de->d_type == DT_DIR) {
690 // Skip "." and ".." entries.
691 if (name == "." || name == "..") continue;
692 dirs.push_back(name + "/");
693 } else if (de->d_type == DT_REG && android::base::EndsWithIgnoreCase(name, ".zip")) {
694 zips.push_back(name);
695 }
696 }
697
698 std::sort(dirs.begin(), dirs.end());
699 std::sort(zips.begin(), zips.end());
700
701 // Append dirs to the zips list.
702 zips.insert(zips.end(), dirs.begin(), dirs.end());
703
704 const char* entries[zips.size() + 1];
705 entries[zips.size()] = nullptr;
706 for (size_t i = 0; i < zips.size(); i++) {
707 entries[i] = zips[i].c_str();
708 }
709
710 const char* headers[] = { "Choose a package to install:", path.c_str(), nullptr };
711
712 int chosen_item = 0;
713 while (true) {
Tao Baofc5499f2017-02-23 19:06:53 -0800714 chosen_item = get_menu_selection(headers, entries, true, chosen_item, device);
Tao Baoc4a18ef2017-02-10 00:13:30 -0800715
716 const std::string& item = zips[chosen_item];
717 if (chosen_item == 0) {
718 // Go up but continue browsing (if the caller is browse_directory).
719 return "";
Doug Zongker8674a722010-09-15 11:08:23 -0700720 }
721
Tao Baoc4a18ef2017-02-10 00:13:30 -0800722 std::string new_path = path + "/" + item;
723 if (new_path.back() == '/') {
724 // Recurse down into a subdirectory.
725 new_path.pop_back();
726 std::string result = browse_directory(new_path, device);
727 if (!result.empty()) return result;
728 } else {
729 // Selected a zip file: return the path to the caller.
730 return new_path;
Doug Zongker8674a722010-09-15 11:08:23 -0700731 }
Tao Baoc4a18ef2017-02-10 00:13:30 -0800732 }
Doug Zongker8674a722010-09-15 11:08:23 -0700733
Tao Baoc4a18ef2017-02-10 00:13:30 -0800734 // Unreachable.
Doug Zongker8674a722010-09-15 11:08:23 -0700735}
736
Elliott Hughes30694c92015-03-25 15:16:51 -0700737static bool yes_no(Device* device, const char* question1, const char* question2) {
Elliott Hughes8fd86d72015-04-13 14:36:02 -0700738 const char* headers[] = { question1, question2, NULL };
Elliott Hughes30694c92015-03-25 15:16:51 -0700739 const char* items[] = { " No", " Yes", NULL };
Doug Zongkerddd6a282009-06-09 12:22:33 -0700740
Tao Baofc5499f2017-02-23 19:06:53 -0800741 int chosen_item = get_menu_selection(headers, items, true, 0, device);
Elliott Hughes30694c92015-03-25 15:16:51 -0700742 return (chosen_item == 1);
743}
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -0800744
Paul Crowley08404b42016-12-19 13:04:23 -0800745static bool ask_to_wipe_data(Device* device) {
746 return yes_no(device, "Wipe all user data?", " THIS CAN NOT BE UNDONE!");
747}
Doug Zongker1066d2c2009-04-01 13:57:40 -0700748
Paul Crowley08404b42016-12-19 13:04:23 -0800749// Return true on success.
750static bool wipe_data(Device* device) {
Tao Bao682c34b2015-04-07 17:16:35 -0700751 modified_flash = true;
752
Doug Zongker211aebc2011-10-28 15:13:10 -0700753 ui->Print("\n-- Wiping data...\n");
Paul Crowley3b4d5162016-06-08 13:51:41 -0700754 bool success = device->PreWipeData();
755 if (success) {
756 success &= erase_volume(DATA_ROOT);
757 if (has_cache) {
758 success &= erase_volume(CACHE_ROOT);
759 }
760 if (volume_for_mount_point(METADATA_ROOT) != nullptr) {
761 success &= erase_volume(METADATA_ROOT);
762 }
763 }
764 if (success) {
765 success &= device->PostWipeData();
766 }
Elliott Hughes945548e2015-06-05 17:59:56 -0700767 ui->Print("Data wipe %s.\n", success ? "complete" : "failed");
768 return success;
Doug Zongkerf93d8162009-09-22 15:16:02 -0700769}
770
Paul Crowley08404b42016-12-19 13:04:23 -0800771static bool prompt_and_wipe_data(Device* device) {
Tao Bao2bbc6d62017-08-13 23:48:55 -0700772 // Use a single string and let ScreenRecoveryUI handles the wrapping.
Tao Baofc5499f2017-02-23 19:06:53 -0800773 const char* const headers[] = {
Tao Bao2bbc6d62017-08-13 23:48:55 -0700774 "Can't load Android system. Your data may be corrupt. "
775 "If you continue to get this message, you may need to "
776 "perform a factory data reset and erase all user data "
Paul Crowley31ac0c62017-03-23 12:32:40 -0700777 "stored on this device.",
Tao Bao2bbc6d62017-08-13 23:48:55 -0700778 nullptr
Tao Baofc5499f2017-02-23 19:06:53 -0800779 };
780 const char* const items[] = {
Paul Crowley31ac0c62017-03-23 12:32:40 -0700781 "Try again",
782 "Factory data reset",
Tao Baofc5499f2017-02-23 19:06:53 -0800783 NULL
784 };
785 for (;;) {
786 int chosen_item = get_menu_selection(headers, items, true, 0, device);
787 if (chosen_item != 1) {
788 return true; // Just reboot, no wipe; not a failure, user asked for it
Paul Crowley08404b42016-12-19 13:04:23 -0800789 }
Tao Baofc5499f2017-02-23 19:06:53 -0800790 if (ask_to_wipe_data(device)) {
791 return wipe_data(device);
792 }
793 }
Paul Crowley08404b42016-12-19 13:04:23 -0800794}
795
Tao Baoe39a9bc2015-03-31 12:19:05 -0700796// Return true on success.
797static bool wipe_cache(bool should_confirm, Device* device) {
Tao Bao26112e52016-02-25 12:29:40 -0800798 if (!has_cache) {
799 ui->Print("No /cache partition found.\n");
800 return false;
801 }
802
Elliott Hughes30694c92015-03-25 15:16:51 -0700803 if (should_confirm && !yes_no(device, "Wipe cache?", " THIS CAN NOT BE UNDONE!")) {
Tao Baoe39a9bc2015-03-31 12:19:05 -0700804 return false;
Elliott Hughes30694c92015-03-25 15:16:51 -0700805 }
806
Tao Bao682c34b2015-04-07 17:16:35 -0700807 modified_flash = true;
808
Elliott Hughes30694c92015-03-25 15:16:51 -0700809 ui->Print("\n-- Wiping cache...\n");
Elliott Hughes945548e2015-06-05 17:59:56 -0700810 bool success = erase_volume("/cache");
811 ui->Print("Cache wipe %s.\n", success ? "complete" : "failed");
812 return success;
Elliott Hughes30694c92015-03-25 15:16:51 -0700813}
814
Tao Bao1b2a98b2017-03-24 10:45:34 -0700815// Secure-wipe a given partition. It uses BLKSECDISCARD, if supported. Otherwise, it goes with
816// BLKDISCARD (if device supports BLKDISCARDZEROES) or BLKZEROOUT.
Tao Bao862a4c12016-06-02 11:16:50 -0700817static bool secure_wipe_partition(const std::string& partition) {
Tao Bao1b2a98b2017-03-24 10:45:34 -0700818 android::base::unique_fd fd(TEMP_FAILURE_RETRY(open(partition.c_str(), O_WRONLY)));
819 if (fd == -1) {
820 PLOG(ERROR) << "Failed to open \"" << partition << "\"";
821 return false;
822 }
823
824 uint64_t range[2] = { 0, 0 };
825 if (ioctl(fd, BLKGETSIZE64, &range[1]) == -1 || range[1] == 0) {
826 PLOG(ERROR) << "Failed to get partition size";
827 return false;
828 }
829 LOG(INFO) << "Secure-wiping \"" << partition << "\" from " << range[0] << " to " << range[1];
830
831 LOG(INFO) << " Trying BLKSECDISCARD...";
832 if (ioctl(fd, BLKSECDISCARD, &range) == -1) {
833 PLOG(WARNING) << " Failed";
834
835 // Use BLKDISCARD if it zeroes out blocks, otherwise use BLKZEROOUT.
836 unsigned int zeroes;
837 if (ioctl(fd, BLKDISCARDZEROES, &zeroes) == 0 && zeroes != 0) {
838 LOG(INFO) << " Trying BLKDISCARD...";
839 if (ioctl(fd, BLKDISCARD, &range) == -1) {
840 PLOG(ERROR) << " Failed";
Tao Bao862a4c12016-06-02 11:16:50 -0700841 return false;
Tao Bao1b2a98b2017-03-24 10:45:34 -0700842 }
843 } else {
844 LOG(INFO) << " Trying BLKZEROOUT...";
845 if (ioctl(fd, BLKZEROOUT, &range) == -1) {
846 PLOG(ERROR) << " Failed";
Tao Bao862a4c12016-06-02 11:16:50 -0700847 return false;
Tao Bao1b2a98b2017-03-24 10:45:34 -0700848 }
Tao Bao862a4c12016-06-02 11:16:50 -0700849 }
Tao Bao1b2a98b2017-03-24 10:45:34 -0700850 }
Tao Bao862a4c12016-06-02 11:16:50 -0700851
Tao Bao1b2a98b2017-03-24 10:45:34 -0700852 LOG(INFO) << " Done";
853 return true;
Tao Bao862a4c12016-06-02 11:16:50 -0700854}
855
Yabin Cuifd99a312016-06-09 14:09:39 -0700856// Check if the wipe package matches expectation:
857// 1. verify the package.
858// 2. check metadata (ota-type, pre-device and serial number if having one).
859static bool check_wipe_package(size_t wipe_package_size) {
860 if (wipe_package_size == 0) {
861 LOG(ERROR) << "wipe_package_size is zero";
862 return false;
863 }
864 std::string wipe_package;
865 std::string err_str;
866 if (!read_wipe_package(&wipe_package, wipe_package_size, &err_str)) {
867 PLOG(ERROR) << "Failed to read wipe package";
868 return false;
869 }
870 if (!verify_package(reinterpret_cast<const unsigned char*>(wipe_package.data()),
871 wipe_package.size())) {
872 LOG(ERROR) << "Failed to verify package";
873 return false;
874 }
875
876 // Extract metadata
877 ZipArchiveHandle zip;
Tao Baoefc35592017-01-08 22:45:47 -0800878 int err = OpenArchiveFromMemory(static_cast<void*>(&wipe_package[0]), wipe_package.size(),
879 "wipe_package", &zip);
Yabin Cuifd99a312016-06-09 14:09:39 -0700880 if (err != 0) {
881 LOG(ERROR) << "Can't open wipe package : " << ErrorCodeString(err);
882 return false;
883 }
884 std::string metadata;
Tao Bao1b2a98b2017-03-24 10:45:34 -0700885 if (!read_metadata_from_package(zip, &metadata)) {
Yabin Cuifd99a312016-06-09 14:09:39 -0700886 CloseArchive(zip);
887 return false;
888 }
889 CloseArchive(zip);
890
891 // Check metadata
892 std::vector<std::string> lines = android::base::Split(metadata, "\n");
893 bool ota_type_matched = false;
894 bool device_type_matched = false;
895 bool has_serial_number = false;
896 bool serial_number_matched = false;
897 for (const auto& line : lines) {
898 if (line == "ota-type=BRICK") {
899 ota_type_matched = true;
900 } else if (android::base::StartsWith(line, "pre-device=")) {
901 std::string device_type = line.substr(strlen("pre-device="));
Tao Baoefc35592017-01-08 22:45:47 -0800902 std::string real_device_type = android::base::GetProperty("ro.build.product", "");
Yabin Cuifd99a312016-06-09 14:09:39 -0700903 device_type_matched = (device_type == real_device_type);
904 } else if (android::base::StartsWith(line, "serialno=")) {
905 std::string serial_no = line.substr(strlen("serialno="));
Tao Baoefc35592017-01-08 22:45:47 -0800906 std::string real_serial_no = android::base::GetProperty("ro.serialno", "");
Yabin Cuifd99a312016-06-09 14:09:39 -0700907 has_serial_number = true;
908 serial_number_matched = (serial_no == real_serial_no);
909 }
910 }
911 return ota_type_matched && device_type_matched && (!has_serial_number || serial_number_matched);
912}
913
Yabin Cui8b309f62016-06-24 18:22:02 -0700914// Wipe the current A/B device, with a secure wipe of all the partitions in
915// RECOVERY_WIPE.
Yabin Cuifd99a312016-06-09 14:09:39 -0700916static bool wipe_ab_device(size_t wipe_package_size) {
Tao Bao862a4c12016-06-02 11:16:50 -0700917 ui->SetBackground(RecoveryUI::ERASING);
918 ui->SetProgressType(RecoveryUI::INDETERMINATE);
919
Yabin Cuifd99a312016-06-09 14:09:39 -0700920 if (!check_wipe_package(wipe_package_size)) {
921 LOG(ERROR) << "Failed to verify wipe package";
922 return false;
923 }
Tao Bao862a4c12016-06-02 11:16:50 -0700924 std::string partition_list;
Yabin Cui8b309f62016-06-24 18:22:02 -0700925 if (!android::base::ReadFileToString(RECOVERY_WIPE, &partition_list)) {
926 LOG(ERROR) << "failed to read \"" << RECOVERY_WIPE << "\"";
Tao Bao862a4c12016-06-02 11:16:50 -0700927 return false;
928 }
929
930 std::vector<std::string> lines = android::base::Split(partition_list, "\n");
931 for (const std::string& line : lines) {
932 std::string partition = android::base::Trim(line);
933 // Ignore '#' comment or empty lines.
934 if (android::base::StartsWith(partition, "#") || partition.empty()) {
935 continue;
936 }
937
938 // Proceed anyway even if it fails to wipe some partition.
939 secure_wipe_partition(partition);
940 }
941 return true;
942}
943
Nick Kralevicha9ad0322014-10-22 18:38:48 -0700944static void choose_recovery_file(Device* device) {
Tao Bao08fc6be2017-03-07 00:56:27 -0800945 std::vector<std::string> entries;
946 if (has_cache) {
947 for (int i = 0; i < KEEP_LOG_COUNT; i++) {
948 auto add_to_entries = [&](const char* filename) {
949 std::string log_file(filename);
950 if (i > 0) {
951 log_file += "." + std::to_string(i);
Tao Baobef39712015-05-04 18:50:27 -0700952 }
Tao Bao08fc6be2017-03-07 00:56:27 -0800953
954 if (ensure_path_mounted(log_file.c_str()) == 0 && access(log_file.c_str(), R_OK) == 0) {
955 entries.push_back(std::move(log_file));
956 }
957 };
958
959 // Add LAST_LOG_FILE + LAST_LOG_FILE.x
960 add_to_entries(LAST_LOG_FILE);
961
962 // Add LAST_KMSG_FILE + LAST_KMSG_FILE.x
963 add_to_entries(LAST_KMSG_FILE);
964 }
965 } else {
966 // If cache partition is not found, view /tmp/recovery.log instead.
Tao Bao641fa972018-04-25 18:59:40 -0700967 if (access(Paths::Get().temporary_log_file().c_str(), R_OK) == -1) {
Tao Bao08fc6be2017-03-07 00:56:27 -0800968 return;
Tianjie Xua54f75e2016-08-17 12:02:46 -0700969 } else {
Tao Bao641fa972018-04-25 18:59:40 -0700970 entries.push_back(Paths::Get().temporary_log_file());
Nick Kralevicha9ad0322014-10-22 18:38:48 -0700971 }
Tao Bao08fc6be2017-03-07 00:56:27 -0800972 }
Nick Kralevicha9ad0322014-10-22 18:38:48 -0700973
Tao Bao08fc6be2017-03-07 00:56:27 -0800974 entries.push_back("Back");
Elliott Hughesc0491632015-05-06 12:40:05 -0700975
Tao Bao08fc6be2017-03-07 00:56:27 -0800976 std::vector<const char*> menu_entries(entries.size());
977 std::transform(entries.cbegin(), entries.cend(), menu_entries.begin(),
978 [](const std::string& entry) { return entry.c_str(); });
979 menu_entries.push_back(nullptr);
Nick Kralevicha9ad0322014-10-22 18:38:48 -0700980
Tao Bao08fc6be2017-03-07 00:56:27 -0800981 const char* headers[] = { "Select file to view", nullptr };
Elliott Hughes8de52072015-04-08 20:06:50 -0700982
Tao Bao08fc6be2017-03-07 00:56:27 -0800983 int chosen_item = 0;
984 while (true) {
Tao Baofc5499f2017-02-23 19:06:53 -0800985 chosen_item = get_menu_selection(headers, menu_entries.data(), true, chosen_item, device);
Tao Bao08fc6be2017-03-07 00:56:27 -0800986 if (entries[chosen_item] == "Back") break;
Nick Kralevicha9ad0322014-10-22 18:38:48 -0700987
Tao Bao08fc6be2017-03-07 00:56:27 -0800988 ui->ShowFile(entries[chosen_item].c_str());
989 }
Nick Kralevicha9ad0322014-10-22 18:38:48 -0700990}
991
Tao Baodb7e8982017-03-06 23:53:16 -0800992static void run_graphics_test() {
993 // Switch to graphics screen.
994 ui->ShowText(false);
Elliott Hughes498cda62016-04-14 16:49:04 -0700995
Tao Baodb7e8982017-03-06 23:53:16 -0800996 ui->SetProgressType(RecoveryUI::INDETERMINATE);
997 ui->SetBackground(RecoveryUI::INSTALLING_UPDATE);
998 sleep(1);
Elliott Hughes498cda62016-04-14 16:49:04 -0700999
Tao Baodb7e8982017-03-06 23:53:16 -08001000 ui->SetBackground(RecoveryUI::ERROR);
1001 sleep(1);
Elliott Hughes498cda62016-04-14 16:49:04 -07001002
Tao Baodb7e8982017-03-06 23:53:16 -08001003 ui->SetBackground(RecoveryUI::NO_COMMAND);
1004 sleep(1);
Elliott Hughes498cda62016-04-14 16:49:04 -07001005
Tao Baodb7e8982017-03-06 23:53:16 -08001006 ui->SetBackground(RecoveryUI::ERASING);
1007 sleep(1);
Elliott Hughes498cda62016-04-14 16:49:04 -07001008
Tao Baodb7e8982017-03-06 23:53:16 -08001009 // Calling SetBackground() after SetStage() to trigger a redraw.
1010 ui->SetStage(1, 3);
1011 ui->SetBackground(RecoveryUI::INSTALLING_UPDATE);
1012 sleep(1);
1013 ui->SetStage(2, 3);
1014 ui->SetBackground(RecoveryUI::INSTALLING_UPDATE);
1015 sleep(1);
1016 ui->SetStage(3, 3);
1017 ui->SetBackground(RecoveryUI::INSTALLING_UPDATE);
1018 sleep(1);
Elliott Hughes498cda62016-04-14 16:49:04 -07001019
Tao Baodb7e8982017-03-06 23:53:16 -08001020 ui->SetStage(-1, -1);
1021 ui->SetBackground(RecoveryUI::INSTALLING_UPDATE);
Elliott Hughes498cda62016-04-14 16:49:04 -07001022
Tao Baodb7e8982017-03-06 23:53:16 -08001023 ui->SetProgressType(RecoveryUI::DETERMINATE);
1024 ui->ShowProgress(1.0, 10.0);
1025 float fraction = 0.0;
1026 for (size_t i = 0; i < 100; ++i) {
1027 fraction += .01;
1028 ui->SetProgress(fraction);
1029 usleep(100000);
1030 }
1031
1032 ui->ShowText(true);
Elliott Hughes498cda62016-04-14 16:49:04 -07001033}
1034
Tao Baocdcf28f2016-01-13 15:05:20 -08001035// How long (in seconds) we wait for the fuse-provided package file to
1036// appear, before timing out.
1037#define SDCARD_INSTALL_TIMEOUT 10
1038
Tao Bao145d8612015-03-25 15:51:15 -07001039static int apply_from_sdcard(Device* device, bool* wipe_cache) {
Tao Bao682c34b2015-04-07 17:16:35 -07001040 modified_flash = true;
1041
Christian Poetzsch4ec58a42015-02-19 10:42:39 +00001042 if (ensure_path_mounted(SDCARD_ROOT) != 0) {
1043 ui->Print("\n-- Couldn't mount %s.\n", SDCARD_ROOT);
1044 return INSTALL_ERROR;
1045 }
1046
Tao Baoc4a18ef2017-02-10 00:13:30 -08001047 std::string path = browse_directory(SDCARD_ROOT, device);
1048 if (path.empty()) {
Elliott Hughes018ed312015-04-08 16:51:36 -07001049 ui->Print("\n-- No package file selected.\n");
caozhiyuanb4effb92015-06-10 16:46:38 +08001050 ensure_path_unmounted(SDCARD_ROOT);
Christian Poetzsch4ec58a42015-02-19 10:42:39 +00001051 return INSTALL_ERROR;
1052 }
1053
Tao Baoc4a18ef2017-02-10 00:13:30 -08001054 ui->Print("\n-- Install %s ...\n", path.c_str());
Christian Poetzsch4ec58a42015-02-19 10:42:39 +00001055 set_sdcard_update_bootloader_message();
Christian Poetzsch4ec58a42015-02-19 10:42:39 +00001056
Tao Baocdcf28f2016-01-13 15:05:20 -08001057 // We used to use fuse in a thread as opposed to a process. Since accessing
1058 // through fuse involves going from kernel to userspace to kernel, it leads
1059 // to deadlock when a page fault occurs. (Bug: 26313124)
1060 pid_t child;
1061 if ((child = fork()) == 0) {
Tao Baoc4a18ef2017-02-10 00:13:30 -08001062 bool status = start_sdcard_fuse(path.c_str());
Tao Baocdcf28f2016-01-13 15:05:20 -08001063
1064 _exit(status ? EXIT_SUCCESS : EXIT_FAILURE);
1065 }
1066
1067 // FUSE_SIDELOAD_HOST_PATHNAME will start to exist once the fuse in child
1068 // process is ready.
1069 int result = INSTALL_ERROR;
1070 int status;
1071 bool waited = false;
1072 for (int i = 0; i < SDCARD_INSTALL_TIMEOUT; ++i) {
1073 if (waitpid(child, &status, WNOHANG) == -1) {
1074 result = INSTALL_ERROR;
1075 waited = true;
1076 break;
1077 }
1078
1079 struct stat sb;
1080 if (stat(FUSE_SIDELOAD_HOST_PATHNAME, &sb) == -1) {
1081 if (errno == ENOENT && i < SDCARD_INSTALL_TIMEOUT-1) {
1082 sleep(1);
1083 continue;
1084 } else {
Tianjie Xu7b0ad9c2016-08-05 18:00:04 -07001085 LOG(ERROR) << "Timed out waiting for the fuse-provided package.";
Tao Baocdcf28f2016-01-13 15:05:20 -08001086 result = INSTALL_ERROR;
1087 kill(child, SIGKILL);
1088 break;
1089 }
1090 }
1091
Tao Bao641fa972018-04-25 18:59:40 -07001092 result = install_package(FUSE_SIDELOAD_HOST_PATHNAME, wipe_cache, false, 0 /*retry_count*/);
Tao Baocdcf28f2016-01-13 15:05:20 -08001093 break;
1094 }
Christian Poetzsch4ec58a42015-02-19 10:42:39 +00001095
Tao Baocdcf28f2016-01-13 15:05:20 -08001096 if (!waited) {
1097 // Calling stat() on this magic filename signals the fuse
1098 // filesystem to shut down.
1099 struct stat sb;
1100 stat(FUSE_SIDELOAD_HOST_EXIT_PATHNAME, &sb);
1101
1102 waitpid(child, &status, 0);
1103 }
1104
1105 if (!WIFEXITED(status) || WEXITSTATUS(status) != 0) {
Tianjie Xu7b0ad9c2016-08-05 18:00:04 -07001106 LOG(ERROR) << "Error exit from the fuse process: " << WEXITSTATUS(status);
Tao Baocdcf28f2016-01-13 15:05:20 -08001107 }
1108
Christian Poetzsch4ec58a42015-02-19 10:42:39 +00001109 ensure_path_unmounted(SDCARD_ROOT);
Tao Baocdcf28f2016-01-13 15:05:20 -08001110 return result;
Christian Poetzsch4ec58a42015-02-19 10:42:39 +00001111}
1112
Tao Bao50dd5322017-03-07 14:57:04 -08001113// Returns REBOOT, SHUTDOWN, or REBOOT_BOOTLOADER. Returning NO_ACTION means to take the default,
1114// which is to reboot or shutdown depending on if the --shutdown_after flag was passed to recovery.
1115static Device::BuiltinAction prompt_and_wait(Device* device, int status) {
1116 for (;;) {
1117 finish_recovery();
1118 switch (status) {
1119 case INSTALL_SUCCESS:
1120 case INSTALL_NONE:
1121 ui->SetBackground(RecoveryUI::NO_COMMAND);
1122 break;
Doug Zongker6c8553d2012-09-24 10:40:47 -07001123
Tao Bao50dd5322017-03-07 14:57:04 -08001124 case INSTALL_ERROR:
1125 case INSTALL_CORRUPT:
1126 ui->SetBackground(RecoveryUI::ERROR);
1127 break;
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -08001128 }
Tao Bao50dd5322017-03-07 14:57:04 -08001129 ui->SetProgressType(RecoveryUI::EMPTY);
1130
1131 int chosen_item = get_menu_selection(nullptr, device->GetMenuItems(), false, 0, device);
1132
1133 // Device-specific code may take some action here. It may return one of the core actions
1134 // handled in the switch statement below.
1135 Device::BuiltinAction chosen_action =
1136 (chosen_item == -1) ? Device::REBOOT : device->InvokeMenuItem(chosen_item);
1137
1138 bool should_wipe_cache = false;
1139 switch (chosen_action) {
1140 case Device::NO_ACTION:
1141 break;
1142
1143 case Device::REBOOT:
1144 case Device::SHUTDOWN:
1145 case Device::REBOOT_BOOTLOADER:
1146 return chosen_action;
1147
1148 case Device::WIPE_DATA:
1149 if (ui->IsTextVisible()) {
1150 if (ask_to_wipe_data(device)) {
1151 wipe_data(device);
1152 }
1153 } else {
1154 wipe_data(device);
1155 return Device::NO_ACTION;
1156 }
1157 break;
1158
1159 case Device::WIPE_CACHE:
1160 wipe_cache(ui->IsTextVisible(), device);
1161 if (!ui->IsTextVisible()) return Device::NO_ACTION;
1162 break;
1163
1164 case Device::APPLY_ADB_SIDELOAD:
1165 case Device::APPLY_SDCARD:
1166 {
1167 bool adb = (chosen_action == Device::APPLY_ADB_SIDELOAD);
1168 if (adb) {
Tao Bao641fa972018-04-25 18:59:40 -07001169 status = apply_from_adb(&should_wipe_cache);
Tao Bao50dd5322017-03-07 14:57:04 -08001170 } else {
1171 status = apply_from_sdcard(device, &should_wipe_cache);
1172 }
1173
1174 if (status == INSTALL_SUCCESS && should_wipe_cache) {
1175 if (!wipe_cache(false, device)) {
1176 status = INSTALL_ERROR;
1177 }
1178 }
1179
1180 if (status != INSTALL_SUCCESS) {
1181 ui->SetBackground(RecoveryUI::ERROR);
1182 ui->Print("Installation aborted.\n");
1183 copy_logs();
1184 } else if (!ui->IsTextVisible()) {
1185 return Device::NO_ACTION; // reboot if logs aren't visible
1186 } else {
1187 ui->Print("\nInstall from %s complete.\n", adb ? "ADB" : "SD card");
1188 }
1189 }
1190 break;
1191
1192 case Device::VIEW_RECOVERY_LOGS:
1193 choose_recovery_file(device);
1194 break;
1195
1196 case Device::RUN_GRAPHICS_TEST:
1197 run_graphics_test();
1198 break;
1199
Tianjie Xu29d55752017-09-20 17:53:46 -07001200 case Device::RUN_LOCALE_TEST: {
1201 ScreenRecoveryUI* screen_ui = static_cast<ScreenRecoveryUI*>(ui);
1202 screen_ui->CheckBackgroundTextImages(locale);
1203 break;
1204 }
Tao Bao50dd5322017-03-07 14:57:04 -08001205 case Device::MOUNT_SYSTEM:
1206 // For a system image built with the root directory (i.e. system_root_image == "true"), we
1207 // mount it to /system_root, and symlink /system to /system_root/system to make adb shell
1208 // work (the symlink is created through the build system). (Bug: 22855115)
1209 if (android::base::GetBoolProperty("ro.build.system_root_image", false)) {
1210 if (ensure_path_mounted_at("/", "/system_root") != -1) {
1211 ui->Print("Mounted /system.\n");
1212 }
1213 } else {
1214 if (ensure_path_mounted("/system") != -1) {
1215 ui->Print("Mounted /system.\n");
1216 }
1217 }
1218 break;
1219 }
1220 }
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -08001221}
1222
Tao Bao99f0d9e2016-10-13 12:46:38 -07001223static void print_property(const char* key, const char* name, void* /* cookie */) {
1224 printf("%s=%s\n", key, name);
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -08001225}
1226
Tao Baoac9d94d2016-11-03 11:37:15 -07001227static std::string load_locale_from_cache() {
1228 if (ensure_path_mounted(LOCALE_FILE) != 0) {
1229 LOG(ERROR) << "Can't mount " << LOCALE_FILE;
1230 return "";
Doug Zongker02ec6b82012-08-22 17:26:40 -07001231 }
Tao Baoac9d94d2016-11-03 11:37:15 -07001232
1233 std::string content;
1234 if (!android::base::ReadFileToString(LOCALE_FILE, &content)) {
1235 PLOG(ERROR) << "Can't read " << LOCALE_FILE;
1236 return "";
1237 }
1238
1239 return android::base::Trim(content);
Doug Zongker02ec6b82012-08-22 17:26:40 -07001240}
1241
Tao Baoac9d94d2016-11-03 11:37:15 -07001242void ui_print(const char* format, ...) {
1243 std::string buffer;
Doug Zongker7c3ae452013-05-14 11:03:02 -07001244 va_list ap;
1245 va_start(ap, format);
Tao Baoac9d94d2016-11-03 11:37:15 -07001246 android::base::StringAppendV(&buffer, format, ap);
Doug Zongker7c3ae452013-05-14 11:03:02 -07001247 va_end(ap);
1248
Tao Baoac9d94d2016-11-03 11:37:15 -07001249 if (ui != nullptr) {
1250 ui->Print("%s", buffer.c_str());
Doug Zongker7c3ae452013-05-14 11:03:02 -07001251 } else {
Tao Baoac9d94d2016-11-03 11:37:15 -07001252 fputs(buffer.c_str(), stdout);
Doug Zongker7c3ae452013-05-14 11:03:02 -07001253 }
1254}
1255
Tianjie Xu7b0ad9c2016-08-05 18:00:04 -07001256static constexpr char log_characters[] = "VDIWEF";
1257
Tao Bao99f0d9e2016-10-13 12:46:38 -07001258void UiLogger(android::base::LogId /* id */, android::base::LogSeverity severity,
1259 const char* /* tag */, const char* /* file */, unsigned int /* line */,
1260 const char* message) {
1261 if (severity >= android::base::ERROR && ui != nullptr) {
1262 ui->Print("E:%s\n", message);
1263 } else {
1264 fprintf(stdout, "%c:%s\n", log_characters[severity], message);
1265 }
Tianjie Xu7b0ad9c2016-08-05 18:00:04 -07001266}
1267
Yabin Cui99281df2016-02-17 12:21:52 -08001268static bool is_battery_ok() {
1269 struct healthd_config healthd_config = {
1270 .batteryStatusPath = android::String8(android::String8::kEmptyString),
1271 .batteryHealthPath = android::String8(android::String8::kEmptyString),
1272 .batteryPresentPath = android::String8(android::String8::kEmptyString),
1273 .batteryCapacityPath = android::String8(android::String8::kEmptyString),
1274 .batteryVoltagePath = android::String8(android::String8::kEmptyString),
1275 .batteryTemperaturePath = android::String8(android::String8::kEmptyString),
1276 .batteryTechnologyPath = android::String8(android::String8::kEmptyString),
1277 .batteryCurrentNowPath = android::String8(android::String8::kEmptyString),
1278 .batteryCurrentAvgPath = android::String8(android::String8::kEmptyString),
1279 .batteryChargeCounterPath = android::String8(android::String8::kEmptyString),
1280 .batteryFullChargePath = android::String8(android::String8::kEmptyString),
1281 .batteryCycleCountPath = android::String8(android::String8::kEmptyString),
1282 .energyCounter = NULL,
1283 .boot_min_cap = 0,
1284 .screen_on = NULL
1285 };
1286 healthd_board_init(&healthd_config);
1287
1288 android::BatteryMonitor monitor;
1289 monitor.init(&healthd_config);
1290
1291 int wait_second = 0;
1292 while (true) {
1293 int charge_status = monitor.getChargeStatus();
1294 // Treat unknown status as charged.
1295 bool charged = (charge_status != android::BATTERY_STATUS_DISCHARGING &&
1296 charge_status != android::BATTERY_STATUS_NOT_CHARGING);
1297 android::BatteryProperty capacity;
1298 android::status_t status = monitor.getProperty(android::BATTERY_PROP_CAPACITY, &capacity);
1299 ui_print("charge_status %d, charged %d, status %d, capacity %lld\n", charge_status,
1300 charged, status, capacity.valueInt64);
1301 // At startup, the battery drivers in devices like N5X/N6P take some time to load
1302 // the battery profile. Before the load finishes, it reports value 50 as a fake
1303 // capacity. BATTERY_READ_TIMEOUT_IN_SEC is set that the battery drivers are expected
1304 // to finish loading the battery profile earlier than 10 seconds after kernel startup.
1305 if (status == 0 && capacity.valueInt64 == 50) {
1306 if (wait_second < BATTERY_READ_TIMEOUT_IN_SEC) {
1307 sleep(1);
1308 wait_second++;
1309 continue;
1310 }
1311 }
1312 // If we can't read battery percentage, it may be a device without battery. In this
1313 // situation, use 100 as a fake battery percentage.
1314 if (status != 0) {
1315 capacity.valueInt64 = 100;
1316 }
1317 return (charged && capacity.valueInt64 >= BATTERY_WITH_CHARGER_OK_PERCENTAGE) ||
1318 (!charged && capacity.valueInt64 >= BATTERY_OK_PERCENTAGE);
1319 }
1320}
1321
Tianjie Xu99b73be2017-11-28 17:23:06 -08001322// Set the retry count to |retry_count| in BCB.
Tianjie Xu72449c92017-05-16 18:07:31 -07001323static void set_retry_bootloader_message(int retry_count, const std::vector<std::string>& args) {
1324 std::vector<std::string> options;
1325 for (const auto& arg : args) {
1326 if (!android::base::StartsWith(arg, "--retry_count")) {
1327 options.push_back(arg);
Tianjie Xu3c62b672016-02-05 18:25:58 -08001328 }
Tianjie Xu72449c92017-05-16 18:07:31 -07001329 }
Tianjie Xu3c62b672016-02-05 18:25:58 -08001330
Tianjie Xu99b73be2017-11-28 17:23:06 -08001331 // Update the retry counter in BCB.
1332 options.push_back(android::base::StringPrintf("--retry_count=%d", retry_count));
Tianjie Xu72449c92017-05-16 18:07:31 -07001333 std::string err;
1334 if (!update_bootloader_message(options, &err)) {
1335 LOG(ERROR) << err;
1336 }
Tianjie Xu3c62b672016-02-05 18:25:58 -08001337}
1338
Tianjie Xu06e57ac2016-07-11 14:04:08 -07001339static bool bootreason_in_blacklist() {
Tao Baoefc35592017-01-08 22:45:47 -08001340 std::string bootreason = android::base::GetProperty("ro.boot.bootreason", "");
1341 if (!bootreason.empty()) {
1342 for (const auto& str : bootreason_blacklist) {
1343 if (strcasecmp(str.c_str(), bootreason.c_str()) == 0) {
1344 return true;
1345 }
Tianjie Xu06e57ac2016-07-11 14:04:08 -07001346 }
Tao Baoefc35592017-01-08 22:45:47 -08001347 }
1348 return false;
Tianjie Xu06e57ac2016-07-11 14:04:08 -07001349}
1350
Tao Bao641fa972018-04-25 18:59:40 -07001351static void log_failure_code(ErrorCode code, const std::string& update_package) {
1352 std::vector<std::string> log_buffer = {
1353 update_package,
1354 "0", // install result
1355 "error: " + std::to_string(code),
1356 };
1357 std::string log_content = android::base::Join(log_buffer, "\n");
1358 const std::string& install_file = Paths::Get().temporary_install_file();
1359 if (!android::base::WriteStringToFile(log_content, install_file)) {
1360 PLOG(ERROR) << "Failed to write " << install_file;
1361 }
Tianjie Xu06e57ac2016-07-11 14:04:08 -07001362
Tao Bao641fa972018-04-25 18:59:40 -07001363 // Also write the info into last_log.
1364 LOG(INFO) << log_content;
Tianjie Xu06e57ac2016-07-11 14:04:08 -07001365}
1366
Yabin Cui99281df2016-02-17 12:21:52 -08001367int main(int argc, char **argv) {
Tianjie Xu99b73be2017-11-28 17:23:06 -08001368 // We don't have logcat yet under recovery; so we'll print error on screen and
1369 // log to stdout (which is redirected to recovery.log) as we used to do.
1370 android::base::InitLogging(argv, &UiLogger);
Tianjie Xu7b0ad9c2016-08-05 18:00:04 -07001371
Tianjie Xu99b73be2017-11-28 17:23:06 -08001372 // Take last pmsg contents and rewrite it to the current pmsg session.
1373 static const char filter[] = "recovery/";
1374 // Do we need to rotate?
1375 bool doRotate = false;
Tianjie Xue113e4d2016-10-21 17:46:13 -07001376
Tianjie Xu99b73be2017-11-28 17:23:06 -08001377 __android_log_pmsg_file_read(LOG_ID_SYSTEM, ANDROID_LOG_INFO, filter, logbasename, &doRotate);
1378 // Take action to refresh pmsg contents
1379 __android_log_pmsg_file_read(LOG_ID_SYSTEM, ANDROID_LOG_INFO, filter, logrotate, &doRotate);
Mark Salyzyna4f701a2016-03-09 14:58:16 -08001380
Tianjie Xu99b73be2017-11-28 17:23:06 -08001381 // If this binary is started with the single argument "--adbd",
1382 // instead of being the normal recovery binary, it turns into kind
1383 // of a stripped-down version of adbd that only supports the
1384 // 'sideload' command. Note this must be a real argument, not
1385 // anything in the command file or bootloader control block; the
1386 // only way recovery should be run with this argument is when it
1387 // starts a copy of itself from the apply_from_adb() function.
1388 if (argc == 2 && strcmp(argv[1], "--adbd") == 0) {
1389 minadbd_main();
1390 return 0;
1391 }
1392
1393 time_t start = time(nullptr);
1394
1395 // redirect_stdio should be called only in non-sideload mode. Otherwise
1396 // we may have two logger instances with different timestamps.
Tao Bao641fa972018-04-25 18:59:40 -07001397 redirect_stdio(Paths::Get().temporary_log_file().c_str());
Tianjie Xu99b73be2017-11-28 17:23:06 -08001398
1399 printf("Starting recovery (pid %d) on %s", getpid(), ctime(&start));
1400
1401 load_volume_table();
1402 has_cache = volume_for_mount_point(CACHE_ROOT) != nullptr;
1403
1404 std::vector<std::string> args = get_args(argc, argv);
1405 std::vector<char*> args_to_parse(args.size());
1406 std::transform(args.cbegin(), args.cend(), args_to_parse.begin(),
1407 [](const std::string& arg) { return const_cast<char*>(arg.c_str()); });
1408
1409 const char* update_package = nullptr;
1410 bool should_wipe_data = false;
1411 bool should_prompt_and_wipe_data = false;
1412 bool should_wipe_cache = false;
1413 bool should_wipe_ab = false;
1414 size_t wipe_package_size = 0;
1415 bool show_text = false;
1416 bool sideload = false;
1417 bool sideload_auto_reboot = false;
1418 bool just_exit = false;
1419 bool shutdown_after = false;
1420 int retry_count = 0;
1421 bool security_update = false;
1422
1423 int arg;
1424 int option_index;
1425 while ((arg = getopt_long(args_to_parse.size(), args_to_parse.data(), "", OPTIONS,
1426 &option_index)) != -1) {
1427 switch (arg) {
1428 case 'n':
1429 android::base::ParseInt(optarg, &retry_count, 0);
1430 break;
1431 case 'u':
1432 update_package = optarg;
1433 break;
1434 case 'w':
1435 should_wipe_data = true;
1436 break;
1437 case 'c':
1438 should_wipe_cache = true;
1439 break;
1440 case 't':
1441 show_text = true;
1442 break;
1443 case 's':
1444 sideload = true;
1445 break;
1446 case 'a':
1447 sideload = true;
1448 sideload_auto_reboot = true;
1449 break;
1450 case 'x':
1451 just_exit = true;
1452 break;
1453 case 'l':
1454 locale = optarg;
1455 break;
1456 case 'p':
1457 shutdown_after = true;
1458 break;
1459 case 'r':
1460 reason = optarg;
1461 break;
1462 case 'e':
1463 security_update = true;
1464 break;
1465 case 0: {
1466 std::string option = OPTIONS[option_index].name;
1467 if (option == "wipe_ab") {
1468 should_wipe_ab = true;
1469 } else if (option == "wipe_package_size") {
1470 android::base::ParseUint(optarg, &wipe_package_size);
1471 } else if (option == "prompt_and_wipe_data") {
1472 should_prompt_and_wipe_data = true;
1473 }
1474 break;
1475 }
1476 case '?':
1477 LOG(ERROR) << "Invalid command argument";
1478 continue;
Doug Zongker9270a202012-01-09 15:16:13 -08001479 }
Tianjie Xu99b73be2017-11-28 17:23:06 -08001480 }
Doug Zongker9270a202012-01-09 15:16:13 -08001481
Tianjie Xu99b73be2017-11-28 17:23:06 -08001482 if (locale.empty()) {
1483 if (has_cache) {
1484 locale = load_locale_from_cache();
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -08001485 }
1486
Tao Baoac9d94d2016-11-03 11:37:15 -07001487 if (locale.empty()) {
Tianjie Xu99b73be2017-11-28 17:23:06 -08001488 locale = DEFAULT_LOCALE;
Doug Zongker02ec6b82012-08-22 17:26:40 -07001489 }
Tianjie Xu99b73be2017-11-28 17:23:06 -08001490 }
Tao Baoac9d94d2016-11-03 11:37:15 -07001491
Tianjie Xu99b73be2017-11-28 17:23:06 -08001492 printf("locale is [%s]\n", locale.c_str());
1493 printf("stage is [%s]\n", stage.c_str());
1494 printf("reason is [%s]\n", reason);
Doug Zongker02ec6b82012-08-22 17:26:40 -07001495
Tianjie Xu99b73be2017-11-28 17:23:06 -08001496 Device* device = make_device();
1497 if (android::base::GetBoolProperty("ro.boot.quiescent", false)) {
1498 printf("Quiescent recovery mode.\n");
1499 ui = new StubRecoveryUI();
1500 } else {
1501 ui = device->GetUI();
1502
1503 if (!ui->Init(locale)) {
1504 printf("Failed to initialize UI, use stub UI instead.\n");
1505 ui = new StubRecoveryUI();
1506 }
1507 }
1508
1509 // Set background string to "installing security update" for security update,
1510 // otherwise set it to "installing system update".
1511 ui->SetSystemUpdateText(security_update);
1512
1513 int st_cur, st_max;
1514 if (!stage.empty() && sscanf(stage.c_str(), "%d/%d", &st_cur, &st_max) == 2) {
1515 ui->SetStage(st_cur, st_max);
1516 }
1517
1518 ui->SetBackground(RecoveryUI::NONE);
1519 if (show_text) ui->ShowText(true);
1520
1521 sehandle = selinux_android_file_context_handle();
1522 selinux_android_set_sehandle(sehandle);
1523 if (!sehandle) {
1524 ui->Print("Warning: No file_contexts\n");
1525 }
1526
1527 device->StartRecovery();
1528
1529 printf("Command:");
1530 for (const auto& arg : args) {
1531 printf(" \"%s\"", arg.c_str());
1532 }
1533 printf("\n\n");
1534
1535 property_list(print_property, nullptr);
1536 printf("\n");
1537
1538 ui->Print("Supported API: %d\n", kRecoveryApiVersion);
1539
1540 int status = INSTALL_SUCCESS;
1541
1542 if (update_package != nullptr) {
1543 // It's not entirely true that we will modify the flash. But we want
1544 // to log the update attempt since update_package is non-NULL.
1545 modified_flash = true;
1546
Tianjie Xua6f49bd2018-03-26 14:32:11 -07001547 if (retry_count == 0 && !is_battery_ok()) {
Tianjie Xu99b73be2017-11-28 17:23:06 -08001548 ui->Print("battery capacity is not enough for installing package, needed is %d%%\n",
1549 BATTERY_OK_PERCENTAGE);
1550 // Log the error code to last_install when installation skips due to
1551 // low battery.
1552 log_failure_code(kLowBattery, update_package);
1553 status = INSTALL_SKIPPED;
Tianjie Xua6f49bd2018-03-26 14:32:11 -07001554 } else if (retry_count == 0 && bootreason_in_blacklist()) {
Tianjie Xu99b73be2017-11-28 17:23:06 -08001555 // Skip update-on-reboot when bootreason is kernel_panic or similar
1556 ui->Print("bootreason is in the blacklist; skip OTA installation\n");
1557 log_failure_code(kBootreasonInBlacklist, update_package);
1558 status = INSTALL_SKIPPED;
Dmitri Plotnikov8706a982017-04-18 08:28:26 -07001559 } else {
Tianjie Xu99b73be2017-11-28 17:23:06 -08001560 // It's a fresh update. Initialize the retry_count in the BCB to 1; therefore we can later
1561 // identify the interrupted update due to unexpected reboots.
1562 if (retry_count == 0) {
1563 set_retry_bootloader_message(retry_count + 1, args);
Tao Bao7022f332017-07-25 09:52:36 -07001564 }
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -08001565
Tao Bao641fa972018-04-25 18:59:40 -07001566 status = install_package(update_package, &should_wipe_cache, true, retry_count);
Tianjie Xu99b73be2017-11-28 17:23:06 -08001567 if (status == INSTALL_SUCCESS && should_wipe_cache) {
1568 wipe_cache(false, device);
1569 }
1570 if (status != INSTALL_SUCCESS) {
1571 ui->Print("Installation aborted.\n");
1572 // When I/O error happens, reboot and retry installation RETRY_LIMIT
1573 // times before we abandon this OTA update.
1574 if (status == INSTALL_RETRY && retry_count < RETRY_LIMIT) {
1575 copy_logs();
1576 retry_count += 1;
1577 set_retry_bootloader_message(retry_count, args);
1578 // Print retry count on screen.
1579 ui->Print("Retry attempt %d\n", retry_count);
1580
1581 // Reboot and retry the update
1582 if (!reboot("reboot,recovery")) {
1583 ui->Print("Reboot failed\n");
1584 } else {
1585 while (true) {
1586 pause();
1587 }
1588 }
Tianjie Xud9d16292017-04-20 18:08:21 -07001589 }
Tianjie Xu99b73be2017-11-28 17:23:06 -08001590 // If this is an eng or userdebug build, then automatically
1591 // turn the text display on if the script fails so the error
1592 // message is visible.
1593 if (is_ro_debuggable()) {
1594 ui->ShowText(true);
Tao Baoc679f932015-03-30 09:43:49 -07001595 }
Tianjie Xu99b73be2017-11-28 17:23:06 -08001596 }
Doug Zongker8674a722010-09-15 11:08:23 -07001597 }
Tianjie Xu99b73be2017-11-28 17:23:06 -08001598 } else if (should_wipe_data) {
1599 if (!wipe_data(device)) {
1600 status = INSTALL_ERROR;
Doug Zongkerb1d12632014-03-18 10:32:12 -07001601 }
Tianjie Xu99b73be2017-11-28 17:23:06 -08001602 } else if (should_prompt_and_wipe_data) {
1603 ui->ShowText(true);
1604 ui->SetBackground(RecoveryUI::ERROR);
1605 if (!prompt_and_wipe_data(device)) {
1606 status = INSTALL_ERROR;
Tao Bao75238632015-05-27 14:46:17 -07001607 }
Tianjie Xu99b73be2017-11-28 17:23:06 -08001608 ui->ShowText(false);
1609 } else if (should_wipe_cache) {
1610 if (!wipe_cache(false, device)) {
1611 status = INSTALL_ERROR;
1612 }
1613 } else if (should_wipe_ab) {
1614 if (!wipe_ab_device(wipe_package_size)) {
1615 status = INSTALL_ERROR;
1616 }
1617 } else if (sideload) {
1618 // 'adb reboot sideload' acts the same as user presses key combinations
1619 // to enter the sideload mode. When 'sideload-auto-reboot' is used, text
1620 // display will NOT be turned on by default. And it will reboot after
1621 // sideload finishes even if there are errors. Unless one turns on the
1622 // text display during the installation. This is to enable automated
1623 // testing.
1624 if (!sideload_auto_reboot) {
1625 ui->ShowText(true);
1626 }
Tao Bao641fa972018-04-25 18:59:40 -07001627 status = apply_from_adb(&should_wipe_cache);
Tianjie Xu99b73be2017-11-28 17:23:06 -08001628 if (status == INSTALL_SUCCESS && should_wipe_cache) {
1629 if (!wipe_cache(false, device)) {
1630 status = INSTALL_ERROR;
1631 }
1632 }
1633 ui->Print("\nInstall from ADB complete (status: %d).\n", status);
1634 if (sideload_auto_reboot) {
1635 ui->Print("Rebooting automatically.\n");
1636 }
1637 } else if (!just_exit) {
1638 // If this is an eng or userdebug build, automatically turn on the text display if no command
1639 // is specified. Note that this should be called before setting the background to avoid
1640 // flickering the background image.
1641 if (is_ro_debuggable()) {
1642 ui->ShowText(true);
1643 }
1644 status = INSTALL_NONE; // No command specified
1645 ui->SetBackground(RecoveryUI::NO_COMMAND);
1646 }
1647
1648 if (status == INSTALL_ERROR || status == INSTALL_CORRUPT) {
1649 ui->SetBackground(RecoveryUI::ERROR);
1650 if (!ui->IsTextVisible()) {
1651 sleep(5);
1652 }
1653 }
1654
1655 Device::BuiltinAction after = shutdown_after ? Device::SHUTDOWN : Device::REBOOT;
1656 // 1. If the recovery menu is visible, prompt and wait for commands.
1657 // 2. If the state is INSTALL_NONE, wait for commands. (i.e. In user build, manually reboot into
1658 // recovery to sideload a package.)
1659 // 3. sideload_auto_reboot is an option only available in user-debug build, reboot the device
1660 // without waiting.
1661 // 4. In all other cases, reboot the device. Therefore, normal users will observe the device
1662 // reboot after it shows the "error" screen for 5s.
1663 if ((status == INSTALL_NONE && !sideload_auto_reboot) || ui->IsTextVisible()) {
1664 Device::BuiltinAction temp = prompt_and_wait(device, status);
1665 if (temp != Device::NO_ACTION) {
1666 after = temp;
1667 }
1668 }
1669
1670 // Save logs and clean up before rebooting or shutting down.
1671 finish_recovery();
1672
1673 switch (after) {
1674 case Device::SHUTDOWN:
1675 ui->Print("Shutting down...\n");
1676 android::base::SetProperty(ANDROID_RB_PROPERTY, "shutdown,");
1677 break;
1678
1679 case Device::REBOOT_BOOTLOADER:
1680 ui->Print("Rebooting to bootloader...\n");
1681 android::base::SetProperty(ANDROID_RB_PROPERTY, "reboot,bootloader");
1682 break;
1683
1684 default:
1685 ui->Print("Rebooting...\n");
1686 reboot("reboot,");
1687 break;
1688 }
1689 while (true) {
1690 pause();
1691 }
1692 // Should be unreachable.
1693 return EXIT_SUCCESS;
The Android Open Source Projectc24a8e62009-03-03 19:28:42 -08001694}