[Qemu-devel] [PATCH] Documentation for kvm_stat.

[Bo Yang]

Signed-off-by: Bo Yang <address@hidden>
---
 Makefile      |    9 ++++++++-
 kvm_stat.texi |   55 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 63 insertions(+), 1 deletions(-)
 create mode 100644 kvm_stat.texi

diff --git a/Makefile b/Makefile
index 1cd5bc8..ee524b0 100644
--- a/Makefile
+++ b/Makefile
@@ -40,7 +40,7 @@ LIBS+=-lz $(LIBS_TOOLS)
 HELPERS-$(CONFIG_LINUX) = qemu-bridge-helper$(EXESUF)
 
 ifdef BUILD_DOCS
-DOCS=qemu-doc.html qemu-tech.html qemu.1 qemu-img.1 qemu-nbd.8 
QMP/qmp-commands.txt
+DOCS=qemu-doc.html qemu-tech.html qemu.1 qemu-img.1 qemu-nbd.8 kvm_stat.1 
QMP/qmp-commands.txt
 ifdef CONFIG_VIRTFS
 DOCS+=fsdev/virtfs-proxy-helper.1
 endif
@@ -283,6 +283,7 @@ ifdef CONFIG_POSIX
        $(INSTALL_DATA) qemu.1 qemu-img.1 "$(DESTDIR)$(mandir)/man1"
        $(INSTALL_DIR) "$(DESTDIR)$(mandir)/man8"
        $(INSTALL_DATA) qemu-nbd.8 "$(DESTDIR)$(mandir)/man8"
+       $(INSTALL_DATA) kvm_stat.1 "$(DESTDIR)$(mandir)/man1"
 endif
 ifdef CONFIG_VIRTFS
        $(INSTALL_DIR) "$(DESTDIR)$(mandir)/man1"
@@ -387,6 +388,12 @@ qemu-nbd.8: qemu-nbd.texi
          $(POD2MAN) --section=8 --center=" " --release=" " qemu-nbd.pod > $@, \
          "  GEN   $@")
 
+kvm_stat.1: kvm_stat.texi
+       $(call quiet-command, \
+         perl -Ww -- $(SRC_PATH)/scripts/texi2pod.pl $< kvm_stat.pod && \
+         $(POD2MAN) --section=1 --center=" " --release=" " kvm_stat.pod > $@, \
+         "  GEN   $@")
+
 dvi: qemu-doc.dvi qemu-tech.dvi
 html: qemu-doc.html qemu-tech.html
 info: qemu-doc.info qemu-tech.info
diff --git a/kvm_stat.texi b/kvm_stat.texi
new file mode 100644
index 0000000..ff7d414
--- /dev/null
+++ b/kvm_stat.texi
@@ -0,0 +1,55 @@
address@hidden
address@hidden man begin SYNOPSIS
+
+usage: kvm_stat [OPTIONS]
+
address@hidden man end
address@hidden example
+
address@hidden man begin DESCRIPTION
+
+This is a utility to watch kvm statistics.
+
address@hidden man end
address@hidden man begin OPTIONS
+
address@hidden @option
+
address@hidden -h, --help
+
+Show help message.
+
address@hidden -1, --once, --batch
+
+Run in batch mode for one second.
+
address@hidden -l, --log
+
+Run in logging mode (like vmstat).
+
address@hidden -f @var{FIELDS}, address@hidden
+
+Fields to display (regex). regex expression can be accepted here. Fields 
include:
address@hidden, @samp{config}, @samp{sample_freq}, @samp{sample_type}, 
@samp{read_format}, @samp{flags}, @samp{wakeup_events}, @samp{bp_type}, 
@samp{bp_addr}, @samp{bp_len}
+
address@hidden table
address@hidden man end
+
address@hidden
+
address@hidden kvm_stat
address@hidden kvm statistics utility
+
address@hidden man begin SEE ALSO
+
+vmstat
+
address@hidden man end
+
address@hidden man begin AUTHOR
+
+Copyright (C) 2012 Bo Yang <address@hidden>.
+This is free software; see the source for copying conditions.  There is NO
+warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
address@hidden man end
address@hidden ignore
-- 
1.6.0.2