update lttng manual

[lttv.git] / LTTngManual.html

diff --git a/LTTngManual.html b/LTTngManual.html
index 60e6dff9f9bf4e48dbe31832981727c6368a746f..ae4add2ef3816810acdf1a219513dbc51ebe0a8e 100644 (file)
--- a/LTTngManual.html
+++ b/LTTngManual.html
@@ -8,7 +8,7 @@
 <h1>Linux Trace Toolkit Next Generation Manual</h1>
 
 Author : Mathieu Desnoyers, September 2005<br>
 <h1>Linux Trace Toolkit Next Generation Manual</h1>
 
 Author : Mathieu Desnoyers, September 2005<br>

-Last update : January 30, 2010<br>
+Last update : September 3, 2010<br>

 (originally known as the LTTng QUICKSTART guide)
 
 <h2>Table of Contents</h2>
 (originally known as the LTTng QUICKSTART guide)
 
 <h2>Table of Contents</h2>


@@ -76,10 +76,10 @@ packages from the LTTng and LTTV sources.
 These operations are made for installing the LTTng 0.86 tracer on a linux 2.6.X
 kernel. You will also find instructions for installation of LTTV 0.12.x : the
 Linux Trace Toolkit Viewer. 
 These operations are made for installing the LTTng 0.86 tracer on a linux 2.6.X
 kernel. You will also find instructions for installation of LTTV 0.12.x : the
 Linux Trace Toolkit Viewer. 

-To see the list of compatibilities between LTTng, ltt-control, LTTV, please
-refer to :
+To see the list of compatibilities between the LTTng kernel patchset, LTTng
+modules, ltt-control, LTTV, please refer to :

 <a
 <a

-href="http://ltt.polymtl.ca/svn/trunk/lttv/doc/developer/lttng-lttv-compatibility.html">LTTng+LTTV versions compatibility</a>
+href="http://lttng.org/cgi-bin/gitweb.cgi?p=lttv.git;a=blob_plain;f=doc/developer/lttng-lttv-compatibility.html;hb=HEAD">LTTng+LTTV versions compatibility</a>

 
 The ongoing work had the Linux Kernel Markers integrated in the mainline Linux
 kernel since Linux 2.6.24 and the Tracepoints since 2.6.28. In its current
 
 The ongoing work had the Linux Kernel Markers integrated in the mainline Linux
 kernel since Linux 2.6.24 and the Tracepoints since 2.6.28. In its current


@@ -174,7 +174,7 @@ gtk 2.4 or better development libraries
   (Fedora : gtk2, gtk2-devel)
   note : For Fedora users : this might require at least core 3 from Fedora,
   or you might have to compile your own GTK2 library.
   (Fedora : gtk2, gtk2-devel)
   note : For Fedora users : this might require at least core 3 from Fedora,
   or you might have to compile your own GTK2 library.

-glib 2.4 or better development libraries
+glib 2.16 or better development libraries

   (Debian : libglib2.0-0, libglib2.0-dev)
   (Fedora : glib2, glib2-devel)
 libpopt development libraries
   (Debian : libglib2.0-0, libglib2.0-dev)
   (Fedora : glib2, glib2-devel)
 libpopt development libraries


@@ -194,8 +194,7 @@ libc6 development librairies
 <p>
 See the list of compatibilities between LTTng, ltt-control and LTTV at :
 <a
 <p>
 See the list of compatibilities between LTTng, ltt-control and LTTV at :
 <a

-href="http://ltt.polymtl.ca/svn/trunk/lttv/doc/developer/lttng-lttv-compatibility.html">LTTng+LTTV
-versions compatibility</a>.
+href="http://lttng.org/cgi-bin/gitweb.cgi?p=lttv.git;a=blob_plain;f=doc/developer/lttng-lttv-compatibility.html;hb=HEAD">LTTng+LTTV versions compatibility</a>.

 
 
 <h3><a href="#TOCgetlttng" name="getlttng">Getting the LTTng packages</a></h3>
 
 
 <h3><a href="#TOCgetlttng" name="getlttng">Getting the LTTng packages</a></h3>


@@ -204,9 +203,11 @@ versions compatibility</a>.
 su -
 mkdir /usr/src/lttng
 cd /usr/src/lttng
 su -
 mkdir /usr/src/lttng
 cd /usr/src/lttng

-(see http://ltt.polymtl.ca/lttng for package listing)
-wget http://ltt.polymtl.ca/lttng/patch-2.6.X-lttng-0.x.xx.tar.bz2
+(see http://lttng.org/files/lttng for package listing)
+wget http://lttng.org/files/lttng/patch-2.6.X-lttng-0.x.xx.tar.bz2
+wget http://lttng.org/files/lttng/lttng-modules-0.x.tar.bz2

 bzip2 -cd patch-2.6.X-lttng-0.x.xx.tar.bz2 | tar xvof -
 bzip2 -cd patch-2.6.X-lttng-0.x.xx.tar.bz2 | tar xvof -

+bzip2 -cd lttng-modules-0.x.tar.bz2 | tar xvof -

 </PRE>
 
 
 </PRE>
 
 


@@ -241,20 +242,7 @@ make menuconfig (or make xconfig or make config)
     Select the following options :
     [*] Prompt for development and/or incomplete code/drivers
     [*] Activate markers
     Select the following options :
     [*] Prompt for development and/or incomplete code/drivers
     [*] Activate markers

-    [*] Activate userspace markers ABI (experimental, optional)

     [*] Immediate value optimization (optional)
     [*] Immediate value optimization (optional)

-    [*] Linux Trace Toolkit Next Generation (LTTng) ---&gt;
-    &lt;M&gt; or &lt;*&gt; Compile lttng tracing probes
-    &lt;M&gt; or &lt;*&gt; Linux Trace Toolkit High-speed Lockless Data Relay
-    &lt;M&gt; or &lt;*&gt; Linux Trace Toolkit Lock-Protected Data Relay
-    &lt;M&gt; or &lt;*&gt; Linux Trace Toolkit Serializer
-    &lt;M&gt; or &lt;*&gt;   Linux Trace Toolkit Marker Control
-    &lt;M&gt; or &lt;*&gt;     Linux Trace Toolkit Tracer
-    [*] Align Linux Trace Toolkit Traces
-    &lt;M&gt; or &lt;*&gt; Support logging events from userspace
-    [*] Support trace extraction from crash dump
-    &lt;M&gt; or &lt;*&gt; Linux Trace Toolkit Trace Controller
-    &lt;M&gt; or &lt;*&gt; Linux Trace Toolkit State Dump

   Select &lt;Exit&gt;
   Select &lt;Exit&gt;
   Select &lt;Yes&gt;
   Select &lt;Exit&gt;
   Select &lt;Exit&gt;
   Select &lt;Yes&gt;


@@ -283,6 +271,16 @@ Select the Linux 2.6.X-lttng-0.x.xx kernel in your boot loader.
 --
 </PRE>
 
 --
 </PRE>
 

+
+<h3><a href="#TOCinstalllttng" name="installlttng">Installing the LTTng modules</a></h3>
+
+<PRE>
+su -
+cd /usr/src/lttng/lttng-modules-0.x
+KERNELDIR=/usr/src/linux-2.6.X-lttng-0.x.xx make
+KERNELDIR=/usr/src/linux-2.6.X-lttng-0.x.xx make modules_install
+</PRE>
+

 <h3><a href="#TOCeditconfig" name="editconfig">Editing the system wide
 configuration</a></h3>
 
 <h3><a href="#TOCeditconfig" name="editconfig">Editing the system wide
 configuration</a></h3>
 


@@ -324,6 +322,7 @@ modprobe jbd2-trace
 modprobe ext4-trace
 modprobe syscall-trace
 modprobe trap-trace
 modprobe ext4-trace
 modprobe syscall-trace
 modprobe trap-trace

+modprobe block-trace

 #if locking tracing is wanted, uncomment the following
 #modprobe lockdep-trace
 </PRE>
 #if locking tracing is wanted, uncomment the following
 #modprobe lockdep-trace
 </PRE>


@@ -551,10 +550,8 @@ See <a
 href="http://ltt.polymtl.ca/packages/markers-userspace-0.5.tar.bz2">markers-userspace-0.5.tar.bz2</a> or more recent.
 
 <p>
 href="http://ltt.polymtl.ca/packages/markers-userspace-0.5.tar.bz2">markers-userspace-0.5.tar.bz2</a> or more recent.
 
 <p>

-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>. This new infrastructure is not yet implemented.
+Note that tracepoint/marker-based userspace tracing is available at <a
+href="http://lttng.org/ust/">LTTng User-space Tracer (UST)</a>.

 
 <p>
 The easy quick-and-dirty way to perform userspace tracing is currently to write
 
 <p>
 The easy quick-and-dirty way to perform userspace tracing is currently to write