aboutsummaryrefslogtreecommitdiff
path: root/README
blob: 68468229ae3cc3686e508ef9ab31e30d38e01232 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
README for matrix-report.pl
===========================

This program processes perf.data files to produce a matrix profile
in HTML format. The resulting HTML uses Javascript and CSS so requires
a reasonably modern web browser to view.

How to use
==========

Perf record must be run with --all-cpus. For example:

    $ perf record --all-cpus <testcommand>
    $ perl .../matrix-report.pl --input perf.data --output report.html

Command line interface
======================

    --report-interval <number of seconds per timeslot> [default: 1]
       * this option selects the time represented by each row in
         the output matrix.
    --sample-interval <perf sample interval> 
    --sample-frequency <perf sample frequency>         [default: automatic]
       * can be used if matrix-report.pl does not correctly determine
         the perf sampling frequency
    --min-task-cpu <%age>                              [default: 1]
       * tasks below this %age CPU usage are hidden from the default
         display
    --output <path>                                    [default: stdout]
       * filename to generate output
    --input <path>
       * path to perf.data file
    --perf <path>                                      [default: perf]
       * name of perf binary to use for analysing perf.data file