lkml.org 
[lkml]   [2013]   [Dec]   [1]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    Patch in this message
    /
    From
    Subject[PATCH 2/2] perf sched: Add documentation for timehist options
    Date
    Add entry to perf-sched documentation for timehist command and its
    options.

    v2: Addressed comments by Namhyung

    Signed-off-by: David Ahern <dsahern@gmail.com>
    Cc: Ingo Molnar <mingo@kernel.org>
    Cc: Frederic Weisbecker <fweisbec@gmail.com>
    Cc: Peter Zijlstra <a.p.zijlstra@chello.nl>
    Cc: Mike Galbraith <efault@gmx.de>
    Cc: Jiri Olsa <jolsa@redhat.com>
    Cc: Namhyung Kim <namhyung@kernel.org>
    Cc: Stephane Eranian <eranian@google.com>
    Cc: Pekka Enberg <penberg@kernel.org>
    ---
    tools/perf/Documentation/perf-sched.txt | 61 ++++++++++++++++++++++++++++++++-
    1 file changed, 60 insertions(+), 1 deletion(-)

    diff --git a/tools/perf/Documentation/perf-sched.txt b/tools/perf/Documentation/perf-sched.txt
    index 8ff4df956951..e7bb19fcdbff 100644
    --- a/tools/perf/Documentation/perf-sched.txt
    +++ b/tools/perf/Documentation/perf-sched.txt
    @@ -8,7 +8,7 @@ perf-sched - Tool to trace/measure scheduler properties (latencies)
    SYNOPSIS
    --------
    [verse]
    -'perf sched' {record|latency|map|replay|script}
    +'perf sched' {record|latency|map|replay|script|timehist}

    DESCRIPTION
    -----------
    @@ -36,6 +36,11 @@ There are five variants of perf sched:
    are running on a CPU. A '*' denotes the CPU that had the event, and
    a dot signals an idle CPU.

    + 'perf sched timehist' to show context-switching analysis with times
    + between schedule-in, schedule delay, and run time. If callchains are
    + present stack trace is dumped at the end of the line. A summary of
    + run times can be shown as well.
    +
    OPTIONS
    -------
    -i::
    @@ -50,6 +55,60 @@ OPTIONS
    --dump-raw-trace=::
    Display verbose dump of the sched data.

    +TIMEHIST OPTIONS
    +----------------
    +-k::
    +--vmlinux=<file>::
    + vmlinux pathname
    +
    +--kallsyms=<file>::
    + kallsyms pathname
    +
    +-s::
    +--summary::
    + Show only a summary of scheduling by thread with min, max, and average
    + run times (in sec) and relative stddev.
    +
    +-S::
    +--with-summary::
    + Show all scheduling events followed by a summary by thread with min,
    + max, and average run times (in sec) and relative stddev.
    +
    +-w::
    +--wakeups::
    + Show wakeup events.
    +
    +-c::
    +--comms=::
    + Only show events for given comms (comma separated list)
    +
    +-p::
    +--pid=::
    + Only show events for given process ID (comma separated list).
    +
    +-t::
    +--tid=::
    + Only show events for given thread ID (comma separated list).
    +
    +--call-graph::
    + Display call chains. Default is on. Use --no-call-graph to suppress
    +
    +--max-stack::
    + Set the stack depth limit when showing the callchains. Default: 127
    +
    +-x::
    +--exclude-sym::
    + Symbols to skip in backtrace. Useful to compact repetitive or
    + uninteresting frames to pull more useful frames into view.
    +
    +--symfs=<directory>::
    + Look for files with symbols relative to this directory.
    +
    +-V::
    +--cpu-visual::
    + Add a visual that better emphasizes activity by cpu. Idle times
    + are denoted with 'i'; schedule events with an 's'.
    +
    SEE ALSO
    --------
    linkperf:perf-record[1]
    --
    1.8.3.4 (Apple Git-47)


    \
     
     \ /
      Last update: 2013-12-02 01:41    [W:3.829 / U:0.772 seconds]
    ©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site