7.2. Common command line options

All EMMA command line tools have a set of common options:

-p, -props, -properties .properties file

This option specifies a pathname for an EMMA property override file, in the standard java.util.Properties format. The pathname could be either relative (in which case it is resolved relative to the JVM's current working directory) or absolute. See Chapter 3, EMMA Property Reference for more information on setting EMMA properties.

-Dname=value, -Dname:value, -Dname value

This option sets a single EMMA property. Note that this is different from using the JVM -D option (the name is not “emma.”-prefixed). See Chapter 3, EMMA Property Reference for more information on EMMA properties.


To enable tool chaining and integration via main() entry methods, EMMA command line tools do not terminate via java.lang.System.exit() by default. If desired for shell and makefile integration, this can be changed by using this option on the command line. The Diagnostics section on every tool's reference page details the error codes the tool returns to the operating system.


These options set EMMA tool verbosity levels to be much lower than normal, lower than normal, and above normal, respectively. These options are shortcuts to setting the verbosity.level property.

-h, -help

This option causes EMMA tools to print their usage summaries to System.out. The longer form of the option results in slightly more detailed usage printout.