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