• Namhyung Kim's avatar
    perf tools: Improve call graph documents and help messages · 76a26549
    Namhyung Kim authored
    The --call-graph option is complex so we should provide better guide for
    users.  Also change help message to be consistent with config option
    names.  Now perf top will show help like below:
    
      $ perf top --call-graph
        Error: option `call-graph' requires a value
    
       Usage: perf top [<options>]
    
          --call-graph <record_mode[,record_size],print_type,threshold[,print_limit],order,sort_key[,branch]>
               setup and enables call-graph (stack chain/backtrace):
    
    		record_mode:	call graph recording mode (fp|dwarf|lbr)
    		record_size:	if record_mode is 'dwarf', max size of stack recording (<bytes>)
    				default: 8192 (bytes)
    		print_type:	call graph printing style (graph|flat|fractal|none)
    		threshold:	minimum call graph inclusion threshold (<percent>)
    		print_limit:	maximum number of call graph entry (<number>)
    		order:		call graph order (caller|callee)
    		sort_key:	call graph sort key (function|address)
    		branch:		include last branch info to call graph (branch)
    
    		Default: fp,graph,0.5,caller,function
    Requested-by: default avatarIngo Molnar <mingo@kernel.org>
    Signed-off-by: default avatarNamhyung Kim <namhyung@kernel.org>
    Acked-by: default avatarFrederic Weisbecker <fweisbec@gmail.com>
    Cc: Adrian Hunter <adrian.hunter@intel.com>
    Cc: Borislav Petkov <bp@suse.de>
    Cc: Brendan Gregg <brendan.d.gregg@gmail.com>
    Cc: Chandler Carruth <chandlerc@gmail.com>
    Cc: David Ahern <dsahern@gmail.com>
    Cc: Jiri Olsa <jolsa@redhat.com>
    Cc: Peter Zijlstra <a.p.zijlstra@chello.nl>
    Cc: Stephane Eranian <eranian@google.com>
    Cc: Wang Nan <wangnan0@huawei.com>
    Link: http://lkml.kernel.org/r/1445524112-5201-2-git-send-email-namhyung@kernel.orgSigned-off-by: default avatarArnaldo Carvalho de Melo <acme@redhat.com>
    76a26549
builtin-top.c 34.3 KB