|
 |
9119d9 |
From bf30179785785e77271500eadd6e425fa11978a5 Mon Sep 17 00:00:00 2001
|
|
|
9119d9 |
Message-Id: <bf30179785785e77271500eadd6e425fa11978a5@dist-git>
|
|
|
9119d9 |
From: Eric Blake <eblake@redhat.com>
|
|
|
9119d9 |
Date: Wed, 17 Dec 2014 03:08:58 -0700
|
|
|
9119d9 |
Subject: [PATCH] virsh: document block.n.allocation stat
|
|
|
9119d9 |
|
|
|
9119d9 |
https://bugzilla.redhat.com/show_bug.cgi?id=1041569
|
|
|
9119d9 |
|
|
|
9119d9 |
Commit 7557ddf added some additional block.* stats to
|
|
|
9119d9 |
virDomainListGetStats, but failed to document them in 'man
|
|
|
9119d9 |
virsh'. Also, I noticed some inconsistent use of commas.
|
|
|
9119d9 |
|
|
|
9119d9 |
* tools/virsh.pod (domstats): Tweak commas, add missing stats.
|
|
|
9119d9 |
|
|
|
9119d9 |
Signed-off-by: Eric Blake <eblake@redhat.com>
|
|
|
9119d9 |
(cherry picked from commit 7296e896c92c64ec5653095bcc2ed86b6a72a7d5)
|
|
|
9119d9 |
Signed-off-by: Jiri Denemark <jdenemar@redhat.com>
|
|
|
9119d9 |
---
|
|
|
9119d9 |
tools/virsh.pod | 9 ++++++---
|
|
|
9119d9 |
1 file changed, 6 insertions(+), 3 deletions(-)
|
|
|
9119d9 |
|
|
|
9119d9 |
diff --git a/tools/virsh.pod b/tools/virsh.pod
|
|
|
9119d9 |
index c88c417..d88fa9f 100644
|
|
|
9119d9 |
--- a/tools/virsh.pod
|
|
|
9119d9 |
+++ b/tools/virsh.pod
|
|
|
9119d9 |
@@ -837,7 +837,7 @@ I<--vcpu>, I<--interface>, I<--block>.
|
|
|
9119d9 |
|
|
|
9119d9 |
When selecting the I<--state> group the following fields are returned:
|
|
|
9119d9 |
"state.state" - state of the VM, returned as number from virDomainState enum,
|
|
|
9119d9 |
-"state.reason" - reason for entering given state, returned as int from,
|
|
|
9119d9 |
+"state.reason" - reason for entering given state, returned as int from
|
|
|
9119d9 |
virDomain*Reason enum corresponding to given state.
|
|
|
9119d9 |
|
|
|
9119d9 |
I<--cpu-total> returns:
|
|
|
9119d9 |
@@ -866,9 +866,9 @@ I<--interface> returns:
|
|
|
9119d9 |
"net.<num>.tx.bytes" - number of bytes transmitted,
|
|
|
9119d9 |
"net.<num>.tx.pkts" - number of packets transmitted,
|
|
|
9119d9 |
"net.<num>.tx.errs" - number of transmission errors,
|
|
|
9119d9 |
-"net.<num>.tx.drop" - number of transmit packets dropped,
|
|
|
9119d9 |
+"net.<num>.tx.drop" - number of transmit packets dropped
|
|
|
9119d9 |
|
|
|
9119d9 |
-I<block> returns:
|
|
|
9119d9 |
+I<--block> returns:
|
|
|
9119d9 |
"block.count" - number of block devices on this domain,
|
|
|
9119d9 |
"block.<num>.name" - name of the target of the block device <num>,
|
|
|
9119d9 |
"block.<num>.rd.reqs" - number of read requests,
|
|
|
9119d9 |
@@ -880,6 +880,9 @@ I<block> returns:
|
|
|
9119d9 |
"block.<num>.fl.reqs" - total flush requests,
|
|
|
9119d9 |
"block.<num>.fl.times" - total time (ns) spent on cache flushing,
|
|
|
9119d9 |
"block.<num>.errors" - Xen only: the 'oo_req' value,
|
|
|
9119d9 |
+"block.<num>.allocation" - offset of highest written sector in bytes,
|
|
|
9119d9 |
+"block.<num>.capacity" - logical size of source file in bytes,
|
|
|
9119d9 |
+"block.<num>.physical" - physical size of source file in bytes
|
|
|
9119d9 |
|
|
|
9119d9 |
Selecting a specific statistics groups doesn't guarantee that the
|
|
|
9119d9 |
daemon supports the selected group of stats. Flag I<--enforce>
|
|
|
9119d9 |
--
|
|
|
9119d9 |
2.2.0
|
|
|
9119d9 |
|