[libvirt] [PATCH v4 4/4] perf: add description for new events in virsh.pod

[John Ferlan]

On 07/16/2016 04:15 AM, Qiaowei Ren wrote:
> This patch add 'domstats --perf' description for new events in
> virsh.pod.
> 
> Signed-off-by: Qiaowei Ren <qiaowei.ren at intel.com>
> ---
>  tools/virsh.pod | 4 ++++
>  1 file changed, 4 insertions(+)
> 

This would need to be merged with the previous patch since that's where
the fields are introduced.


> diff --git a/tools/virsh.pod b/tools/virsh.pod
> index d7cd10e..da7f24f 100644
> --- a/tools/virsh.pod
> +++ b/tools/virsh.pod
> @@ -909,6 +909,10 @@ I<--perf> returns the statistics of all enabled perf events:
>  "perf.cmt" - the cache usage in Byte currently used
>  "perf.mbmt" - total system bandwidth from one level of cache
>  "perf.mbml" - bandwidth of memory traffic for a memory controller
> +"perf.cpu_cycles" - the number of cpu cycles one instruction needs
> +"perf.instructions" - the count of instructions
> +"perf.cache_references" - the count of cache hits
> +"perf.cache_misses" - the count of caches misses
>  

As previously stated - it'd be nice to add a reference to the "perf"
section from the domstats --perf section, e.g.:

See the B<perf> command for more details about each event.


>  I<--block> returns information about disks associated with each
>  domain.  Using the I<--backing> flag extends this information to
> 


The update to the perf section is missing...  You'll see my adjustments
shortly - just cleaning up the patches a bit...

John