storage/resources/ResourcesFormat.tex

44 (resource files), on the other hand these are file formats extended to
67 x86 resource files introduce the least overhead. The resources start directly
82 PPC resource files begin with a PEF container header, after which the
170 from the type of the file. x86 resource files contain little endian, PPC
171 resource files big endian data. The endianess of an ELF file is encoded in
174 As there is in fact no good reason to have different resource file formats,
176 \ref{file-formats}), it may be decided to use the x86 resource file format
195                 & index section & resource index \\
217   resource index subsection. The latter locates all other data in the file.
222 \item{A data section holding the actual resource data.
224 \item{An info section, which provides aditional information for each resource,
263   Specifies the offset of the resource index section relative to the beginning
282 The resource index section starts with a header, it follows a table of
283 \code{resource\_index\_entry} structures, that locates the data of each
284 resource, and the section ends with a special padding.
287 The resource index header has the following structure:
311   Specifies the offset of the resource index section relative to the beginning
317   Specifies the size of the resource index section.
338   Specifies the offset of the resource info table relative to the beginning
342   Specifies the size of the resource info table.
349 Directly, without padding, it follows a table of \code{resource\_index\_entry}
354 the size of \code{resource\_index\_entry} and the number of resources.
369   Specifies the offset of the resource data relative to the beginning
373   Specifies the size of the resource data.
380 Since the size of the resource index section must be a multiple of
420 The resource info table features exactly one entry for each resource.
421 Such an entry (resource info) specifies the ID and name of a
422 resource. Subsequent infos for resources of the same type are collected in
425 The following grammar specifies the layout of the resource info table.
464   Is the first resource info of the block. More infos may follow.
485   Specifies the ID of the resource.
488   Specifies the index of the resource this resource info refers to.
491   Specifies the size of the resource name. May be 0 -- then the resource does
495   Specifies the name of the resource. The name must be null terminated.
497   terminating null). If it is 0, the resource does not have a name and
501   Is the minimal size of a resource info. That is the size it has, if the
502   resource does not have a name.
537   Contains the check sum for the resource info table. The check sum is
538   calculated from all bytes of the resource info table not including
546   Terminates the resource info table.
565 \item{The third and fourth byte of the x86 resource file magic (the 0 bytes)
567 \item{\code{rh\_resource\_count} may be unreliable. The resource index table
571 \item{The resource info table may contain entries for indices that are out
572   of range, i.e. greater than the number of resources induced by the resource
574 \item{The resource info table may contain multiple entries for an index.
576 \item{The resource info table may not contain an entry for an index.
577   The respective resource should be ignored.}
578 \item{The resource info table may not contain a \code{ResourceInfoTableEnd}
609   header is unclear. The same holds for the resource index section header.}