Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 9a6d3166 authored by David Ahern's avatar David Ahern Committed by Arnaldo Carvalho de Melo
Browse files

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: default avatarDavid Ahern <dsahern@gmail.com>
Requested-by: default avatarXiao 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: default avatarArnaldo Carvalho de Melo <acme@redhat.com>
parent 70f7b4a7

tools/perf/Documentation/perf-kvm.txt

+44 −2
Original line number Diff line number Diff line
@@ -13,6 +13,7 @@ SYNOPSIS 
	{top|record|report|diff|buildid-list}

'perf kvm' [--host] [--guest] [--guestkallsyms=<path> --guestmodules=<path>

	| --guestvmlinux=<path>] {top|record|report|diff|buildid-list|stat}

'perf kvm stat [record|report|live] [<options>]



DESCRIPTION

-----------
@@ -50,6 +51,10 @@ There are a couple of variants of perf kvm: 
  'perf kvm stat report' reports statistical data which includes events

  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

-------

-i::
@@ -85,13 +90,50 @@ STAT REPORT OPTIONS 
--vcpu=<value>::

       analyze events which occures on this vcpu. (default: all vcpus)



--events=<value>::

       events to be analyzed. Possible values: vmexit, mmio, ioport.

--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).

-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

--------