qemu/scripts/kvm/kvm_stat.texi

   1 @example
   2 @c man begin SYNOPSIS
   3 usage: kvm_stat [OPTION]...
   4 @c man end
   5 @end example
   6
   7 @c man begin DESCRIPTION
   8
   9 kvm_stat prints counts of KVM kernel module trace events.  These events signify
  10 state transitions such as guest mode entry and exit.
  11
  12 This tool is useful for observing guest behavior from the host perspective.
  13 Often conclusions about performance or buggy behavior can be drawn from the
  14 output.
  15
  16 The set of KVM kernel module trace events may be specific to the kernel version
  17 or architecture.  It is best to check the KVM kernel module source code for the
  18 meaning of events.
  19
  20 Note that trace events are counted globally across all running guests.
  21
  22 @c man end
  23
  24 @c man begin OPTIONS
  25 @table @option
  26 @item -1, --once, --batch
  27   run in batch mode for one second
  28 @item -l, --log
  29   run in logging mode (like vmstat)
  30 @item -t, --tracepoints
  31   retrieve statistics from tracepoints
  32 @item -d, --debugfs
  33   retrieve statistics from debugfs
  34 @item -f, --fields=@var{fields}
  35   fields to display (regex)
  36 @item -h, --help
  37   show help message
  38 @end table
  39
  40 @c man end
  41
  42 @ignore
  43
  44 @setfilename kvm_stat
  45 @settitle Report KVM kernel module event counters.
  46
  47 @c man begin AUTHOR
  48 Stefan Hajnoczi <stefanha@redhat.com>
  49 @c man end
  50
  51 @c man begin SEEALSO
  52 perf(1), trace-cmd(1)
  53 @c man end
  54
  55 @end ignore