perf kvm: Update documentation with live command
Update perf-kvm documentation with new live subcommand. Add -p/--pid option for perf-kvm-stat-report as well. Signed-off-by: David Ahern <dsahern@gmail.com> Requested-by: Xiao Guangrong <xiaoguangrong@linux.vnet.ibm.com> Cc: Frederic Weisbecker <fweisbec@gmail.com> Cc: Ingo Molnar <mingo@kernel.org> Cc: Jiri Olsa <jolsa@redhat.com> Cc: Namhyung Kim <namhyung@kernel.org> Cc: Peter Zijlstra <peterz@infradead.org> Cc: Runzhen Wang <runzhen@linux.vnet.ibm.com> Cc: Xiao Guangrong <xiaoguangrong@linux.vnet.ibm.com> Link: http://lkml.kernel.org/r/1375926999-75129-2-git-send-email-dsahern@gmail.com Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>
This commit is contained in:
parent
70f7b4a7f3
commit
9a6d316692
|
@ -13,6 +13,7 @@ SYNOPSIS
|
||||||
{top|record|report|diff|buildid-list}
|
{top|record|report|diff|buildid-list}
|
||||||
'perf kvm' [--host] [--guest] [--guestkallsyms=<path> --guestmodules=<path>
|
'perf kvm' [--host] [--guest] [--guestkallsyms=<path> --guestmodules=<path>
|
||||||
| --guestvmlinux=<path>] {top|record|report|diff|buildid-list|stat}
|
| --guestvmlinux=<path>] {top|record|report|diff|buildid-list|stat}
|
||||||
|
'perf kvm stat [record|report|live] [<options>]
|
||||||
|
|
||||||
DESCRIPTION
|
DESCRIPTION
|
||||||
-----------
|
-----------
|
||||||
|
@ -50,6 +51,10 @@ There are a couple of variants of perf kvm:
|
||||||
'perf kvm stat report' reports statistical data which includes events
|
'perf kvm stat report' reports statistical data which includes events
|
||||||
handled time, samples, and so on.
|
handled time, samples, and so on.
|
||||||
|
|
||||||
|
'perf kvm stat live' reports statistical data in a live mode (similar to
|
||||||
|
record + report but with statistical data updated live at a given display
|
||||||
|
rate).
|
||||||
|
|
||||||
OPTIONS
|
OPTIONS
|
||||||
-------
|
-------
|
||||||
-i::
|
-i::
|
||||||
|
@ -85,13 +90,50 @@ STAT REPORT OPTIONS
|
||||||
--vcpu=<value>::
|
--vcpu=<value>::
|
||||||
analyze events which occures on this vcpu. (default: all vcpus)
|
analyze events which occures on this vcpu. (default: all vcpus)
|
||||||
|
|
||||||
--events=<value>::
|
--event=<value>::
|
||||||
events to be analyzed. Possible values: vmexit, mmio, ioport.
|
event to be analyzed. Possible values: vmexit, mmio, ioport.
|
||||||
(default: vmexit)
|
(default: vmexit)
|
||||||
-k::
|
-k::
|
||||||
--key=<value>::
|
--key=<value>::
|
||||||
Sorting key. Possible values: sample (default, sort by samples
|
Sorting key. Possible values: sample (default, sort by samples
|
||||||
number), time (sort by average time).
|
number), time (sort by average time).
|
||||||
|
-p::
|
||||||
|
--pid=::
|
||||||
|
Analyze events only for given process ID(s) (comma separated list).
|
||||||
|
|
||||||
|
STAT LIVE OPTIONS
|
||||||
|
-----------------
|
||||||
|
-d::
|
||||||
|
--display::
|
||||||
|
Time in seconds between display updates
|
||||||
|
|
||||||
|
-m::
|
||||||
|
--mmap-pages=::
|
||||||
|
Number of mmap data pages. Must be a power of two.
|
||||||
|
|
||||||
|
-a::
|
||||||
|
--all-cpus::
|
||||||
|
System-wide collection from all CPUs.
|
||||||
|
|
||||||
|
-p::
|
||||||
|
--pid=::
|
||||||
|
Analyze events only for given process ID(s) (comma separated list).
|
||||||
|
|
||||||
|
--vcpu=<value>::
|
||||||
|
analyze events which occures on this vcpu. (default: all vcpus)
|
||||||
|
|
||||||
|
|
||||||
|
--event=<value>::
|
||||||
|
event to be analyzed. Possible values: vmexit, mmio, ioport.
|
||||||
|
(default: vmexit)
|
||||||
|
|
||||||
|
-k::
|
||||||
|
--key=<value>::
|
||||||
|
Sorting key. Possible values: sample (default, sort by samples
|
||||||
|
number), time (sort by average time).
|
||||||
|
|
||||||
|
--duration=<value>::
|
||||||
|
Show events other than HLT that take longer than duration usecs.
|
||||||
|
|
||||||
SEE ALSO
|
SEE ALSO
|
||||||
--------
|
--------
|
||||||
|
|
Loading…
Reference in New Issue