X-Git-Url: http://git.annexia.org/?p=virt-top.git;a=blobdiff_plain;f=virt-top%2Fvirt-top.txt;h=de0681e2b3c1be2fe181f44e532e4f5388e7f497;hp=c7209392d0a14ec07cf36f73cb176da534e45caa;hb=4e1409917c38f8bf57838f5119f58edbcad41937;hpb=1998014dafda52019e5151dc6c4c75b3b5dad7aa

diff --git a/virt-top/virt-top.txt b/virt-top/virt-top.txt
index c720939..de0681e 100644
--- a/virt-top/virt-top.txt
+++ b/virt-top/virt-top.txt
@@ -50,7 +50,7 @@ OPTIONS
 
     -o sort
         Set the sort order to one of: cpu (sort by %CPU used), mem (sort by
-        memory used), time (sort by total time), id (sort by domain ID),
+        total memory), time (sort by total time), id (sort by domain ID),
         name (sort by domain name), netrx (sort by network received bytes),
         nettx (sort by network transmitted bytes), blockrdrq (sort by block
         device [disk] read requests), blockwrrq (sort by block device [disk]
@@ -152,6 +152,9 @@ OPTIONS
     --help
         Display usage summary.
 
+    --version
+        Display version number and exit.
+
 KEYS
     Note that keys are case sensitive. For example use upper-case *P* (shift
     P) to sort by %CPU. *^* before a key means a Ctrl key, so *^L* is Ctrl
@@ -182,7 +185,8 @@ KEYS
 
     *P* Sort by %CPU.
 
-    *M* Sort by memory.
+    *M* Sort by total memory. Note that this shows the total memory
+        allocated to the guest, not the memory being used.
 
     *T* Sort by total time.
 
@@ -265,15 +269,30 @@ INIT FILE
     file override options specified on the command line. This is a bug and
     this behaviour may change in the future.
 
+NOTES
+  NETWORK RX BYTES AND PACKETS
+    Libvirt/virt-top has no way to know that a packet transmitted to a guest
+    was received (eg. if the guest is not listening). In the network RX
+    stats, virt-top reports the packets transmitted to the guest, on the
+    basis that the guest might receive them.
+
+    In particular this includes broadcast packets. Because of the way that
+    Linux bridges work, if the guest is connected to a bridge, it will
+    probably see a steady "background noise" of RX packets even when the
+    network interface is idle or down. These are caused by STP packets
+    generated by the bridge.
+
 SEE ALSO
-    top(1), virsh(1), xm(1), xentop(1), <http://www.libvirt.org/>,
-    <http://et.redhat.com/~rjones/>, <http://caml.inria.fr/>
+    top(1), virsh(1), <http://www.libvirt.org/ocaml/>,
+    <http://www.libvirt.org/>, <http://people.redhat.com/~rjones/>,
+    <http://caml.inria.fr/>
 
 AUTHORS
     Richard W.M. Jones <rjones @ redhat . com>
 
 COPYRIGHT
-    (C) Copyright 2007 Red Hat Inc., Richard W.M. Jones http://libvirt.org/
+    (C) Copyright 2007-2011 Red Hat Inc., Richard W.M. Jones
+    http://libvirt.org/
 
     This program is free software; you can redistribute it and/or modify it
     under the terms of the GNU General Public License as published by the
@@ -309,9 +328,12 @@ REPORTING BUGS
         submit with your bug report.
 
     3. Get version of virt-top and version of libvirt.
-        In virt-top, press the *h* (help) key, and write down the version of
-        virt-top and the version of libvirt. They are shown in the first
-        line.
+        Use:
+
+         virt-top --version
+
+        If you can get the precise version of libvirt you are using then
+        that too is helpful.
 
     4. Submit a bug report.
         Go to <https://bugzilla.redhat.com/> and enter a new bug. Please