• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright (C) 2015 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 /*
18  * update_verifier verifies the integrity of the partitions after an A/B OTA update. It gets invoked
19  * by init, and will only perform the verification if it's the first boot post an A/B OTA update
20  * (https://source.android.com/devices/tech/ota/ab/#after_reboot).
21  *
22  * update_verifier relies on device-mapper-verity (dm-verity) to capture any corruption on the
23  * partitions being verified (https://source.android.com/security/verifiedboot). The verification
24  * will be skipped, if dm-verity is not enabled on the device.
25  *
26  * Upon detecting verification failures, the device will be rebooted, although the trigger of the
27  * reboot depends on the dm-verity mode.
28  *   enforcing mode: dm-verity reboots the device
29  *   eio mode: dm-verity fails the read and update_verifier reboots the device
30  *   other mode: not supported and update_verifier reboots the device
31  *
32  * All these reboots prevent the device from booting into a known corrupt state. If the device
33  * continuously fails to boot into the new slot, the bootloader should mark the slot as unbootable
34  * and trigger a fallback to the old slot.
35  *
36  * The current slot will be marked as having booted successfully if the verifier reaches the end
37  * after the verification.
38  */
39 
40 #include "update_verifier/update_verifier.h"
41 
42 #include <dirent.h>
43 #include <errno.h>
44 #include <fcntl.h>
45 #include <stdint.h>
46 #include <stdio.h>
47 #include <stdlib.h>
48 #include <string.h>
49 #include <unistd.h>
50 
51 #include <algorithm>
52 #include <future>
53 #include <thread>
54 
55 #include <android-base/file.h>
56 #include <android-base/logging.h>
57 #include <android-base/parseint.h>
58 #include <android-base/properties.h>
59 #include <android-base/strings.h>
60 #include <android-base/unique_fd.h>
61 #include <android/hardware/boot/1.0/IBootControl.h>
62 #include <android/os/IVold.h>
63 #include <binder/BinderService.h>
64 #include <binder/Status.h>
65 #include <cutils/android_reboot.h>
66 
67 #include "care_map.pb.h"
68 
69 using android::sp;
70 using android::hardware::boot::V1_0::IBootControl;
71 using android::hardware::boot::V1_0::BoolResult;
72 using android::hardware::boot::V1_0::CommandResult;
73 
74 // TODO(xunchang) remove the prefix and use a default path instead.
75 constexpr const char* kDefaultCareMapPrefix = "/data/ota_package/care_map";
76 
77 // Find directories in format of "/sys/block/dm-X".
dm_name_filter(const dirent * de)78 static int dm_name_filter(const dirent* de) {
79   if (android::base::StartsWith(de->d_name, "dm-")) {
80     return 1;
81   }
82   return 0;
83 }
84 
UpdateVerifier()85 UpdateVerifier::UpdateVerifier()
86     : care_map_prefix_(kDefaultCareMapPrefix),
87       property_reader_([](const std::string& id) { return android::base::GetProperty(id, ""); }) {}
88 
89 // Iterate the content of "/sys/block/dm-X/dm/name" and find all the dm-wrapped block devices.
90 // We will later read all the ("cared") blocks from "/dev/block/dm-X" to ensure the target
91 // partition's integrity.
FindDmPartitions()92 std::map<std::string, std::string> UpdateVerifier::FindDmPartitions() {
93   static constexpr auto DM_PATH_PREFIX = "/sys/block/";
94   dirent** namelist;
95   int n = scandir(DM_PATH_PREFIX, &namelist, dm_name_filter, alphasort);
96   if (n == -1) {
97     PLOG(ERROR) << "Failed to scan dir " << DM_PATH_PREFIX;
98     return {};
99   }
100   if (n == 0) {
101     LOG(ERROR) << "No dm block device found.";
102     return {};
103   }
104 
105   static constexpr auto DM_PATH_SUFFIX = "/dm/name";
106   static constexpr auto DEV_PATH = "/dev/block/";
107   std::map<std::string, std::string> dm_block_devices;
108   while (n--) {
109     std::string path = DM_PATH_PREFIX + std::string(namelist[n]->d_name) + DM_PATH_SUFFIX;
110     std::string content;
111     if (!android::base::ReadFileToString(path, &content)) {
112       PLOG(WARNING) << "Failed to read " << path;
113     } else {
114       std::string dm_block_name = android::base::Trim(content);
115       // AVB is using 'vroot' for the root block device but we're expecting 'system'.
116       if (dm_block_name == "vroot") {
117         dm_block_name = "system";
118       } else if (android::base::EndsWith(dm_block_name, "-verity")) {
119         auto npos = dm_block_name.rfind("-verity");
120         dm_block_name = dm_block_name.substr(0, npos);
121       } else if (!android::base::GetProperty("ro.boot.avb_version", "").empty()) {
122         // Verified Boot 1.0 doesn't add a -verity suffix. On AVB 2 devices,
123         // if DAP is enabled, then a -verity suffix must be used to
124         // differentiate between dm-linear and dm-verity devices. If we get
125         // here, we're AVB 2 and looking at a non-verity partition.
126         continue;
127       }
128 
129       dm_block_devices.emplace(dm_block_name, DEV_PATH + std::string(namelist[n]->d_name));
130     }
131     free(namelist[n]);
132   }
133   free(namelist);
134 
135   return dm_block_devices;
136 }
137 
ReadBlocks(const std::string partition_name,const std::string & dm_block_device,const RangeSet & ranges)138 bool UpdateVerifier::ReadBlocks(const std::string partition_name,
139                                 const std::string& dm_block_device, const RangeSet& ranges) {
140   // RangeSet::Split() splits the ranges into multiple groups with same number of blocks (except for
141   // the last group).
142   size_t thread_num = std::thread::hardware_concurrency() ?: 4;
143   std::vector<RangeSet> groups = ranges.Split(thread_num);
144 
145   std::vector<std::future<bool>> threads;
146   for (const auto& group : groups) {
147     auto thread_func = [&group, &dm_block_device, &partition_name]() {
148       android::base::unique_fd fd(TEMP_FAILURE_RETRY(open(dm_block_device.c_str(), O_RDONLY)));
149       if (fd.get() == -1) {
150         PLOG(ERROR) << "Error reading " << dm_block_device << " for partition " << partition_name;
151         return false;
152       }
153 
154       static constexpr size_t kBlockSize = 4096;
155       std::vector<uint8_t> buf(1024 * kBlockSize);
156 
157       size_t block_count = 0;
158       for (const auto& [range_start, range_end] : group) {
159         if (lseek64(fd.get(), static_cast<off64_t>(range_start) * kBlockSize, SEEK_SET) == -1) {
160           PLOG(ERROR) << "lseek to " << range_start << " failed";
161           return false;
162         }
163 
164         size_t remain = (range_end - range_start) * kBlockSize;
165         while (remain > 0) {
166           size_t to_read = std::min(remain, 1024 * kBlockSize);
167           if (!android::base::ReadFully(fd.get(), buf.data(), to_read)) {
168             PLOG(ERROR) << "Failed to read blocks " << range_start << " to " << range_end;
169             return false;
170           }
171           remain -= to_read;
172         }
173         block_count += (range_end - range_start);
174       }
175       LOG(INFO) << "Finished reading " << block_count << " blocks on " << dm_block_device;
176       return true;
177     };
178 
179     threads.emplace_back(std::async(std::launch::async, thread_func));
180   }
181 
182   bool ret = true;
183   for (auto& t : threads) {
184     ret = t.get() && ret;
185   }
186   LOG(INFO) << "Finished reading blocks on " << dm_block_device << " with " << thread_num
187             << " threads.";
188   return ret;
189 }
190 
VerifyPartitions()191 bool UpdateVerifier::VerifyPartitions() {
192   auto dm_block_devices = FindDmPartitions();
193   if (dm_block_devices.empty()) {
194     LOG(ERROR) << "No dm-enabled block device is found.";
195     return false;
196   }
197 
198   for (const auto& [partition_name, ranges] : partition_map_) {
199     if (dm_block_devices.find(partition_name) == dm_block_devices.end()) {
200       LOG(ERROR) << "Failed to find dm block device for " << partition_name;
201       return false;
202     }
203 
204     if (!ReadBlocks(partition_name, dm_block_devices.at(partition_name), ranges)) {
205       return false;
206     }
207   }
208 
209   return true;
210 }
211 
ParseCareMap()212 bool UpdateVerifier::ParseCareMap() {
213   partition_map_.clear();
214 
215   std::string care_map_name = care_map_prefix_ + ".pb";
216   if (access(care_map_name.c_str(), R_OK) == -1) {
217     LOG(ERROR) << care_map_name << " doesn't exist";
218     return false;
219   }
220 
221   android::base::unique_fd care_map_fd(TEMP_FAILURE_RETRY(open(care_map_name.c_str(), O_RDONLY)));
222   // If the device is flashed before the current boot, it may not have care_map.txt in
223   // /data/ota_package. To allow the device to continue booting in this situation, we should
224   // print a warning and skip the block verification.
225   if (care_map_fd.get() == -1) {
226     PLOG(WARNING) << "Failed to open " << care_map_name;
227     return false;
228   }
229 
230   std::string file_content;
231   if (!android::base::ReadFdToString(care_map_fd.get(), &file_content)) {
232     PLOG(WARNING) << "Failed to read " << care_map_name;
233     return false;
234   }
235 
236   if (file_content.empty()) {
237     LOG(WARNING) << "Unexpected empty care map";
238     return false;
239   }
240 
241   recovery_update_verifier::CareMap care_map;
242   if (!care_map.ParseFromString(file_content)) {
243     LOG(WARNING) << "Failed to parse " << care_map_name << " in protobuf format.";
244     return false;
245   }
246 
247   for (const auto& partition : care_map.partitions()) {
248     if (partition.name().empty()) {
249       LOG(WARNING) << "Unexpected empty partition name.";
250       return false;
251     }
252     if (partition.ranges().empty()) {
253       LOG(WARNING) << "Unexpected block ranges for partition " << partition.name();
254       return false;
255     }
256     RangeSet ranges = RangeSet::Parse(partition.ranges());
257     if (!ranges) {
258       LOG(WARNING) << "Error parsing RangeSet string " << partition.ranges();
259       return false;
260     }
261 
262     // Continues to check other partitions if there is a fingerprint mismatch.
263     if (partition.id().empty() || partition.id() == "unknown") {
264       LOG(WARNING) << "Skip reading partition " << partition.name()
265                    << ": property_id is not provided to get fingerprint.";
266       continue;
267     }
268 
269     std::string fingerprint = property_reader_(partition.id());
270     if (fingerprint != partition.fingerprint()) {
271       LOG(WARNING) << "Skip reading partition " << partition.name() << ": fingerprint "
272                    << fingerprint << " doesn't match the expected value "
273                    << partition.fingerprint();
274       continue;
275     }
276 
277     partition_map_.emplace(partition.name(), ranges);
278   }
279 
280   if (partition_map_.empty()) {
281     LOG(WARNING) << "No partition to verify";
282     return false;
283   }
284 
285   return true;
286 }
287 
set_care_map_prefix(const std::string & prefix)288 void UpdateVerifier::set_care_map_prefix(const std::string& prefix) {
289   care_map_prefix_ = prefix;
290 }
291 
set_property_reader(const std::function<std::string (const std::string &)> & property_reader)292 void UpdateVerifier::set_property_reader(
293     const std::function<std::string(const std::string&)>& property_reader) {
294   property_reader_ = property_reader;
295 }
296 
reboot_device()297 static int reboot_device() {
298   if (android_reboot(ANDROID_RB_RESTART2, 0, nullptr) == -1) {
299     LOG(ERROR) << "Failed to reboot.";
300     return -1;
301   }
302   while (true) pause();
303 }
304 
update_verifier(int argc,char ** argv)305 int update_verifier(int argc, char** argv) {
306   for (int i = 1; i < argc; i++) {
307     LOG(INFO) << "Started with arg " << i << ": " << argv[i];
308   }
309 
310   sp<IBootControl> module = IBootControl::getService();
311   if (module == nullptr) {
312     LOG(ERROR) << "Error getting bootctrl module.";
313     return reboot_device();
314   }
315 
316   uint32_t current_slot = module->getCurrentSlot();
317   BoolResult is_successful = module->isSlotMarkedSuccessful(current_slot);
318   LOG(INFO) << "Booting slot " << current_slot << ": isSlotMarkedSuccessful="
319             << static_cast<int32_t>(is_successful);
320 
321   if (is_successful == BoolResult::FALSE) {
322     // The current slot has not booted successfully.
323 
324     bool skip_verification = false;
325     std::string verity_mode = android::base::GetProperty("ro.boot.veritymode", "");
326     if (verity_mode.empty()) {
327       // Skip the verification if ro.boot.veritymode property is not set. This could be a result
328       // that device doesn't support dm-verity, or has disabled that.
329       LOG(WARNING) << "dm-verity not enabled; marking without verification.";
330       skip_verification = true;
331     } else if (android::base::EqualsIgnoreCase(verity_mode, "eio")) {
332       // We shouldn't see verity in EIO mode if the current slot hasn't booted successfully before.
333       // Continue the verification until we fail to read some blocks.
334       LOG(WARNING) << "Found dm-verity in EIO mode.";
335     } else if (android::base::EqualsIgnoreCase(verity_mode, "disabled")) {
336       LOG(WARNING) << "dm-verity in disabled mode; marking without verification.";
337       skip_verification = true;
338     } else if (verity_mode != "enforcing") {
339       LOG(ERROR) << "Unexpected dm-verity mode: " << verity_mode << ", expecting enforcing.";
340       return reboot_device();
341     }
342 
343     if (!skip_verification) {
344       UpdateVerifier verifier;
345       if (!verifier.ParseCareMap()) {
346         LOG(WARNING) << "Failed to parse the care map file, skipping verification";
347       } else if (!verifier.VerifyPartitions()) {
348         LOG(ERROR) << "Failed to verify all blocks in care map file.";
349         return reboot_device();
350       }
351     }
352 
353     bool supports_checkpoint = false;
354     auto sm = android::defaultServiceManager();
355     android::sp<android::IBinder> binder = sm->getService(android::String16("vold"));
356     if (binder) {
357       auto vold = android::interface_cast<android::os::IVold>(binder);
358       android::binder::Status status = vold->supportsCheckpoint(&supports_checkpoint);
359       if (!status.isOk()) {
360         LOG(ERROR) << "Failed to check if checkpoints supported. Continuing";
361       }
362     } else {
363       LOG(ERROR) << "Failed to obtain vold Binder. Continuing";
364     }
365 
366     if (!supports_checkpoint) {
367       CommandResult cr;
368       module->markBootSuccessful([&cr](CommandResult result) { cr = result; });
369       if (!cr.success) {
370         LOG(ERROR) << "Error marking booted successfully: " << cr.errMsg;
371         return reboot_device();
372       }
373       LOG(INFO) << "Marked slot " << current_slot << " as booted successfully.";
374     } else {
375       LOG(INFO) << "Deferred marking slot " << current_slot << " as booted successfully.";
376     }
377   }
378 
379   LOG(INFO) << "Leaving update_verifier.";
380   return 0;
381 }
382