1mprof-report(1)             General Commands Manual            mprof-report(1)
2
3
4

NAME

6       mprof-report - report generator for Mono's log profiler
7

SYNOPSIS

9       mprof-report [option]... file.mlpd
10

DESCRIPTION

12       mprof-report  is the report generator for Mono's log profiler. It reads
13       the MLPD log files produced by the log profiler and generates a  report
14       based  on  the  options passed to it. The output is based on individual
15       reports which can be turned on or off.  By  default,  all  reports  are
16       generated in summary form (i.e., non-verbose output).
17
18       mprof-report  can  read  both  normal  and gzip(1)-compressed log files
19       transparently.
20
21       For information about how to use the log profiler with a  program,  see
22       the mono-profilers(1) page, under the LOG PROFILER section.
23

OPTIONS

25       The following options are available:
26
27       --help Displays usage instructions.
28
29       --out=file
30              Write the report output to file instead of standard output.
31
32       --traces
33              Show backtraces in reports when available.
34
35       --maxframes=num
36              Limit backtraces to num frames.
37
38       --reports=reports
39              Generate  only  the  specified reports. reports is a comma-sepa‐
40              rated list of reports. See the REPORTS section.
41
42       --method-sort=mode
43              Sort methods according to mode, which can be one of:
44
45              total (default)
46                     Sort by the total amount of time spent in  a  method  and
47                     its callees.
48
49              self   Sort  by  the  amount  of time spent only within a method
50                     itself.
51
52              calls  Sort by the total amount of calls made to a method.
53
54       --alloc-sort=mode
55              Sort allocations according to mode, which can be one of:
56
57              bytes (default)
58                     Sort by the amount of heap bytes occupied  by  all  allo‐
59                     cated objects of a type.
60
61              count  Sort by the total amount of allocations of a type.
62
63       --counters-sort=mode
64              Sort  counters  according  to mode. This alters how the counters
65              report is presented. It can be one of:
66
67              time (default)
68                     Present a list of samples,  each  containing  a  list  of
69                     counter name-value pairs.
70
71              category
72                     Present  a  list of counter names, each containing a list
73                     of sampled values.
74
75              This option has no effect unless --verbose is passed.
76
77       --track=objects
78              Track what happens to the specified objects. objects is a comma-
79              separated list of object addresses.
80
81       --find=spec
82              Find  and track what happens to objects matching spec, which can
83              have one of these forms:
84
85              S:minimum_size
86                     Look for objects that are at least minimum_size bytes  in
87                     size.
88
89              T:name_fragment
90                     Look for objects whose type name contain name_fragment.
91
92              Both an S and T spec can be given by passing the option twice.
93
94       --thread=tid
95              Consider only events from the thread with ID tid.
96
97       --time=span
98              Consider  only events occurring in the specified time span. span
99              must be of the form from-to where from and to are seconds  since
100              the program started.
101
102       --verbose
103              Print verbose output.
104
105       --debug
106              Print extremely detailed debug output. Most users should not use
107              this option.
108

REPORTS

110       The following reports are available:
111
112       header Program startup and profiler version  and  operational  informa‐
113              tion.
114
115       jit    JIT compiler statistics.
116
117       gc     Garbage collection and handle statistics.
118
119       sample Flat statistical sampling profile.
120
121       alloc  Per-class GC allocation statistics and backtraces.
122
123       call   Method call statistics and backtraces.
124
125       metadata
126              Loaded images and assemblies.
127
128       exception
129              Exception statistics and backtraces.
130
131       monitor
132              Monitor lock statistics and backtraces.
133
134       thread Managed thread names.
135
136       domain Loaded application domains.
137
138       context
139              Loaded remoting contexts.
140
141       heapshot
142              Heap snapshot information.
143
144       counters
145              Performance counter samples.
146

SEE ALSO

148       mono(1), mono-profilers(1)
149
150
151
152                                                               mprof-report(1)
Impressum