X-Git-Url: https://git.lttng.org/?p=lttngtop.git;a=blobdiff_plain;f=README;h=0a64510ee3c98f06cc0cea67195fe58759ec34a8;hp=b2fed8845367c8274f66224046eeee31e4d693da;hb=a7132ddbe9a85b93ede6c4bec99b525f6da569fe;hpb=bc02a7aa917596e98027f6b44f9e3f145e369161 diff --git a/README b/README index b2fed88..0a64510 100644 --- a/README +++ b/README @@ -1,41 +1,18 @@ LTTngTop -Julien Desfossez -August 2011 +Julien Desfossez +April 2012 Lttngtop is an ncurses interface for reading and browsing traces recorded by the LTTng tracer and displaying various statistics. -As of now, the cpu usage and perf counters are displayed. This version currently -only supports offline traces, but a live version is in alpha and will be -available for testing soon. +As of now, the cpu usage, per file/process I/O bandwidth and perf counters are +displayed. This version currently only supports offline traces, but a live +version is in alpha and will be available for testing soon. USAGE ----- -Record a trace with LTTng 2.0 with at least the sched_switch event, and the pid, -procname, tid, ppid contexts. To have the perftop view working you can enable -any number of perf contexts (depending on your hardware). -For the iotop view, you need to have some syscall events : sys_read, sys_write -and exit_syscall. - -Once your trace is recorded, you can use lttngtop this way : -$ lttngtop /path/to/your/trace - -Make sure you have read permissions on the whole directory. - -EXAMPLE -------- -# Get root (or ideally just launch lttng-sessiond as root) -lttng create lttngtop -lttng enable-event -k sched_switch -lttng add-context -k -t pid -t procname -t tid -t ppid -t perf:cache-misses \ - -t perf:major-faults -t perf:branch-load-misses -lttng start -#...do stuff... -lttng stop -lttng destroy - -# Run lttngtop -lttngtop $HOME/lttng-traces/lttngtop-... +The manpage located in the doc folder of this source tree documents the usage +of LTTngTop. BUILDING -------- @@ -74,8 +51,6 @@ compile the git repository tree : (make sure your system wide "automake" points to a recent version!) - GNU Libtool >=2.2 (for more information, go to http://www.gnu.org/software/autoconf/) -- Flex >=2.5.35. -- Bison >=2.4. If you get the tree from the repository, you will need to use the "bootstrap" script in the root of the tree. It calls all the GNU tools needed to prepare the