X-Git-Url: https://git.liburcu.org/?p=lttv.git;a=blobdiff_plain;f=LTTngManual.html;h=10978001793975f4867738ff5f0bf34a4bcfa3dd;hp=09236d5feeff67139fa01f68302dffd3bf87dc57;hb=HEAD;hpb=e3bf857c22b9c1871cb9356e9d1c3b1320ee7f94 diff --git a/LTTngManual.html b/LTTngManual.html index 09236d5f..10978001 100644 --- a/LTTngManual.html +++ b/LTTngManual.html @@ -8,7 +8,7 @@

Linux Trace Toolkit Next Generation Manual

Author : Mathieu Desnoyers, September 2005
-Last update : January 30, 2010
+Last update : September 3, 2010
(originally known as the LTTng QUICKSTART guide)

Table of Contents

@@ -76,8 +76,8 @@ 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. -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 : LTTng+LTTV versions compatibility @@ -203,9 +203,11 @@ href="http://lttng.org/cgi-bin/gitweb.cgi?p=lttv.git;a=blob_plain;f=doc/develope 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 lttng-modules-0.x.tar.bz2 | tar xvof - @@ -240,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 - [*] Activate userspace markers ABI (experimental, optional) [*] Immediate value optimization (optional) - [*] Linux Trace Toolkit Next Generation (LTTng) ---> - <M> or <*> Compile lttng tracing probes - <M> or <*> Linux Trace Toolkit High-speed Lockless Data Relay - <M> or <*> Linux Trace Toolkit Lock-Protected Data Relay - <M> or <*> Linux Trace Toolkit Serializer - <M> or <*> Linux Trace Toolkit Marker Control - <M> or <*> Linux Trace Toolkit Tracer - [*] Align Linux Trace Toolkit Traces - <M> or <*> Support logging events from userspace - [*] Support trace extraction from crash dump - <M> or <*> Linux Trace Toolkit Trace Controller - <M> or <*> Linux Trace Toolkit State Dump Select <Exit> Select <Exit> Select <Yes> @@ -282,6 +271,22 @@ Select the Linux 2.6.X-lttng-0.x.xx kernel in your boot loader. -- + +

Installing the LTTng modules

+ +
+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
+
+Optionally, make can be prefixed with tracer options:
+
+EXTRA_CFLAGS="-DLTT_DEBUG_EVENT_SIZE" make
+EXTRA_CFLAGS="-DLTT_VMCORE" make
+EXTRA_CFLAGS="-DLTT_DEBUG_EVENT_SIZE -DLTT_VMCORE" make
+
+

Editing the system wide configuration

@@ -312,7 +317,6 @@ compile statically, you may not need to issue all these commands. modprobe ltt-trace-control modprobe ltt-marker-control modprobe ltt-tracer -modprobe ltt-serialize modprobe ltt-relay modprobe ipc-trace modprobe kernel-trace @@ -344,7 +348,6 @@ cp /etc/modules /etc/modules.bkp echo ltt-trace-control >> /etc/modules echo ltt-marker-control >> /etc/modules echo ltt-tracer >> /etc/modules -echo ltt-serialize >> /etc/modules echo ltt-relay >> /etc/modules echo ipc-trace >> /etc/modules echo kernel-trace >> /etc/modules @@ -369,7 +372,7 @@ same name as the ltt-control kernel module, they are *not* the same thing.)
 su -
 cd /usr/src
-wget http://ltt.polymtl.ca/lttng/ltt-control-0.x-xxxx2006.tar.gz
+wget http://lttng.org/files/lttng/ltt-control-0.x-xxxx2006.tar.gz
 gzip -cd ltt-control-0.x-xxxx2008.tar.gz | tar xvof -
 cd ltt-control-0.x-xxxx2006
 (refer to README to see the development libraries that must be installed on you
@@ -404,7 +407,7 @@ or different from the visualisation machine)
 
 su -
 cd /usr/src
-wget http://ltt.polymtl.ca/packages/lttv-0.x.xx-xxxx2008.tar.gz
+wget http://lttng.org/files/packages/lttv-0.x.xx-xxxx2008.tar.gz
 gzip -cd lttv-0.x.xx-xxxx2008.tar.gz | tar xvof -
 cd lttv-0.x.xx-xxxx2008
 (refer to README to see the development libraries that must be installed on your
@@ -543,12 +546,12 @@ for LTTng probe examples.
 

Adding userspace instrumentation

Add new events to userspace programs with -userspace markers packages. +userspace markers packages. 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. See markers-userspace-0.5.tar.bz2 or more recent. +href="http://lttng.org/files/packages/markers-userspace-0.5.tar.bz2">markers-userspace-0.5.tar.bz2 or more recent.

Note that tracepoint/marker-based userspace tracing is available at