X-Git-Url: http://git.lttng.org./?a=blobdiff_plain;f=genevent%2FREADME;h=6db1503004a42c8e4e3e7261971e34dfb9312c7f;hb=2d097aba294e1ce388f16b54f5b488d0d138abc8;hp=9b34bf42245a2cad534ebb227f6c4c27b4acf6b9;hpb=3888436ce256d6b48f9354006a2acc8a25fb6889;p=lttv.git

diff --git a/genevent/README b/genevent/README
index 9b34bf42..6db15030 100644
--- a/genevent/README
+++ b/genevent/README
@@ -1,9 +1,15 @@
+
+Mathieu Desnoyers -- September 2005
+
 The 'genevent' program parses event descriptions and generates 
 the inline functions to record events in the kernel.
 
 Right now, the program can only parse simple structure, if a 
 structure has a nested structure, it will not work.
 
+Genevent will soon go through a rewrite, but for now, the strings should be put
+*** AT THE END *** of a structure : they will be put there anyways.
+
 There are several files in the directory:
  genevent.c, genevent.h, crc32.tab, parser.c and parser.h
 
@@ -12,3 +18,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
+
+