128fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross#! /usr/bin/env python 228fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross 328fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross# Copyright (C) 2012 The Android Open Source Project 428fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross# 528fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross# Licensed under the Apache License, Version 2.0 (the "License"); 628fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross# you may not use this file except in compliance with the License. 728fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross# You may obtain a copy of the License at 828fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross# 928fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross# http://www.apache.org/licenses/LICENSE-2.0 1028fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross# 1128fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross# Unless required by applicable law or agreed to in writing, software 1228fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross# distributed under the License is distributed on an "AS IS" BASIS, 1328fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1428fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross# See the License for the specific language governing permissions and 1528fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross# limitations under the License. 1628fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross 1728fa5bc347390480fe190294c6c385b6a9f0d68bColin Crossfrom __future__ import print_function 1828fa5bc347390480fe190294c6c385b6a9f0d68bColin Crossimport getopt, posixpath, signal, struct, sys 1928fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross 2028fa5bc347390480fe190294c6c385b6a9f0d68bColin Crossdef usage(argv0): 2128fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print(""" 2228fa5bc347390480fe190294c6c385b6a9f0d68bColin CrossUsage: %s [-v] sparse_image_file ... 2328fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross -v verbose output 2428fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross""" % ( argv0 )) 2528fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross sys.exit(2) 2628fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross 2728fa5bc347390480fe190294c6c385b6a9f0d68bColin Crossdef main(): 2828fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross 2928fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross signal.signal(signal.SIGPIPE, signal.SIG_DFL) 3028fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross 3128fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross me = posixpath.basename(sys.argv[0]) 3228fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross 3328fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross # Parse the command line 3428fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross verbose = 0 # -v 3528fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross try: 3628fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross opts, args = getopt.getopt(sys.argv[1:], 3728fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross "v", 3828fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross ["verbose"]) 3928fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross except getopt.GetoptError, e: 4028fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print(e) 4128fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross usage(me) 4228fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross for o, a in opts: 4328fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross if o in ("-v", "--verbose"): 4428fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross verbose += 1 4528fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross else: 4628fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print("Unrecognized option \"%s\"" % (o)) 4728fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross usage(me) 4828fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross 4928fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross if len(args) == 0: 5028fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print("No sparse_image_file specified") 5128fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross usage(me) 5228fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross 5328fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross for path in args: 5428fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross FH = open(path, 'rb') 5528fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross header_bin = FH.read(28) 5628fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross header = struct.unpack("<I4H4I", header_bin) 5728fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross 5828fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross magic = header[0] 5928fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross major_version = header[1] 6028fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross minor_version = header[2] 6128fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross file_hdr_sz = header[3] 6228fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross chunk_hdr_sz = header[4] 6328fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross blk_sz = header[5] 6428fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross total_blks = header[6] 6528fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross total_chunks = header[7] 6628fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross image_checksum = header[8] 6728fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross 6828fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross if magic != 0xED26FF3A: 6928fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print("%s: %s: Magic should be 0xED26FF3A but is 0x%08X" 7028fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross % (me, path, magic)) 7128fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross continue 7228fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross if major_version != 1 or minor_version != 0: 7328fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print("%s: %s: I only know about version 1.0, but this is version %u.%u" 7428fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross % (me, path, major_version, minor_version)) 7528fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross continue 7628fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross if file_hdr_sz != 28: 7728fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print("%s: %s: The file header size was expected to be 28, but is %u." 7828fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross % (me, path, file_hdr_sz)) 7928fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross continue 8028fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross if chunk_hdr_sz != 12: 8128fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print("%s: %s: The chunk header size was expected to be 12, but is %u." 8228fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross % (me, path, chunk_hdr_sz)) 8328fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross continue 8428fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross 8528fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print("%s: Total of %u %u-byte output blocks in %u input chunks." 8628fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross % (path, total_blks, blk_sz, total_chunks)) 8728fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross 8828fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross if image_checksum != 0: 8928fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print("checksum=0x%08X" % (image_checksum)) 9028fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross 9128fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross if not verbose: 9228fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross continue 9328fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print(" input_bytes output_blocks") 9428fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print("chunk offset number offset number") 9528fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross offset = 0 9628fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross for i in xrange(1,total_chunks+1): 9728fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross header_bin = FH.read(12) 9828fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross header = struct.unpack("<2H2I", header_bin) 9928fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross chunk_type = header[0] 10028fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross reserved1 = header[1] 10128fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross chunk_sz = header[2] 10228fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross total_sz = header[3] 10328fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross data_sz = total_sz - 12 10428fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross 10528fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print("%4u %10u %10u %7u %7u" % (i, FH.tell(), data_sz, offset, chunk_sz), 10628fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross end=" ") 10728fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross 10828fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross if chunk_type == 0xCAC1: 10928fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross if data_sz != (chunk_sz * blk_sz): 11028fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print("Raw chunk input size (%u) does not match output size (%u)" 11128fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross % (data_sz, chunk_sz * blk_sz)) 11228fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross break; 11328fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross else: 11428fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print("Raw data", end="") 11528fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross FH.read(data_sz) 11628fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross elif chunk_type == 0xCAC2: 11728fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross if data_sz != 4: 11828fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print("Fill chunk should have 4 bytes of fill, but this has %u" 11928fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross % (data_sz), end="") 12028fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross break; 12128fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross else: 12228fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross fill_bin = FH.read(4) 12328fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross fill = struct.unpack("<I", fill_bin) 12428fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print("Fill with 0x%08X" % (fill)) 12528fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross elif chunk_type == 0xCAC3: 12628fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross if data_sz != 0: 12728fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print("Don't care chunk input size is non-zero (%u)" % (data_sz)) 12828fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross break; 12928fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross else: 13028fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print("Don't care", end="") 13128fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross elif chunk_type == 0xCAC4: 13228fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross if data_sz != 4: 13328fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print("CRC32 chunk should have 4 bytes of CRC, but this has %u" 13428fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross % (data_sz), end="") 13528fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross break; 13628fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross else: 13728fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross crc_bin = FH.read(4) 13828fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross crc = struct.unpack("<I", crc) 13928fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print("Unverified CRC32 0x%08X" % (crc)) 14028fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross else: 14128fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print("Unknown chunk type 0x%04X" % (chunk_type), end="") 14228fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross break; 14328fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross 14428fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross if verbose > 1: 14528fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross header = struct.unpack("<12B", header_bin) 14628fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print(" (%02X%02X %02X%02X %02X%02X%02X%02X %02X%02X%02X%02X)" 14728fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross % (header[0], header[1], header[2], header[3], 14828fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross header[4], header[5], header[6], header[7], 14928fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross header[8], header[9], header[10], header[11])) 15028fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross else: 15128fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print() 15228fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross 15328fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross offset += chunk_sz 15428fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross 15528fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print(" %10u %7u End" % (FH.tell(), offset)) 15628fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross 15728fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross if total_blks != offset: 15828fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print("The header said we should have %u output blocks, but we saw %u" 15928fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross % (total_blks, offset)) 16028fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross 16128fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross junk_len = len(FH.read()) 16228fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross if junk_len: 16328fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross print("There were %u bytes of extra data at the end of the file." 16428fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross % (junk_len)) 16528fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross 16628fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross sys.exit(0) 16728fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross 16828fa5bc347390480fe190294c6c385b6a9f0d68bColin Crossif __name__ == "__main__": 16928fa5bc347390480fe190294c6c385b6a9f0d68bColin Cross main() 170