/* * Copyright (C) 2018 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #ifdef __ANDROID__ #include #include #endif #include #include #include #include "dynamic_partitions_device_info.pb.h" using namespace android; using namespace android::fs_mgr; static int usage(int /* argc */, char* argv[], std::ostream& cerr) { cerr << argv[0] << " - command-line tool for dumping Android Logical Partition images.\n" "\n" "Usage:\n" " " << argv[0] << " [-s |--slot=] [-j|--json] [FILE|DEVICE]\n" "\n" "Options:\n" " -s, --slot=N Slot number or suffix.\n" " -j, --json Print in JSON format.\n" " -e, --is-super-empty\n" " The given file is a super_empty.img.\n" " -d, --dump-metadata-size\n" " Print the space reserved for metadata to stdout\n" " in bytes.\n"; return EX_USAGE; } static std::string BuildFlagString(const std::vector& strings) { return strings.empty() ? "none" : android::base::Join(strings, ","); } static std::string BuildAttributeString(uint32_t attrs) { std::vector strings; if (attrs & LP_PARTITION_ATTR_READONLY) strings.emplace_back("readonly"); if (attrs & LP_PARTITION_ATTR_SLOT_SUFFIXED) strings.emplace_back("slot-suffixed"); return BuildFlagString(strings); } static std::string BuildGroupFlagString(uint32_t flags) { std::vector strings; if (flags & LP_GROUP_SLOT_SUFFIXED) strings.emplace_back("slot-suffixed"); return BuildFlagString(strings); } static std::string BuildBlockDeviceFlagString(uint32_t flags) { std::vector strings; if (flags & LP_BLOCK_DEVICE_SLOT_SUFFIXED) strings.emplace_back("slot-suffixed"); return BuildFlagString(strings); } static bool IsBlockDevice(const char* file) { struct stat s; return !stat(file, &s) && S_ISBLK(s.st_mode); } // Reimplementation of fs_mgr_get_slot_suffix() without reading // kernel commandline. static std::string GetSlotSuffix() { return base::GetProperty("ro.boot.slot_suffix", ""); } // Reimplementation of fs_mgr_get_super_partition_name() without reading // kernel commandline. Always return the super partition at current slot. static std::string GetSuperPartionName() { std::string super_partition = base::GetProperty("ro.boot.super_partition", ""); if (super_partition.empty()) { return LP_METADATA_DEFAULT_PARTITION_NAME; } return super_partition + GetSlotSuffix(); } static std::string RemoveSuffix(const std::string& s, const std::string& suffix) { if (base::EndsWith(s, suffix)) { return s.substr(0, s.length() - suffix.length()); } return s; } // Merge proto with information from metadata. static bool MergeMetadata(const LpMetadata* metadata, DynamicPartitionsDeviceInfoProto* proto) { if (!metadata) return false; auto builder = MetadataBuilder::New(*metadata); if (!builder) return false; std::string slot_suffix = GetSlotSuffix(); for (const auto& group_name : builder->ListGroups()) { auto group = builder->FindGroup(group_name); if (!group) continue; if (!base::EndsWith(group_name, slot_suffix)) continue; auto group_proto = proto->add_groups(); group_proto->set_name(RemoveSuffix(group_name, slot_suffix)); group_proto->set_maximum_size(group->maximum_size()); for (auto partition : builder->ListPartitionsInGroup(group_name)) { auto partition_name = partition->name(); if (!base::EndsWith(partition_name, slot_suffix)) continue; auto partition_proto = proto->add_partitions(); partition_proto->set_name(RemoveSuffix(partition_name, slot_suffix)); partition_proto->set_group_name(RemoveSuffix(group_name, slot_suffix)); partition_proto->set_size(partition->size()); partition_proto->set_is_dynamic(true); } } for (const auto& block_device : metadata->block_devices) { std::string name = GetBlockDevicePartitionName(block_device); BlockDeviceInfo info; if (!builder->GetBlockDeviceInfo(name, &info)) { continue; } auto block_device_proto = proto->add_block_devices(); block_device_proto->set_name(RemoveSuffix(name, slot_suffix)); block_device_proto->set_size(info.size); block_device_proto->set_block_size(info.logical_block_size); block_device_proto->set_alignment(info.alignment); block_device_proto->set_alignment_offset(info.alignment_offset); } return true; } #ifdef __ANDROID__ static DynamicPartitionsDeviceInfoProto::Partition* FindPartition( DynamicPartitionsDeviceInfoProto* proto, const std::string& partition) { for (DynamicPartitionsDeviceInfoProto::Partition& p : *proto->mutable_partitions()) { if (p.name() == partition) { return &p; } } return nullptr; } static std::optional GetReadonlyPartitionName(const android::fs_mgr::FstabEntry& entry) { // Only report readonly partitions. if ((entry.flags & MS_RDONLY) == 0) return std::nullopt; std::regex regex("/([a-zA-Z_]*)$"); std::smatch match; if (!std::regex_match(entry.mount_point, match, regex)) return std::nullopt; // On system-as-root devices, fstab lists / for system partition. std::string partition = match[1]; return partition.empty() ? "system" : partition; } static bool MergeFsUsage(DynamicPartitionsDeviceInfoProto* proto, std::ostream& cerr) { using namespace std::string_literals; Fstab fstab; if (!ReadDefaultFstab(&fstab)) { cerr << "Cannot read fstab\n"; return false; } for (const auto& entry : fstab) { auto partition = GetReadonlyPartitionName(entry); if (!partition) { continue; } // system is mounted to "/"; const char* mount_point = (entry.mount_point == "/system") ? "/" : entry.mount_point.c_str(); struct statvfs vst; if (statvfs(mount_point, &vst) == -1) { continue; } auto partition_proto = FindPartition(proto, *partition); if (partition_proto == nullptr) { partition_proto = proto->add_partitions(); partition_proto->set_name(*partition); partition_proto->set_is_dynamic(false); } partition_proto->set_fs_size((uint64_t)vst.f_blocks * vst.f_frsize); if (vst.f_bavail <= vst.f_blocks) { partition_proto->set_fs_used((uint64_t)(vst.f_blocks - vst.f_bavail) * vst.f_frsize); } } return true; } #endif // Print output in JSON format. // If successful, this function must write a valid JSON string to "cout" and return 0. static int PrintJson(const LpMetadata* metadata, std::ostream& cout, std::ostream& cerr) { DynamicPartitionsDeviceInfoProto proto; if (base::GetBoolProperty("ro.boot.dynamic_partitions", false)) { proto.set_enabled(true); } if (base::GetBoolProperty("ro.boot.dynamic_partitions_retrofit", false)) { proto.set_retrofit(true); } if (!MergeMetadata(metadata, &proto)) { cerr << "Warning: Failed to read metadata.\n"; } #ifdef __ANDROID__ if (!MergeFsUsage(&proto, cerr)) { cerr << "Warning: Failed to read filesystem size and usage.\n"; } #endif auto error_or_json = jsonpb::MessageToJsonString(proto); if (!error_or_json.ok()) { cerr << error_or_json.error() << "\n"; return EX_SOFTWARE; } cout << *error_or_json; return EX_OK; } static int DumpMetadataSize(const LpMetadata* metadata, std::ostream& cout) { auto super_device = GetMetadataSuperBlockDevice(*metadata); uint64_t metadata_size = super_device->first_logical_sector * LP_SECTOR_SIZE; cout << metadata_size << std::endl; return EX_OK; } class FileOrBlockDeviceOpener final : public PartitionOpener { public: android::base::unique_fd Open(const std::string& path, int flags) const override { // Try a local file first. android::base::unique_fd fd; #ifdef __ANDROID__ fd.reset(android_get_control_file(path.c_str())); if (fd >= 0) return fd; #endif fd.reset(open(path.c_str(), flags)); if (fd >= 0) return fd; return PartitionOpener::Open(path, flags); } }; int LpdumpMain(int argc, char* argv[], std::ostream& cout, std::ostream& cerr) { // clang-format off struct option options[] = { { "slot", required_argument, nullptr, 's' }, { "help", no_argument, nullptr, 'h' }, { "json", no_argument, nullptr, 'j' }, { "dump-metadata-size", no_argument, nullptr, 'd' }, { "is-super-empty", no_argument, nullptr, 'e' }, { nullptr, 0, nullptr, 0 }, }; // clang-format on // Allow this function to be invoked by lpdumpd multiple times. optind = 1; int rv; int index; uint32_t slot = 0; bool json = false; bool is_empty = false; bool dump_metadata_size = false; while ((rv = getopt_long_only(argc, argv, "s:jhde", options, &index)) != -1) { switch (rv) { case 'h': usage(argc, argv, cerr); return EX_OK; case 's': if (!android::base::ParseUint(optarg, &slot)) { slot = SlotNumberForSlotSuffix(optarg); } break; case 'e': is_empty = true; break; case 'd': dump_metadata_size = true; break; case 'j': json = true; break; case '?': case ':': return usage(argc, argv, cerr); } } std::unique_ptr pt; if (optind < argc) { FileOrBlockDeviceOpener opener; const char* file = argv[optind++]; if (!is_empty) { pt = ReadMetadata(opener, file, slot); } if (!pt && !IsBlockDevice(file)) { pt = ReadFromImageFile(file); } } else { #ifdef __ANDROID__ if (is_empty) { return usage(argc, argv, cerr); } auto slot_number = SlotNumberForSlotSuffix(GetSlotSuffix()); pt = ReadMetadata(GetSuperPartionName(), slot_number); #else return usage(argc, argv, cerr); #endif } // --json option doesn't require metadata to be present. if (json) { return PrintJson(pt.get(), cout, cerr); } if (!pt) { cerr << "Failed to read metadata.\n"; return EX_NOINPUT; } if (dump_metadata_size) { return DumpMetadataSize(pt.get(), cout); } cout << "Metadata version: " << pt->header.major_version << "." << pt->header.minor_version << "\n"; cout << "Metadata size: " << (pt->header.header_size + pt->header.tables_size) << " bytes\n"; cout << "Metadata max size: " << pt->geometry.metadata_max_size << " bytes\n"; cout << "Metadata slot count: " << pt->geometry.metadata_slot_count << "\n"; cout << "Partition table:\n"; cout << "------------------------\n"; for (const auto& partition : pt->partitions) { std::string name = GetPartitionName(partition); std::string group_name = GetPartitionGroupName(pt->groups[partition.group_index]); cout << " Name: " << name << "\n"; cout << " Group: " << group_name << "\n"; cout << " Attributes: " << BuildAttributeString(partition.attributes) << "\n"; cout << " Extents:\n"; uint64_t first_sector = 0; for (size_t i = 0; i < partition.num_extents; i++) { const LpMetadataExtent& extent = pt->extents[partition.first_extent_index + i]; cout << " " << first_sector << " .. " << (first_sector + extent.num_sectors - 1) << " "; first_sector += extent.num_sectors; if (extent.target_type == LP_TARGET_TYPE_LINEAR) { const auto& block_device = pt->block_devices[extent.target_source]; std::string device_name = GetBlockDevicePartitionName(block_device); cout << "linear " << device_name.c_str() << " " << extent.target_data; } else if (extent.target_type == LP_TARGET_TYPE_ZERO) { cout << "zero"; } cout << "\n"; } cout << "------------------------\n"; } cout << "Block device table:\n"; cout << "------------------------\n"; for (const auto& block_device : pt->block_devices) { std::string partition_name = GetBlockDevicePartitionName(block_device); cout << " Partition name: " << partition_name << "\n"; cout << " First sector: " << block_device.first_logical_sector << "\n"; cout << " Size: " << block_device.size << " bytes\n"; cout << " Flags: " << BuildBlockDeviceFlagString(block_device.flags) << "\n"; cout << "------------------------\n"; } cout << "Group table:\n"; cout << "------------------------\n"; for (const auto& group : pt->groups) { std::string group_name = GetPartitionGroupName(group); cout << " Name: " << group_name << "\n"; cout << " Maximum size: " << group.maximum_size << " bytes\n"; cout << " Flags: " << BuildGroupFlagString(group.flags) << "\n"; cout << "------------------------\n"; } return EX_OK; } int LpdumpMain(int argc, char* argv[]) { return LpdumpMain(argc, argv, std::cout, std::cerr); }