<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
- <title>Linux Trace Toolkit Quickstart</title>
+ <title>Linux Trace Toolkit Next Generation User Documentation</title>
</head>
<body>
-<h1>Linux Trace Toolkit Quickstart</h1>
+<h1>Linux Trace Toolkit Next Generation User Documentation</h1>
Author : Mathieu Desnoyers, September 2005<br>
Last update : January 21st, 2009<br>
+(originally known as the LTTng QUICKSTART guide)
<h2>Table of Contents</h2>
<ul>
<hr />
-<h2><a href="#TOCsection2" name="section2">Installation from sources</a></h2>
+<h2><a href="#TOCsection1" name="section1">Installation from sources</a></h2>
<p>
<li>Prerequisites</li>
make install
</PRE>
-<li>Getting and installing the markers-userspace package for user space
-tracing (experimental)</li>
-<p>
-See <a
-href="http://ltt.polymtl.ca/packages/markers-userspace-0.5.tar.bz2">markers-userspace-0.5.tar.bz2</a> or more recent.
-
<hr />
-<h2><a href="#TOCsection3" name="section3">Using LTTng and LTTV</a></h2>
+<h2><a href="#TOCsection2" name="section2">Using LTTng and LTTV</a></h2>
<li>IMPORTANT : Arm Linux Kernel Markers after each boot</li>
<PRE>
lttctl -D -w /tmp/trace3 trace3
</PRE>
-**************************************************************
-** Section 4 * Adding new instrumentations with the markers **
-**************************************************************
+<hr />
+
+
+<h2><a href="#TOCsection3" name="section3">Adding new instrumentations with the
+markers</a></h2>
+<p>
+<p>
See Documentation/markers.txt and Documentation/tracepoints.txt in your kernel
tree.
-* Add new events to userspace programs with userspace markers
-http://ltt.polymtl.ca/packages/
+<li>Add new events to userspace programs with
+<a href="http://ltt.polymtl.ca/packages/">userspace markers packages</a></li>
+<p>
Get the latest markers-userspace-*.tar.bz2 and see the Makefile and examples. It
allows inserting markers in executables and libraries, currently only on x86_32
and x86_64.
-***********************************************************
-** Section 5 * Creating Debian or RPM packages **
-***********************************************************
+See <a
+href="http://ltt.polymtl.ca/packages/markers-userspace-0.5.tar.bz2">markers-userspace-0.5.tar.bz2</a> or more recent.
-* Create custom LTTV Debian packages
+Note that a new design document for a 3rd generation of tracepoint/marker-based
+userspace tracing is available at <a
+href="http://ltt.polymtl.ca/svn/trunk/lttv/doc/developer/ust.html">LTTng User-space Tracing
+Design"</a>.
-Use : dpkg-buildpackage -rfakeroot
+<hr />
-You should then have your LTTV .deb files created for your architecture.
+<h2><a href="#TOCsection4" name="section4">Creating Debian or RPM packages</a></h2>
+<p>
-* Create custom LTTng packages
+<li>Create custom LTTV Debian packages</li>
-For building LTTng Debian packages :
+<PRE>
+Use : dpkg-buildpackage -rfakeroot
+</PRE>
+<p>
+You should then have your LTTV .deb files created for your architecture.
-Get the build tree with patches applies as explained in section 2.
+<li>Create custom LTTng packages</li>
+<p>
+For building LTTng Debian packages :
+get the build tree with patches applies as explained in section 2.
+<PRE>
make menuconfig (or xconfig or config) (customize your configuration)
make-kpkg kernel_image
-
+</PRE>
+<p>
You will then see your freshly created .deb in /usr/src. Install it with
+<PRE>
dpkg -i /usr/src/(image-name).deb
-
+</PRE>
+<p>
Then, follow the section "Editing the system wide configuration" in section 2.