summaryrefslogtreecommitdiffstats
path: root/examples/guestfs-testing.pod
diff options
context:
space:
mode:
authorRichard W.M. Jones <rjones@redhat.com>2011-11-22 13:18:32 +0000
committerRichard W.M. Jones <rjones@redhat.com>2011-11-22 14:44:54 +0000
commitde952fa9e8846aac11316d4bd39c069b15aec4ac (patch)
tree46d1712195b59d86058ab1037ce313ecf58c151b /examples/guestfs-testing.pod
parent7e1b479f7e7fccc79a34caaf8349d6e941b8344e (diff)
downloadlibguestfs-de952fa9e8846aac11316d4bd39c069b15aec4ac.tar.gz
libguestfs-de952fa9e8846aac11316d4bd39c069b15aec4ac.tar.xz
libguestfs-de952fa9e8846aac11316d4bd39c069b15aec4ac.zip
df, testing: Add notes on virt-df numbers (thanks Kashyap Chamarthy).
(cherry picked from commit 7b3137e664c3f4edf6ac7043a34c4166567e17bd)
Diffstat (limited to 'examples/guestfs-testing.pod')
-rw-r--r--examples/guestfs-testing.pod24
1 files changed, 23 insertions, 1 deletions
diff --git a/examples/guestfs-testing.pod b/examples/guestfs-testing.pod
index adf5b04d..c35c3b86 100644
--- a/examples/guestfs-testing.pod
+++ b/examples/guestfs-testing.pod
@@ -102,7 +102,29 @@ L<virt-df(1)> lists disk space. Run:
virt-df
-Do the results match what's reported inside the guests?
+You can try comparing this to the results from L<df(1)> inside the
+guest, but there are some provisos:
+
+=over 4
+
+=item *
+
+The guest must be idle.
+
+=item *
+
+The guest disks must be synched using L<sync(1)>.
+
+=item *
+
+Any action such as booting the guest will write log files causing the
+numbers to change.
+
+=back
+
+We don't guarantee that the numbers will be identical even under these
+circumstances. They should be similar. It would indicate a bug if
+you saw greatly differing numbers.
=head2 Try importing virt-df CSV output into a spreadsheet or database.