add relayfs

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

diff --git a/ltt/branches/poly/QUICKSTART b/ltt/branches/poly/QUICKSTART
index d5d5b8f89d66bea1430ddbaeffe17f4f2756d632..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,9 @@ echo ltt-control >> /etc/modules
 
 su -
 cd /usr/src
 
 su -
 cd /usr/src

-wget http://ltt.polymtl.ca/packages/LinuxTraceToolkitViewer-0.6.1-16092005.tar.gz
-gzip -cd LinuxTraceToolkitViewer-0.6.1-16092005.tar.gz | tar xvof -
-cd LinuxTraceToolkitViewer-0.6.1-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
 (refer to README to see the development libraries that must be installed on you
 system)
 ./configure


@@ -111,10 +116,10 @@ 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)
   - Spot the "Tracing Control" icon : click on it
 
 lttv-gui (or /usr/local/bin/lttv-gui)
   - Spot the "Tracing Control" icon : click on it


@@ -125,6 +130,21 @@ lttv-gui (or /usr/local/bin/lttv-gui)
     - Yes
       * You should now see a trace
 
     - 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