File Sequencing and How Files are Located

Heath Stewart

The File table in a Windows Installer package has a Sequence column that begins with 1. Besides determining in what order files are to be installed, this column serves another, relatively more important function: determining where the source files are located.

In concert with the Media table, a range of sequence numbers identify in which cabinet – if that range of files is even compressed – the files are located. The Media table has a column named LastSequence that is inclusive of the maximum sequence number of a particular file range. All files in the File table with a sequence number greater than the previous Media table entry’s LastSequence and less than or equal to another Media table entry’s LastSequence are contained in the latter media. To put that a little more plainly, see the following color-coded tables.

File table (partial)

File FileName Attributes Sequence
A_DLL a.dll 0 1
B_DLL b.dll 0 2
C_DLL c.dll 16384 3
D_DLL d.dll 16384 4

Media table

DiskId LastSequence DiskPrompt Cabinet VolumeLabel Source
1 2 Disk 1 AB.cab DISK1  
2 4 Disk 2 #CD.cab DISK2  

The files a.dll and b.dll may be compressed into AB.cab, while c.dll and d.dll will be compressed into CD.cab. CD.cab begins with a hash symbol (#) because, as documented for the Cabinet data type, that cabinet will be embedded as a stream within the .msi package. AB.cab would identify a cabinet in the root of the source tree specified in the Directory table.

You might also notice that I said the files a.dll and b.dll may be compressed into AB.cab because, depending on the Word Count, those files aren’t explicitly attributed to be compressed. The Word Count Summary Property describes the default setting for whether files are compressed or uncompressed. As documented in Compressed and Uncompressed Sources, the Attributes column values of the File table override the Word Count property value. So, if the Word Count property specified that all sources were compressed then files a.dll and b.dll would be compressed into AB.cab; otherwise, if the Word Count property specified that all sources were uncompressed then only files c.dll and d.dll would be compressed into their respective cabinet.

Now, for example, b.dll needs to be patched. A patch must carry the new copy (or binary delta patch) of b.dll so it must change the file sequence of b.dll to match up with a new entry in the Media table to be added by one of the patch transforms for a particular product, as discussed in more detail in What’s in a Patch. The transform beginning with a hash symbol (#) would make the following changes from the previous tables.

File table (partial)

File FileName Attributes Sequence
A_DLL a.dll 0 1
C_DLL c.dll 16384 3
D_DLL d.dll 16384 4
B_DLL b.dll 20480 5

Media table

DiskId LastSequence DiskPrompt Cabinet VolumeLabel Source
1 2 Disk 1 AB.cab DISK1  
2 4 Disk 2 #CD.cab DISK2  
3 5   #P1.cab   MspSrc3

PatchPackage table

PatchId Media_
{45F3433D-47C1-4AAF-9B4C-4FA759A02C0A} 3

Re-sequencing this file locates it in the the patch in the embedded stream named P1.cab. The attributes are changed to msidbFileAttributesPatchAdded (4096) + msidbFileAttributesCompressed (16384), the latter of which to override whatever the default Word Count is set for the .msi package being patched. The Word Count property value of the .msp file is used to identify the minimum version of Windows Installer required to install the patch and does not specify compression. Prior to Windows Installer 2.0 you had to guarauntee uniqueness of file sequence numbers for both the installer package for all patches, but starting with Windows Installer 2.0 you need only ensure that file sequences numbers are correct for a given package since Windows Installer 2.0 and newer will automatically adjust file sequence number as necessary.

When the transforms are applied from a patch and the files are re-sequenced, a reinstall of the affected features or all of the product is performed as documented in How Patching Works. The value in the Source column of the Media table for DiskId 3 is used to identify the location of the .msp file in order to locate the embedded cabinet.

Do note that the default schema of the File and Media tables allow for a maximum of 32,767 files including all changes made by any applicable patches. In the last set of tables, Windows Installer would view the product as now having 5 files. The reason is that the column data type is only a 2-byte signed integer. For more information about how to author a package with more initial files or to allow for many more patches, read Authoring a Large Package.

0 comments

Discussion is closed.

Feedback usabilla icon