From nobody Sat Apr 27 07:35:32 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of redhat.com designates 209.132.183.37 as permitted sender) client-ip=209.132.183.37; envelope-from=libvir-list-bounces@redhat.com; helo=mx5-phx2.redhat.com; Authentication-Results: mx.zoho.com; spf=pass (zoho.com: domain of redhat.com designates 209.132.183.37 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; Return-Path: Received: from mx5-phx2.redhat.com (mx5-phx2.redhat.com [209.132.183.37]) by mx.zohomail.com with SMTPS id 1486677988043840.0517397347486; Thu, 9 Feb 2017 14:06:28 -0800 (PST) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by mx5-phx2.redhat.com (8.14.4/8.14.4) with ESMTP id v19M2xIo037299; Thu, 9 Feb 2017 17:02:59 -0500 Received: from int-mx10.intmail.prod.int.phx2.redhat.com (int-mx10.intmail.prod.int.phx2.redhat.com [10.5.11.23]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id v19M2wsc014048 for ; Thu, 9 Feb 2017 17:02:58 -0500 Received: from localhost.localdomain.com (ovpn-116-36.phx2.redhat.com [10.3.116.36]) by int-mx10.intmail.prod.int.phx2.redhat.com (8.14.4/8.14.4) with ESMTP id v19M2v6R026314 for ; Thu, 9 Feb 2017 17:02:57 -0500 From: John Ferlan To: libvir-list@redhat.com Date: Thu, 9 Feb 2017 17:02:50 -0500 Message-Id: <1486677770-14918-1-git-send-email-jferlan@redhat.com> X-Scanned-By: MIMEDefang 2.68 on 10.5.11.23 X-loop: libvir-list@redhat.com Subject: [libvirt] [PATCH] virsh: Alter formatting a bit for output of domstats fields X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-ZohoMail: RSF_0 Z_629925259 SPT_0 Content-Type: text/plain; charset="utf-8" Alter the formatting of each line to not give the appearance of one long run-on sentance and to be consistent between the various elements of collected/displayed data. The formatting should fit within the 80 character display. This removes the need for commas at the end of each line. Signed-off-by: John Ferlan --- tools/virsh.pod | 163 ++++++++++++++++++++++++++++++++--------------------= ---- 1 file changed, 93 insertions(+), 70 deletions(-) diff --git a/tools/virsh.pod b/tools/virsh.pod index a470409..c3cd6bb 100644 --- a/tools/virsh.pod +++ b/tools/virsh.pod @@ -885,67 +885,85 @@ Note that - depending on the hypervisor type and vers= ion or the domain state - not all of the following statistics may be returned. =20 When selecting the I<--state> group the following fields are returned: -"state.state" - state of the VM, returned as number from virDomainState en= um, -"state.reason" - reason for entering given state, returned as int from -virDomain*Reason enum corresponding to given state. + + "state.state" - state of the VM, returned as number from + virDomainState enum + "state.reason" - reason for entering given state, returned + as int from virDomain*Reason enum corresponding + to given state =20 I<--cpu-total> returns: -"cpu.time" - total cpu time spent for this domain in nanoseconds, -"cpu.user" - user cpu time spent in nanoseconds, -"cpu.system" - system cpu time spent in nanoseconds + + "cpu.time" - total cpu time spent for this domain in nanoseconds + "cpu.user" - user cpu time spent in nanoseconds + "cpu.system" - system cpu time spent in nanoseconds =20 I<--balloon> returns: -"balloon.current" - the memory in kiB currently used, -"balloon.maximum" - the maximum memory in kiB allowed, -"balloon.swap_in" - the amount of data read from swap space (in kB), -"balloon.swap_out" - the amount of memory written out to swap space (in kB= ), -"balloon.major_fault" - the number of page faults then disk IO was require= d, -"balloon.minor_fault" - the number of other page faults, -"balloon.unused" - the amount of memory left unused by the system (in kB), -"balloon.available" - the amount of usable memory as seen by the domain (i= n kB), -"balloon.rss" - Resident Set Size of running domain's process (in kB), -"balloon.usable" - the amount of memory which can be reclaimed by balloon -without causing host swapping (in KB), -"balloon.last-update" - timestamp of the last update of statistics (in sec= onds) + + "balloon.current" - the memory in kiB currently used + "balloon.maximum" - the maximum memory in kiB allowed + "balloon.swap_in" - the amount of data read from swap space (in kB) + "balloon.swap_out" - the amount of memory written out to swap + space (in kB) + "balloon.major_fault" - the number of page faults then disk IO + was required + "balloon.minor_fault" - the number of other page faults + "balloon.unused" - the amount of memory left unused by the + system (in kB) + "balloon.available" - the amount of usable memory as seen by + the domain (in kB) + "balloon.rss" - Resident Set Size of running domain's process + (in kB) + "balloon.usable" - the amount of memory which can be reclaimed by + balloon without causing host swapping (in KB) + "balloon.last-update" - timestamp of the last update of statistics + (in seconds) =20 I<--vcpu> returns: -"vcpu.current" - current number of online virtual CPUs, -"vcpu.maximum" - maximum number of online virtual CPUs, -"vcpu..state" - state of the virtual CPU , as number -from virVcpuState enum, -"vcpu..time" - virtual cpu time spent by virtual CPU - (in microseconds), -"vcpu..wait" - virtual cpu time spent by virtual CPU -waiting on I/O (in microseconds), -"vcpu..halted" - virtual CPU is halted: yes or no (may indicate -the processor is idle or even disabled, depending on the architecture) + + "vcpu.current" - current number of online virtual CPUs + "vcpu.maximum" - maximum number of online virtual CPUs + "vcpu..state" - state of the virtual CPU , as + number from virVcpuState enum + "vcpu..time" - virtual cpu time spent by virtual + CPU (in microseconds) + "vcpu..wait" - virtual cpu time spent by virtual + CPU waiting on I/O (in microseconds) + "vcpu..halted" - virtual CPU is halted: yes or + no (may indicate the processor is idle + or even disabled, depending on the + architecture) =20 I<--interface> returns: -"net.count" - number of network interfaces on this domain, -"net..name" - name of the interface , -"net..rx.bytes" - number of bytes received, -"net..rx.pkts" - number of packets received, -"net..rx.errs" - number of receive errors, -"net..rx.drop" - number of receive packets dropped, -"net..tx.bytes" - number of bytes transmitted, -"net..tx.pkts" - number of packets transmitted, -"net..tx.errs" - number of transmission errors, -"net..tx.drop" - number of transmit packets dropped + + "net.count" - number of network interfaces on this domain + "net..name" - name of the interface + "net..rx.bytes" - number of bytes received + "net..rx.pkts" - number of packets received + "net..rx.errs" - number of receive errors + "net..rx.drop" - number of receive packets dropped + "net..tx.bytes" - number of bytes transmitted + "net..tx.pkts" - number of packets transmitted + "net..tx.errs" - number of transmission errors + "net..tx.drop" - number of transmit packets dropped =20 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 count of cpu cycles (total/elapsed), -"perf.instructions" - the count of instructions, -"perf.cache_references" - the count of cache hits, -"perf.cache_misses" - the count of caches misses, -"perf.branch_instructions" - the count of branch instructions, -"perf.branch_misses" - the count of branch misses, -"perf.bus_cycles" - the count of bus cycles, -"perf.stalled_cycles_frontend" - the count of stalled frontend cpu cycles, -"perf.stalled_cycles_backend" - the count of stalled backend cpu cycles, -"perf.ref_cpu_cycles" - the count of ref cpu cycles + + "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 count of cpu cycles (total/elapsed) + "perf.instructions" - the count of instructions + "perf.cache_references" - the count of cache hits + "perf.cache_misses" - the count of caches misses + "perf.branch_instructions" - the count of branch instructions + "perf.branch_misses" - the count of branch misses + "perf.bus_cycles" - the count of bus cycles + "perf.stalled_cycles_frontend" - the count of stalled frontend + cpu cycles + "perf.stalled_cycles_backend" - the count of stalled backend + cpu cycles + "perf.ref_cpu_cycles" - the count of ref cpu cycles =20 See the B command for more details about each event. =20 @@ -954,25 +972,30 @@ domain. Using the I<--backing> flag extends this inf= ormation to cover all resources in the backing chain, rather than the default of limiting information to the active layer for each guest disk. Information listed includes: -"block.count" - number of block devices being listed, -"block..name" - name of the target of the block device (the -same name for multiple entries if I<--backing> is present), -"block..backingIndex" - when I<--backing> is present, matches up -with the index listed in domain XML for backing files, -"block..path" - file source of block device , if it is a -local file or block device, -"block..rd.reqs" - number of read requests, -"block..rd.bytes" - number of read bytes, -"block..rd.times" - total time (ns) spent on reads, -"block..wr.reqs" - number of write requests, -"block..wr.bytes" - number of written bytes, -"block..wr.times" - total time (ns) spent on writes, -"block..fl.reqs" - total flush requests, -"block..fl.times" - total time (ns) spent on cache flushing, -"block..errors" - Xen only: the 'oo_req' value, -"block..allocation" - offset of highest written sector in bytes, -"block..capacity" - logical size of source file in bytes, -"block..physical" - physical size of source file in bytes + + "block.count" - number of block devices being listed + "block..name" - name of the target of the block + device (the same name for + multiple entries if I<--backing> + is present) + "block..backingIndex" - when I<--backing> is present, + matches up with the + index listed in domain XML for + backing files + "block..path" - file source of block device , if + it is a local file or block device + "block..rd.reqs" - number of read requests + "block..rd.bytes" - number of read bytes + "block..rd.times" - total time (ns) spent on reads + "block..wr.reqs" - number of write requests + "block..wr.bytes" - number of written bytes + "block..wr.times" - total time (ns) spent on writes + "block..fl.reqs" - total flush requests + "block..fl.times" - total time (ns) spent on cache flushing + "block..errors" - Xen only: the 'oo_req' value + "block..allocation" - offset of highest written sector in bytes + "block..capacity" - logical size of source file in bytes + "block..physical" - physical size of source file in bytes =20 Selecting a specific statistics groups doesn't guarantee that the daemon supports the selected group of stats. Flag I<--enforce> --=20 2.7.4 -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list