--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. 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

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

--module-search-path

--module-search-path directory[:directory[:...]]

Specifies a list of directories to search when a load module file (executable or shared library) cannot be found by using the path obtained from the process. This typically happens if the measured process uses chroot(2) or chdir(2) and then loads libraries or executes other binaries using relative paths.

--module-default 65

Page 65
Image 65
HP UX Caliper Software manual Module-default, Module-exclude, Module-include, Module-search-path