windows-server-2003/base/ntsetup/inf/win4/tools/escpeinf/escpeinf.txt

Author: Sandy Coyne
Date: March 7, 2000


Given two files as input, ESCPEINF.EXE generates one output file.

Usage: escpeinf U|C <input file> <output file> <layout.inf>
        U = Upgrade
        C = Clean Install
All fields are required.

The input file must be an inf file containing a [File Security] section. If it does not contain that section, the output file should be identical to the input.

All comparisons are case insensitive. All quotes are required where shown.

Any line that does not fit the following format should be copied to the output file unchanged.

Recognized Input Lines, only in the [File Security] section:

	"<directory>\<WildCardName>",<Integer>,"<SecurityDescriptorString>"

After a line containing a wildcard, there may be zero or more exception lines:

	Exception="<ExceptionFileName>"


Input Detail:
<directory> must be one of the directories in the layout.inf [WinntDirectories] section, and it must begin with "%SystemRoot%" or "%SystemDirectory%"   An example is "%SystemRoot%\Help"

<WildCardName> must be a filename containing at least one wildcard.   An example is "*.hlp"

<Integer> must be a natural integer. Since ESCAPE only accepts a few low numbers, it is possible that huge integers will break the tool. This is okay.   An example is "2"

<SecurityDescriptorString> is a properly formatted security descriptor string. One important aspect of this formatting is that it cannot contain any whitespace.  An example is "D:P(A;;GRGX;;;BU)(A;;GRGX;;;PU)(A;;GA;;;BA)(A;;GA;;;SY)"

<ExceptionFileName> is a file name, with no path. If desired, it can contain wildcards.   Examples are "win.ini" or "*.hlp"

Output:
The Recognized Input Lines will not appear in the output. In their place will be lines in this format:
	"<directory>\<filename1>",<Integer>,"<SecurityDescriptorString>"
	"<directory>\<filename2>",<Integer>,"<SecurityDescriptorString>"
	"<directory>\<filename3>",<Integer>,"<SecurityDescriptorString>"
			.
			.
			.

Output Detail:
<directory> will be identical to the <directory> field of the input.

<filenameX> will be a filename that is found in the layout.inf that matches the <WildCardName> field of the input and is destined for <directory>, except if the filename matches the <ExceptionFileName> field, or if the file is never installed in this mode (Upgrade or Clean Install).

<Integer> will be identical to the <Integer> field of the input.

<SecurityDescriptorString> will be identical to the <SecurityDescriptorString> field of the input.