X-Git-Url: http://git.liburcu.org/?a=blobdiff_plain;f=trunk%2Flttv%2FQUICKSTART.html;h=929e4a65acb94af1e35e25c4f81694b6f91fe95f;hb=84cf59032119d4a6bf96ef4ae486d1b96462e8bb;hp=63701842d932d83590bffa58c8ee5de5e8e54993;hpb=c924c2c6eef9ac7711b93cc83b093d9a888b0332;p=lttv.git diff --git a/trunk/lttv/QUICKSTART.html b/trunk/lttv/QUICKSTART.html index 63701842..929e4a65 100644 --- a/trunk/lttv/QUICKSTART.html +++ b/trunk/lttv/QUICKSTART.html @@ -7,114 +7,99 @@

Linux Trace Toolkit Quickstart

- Author : Mathieu Desnoyers, September 2005
-Last update : January 9th, 2009
+Last update : January 21st, 2009
-

-This document is made of four parts : the first one explains how to install -LTTng and LTTV from Debian and RPM binary packages, the second one explains how -to install LTTng and LTTV from sources and the third one describes the steps -to follow to trace a system and view it. The fourth and last part explains -briefly how to add a new trace point to the kernel and to user space -applications. +

Table of Contents

+ +
+ +

Introduction

-What you will typically want is to read sections 2 and 3 : install LTTng from -sources and use it. +This document is made of four parts : the first one explains how +to install LTTng and LTTV from sources, the second one describes the steps +to follow to trace a system and view it. The third part explains +briefly how to add a new trace point to the kernel and to user space +applications. The fourth and last part explains how to create Debian or RPM +packages from the LTTng and LTTV sources.

-These operations are made for installing the LTTng 0.74 tracer on a linux 2.6.X +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 and -markers-userspace, please refer to : +To see the list of compatibilities between LTTng, ltt-control, LTTV, please +refer to : LTTng+LTTV versions compatibility +The lttng patch is necessary to have the tracing hooks in the kernel. - -

-The following lttng patch is necessary to have the tracing hooks in the kernel. -The following ltt-control module controls the tracing. - -

-Required programs and libraries are assumed to be automatically installed in an -installation with Debian or RPM packages. In the case of an installation from -sources, the dependencies are listed. - - -** Current development status **

-LTTng :
+
Supported architectures : +
+LTTng :

  • x86 32/64 bits
  • PowerPC 32 and 64 bits
  • ARM (with limited timestamping precision, e.g. 1HZ. Need architecture-specific support for better precision)
  • MIPS
    +
    LTTV :
    -supported architectures :
  • Intel 32/64 bits
  • PowerPC 32 and 64 bits
  • Possibly others. Takes care of endianness and type size difference between the LTTng traces and the LTTV analysis tool. -*********************************************************** -** Section 1 * Installation from Debian or RPM packages ** -*********************************************************** - -* Create custom LTTV Debian packages - -Use : dpkg-buildpackage -rfakeroot - -You should then have your LTTV .deb files created for your architecture. - -* Create custom LTTng packages +
    -For building LTTng Debian packages : - -Get the build tree with patches applies as explained in section 2. - -make menuconfig (or xconfig or config) (customize your configuration) -make-kpkg kernel_image - -You will then see your freshly created .deb in /usr/src. Install it with -dpkg -i /usr/src/(image-name).deb -Then, follow the section "Editing the system wide configuration" in section 2. - - -*********************************************************** -** Section 2 * Installation from sources ** -*********************************************************** - -* Prerequisites +

    Installation from sources

    +

    +

  • Prerequisites
    • + -* Reminder - -See the list of compatibilities between LTTng, ltt-control, LTTV and -markers-userspace at : -http://ltt.polymtl.ca > LTTng+LTTV versions compatibility +
  • Reminder/
  • +See the list of compatibilities between LTTng, ltt-control and LTTV at : +LTTng+LTTV +versions compatibility. * Getting the LTTng packages @@ -443,5 +430,31 @@ 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 ** +*********************************************************** + +* Create custom LTTV Debian packages + +Use : dpkg-buildpackage -rfakeroot + +You should then have your LTTV .deb files created for your architecture. + +* Create custom LTTng packages + +For building LTTng Debian packages : + +Get the build tree with patches applies as explained in section 2. + +make menuconfig (or xconfig or config) (customize your configuration) +make-kpkg kernel_image + +You will then see your freshly created .deb in /usr/src. Install it with +dpkg -i /usr/src/(image-name).deb + +Then, follow the section "Editing the system wide configuration" in section 2. + + +