X-Git-Url: http://git.liburcu.org/?a=blobdiff_plain;f=trunk%2Flttv%2FQUICKSTART.html;h=daef794ced08652e46c3190369d27599ab89c510;hb=6f88b01deacc64482fff0251775cb5c4f329c1a0;hp=ea3abb30f3aec043339d29da879306647058ee88;hpb=bc58079d672530f653466e507930d6e90474f752;p=lttv.git
diff --git a/trunk/lttv/QUICKSTART.html b/trunk/lttv/QUICKSTART.html
index ea3abb30..daef794c 100644
--- a/trunk/lttv/QUICKSTART.html
+++ b/trunk/lttv/QUICKSTART.html
@@ -17,6 +17,17 @@ Last update : January 21st, 2009
-
Tools needed to follow the package download steps : @@ -130,7 +141,7 @@ href="http://ltt.polymtl.ca/svn/trunk/lttv/doc/developer/lttng-lttv-compatibilit versions compatibility
su - @@ -142,7 +153,7 @@ bzip2 -cd patch-2.6.X-lttng-0.x.xx.tar.bz2 | tar xvof --
su - @@ -158,7 +169,7 @@ mv linux-2.6.X linux-2.6.X-lttng-0.x.xx-
su - @@ -215,7 +226,8 @@ Select the Linux 2.6.X-lttng-0.x.xx kernel in your boot loader. ---
You must activate debugfs and specify a mount point. This is typically done in @@ -290,7 +302,9 @@ echo trap-trace >> /etc/modules #echo lockdep-trace >> /etc/modules -
(note : the ltt-control package contains lttd and lttctl. Although it has the same name as the ltt-control kernel module, they are *not* the same thing.) @@ -308,7 +322,7 @@ make make install -
Make sure you selected the kernel menuconfig option : @@ -324,8 +338,9 @@ channel : userspace event name : event-
su - @@ -340,16 +355,10 @@ make make install-
-See markers-userspace-0.5.tar.bz2 or more recent. -
@@ -446,42 +455,67 @@ lttctl -C -w /tmp/trace3 -o channel.all.overwrite=1 trace3 lttctl -D -w /tmp/trace3 trace3-************************************************************** -** Section 4 * Adding new instrumentations with the markers ** -************************************************************** +
+ +
See Documentation/markers.txt and Documentation/tracepoints.txt in your kernel tree. -* Add new events to userspace programs with userspace markers -http://ltt.polymtl.ca/packages/ +
Get the latest markers-userspace-*.tar.bz2 and see the Makefile and examples. It allows inserting markers in executables and libraries, currently only on x86_32 and x86_64. +See markers-userspace-0.5.tar.bz2 or more recent. -*********************************************************** -** Section 5 * Creating Debian or RPM packages ** -*********************************************************** +
+Note that a new design document for a 3rd generation of tracepoint/marker-based +userspace tracing is available at LTTng User-space Tracing +Design". This new infrastructure is not yet implemented. -* Create custom LTTV Debian packages +
+The easy quick-and-dirty way to perform userspace tracing is currently to write +an string to /mnt/debugfs/ltt/write_event. See Userspace tracing in the +installation for sources section of this document. -Use : dpkg-buildpackage -rfakeroot +
-* Create custom LTTng packages +
+Use : dpkg-buildpackage -rfakeroot ++
+You should then have your LTTV .deb files created for your architecture. -Get the build tree with patches applies as explained in section 2. +
+For building LTTng Debian packages : +get the build tree with patches applies as explained in section 2. +
make menuconfig (or xconfig or config) (customize your configuration) make-kpkg kernel_image - ++
You will then see your freshly created .deb in /usr/src. Install it with +
dpkg -i /usr/src/(image-name).deb - ++
Then, follow the section "Editing the system wide configuration" in section 2.