Provided by: eventstat_0.03.01-1_i386 bug

NAME

       eventstat - a tool to measure system events.

SYNOPSIS

       eventstat [options] [delay [count]]

DESCRIPTION

       eventstat is a program that dumps the current active system events.

OPTIONS

       eventstat options are as follow:

       -b     just  report  events, PID and process name. By default the short
              task name from the kernel comm field will be displayed,  however
              the -s and -l options will report more process name information.

       -c     report cumulative events rather than events per sample period.

       -C     report  the sample event count in the CSV output rather than the
              default events per second rate.

       -d     strip full directory path  off  the  process  name  in  the  CSV
              output.

       -h     show help

       -k     report just kernel threads.

       -l     report  long  process  name from /proc/pid/cmdline. This reports
              the process name and all the command line arguments.

       -n event_count
              only display the first event_count number of top events.

       -q     run quietly, only really makes sense with -r option.

       -r csv_file
              output gathered data in a comma separated values file. This  can
              be  then  imported  and graphed using your favourite open source
              spread sheet.

       -s     report short process name from /proc/pid/cmdline.  This  reports
              just the process name.

       -S     report  the  minimum,  maximum,  average and population standard
              deviation at the end of the CSV output.

       -t threshold
              ignore samples where the event delta per second  less  than  the
              given threshold.

       -T     enable 'top' mode, refresh display on each update.

       -u     report just user space processes.

       -w     add timestamp (the "whence" info) to the output.

EXAMPLES

       Dump events every second until stopped.
               sudo eventstat

       Dump the top 20 events every 60 seconds until stopped.
               sudo eventstat -n 20 60

       Dump events every 10 seconds just 5 times.
               sudo eventstat 10 5

       Quietly  dump events every 10 seconds just 5 times into a CSV file with
       short process name.
               sudo eventstat 10 5 -q -s -r results.csv

CSV OUTPUT

       The -r option generates a comma  separated  file  report  that  can  be
       imported  into  spreadsheets  or  parsed  using  text processing tools.
       Column 1 of the data is the label  for  each  row,  columns  2  onwards
       contain the data for each task that generated a wakeup event.

       The  first row lists the task name of the thread or process. Task names
       in [ ] brackets are kernel threads, other tasks are the names  of  user
       space  processes.   By  default  these  names are derived from the task
       names from /proc/timer_stats but the -s -l options fetch more  complete
       task names from /proc/pid/cmdline instead.

       The  second  and third rows list the names of the internal Linux kernel
       timer init and callback functions, respectively.

       The fourth row lists the total number of wakeup events  for  each  task
       during the entire run of eventstat.

       The  subsequent  rows  list  the  average  number of wakeups per second
       measured during the  sample  interval  for  each  task  in  column  two
       onwards.  The first column indicates the sample time (in seconds) since
       the start of the measuring.

SEE ALSO

       powertop(8), top(1)

AUTHOR

       eventstat was written by Colin King <colin.king@canonical.com>

       This manual page was written by Colin King  <colin.king@canonical.com>,
       for the Ubuntu project (but may be used by others).

COPYRIGHT

       Copyright © 2011-2016 Canonical Ltd.
       This is free software; see the source for copying conditions.  There is
       NO warranty; not even for MERCHANTABILITY or FITNESS FOR  A  PARTICULAR
       PURPOSE.

                               February 11, 2016                  EVENTSTAT(8)