add relayfs

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

diff --git a/ltt/branches/poly/QUICKSTART b/ltt/branches/poly/QUICKSTART
index 8fe0b5f5a42f890e5a6d785087976de29051d9c3..e3c77cf31463c7e0cbc38accf337ba39b148d4e7 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 LTTng 0.2 on a linux 2.6.12-rc2-mm2
+These operations are made for installing LTTng 0.3 on a linux 2.6.12-rc2-mm2

 kernel. Change the versions to fit your needs.
 
 Author : Mathieu Desnoyers, September 2005
 kernel. Change the versions to fit your needs.
 
 Author : Mathieu Desnoyers, September 2005


@@ -74,6 +74,11 @@ make
 make install
 make modules_install
 
 make install
 make modules_install
 

+The first time you use relayfs, you have to specify a mount point in you system:
+mkdir /mnt/relayfs
+echo "relayfs         /mnt/relayfs    relayfs rw              0       0" \
+   >> /etc/fstab
+

 Depending on your boot loader, you may want to execute :
 update-grub or lilo
 
 Depending on your boot loader, you may want to execute :
 update-grub or lilo
 


@@ -98,9 +103,11 @@ echo ltt-control >> /etc/modules
 
 su -
 cd /usr/src
 
 su -
 cd /usr/src

-wget http://ltt.polymtl.ca/packages/LinuxTraceToolkitViewer-0.5-16092005.tar.gz
-gzip -cd LinuxTraceToolkitViewer-0.5-16092005.tar.gz | tar xvof -
-cd LinuxTraceToolkitViewer-0.5-16092005
+wget http://ltt.polymtl.ca/packages/LinuxTraceToolkitViewer-0.6.2-20092005.tar.gz
+gzip -cd LinuxTraceToolkitViewer-0.6.2-20092005.tar.gz | tar xvof -
+cd LinuxTraceToolkitViewer-0.6.2-20092005
+(refer to README to see the development libraries that must be installed on you
+system)

 ./configure
 make
 make install
 ./configure
 make
 make install


@@ -109,19 +116,35 @@ make install
 
 
 ***********************************************************
 
 
 ***********************************************************

-** Section 3 * Using LTTV                                **
+** Section 3 * Using LTTng and LTTV                      **

 ***********************************************************
 
 ***********************************************************
 

-* Use graphical LTTV
+* Use graphical LTTV to control tracing and analyse traces

 
 lttv-gui (or /usr/local/bin/lttv-gui)
 
 lttv-gui (or /usr/local/bin/lttv-gui)

-  - Spot the "Trace Control" icon : click on it
+  - Spot the "Tracing Control" icon : click on it
+      (it's a traffic light icon)

     - enter the root password
     - click "start"
     - click "stop"
     - Yes
       * You should now see a trace
 
     - enter the root password
     - click "start"
     - click "stop"
     - Yes
       * You should now see a trace
 

+* Use text mode LTTng to control tracing
+
+The tracing can be controlled from a terminal by using the lttctl command.
+
+Start tracing :
+
+lttctl -n trace -d -l /mnt/relayfs/ltt -t /tmp/trace1
+
+Stop tracing and destroy trace channels :
+
+lttctl -n trace -R
+
+see lttctl --help for details.
+
+

 * Use text mode LTTV
 
 Fell free to look in /usr/local/lib/lttv/plugins to see all the text and
 * Use text mode LTTV
 
 Fell free to look in /usr/local/lib/lttv/plugins to see all the text and