External/libvirt
1
0
Fork 0
mirror of https://gitlab.com/libvirt/libvirt.git synced 2024-07-30 13:37:17 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: Alter descriptions of perf cpu_cycles

Browse Source 
https://bugzilla.redhat.com/show_bug.cgi?id=1381714

Alter the descriptions to match what the cpu_cycles actually is
This commit is contained in:
John Ferlan 2016-10-07 07:55:51 -04:00
parent 5dee668632
commit 12629888fc
5 changed files with 10 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
docs/formatdomain.html.in
View File

@ -1954,7 +1954,7 @@
</tr> </tr>
<tr> <tr>
<td><code>cpu_cycles</code></td> <td><code>cpu_cycles</code></td>
<td>the number of cpu cycles one instruction needs</td> <td>the count of cpu cycles (total/elapsed)</td>
<td><code>perf.cpu_cycles</code></td> <td><code>perf.cpu_cycles</code></td>
</tr> </tr>
<tr> <tr>

3
include/libvirt/libvirt-domain.h
View File

@ -2008,7 +2008,8 @@ void virDomainStatsRecordListFree(virDomainStatsRecordPtr *stats);
* VIR_PERF_PARAM_CPU_CYCLES: * VIR_PERF_PARAM_CPU_CYCLES:
* *
* Macro for typed parameter name that represents cpu_cycles perf event * Macro for typed parameter name that represents cpu_cycles perf event
* which can be used to measure how many cpu cycles one instruction needs. * describing the total/elapsed cpu cycles. This can be used to measure
* how many cpu cycles one instruction needs.
* It corresponds to the "perf.cpu_cycles" field in the *Stats APIs. * It corresponds to the "perf.cpu_cycles" field in the *Stats APIs.
*/ */
# define VIR_PERF_PARAM_CPU_CYCLES "cpu_cycles" # define VIR_PERF_PARAM_CPU_CYCLES "cpu_cycles"

2
src/libvirt-domain.c
View File

@ -11482,7 +11482,7 @@ virConnectGetDomainCapabilities(virConnectPtr conn,
* It is produced by cache_references perf event. * It is produced by cache_references perf event.
* "perf.instructions" - The count of instructions as unsigned long long. * "perf.instructions" - The count of instructions as unsigned long long.
* It is produced by instructions perf event. * It is produced by instructions perf event.
* "perf.cpu_cycles" - The number of cpu cycles one instruction needs as * "perf.cpu_cycles" - The count of cpu cycles (total/elapsed) as an
* unsigned long long. It is produced by cpu_cycles * unsigned long long. It is produced by cpu_cycles
* perf event. * perf event.
* *

2
src/util/virperf.h
View File

@ -32,7 +32,7 @@ typedef enum {
VIR_PERF_EVENT_MBMT, /* Memory Bandwidth Monitoring Total */ VIR_PERF_EVENT_MBMT, /* Memory Bandwidth Monitoring Total */
VIR_PERF_EVENT_MBML, /* Memory Bandwidth Monitor Limit for controller */ VIR_PERF_EVENT_MBML, /* Memory Bandwidth Monitor Limit for controller */
VIR_PERF_EVENT_CPU_CYCLES, /* CPU Cycles per instruction */ VIR_PERF_EVENT_CPU_CYCLES, /* Count of CPU Cycles (total/elapsed) */
VIR_PERF_EVENT_INSTRUCTIONS, /* Count of instructions for application */ VIR_PERF_EVENT_INSTRUCTIONS, /* Count of instructions for application */
VIR_PERF_EVENT_CACHE_REFERENCES, /* Cache hits by applications */ VIR_PERF_EVENT_CACHE_REFERENCES, /* Cache hits by applications */
VIR_PERF_EVENT_CACHE_MISSES, /* Cache misses by applications */ VIR_PERF_EVENT_CACHE_MISSES, /* Cache misses by applications */

9
tools/virsh.pod
View File

@ -934,7 +934,7 @@ I<--perf> returns the statistics of all enabled perf events:
"perf.cmt" - the cache usage in Byte currently used "perf.cmt" - the cache usage in Byte currently used
"perf.mbmt" - total system bandwidth from one level of cache "perf.mbmt" - total system bandwidth from one level of cache
"perf.mbml" - bandwidth of memory traffic for a memory controller "perf.mbml" - bandwidth of memory traffic for a memory controller
"perf.cpu_cycles" - the number of cpu cycles one instruction needs "perf.cpu_cycles" - the count of cpu cycles (total/elapsed)
"perf.instructions" - the count of instructions "perf.instructions" - the count of instructions
"perf.cache_references" - the count of cache hits "perf.cache_references" - the count of cache hits
"perf.cache_misses" - the count of caches misses "perf.cache_misses" - the count of caches misses
@ -2247,9 +2247,10 @@ B<Valid perf event names>
applications running on th e platform. applications running on th e platform.
instructions - Provides the count of instructions executed instructions - Provides the count of instructions executed
by applications running on the platform. by applications running on the platform.
cpu_cycles - Provides the number of cpu_cycles for one cpu_cycles - Provides the count of cpu cycles
instruction. May be used with instructions (total/elapsed). May be used with
in order to get a cycles per instruction. instructions in order to get a cycles
per instruction.
B<Note>: The statistics can be retrieved using the B<domstats> command using B<Note>: The statistics can be retrieved using the B<domstats> command using
the I<--perf> flag. the I<--perf> flag.