lkml.org 
[lkml]   [2012]   [Jan]   [31]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    Patch in this message
    /
    Date
    From
    Subject[tip:perf/core] perf lock: Document lock info subcommand
    Commit-ID:  d1eec3ecaef083affaf3210246b01b6e80d3a44e
    Gitweb: http://git.kernel.org/tip/d1eec3ecaef083affaf3210246b01b6e80d3a44e
    Author: Namhyung Kim <namhyung@gmail.com>
    AuthorDate: Sun, 29 Jan 2012 17:55:56 +0900
    Committer: Arnaldo Carvalho de Melo <acme@redhat.com>
    CommitDate: Mon, 30 Jan 2012 18:30:48 -0200

    perf lock: Document lock info subcommand

    The commit 26242d859c9be ("perf lock: Add "info" subcommand for dumping
    misc information") added the subcommand but missed documentation. Add
    it. Also update stale 'trace' subcommand to 'script'.

    Cc: Hitoshi Mitake <mitake@dcl.info.waseda.ac.jp>
    Cc: Ingo Molnar <mingo@elte.hu>
    Cc: Paul Mackerras <paulus@samba.org>
    Cc: Peter Zijlstra <a.p.zijlstra@chello.nl>
    Link: http://lkml.kernel.org/r/1327827356-8786-5-git-send-email-namhyung@gmail.com
    Signed-off-by: Namhyung Kim <namhyung@gmail.com>
    Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>
    ---
    tools/perf/Documentation/perf-lock.txt | 20 +++++++++++++++++---
    tools/perf/builtin-lock.c | 4 ++--
    2 files changed, 19 insertions(+), 5 deletions(-)

    diff --git a/tools/perf/Documentation/perf-lock.txt b/tools/perf/Documentation/perf-lock.txt
    index d6b2a4f..c7f5f55 100644
    --- a/tools/perf/Documentation/perf-lock.txt
    +++ b/tools/perf/Documentation/perf-lock.txt
    @@ -8,7 +8,7 @@ perf-lock - Analyze lock events
    SYNOPSIS
    --------
    [verse]
    -'perf lock' {record|report|trace}
    +'perf lock' {record|report|script|info}

    DESCRIPTION
    -----------
    @@ -20,10 +20,13 @@ and statistics with this 'perf lock' command.
    produces the file "perf.data" which contains tracing
    results of lock events.

    - 'perf lock trace' shows raw lock events.
    -
    'perf lock report' reports statistical data.

    + 'perf lock script' shows raw lock events.
    +
    + 'perf lock info' shows metadata like threads or addresses
    + of lock instances.
    +
    COMMON OPTIONS
    --------------

    @@ -47,6 +50,17 @@ REPORT OPTIONS
    Sorting key. Possible values: acquired (default), contended,
    wait_total, wait_max, wait_min.

    +INFO OPTIONS
    +------------
    +
    +-t::
    +--threads::
    + dump thread list in perf.data
    +
    +-m::
    +--map::
    + dump map of lock instances (address:name table)
    +
    SEE ALSO
    --------
    linkperf:perf[1]
    diff --git a/tools/perf/builtin-lock.c b/tools/perf/builtin-lock.c
    index 2296c39..12c8148 100644
    --- a/tools/perf/builtin-lock.c
    +++ b/tools/perf/builtin-lock.c
    @@ -922,12 +922,12 @@ static const struct option info_options[] = {
    OPT_BOOLEAN('t', "threads", &info_threads,
    "dump thread list in perf.data"),
    OPT_BOOLEAN('m', "map", &info_map,
    - "map of lock instances (name:address table)"),
    + "map of lock instances (address:name table)"),
    OPT_END()
    };

    static const char * const lock_usage[] = {
    - "perf lock [<options>] {record|trace|report}",
    + "perf lock [<options>] {record|report|script|info}",
    NULL
    };


    \
     
     \ /
      Last update: 2012-01-31 14:25    [W:3.117 / U:0.212 seconds]
    ©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site