blob: 0921d72ae7d1eed63be43ebab284ebfb09286ee6 [file] [log] [blame]
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -08001/*
2 * Copyright (C) 2008 The Android Open Source Project
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 * * Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * * Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in
Tsu Chiang Chuangee520552011-02-25 18:38:53 -080012 * the documentation and/or other materials provided with the
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -080013 * distribution.
14 *
15 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
16 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
17 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
18 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
19 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
20 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
21 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
Tsu Chiang Chuangee520552011-02-25 18:38:53 -080022 * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -080023 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
24 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
25 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26 * SUCH DAMAGE.
27 */
28
Tom Cherry9027af02018-09-24 15:48:09 -070029#include "fastboot.h"
30
Mark Salyzyn5957c1f2014-04-30 14:05:28 -070031#include <ctype.h>
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -080032#include <errno.h>
33#include <fcntl.h>
Colin Cross8879f982012-05-22 17:53:34 -070034#include <getopt.h>
Ying Wangcf86e2f2014-05-15 20:06:40 -070035#include <inttypes.h>
Mark Salyzyn5957c1f2014-04-30 14:05:28 -070036#include <limits.h>
Mark Salyzyn5957c1f2014-04-30 14:05:28 -070037#include <stdint.h>
38#include <stdio.h>
39#include <stdlib.h>
40#include <string.h>
41#include <sys/stat.h>
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -080042#include <sys/time.h>
Colin Crossf8387882012-05-24 17:18:41 -070043#include <sys/types.h>
Mark Salyzyn5957c1f2014-04-30 14:05:28 -070044#include <unistd.h>
David Pursell2ec418a2016-01-20 08:32:08 -080045
Elliott Hughes290a2282016-11-14 17:08:47 -080046#include <chrono>
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -070047#include <functional>
Tom Cherry4aa60b32018-09-05 15:11:44 -070048#include <regex>
David Anderson0c732342018-11-28 17:10:42 -080049#include <string>
Elliott Hughes290a2282016-11-14 17:08:47 -080050#include <thread>
Josh Gao9da9ac52016-01-19 14:50:18 -080051#include <utility>
52#include <vector>
Colin Crossf8387882012-05-24 17:18:41 -070053
Chin-Ting Kuodf6a7802019-09-16 11:23:55 +080054#include <android-base/endian.h>
Elliott Hughes82ff3152016-08-31 15:07:18 -070055#include <android-base/file.h>
Elliott Hughes749ae2d2016-06-28 14:48:45 -070056#include <android-base/macros.h>
Elliott Hughes4f713192015-12-04 22:00:26 -080057#include <android-base/parseint.h>
David Pursell2ec418a2016-01-20 08:32:08 -080058#include <android-base/parsenetaddress.h>
Elliott Hughes2810d002016-04-25 14:31:18 -070059#include <android-base/stringprintf.h>
Elliott Hughes4f713192015-12-04 22:00:26 -080060#include <android-base/strings.h>
Chris Fries0ea946c2017-04-12 10:25:57 -050061#include <android-base/unique_fd.h>
Dan Willemsenab971b52018-08-29 14:58:02 -070062#include <build/version.h>
Chin-Ting Kuodf6a7802019-09-16 11:23:55 +080063#include <libavb/libavb.h>
David Anderson89569642018-11-16 15:53:35 -080064#include <liblp/liblp.h>
Dan Willemsenab971b52018-08-29 14:58:02 -070065#include <platform_tools_version.h>
Colin Crossf8387882012-05-24 17:18:41 -070066#include <sparse/sparse.h>
Elliott Hughesd30ad8a2015-03-18 23:12:44 -070067#include <ziparchive/zip_archive.h>
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -080068
Elliott Hughes253c18d2015-03-18 22:47:09 -070069#include "bootimg_utils.h"
Mark Salyzyn8e7e9cb2018-08-29 10:44:33 -070070#include "constants.h"
Elliott Hughes1b708d32015-12-11 19:07:01 -080071#include "diagnose_usb.h"
Tom Cherry9027af02018-09-24 15:48:09 -070072#include "fastboot_driver.h"
Dmitry Grinberge6f3e9b2014-03-11 18:28:15 -070073#include "fs.h"
David Pursell2ec418a2016-01-20 08:32:08 -080074#include "tcp.h"
David Pursell0b156632015-10-30 11:22:01 -070075#include "transport.h"
David Pursell4601c972016-02-05 15:35:09 -080076#include "udp.h"
David Pursell0b156632015-10-30 11:22:01 -070077#include "usb.h"
Tom Cherry9027af02018-09-24 15:48:09 -070078#include "util.h"
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -080079
Tom Cherrydfd85df2018-09-20 14:45:05 -070080using android::base::ReadFully;
Tom Cherry4aa60b32018-09-05 15:11:44 -070081using android::base::Split;
82using android::base::Trim;
Chris Fries0ea946c2017-04-12 10:25:57 -050083using android::base::unique_fd;
David Anderson0c732342018-11-28 17:10:42 -080084using namespace std::string_literals;
Chris Fries0ea946c2017-04-12 10:25:57 -050085
David Pursell2ec418a2016-01-20 08:32:08 -080086static const char* serial = nullptr;
Elliott Hughes577e8b42018-04-05 16:12:47 -070087
Elliott Hughes577e8b42018-04-05 16:12:47 -070088static bool g_long_listing = false;
Chris Fries6a999712017-04-04 09:52:47 -050089// Don't resparse files in too-big chunks.
90// libsparse will support INT_MAX, but this results in large allocations, so
91// let's keep it at 1GB to avoid memory pressure on the host.
92static constexpr int64_t RESPARSE_LIMIT = 1 * 1024 * 1024 * 1024;
Elliott Hughes542370d2018-04-19 19:49:44 -070093static uint64_t sparse_limit = 0;
Colin Crossf8387882012-05-24 17:18:41 -070094static int64_t target_sparse_limit = -1;
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -080095
Elliott Hughes577e8b42018-04-05 16:12:47 -070096static unsigned g_base_addr = 0x10000000;
Hridya Valsaraju6c8fca62019-01-24 12:47:08 -080097static boot_img_hdr_v2 g_boot_img_hdr = {};
Elliott Hughes577e8b42018-04-05 16:12:47 -070098static std::string g_cmdline;
Hridya Valsaraju6c8fca62019-01-24 12:47:08 -080099static std::string g_dtb_path;
JP Abgrall7b8970c2013-03-07 17:06:41 -0800100
David Zeuthenb6ea4352017-08-07 14:29:26 -0400101static bool g_disable_verity = false;
102static bool g_disable_verification = false;
103
Paul Crowley8f7f56e2015-11-27 09:29:37 +0000104static const std::string convert_fbe_marker_filename("convert_fbe");
105
Tom Cherry9027af02018-09-24 15:48:09 -0700106fastboot::FastBootDriver* fb = nullptr;
107
Rom Lemarchand622810c2013-06-28 09:54:59 -0700108enum fb_buffer_type {
Chris Fries0ea946c2017-04-12 10:25:57 -0500109 FB_BUFFER_FD,
Rom Lemarchand622810c2013-06-28 09:54:59 -0700110 FB_BUFFER_SPARSE,
111};
112
113struct fastboot_buffer {
114 enum fb_buffer_type type;
Elliott Hughesfc797672015-04-07 20:12:50 -0700115 void* data;
116 int64_t sz;
Chris Fries0ea946c2017-04-12 10:25:57 -0500117 int fd;
David Anderson32e376f2018-08-16 13:43:11 -0700118 int64_t image_size;
Rom Lemarchand622810c2013-06-28 09:54:59 -0700119};
120
David Anderson0debda02018-08-28 13:54:03 -0700121enum class ImageType {
122 // Must be flashed for device to boot into the kernel.
123 BootCritical,
124 // Normal partition to be flashed during "flashall".
125 Normal,
126 // Partition that is never flashed during "flashall".
127 Extra
128};
129
David Anderson32e376f2018-08-16 13:43:11 -0700130struct Image {
Elliott Hughes45964a82017-05-03 22:43:23 -0700131 const char* nickname;
132 const char* img_name;
133 const char* sig_name;
134 const char* part_name;
Hridya Valsarajuf1f0a9c2018-08-02 10:46:21 -0700135 bool optional_if_no_image;
David Anderson0debda02018-08-28 13:54:03 -0700136 ImageType type;
Hridya Valsarajuf1f0a9c2018-08-02 10:46:21 -0700137 bool IsSecondary() const { return nickname == nullptr; }
David Anderson32e376f2018-08-16 13:43:11 -0700138};
139
140static Image images[] = {
Dario Frenic7ea1af2018-05-25 16:07:19 +0100141 // clang-format off
David Anderson0debda02018-08-28 13:54:03 -0700142 { "boot", "boot.img", "boot.sig", "boot", false, ImageType::BootCritical },
143 { nullptr, "boot_other.img", "boot.sig", "boot", true, ImageType::Normal },
144 { "cache", "cache.img", "cache.sig", "cache", true, ImageType::Extra },
145 { "dtbo", "dtbo.img", "dtbo.sig", "dtbo", true, ImageType::BootCritical },
146 { "dts", "dt.img", "dt.sig", "dts", true, ImageType::BootCritical },
Yifan Hong260b12b2020-08-10 17:48:23 -0700147 { "modules", "modules.img", "modules.sig", "modules", true, ImageType::Normal },
David Anderson0debda02018-08-28 13:54:03 -0700148 { "odm", "odm.img", "odm.sig", "odm", true, ImageType::Normal },
Yifan Hongbe78bb62020-07-15 17:07:11 -0700149 { "odm_dlkm", "odm_dlkm.img", "odm_dlkm.sig", "odm_dlkm", true, ImageType::Normal },
David Anderson0debda02018-08-28 13:54:03 -0700150 { "product", "product.img", "product.sig", "product", true, ImageType::Normal },
David Anderson0debda02018-08-28 13:54:03 -0700151 { "recovery", "recovery.img", "recovery.sig", "recovery", true, ImageType::BootCritical },
152 { "super", "super.img", "super.sig", "super", true, ImageType::Extra },
153 { "system", "system.img", "system.sig", "system", false, ImageType::Normal },
Justin Yun5d0ac622019-06-26 09:18:03 +0900154 { "system_ext",
155 "system_ext.img", "system_ext.sig",
156 "system_ext",
157 true, ImageType::Normal },
David Anderson0debda02018-08-28 13:54:03 -0700158 { nullptr, "system_other.img", "system.sig", "system", true, ImageType::Normal },
159 { "userdata", "userdata.img", "userdata.sig", "userdata", true, ImageType::Extra },
160 { "vbmeta", "vbmeta.img", "vbmeta.sig", "vbmeta", true, ImageType::BootCritical },
David Anderson166bfef2018-10-15 14:46:59 -0700161 { "vbmeta_system",
162 "vbmeta_system.img",
163 "vbmeta_system.sig",
164 "vbmeta_system",
David Anderson1109c922018-09-17 17:32:54 -0700165 true, ImageType::BootCritical },
David Anderson0debda02018-08-28 13:54:03 -0700166 { "vendor", "vendor.img", "vendor.sig", "vendor", true, ImageType::Normal },
Steve Muckle36112432019-08-21 11:16:14 -0700167 { "vendor_boot",
168 "vendor_boot.img", "vendor_boot.sig",
169 "vendor_boot",
170 true, ImageType::BootCritical },
Yifan Hong6b1c15c2020-05-12 10:38:53 -0700171 { "vendor_dlkm",
172 "vendor_dlkm.img", "vendor_dlkm.sig",
173 "vendor_dlkm",
174 true, ImageType::Normal },
David Anderson0debda02018-08-28 13:54:03 -0700175 { nullptr, "vendor_other.img", "vendor.sig", "vendor", true, ImageType::Normal },
Dario Frenic7ea1af2018-05-25 16:07:19 +0100176 // clang-format on
Rom Lemarchand622810c2013-06-28 09:54:59 -0700177};
Brian Swetland2a63bb72009-04-28 16:05:07 -0700178
David Andersone0e693c2018-11-27 20:19:26 -0800179static char* get_android_product_out() {
Elliott Hughes45964a82017-05-03 22:43:23 -0700180 char* dir = getenv("ANDROID_PRODUCT_OUT");
Alex Lightbb9b8a52016-06-29 09:26:44 -0700181 if (dir == nullptr || dir[0] == '\0') {
David Andersone0e693c2018-11-27 20:19:26 -0800182 return nullptr;
183 }
184 return dir;
185}
186
187static std::string find_item_given_name(const std::string& img_name) {
188 char* dir = get_android_product_out();
189 if (!dir) {
Elliott Hughes45964a82017-05-03 22:43:23 -0700190 die("ANDROID_PRODUCT_OUT not set");
Alex Lightbb9b8a52016-06-29 09:26:44 -0700191 }
David Anderson0debda02018-08-28 13:54:03 -0700192 return std::string(dir) + "/" + img_name;
Alex Lightbb9b8a52016-06-29 09:26:44 -0700193}
194
Elliott Hughes29d5d7d2017-05-11 15:05:13 -0700195static std::string find_item(const std::string& item) {
Elliott Hughes45964a82017-05-03 22:43:23 -0700196 for (size_t i = 0; i < arraysize(images); ++i) {
Elliott Hughesd6365a72017-05-08 18:04:49 -0700197 if (images[i].nickname && item == images[i].nickname) {
Elliott Hughes45964a82017-05-03 22:43:23 -0700198 return find_item_given_name(images[i].img_name);
199 }
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800200 }
201
Elliott Hughesd6365a72017-05-08 18:04:49 -0700202 fprintf(stderr, "unknown partition '%s'\n", item.c_str());
Elliott Hughes45964a82017-05-03 22:43:23 -0700203 return "";
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800204}
205
Tom Cherry9027af02018-09-24 15:48:09 -0700206double last_start_time;
207
208static void Status(const std::string& message) {
Tom Cherry2217c502020-06-10 09:29:25 -0700209 if (!message.empty()) {
210 static constexpr char kStatusFormat[] = "%-50s ";
211 fprintf(stderr, kStatusFormat, message.c_str());
212 }
Tom Cherry9027af02018-09-24 15:48:09 -0700213 last_start_time = now();
214}
215
216static void Epilog(int status) {
217 if (status) {
218 fprintf(stderr, "FAILED (%s)\n", fb->Error().c_str());
219 die("Command failed");
220 } else {
221 double split = now();
222 fprintf(stderr, "OKAY [%7.3fs]\n", (split - last_start_time));
223 }
224}
225
226static void InfoMessage(const std::string& info) {
227 fprintf(stderr, "(bootloader) %s\n", info.c_str());
228}
229
Elliott Hughesfc797672015-04-07 20:12:50 -0700230static int64_t get_file_size(int fd) {
231 struct stat sb;
Tom Cherrydfd85df2018-09-20 14:45:05 -0700232 if (fstat(fd, &sb) == -1) {
233 die("could not get file size");
234 }
235 return sb.st_size;
Colin Crossf8387882012-05-24 17:18:41 -0700236}
237
Tom Cherrydfd85df2018-09-20 14:45:05 -0700238bool ReadFileToVector(const std::string& file, std::vector<char>* out) {
239 out->clear();
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800240
Tom Cherrydfd85df2018-09-20 14:45:05 -0700241 unique_fd fd(TEMP_FAILURE_RETRY(open(file.c_str(), O_RDONLY | O_CLOEXEC | O_BINARY)));
242 if (fd == -1) {
243 return false;
Rom Lemarchand622810c2013-06-28 09:54:59 -0700244 }
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800245
Tom Cherrydfd85df2018-09-20 14:45:05 -0700246 out->resize(get_file_size(fd));
247 return ReadFully(fd, out->data(), out->size());
Rom Lemarchand622810c2013-06-28 09:54:59 -0700248}
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800249
Elliott Hughesfc797672015-04-07 20:12:50 -0700250static int match_fastboot_with_serial(usb_ifc_info* info, const char* local_serial) {
Elliott Hughese1746fd2015-08-10 15:30:54 -0700251 if (info->ifc_class != 0xff || info->ifc_subclass != 0x42 || info->ifc_protocol != 0x03) {
252 return -1;
253 }
254
Scott Anderson13081c62012-04-06 12:39:30 -0700255 // require matching serial number or device path if requested
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800256 // at the command line with the -s option.
JP Abgralla032ded2012-06-06 11:53:33 -0700257 if (local_serial && (strcmp(local_serial, info->serial_number) != 0 &&
258 strcmp(local_serial, info->device_path) != 0)) return -1;
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800259 return 0;
260}
261
Elliott Hughesfc797672015-04-07 20:12:50 -0700262static int match_fastboot(usb_ifc_info* info) {
JP Abgrall7b8970c2013-03-07 17:06:41 -0800263 return match_fastboot_with_serial(info, serial);
264}
265
Elliott Hughesfc797672015-04-07 20:12:50 -0700266static int list_devices_callback(usb_ifc_info* info) {
267 if (match_fastboot_with_serial(info, nullptr) == 0) {
Elliott Hughes1b708d32015-12-11 19:07:01 -0800268 std::string serial = info->serial_number;
David Anderson4e058ca2020-05-28 04:39:37 +0000269 std::string interface = info->interface;
270 if (interface.empty()) {
271 interface = "fastboot";
272 }
Elliott Hughesb4add9b2009-10-06 18:07:49 -0700273 if (!info->writable) {
Elliott Hughes1b708d32015-12-11 19:07:01 -0800274 serial = UsbNoPermissionsShortHelpText();
Elliott Hughesb4add9b2009-10-06 18:07:49 -0700275 }
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800276 if (!serial[0]) {
277 serial = "????????????";
278 }
Scott Anderson866b1bd2012-06-04 20:29:11 -0700279 // output compatible with "adb devices"
Elliott Hughes577e8b42018-04-05 16:12:47 -0700280 if (!g_long_listing) {
David Anderson4e058ca2020-05-28 04:39:37 +0000281 printf("%s\t%s", serial.c_str(), interface.c_str());
Scott Anderson13081c62012-04-06 12:39:30 -0700282 } else {
David Anderson4e058ca2020-05-28 04:39:37 +0000283 printf("%-22s %s", serial.c_str(), interface.c_str());
Elliott Hughes1b708d32015-12-11 19:07:01 -0800284 if (strlen(info->device_path) > 0) printf(" %s", info->device_path);
Scott Anderson13081c62012-04-06 12:39:30 -0700285 }
Elliott Hughes1b708d32015-12-11 19:07:01 -0800286 putchar('\n');
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800287 }
288
289 return -1;
290}
291
David Pursell2ec418a2016-01-20 08:32:08 -0800292// Opens a new Transport connected to a device. If |serial| is non-null it will be used to identify
293// a specific device, otherwise the first USB device found will be used.
294//
Elliott Hughes855cdf82018-04-02 14:24:03 -0700295// If |serial| is non-null but invalid, this exits.
David Pursell2ec418a2016-01-20 08:32:08 -0800296// Otherwise it blocks until the target is available.
297//
298// The returned Transport is a singleton, so multiple calls to this function will return the same
299// object, and the caller should not attempt to delete the returned Transport.
David Pursell0b156632015-10-30 11:22:01 -0700300static Transport* open_device() {
David Pursell2ec418a2016-01-20 08:32:08 -0800301 bool announce = true;
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800302
David Pursell4601c972016-02-05 15:35:09 -0800303 Socket::Protocol protocol = Socket::Protocol::kTcp;
David Pursell2ec418a2016-01-20 08:32:08 -0800304 std::string host;
David Pursell4601c972016-02-05 15:35:09 -0800305 int port = 0;
306 if (serial != nullptr) {
307 const char* net_address = nullptr;
David Pursell2ec418a2016-01-20 08:32:08 -0800308
David Pursell4601c972016-02-05 15:35:09 -0800309 if (android::base::StartsWith(serial, "tcp:")) {
310 protocol = Socket::Protocol::kTcp;
311 port = tcp::kDefaultPort;
312 net_address = serial + strlen("tcp:");
313 } else if (android::base::StartsWith(serial, "udp:")) {
314 protocol = Socket::Protocol::kUdp;
315 port = udp::kDefaultPort;
316 net_address = serial + strlen("udp:");
317 }
318
319 if (net_address != nullptr) {
320 std::string error;
321 if (!android::base::ParseNetAddress(net_address, &host, &port, nullptr, &error)) {
Elliott Hughes855cdf82018-04-02 14:24:03 -0700322 die("invalid network address '%s': %s\n", net_address, error.c_str());
David Pursell4601c972016-02-05 15:35:09 -0800323 }
David Pursell2ec418a2016-01-20 08:32:08 -0800324 }
325 }
326
David Anderson1d887432018-08-27 16:47:32 -0700327 Transport* transport = nullptr;
David Pursell2ec418a2016-01-20 08:32:08 -0800328 while (true) {
329 if (!host.empty()) {
330 std::string error;
David Pursell4601c972016-02-05 15:35:09 -0800331 if (protocol == Socket::Protocol::kTcp) {
332 transport = tcp::Connect(host, port, &error).release();
333 } else if (protocol == Socket::Protocol::kUdp) {
334 transport = udp::Connect(host, port, &error).release();
335 }
336
David Pursell2ec418a2016-01-20 08:32:08 -0800337 if (transport == nullptr && announce) {
338 fprintf(stderr, "error: %s\n", error.c_str());
339 }
340 } else {
341 transport = usb_open(match_fastboot);
342 }
343
344 if (transport != nullptr) {
345 return transport;
346 }
347
David Pursell0b156632015-10-30 11:22:01 -0700348 if (announce) {
David Pursell2ec418a2016-01-20 08:32:08 -0800349 announce = false;
Elliott Hughesb46964f2015-08-19 17:49:45 -0700350 fprintf(stderr, "< waiting for %s >\n", serial ? serial : "any device");
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800351 }
Elliott Hughes290a2282016-11-14 17:08:47 -0800352 std::this_thread::sleep_for(std::chrono::milliseconds(1));
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800353 }
354}
355
Elliott Hughesfc797672015-04-07 20:12:50 -0700356static void list_devices() {
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800357 // We don't actually open a USB device here,
358 // just getting our callback called so we can
359 // list all the connected devices.
360 usb_open(list_devices_callback);
361}
362
Elliott Hughesd6365a72017-05-08 18:04:49 -0700363static void syntax_error(const char* fmt, ...) {
364 fprintf(stderr, "fastboot: usage: ");
365
366 va_list ap;
367 va_start(ap, fmt);
368 vfprintf(stderr, fmt, ap);
369 va_end(ap);
370
371 fprintf(stderr, "\n");
372 exit(1);
373}
374
375static int show_help() {
376 // clang-format off
377 fprintf(stdout,
Elliott Hughes07fc6822018-05-24 16:36:05 -0700378// 1 2 3 4 5 6 7 8
379// 12345678901234567890123456789012345678901234567890123456789012345678901234567890
Elliott Hughesb76188f2018-04-03 13:30:18 -0700380 "usage: fastboot [OPTION...] COMMAND...\n"
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800381 "\n"
Elliott Hughesb76188f2018-04-03 13:30:18 -0700382 "flashing:\n"
383 " update ZIP Flash all partitions from an update.zip package.\n"
384 " flashall Flash all partitions from $ANDROID_PRODUCT_OUT.\n"
385 " On A/B devices, flashed slot is set as active.\n"
386 " Secondary images may be flashed to inactive slot.\n"
Elliott Hughes07fc6822018-05-24 16:36:05 -0700387 " flash PARTITION [FILENAME] Flash given partition, using the image from\n"
388 " $ANDROID_PRODUCT_OUT if no filename is given.\n"
Elliott Hughesb76188f2018-04-03 13:30:18 -0700389 "\n"
390 "basics:\n"
391 " devices [-l] List devices in bootloader (-l: with device paths).\n"
392 " getvar NAME Display given bootloader variable.\n"
393 " reboot [bootloader] Reboot device.\n"
394 "\n"
395 "locking/unlocking:\n"
396 " flashing lock|unlock Lock/unlock partitions for flashing\n"
397 " flashing lock_critical|unlock_critical\n"
398 " Lock/unlock 'critical' bootloader partitions.\n"
399 " flashing get_unlock_ability\n"
400 " Check whether unlocking is allowed (1) or not(0).\n"
401 "\n"
402 "advanced:\n"
403 " erase PARTITION Erase a flash partition.\n"
404 " format[:FS_TYPE[:SIZE]] PARTITION\n"
405 " Format a flash partition.\n"
406 " set_active SLOT Set the active slot.\n"
407 " oem [COMMAND...] Execute OEM-specific command.\n"
David Anderson1d504e32019-01-15 14:38:20 -0800408 " gsi wipe|disable Wipe or disable a GSI installation (fastbootd only).\n"
David Anderson7c84b9f2019-06-27 22:15:29 -0700409 " wipe-super [SUPER_EMPTY] Wipe the super partition. This will reset it to\n"
410 " contain an empty set of default dynamic partitions.\n"
David Andersonab8f4662019-10-21 16:45:59 -0700411 " snapshot-update cancel On devices that support snapshot-based updates, cancel\n"
412 " an in-progress update. This may make the device\n"
413 " unbootable until it is reflashed.\n"
David Anderson220ddb12019-10-31 18:02:41 -0700414 " snapshot-update merge On devices that support snapshot-based updates, finish\n"
415 " an in-progress update if it is in the \"merging\"\n"
416 " phase.\n"
Elliott Hughesb76188f2018-04-03 13:30:18 -0700417 "\n"
418 "boot image:\n"
419 " boot KERNEL [RAMDISK [SECOND]]\n"
420 " Download and boot kernel from RAM.\n"
421 " flash:raw PARTITION KERNEL [RAMDISK [SECOND]]\n"
422 " Create boot image and flash it.\n"
Hridya Valsaraju6c8fca62019-01-24 12:47:08 -0800423 " --dtb DTB Specify path to DTB for boot image header version 2.\n"
Elliott Hughes577e8b42018-04-05 16:12:47 -0700424 " --cmdline CMDLINE Override kernel command line.\n"
Elliott Hughesb76188f2018-04-03 13:30:18 -0700425 " --base ADDRESS Set kernel base address (default: 0x10000000).\n"
426 " --kernel-offset Set kernel offset (default: 0x00008000).\n"
427 " --ramdisk-offset Set ramdisk offset (default: 0x01000000).\n"
428 " --tags-offset Set tags offset (default: 0x00000100).\n"
Hridya Valsaraju6c8fca62019-01-24 12:47:08 -0800429 " --dtb-offset Set dtb offset (default: 0x01100000).\n"
Elliott Hughesb76188f2018-04-03 13:30:18 -0700430 " --page-size BYTES Set flash page size (default: 2048).\n"
431 " --header-version VERSION Set boot image header version.\n"
Elliott Hughes577e8b42018-04-05 16:12:47 -0700432 " --os-version MAJOR[.MINOR[.PATCH]]\n"
433 " Set boot image OS version (default: 0.0.0).\n"
434 " --os-patch-level YYYY-MM-DD\n"
435 " Set boot image OS security patch level.\n"
436 // TODO: still missing: `second_addr`, `name`, `id`, `recovery_dtbo_*`.
Elliott Hughesb76188f2018-04-03 13:30:18 -0700437 "\n"
Elliott Hughes2e9b7792018-04-04 13:36:44 -0700438 // TODO: what device(s) used this? is there any documentation?
Elliott Hughesb76188f2018-04-03 13:30:18 -0700439 //" continue Continue with autoboot.\n"
440 //"\n"
441 "Android Things:\n"
442 " stage IN_FILE Sends given file to stage for the next command.\n"
443 " get_staged OUT_FILE Writes data staged by the last command to a file.\n"
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800444 "\n"
445 "options:\n"
Elliott Hughesb76188f2018-04-03 13:30:18 -0700446 " -w Wipe userdata.\n"
Elliott Hughesb76188f2018-04-03 13:30:18 -0700447 " -s SERIAL Specify a USB device.\n"
448 " -s tcp|udp:HOST[:PORT] Specify a network device.\n"
Elliott Hughes542370d2018-04-19 19:49:44 -0700449 " -S SIZE[K|M|G] Break into sparse files no larger than SIZE.\n"
David Anderson89569642018-11-16 15:53:35 -0800450 " --force Force a flash operation that may be unsafe.\n"
Elliott Hughesb76188f2018-04-03 13:30:18 -0700451 " --slot SLOT Use SLOT; 'all' for both slots, 'other' for\n"
452 " non-current slot (default: current active slot).\n"
453 " --set-active[=SLOT] Sets the active slot before rebooting.\n"
454 " --skip-secondary Don't flash secondary slots in flashall/update.\n"
455 " --skip-reboot Don't reboot device after flashing.\n"
456 " --disable-verity Sets disable-verity when flashing vbmeta.\n"
457 " --disable-verification Sets disable-verification when flashing vbmeta.\n"
Paul Crowley8f7f56e2015-11-27 09:29:37 +0000458#if !defined(_WIN32)
Elliott Hughesb76188f2018-04-03 13:30:18 -0700459 " --wipe-and-use-fbe Enable file-based encryption, wiping userdata.\n"
Paul Crowley8f7f56e2015-11-27 09:29:37 +0000460#endif
Elliott Hughesb76188f2018-04-03 13:30:18 -0700461 // TODO: remove --unbuffered?
462 " --unbuffered Don't buffer input or output.\n"
463 " --verbose, -v Verbose output.\n"
464 " --version Display version.\n"
465 " --help, -h Show this message.\n"
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800466 );
Elliott Hughesd6365a72017-05-08 18:04:49 -0700467 // clang-format off
468 return 0;
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800469}
Paul Crowley8f7f56e2015-11-27 09:29:37 +0000470
Tom Cherrydfd85df2018-09-20 14:45:05 -0700471static std::vector<char> LoadBootableImage(const std::string& kernel, const std::string& ramdisk,
472 const std::string& second_stage) {
473 std::vector<char> kernel_data;
474 if (!ReadFileToVector(kernel, &kernel_data)) {
475 die("cannot load '%s': %s", kernel.c_str(), strerror(errno));
476 }
Tsu Chiang Chuangee520552011-02-25 18:38:53 -0800477
Elliott Hughesfc797672015-04-07 20:12:50 -0700478 // Is this actually a boot image?
Steve Muckle15303f22020-03-18 14:55:06 -0700479 if (kernel_data.size() < sizeof(boot_img_hdr_v3)) {
Elliott Hughesaaa3b6b2018-01-18 16:08:24 -0800480 die("cannot load '%s': too short", kernel.c_str());
481 }
Tom Cherrydfd85df2018-09-20 14:45:05 -0700482 if (!memcmp(kernel_data.data(), BOOT_MAGIC, BOOT_MAGIC_SIZE)) {
Elliott Hughes577e8b42018-04-05 16:12:47 -0700483 if (!g_cmdline.empty()) {
Hridya Valsaraju6c8fca62019-01-24 12:47:08 -0800484 bootimg_set_cmdline(reinterpret_cast<boot_img_hdr_v2*>(kernel_data.data()), g_cmdline);
Elliott Hughes577e8b42018-04-05 16:12:47 -0700485 }
Tsu Chiang Chuangee520552011-02-25 18:38:53 -0800486
Elliott Hughes4089d342017-10-27 14:21:12 -0700487 if (!ramdisk.empty()) die("cannot boot a boot.img *and* ramdisk");
Tsu Chiang Chuangee520552011-02-25 18:38:53 -0800488
Tom Cherrydfd85df2018-09-20 14:45:05 -0700489 return kernel_data;
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800490 }
491
Tom Cherrydfd85df2018-09-20 14:45:05 -0700492 std::vector<char> ramdisk_data;
Elliott Hughesd6365a72017-05-08 18:04:49 -0700493 if (!ramdisk.empty()) {
Tom Cherrydfd85df2018-09-20 14:45:05 -0700494 if (!ReadFileToVector(ramdisk, &ramdisk_data)) {
495 die("cannot load '%s': %s", ramdisk.c_str(), strerror(errno));
496 }
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800497 }
498
Tom Cherrydfd85df2018-09-20 14:45:05 -0700499 std::vector<char> second_stage_data;
Elliott Hughesd6365a72017-05-08 18:04:49 -0700500 if (!second_stage.empty()) {
Tom Cherrydfd85df2018-09-20 14:45:05 -0700501 if (!ReadFileToVector(second_stage, &second_stage_data)) {
502 die("cannot load '%s': %s", second_stage.c_str(), strerror(errno));
503 }
Jeremy Compostellaa42adff2014-07-17 17:17:54 +0200504 }
Hridya Valsaraju6c8fca62019-01-24 12:47:08 -0800505
506 std::vector<char> dtb_data;
507 if (!g_dtb_path.empty()) {
Steve Muckle15303f22020-03-18 14:55:06 -0700508 if (g_boot_img_hdr.header_version != 2) {
Hridya Valsaraju6c8fca62019-01-24 12:47:08 -0800509 die("Argument dtb not supported for boot image header version %d\n",
510 g_boot_img_hdr.header_version);
511 }
512 if (!ReadFileToVector(g_dtb_path, &dtb_data)) {
513 die("cannot load '%s': %s", g_dtb_path.c_str(), strerror(errno));
514 }
515 }
516
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800517 fprintf(stderr,"creating boot image...\n");
Elliott Hughesd6365a72017-05-08 18:04:49 -0700518
Tom Cherrydfd85df2018-09-20 14:45:05 -0700519 std::vector<char> out;
Hridya Valsaraju6c8fca62019-01-24 12:47:08 -0800520 boot_img_hdr_v2* boot_image_data = mkbootimg(kernel_data, ramdisk_data, second_stage_data,
521 dtb_data, g_base_addr, g_boot_img_hdr, &out);
Tsu Chiang Chuangee520552011-02-25 18:38:53 -0800522
Tom Cherrydfd85df2018-09-20 14:45:05 -0700523 if (!g_cmdline.empty()) bootimg_set_cmdline(boot_image_data, g_cmdline);
524 fprintf(stderr, "creating boot image - %zu bytes\n", out.size());
Tom Cherrydfd85df2018-09-20 14:45:05 -0700525 return out;
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800526}
527
Tom Cherrydfd85df2018-09-20 14:45:05 -0700528static bool UnzipToMemory(ZipArchiveHandle zip, const std::string& entry_name,
529 std::vector<char>* out) {
Elliott Hughesb4074142020-09-15 14:26:17 -0700530 ZipEntry64 zip_entry;
Elliott Hughesb17bf522019-05-03 22:38:44 -0700531 if (FindEntry(zip, entry_name, &zip_entry) != 0) {
Tom Cherrydfd85df2018-09-20 14:45:05 -0700532 fprintf(stderr, "archive does not contain '%s'\n", entry_name.c_str());
533 return false;
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800534 }
535
Elliott Hughesb4074142020-09-15 14:26:17 -0700536 if (zip_entry.uncompressed_length > std::numeric_limits<size_t>::max()) {
537 die("entry '%s' is too large: %" PRIu64, entry_name.c_str(), zip_entry.uncompressed_length);
538 }
Tom Cherrydfd85df2018-09-20 14:45:05 -0700539 out->resize(zip_entry.uncompressed_length);
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800540
Tom Cherrydfd85df2018-09-20 14:45:05 -0700541 fprintf(stderr, "extracting %s (%zu MB) to RAM...\n", entry_name.c_str(),
542 out->size() / 1024 / 1024);
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800543
Tom Cherrydfd85df2018-09-20 14:45:05 -0700544 int error = ExtractToMemory(zip, &zip_entry, reinterpret_cast<uint8_t*>(out->data()),
545 out->size());
546 if (error != 0) die("failed to extract '%s': %s", entry_name.c_str(), ErrorCodeString(error));
Alexander Levitskiy8d7ddb32014-05-07 23:31:59 +0000547
Tom Cherrydfd85df2018-09-20 14:45:05 -0700548 return true;
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800549}
550
Elliott Hughesa26fbee2015-06-03 15:22:11 -0700551#if defined(_WIN32)
552
553// TODO: move this to somewhere it can be shared.
554
555#include <windows.h>
556
557// Windows' tmpfile(3) requires administrator rights because
558// it creates temporary files in the root directory.
559static FILE* win32_tmpfile() {
560 char temp_path[PATH_MAX];
561 DWORD nchars = GetTempPath(sizeof(temp_path), temp_path);
562 if (nchars == 0 || nchars >= sizeof(temp_path)) {
Elliott Hughes4089d342017-10-27 14:21:12 -0700563 die("GetTempPath failed, error %ld", GetLastError());
Elliott Hughesa26fbee2015-06-03 15:22:11 -0700564 }
565
566 char filename[PATH_MAX];
567 if (GetTempFileName(temp_path, "fastboot", 0, filename) == 0) {
Elliott Hughes4089d342017-10-27 14:21:12 -0700568 die("GetTempFileName failed, error %ld", GetLastError());
Elliott Hughesa26fbee2015-06-03 15:22:11 -0700569 }
570
571 return fopen(filename, "w+bTD");
572}
573
574#define tmpfile win32_tmpfile
575
Paul Crowley8f7f56e2015-11-27 09:29:37 +0000576static std::string make_temporary_directory() {
Elliott Hughes4089d342017-10-27 14:21:12 -0700577 die("make_temporary_directory not supported under Windows, sorry!");
Paul Crowley8f7f56e2015-11-27 09:29:37 +0000578}
579
Elliott Hughes855cdf82018-04-02 14:24:03 -0700580static int make_temporary_fd(const char* /*what*/) {
Elliott Hughesbbfc2812017-04-25 18:33:09 -0700581 // TODO: reimplement to avoid leaking a FILE*.
582 return fileno(tmpfile());
583}
584
Paul Crowley8f7f56e2015-11-27 09:29:37 +0000585#else
586
Elliott Hughesbbfc2812017-04-25 18:33:09 -0700587static std::string make_temporary_template() {
588 const char* tmpdir = getenv("TMPDIR");
589 if (tmpdir == nullptr) tmpdir = P_tmpdir;
590 return std::string(tmpdir) + "/fastboot_userdata_XXXXXX";
591}
592
Paul Crowley8f7f56e2015-11-27 09:29:37 +0000593static std::string make_temporary_directory() {
Elliott Hughesbbfc2812017-04-25 18:33:09 -0700594 std::string result(make_temporary_template());
595 if (mkdtemp(&result[0]) == nullptr) {
Elliott Hughesda1dbd62018-05-21 23:02:26 -0700596 die("unable to create temporary directory with template %s: %s",
597 result.c_str(), strerror(errno));
Paul Crowley8f7f56e2015-11-27 09:29:37 +0000598 }
599 return result;
600}
601
Elliott Hughes855cdf82018-04-02 14:24:03 -0700602static int make_temporary_fd(const char* what) {
Elliott Hughesbbfc2812017-04-25 18:33:09 -0700603 std::string path_template(make_temporary_template());
604 int fd = mkstemp(&path_template[0]);
605 if (fd == -1) {
Elliott Hughesda1dbd62018-05-21 23:02:26 -0700606 die("failed to create temporary file for %s with template %s: %s\n",
607 path_template.c_str(), what, strerror(errno));
Elliott Hughesbbfc2812017-04-25 18:33:09 -0700608 }
609 unlink(path_template.c_str());
610 return fd;
611}
612
Elliott Hughesa26fbee2015-06-03 15:22:11 -0700613#endif
614
Paul Crowley8f7f56e2015-11-27 09:29:37 +0000615static std::string create_fbemarker_tmpdir() {
616 std::string dir = make_temporary_directory();
Paul Crowley8f7f56e2015-11-27 09:29:37 +0000617 std::string marker_file = dir + "/" + convert_fbe_marker_filename;
618 int fd = open(marker_file.c_str(), O_CREAT | O_WRONLY | O_CLOEXEC, 0666);
619 if (fd == -1) {
Elliott Hughes855cdf82018-04-02 14:24:03 -0700620 die("unable to create FBE marker file %s locally: %s",
621 marker_file.c_str(), strerror(errno));
Paul Crowley8f7f56e2015-11-27 09:29:37 +0000622 }
623 close(fd);
624 return dir;
625}
626
627static void delete_fbemarker_tmpdir(const std::string& dir) {
628 std::string marker_file = dir + "/" + convert_fbe_marker_filename;
629 if (unlink(marker_file.c_str()) == -1) {
630 fprintf(stderr, "Unable to delete FBE marker file %s locally: %d, %s\n",
631 marker_file.c_str(), errno, strerror(errno));
632 return;
633 }
634 if (rmdir(dir.c_str()) == -1) {
635 fprintf(stderr, "Unable to delete FBE marker directory %s locally: %d, %s\n",
636 dir.c_str(), errno, strerror(errno));
637 return;
638 }
639}
640
Elliott Hughes45964a82017-05-03 22:43:23 -0700641static int unzip_to_file(ZipArchiveHandle zip, const char* entry_name) {
Elliott Hughes855cdf82018-04-02 14:24:03 -0700642 unique_fd fd(make_temporary_fd(entry_name));
Rom Lemarchand622810c2013-06-28 09:54:59 -0700643
Elliott Hughesb4074142020-09-15 14:26:17 -0700644 ZipEntry64 zip_entry;
Elliott Hughesb17bf522019-05-03 22:38:44 -0700645 if (FindEntry(zip, entry_name, &zip_entry) != 0) {
Elliott Hughesa82c89d2015-03-19 11:44:32 -0700646 fprintf(stderr, "archive does not contain '%s'\n", entry_name);
David Andersoncf444f32018-08-29 14:15:49 -0700647 errno = ENOENT;
Alexander Levitskiy8d7ddb32014-05-07 23:31:59 +0000648 return -1;
649 }
650
Elliott Hughesb4074142020-09-15 14:26:17 -0700651 fprintf(stderr, "extracting %s (%" PRIu64 " MB) to disk...", entry_name,
Elliott Hughesbbfc2812017-04-25 18:33:09 -0700652 zip_entry.uncompressed_length / 1024 / 1024);
Elliott Hughes23af1122017-11-10 08:42:17 -0800653 double start = now();
Elliott Hughesa82c89d2015-03-19 11:44:32 -0700654 int error = ExtractEntryToFile(zip, &zip_entry, fd);
655 if (error != 0) {
Elliott Hughes23af1122017-11-10 08:42:17 -0800656 die("\nfailed to extract '%s': %s", entry_name, ErrorCodeString(error));
Rom Lemarchand622810c2013-06-28 09:54:59 -0700657 }
658
Elliott Hughes4089d342017-10-27 14:21:12 -0700659 if (lseek(fd, 0, SEEK_SET) != 0) {
Elliott Hughes23af1122017-11-10 08:42:17 -0800660 die("\nlseek on extracted file '%s' failed: %s", entry_name, strerror(errno));
Elliott Hughes4089d342017-10-27 14:21:12 -0700661 }
662
Elliott Hughes23af1122017-11-10 08:42:17 -0800663 fprintf(stderr, " took %.3fs\n", now() - start);
664
Elliott Hughesbbfc2812017-04-25 18:33:09 -0700665 return fd.release();
Rom Lemarchand622810c2013-06-28 09:54:59 -0700666}
667
Tom Cherry4aa60b32018-09-05 15:11:44 -0700668static void CheckRequirement(const std::string& cur_product, const std::string& var,
669 const std::string& product, bool invert,
670 const std::vector<std::string>& options) {
671 Status("Checking '" + var + "'");
Elliott Hughes5620d222018-03-28 08:20:00 -0700672
Tom Cherry4aa60b32018-09-05 15:11:44 -0700673 double start = now();
674
675 if (!product.empty()) {
676 if (product != cur_product) {
677 double split = now();
678 fprintf(stderr, "IGNORE, product is %s required only for %s [%7.3fs]\n",
679 cur_product.c_str(), product.c_str(), (split - start));
680 return;
681 }
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800682 }
Tom Cherry4aa60b32018-09-05 15:11:44 -0700683
684 std::string var_value;
Tom Cherry9027af02018-09-24 15:48:09 -0700685 if (fb->GetVar(var, &var_value) != fastboot::SUCCESS) {
Tom Cherry4aa60b32018-09-05 15:11:44 -0700686 fprintf(stderr, "FAILED\n\n");
Tom Cherry9027af02018-09-24 15:48:09 -0700687 fprintf(stderr, "Could not getvar for '%s' (%s)\n\n", var.c_str(),
688 fb->Error().c_str());
Tom Cherry4aa60b32018-09-05 15:11:44 -0700689 die("requirements not met!");
690 }
691
692 bool match = false;
693 for (const auto& option : options) {
694 if (option == var_value || (option.back() == '*' &&
695 !var_value.compare(0, option.length() - 1, option, 0,
696 option.length() - 1))) {
697 match = true;
698 break;
699 }
700 }
701
702 if (invert) {
703 match = !match;
704 }
705
706 if (match) {
707 double split = now();
708 fprintf(stderr, "OKAY [%7.3fs]\n", (split - start));
709 return;
710 }
711
712 fprintf(stderr, "FAILED\n\n");
713 fprintf(stderr, "Device %s is '%s'.\n", var.c_str(), var_value.c_str());
714 fprintf(stderr, "Update %s '%s'", invert ? "rejects" : "requires", options[0].c_str());
715 for (auto it = std::next(options.begin()); it != options.end(); ++it) {
716 fprintf(stderr, " or '%s'", it->c_str());
717 }
718 fprintf(stderr, ".\n\n");
719 die("requirements not met!");
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800720}
721
Tom Cherry4aa60b32018-09-05 15:11:44 -0700722bool ParseRequirementLine(const std::string& line, std::string* name, std::string* product,
723 bool* invert, std::vector<std::string>* options) {
Elliott Hughes5620d222018-03-28 08:20:00 -0700724 // "require product=alpha|beta|gamma"
725 // "require version-bootloader=1234"
726 // "require-for-product:gamma version-bootloader=istanbul|constantinople"
727 // "require partition-exists=vendor"
Tom Cherry4aa60b32018-09-05 15:11:44 -0700728 *product = "";
729 *invert = false;
Elliott Hughes5620d222018-03-28 08:20:00 -0700730
Tom Cherry4aa60b32018-09-05 15:11:44 -0700731 auto require_reject_regex = std::regex{"(require\\s+|reject\\s+)?\\s*(\\S+)\\s*=\\s*(.*)"};
732 auto require_product_regex =
733 std::regex{"require-for-product:\\s*(\\S+)\\s+(\\S+)\\s*=\\s*(.*)"};
734 std::smatch match_results;
735
736 if (std::regex_match(line, match_results, require_reject_regex)) {
737 *invert = Trim(match_results[1]) == "reject";
738 } else if (std::regex_match(line, match_results, require_product_regex)) {
739 *product = match_results[1];
740 } else {
741 return false;
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800742 }
743
Tom Cherry4aa60b32018-09-05 15:11:44 -0700744 *name = match_results[2];
Elliott Hughes253c18d2015-03-18 22:47:09 -0700745 // Work around an unfortunate name mismatch.
Tom Cherry4aa60b32018-09-05 15:11:44 -0700746 if (*name == "board") {
747 *name = "product";
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800748 }
749
Tom Cherry4aa60b32018-09-05 15:11:44 -0700750 auto raw_options = Split(match_results[3], "|");
751 for (const auto& option : raw_options) {
752 auto trimmed_option = Trim(option);
753 options->emplace_back(trimmed_option);
754 }
755
756 return true;
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800757}
758
Tom Cherry4aa60b32018-09-05 15:11:44 -0700759// "require partition-exists=x" is a special case, added because of the trouble we had when
760// Pixel 2 shipped with new partitions and users used old versions of fastboot to flash them,
761// missing out new partitions. A device with new partitions can use "partition-exists" to
762// override the fields `optional_if_no_image` in the `images` array.
763static void HandlePartitionExists(const std::vector<std::string>& options) {
764 const std::string& partition_name = options[0];
765 std::string has_slot;
Tom Cherry9027af02018-09-24 15:48:09 -0700766 if (fb->GetVar("has-slot:" + partition_name, &has_slot) != fastboot::SUCCESS ||
Tom Cherry4aa60b32018-09-05 15:11:44 -0700767 (has_slot != "yes" && has_slot != "no")) {
768 die("device doesn't have required partition %s!", partition_name.c_str());
769 }
770 bool known_partition = false;
771 for (size_t i = 0; i < arraysize(images); ++i) {
772 if (images[i].nickname && images[i].nickname == partition_name) {
773 images[i].optional_if_no_image = false;
774 known_partition = true;
775 }
776 }
777 if (!known_partition) {
778 die("device requires partition %s which is not known to this version of fastboot",
779 partition_name.c_str());
780 }
781}
782
783static void CheckRequirements(const std::string& data) {
784 std::string cur_product;
Tom Cherry9027af02018-09-24 15:48:09 -0700785 if (fb->GetVar("product", &cur_product) != fastboot::SUCCESS) {
786 fprintf(stderr, "getvar:product FAILED (%s)\n", fb->Error().c_str());
Tom Cherry4aa60b32018-09-05 15:11:44 -0700787 }
788
789 auto lines = Split(data, "\n");
790 for (const auto& line : lines) {
791 if (line.empty()) {
792 continue;
793 }
794
795 std::string name;
796 std::string product;
797 bool invert;
798 std::vector<std::string> options;
799
800 if (!ParseRequirementLine(line, &name, &product, &invert, &options)) {
801 fprintf(stderr, "android-info.txt syntax error: %s\n", line.c_str());
802 continue;
803 }
804 if (name == "partition-exists") {
805 HandlePartitionExists(options);
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800806 } else {
Tom Cherry4aa60b32018-09-05 15:11:44 -0700807 CheckRequirement(cur_product, name, product, invert, options);
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800808 }
809 }
810}
811
Tom Cherry9027af02018-09-24 15:48:09 -0700812static void DisplayVarOrError(const std::string& label, const std::string& var) {
813 std::string value;
814
815 if (fb->GetVar(var, &value) != fastboot::SUCCESS) {
816 Status("getvar:" + var);
817 fprintf(stderr, "FAILED (%s)\n", fb->Error().c_str());
818 return;
819 }
820 fprintf(stderr, "%s: %s\n", label.c_str(), value.c_str());
821}
822
823static void DumpInfo() {
824 fprintf(stderr, "--------------------------------------------\n");
825 DisplayVarOrError("Bootloader Version...", "version-bootloader");
826 DisplayVarOrError("Baseband Version.....", "version-baseband");
827 DisplayVarOrError("Serial Number........", "serialno");
828 fprintf(stderr, "--------------------------------------------\n");
829
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -0800830}
831
Tao Bao41cf35f2018-04-24 10:54:21 -0700832static struct sparse_file** load_sparse_files(int fd, int64_t max_size) {
Mohamad Ayyash80cc1f62015-03-31 12:09:29 -0700833 struct sparse_file* s = sparse_file_import_auto(fd, false, true);
Elliott Hughes4089d342017-10-27 14:21:12 -0700834 if (!s) die("cannot sparse read file");
Colin Crossf8387882012-05-24 17:18:41 -0700835
Tao Bao41cf35f2018-04-24 10:54:21 -0700836 if (max_size <= 0 || max_size > std::numeric_limits<uint32_t>::max()) {
837 die("invalid max size %" PRId64, max_size);
838 }
839
Elliott Hughesfc797672015-04-07 20:12:50 -0700840 int files = sparse_file_resparse(s, max_size, nullptr, 0);
Elliott Hughes4089d342017-10-27 14:21:12 -0700841 if (files < 0) die("Failed to resparse");
Colin Crossf8387882012-05-24 17:18:41 -0700842
Elliott Hughes253c18d2015-03-18 22:47:09 -0700843 sparse_file** out_s = reinterpret_cast<sparse_file**>(calloc(sizeof(struct sparse_file *), files + 1));
Elliott Hughes4089d342017-10-27 14:21:12 -0700844 if (!out_s) die("Failed to allocate sparse file array");
Colin Crossf8387882012-05-24 17:18:41 -0700845
846 files = sparse_file_resparse(s, max_size, out_s, files);
Elliott Hughes4089d342017-10-27 14:21:12 -0700847 if (files < 0) die("Failed to resparse");
Colin Crossf8387882012-05-24 17:18:41 -0700848
849 return out_s;
850}
851
Aaron Wisnerdb511202018-06-26 15:38:35 -0500852static int64_t get_target_sparse_limit() {
Elliott Hughes2fd45a92015-10-30 11:49:47 -0700853 std::string max_download_size;
Tom Cherry9027af02018-09-24 15:48:09 -0700854 if (fb->GetVar("max-download-size", &max_download_size) != fastboot::SUCCESS ||
Elliott Hughes855cdf82018-04-02 14:24:03 -0700855 max_download_size.empty()) {
856 verbose("target didn't report max-download-size");
Elliott Hughes2fd45a92015-10-30 11:49:47 -0700857 return 0;
Colin Crossf8387882012-05-24 17:18:41 -0700858 }
859
Elliott Hughes77c0e662015-11-02 15:51:12 -0800860 // Some bootloaders (angler, for example) send spurious whitespace too.
861 max_download_size = android::base::Trim(max_download_size);
862
Elliott Hughes2fd45a92015-10-30 11:49:47 -0700863 uint64_t limit;
Elliott Hughesda46b392016-10-11 17:09:00 -0700864 if (!android::base::ParseUint(max_download_size, &limit)) {
Elliott Hughes3ab05862015-11-02 09:01:53 -0800865 fprintf(stderr, "couldn't parse max-download-size '%s'\n", max_download_size.c_str());
Elliott Hughes2fd45a92015-10-30 11:49:47 -0700866 return 0;
867 }
Elliott Hughes855cdf82018-04-02 14:24:03 -0700868 if (limit > 0) verbose("target reported max download size of %" PRId64 " bytes", limit);
Colin Crossf8387882012-05-24 17:18:41 -0700869 return limit;
870}
871
Aaron Wisnerdb511202018-06-26 15:38:35 -0500872static int64_t get_sparse_limit(int64_t size) {
Elliott Hughes542370d2018-04-19 19:49:44 -0700873 int64_t limit = sparse_limit;
874 if (limit == 0) {
875 // Unlimited, so see what the target device's limit is.
876 // TODO: shouldn't we apply this limit even if you've used -S?
Colin Crossf8387882012-05-24 17:18:41 -0700877 if (target_sparse_limit == -1) {
Aaron Wisnerdb511202018-06-26 15:38:35 -0500878 target_sparse_limit = get_target_sparse_limit();
Colin Crossf8387882012-05-24 17:18:41 -0700879 }
880 if (target_sparse_limit > 0) {
881 limit = target_sparse_limit;
882 } else {
Colin Cross0bbfb392012-07-24 18:05:21 -0700883 return 0;
Colin Crossf8387882012-05-24 17:18:41 -0700884 }
885 }
886
887 if (size > limit) {
Chris Fries6a999712017-04-04 09:52:47 -0500888 return std::min(limit, RESPARSE_LIMIT);
Colin Crossf8387882012-05-24 17:18:41 -0700889 }
890
891 return 0;
892}
893
Aaron Wisnerdb511202018-06-26 15:38:35 -0500894static bool load_buf_fd(int fd, struct fastboot_buffer* buf) {
Elliott Hughesfc797672015-04-07 20:12:50 -0700895 int64_t sz = get_file_size(fd);
896 if (sz == -1) {
Elliott Hughes53ec4952016-05-11 12:39:27 -0700897 return false;
Rom Lemarchand622810c2013-06-28 09:54:59 -0700898 }
Dmitry Grinberge6f3e9b2014-03-11 18:28:15 -0700899
Tom Cherryfbb95352019-09-17 13:34:04 -0700900 if (sparse_file* s = sparse_file_import(fd, false, false)) {
David Anderson32e376f2018-08-16 13:43:11 -0700901 buf->image_size = sparse_file_len(s, false, false);
902 sparse_file_destroy(s);
903 } else {
904 buf->image_size = sz;
905 }
906
Elliott Hughesa56a7292018-10-26 10:34:53 -0700907 lseek(fd, 0, SEEK_SET);
Aaron Wisnerdb511202018-06-26 15:38:35 -0500908 int64_t limit = get_sparse_limit(sz);
Colin Crossf8387882012-05-24 17:18:41 -0700909 if (limit) {
Elliott Hughesfc797672015-04-07 20:12:50 -0700910 sparse_file** s = load_sparse_files(fd, limit);
911 if (s == nullptr) {
Elliott Hughes53ec4952016-05-11 12:39:27 -0700912 return false;
Colin Crossf8387882012-05-24 17:18:41 -0700913 }
Rom Lemarchand622810c2013-06-28 09:54:59 -0700914 buf->type = FB_BUFFER_SPARSE;
915 buf->data = s;
Colin Crossf8387882012-05-24 17:18:41 -0700916 } else {
Chris Fries0ea946c2017-04-12 10:25:57 -0500917 buf->type = FB_BUFFER_FD;
918 buf->data = nullptr;
919 buf->fd = fd;
Alexander Levitskiy8d7ddb32014-05-07 23:31:59 +0000920 buf->sz = sz;
Colin Crossf8387882012-05-24 17:18:41 -0700921 }
Rom Lemarchand622810c2013-06-28 09:54:59 -0700922
Elliott Hughes53ec4952016-05-11 12:39:27 -0700923 return true;
Rom Lemarchand622810c2013-06-28 09:54:59 -0700924}
925
Aaron Wisnerdb511202018-06-26 15:38:35 -0500926static bool load_buf(const char* fname, struct fastboot_buffer* buf) {
Chris Fries0ea946c2017-04-12 10:25:57 -0500927 unique_fd fd(TEMP_FAILURE_RETRY(open(fname, O_RDONLY | O_BINARY)));
928
Elliott Hughes53ec4952016-05-11 12:39:27 -0700929 if (fd == -1) {
930 return false;
Rom Lemarchand622810c2013-06-28 09:54:59 -0700931 }
Chris Fries0ea946c2017-04-12 10:25:57 -0500932
933 struct stat s;
934 if (fstat(fd, &s)) {
935 return false;
936 }
937 if (!S_ISREG(s.st_mode)) {
938 errno = S_ISDIR(s.st_mode) ? EISDIR : EINVAL;
939 return false;
940 }
941
Aaron Wisnerdb511202018-06-26 15:38:35 -0500942 return load_buf_fd(fd.release(), buf);
Rom Lemarchand622810c2013-06-28 09:54:59 -0700943}
944
Chin-Ting Kuodf6a7802019-09-16 11:23:55 +0800945static void rewrite_vbmeta_buffer(struct fastboot_buffer* buf, bool vbmeta_in_boot) {
David Zeuthenb6ea4352017-08-07 14:29:26 -0400946 // Buffer needs to be at least the size of the VBMeta struct which
947 // is 256 bytes.
948 if (buf->sz < 256) {
949 return;
950 }
951
David Zeuthenb6ea4352017-08-07 14:29:26 -0400952 std::string data;
953 if (!android::base::ReadFdToString(buf->fd, &data)) {
954 die("Failed reading from vbmeta");
955 }
956
Chin-Ting Kuodf6a7802019-09-16 11:23:55 +0800957 uint64_t vbmeta_offset = 0;
958 if (vbmeta_in_boot) {
959 // Tries to locate top-level vbmeta from boot.img footer.
960 uint64_t footer_offset = buf->sz - AVB_FOOTER_SIZE;
961 if (0 != data.compare(footer_offset, AVB_FOOTER_MAGIC_LEN, AVB_FOOTER_MAGIC)) {
962 die("Failed to find AVB_FOOTER at offset: %" PRId64, footer_offset);
963 }
964 const AvbFooter* footer = reinterpret_cast<const AvbFooter*>(data.c_str() + footer_offset);
965 vbmeta_offset = be64toh(footer->vbmeta_offset);
966 }
967 // Ensures there is AVB_MAGIC at vbmeta_offset.
968 if (0 != data.compare(vbmeta_offset, AVB_MAGIC_LEN, AVB_MAGIC)) {
969 die("Failed to find AVB_MAGIC at offset: %" PRId64, vbmeta_offset);
970 }
971
972 fprintf(stderr, "Rewriting vbmeta struct at offset: %" PRId64 "\n", vbmeta_offset);
973
David Zeuthenb6ea4352017-08-07 14:29:26 -0400974 // There's a 32-bit big endian |flags| field at offset 120 where
975 // bit 0 corresponds to disable-verity and bit 1 corresponds to
976 // disable-verification.
977 //
978 // See external/avb/libavb/avb_vbmeta_image.h for the layout of
979 // the VBMeta struct.
Chin-Ting Kuodf6a7802019-09-16 11:23:55 +0800980 uint64_t flags_offset = 123 + vbmeta_offset;
David Zeuthenb6ea4352017-08-07 14:29:26 -0400981 if (g_disable_verity) {
Chin-Ting Kuodf6a7802019-09-16 11:23:55 +0800982 data[flags_offset] |= 0x01;
David Zeuthenb6ea4352017-08-07 14:29:26 -0400983 }
984 if (g_disable_verification) {
Chin-Ting Kuodf6a7802019-09-16 11:23:55 +0800985 data[flags_offset] |= 0x02;
David Zeuthenb6ea4352017-08-07 14:29:26 -0400986 }
987
Chin-Ting Kuodf6a7802019-09-16 11:23:55 +0800988 int fd = make_temporary_fd("vbmeta rewriting");
David Zeuthenb6ea4352017-08-07 14:29:26 -0400989 if (!android::base::WriteStringToFd(data, fd)) {
990 die("Failed writing to modified vbmeta");
991 }
992 close(buf->fd);
993 buf->fd = fd;
994 lseek(fd, 0, SEEK_SET);
995}
996
Chin-Ting Kuodf6a7802019-09-16 11:23:55 +0800997static bool has_vbmeta_partition() {
998 std::string partition_type;
999 return fb->GetVar("partition-type:vbmeta", &partition_type) == fastboot::SUCCESS ||
1000 fb->GetVar("partition-type:vbmeta_a", &partition_type) == fastboot::SUCCESS ||
1001 fb->GetVar("partition-type:vbmeta_b", &partition_type) == fastboot::SUCCESS;
1002}
1003
Steve Muckle3af575b2020-06-18 17:02:15 -07001004static std::string fb_fix_numeric_var(std::string var) {
1005 // Some bootloaders (angler, for example), send spurious leading whitespace.
1006 var = android::base::Trim(var);
1007 // Some bootloaders (hammerhead, for example) use implicit hex.
1008 // This code used to use strtol with base 16.
1009 if (!android::base::StartsWith(var, "0x")) var = "0x" + var;
1010 return var;
1011}
1012
1013static void copy_boot_avb_footer(const std::string& partition, struct fastboot_buffer* buf) {
1014 if (buf->sz < AVB_FOOTER_SIZE) {
1015 return;
1016 }
1017
1018 std::string partition_size_str;
1019 if (fb->GetVar("partition-size:" + partition, &partition_size_str) != fastboot::SUCCESS) {
1020 die("cannot get boot partition size");
1021 }
1022
1023 partition_size_str = fb_fix_numeric_var(partition_size_str);
1024 int64_t partition_size;
1025 if (!android::base::ParseInt(partition_size_str, &partition_size)) {
1026 die("Couldn't parse partition size '%s'.", partition_size_str.c_str());
1027 }
1028 if (partition_size == buf->sz) {
1029 return;
1030 }
1031 if (partition_size < buf->sz) {
1032 die("boot partition is smaller than boot image");
1033 }
1034
1035 std::string data;
1036 if (!android::base::ReadFdToString(buf->fd, &data)) {
1037 die("Failed reading from boot");
1038 }
1039
1040 uint64_t footer_offset = buf->sz - AVB_FOOTER_SIZE;
1041 if (0 != data.compare(footer_offset, AVB_FOOTER_MAGIC_LEN, AVB_FOOTER_MAGIC)) {
1042 return;
1043 }
1044
1045 int fd = make_temporary_fd("boot rewriting");
1046 if (!android::base::WriteStringToFd(data, fd)) {
1047 die("Failed writing to modified boot");
1048 }
1049 lseek(fd, partition_size - AVB_FOOTER_SIZE, SEEK_SET);
1050 if (!android::base::WriteStringToFd(data.substr(footer_offset), fd)) {
1051 die("Failed copying AVB footer in boot");
1052 }
1053 close(buf->fd);
1054 buf->fd = fd;
1055 buf->sz = partition_size;
1056 lseek(fd, 0, SEEK_SET);
1057}
1058
Elliott Hughes5620d222018-03-28 08:20:00 -07001059static void flash_buf(const std::string& partition, struct fastboot_buffer *buf)
Rom Lemarchand622810c2013-06-28 09:54:59 -07001060{
Elliott Hughes253c18d2015-03-18 22:47:09 -07001061 sparse_file** s;
Rom Lemarchand622810c2013-06-28 09:54:59 -07001062
Steve Muckle3af575b2020-06-18 17:02:15 -07001063 if (partition == "boot" || partition == "boot_a" || partition == "boot_b") {
1064 copy_boot_avb_footer(partition, buf);
1065 }
1066
David Zeuthenb6ea4352017-08-07 14:29:26 -04001067 // Rewrite vbmeta if that's what we're flashing and modification has been requested.
Chin-Ting Kuodf6a7802019-09-16 11:23:55 +08001068 if (g_disable_verity || g_disable_verification) {
1069 if (partition == "vbmeta" || partition == "vbmeta_a" || partition == "vbmeta_b") {
1070 rewrite_vbmeta_buffer(buf, false /* vbmeta_in_boot */);
1071 } else if (!has_vbmeta_partition() &&
1072 (partition == "boot" || partition == "boot_a" || partition == "boot_b")) {
1073 rewrite_vbmeta_buffer(buf, true /* vbmeta_in_boot */ );
1074 }
David Zeuthenb6ea4352017-08-07 14:29:26 -04001075 }
1076
Rom Lemarchand622810c2013-06-28 09:54:59 -07001077 switch (buf->type) {
Josh Gao9da9ac52016-01-19 14:50:18 -08001078 case FB_BUFFER_SPARSE: {
1079 std::vector<std::pair<sparse_file*, int64_t>> sparse_files;
Elliott Hughes253c18d2015-03-18 22:47:09 -07001080 s = reinterpret_cast<sparse_file**>(buf->data);
Rom Lemarchand622810c2013-06-28 09:54:59 -07001081 while (*s) {
Elliott Hughesfc797672015-04-07 20:12:50 -07001082 int64_t sz = sparse_file_len(*s, true, false);
Josh Gao9da9ac52016-01-19 14:50:18 -08001083 sparse_files.emplace_back(*s, sz);
1084 ++s;
1085 }
1086
1087 for (size_t i = 0; i < sparse_files.size(); ++i) {
1088 const auto& pair = sparse_files[i];
Tom Cherry9027af02018-09-24 15:48:09 -07001089 fb->FlashPartition(partition, pair.first, pair.second, i + 1, sparse_files.size());
Rom Lemarchand622810c2013-06-28 09:54:59 -07001090 }
1091 break;
Josh Gao9da9ac52016-01-19 14:50:18 -08001092 }
Chris Fries0ea946c2017-04-12 10:25:57 -05001093 case FB_BUFFER_FD:
Tom Cherry9027af02018-09-24 15:48:09 -07001094 fb->FlashPartition(partition, buf->fd, buf->sz);
Rom Lemarchand622810c2013-06-28 09:54:59 -07001095 break;
1096 default:
1097 die("unknown buffer type: %d", buf->type);
1098 }
1099}
1100
Aaron Wisnerdb511202018-06-26 15:38:35 -05001101static std::string get_current_slot() {
Daniel Rosenberg80919472016-06-30 19:25:31 -07001102 std::string current_slot;
Tom Cherry9027af02018-09-24 15:48:09 -07001103 if (fb->GetVar("current-slot", &current_slot) != fastboot::SUCCESS) return "";
Elliott Hughes42b18a52018-04-10 15:32:21 -07001104 return current_slot;
Daniel Rosenberg80919472016-06-30 19:25:31 -07001105}
1106
Aaron Wisnerdb511202018-06-26 15:38:35 -05001107static int get_slot_count() {
Daniel Rosenberg80919472016-06-30 19:25:31 -07001108 std::string var;
Elliott Hughes42b18a52018-04-10 15:32:21 -07001109 int count = 0;
Tom Cherry9027af02018-09-24 15:48:09 -07001110 if (fb->GetVar("slot-count", &var) != fastboot::SUCCESS ||
1111 !android::base::ParseInt(var, &count)) {
Elliott Hughes42b18a52018-04-10 15:32:21 -07001112 return 0;
Daniel Rosenberg80919472016-06-30 19:25:31 -07001113 }
Daniel Rosenberg80919472016-06-30 19:25:31 -07001114 return count;
1115}
1116
Aaron Wisnerdb511202018-06-26 15:38:35 -05001117static bool supports_AB() {
1118 return get_slot_count() >= 2;
Alex Lightbb9b8a52016-06-29 09:26:44 -07001119}
1120
Daniel Rosenbergad3d3c12016-06-27 23:03:48 -07001121// Given a current slot, this returns what the 'other' slot is.
Daniel Rosenberg80919472016-06-30 19:25:31 -07001122static std::string get_other_slot(const std::string& current_slot, int count) {
1123 if (count == 0) return "";
Daniel Rosenbergad3d3c12016-06-27 23:03:48 -07001124
Daniel Rosenberg80919472016-06-30 19:25:31 -07001125 char next = (current_slot[0] - 'a' + 1)%count + 'a';
1126 return std::string(1, next);
1127}
1128
Aaron Wisnerdb511202018-06-26 15:38:35 -05001129static std::string get_other_slot(const std::string& current_slot) {
1130 return get_other_slot(current_slot, get_slot_count());
Daniel Rosenberg80919472016-06-30 19:25:31 -07001131}
1132
Aaron Wisnerdb511202018-06-26 15:38:35 -05001133static std::string get_other_slot(int count) {
1134 return get_other_slot(get_current_slot(), count);
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07001135}
1136
Aaron Wisnerdb511202018-06-26 15:38:35 -05001137static std::string get_other_slot() {
1138 return get_other_slot(get_current_slot(), get_slot_count());
Alex Lightbb9b8a52016-06-29 09:26:44 -07001139}
1140
Aaron Wisnerdb511202018-06-26 15:38:35 -05001141static std::string verify_slot(const std::string& slot_name, bool allow_all) {
Daniel Rosenberg80919472016-06-30 19:25:31 -07001142 std::string slot = slot_name;
Daniel Rosenberg80919472016-06-30 19:25:31 -07001143 if (slot == "all") {
Daniel Rosenberg9b432052015-11-25 15:17:10 -08001144 if (allow_all) {
1145 return "all";
1146 } else {
Aaron Wisnerdb511202018-06-26 15:38:35 -05001147 int count = get_slot_count();
Daniel Rosenberg80919472016-06-30 19:25:31 -07001148 if (count > 0) {
1149 return "a";
Daniel Rosenberg9b432052015-11-25 15:17:10 -08001150 } else {
Elliott Hughes4089d342017-10-27 14:21:12 -07001151 die("No known slots");
Daniel Rosenberg9b432052015-11-25 15:17:10 -08001152 }
1153 }
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07001154 }
Daniel Rosenbergc1743ba2016-01-05 16:54:40 -08001155
Aaron Wisnerdb511202018-06-26 15:38:35 -05001156 int count = get_slot_count();
Elliott Hughes4089d342017-10-27 14:21:12 -07001157 if (count == 0) die("Device does not support slots");
Daniel Rosenbergc1743ba2016-01-05 16:54:40 -08001158
Daniel Rosenberg80919472016-06-30 19:25:31 -07001159 if (slot == "other") {
Aaron Wisnerdb511202018-06-26 15:38:35 -05001160 std::string other = get_other_slot( count);
Daniel Rosenbergad3d3c12016-06-27 23:03:48 -07001161 if (other == "") {
Elliott Hughes4089d342017-10-27 14:21:12 -07001162 die("No known slots");
Daniel Rosenbergc1743ba2016-01-05 16:54:40 -08001163 }
Daniel Rosenbergad3d3c12016-06-27 23:03:48 -07001164 return other;
Daniel Rosenbergc1743ba2016-01-05 16:54:40 -08001165 }
1166
Daniel Rosenberg80919472016-06-30 19:25:31 -07001167 if (slot.size() == 1 && (slot[0]-'a' >= 0 && slot[0]-'a' < count)) return slot;
1168
1169 fprintf(stderr, "Slot %s does not exist. supported slots are:\n", slot.c_str());
1170 for (int i=0; i<count; i++) {
1171 fprintf(stderr, "%c\n", (char)(i + 'a'));
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07001172 }
Daniel Rosenberg80919472016-06-30 19:25:31 -07001173
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07001174 exit(1);
1175}
1176
Aaron Wisnerdb511202018-06-26 15:38:35 -05001177static std::string verify_slot(const std::string& slot) {
1178 return verify_slot(slot, true);
Daniel Rosenberg9b432052015-11-25 15:17:10 -08001179}
1180
Aaron Wisnerdb511202018-06-26 15:38:35 -05001181static void do_for_partition(const std::string& part, const std::string& slot,
Chih-Hung Hsieh8f7b9e32016-07-27 16:25:51 -07001182 const std::function<void(const std::string&)>& func, bool force_slot) {
Daniel Rosenberga7974792015-11-11 16:13:13 -08001183 std::string has_slot;
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07001184 std::string current_slot;
1185
Tom Cherry9027af02018-09-24 15:48:09 -07001186 if (fb->GetVar("has-slot:" + part, &has_slot) != fastboot::SUCCESS) {
Daniel Rosenberga7974792015-11-11 16:13:13 -08001187 /* If has-slot is not supported, the answer is no. */
1188 has_slot = "no";
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07001189 }
Daniel Rosenberga7974792015-11-11 16:13:13 -08001190 if (has_slot == "yes") {
Daniel Rosenberg80919472016-06-30 19:25:31 -07001191 if (slot == "") {
Aaron Wisnerdb511202018-06-26 15:38:35 -05001192 current_slot = get_current_slot();
Daniel Rosenberg80919472016-06-30 19:25:31 -07001193 if (current_slot == "") {
Elliott Hughes4089d342017-10-27 14:21:12 -07001194 die("Failed to identify current slot");
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07001195 }
Daniel Rosenberg80919472016-06-30 19:25:31 -07001196 func(part + "_" + current_slot);
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07001197 } else {
Daniel Rosenberg80919472016-06-30 19:25:31 -07001198 func(part + '_' + slot);
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07001199 }
1200 } else {
Daniel Rosenberg80919472016-06-30 19:25:31 -07001201 if (force_slot && slot != "") {
David Pursell0b156632015-10-30 11:22:01 -07001202 fprintf(stderr, "Warning: %s does not support slots, and slot %s was requested.\n",
Daniel Rosenberg80919472016-06-30 19:25:31 -07001203 part.c_str(), slot.c_str());
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07001204 }
1205 func(part);
1206 }
1207}
1208
David Pursell0b156632015-10-30 11:22:01 -07001209/* This function will find the real partition name given a base name, and a slot. If slot is NULL or
1210 * empty, it will use the current slot. If slot is "all", it will return a list of all possible
1211 * partition names. If force_slot is true, it will fail if a slot is specified, and the given
1212 * partition does not support slots.
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07001213 */
Aaron Wisnerdb511202018-06-26 15:38:35 -05001214static void do_for_partitions(const std::string& part, const std::string& slot,
Chih-Hung Hsieh8f7b9e32016-07-27 16:25:51 -07001215 const std::function<void(const std::string&)>& func, bool force_slot) {
Daniel Rosenberga7974792015-11-11 16:13:13 -08001216 std::string has_slot;
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07001217
Daniel Rosenberg80919472016-06-30 19:25:31 -07001218 if (slot == "all") {
Tom Cherry9027af02018-09-24 15:48:09 -07001219 if (fb->GetVar("has-slot:" + part, &has_slot) != fastboot::SUCCESS) {
Elliott Hughes4089d342017-10-27 14:21:12 -07001220 die("Could not check if partition %s has slot %s", part.c_str(), slot.c_str());
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07001221 }
Daniel Rosenberga7974792015-11-11 16:13:13 -08001222 if (has_slot == "yes") {
Aaron Wisnerdb511202018-06-26 15:38:35 -05001223 for (int i=0; i < get_slot_count(); i++) {
1224 do_for_partition(part, std::string(1, (char)(i + 'a')), func, force_slot);
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07001225 }
1226 } else {
Aaron Wisnerdb511202018-06-26 15:38:35 -05001227 do_for_partition(part, "", func, force_slot);
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07001228 }
1229 } else {
Aaron Wisnerdb511202018-06-26 15:38:35 -05001230 do_for_partition(part, slot, func, force_slot);
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07001231 }
1232}
1233
David Anderson629e51c2018-10-25 12:51:25 -07001234static bool is_logical(const std::string& partition) {
1235 std::string value;
1236 return fb->GetVar("is-logical:" + partition, &value) == fastboot::SUCCESS && value == "yes";
1237}
1238
David Anderson0c732342018-11-28 17:10:42 -08001239static bool is_retrofit_device() {
1240 std::string value;
1241 if (fb->GetVar("super-partition-name", &value) != fastboot::SUCCESS) {
1242 return false;
1243 }
1244 return android::base::StartsWith(value, "system_");
1245}
1246
Aaron Wisnerdb511202018-06-26 15:38:35 -05001247static void do_flash(const char* pname, const char* fname) {
Rom Lemarchand622810c2013-06-28 09:54:59 -07001248 struct fastboot_buffer buf;
1249
Aaron Wisnerdb511202018-06-26 15:38:35 -05001250 if (!load_buf(fname, &buf)) {
Elliott Hughes53ec4952016-05-11 12:39:27 -07001251 die("cannot load '%s': %s", fname, strerror(errno));
Rom Lemarchand622810c2013-06-28 09:54:59 -07001252 }
David Anderson629e51c2018-10-25 12:51:25 -07001253 if (is_logical(pname)) {
1254 fb->ResizePartition(pname, std::to_string(buf.image_size));
1255 }
Rom Lemarchand622810c2013-06-28 09:54:59 -07001256 flash_buf(pname, &buf);
Colin Crossf8387882012-05-24 17:18:41 -07001257}
1258
Daniel Rosenberg13454092016-06-27 19:43:11 -07001259// Sets slot_override as the active slot. If slot_override is blank,
1260// set current slot as active instead. This clears slot-unbootable.
Aaron Wisnerdb511202018-06-26 15:38:35 -05001261static void set_active(const std::string& slot_override) {
1262 if (!supports_AB()) return;
Elliott Hughes42b18a52018-04-10 15:32:21 -07001263
Daniel Rosenberg80919472016-06-30 19:25:31 -07001264 if (slot_override != "") {
Tom Cherry9027af02018-09-24 15:48:09 -07001265 fb->SetActive(slot_override);
Daniel Rosenberg13454092016-06-27 19:43:11 -07001266 } else {
Aaron Wisnerdb511202018-06-26 15:38:35 -05001267 std::string current_slot = get_current_slot();
Daniel Rosenberg80919472016-06-30 19:25:31 -07001268 if (current_slot != "") {
Tom Cherry9027af02018-09-24 15:48:09 -07001269 fb->SetActive(current_slot);
Daniel Rosenberg13454092016-06-27 19:43:11 -07001270 }
1271 }
1272}
1273
David Anderson32e376f2018-08-16 13:43:11 -07001274static bool is_userspace_fastboot() {
1275 std::string value;
Tom Cherry9027af02018-09-24 15:48:09 -07001276 return fb->GetVar("is-userspace", &value) == fastboot::SUCCESS && value == "yes";
David Anderson32e376f2018-08-16 13:43:11 -07001277}
1278
David Anderson1d887432018-08-27 16:47:32 -07001279static void reboot_to_userspace_fastboot() {
Tom Cherry9027af02018-09-24 15:48:09 -07001280 fb->RebootTo("fastboot");
1281
1282 auto* old_transport = fb->set_transport(nullptr);
1283 delete old_transport;
David Anderson1d887432018-08-27 16:47:32 -07001284
1285 // Give the current connection time to close.
1286 std::this_thread::sleep_for(std::chrono::milliseconds(1000));
1287
Tom Cherry9027af02018-09-24 15:48:09 -07001288 fb->set_transport(open_device());
David Anderson11d6d272018-12-07 16:39:07 -08001289
1290 if (!is_userspace_fastboot()) {
1291 die("Failed to boot into userspace fastboot; one or more components might be unbootable.");
1292 }
Hridya Valsaraju83d856e2019-05-17 14:24:19 -07001293
1294 // Reset target_sparse_limit after reboot to userspace fastboot. Max
1295 // download sizes may differ in bootloader and fastbootd.
1296 target_sparse_limit = -1;
David Anderson1d887432018-08-27 16:47:32 -07001297}
1298
David Andersonab8f4662019-10-21 16:45:59 -07001299static void CancelSnapshotIfNeeded() {
1300 std::string merge_status = "none";
1301 if (fb->GetVar(FB_VAR_SNAPSHOT_UPDATE_STATUS, &merge_status) == fastboot::SUCCESS &&
Elliott Hughes6a7ff582020-06-05 14:06:15 -07001302 !merge_status.empty() && merge_status != "none") {
Yifan Hong712c32b2019-12-10 18:11:13 -08001303 fb->SnapshotUpdateCommand("cancel");
David Andersonab8f4662019-10-21 16:45:59 -07001304 }
1305}
1306
David Andersoncf444f32018-08-29 14:15:49 -07001307class ImageSource {
1308 public:
Tom Cherrydfd85df2018-09-20 14:45:05 -07001309 virtual bool ReadFile(const std::string& name, std::vector<char>* out) const = 0;
David Andersoncf444f32018-08-29 14:15:49 -07001310 virtual int OpenFile(const std::string& name) const = 0;
1311};
David Anderson32e376f2018-08-16 13:43:11 -07001312
David Andersoncf444f32018-08-29 14:15:49 -07001313class FlashAllTool {
1314 public:
1315 FlashAllTool(const ImageSource& source, const std::string& slot_override, bool skip_secondary, bool wipe);
David Anderson32e376f2018-08-16 13:43:11 -07001316
David Andersoncf444f32018-08-29 14:15:49 -07001317 void Flash();
David Anderson32e376f2018-08-16 13:43:11 -07001318
David Andersoncf444f32018-08-29 14:15:49 -07001319 private:
1320 void CheckRequirements();
1321 void DetermineSecondarySlot();
1322 void CollectImages();
1323 void FlashImages(const std::vector<std::pair<const Image*, std::string>>& images);
1324 void FlashImage(const Image& image, const std::string& slot, fastboot_buffer* buf);
1325 void UpdateSuperPartition();
David Anderson32e376f2018-08-16 13:43:11 -07001326
David Andersoncf444f32018-08-29 14:15:49 -07001327 const ImageSource& source_;
1328 std::string slot_override_;
1329 bool skip_secondary_;
1330 bool wipe_;
1331 std::string secondary_slot_;
1332 std::vector<std::pair<const Image*, std::string>> boot_images_;
1333 std::vector<std::pair<const Image*, std::string>> os_images_;
1334};
1335
1336FlashAllTool::FlashAllTool(const ImageSource& source, const std::string& slot_override, bool skip_secondary, bool wipe)
1337 : source_(source),
1338 slot_override_(slot_override),
1339 skip_secondary_(skip_secondary),
1340 wipe_(wipe)
1341{
David Anderson32e376f2018-08-16 13:43:11 -07001342}
1343
David Andersoncf444f32018-08-29 14:15:49 -07001344void FlashAllTool::Flash() {
Tom Cherry9027af02018-09-24 15:48:09 -07001345 DumpInfo();
David Andersoncf444f32018-08-29 14:15:49 -07001346 CheckRequirements();
David Anderson96a9fd42018-11-05 15:21:44 -08001347
1348 // Change the slot first, so we boot into the correct recovery image when
1349 // using fastbootd.
1350 if (slot_override_ == "all") {
1351 set_active("a");
1352 } else {
1353 set_active(slot_override_);
1354 }
1355
David Andersoncf444f32018-08-29 14:15:49 -07001356 DetermineSecondarySlot();
1357 CollectImages();
David Anderson32e376f2018-08-16 13:43:11 -07001358
David Andersonab8f4662019-10-21 16:45:59 -07001359 CancelSnapshotIfNeeded();
1360
David Anderson95d40932018-08-28 12:14:33 -07001361 // First flash boot partitions. We allow this to happen either in userspace
1362 // or in bootloader fastboot.
David Andersoncf444f32018-08-29 14:15:49 -07001363 FlashImages(boot_images_);
David Anderson95d40932018-08-28 12:14:33 -07001364
1365 // Sync the super partition. This will reboot to userspace fastboot if needed.
David Andersoncf444f32018-08-29 14:15:49 -07001366 UpdateSuperPartition();
David Anderson95d40932018-08-28 12:14:33 -07001367
1368 // Resize any logical partition to 0, so each partition is reset to 0
1369 // extents, and will achieve more optimal allocation.
David Andersoncf444f32018-08-29 14:15:49 -07001370 for (const auto& [image, slot] : os_images_) {
David Anderson32e376f2018-08-16 13:43:11 -07001371 auto resize_partition = [](const std::string& partition) -> void {
1372 if (is_logical(partition)) {
Tom Cherry9027af02018-09-24 15:48:09 -07001373 fb->ResizePartition(partition, "0");
David Anderson32e376f2018-08-16 13:43:11 -07001374 }
1375 };
David Anderson95d40932018-08-28 12:14:33 -07001376 do_for_partitions(image->part_name, slot, resize_partition, false);
David Anderson32e376f2018-08-16 13:43:11 -07001377 }
1378
David Anderson95d40932018-08-28 12:14:33 -07001379 // Flash OS images, resizing logical partitions as needed.
David Andersoncf444f32018-08-29 14:15:49 -07001380 FlashImages(os_images_);
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -08001381}
1382
David Andersoncf444f32018-08-29 14:15:49 -07001383void FlashAllTool::CheckRequirements() {
Tom Cherrydfd85df2018-09-20 14:45:05 -07001384 std::vector<char> contents;
1385 if (!source_.ReadFile("android-info.txt", &contents)) {
David Andersoncf444f32018-08-29 14:15:49 -07001386 die("could not read android-info.txt");
1387 }
Tom Cherry4aa60b32018-09-05 15:11:44 -07001388 ::CheckRequirements({contents.data(), contents.size()});
David Andersoncf444f32018-08-29 14:15:49 -07001389}
1390
1391void FlashAllTool::DetermineSecondarySlot() {
1392 if (skip_secondary_) {
1393 return;
1394 }
David Anderson96a9fd42018-11-05 15:21:44 -08001395 if (slot_override_ != "" && slot_override_ != "all") {
David Andersoncf444f32018-08-29 14:15:49 -07001396 secondary_slot_ = get_other_slot(slot_override_);
1397 } else {
1398 secondary_slot_ = get_other_slot();
1399 }
1400 if (secondary_slot_ == "") {
1401 if (supports_AB()) {
1402 fprintf(stderr, "Warning: Could not determine slot for secondary images. Ignoring.\n");
1403 }
1404 skip_secondary_ = true;
1405 }
1406}
1407
1408void FlashAllTool::CollectImages() {
1409 for (size_t i = 0; i < arraysize(images); ++i) {
1410 std::string slot = slot_override_;
1411 if (images[i].IsSecondary()) {
1412 if (skip_secondary_) {
1413 continue;
1414 }
1415 slot = secondary_slot_;
1416 }
1417 if (images[i].type == ImageType::BootCritical) {
1418 boot_images_.emplace_back(&images[i], slot);
1419 } else if (images[i].type == ImageType::Normal) {
1420 os_images_.emplace_back(&images[i], slot);
1421 }
1422 }
1423}
1424
1425void FlashAllTool::FlashImages(const std::vector<std::pair<const Image*, std::string>>& images) {
1426 for (const auto& [image, slot] : images) {
1427 fastboot_buffer buf;
1428 int fd = source_.OpenFile(image->img_name);
1429 if (fd < 0 || !load_buf_fd(fd, &buf)) {
1430 if (image->optional_if_no_image) {
1431 continue;
1432 }
1433 die("could not load '%s': %s", image->img_name, strerror(errno));
1434 }
1435 FlashImage(*image, slot, &buf);
1436 }
1437}
1438
1439void FlashAllTool::FlashImage(const Image& image, const std::string& slot, fastboot_buffer* buf) {
1440 auto flash = [&, this](const std::string& partition_name) {
Tom Cherrydfd85df2018-09-20 14:45:05 -07001441 std::vector<char> signature_data;
1442 if (source_.ReadFile(image.sig_name, &signature_data)) {
Tom Cherry9027af02018-09-24 15:48:09 -07001443 fb->Download("signature", signature_data);
1444 fb->RawCommand("signature", "installing signature");
David Andersoncf444f32018-08-29 14:15:49 -07001445 }
1446
1447 if (is_logical(partition_name)) {
Tom Cherry9027af02018-09-24 15:48:09 -07001448 fb->ResizePartition(partition_name, std::to_string(buf->image_size));
David Andersoncf444f32018-08-29 14:15:49 -07001449 }
1450 flash_buf(partition_name.c_str(), buf);
1451 };
1452 do_for_partitions(image.part_name, slot, flash, false);
1453}
1454
1455void FlashAllTool::UpdateSuperPartition() {
David Andersoncf444f32018-08-29 14:15:49 -07001456 int fd = source_.OpenFile("super_empty.img");
1457 if (fd < 0) {
1458 return;
1459 }
1460 if (!is_userspace_fastboot()) {
1461 reboot_to_userspace_fastboot();
1462 }
David Andersoncf444f32018-08-29 14:15:49 -07001463
David Anderson90fe0a42018-11-05 18:01:32 -08001464 std::string super_name;
1465 if (fb->GetVar("super-partition-name", &super_name) != fastboot::RetCode::SUCCESS) {
1466 super_name = "super";
1467 }
1468 fb->Download(super_name, fd, get_file_size(fd));
1469
1470 std::string command = "update-super:" + super_name;
David Andersoncf444f32018-08-29 14:15:49 -07001471 if (wipe_) {
1472 command += ":wipe";
1473 }
Tom Cherry9027af02018-09-24 15:48:09 -07001474 fb->RawCommand(command, "Updating super partition");
David Anderson0c732342018-11-28 17:10:42 -08001475
1476 // Retrofit devices have two super partitions, named super_a and super_b.
1477 // On these devices, secondary slots must be flashed as physical
1478 // partitions (otherwise they would not mount on first boot). To enforce
1479 // this, we delete any logical partitions for the "other" slot.
1480 if (is_retrofit_device()) {
1481 for (const auto& [image, slot] : os_images_) {
1482 std::string partition_name = image->part_name + "_"s + slot;
1483 if (image->IsSecondary() && is_logical(partition_name)) {
1484 fb->DeletePartition(partition_name);
1485 }
1486 }
1487 }
David Andersoncf444f32018-08-29 14:15:49 -07001488}
1489
1490class ZipImageSource final : public ImageSource {
1491 public:
1492 explicit ZipImageSource(ZipArchiveHandle zip) : zip_(zip) {}
Tom Cherrydfd85df2018-09-20 14:45:05 -07001493 bool ReadFile(const std::string& name, std::vector<char>* out) const override;
David Andersoncf444f32018-08-29 14:15:49 -07001494 int OpenFile(const std::string& name) const override;
1495
1496 private:
1497 ZipArchiveHandle zip_;
1498};
1499
Tom Cherrydfd85df2018-09-20 14:45:05 -07001500bool ZipImageSource::ReadFile(const std::string& name, std::vector<char>* out) const {
1501 return UnzipToMemory(zip_, name, out);
David Andersoncf444f32018-08-29 14:15:49 -07001502}
1503
1504int ZipImageSource::OpenFile(const std::string& name) const {
1505 return unzip_to_file(zip_, name.c_str());
1506}
1507
1508static void do_update(const char* filename, const std::string& slot_override, bool skip_secondary) {
David Andersoncf444f32018-08-29 14:15:49 -07001509 ZipArchiveHandle zip;
1510 int error = OpenArchive(filename, &zip);
1511 if (error != 0) {
1512 die("failed to open zip file '%s': %s", filename, ErrorCodeString(error));
1513 }
1514
1515 FlashAllTool tool(ZipImageSource(zip), slot_override, skip_secondary, false);
1516 tool.Flash();
1517
1518 CloseArchive(zip);
1519}
1520
1521class LocalImageSource final : public ImageSource {
1522 public:
Tom Cherrydfd85df2018-09-20 14:45:05 -07001523 bool ReadFile(const std::string& name, std::vector<char>* out) const override;
David Andersoncf444f32018-08-29 14:15:49 -07001524 int OpenFile(const std::string& name) const override;
1525};
1526
Tom Cherrydfd85df2018-09-20 14:45:05 -07001527bool LocalImageSource::ReadFile(const std::string& name, std::vector<char>* out) const {
David Andersoncf444f32018-08-29 14:15:49 -07001528 auto path = find_item_given_name(name);
1529 if (path.empty()) {
Tom Cherrydfd85df2018-09-20 14:45:05 -07001530 return false;
David Andersoncf444f32018-08-29 14:15:49 -07001531 }
Tom Cherrydfd85df2018-09-20 14:45:05 -07001532 return ReadFileToVector(path, out);
David Andersoncf444f32018-08-29 14:15:49 -07001533}
1534
1535int LocalImageSource::OpenFile(const std::string& name) const {
1536 auto path = find_item_given_name(name);
Hridya Valsaraju1a6f6fe2019-04-03 17:57:00 -07001537 return open(path.c_str(), O_RDONLY | O_BINARY);
David Andersoncf444f32018-08-29 14:15:49 -07001538}
1539
1540static void do_flashall(const std::string& slot_override, bool skip_secondary, bool wipe) {
David Andersoncf444f32018-08-29 14:15:49 -07001541 FlashAllTool tool(LocalImageSource(), slot_override, skip_secondary, wipe);
1542 tool.Flash();
1543}
1544
Elliott Hughesd6365a72017-05-08 18:04:49 -07001545static std::string next_arg(std::vector<std::string>* args) {
1546 if (args->empty()) syntax_error("expected argument");
1547 std::string result = args->front();
1548 args->erase(args->begin());
1549 return result;
Patrick Tjin51e8b032015-09-01 08:15:23 -07001550}
1551
Elliott Hughes1eec97a2017-05-15 16:53:53 -07001552static void do_oem_command(const std::string& cmd, std::vector<std::string>* args) {
Elliott Hughesd6365a72017-05-08 18:04:49 -07001553 if (args->empty()) syntax_error("empty oem command");
Tsu Chiang Chuangee520552011-02-25 18:38:53 -08001554
Elliott Hughes1eec97a2017-05-15 16:53:53 -07001555 std::string command(cmd);
Elliott Hughesd6365a72017-05-08 18:04:49 -07001556 while (!args->empty()) {
Elliott Hughes29d5d7d2017-05-11 15:05:13 -07001557 command += " " + next_arg(args);
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -08001558 }
Tom Cherry9027af02018-09-24 15:48:09 -07001559 fb->RawCommand(command, "");
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -08001560}
1561
Aaron Wisnerdb511202018-06-26 15:38:35 -05001562static unsigned fb_get_flash_block_size(std::string name) {
Connor O'Brience16a8a2017-02-06 14:39:31 -08001563 std::string sizeString;
Tom Cherry9027af02018-09-24 15:48:09 -07001564 if (fb->GetVar(name, &sizeString) != fastboot::SUCCESS || sizeString.empty()) {
Elliott Hughes5620d222018-03-28 08:20:00 -07001565 // This device does not report flash block sizes, so return 0.
Connor O'Brience16a8a2017-02-06 14:39:31 -08001566 return 0;
1567 }
1568 sizeString = fb_fix_numeric_var(sizeString);
1569
1570 unsigned size;
1571 if (!android::base::ParseUint(sizeString, &size)) {
1572 fprintf(stderr, "Couldn't parse %s '%s'.\n", name.c_str(), sizeString.c_str());
1573 return 0;
1574 }
Connor O'Brien6ef5c242017-11-01 17:37:32 -07001575 if ((size & (size - 1)) != 0) {
1576 fprintf(stderr, "Invalid %s %u: must be a power of 2.\n", name.c_str(), size);
Connor O'Brience16a8a2017-02-06 14:39:31 -08001577 return 0;
1578 }
1579 return size;
1580}
1581
Aaron Wisnerdb511202018-06-26 15:38:35 -05001582static void fb_perform_format(
Elliott Hughes5620d222018-03-28 08:20:00 -07001583 const std::string& partition, int skip_if_not_supported,
Elliott Hughesd6365a72017-05-08 18:04:49 -07001584 const std::string& type_override, const std::string& size_override,
Paul Crowley8f7f56e2015-11-27 09:29:37 +00001585 const std::string& initial_dir) {
Elliott Hughes2fd45a92015-10-30 11:49:47 -07001586 std::string partition_type, partition_size;
1587
Dmitry Grinberge6f3e9b2014-03-11 18:28:15 -07001588 struct fastboot_buffer buf;
Elliott Hughes2fd45a92015-10-30 11:49:47 -07001589 const char* errMsg = nullptr;
1590 const struct fs_generator* gen = nullptr;
Jin Qian4a335822017-04-18 16:23:18 -07001591 TemporaryFile output;
1592 unique_fd fd;
Dmitry Grinberge6f3e9b2014-03-11 18:28:15 -07001593
Elliott Hughes2fd45a92015-10-30 11:49:47 -07001594 unsigned int limit = INT_MAX;
1595 if (target_sparse_limit > 0 && target_sparse_limit < limit) {
Dmitry Grinberge6f3e9b2014-03-11 18:28:15 -07001596 limit = target_sparse_limit;
Elliott Hughes2fd45a92015-10-30 11:49:47 -07001597 }
1598 if (sparse_limit > 0 && sparse_limit < limit) {
Dmitry Grinberge6f3e9b2014-03-11 18:28:15 -07001599 limit = sparse_limit;
Elliott Hughes2fd45a92015-10-30 11:49:47 -07001600 }
Dmitry Grinberge6f3e9b2014-03-11 18:28:15 -07001601
Tom Cherry9027af02018-09-24 15:48:09 -07001602 if (fb->GetVar("partition-type:" + partition, &partition_type) != fastboot::SUCCESS) {
Dmitry Grinberge6f3e9b2014-03-11 18:28:15 -07001603 errMsg = "Can't determine partition type.\n";
1604 goto failed;
1605 }
Elliott Hughesd6365a72017-05-08 18:04:49 -07001606 if (!type_override.empty()) {
Elliott Hughes2fd45a92015-10-30 11:49:47 -07001607 if (partition_type != type_override) {
1608 fprintf(stderr, "Warning: %s type is %s, but %s was requested for formatting.\n",
Elliott Hughes5620d222018-03-28 08:20:00 -07001609 partition.c_str(), partition_type.c_str(), type_override.c_str());
JP Abgrall7e859742014-05-06 15:14:15 -07001610 }
Elliott Hughes2fd45a92015-10-30 11:49:47 -07001611 partition_type = type_override;
JP Abgrall7e859742014-05-06 15:14:15 -07001612 }
Dmitry Grinberge6f3e9b2014-03-11 18:28:15 -07001613
Tom Cherry9027af02018-09-24 15:48:09 -07001614 if (fb->GetVar("partition-size:" + partition, &partition_size) != fastboot::SUCCESS) {
Dmitry Grinberge6f3e9b2014-03-11 18:28:15 -07001615 errMsg = "Unable to get partition size\n";
1616 goto failed;
1617 }
Elliott Hughesd6365a72017-05-08 18:04:49 -07001618 if (!size_override.empty()) {
Elliott Hughes2fd45a92015-10-30 11:49:47 -07001619 if (partition_size != size_override) {
1620 fprintf(stderr, "Warning: %s size is %s, but %s was requested for formatting.\n",
Elliott Hughes5620d222018-03-28 08:20:00 -07001621 partition.c_str(), partition_size.c_str(), size_override.c_str());
JP Abgrall7e859742014-05-06 15:14:15 -07001622 }
Elliott Hughes2fd45a92015-10-30 11:49:47 -07001623 partition_size = size_override;
JP Abgrall7e859742014-05-06 15:14:15 -07001624 }
Connor O'Brience16a8a2017-02-06 14:39:31 -08001625 partition_size = fb_fix_numeric_var(partition_size);
Dmitry Grinberge6f3e9b2014-03-11 18:28:15 -07001626
Elliott Hughes8ab9a322015-11-02 14:05:57 -08001627 gen = fs_get_generator(partition_type);
Dmitry Grinberge6f3e9b2014-03-11 18:28:15 -07001628 if (!gen) {
1629 if (skip_if_not_supported) {
1630 fprintf(stderr, "Erase successful, but not automatically formatting.\n");
Elliott Hughes2fd45a92015-10-30 11:49:47 -07001631 fprintf(stderr, "File system type %s not supported.\n", partition_type.c_str());
Dmitry Grinberge6f3e9b2014-03-11 18:28:15 -07001632 return;
1633 }
Mark Salyzyna30b6962018-11-20 11:04:15 -08001634 die("Formatting is not supported for file system with type '%s'.",
1635 partition_type.c_str());
Dmitry Grinberge6f3e9b2014-03-11 18:28:15 -07001636 }
1637
Elliott Hughes2fd45a92015-10-30 11:49:47 -07001638 int64_t size;
Elliott Hughesda46b392016-10-11 17:09:00 -07001639 if (!android::base::ParseInt(partition_size, &size)) {
Mark Salyzyna30b6962018-11-20 11:04:15 -08001640 die("Couldn't parse partition size '%s'.", partition_size.c_str());
Elliott Hughes2fd45a92015-10-30 11:49:47 -07001641 }
Dmitry Grinberge6f3e9b2014-03-11 18:28:15 -07001642
Connor O'Brience16a8a2017-02-06 14:39:31 -08001643 unsigned eraseBlkSize, logicalBlkSize;
Aaron Wisnerdb511202018-06-26 15:38:35 -05001644 eraseBlkSize = fb_get_flash_block_size("erase-block-size");
1645 logicalBlkSize = fb_get_flash_block_size("logical-block-size");
Connor O'Brience16a8a2017-02-06 14:39:31 -08001646
Jin Qian4a335822017-04-18 16:23:18 -07001647 if (fs_generator_generate(gen, output.path, size, initial_dir,
1648 eraseBlkSize, logicalBlkSize)) {
Elliott Hughes5620d222018-03-28 08:20:00 -07001649 die("Cannot generate image for %s", partition.c_str());
Dmitry Grinberge6f3e9b2014-03-11 18:28:15 -07001650 }
1651
Jin Qian4a335822017-04-18 16:23:18 -07001652 fd.reset(open(output.path, O_RDONLY));
1653 if (fd == -1) {
Mark Salyzyna30b6962018-11-20 11:04:15 -08001654 die("Cannot open generated image: %s", strerror(errno));
Jin Qian4a335822017-04-18 16:23:18 -07001655 }
Aaron Wisnerdb511202018-06-26 15:38:35 -05001656 if (!load_buf_fd(fd.release(), &buf)) {
Mark Salyzyna30b6962018-11-20 11:04:15 -08001657 die("Cannot read image: %s", strerror(errno));
Dmitry Grinberge6f3e9b2014-03-11 18:28:15 -07001658 }
1659 flash_buf(partition, &buf);
Dmitry Grinberge6f3e9b2014-03-11 18:28:15 -07001660 return;
1661
Dmitry Grinberge6f3e9b2014-03-11 18:28:15 -07001662failed:
1663 if (skip_if_not_supported) {
1664 fprintf(stderr, "Erase successful, but not automatically formatting.\n");
Elliott Hughes2fd45a92015-10-30 11:49:47 -07001665 if (errMsg) fprintf(stderr, "%s", errMsg);
Dmitry Grinberge6f3e9b2014-03-11 18:28:15 -07001666 }
Tom Cherry9027af02018-09-24 15:48:09 -07001667 fprintf(stderr, "FAILED (%s)\n", fb->Error().c_str());
Mark Salyzyna30b6962018-11-20 11:04:15 -08001668 if (!skip_if_not_supported) {
1669 die("Command failed");
1670 }
Dmitry Grinberge6f3e9b2014-03-11 18:28:15 -07001671}
1672
David Anderson89569642018-11-16 15:53:35 -08001673static bool should_flash_in_userspace(const std::string& partition_name) {
David Andersone0e693c2018-11-27 20:19:26 -08001674 if (!get_android_product_out()) {
1675 return false;
1676 }
David Anderson89569642018-11-16 15:53:35 -08001677 auto path = find_item_given_name("super_empty.img");
David Anderson00475802018-12-04 17:05:47 -08001678 if (path.empty() || access(path.c_str(), R_OK)) {
David Anderson89569642018-11-16 15:53:35 -08001679 return false;
1680 }
1681 auto metadata = android::fs_mgr::ReadFromImageFile(path);
1682 if (!metadata) {
1683 return false;
1684 }
1685 for (const auto& partition : metadata->partitions) {
1686 auto candidate = android::fs_mgr::GetPartitionName(partition);
1687 if (partition.attributes & LP_PARTITION_ATTR_SLOT_SUFFIXED) {
1688 // On retrofit devices, we don't know if, or whether, the A or B
1689 // slot has been flashed for dynamic partitions. Instead we add
1690 // both names to the list as a conservative guess.
1691 if (candidate + "_a" == partition_name || candidate + "_b" == partition_name) {
1692 return true;
1693 }
1694 } else if (candidate == partition_name) {
1695 return true;
1696 }
1697 }
1698 return false;
1699}
1700
David Anderson7c84b9f2019-06-27 22:15:29 -07001701static bool wipe_super(const android::fs_mgr::LpMetadata& metadata, const std::string& slot,
1702 std::string* message) {
1703 auto super_device = GetMetadataSuperBlockDevice(metadata);
1704 auto block_size = metadata.geometry.logical_block_size;
1705 auto super_bdev_name = android::fs_mgr::GetBlockDevicePartitionName(*super_device);
1706
1707 if (super_bdev_name != "super") {
1708 // retrofit devices do not allow flashing to the retrofit partitions,
1709 // so enable it if we can.
1710 fb->RawCommand("oem allow-flash-super");
1711 }
1712
1713 // Note: do not use die() in here, since we want TemporaryDir's destructor
1714 // to be called.
1715 TemporaryDir temp_dir;
1716
1717 bool ok;
1718 if (metadata.block_devices.size() > 1) {
1719 ok = WriteSplitImageFiles(temp_dir.path, metadata, block_size, {}, true);
1720 } else {
1721 auto image_path = temp_dir.path + "/"s + super_bdev_name + ".img";
1722 ok = WriteToImageFile(image_path, metadata, block_size, {}, true);
1723 }
1724 if (!ok) {
1725 *message = "Could not generate a flashable super image file";
1726 return false;
1727 }
1728
1729 for (const auto& block_device : metadata.block_devices) {
1730 auto partition = android::fs_mgr::GetBlockDevicePartitionName(block_device);
1731 bool force_slot = !!(block_device.flags & LP_BLOCK_DEVICE_SLOT_SUFFIXED);
1732
1733 std::string image_name;
1734 if (metadata.block_devices.size() > 1) {
1735 image_name = "super_" + partition + ".img";
1736 } else {
1737 image_name = partition + ".img";
1738 }
1739
1740 auto image_path = temp_dir.path + "/"s + image_name;
1741 auto flash = [&](const std::string& partition_name) {
1742 do_flash(partition_name.c_str(), image_path.c_str());
1743 };
1744 do_for_partitions(partition, slot, flash, force_slot);
1745
1746 unlink(image_path.c_str());
1747 }
1748 return true;
1749}
1750
1751static void do_wipe_super(const std::string& image, const std::string& slot_override) {
1752 if (access(image.c_str(), R_OK) != 0) {
1753 die("Could not read image: %s", image.c_str());
1754 }
1755 auto metadata = android::fs_mgr::ReadFromImageFile(image);
1756 if (!metadata) {
1757 die("Could not parse image: %s", image.c_str());
1758 }
1759
1760 auto slot = slot_override;
1761 if (slot.empty()) {
1762 slot = get_current_slot();
1763 }
1764
1765 std::string message;
1766 if (!wipe_super(*metadata.get(), slot, &message)) {
1767 die(message);
1768 }
1769}
1770
Aaron Wisnerdb511202018-06-26 15:38:35 -05001771int FastBootTool::Main(int argc, char* argv[]) {
Daniel Rosenberg0d088562015-11-11 16:15:30 -08001772 bool wants_wipe = false;
1773 bool wants_reboot = false;
1774 bool wants_reboot_bootloader = false;
Hridya Valsarajudea91b42018-07-17 11:14:01 -07001775 bool wants_reboot_recovery = false;
1776 bool wants_reboot_fastboot = false;
Mitchell Wills31dce302016-09-26 10:26:21 -07001777 bool skip_reboot = false;
Daniel Rosenberg0d088562015-11-11 16:15:30 -08001778 bool wants_set_active = false;
Daniel Rosenberg92b44762016-07-13 20:03:25 -07001779 bool skip_secondary = false;
Paul Crowley8f7f56e2015-11-27 09:29:37 +00001780 bool set_fbe_marker = false;
David Anderson89569642018-11-16 15:53:35 -08001781 bool force_flash = false;
Florian Bäuerle27ded482014-11-24 11:29:34 +01001782 int longindex;
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07001783 std::string slot_override;
Daniel Rosenberg0d088562015-11-11 16:15:30 -08001784 std::string next_active;
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -08001785
Elliott Hughes577e8b42018-04-05 16:12:47 -07001786 g_boot_img_hdr.kernel_addr = 0x00008000;
1787 g_boot_img_hdr.ramdisk_addr = 0x01000000;
1788 g_boot_img_hdr.second_addr = 0x00f00000;
1789 g_boot_img_hdr.tags_addr = 0x00000100;
1790 g_boot_img_hdr.page_size = 2048;
Hridya Valsaraju6c8fca62019-01-24 12:47:08 -08001791 g_boot_img_hdr.dtb_addr = 0x01100000;
Elliott Hughes577e8b42018-04-05 16:12:47 -07001792
JP Abgrall7b8970c2013-03-07 17:06:41 -08001793 const struct option longopts[] = {
Elliott Hughes577e8b42018-04-05 16:12:47 -07001794 {"base", required_argument, 0, 0},
1795 {"cmdline", required_argument, 0, 0},
1796 {"disable-verification", no_argument, 0, 0},
1797 {"disable-verity", no_argument, 0, 0},
David Anderson89569642018-11-16 15:53:35 -08001798 {"force", no_argument, 0, 0},
Elliott Hughes577e8b42018-04-05 16:12:47 -07001799 {"header-version", required_argument, 0, 0},
Elliott Hughes379646b2015-06-02 13:50:00 -07001800 {"help", no_argument, 0, 'h'},
Elliott Hughes577e8b42018-04-05 16:12:47 -07001801 {"kernel-offset", required_argument, 0, 0},
1802 {"os-patch-level", required_argument, 0, 0},
1803 {"os-version", required_argument, 0, 0},
1804 {"page-size", required_argument, 0, 0},
1805 {"ramdisk-offset", required_argument, 0, 0},
Daniel Rosenberg7aa38bc2015-11-11 17:29:37 -08001806 {"set-active", optional_argument, 0, 'a'},
Mitchell Wills31dce302016-09-26 10:26:21 -07001807 {"skip-reboot", no_argument, 0, 0},
Elliott Hughes577e8b42018-04-05 16:12:47 -07001808 {"skip-secondary", no_argument, 0, 0},
1809 {"slot", required_argument, 0, 0},
1810 {"tags-offset", required_argument, 0, 0},
Hridya Valsaraju6c8fca62019-01-24 12:47:08 -08001811 {"dtb", required_argument, 0, 0},
1812 {"dtb-offset", required_argument, 0, 0},
Elliott Hughes577e8b42018-04-05 16:12:47 -07001813 {"unbuffered", no_argument, 0, 0},
Elliott Hughesf238d872018-03-29 14:46:29 -07001814 {"verbose", no_argument, 0, 'v'},
1815 {"version", no_argument, 0, 0},
Paul Crowley8f7f56e2015-11-27 09:29:37 +00001816#if !defined(_WIN32)
1817 {"wipe-and-use-fbe", no_argument, 0, 0},
1818#endif
JP Abgrall7b8970c2013-03-07 17:06:41 -08001819 {0, 0, 0, 0}
1820 };
Colin Cross8879f982012-05-22 17:53:34 -07001821
1822 serial = getenv("ANDROID_SERIAL");
1823
Elliott Hughes577e8b42018-04-05 16:12:47 -07001824 int c;
Elliott Hughesf3192bd2018-04-10 15:38:08 -07001825 while ((c = getopt_long(argc, argv, "a::hls:S:vw", longopts, &longindex)) != -1) {
Elliott Hughes577e8b42018-04-05 16:12:47 -07001826 if (c == 0) {
1827 std::string name{longopts[longindex].name};
1828 if (name == "base") {
1829 g_base_addr = strtoul(optarg, 0, 16);
1830 } else if (name == "cmdline") {
1831 g_cmdline = optarg;
1832 } else if (name == "disable-verification") {
1833 g_disable_verification = true;
1834 } else if (name == "disable-verity") {
1835 g_disable_verity = true;
David Anderson89569642018-11-16 15:53:35 -08001836 } else if (name == "force") {
1837 force_flash = true;
Elliott Hughes577e8b42018-04-05 16:12:47 -07001838 } else if (name == "header-version") {
1839 g_boot_img_hdr.header_version = strtoul(optarg, nullptr, 0);
Hridya Valsaraju6c8fca62019-01-24 12:47:08 -08001840 } else if (name == "dtb") {
1841 g_dtb_path = optarg;
Elliott Hughes577e8b42018-04-05 16:12:47 -07001842 } else if (name == "kernel-offset") {
1843 g_boot_img_hdr.kernel_addr = strtoul(optarg, 0, 16);
1844 } else if (name == "os-patch-level") {
Elliott Hughes6ebec932018-04-10 14:22:13 -07001845 ParseOsPatchLevel(&g_boot_img_hdr, optarg);
Elliott Hughes577e8b42018-04-05 16:12:47 -07001846 } else if (name == "os-version") {
Elliott Hughes6ebec932018-04-10 14:22:13 -07001847 ParseOsVersion(&g_boot_img_hdr, optarg);
Elliott Hughes577e8b42018-04-05 16:12:47 -07001848 } else if (name == "page-size") {
1849 g_boot_img_hdr.page_size = strtoul(optarg, nullptr, 0);
1850 if (g_boot_img_hdr.page_size == 0) die("invalid page size");
1851 } else if (name == "ramdisk-offset") {
1852 g_boot_img_hdr.ramdisk_addr = strtoul(optarg, 0, 16);
1853 } else if (name == "skip-reboot") {
1854 skip_reboot = true;
1855 } else if (name == "skip-secondary") {
1856 skip_secondary = true;
1857 } else if (name == "slot") {
1858 slot_override = optarg;
Hridya Valsaraju6c8fca62019-01-24 12:47:08 -08001859 } else if (name == "dtb-offset") {
1860 g_boot_img_hdr.dtb_addr = strtoul(optarg, 0, 16);
Elliott Hughes577e8b42018-04-05 16:12:47 -07001861 } else if (name == "tags-offset") {
1862 g_boot_img_hdr.tags_addr = strtoul(optarg, 0, 16);
1863 } else if (name == "unbuffered") {
Elliott Hughesfc797672015-04-07 20:12:50 -07001864 setvbuf(stdout, nullptr, _IONBF, 0);
1865 setvbuf(stderr, nullptr, _IONBF, 0);
Elliott Hughes577e8b42018-04-05 16:12:47 -07001866 } else if (name == "version") {
Dan Willemsenab971b52018-08-29 14:58:02 -07001867 fprintf(stdout, "fastboot version %s-%s\n", PLATFORM_TOOLS_VERSION, android::build::GetBuildNumber().c_str());
Elliott Hughes1fd46df2017-03-30 15:08:28 -07001868 fprintf(stdout, "Installed as %s\n", android::base::GetExecutablePath().c_str());
Elliott Hughes379646b2015-06-02 13:50:00 -07001869 return 0;
Paul Crowley8f7f56e2015-11-27 09:29:37 +00001870#if !defined(_WIN32)
Elliott Hughes577e8b42018-04-05 16:12:47 -07001871 } else if (name == "wipe-and-use-fbe") {
Paul Crowley8f7f56e2015-11-27 09:29:37 +00001872 wants_wipe = true;
1873 set_fbe_marker = true;
1874#endif
1875 } else {
Elliott Hughes855cdf82018-04-02 14:24:03 -07001876 die("unknown option %s", longopts[longindex].name);
Florian Bäuerle27ded482014-11-24 11:29:34 +01001877 }
Elliott Hughes577e8b42018-04-05 16:12:47 -07001878 } else {
1879 switch (c) {
1880 case 'a':
1881 wants_set_active = true;
1882 if (optarg) next_active = optarg;
1883 break;
1884 case 'h':
1885 return show_help();
Elliott Hughes577e8b42018-04-05 16:12:47 -07001886 case 'l':
1887 g_long_listing = true;
1888 break;
1889 case 's':
1890 serial = optarg;
1891 break;
1892 case 'S':
Elliott Hughes542370d2018-04-19 19:49:44 -07001893 if (!android::base::ParseByteCount(optarg, &sparse_limit)) {
1894 die("invalid sparse limit %s", optarg);
1895 }
Elliott Hughes577e8b42018-04-05 16:12:47 -07001896 break;
1897 case 'v':
1898 set_verbose();
1899 break;
1900 case 'w':
1901 wants_wipe = true;
1902 break;
1903 case '?':
1904 return 1;
1905 default:
1906 abort();
1907 }
Colin Cross8879f982012-05-22 17:53:34 -07001908 }
1909 }
1910
1911 argc -= optind;
1912 argv += optind;
1913
Elliott Hughesd6365a72017-05-08 18:04:49 -07001914 if (argc == 0 && !wants_wipe && !wants_set_active) syntax_error("no command");
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -08001915
Colin Cross8fb6e062012-07-24 16:36:41 -07001916 if (argc > 0 && !strcmp(*argv, "devices")) {
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -08001917 list_devices();
Tsu Chiang Chuangee520552011-02-25 18:38:53 -08001918 return 0;
1919 }
1920
Colin Crossc7b75dc2012-08-29 18:17:06 -07001921 if (argc > 0 && !strcmp(*argv, "help")) {
Elliott Hughesd6365a72017-05-08 18:04:49 -07001922 return show_help();
Colin Crossc7b75dc2012-08-29 18:17:06 -07001923 }
1924
David Pursell0b156632015-10-30 11:22:01 -07001925 Transport* transport = open_device();
David Pursell2ec418a2016-01-20 08:32:08 -08001926 if (transport == nullptr) {
1927 return 1;
1928 }
Tom Cherry9027af02018-09-24 15:48:09 -07001929 fastboot::DriverCallbacks driver_callbacks = {
1930 .prolog = Status,
1931 .epilog = Epilog,
1932 .info = InfoMessage,
1933 };
1934 fastboot::FastBootDriver fastboot_driver(transport, driver_callbacks, false);
1935 fb = &fastboot_driver;
David Pursell2ec418a2016-01-20 08:32:08 -08001936
Elliott Hughes5620d222018-03-28 08:20:00 -07001937 const double start = now();
1938
Aaron Wisnerdb511202018-06-26 15:38:35 -05001939 if (slot_override != "") slot_override = verify_slot(slot_override);
1940 if (next_active != "") next_active = verify_slot(next_active, false);
Daniel Rosenberg0d088562015-11-11 16:15:30 -08001941
1942 if (wants_set_active) {
1943 if (next_active == "") {
1944 if (slot_override == "") {
Daniel Rosenberg13454092016-06-27 19:43:11 -07001945 std::string current_slot;
Tom Cherry9027af02018-09-24 15:48:09 -07001946 if (fb->GetVar("current-slot", &current_slot) == fastboot::SUCCESS) {
Aaron Wisnerdb511202018-06-26 15:38:35 -05001947 next_active = verify_slot(current_slot, false);
Daniel Rosenberg13454092016-06-27 19:43:11 -07001948 } else {
1949 wants_set_active = false;
1950 }
Daniel Rosenberg0d088562015-11-11 16:15:30 -08001951 } else {
Aaron Wisnerdb511202018-06-26 15:38:35 -05001952 next_active = verify_slot(slot_override, false);
Daniel Rosenberg0d088562015-11-11 16:15:30 -08001953 }
1954 }
1955 }
Elliott Hughes31dbed72009-10-07 15:38:53 -07001956
Elliott Hughesd6365a72017-05-08 18:04:49 -07001957 std::vector<std::string> args(argv, argv + argc);
1958 while (!args.empty()) {
1959 std::string command = next_arg(&args);
Ken Sumrall5ee5d382012-09-29 14:46:25 -07001960
Mark Salyzyn8e7e9cb2018-08-29 10:44:33 -07001961 if (command == FB_CMD_GETVAR) {
Elliott Hughesd6365a72017-05-08 18:04:49 -07001962 std::string variable = next_arg(&args);
Tom Cherry9027af02018-09-24 15:48:09 -07001963 DisplayVarOrError(variable, variable);
Mark Salyzyn8e7e9cb2018-08-29 10:44:33 -07001964 } else if (command == FB_CMD_ERASE) {
Elliott Hughesd6365a72017-05-08 18:04:49 -07001965 std::string partition = next_arg(&args);
1966 auto erase = [&](const std::string& partition) {
David Pursell0b156632015-10-30 11:22:01 -07001967 std::string partition_type;
Tom Cherry9027af02018-09-24 15:48:09 -07001968 if (fb->GetVar("partition-type:" + partition, &partition_type) == fastboot::SUCCESS &&
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07001969 fs_get_generator(partition_type) != nullptr) {
1970 fprintf(stderr, "******** Did you mean to fastboot format this %s partition?\n",
1971 partition_type.c_str());
1972 }
Ken Sumrall5ee5d382012-09-29 14:46:25 -07001973
Tom Cherry9027af02018-09-24 15:48:09 -07001974 fb->Erase(partition);
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07001975 };
Aaron Wisnerdb511202018-06-26 15:38:35 -05001976 do_for_partitions(partition, slot_override, erase, true);
Elliott Hughesd6365a72017-05-08 18:04:49 -07001977 } else if (android::base::StartsWith(command, "format")) {
1978 // Parsing for: "format[:[type][:[size]]]"
1979 // Some valid things:
1980 // - select only the size, and leave default fs type:
1981 // format::0x4000000 userdata
1982 // - default fs type and size:
1983 // format userdata
1984 // format:: userdata
1985 std::vector<std::string> pieces = android::base::Split(command, ":");
1986 std::string type_override;
1987 if (pieces.size() > 1) type_override = pieces[1].c_str();
1988 std::string size_override;
1989 if (pieces.size() > 2) size_override = pieces[2].c_str();
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07001990
Elliott Hughesd6365a72017-05-08 18:04:49 -07001991 std::string partition = next_arg(&args);
1992
1993 auto format = [&](const std::string& partition) {
Aaron Wisnerdb511202018-06-26 15:38:35 -05001994 fb_perform_format(partition, 0, type_override, size_override, "");
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07001995 };
Greg Kaiserb49d9e12019-03-26 12:04:05 -07001996 do_for_partitions(partition, slot_override, format, true);
Elliott Hughesd6365a72017-05-08 18:04:49 -07001997 } else if (command == "signature") {
1998 std::string filename = next_arg(&args);
Tom Cherrydfd85df2018-09-20 14:45:05 -07001999 std::vector<char> data;
2000 if (!ReadFileToVector(filename, &data)) {
2001 die("could not load '%s': %s", filename.c_str(), strerror(errno));
2002 }
2003 if (data.size() != 256) die("signature must be 256 bytes (got %zu)", data.size());
Tom Cherry9027af02018-09-24 15:48:09 -07002004 fb->Download("signature", data);
2005 fb->RawCommand("signature", "installing signature");
Mark Salyzyn8e7e9cb2018-08-29 10:44:33 -07002006 } else if (command == FB_CMD_REBOOT) {
Daniel Rosenberg0d088562015-11-11 16:15:30 -08002007 wants_reboot = true;
Elliott Hughesd6365a72017-05-08 18:04:49 -07002008
2009 if (args.size() == 1) {
2010 std::string what = next_arg(&args);
2011 if (what == "bootloader") {
Daniel Rosenberg0d088562015-11-11 16:15:30 -08002012 wants_reboot = false;
2013 wants_reboot_bootloader = true;
Hridya Valsarajudea91b42018-07-17 11:14:01 -07002014 } else if (what == "recovery") {
2015 wants_reboot = false;
2016 wants_reboot_recovery = true;
2017 } else if (what == "fastboot") {
2018 wants_reboot = false;
2019 wants_reboot_fastboot = true;
Elliott Hughesd6365a72017-05-08 18:04:49 -07002020 } else {
2021 syntax_error("unknown reboot target %s", what.c_str());
Alexey Polyudove0bfb752017-01-03 19:39:13 -08002022 }
Elliott Hughesd6365a72017-05-08 18:04:49 -07002023
Elliott Hughesca85df02015-02-25 10:02:00 -08002024 }
Elliott Hughesd6365a72017-05-08 18:04:49 -07002025 if (!args.empty()) syntax_error("junk after reboot command");
Mark Salyzyn8e7e9cb2018-08-29 10:44:33 -07002026 } else if (command == FB_CMD_REBOOT_BOOTLOADER) {
Daniel Rosenberg0d088562015-11-11 16:15:30 -08002027 wants_reboot_bootloader = true;
Mark Salyzyn8e7e9cb2018-08-29 10:44:33 -07002028 } else if (command == FB_CMD_REBOOT_RECOVERY) {
Hridya Valsarajudea91b42018-07-17 11:14:01 -07002029 wants_reboot_recovery = true;
Mark Salyzyn8e7e9cb2018-08-29 10:44:33 -07002030 } else if (command == FB_CMD_REBOOT_FASTBOOT) {
Hridya Valsarajudea91b42018-07-17 11:14:01 -07002031 wants_reboot_fastboot = true;
Mark Salyzyn8e7e9cb2018-08-29 10:44:33 -07002032 } else if (command == FB_CMD_CONTINUE) {
Tom Cherry9027af02018-09-24 15:48:09 -07002033 fb->Continue();
Mark Salyzyn8e7e9cb2018-08-29 10:44:33 -07002034 } else if (command == FB_CMD_BOOT) {
Elliott Hughesd6365a72017-05-08 18:04:49 -07002035 std::string kernel = next_arg(&args);
2036 std::string ramdisk;
2037 if (!args.empty()) ramdisk = next_arg(&args);
2038 std::string second_stage;
2039 if (!args.empty()) second_stage = next_arg(&args);
Tom Cherrydfd85df2018-09-20 14:45:05 -07002040 auto data = LoadBootableImage(kernel, ramdisk, second_stage);
Tom Cherry9027af02018-09-24 15:48:09 -07002041 fb->Download("boot.img", data);
2042 fb->Boot();
Mark Salyzyn8e7e9cb2018-08-29 10:44:33 -07002043 } else if (command == FB_CMD_FLASH) {
Elliott Hughesd6365a72017-05-08 18:04:49 -07002044 std::string pname = next_arg(&args);
2045
Elliott Hughes2810d002016-04-25 14:31:18 -07002046 std::string fname;
Elliott Hughesd6365a72017-05-08 18:04:49 -07002047 if (!args.empty()) {
2048 fname = next_arg(&args);
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -08002049 } else {
Elliott Hughes45964a82017-05-03 22:43:23 -07002050 fname = find_item(pname);
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -08002051 }
Elliott Hughesd6365a72017-05-08 18:04:49 -07002052 if (fname.empty()) die("cannot determine image filename for '%s'", pname.c_str());
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07002053
2054 auto flash = [&](const std::string &partition) {
David Anderson89569642018-11-16 15:53:35 -08002055 if (should_flash_in_userspace(partition) && !is_userspace_fastboot() &&
2056 !force_flash) {
2057 die("The partition you are trying to flash is dynamic, and "
2058 "should be flashed via fastbootd. Please run:\n"
2059 "\n"
2060 " fastboot reboot fastboot\n"
2061 "\n"
2062 "And try again. If you are intentionally trying to "
2063 "overwrite a fixed partition, use --force.");
2064 }
Aaron Wisnerdb511202018-06-26 15:38:35 -05002065 do_flash(partition.c_str(), fname.c_str());
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07002066 };
Greg Kaiserb49d9e12019-03-26 12:04:05 -07002067 do_for_partitions(pname, slot_override, flash, true);
Elliott Hughesd6365a72017-05-08 18:04:49 -07002068 } else if (command == "flash:raw") {
2069 std::string partition = next_arg(&args);
2070 std::string kernel = next_arg(&args);
2071 std::string ramdisk;
2072 if (!args.empty()) ramdisk = next_arg(&args);
2073 std::string second_stage;
2074 if (!args.empty()) second_stage = next_arg(&args);
2075
Tom Cherrydfd85df2018-09-20 14:45:05 -07002076 auto data = LoadBootableImage(kernel, ramdisk, second_stage);
2077 auto flashraw = [&data](const std::string& partition) {
Tom Cherry9027af02018-09-24 15:48:09 -07002078 fb->FlashPartition(partition, data);
Daniel Rosenbergb7bd4ae2015-09-14 21:05:41 -07002079 };
Aaron Wisnerdb511202018-06-26 15:38:35 -05002080 do_for_partitions(partition, slot_override, flashraw, true);
Elliott Hughesd6365a72017-05-08 18:04:49 -07002081 } else if (command == "flashall") {
Alex Lightbb9b8a52016-06-29 09:26:44 -07002082 if (slot_override == "all") {
Daniel Rosenberg92b44762016-07-13 20:03:25 -07002083 fprintf(stderr, "Warning: slot set to 'all'. Secondary slots will not be flashed.\n");
David Anderson32e376f2018-08-16 13:43:11 -07002084 do_flashall(slot_override, true, wants_wipe);
Alex Lightbb9b8a52016-06-29 09:26:44 -07002085 } else {
David Anderson32e376f2018-08-16 13:43:11 -07002086 do_flashall(slot_override, skip_secondary, wants_wipe);
Alex Lightbb9b8a52016-06-29 09:26:44 -07002087 }
Daniel Rosenberg0d088562015-11-11 16:15:30 -08002088 wants_reboot = true;
Elliott Hughesd6365a72017-05-08 18:04:49 -07002089 } else if (command == "update") {
Daniel Rosenberg92b44762016-07-13 20:03:25 -07002090 bool slot_all = (slot_override == "all");
2091 if (slot_all) {
2092 fprintf(stderr, "Warning: slot set to 'all'. Secondary slots will not be flashed.\n");
2093 }
Elliott Hughesd6365a72017-05-08 18:04:49 -07002094 std::string filename = "update.zip";
2095 if (!args.empty()) {
2096 filename = next_arg(&args);
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -08002097 }
Aaron Wisnerdb511202018-06-26 15:38:35 -05002098 do_update(filename.c_str(), slot_override, skip_secondary || slot_all);
Mitchell Wills31dce302016-09-26 10:26:21 -07002099 wants_reboot = true;
Mark Salyzyn8e7e9cb2018-08-29 10:44:33 -07002100 } else if (command == FB_CMD_SET_ACTIVE) {
Aaron Wisnerdb511202018-06-26 15:38:35 -05002101 std::string slot = verify_slot(next_arg(&args), false);
Tom Cherry9027af02018-09-24 15:48:09 -07002102 fb->SetActive(slot);
Elliott Hughesd6365a72017-05-08 18:04:49 -07002103 } else if (command == "stage") {
2104 std::string filename = next_arg(&args);
2105
Jocelyn Bohr98cc2832017-01-26 19:20:53 -08002106 struct fastboot_buffer buf;
Aaron Wisnerdb511202018-06-26 15:38:35 -05002107 if (!load_buf(filename.c_str(), &buf) || buf.type != FB_BUFFER_FD) {
Elliott Hughesd6365a72017-05-08 18:04:49 -07002108 die("cannot load '%s'", filename.c_str());
Jocelyn Bohr98cc2832017-01-26 19:20:53 -08002109 }
Tom Cherry9027af02018-09-24 15:48:09 -07002110 fb->Download(filename, buf.fd, buf.sz);
Elliott Hughesd6365a72017-05-08 18:04:49 -07002111 } else if (command == "get_staged") {
2112 std::string filename = next_arg(&args);
Tom Cherry9027af02018-09-24 15:48:09 -07002113 fb->Upload(filename);
Mark Salyzyn8e7e9cb2018-08-29 10:44:33 -07002114 } else if (command == FB_CMD_OEM) {
2115 do_oem_command(FB_CMD_OEM, &args);
Elliott Hughesd6365a72017-05-08 18:04:49 -07002116 } else if (command == "flashing") {
2117 if (args.empty()) {
2118 syntax_error("missing 'flashing' command");
2119 } else if (args.size() == 1 && (args[0] == "unlock" || args[0] == "lock" ||
2120 args[0] == "unlock_critical" ||
2121 args[0] == "lock_critical" ||
Elliott Hughes2e9b7792018-04-04 13:36:44 -07002122 args[0] == "get_unlock_ability")) {
Elliott Hughes1eec97a2017-05-15 16:53:53 -07002123 do_oem_command("flashing", &args);
Badhri Jagan Sridharanbf110952015-05-15 16:43:47 -07002124 } else {
Elliott Hughesd6365a72017-05-08 18:04:49 -07002125 syntax_error("unknown 'flashing' command %s", args[0].c_str());
Badhri Jagan Sridharanbf110952015-05-15 16:43:47 -07002126 }
Mark Salyzyn8e7e9cb2018-08-29 10:44:33 -07002127 } else if (command == FB_CMD_CREATE_PARTITION) {
David Anderson0d4277d2018-07-31 13:27:37 -07002128 std::string partition = next_arg(&args);
2129 std::string size = next_arg(&args);
Tom Cherry9027af02018-09-24 15:48:09 -07002130 fb->CreatePartition(partition, size);
Mark Salyzyn8e7e9cb2018-08-29 10:44:33 -07002131 } else if (command == FB_CMD_DELETE_PARTITION) {
David Anderson0d4277d2018-07-31 13:27:37 -07002132 std::string partition = next_arg(&args);
Tom Cherry9027af02018-09-24 15:48:09 -07002133 fb->DeletePartition(partition);
Mark Salyzyn8e7e9cb2018-08-29 10:44:33 -07002134 } else if (command == FB_CMD_RESIZE_PARTITION) {
David Anderson0d4277d2018-07-31 13:27:37 -07002135 std::string partition = next_arg(&args);
2136 std::string size = next_arg(&args);
Tom Cherry9027af02018-09-24 15:48:09 -07002137 fb->ResizePartition(partition, size);
David Anderson1d504e32019-01-15 14:38:20 -08002138 } else if (command == "gsi") {
David Anderson3d782d52019-01-29 13:09:49 -08002139 std::string arg = next_arg(&args);
2140 if (arg == "wipe") {
David Anderson1d504e32019-01-15 14:38:20 -08002141 fb->RawCommand("gsi:wipe", "wiping GSI");
David Anderson3d782d52019-01-29 13:09:49 -08002142 } else if (arg == "disable") {
David Anderson1d504e32019-01-15 14:38:20 -08002143 fb->RawCommand("gsi:disable", "disabling GSI");
2144 } else {
2145 syntax_error("expected 'wipe' or 'disable'");
2146 }
David Anderson7c84b9f2019-06-27 22:15:29 -07002147 } else if (command == "wipe-super") {
2148 std::string image;
2149 if (args.empty()) {
2150 image = find_item_given_name("super_empty.img");
2151 } else {
2152 image = next_arg(&args);
2153 }
2154 do_wipe_super(image, slot_override);
David Andersonab8f4662019-10-21 16:45:59 -07002155 } else if (command == "snapshot-update") {
2156 std::string arg;
2157 if (!args.empty()) {
2158 arg = next_arg(&args);
2159 }
David Anderson220ddb12019-10-31 18:02:41 -07002160 if (!arg.empty() && (arg != "cancel" && arg != "merge")) {
2161 syntax_error("expected: snapshot-update [cancel|merge]");
David Andersonab8f4662019-10-21 16:45:59 -07002162 }
2163 fb->SnapshotUpdateCommand(arg);
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -08002164 } else {
Elliott Hughesd6365a72017-05-08 18:04:49 -07002165 syntax_error("unknown command %s", command.c_str());
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -08002166 }
2167 }
2168
2169 if (wants_wipe) {
David Andersonab8f4662019-10-21 16:45:59 -07002170 if (force_flash) {
2171 CancelSnapshotIfNeeded();
2172 }
Paul Crowley4d170062018-04-24 17:06:30 -07002173 std::vector<std::string> partitions = { "userdata", "cache", "metadata" };
2174 for (const auto& partition : partitions) {
2175 std::string partition_type;
Tom Cherry9027af02018-09-24 15:48:09 -07002176 if (fb->GetVar("partition-type:" + partition, &partition_type) != fastboot::SUCCESS) {
2177 continue;
2178 }
Paul Crowley4d170062018-04-24 17:06:30 -07002179 if (partition_type.empty()) continue;
Tom Cherry9027af02018-09-24 15:48:09 -07002180 fb->Erase(partition);
Paul Crowley4d170062018-04-24 17:06:30 -07002181 if (partition == "userdata" && set_fbe_marker) {
2182 fprintf(stderr, "setting FBE marker on initial userdata...\n");
2183 std::string initial_userdata_dir = create_fbemarker_tmpdir();
cfigf60613b2019-08-29 13:17:28 +08002184 fb_perform_format(partition, 1, partition_type, "", initial_userdata_dir);
Paul Crowley4d170062018-04-24 17:06:30 -07002185 delete_fbemarker_tmpdir(initial_userdata_dir);
2186 } else {
cfigf60613b2019-08-29 13:17:28 +08002187 fb_perform_format(partition, 1, partition_type, "", "");
Paul Crowley4d170062018-04-24 17:06:30 -07002188 }
Elliott Hughes2fd45a92015-10-30 11:49:47 -07002189 }
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -08002190 }
Daniel Rosenberg0d088562015-11-11 16:15:30 -08002191 if (wants_set_active) {
Tom Cherry9027af02018-09-24 15:48:09 -07002192 fb->SetActive(next_active);
Daniel Rosenberg0d088562015-11-11 16:15:30 -08002193 }
Mitchell Wills31dce302016-09-26 10:26:21 -07002194 if (wants_reboot && !skip_reboot) {
Tom Cherry9027af02018-09-24 15:48:09 -07002195 fb->Reboot();
2196 fb->WaitForDisconnect();
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -08002197 } else if (wants_reboot_bootloader) {
Tom Cherry9027af02018-09-24 15:48:09 -07002198 fb->RebootTo("bootloader");
2199 fb->WaitForDisconnect();
Hridya Valsarajudea91b42018-07-17 11:14:01 -07002200 } else if (wants_reboot_recovery) {
Tom Cherry9027af02018-09-24 15:48:09 -07002201 fb->RebootTo("recovery");
2202 fb->WaitForDisconnect();
Hridya Valsarajudea91b42018-07-17 11:14:01 -07002203 } else if (wants_reboot_fastboot) {
David Anderson11d6d272018-12-07 16:39:07 -08002204 reboot_to_userspace_fastboot();
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -08002205 }
2206
Elliott Hughes5620d222018-03-28 08:20:00 -07002207 fprintf(stderr, "Finished. Total time: %.3fs\n", (now() - start));
David Anderson03de6452018-09-04 14:32:54 -07002208
Tom Cherry9027af02018-09-24 15:48:09 -07002209 auto* old_transport = fb->set_transport(nullptr);
2210 delete old_transport;
2211
Tom Cherry11f12092018-08-29 21:36:28 -07002212 return 0;
The Android Open Source Projectdd7bc332009-03-03 19:32:55 -08002213}
Elliott Hughes6ebec932018-04-10 14:22:13 -07002214
Aaron Wisnerdb511202018-06-26 15:38:35 -05002215void FastBootTool::ParseOsPatchLevel(boot_img_hdr_v1* hdr, const char* arg) {
Elliott Hughes6ebec932018-04-10 14:22:13 -07002216 unsigned year, month, day;
2217 if (sscanf(arg, "%u-%u-%u", &year, &month, &day) != 3) {
2218 syntax_error("OS patch level should be YYYY-MM-DD: %s", arg);
2219 }
2220 if (year < 2000 || year >= 2128) syntax_error("year out of range: %d", year);
2221 if (month < 1 || month > 12) syntax_error("month out of range: %d", month);
2222 hdr->SetOsPatchLevel(year, month);
2223}
2224
Aaron Wisnerdb511202018-06-26 15:38:35 -05002225void FastBootTool::ParseOsVersion(boot_img_hdr_v1* hdr, const char* arg) {
Elliott Hughes6ebec932018-04-10 14:22:13 -07002226 unsigned major = 0, minor = 0, patch = 0;
2227 std::vector<std::string> versions = android::base::Split(arg, ".");
2228 if (versions.size() < 1 || versions.size() > 3 ||
2229 (versions.size() >= 1 && !android::base::ParseUint(versions[0], &major)) ||
2230 (versions.size() >= 2 && !android::base::ParseUint(versions[1], &minor)) ||
2231 (versions.size() == 3 && !android::base::ParseUint(versions[2], &patch)) ||
2232 (major > 0x7f || minor > 0x7f || patch > 0x7f)) {
2233 syntax_error("bad OS version: %s", arg);
2234 }
2235 hdr->SetOsVersion(major, minor, patch);
2236}