The analyze directive

This section is for reference; see Writing an execute/analyze test for more detail on how to use the "analyze" directive.

The "analyze" directive can only be used in a test that contains at least one "parameterize" directive. A separate test instance is created and is run after all the parameterized tests have completed.

The script to run the analysis can either be the test script itself, or a separate script associated with the test. For example, a test with

#VVT: analyze : --analyze

will run the test script itself but it will be given the --analyze command line option. Whereas, a test with

#VVT: analyze : scriptname

will run the scriptname file instead. The logic used is simply whether the "analyze" value starts with a hyphen or not. If it does, then the test script is called to run the analysis and given the value as an option.

Allowable attributes

The only attributes are these common ones: "testname", "platform", and "option". These decide whether the directive is processed or not.