kprobe/README

   1 ########################################
   2 ## ELP2 KProbe Dynamically Loaded Module
   3 ########################################
   4
   5 1. Overview
   6         ELP2 KProbe Module provides dynamic enabling of KProbe facilities on the current platform,
   7         eliminating the necessity of according Linux kernel patches.
   8         Supports the following architectures:
   9                 a) ARM (OMAP 5912 OSK, MV320-LCD)
  10                 b) MIPS (DTV x260, DMB2 AMD)
  11         Runs on Linux kernel 2.6.10 - 2.6.21.
  12
  13 2. Installation
  14         a) Extract files from installation archive "elp2-kprobe-dynamic.tgz"
  15                 into desired location.
  16         b) Find the following files:
  17                 asm/kprobe.h    - architecture specific header file
  18                 kprobes_arch.c  - architecture specific source code
  19                 kprobe.h        - header file
  20                 kprobes.c       - source code
  21                 build_arm       - example of how to compile the module for OMAP 5912 OSK
  22                 build_cosmos    - example of how to compile the module for MV320-LCD
  23                 build_dtv_x260  - example of how to compile the module for DTV x260
  24                 build_mips      - example of how to compile the module for DMB2 AMD
  25                 README          - this file
  26         c) Execute the following command to compile the module:
  27                 make ARCH=[arm, mips] CROSS_COMPILE=[/opt/...] KERNELDIR=[/opt/...]
  28         d) Copy the output file "elp_kprobes.ko" to the target filesystem.
  29
  30 3. Usage
  31         a) Find out the address [XXX] of function "kallsyms_lookup_name":
  32                 cat /proc/kallsyms > kallsyms.txt
  33         b) Execute the pointed command to load the module into memory:
  34                 insmod elp_kprobes.ko ksyms=0x[XXX]
  35
  36         Now, KProbe facilities are enabled to requestors.