X-Git-Url: http://git.liburcu.org/?a=blobdiff_plain;f=trunk%2Flttv%2FQUICKSTART.html;h=75aafe49ed6ae21042ba59cfbf8b67e180eb070b;hb=633bc4a39fa7dc25a67bedb5c44aaa81a34bac45;hp=78fdad601d8f16b8848c6ccf0a1d3f81392479df;hpb=b9e1fab11c089bdf2ed2d7a3b834587aa0464e11;p=lttv.git
diff --git a/trunk/lttv/QUICKSTART.html b/trunk/lttv/QUICKSTART.html
index 78fdad60..75aafe49 100644
--- a/trunk/lttv/QUICKSTART.html
+++ b/trunk/lttv/QUICKSTART.html
@@ -7,7 +7,6 @@
Linux Trace Toolkit Quickstart
-
Author : Mathieu Desnoyers, September 2005
Last update : January 21st, 2009
@@ -20,6 +19,8 @@ sources
Using LTTng and LTTV
Adding kernel and user-space
tracepoints
+Creating Debian and RPM packages
+from LTTV
@@ -27,33 +28,28 @@ tracepoints
-This document is made of three parts : the first one explains how
+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 and last part explains
+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.
+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.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 :
LTTng+LTTV versions compatibility
-
-
The lttng patch is necessary to have the tracing hooks in the kernel.
-** Current development status **
-
+Supported architectures :
LTTng :
-Supported architectures :
x86 32/64 bits
PowerPC 32 and 64 bits
ARM (with limited timestamping precision, e.g. 1HZ. Need
@@ -62,7 +58,6 @@ architecture-specific support for better precision)
LTTV :
-supported architectures :
Intel 32/64 bits
PowerPC 32 and 64 bits
Possibly others. Takes care of endianness and type size difference between
@@ -70,84 +65,64 @@ 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
+
+
+
Prerequisites
+
+
Tools needed to follow the package download steps :
-o wget
-o bzip2
-o gzip
-o tar
+
- wget
+
- bzip2
+
- gzip
+
- tar
+
You have to install the standard development libraries and programs necessary
to compile a kernel :
(from Documentation/Changes in the Linux kernel tree)
-o Gnu C 2.95.3 # gcc --version
-o Gnu make 3.79.1 # make --version
-o binutils 2.12 # ld -v
-o util-linux 2.10o # fdformat --version
-o module-init-tools 0.9.10 # depmod -V
+
- Gnu C 2.95.3 # gcc --version
+
- Gnu make 3.79.1 # make --version
+
- binutils 2.12 # ld -v
+
- util-linux 2.10o # fdformat --version
+
- module-init-tools 0.9.10 # depmod -V
+
You might also want to have libncurses5 to have the text mode kernel
configuration menu, but there are alternatives.
+
Prerequisites for LTTV 0.x.x installation are :
-gcc 3.2 or better
-gtk 2.4 or better development libraries
+
- gcc 3.2 or better
+
- gtk 2.4 or better development libraries
(Debian : libgtk2.0, libgtk2.0-dev)
(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.4 or better development libraries
(Debian : libglib2.0-0, libglib2.0-dev)
(Fedora : glib2, glib2-devel)
-libpopt development libraries
+
- libpopt development libraries
(Debian : libpopt0, libpopt-dev)
(Fedora : popt)
-libpango development libraries
+
- libpango development libraries
(Debian : libpango1.0, libpango1.0-dev)
(Fedora : pango, pango-devel)
-libc6 development librairies
+
- libc6 development librairies
(Debian : libc6, libc6-dev)
(Fedora : glibc, glibc)
+
-* 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
@@ -451,5 +426,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.
+
+
+