X-Git-Url: http://git.liburcu.org/?a=blobdiff_plain;f=trunk%2Flttv%2FQUICKSTART.html;h=98079c7accc37a1a67e39b68a7d161def55ecb8a;hb=df7f63ab9e7699a88909ba141753bdaf90b95df6;hp=350a606b4bd4366408130ff519c6d64e82b00ff0;hpb=aa94f49e44e29afd35da059d0a2bed8daa7c5ee7;p=lttv.git diff --git a/trunk/lttv/QUICKSTART.html b/trunk/lttv/QUICKSTART.html index 350a606b..98079c7a 100644 --- a/trunk/lttv/QUICKSTART.html +++ b/trunk/lttv/QUICKSTART.html @@ -34,7 +34,6 @@ to follow to trace a system and view it. The third part explains briefly how to add a new trace point to the kernel and to user space applications. The fourth and last part explains how to create Debian or RPM packages from the LTTng and LTTV sources. -

These operations are made for installing the LTTng 0.86 tracer on a linux 2.6.X kernel. You will also find instructions for installation of LTTV 0.12.x : the @@ -338,11 +337,11 @@ system) ./configure make make install - +

  • Getting and installing the markers-userspace package for user space tracing (experimental)
  • - +

    See markers-userspace-0.5.tar.bz2 or more recent. @@ -352,13 +351,11 @@ href="http://ltt.polymtl.ca/packages/markers-userspace-0.5.tar.bz2">markers-user

    Using LTTng and LTTV

  • IMPORTANT : Arm Linux Kernel Markers after each boot
  • -
     ltt-armall
     
  • 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
    @@ -371,7 +368,6 @@ lttv-gui (or /usr/local/bin/lttv-gui)
     
  • Use text mode LTTng to control tracing
  • -
     The tracing can be controlled from a terminal by using the lttctl command (as
     root).
    @@ -385,8 +381,7 @@ Stop tracing and destroy trace channels :
     lttctl -D trace1
     
     see lttctl --help for details.
    -
    -
    +

    (note : to see if the buffers has been filled, look at the dmesg output after lttctl -R or after stopping tracing from the GUI, it will show an event lost @@ -400,14 +395,11 @@ Feel 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. -

    It is, in the current state of the project, very useful to use "grep" on the text output to filter by specific event fields. You can later copy the timestamp @@ -416,18 +408,15 @@ bottom right label "Current time". Support for this type of filtering should be added to the filter module soon.

  • Hybrid mode
  • -

    Starting from LTTng 0.5.105 and ltt-control 0.20, a new mode can be used : hybrid. It can be especially useful when studying big workloads on a long period of time. -

    When using this mode, the most important, low rate control information will be recorded during all the trace by lttd (i.e. process creation/exit). The high rate information (i.e. interrupt/traps/syscall entry/exit) will be kept in a flight recorder buffer (now named flight-channelname_X). -

    The following lttctl commands take an hybrid trace :

    @@ -444,15 +433,12 @@ lttctl -D -w /tmp/trace2 trace2 Each "overwrite" channel is flight recorder channel.

  • Flight recorder mode
  • -

    The flight recorder mode writes data into overwritten buffers for all channels, including control channels, except for the facilities tracefiles. It consists of setting all channels to "overwrite". -

    The following lttctl commands take a flight recorder trace : -

     lttctl -C -w /tmp/trace3 -o channel.all.overwrite=1 trace3
     ...