[This is preliminary documentation and subject to change.]
| Parameter | Meaning |
|---|---|
| /i <filename> | The input file or directory to be filtered. The filename can contain the wildcard characters * and ?. |
| /l | Log messages are directed to a file, instead of the screen. Log messages describe the individual tests performed and the pass/fail result of the test. The log filename is the same as the input filename with a .log extension. |
| /d | Dump messages are directed to a file instead of the screen. Dump messages describe the contents of the chunks. The chunk structure is dumped when the verbosity level is 3. The dump filename is the same as the input filename with a .dmp extension. |
| /-l | Disable logging. This flag overrides /l |
| /-d | Disable dumping. This flag overrides /d |
| /v <integer> | The verbosity level. The test logs only messages concerning specific IFilter failures. The test dumps the chunk contents. The test logs warning messages. The test logs messages concerning tests which passed. The test logs informational messages. In addition, the test dumps the structure of the chunks. |
| /t <integer> | The number of threads to launch. One by default. |
| /r [<integer>] | Recursively filter subdirectories. The optional integer parameter specifies the depth to which to recurse. If no integer is specified, or if the integer is 0, full recursion is assumed. By default, the recursion depth is 1. |
| /c <integer> | The number of times to loop. If the integer is 0, the test loops infinitely. By default, the test loops only once. |
Note You must include a space between the command line switch and the value.
You can invoke the IFilter Test Suite from the command line as follows:
ifilttst /i test.htm /l /d /v 1
The above command line tells the program to filter the file "test.htm", redirect the log messages to "test.htm.log", redirect the dump messages to "test.htm.dmp" and to set the verbosity to 1.
For the above command to work, three files must be located in the current working directory: ifilttst.exe, ifilttst.ini and test.htm. The significance of ifilttst.ini is described in the next section.