todo update

[lttv.git] / ltt / branches / poly / QUICKSTART

diff --git a/ltt/branches/poly/QUICKSTART b/ltt/branches/poly/QUICKSTART
index 3c094fce825ed40efc45c803f9ff86fef971d08c..e2a09779651230a6e81dbec9da0390bdd1448072 100644 (file)
--- a/ltt/branches/poly/QUICKSTART
+++ b/ltt/branches/poly/QUICKSTART
@@ -13,7 +13,7 @@ What you will typically want is to read sections 1 and 3 : install LTTng from
 binary packages and use it. If there are no packages ready for your system, you
 will have to install from sources (section 2) instead.
 
 binary packages and use it. If there are no packages ready for your system, you
 will have to install from sources (section 2) instead.
 

-These operations are made for installing the LTTng 0.4.1 tracer on a
+These operations are made for installing the LTTng 0.4.2 tracer on a

 linux 2.6.12-rc4-mm2 kernel. You will also find instructions for installtion of
 LTTV 0.6.x : the Linux Trace Toolkit Viewer.
 
 linux 2.6.12-rc4-mm2 kernel. You will also find instructions for installtion of
 LTTV 0.6.x : the Linux Trace Toolkit Viewer.
 


@@ -50,8 +50,16 @@ Author : Mathieu Desnoyers, September 2005
 ** Section 1 * Installation from Debian or RPM packages  **
 ***********************************************************
 
 ** Section 1 * Installation from Debian or RPM packages  **
 ***********************************************************
 

-No RPM packages are ready yet.
-No Debian kernel LTTng patch is ready yet.
+* Install from RPM packages on Fedora Core 4 :
+
+Get LTTV RPM from :
+
+http://ltt.polymtl.ca/packages/fedora/RPMS
+
+No RPM packages for LTTng are ready yet.
+
+
+* Install from Deb packages on Debian :

 
 You can use the ltt.polymtl.ca apt source to get LTTV for Debian :
 
 
 You can use the ltt.polymtl.ca apt source to get LTTV for Debian :
 


@@ -82,7 +90,7 @@ packages for other platforms, do :
 su -
 cd /usr/src
 apt-get source lttv
 su -
 cd /usr/src
 apt-get source lttv

-cd lttv-0.6.7
+cd lttv-0.6.8

 dpkg-buildpackage -rfakeroot
 
 You should then have your LTTV .deb files created for your architecture.
 dpkg-buildpackage -rfakeroot
 
 You should then have your LTTV .deb files created for your architecture.


@@ -159,8 +167,9 @@ mkdir /usr/src/lttng
 cd /usr/src/lttng
 (see http://ltt.polymtl.ca/lttng for package listing)
 wget http://ltt.polymtl.ca/lttng/lttng-modules-0.3.tar.bz2
 cd /usr/src/lttng
 (see http://ltt.polymtl.ca/lttng for package listing)
 wget http://ltt.polymtl.ca/lttng/lttng-modules-0.3.tar.bz2

-wget http://ltt.polymtl.ca/lttng/patch-2.6.12-rc4-mm2-lttng-0.4.1.bz2
+wget http://ltt.polymtl.ca/lttng/patch-2.6.12-rc4-mm2-lttng-0.4.2.tar.bz2

 bzip2 -cd lttng-modules-0.3.tar.bz2 | tar xvof -
 bzip2 -cd lttng-modules-0.3.tar.bz2 | tar xvof -

+bzip2 -cd patch-2.6.12-rc4-mm2-lttng-0.4.2.tar.bz2 | tar xvof -

 
 
 * Getting LTTng kernel sources
 
 
 * Getting LTTng kernel sources


@@ -172,15 +181,15 @@ wget http://kernel.org/pub/linux/kernel/people/akpm/patches/2.6/2.6.12-rc4/2.6.1
 bzip2 -cd linux-2.6.12-rc4.tar.bz2 | tar xvof -
 cd linux-2.6.12-rc4
 bzip2 -cd ../2.6.12-rc4-mm2.bz2 | patch -p1
 bzip2 -cd linux-2.6.12-rc4.tar.bz2 | tar xvof -
 cd linux-2.6.12-rc4
 bzip2 -cd ../2.6.12-rc4-mm2.bz2 | patch -p1

-bzip2 -cd /usr/src/lttng/patch-2.6.12-rc4-mm2-lttng-0.4.1.bz2 | patch -p1
+cat /usr/src/lttng/patch-2.6.12-rc4-mm2-lttng-0.4.2-* | patch -p1

 cd ..
 cd ..

-mv linux-2.6.12-rc4 linux-2.6.12-rc4-mm2-lttng-0.4.1
+mv linux-2.6.12-rc4 linux-2.6.12-rc4-mm2-lttng-0.4.2

 
 
 * Installing a LTTng kernel
 
 su -
 
 
 * Installing a LTTng kernel
 
 su -

-cd /usr/src/linux-2.6.12-rc4-mm2-lttng-0.4.1
+cd /usr/src/linux-2.6.12-rc4-mm2-lttng-0.4.2

 make menuconfig (or make xconfig or make config)
     Select the < Help > button if you are not familiar with kernel
     configuration.
 make menuconfig (or make xconfig or make config)
     Select the < Help > button if you are not familiar with kernel
     configuration.


@@ -206,15 +215,15 @@ make install
 
 reboot
 
 
 reboot
 

-  Select the Linux 2.6.12-rc4-mm2-lttng-0.4.1 kernel in your boot loader.
+  Select the Linux 2.6.12-rc4-mm2-lttng-0.4.2 kernel in your boot loader.

 
 
 * Install the ltt-modules
 
 su -
 cd /usr/src/lttng/lttng-modules-0.3
 
 
 * Install the ltt-modules
 
 su -
 cd /usr/src/lttng/lttng-modules-0.3

-KERNELDIR=/usr/src/linux-2.6.12-rc4-mm2-lttng-0.4.1 make
-KERNELDIR=/usr/src/linux-2.6.12-rc4-mm2-lttng-0.4.1 make modules_install
+KERNELDIR=/usr/src/linux-2.6.12-rc4-mm2-lttng-0.4.2 make
+KERNELDIR=/usr/src/linux-2.6.12-rc4-mm2-lttng-0.4.2 make modules_install

 
 
 * Editing the system wide configuration
 
 
 * Editing the system wide configuration


@@ -246,9 +255,9 @@ echo ltt-control >> /etc/modules
 
 su -
 cd /usr/src
 
 su -
 cd /usr/src

-wget http://ltt.polymtl.ca/packages/LinuxTraceToolkitViewer-0.6.5-21092005.tar.gz
-gzip -cd LinuxTraceToolkitViewer-0.6.5-21092005.tar.gz | tar xvof -
-cd LinuxTraceToolkitViewer-0.6.5-21092005
+wget http://ltt.polymtl.ca/packages/LinuxTraceToolkitViewer-0.6.8-26092005.tar.gz
+gzip -cd LinuxTraceToolkitViewer-0.6.8-26092005.tar.gz | tar xvof -
+cd LinuxTraceToolkitViewer-0.6.8-26092005

 (refer to README to see the development libraries that must be installed on you
 system)
 ./configure
 (refer to README to see the development libraries that must be installed on you
 system)
 ./configure


@@ -327,14 +336,14 @@ cp process.xml yourfacility.xml
 cd /tmp
 /usr/local/bin/genevent /usr/local/share/LinuxTraceToolkitViewer/yourfacility.xml
 cp ltt-facility-yourfacility.h ltt-facility-id-yourfacility.h \
 cd /tmp
 /usr/local/bin/genevent /usr/local/share/LinuxTraceToolkitViewer/yourfacility.xml
 cp ltt-facility-yourfacility.h ltt-facility-id-yourfacility.h \

-         /usr/src/linux-2.6.12-rc4-mm2-lttng-0.4.1/include/linux/ltt
+         /usr/src/linux-2.6.12-rc4-mm2-lttng-0.4.2/include/linux/ltt

 cp ltt-facility-loader-yourfacility.c ltt-facility-loader-yourfacility.h \
 cp ltt-facility-loader-yourfacility.c ltt-facility-loader-yourfacility.h \

-         /usr/src/linux-2.6.12-rc4-mm2-lttng-0.4.1/ltt
+         /usr/src/linux-2.6.12-rc4-mm2-lttng-0.4.2/ltt

   * edit the kernel file you want to instrument
     - Add #include <linux/ltt/ltt-facility-yourfacility.h> at the beginning
       of the file.
     - Add a call to the tracing functions. See their names and parameters in
   * edit the kernel file you want to instrument
     - Add #include <linux/ltt/ltt-facility-yourfacility.h> at the beginning
       of the file.
     - Add a call to the tracing functions. See their names and parameters in

-      /usr/src/linux-2.6.12-rc4-mm2-lttng-0.4.1/include/linux/ltt/ltt-facility-yourfacility.h
+      /usr/src/linux-2.6.12-rc4-mm2-lttng-0.4.2/include/linux/ltt/ltt-facility-yourfacility.h