Documentation for "expecto"

Download the whole documentation as one plain text file


3. Usage and Options

3.3. Command Line Options

The following command line options are supported:

-r <n>
Select reporting level (default: 2).
-d <n>
Select debug output level (default: 0).

Reporting Level

The reporting level is set with the "-r" option. It specifies what is to be printed when the input data does not match the template. The following levels can be used:

0
Only print the number of the input line at which the mismatch was detected, and exit with error code 1. This is intended to be used by other programs and scripts that call expecto and parse its output. Do not use this within normal crontab entries.
1
Print the contents of the input line at which the mismatch was detected (if this happens to be an empty line, then the following line(s) are printed, too, until a non-empty line is encountered).
2
Print all the rest of the input, starting at the line at which the mismatch was detected. This is the default.
3
Print a complete copy of the input, i.e. all lines.

Except for reporting level 0, the output is preceded by a message that describes the kind of mismatch, also mentioning the number of the line at which the mismatch was detected.

Note: If the input did match the template, nothing is printed at all (except if reporting statements in the template were triggered). This is independent of the reporting level. In this case, the exit code is 0.

Debug Output Level

The debug output level is set with the "-d" option. By default it is 0, i.e. debug output is disabled. When enabled, it can produce a huge amount of output, so beware. This is intended to be used by developers for debugging only. Do not use it within normal crontab entries.



[Valid XHTML 1.0]