3 # Copyright (C) 2012 The Android Open Source Project
5 # Licensed under the Apache License, Version 2.0 (the "License");
6 # you may not use this file except in compliance with the License.
7 # You may obtain a copy of the License at
9 # http://www.apache.org/licenses/LICENSE-2.0
11 # Unless required by applicable law or agreed to in writing, software
12 # distributed under the License is distributed on an "AS IS" BASIS,
13 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 # See the License for the specific language governing permissions and
15 # limitations under the License.
17 from __future__ import print_function
18 import getopt, posixpath, signal, struct, sys
22 Usage: %s [-v] sparse_image_file ...
29 signal.signal(signal.SIGPIPE, signal.SIG_DFL)
31 me = posixpath.basename(sys.argv[0])
33 # Parse the command line
36 opts, args = getopt.getopt(sys.argv[1:],
39 except getopt.GetoptError, e:
43 if o in ("-v", "--verbose"):
46 print("Unrecognized option \"%s\"" % (o))
50 print("No sparse_image_file specified")
55 header_bin = FH.read(28)
56 header = struct.unpack("<I4H4I", header_bin)
59 major_version = header[1]
60 minor_version = header[2]
61 file_hdr_sz = header[3]
62 chunk_hdr_sz = header[4]
64 total_blks = header[6]
65 total_chunks = header[7]
66 image_checksum = header[8]
68 if magic != 0xED26FF3A:
69 print("%s: %s: Magic should be 0xED26FF3A but is 0x%08X"
72 if major_version != 1 or minor_version != 0:
73 print("%s: %s: I only know about version 1.0, but this is version %u.%u"
74 % (me, path, major_version, minor_version))
77 print("%s: %s: The file header size was expected to be 28, but is %u."
78 % (me, path, file_hdr_sz))
80 if chunk_hdr_sz != 12:
81 print("%s: %s: The chunk header size was expected to be 12, but is %u."
82 % (me, path, chunk_hdr_sz))
85 print("%s: Total of %u %u-byte output blocks in %u input chunks."
86 % (path, total_blks, blk_sz, total_chunks))
88 if image_checksum != 0:
89 print("checksum=0x%08X" % (image_checksum))
93 print(" input_bytes output_blocks")
94 print("chunk offset number offset number")
96 for i in xrange(1,total_chunks+1):
97 header_bin = FH.read(12)
98 header = struct.unpack("<2H2I", header_bin)
99 chunk_type = header[0]
100 reserved1 = header[1]
103 data_sz = total_sz - 12
105 print("%4u %10u %10u %7u %7u" % (i, FH.tell(), data_sz, offset, chunk_sz),
108 if chunk_type == 0xCAC1:
109 if data_sz != (chunk_sz * blk_sz):
110 print("Raw chunk input size (%u) does not match output size (%u)"
111 % (data_sz, chunk_sz * blk_sz))
114 print("Raw data", end="")
116 elif chunk_type == 0xCAC2:
118 print("Fill chunk should have 4 bytes of fill, but this has %u"
122 fill_bin = FH.read(4)
123 fill = struct.unpack("<I", fill_bin)
124 print("Fill with 0x%08X" % (fill))
125 elif chunk_type == 0xCAC3:
127 print("Don't care chunk input size is non-zero (%u)" % (data_sz))
130 print("Don't care", end="")
131 elif chunk_type == 0xCAC4:
133 print("CRC32 chunk should have 4 bytes of CRC, but this has %u"
138 crc = struct.unpack("<I", crc)
139 print("Unverified CRC32 0x%08X" % (crc))
141 print("Unknown chunk type 0x%04X" % (chunk_type), end="")
145 header = struct.unpack("<12B", header_bin)
146 print(" (%02X%02X %02X%02X %02X%02X%02X%02X %02X%02X%02X%02X)"
147 % (header[0], header[1], header[2], header[3],
148 header[4], header[5], header[6], header[7],
149 header[8], header[9], header[10], header[11]))
155 print(" %10u %7u End" % (FH.tell(), offset))
157 if total_blks != offset:
158 print("The header said we should have %u output blocks, but we saw %u"
159 % (total_blks, offset))
161 junk_len = len(FH.read())
163 print("There were %u bytes of extra data at the end of the file."
168 if __name__ == "__main__":