cachepc-linux

Fork of AMDESE/linux with modifications for CachePC side-channel attack
git clone https://git.sinitax.com/sinitax/cachepc-linux
Log | Files | Refs | README | LICENSE | sfeed.txt

kvm_stat.txt (2785B)

      1kvm_stat(1)
      2===========
      3
      4NAME
      5----
      6kvm_stat - Report KVM kernel module event counters
      7
      8SYNOPSIS
      9--------
     10[verse]
     11'kvm_stat' [OPTION]...
     12
     13DESCRIPTION
     14-----------
     15kvm_stat prints counts of KVM kernel module trace events.  These events signify
     16state transitions such as guest mode entry and exit.
     17
     18This tool is useful for observing guest behavior from the host perspective.
     19Often conclusions about performance or buggy behavior can be drawn from the
     20output.
     21While running in regular mode, use any of the keys listed in section
     22'Interactive Commands' below.
     23Use batch and logging modes for scripting purposes.
     24
     25The set of KVM kernel module trace events may be specific to the kernel version
     26or architecture.  It is best to check the KVM kernel module source code for the
     27meaning of events.
     28
     29INTERACTIVE COMMANDS
     30--------------------
     31[horizontal]
     32*b*::	toggle events by guests (debugfs only, honors filters)
     33
     34*c*::	clear filter
     35
     36*f*::	filter by regular expression
     37 ::     *Note*: Child events pull in their parents, and parents' stats summarize
     38                all child events, not just the filtered ones
     39
     40*g*::	filter by guest name/PID
     41
     42*h*::	display interactive commands reference
     43
     44*o*::   toggle sorting order (Total vs CurAvg/s)
     45
     46*p*::	filter by guest name/PID
     47
     48*q*::	quit
     49
     50*r*::	reset stats
     51
     52*s*::   set delay between refreshs
     53
     54*x*::	toggle reporting of stats for child trace events
     55 ::     *Note*: The stats for the parents summarize the respective child trace
     56                events
     57
     58Press any other key to refresh statistics immediately.
     59
     60OPTIONS
     61-------
     62-1::
     63--once::
     64--batch::
     65	run in batch mode for one second
     66
     67-c::
     68--csv::
     69        log in csv format. Requires option -l/--log or -L/--log-to-file.
     70        When used with option -L/--log-to-file, the header is only ever
     71        written to start of file to preserve the format.
     72
     73-d::
     74--debugfs::
     75	retrieve statistics from debugfs
     76
     77-f<fields>::
     78--fields=<fields>::
     79        fields to display (regex), "-f help" for a list of available events
     80
     81-g<guest>::
     82--guest=<guest_name>::
     83        limit statistics to one virtual machine (guest name)
     84
     85-h::
     86--help::
     87        show help message
     88
     89-i::
     90--debugfs-include-past::
     91	include all available data on past events for debugfs
     92
     93-l::
     94--log::
     95        run in logging mode (like vmstat)
     96
     97
     98-L<file>::
     99--log-to-file=<file>::
    100        like -l/--log, but logging to a file. Appends to existing files.
    101
    102-p<pid>::
    103--pid=<pid>::
    104	limit statistics to one virtual machine (pid)
    105
    106-s::
    107--set-delay::
    108        set delay between refreshs (value range: 0.1-25.5 secs)
    109
    110-t::
    111--tracepoints::
    112        retrieve statistics from tracepoints
    113
    114-z::
    115--skip-zero-records::
    116        omit records with all zeros in logging mode
    117
    118SEE ALSO
    119--------
    120'perf'(1), 'trace-cmd'(1)
    121
    122AUTHOR
    123------
    124Stefan Hajnoczi <stefanha@redhat.com>