From: compudj <compudj@04897980-b3bd-0310-b5e0-8ef037075253>
Date: Fri, 16 Sep 2005 16:56:31 +0000 (+0000)
Subject: genevent readme
X-Git-Tag: v0.12.20~2276
X-Git-Url: http://git.lttng.org./?a=commitdiff_plain;h=bf431ad1289ad6c43471f2949b0eb544cd35c1ad;p=lttv.git

genevent readme

git-svn-id: http://ltt.polymtl.ca/svn@1213 04897980-b3bd-0310-b5e0-8ef037075253
---

diff --git a/genevent/README b/genevent/README
index 9b34bf42..182fbf05 100644
--- a/genevent/README
+++ b/genevent/README
@@ -1,3 +1,6 @@
+
+Mathieu Desnoyers -- September 2005
+
 The 'genevent' program parses event descriptions and generates 
 the inline functions to record events in the kernel.
 
@@ -12,3 +15,28 @@ those in LTT library.
 
 'core.xml' is an example event description file.
 
+Here is a brief description of how to use genevent.
+
+make
+make install
+
+
+* Add new events to the kernel with genevent
+
+su -
+cd /usr/local/share/LinuxTraceToolkitViewer/facilities
+cp process.xml yourfacility.xml
+  * edit yourfacility.xml to fit your needs.
+cd /tmp
+/usr/local/bin/genevent /usr/local/share/LinuxTraceToolkitViewer/yourfacility.xml
+cp ltt-facility-yourfacility.h ltt-facility-id-yourfacility.h \
+         /usr/src/linux-2.6.12-rc4-mm2-lttng-0.2/include/linux/ltt
+cp ltt-facility-loader-yourfacility.c ltt-facility-loader-yourfacility.h \
+         /usr/src/linux-2.6.12-rc4-mm2-lttng-0.2/ltt
+  * edit the kernel file you want to instrument
+    - Add #include <linux/ltt/ltt-facility-yourfacility.h> at the beginning
+      of the file.
+    - Add a call to the tracing functions. See their names and parameters in
+      /usr/src/linux-2.6.12-rc4-mm2-lttng-0.2/include/linux/ltt/ltt-facility-yourfacility.h
+
+