NOTE: With this HP Caliper option, you must use a qualifier or an equals sign (=). You cannot use --memory-usageas the option. You must use --memory-usage=.

If you specify --memory-usage=, then --memory-usage=all is assumed.

Use of this option causes two different sets of memory measurements to be taken, each reported in its own table in the report:

•Overall memory available (and currently in use and free) on the system

•Memory currently being consumed by the process(es) being measured by a particular HP Caliper run

For details, see “Measuring Memory Usage Concurrently with Other Measurements ” (p. 154).

--metrics

See “-m or --metrics” (p. 50).

--module-default

--module-default allnone

Specifies the default setting for load module inclusion in the measurement.

If --module-default none is set, then HP Caliper excludes all modules and only looks at the --module-includelist.

If --module-default all is set, then HP Caliper includes all modules and only looks at the --module-excludelist.

See “Specifying Which Load Modules to Collect Data For” (p. 95).

--module-exclude

--module-exclude module1:module2:...

Specifies explicitly the load modules to be excluded from measurement.

You can specify module names in several ways:

•As a simple file name (libapplib1.so) that matches libraries of this name in any directory

•As a full-path file name (/home/dev/libs/libapplib1.so) that matches only this one specific library

•As a full-path directory name (/usr/lib/) that matches all libraries within this directory or any lower subdirectories

For measurements that get their data from the PMU (that is, most of the HP Caliper measurements), this option will show no data in the Function Summary/Details sections for the selected modules. However, this does not mean that samples did not occur in these modules.

See “Specifying Which Load Modules to Collect Data For” (p. 95).

--module-include

--module-include module1:module2:...

Specifies explicitly the load modules to be included in the measurement.

You can specify module names in several ways:

•As a simple filename (libapplib1.so) that matches libraries of this name in any directory

•As a full-path file name (/home/dev/libs/libapplib1.so) that matches only this one specific library

•As a full-path directory name (/usr/lib/) that matches all libraries within this directory or any lower subdirectories

66 HP Caliper Options