HP Caliper 5.3 User Guide (5900-1558, February 2011)

Default Settings for Load Module Data Collection
HP Caliper uses these default settings:
module-default all
module-include libdl.so
module-exclude
uld.so•
• dld.so
• libsin.so
You cannot override the settings for uld.so, dld.so, and libsin.so.
How to Specify Load Module Names
HP Caliper matches load module names in the following way:
• If you provide a full path for the module name, only an exact match succeeds.
• To imply all modules within a directory and its subdirectories, you provide a directory name
with a trailing slash (/).
• If you do not specify the full path, only the base file name is used to match module names.
For example, if you specify the full path like this:
--module-include /usr/lib/hpux64/libc.so
You get these results:
/usr/lib/hpux64/libc.so match
/usr/lib/hpux64/libc.so.1 no match
/usr/lib/hpux32/libc.so no match
If you provide the base file name without the full path, HP Caliper considers it a match if the base
file name is the suffix of the loaded module or if the base file name is present in the load module's
full path and followed by a period (.).
For example:
--module-exclude libc
gives these results:
/usr/lib/hpux64/libc.so match
/usr/lib/hpux64/libc.so.1 match
Here is another example:
--module-include libcur
gives these results:
/usr/lib/hpux64/
libcurses.so
no match
To match, you would have to specify libcurses.
You can repeat each of these options multiple times. HP Caliper uses the last value of
--module-default given.
If you specify --module-default all, then HP Caliper uses only files specified in the
--module-exclude list.
If you specify --module-default none, then HP Caliper uses only files specified in the
--module-include list.
For example, if you only want to include libc in a measurement, you would use these options:
--module-default none --module-include libc
Configuring Data Collection 95