debian source

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

diff --git a/ltt/branches/poly/QUICKSTART b/ltt/branches/poly/QUICKSTART
index 4a781b5224a8e2a72380f5d7277d036ea6f08d28..cf6a144472b95fdfae5cfd66b3eb479488af3ace 100644 (file)
--- a/ltt/branches/poly/QUICKSTART
+++ b/ltt/branches/poly/QUICKSTART
@@ -37,9 +37,33 @@ Author : Mathieu Desnoyers, September 2005
 ** Section 1 * Installation from Debian or RPM packages  **
 ***********************************************************
 
-No Debian or RPM packages are ready yet.
+No RPM packages are ready yet.
+No Debian kernel LTTng patch is ready yet.
+
+You can use the ltt.polymtl.ca apt source to get LTTV for Debian :
+
+Add the following two sources to your /etc/apt/sources.list :
+
+deb http://ltt.polymtl.ca/packages/debian experimental main
+deb-src http://ltt.polymtl.ca/packages/debian experimental main
+
+Then, perform the following :
+
+su -
+apt-get update
+apt-get install lttv lttv-doc
+  * note : the packages are signed by myself. I am not considered a trusted
+    Debian source yet, so warnings are normal.
+
+Packages are only available for i386. If you want to create packages for other
+platforms, do :
+
+apt-get source lttv
+cd lttv-0.6.7
+dpkg-buildpackage -rfakeroot
+
+You should then have your .deb files created for your architecture.
 
-TODO
 
 
 ***********************************************************
@@ -83,9 +107,9 @@ su -
 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.2.tar.bz2
+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.bz2
-bzip2 -cd lttng-modules-0.2.tar.bz2 | tar xvof -
+bzip2 -cd lttng-modules-0.3.tar.bz2 | tar xvof -
 
 
 * Getting LTTng kernel sources
@@ -116,6 +140,8 @@ make menuconfig (or make xconfig or make config)
     Select the following options :
     [*] Linux Trace Toolkit Instrumentation Support
     [M] or [*] Linux Trace Toolkit Tracer
+        It makes no difference for the rest of the procedure whether the Tracer
+        is compiled built-in or as a module.
     do NOT activate (not ready yet) :
        [ ] Align Linux Trace Toolkit Traces
        [ ] Activate Linux Trace Toolkit Heartbeat Timer
@@ -124,16 +150,17 @@ make menuconfig (or make xconfig or make config)
   Select <Exit>
   Select <Yes>
 make
-make install
 make modules_install
+make install
 
 You must activate relayfs and specify a mount point. This is typically done in
 fstab such that it happens at boot time.
 
 If you have never used RelayFS before, these operation would do this for you :
+
 mkdir /mnt/relayfs
-echo "relayfs         /mnt/relayfs    relayfs rw              0       0" \
-   >> /etc/fstab
+cp /etc/fstab /etc/fstab.lttng.bkp
+echo "relayfs         /mnt/relayfs    relayfs rw              0       0"  >> /etc/fstab
 
 reboot
 
@@ -143,15 +170,17 @@ reboot
 * Install the ltt-modules
 
 su -
-cd /usr/src/lttng/lttng-modules-0.2
+cd /usr/src/lttng/lttng-modules-0.3
 KERNELDIR=/usr/src/linux-2.6.12-rc4-mm2-lttng-0.4 make
 KERNELDIR=/usr/src/linux-2.6.12-rc4-mm2-lttng-0.4 make modules_install
 
 You need to load the ltt-control module to be able to control tracing from user
 space. This is done by issuing the command :
+
 modprobe ltt-control
 
 You can automate at boot time loading the ltt-control module by :
+
 echo ltt-control >> /etc/modules