Manpage and updated doc
authorJulien Desfossez <>
Wed, 18 Apr 2012 18:45:14 +0000 (14:45 -0400)
committerJulien Desfossez <>
Wed, 18 Apr 2012 18:45:14 +0000 (14:45 -0400)
Signed-off-by: Julien Desfossez <>
doc/lttngtop.1 [new file with mode: 0644]

index 733b0cdc983918a7d0c9421bb44003c016f0ca25..d371a5491fe220915acef6d439d524aefb16fd95 100644 (file)
@@ -2,4 +2,4 @@ AM_CFLAGS = $(PACKAGE_CFLAGS)
-SUBDIRS = src
+SUBDIRS = src doc
diff --git a/README b/README
index b2fed8845367c8274f66224046eeee31e4d693da..0d67972735d7e0cfdd672dd28a44eb13ae8dddac 100644 (file)
--- a/README
+++ b/README
@@ -1,12 +1,12 @@
 Julien Desfossez <>
-August 2011
+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.
index 0b67fc9dd5b7699e2634ca1c08205ebb613109e2..358ead88e2443705c69a7e98003a13dba55a87b0 100644 (file)
@@ -77,5 +77,6 @@ AC_SUBST(PACKAGE_CFLAGS)
+       doc/Makefile
diff --git a/doc/lttngtop.1 b/doc/lttngtop.1
new file mode 100644 (file)
index 0000000..ac9828c
--- /dev/null
@@ -0,0 +1,94 @@
+.TH "LTTNGTOP" "1" "April 18, 2012" "" ""
+lttngtop \(em LTTng Trace Viewer
+lttngtop INPUT
+Lttngtop is a ncurses interface for reading and browsing traces recorded by the
+LTTng tracer and displaying various statistics. As of now, the cpu usage,
+performance counters and per process/file I/O bandwidth are displayed. This
+version currently only supports offline traces, but a live version is in alpha
+and will be available for testing soon.
+Input trace path
+LTTngTop requires that the pid, procname, tid and ppid context information
+are enabled during tracing.
+If you want the CPU activity view, you need the sched_switch event, if you
+want the I/O statistics, you need to enable the system call tracing, and if
+you want the performance counters, you need to enable them for the events you
+are interested in (or all of them). Note, there is a hardware limitation for the
+number of performance counter you can enable, check dmesg for information.
+The following example creates a trace with all events enabled, the mandatory context informations and
+three performance counters. It assumes that you are running as root or with a user part of the tracing group and a lttng-sessiond
+launched as root.
+lttng create lttngtop
+lttng enable-event -k -a
+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
+sleep 10
+lttng stop
+lttng destroy
+babeltrace(1), babeltrace-log(1), lttng(1), lttng-ust(3), lttng-sessiond(8)
+No knows bugs at this point.
+If you encounter any issues or usability problem, please report it on
+our mailing list <> to help improve this
+LTTngTop is distributed under the GPLv2 license. See the LICENSE file
+in the source tree for details.
+A Web site is available at for more
+information on Babeltrace and the Common Trace Format. See
+ for more information on the LTTng project.
+Mailing list for support and development: <>.
+You can find us on IRC server (OFTC) in #lttng.
+LTTngTop was originally written by Julien Desfossez, with contribution
+from Mathieu Bain for the I/O bandwidth view, and suggestions and ideas
+from the team working with the LTTng project. It is currently
+maintained by Julien Desfossez <>
This page took 0.038511 seconds and 4 git commands to generate.