HP Caliper User Guide Release 5.5 (5900-2351, August 2012)

NOTE: With this HP Caliper option, you must use a qualifier or an equals sign (=). You cannot
use --memory-usage as 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. 153).
--metrics
See “-m or --metrics” (p. 49).
--module-default
--module-default all|none
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-include list.
If --module-default all is set, then HP Caliper includes all modules and only looks at the
--module-exclude list.
See “Specifying Which Load Modules to Collect Data For” (p. 94).
--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. 94).
--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
--metrics 65