Download CXperf User's Guide

Using CXoi to instrument object files and archive libraries . . . . . . . . .
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Preparing for profiling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Instrumenting with CXoi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Linking the instrumented files . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CXoi limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4
Choosing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Introducing metrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Metrics available on all architectures . . . . . . . . . . . . . . . . . . . . . . . . .
Architecture-dependent metrics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Process events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Memory events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Data Cache Utilization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Data and Instruction TLB misses. . . . . . . . . . . . . . . . . . . . . . . . . . .
Derived metrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using event metrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Instrumenting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Instrumenting in GUI mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Selecting routines and loops . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Selecting loop nesting levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Selecting metrics to collect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Instrumenting in line mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Selecting routines and loops . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Selecting loop nesting levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Selecting metrics to collect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Preinstrumenting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Setting the environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Performance Data Files (PDFs) . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CXperf command line options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The PROFDIR environment variable . . . . . . . . . . . . . . . . . . . . . . . .
Preinstrumenting in GUI mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Preinstrumenting in line mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5
38
38
39
39
39
40
42
43
44
44
45
45
46
46
47
49
49
49
53
56
58
58
61
63
65
65
65
66
66
67
69
Profiling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Profiling strategy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Profiling intrusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Minimizing intrusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Routines that call uninstrumented routines . . . . . . . . . . . . . . . . . . . .
Profiling MPI and PVM applications . . . . . . . . . . . . . . . . . . . . . . . . . . .
Generating PDFs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using CXmerge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Syntax. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Analyzing merged data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
iv
74
74
76
77
79
79
80
80
81
Table of Contents