genevent-new/README

   1
   2 Mathieu Desnoyers -- November 2005
   3
   4 This is a complete rework of genevent.
   5
   6 The 'genevent' program parses event descriptions and generates
   7 the inline functions to record events in the kernel.
   8
   9 There are several files in the directory:
  10  genevent.c, genevent.h, crc32.tab, parser.c and parser.h
  11
  12 In fact, crc32.tab, parser.c and parser.h are the same files as
  13 those in LTT library.
  14
  15 Here is a brief description of how to use genevent.
  16
  17 make
  18 make install
  19
  20
  21 * Add new events to the kernel with genevent
  22
  23 su -
  24 cd /usr/local/share/LinuxTraceToolkitViewer/facilities
  25 cp process.xml yourfacility.xml
  26   * edit yourfacility.xml to fit your needs.
  27 cd /tmp
  28 /usr/local/bin/genevent /usr/local/share/LinuxTraceToolkitViewer/yourfacility.xml
  29 cp ltt-facility-yourfacility.h ltt-facility-id-yourfacility.h \
  30          /usr/src/linux-2.6.12-rc4-mm2-lttng-0.2/include/linux/ltt
  31 cp ltt-facility-loader-yourfacility.c ltt-facility-loader-yourfacility.h \
  32          /usr/src/linux-2.6.12-rc4-mm2-lttng-0.2/ltt
  33   * edit the kernel file you want to instrument
  34     - Add #include <linux/ltt/ltt-facility-yourfacility.h> at the beginning
  35       of the file.
  36     - Add a call to the tracing functions. See their names and parameters in
  37       /usr/src/linux-2.6.12-rc4-mm2-lttng-0.2/include/linux/ltt/ltt-facility-yourfacility.h
  38
  39