X-Git-Url: http://git.lttng.org./?a=blobdiff_plain;f=ltt%2Fbranches%2Fpoly%2FQUICKSTART;h=8fe0b5f5a42f890e5a6d785087976de29051d9c3;hb=916ec268f37ffaa360642b249d08f011d078cdec;hp=426fc711afc166c64d996240e8cfa0fd29ac0aa8;hpb=4408c54cb1cd82f1418283cad5a050825aefbfda;p=lttv.git diff --git a/ltt/branches/poly/QUICKSTART b/ltt/branches/poly/QUICKSTART index 426fc711..8fe0b5f5 100644 --- a/ltt/branches/poly/QUICKSTART +++ b/ltt/branches/poly/QUICKSTART @@ -3,12 +3,36 @@ QUICKSTART How to use LTTng and LTTV in a few lines : +This document is made of four parts : The first one explains how to install +LTTng and LTTV from Debian and RPM binary packages, the second one explains how +to install LTTng and LTTV from sources and the third one describes the steps +to follow to trace a system and view it. The fourth and last part explains +briefly how to add a new trace point to the kernel. + +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. + These operations are made for installing LTTng 0.2 on a linux 2.6.12-rc2-mm2 kernel. Change the versions to fit your needs. Author : Mathieu Desnoyers, September 2005 + +*********************************************************** +** Section 1 * Installation from Debian or RPM packages ** +*********************************************************** + +No Debian or RPM packages are ready yet. + +TODO + + +*********************************************************** +** Section 2 * Installation from sources ** +*********************************************************** + * Getting the LTTng packages su - @@ -49,6 +73,10 @@ make menuconfig make make install make modules_install + +Depending on your boot loader, you may want to execute : +update-grub or lilo + reboot @@ -77,7 +105,14 @@ cd LinuxTraceToolkitViewer-0.5-16092005 make make install -* Use LTTV + + + +*********************************************************** +** Section 3 * Using LTTV ** +*********************************************************** + +* Use graphical LTTV lttv-gui (or /usr/local/bin/lttv-gui) - Spot the "Trace Control" icon : click on it @@ -87,6 +122,23 @@ lttv-gui (or /usr/local/bin/lttv-gui) - Yes * You should now see a trace +* Use text mode LTTV + +Fell free to look in /usr/local/lib/lttv/plugins to see all the text and +graphical plugins available. + +For example, a simple trace dump in text format is available with : + +lttv -m textDump -t /tmp/trace + +see lttv -m textDump --help for detailed command line options of textDump. + + + + +*********************************************************** +** Section 4 * Adding new instrumentations with genevent ** +*********************************************************** * Getting and installing genevent