Lines Matching full:the
8 This work is licensed under the terms of the GNU GPL, version 2 or later.
9 See the COPYING file in the top-level directory.
29 A data chunk of the size specified in the image header.
30 Currently, the default size is 1MiB (2048 sectors). In previous
40 The header is placed at the start of an image and contains the following
66 Only the lowest 4 bytes are used. The highest 4 bytes must be
73 Set to 0x746F6E59 when the image is opened by software in R/W
74 mode; set to 0x312e3276 when the image is closed.
76 A zero in this field means that the image was opened by an old
77 version of the software that doesn't support Format Extension
83 An offset, in sectors, from the start of the file to the start of
84 the data area.
87 - If data_off is zero, the offset is calculated as the end of BAT
89 - If data_off is non-zero, the offset should be aligned to sector
99 Bit 0: Empty Image bit. If set, the image should be
105 Format Extension offset, an offset, in sectors, from the start of
106 the file to the start of the Format Extension Cluster.
108 ext_off must meet the same requirements as cluster offsets
114 BAT is placed immediately after the image header. In the file, BAT is a
118 Each BAT entry contains an offset from the start of the file to the
119 corresponding cluster. The offset set in clusters for ``WithouFreSpacExt``
122 If a BAT entry is zero, the corresponding cluster is not allocated and should
125 Cluster offsets specified by BAT entries must meet the following requirements:
127 - the value must not be lower than data offset (provided by ``header.data_off``
129 - the value must be lower than the desired file size
130 - the value must be unique among all BAT entries
131 - the result of ``(cluster offset - data offset)`` must be aligned to
137 The data area is an area from the data offset (provided by ``header.data_off``
138 or calculated as specified above) to the end of the file. It represents a
139 contiguous array of clusters. Most of them are allocated by the BAT, some may
140 be allocated by the ``ext_off`` field in the header while other may be
142 should meet the same requirements as clusters specified by BAT entries.
148 The Format Extension is an area 1 cluster in size that provides additional
149 format features. This cluster is addressed by the ext_off field in the header.
150 The format of the Format Extension area is the following::
156 The MD5 checksum of the entire Header Extension cluster except
157 the first 24 bytes.
159 The above are followed by feature sections or "extensions". The last
162 Each feature section has the following format::
165 The identifier of the feature:
173 If the software cannot load the extension (due to an
174 unknown magic number or error), the file should not be
176 loading the extension, said extension should be dropped.
182 If neither NECESSARY nor TRANSIT are set, the extension should be
186 The size of the following feature data, in bytes.
193 The above is followed by padding to the next 8 bytes boundary, then the
196 The last extension must be "End of features" with all the fields set to 0.
202 This feature provides a way of storing dirty bitmaps in the image. The fields
206 The bitmap size, should be equal to disk size in sectors.
212 Bitmap granularity, in sectors. I.e., the number of sectors
213 corresponding to one bit of the bitmap. Granularity must be
217 The number of entries in the L1 table of the bitmap.
221 The dirty bitmap described by this feature extension is stored in a set of
222 clusters inside the Parallels image file. The offsets of these clusters are
223 saved in the L1 offset table specified by the feature extension. Each L1 table
226 Given an offset in bytes into the bitmap data, corresponding L1 entry is::
230 If an L1 table entry is 0, all bits in the corresponding cluster of the bitmap
233 If an L1 table entry is 1, all bits in the corresponding cluster of the bitmap
236 If an L1 table entry is not 0 or 1, it contains the corresponding cluster
237 offset (in 512b sectors). Given an offset in bytes into the bitmap data the
238 offset in bytes into the image file can be obtained as follows::