lkml.org 
[lkml]   [2016]   [Feb]   [17]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    Patch in this message
    /
    From
    Subject[PATCH 4/6] perf, tools, stat: Document CSV format in manpage
    Date
    From: Andi Kleen <ak@linux.intel.com>

    With all the recently added fields in the perf stat CSV output
    we should finally document them in the man page. Do this here.

    v2: Fix fields in documentation (Jiri)
    v3: fix order of fields again (Jiri)
    v4: Change order again.
    Signed-off-by: Andi Kleen <ak@linux.intel.com>
    ---
    tools/perf/Documentation/perf-stat.txt | 21 +++++++++++++++++++++
    1 file changed, 21 insertions(+)

    diff --git a/tools/perf/Documentation/perf-stat.txt b/tools/perf/Documentation/perf-stat.txt
    index 52ef7a9..3ae7907 100644
    --- a/tools/perf/Documentation/perf-stat.txt
    +++ b/tools/perf/Documentation/perf-stat.txt
    @@ -211,6 +211,27 @@ $ perf stat -- make -j

    Wall-clock time elapsed: 719.554352 msecs

    +CSV FORMAT
    +----------
    +
    +With -x, perf stat is able to output a not-quite-CSV format output
    +Commas in the output are not put into "". To make it easy to parse
    +it is recommended to use a different character like -x \;
    +
    +The fields are in this order:
    +
    + - optional usec time stamp in fractions of second (with -I xxx)
    + - counter value
    + - unit of the counter value or empty
    + - event name
    + - run time of counter
    + - percentage of measurement time the counter was running
    + - optional variance if multiple values are collected with -r
    + - optional metric value
    + - optional unit of metric
    +
    +Additional metrics may be printed with all earlier fields being empty.
    +
    SEE ALSO
    --------
    linkperf:perf-top[1], linkperf:perf-list[1]
    --
    2.5.0
    \
     
     \ /
      Last update: 2016-02-18 00:01    [W:4.726 / U:0.648 seconds]
    ©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site