summaryrefslogtreecommitdiffstats
path: root/runtime/lket/b2a/README
diff options
context:
space:
mode:
Diffstat (limited to 'runtime/lket/b2a/README')
-rw-r--r--runtime/lket/b2a/README48
1 files changed, 48 insertions, 0 deletions
diff --git a/runtime/lket/b2a/README b/runtime/lket/b2a/README
new file mode 100644
index 00000000..004cc640
--- /dev/null
+++ b/runtime/lket/b2a/README
@@ -0,0 +1,48 @@
+b2a: a binary2ascii converter for LKET
+
+It is used to convert the binary trace data generated by systemtap
+with LKET into readable data in ascii format.
+
+It uses the pre-cpu binary trace data files as inputs, and generates
+an output file named "lket.out". You can use "stap -b -M" with LKET
+to get those pre-cpu files (stpd_cpu*) before using it.
+
+How to build:
+ gcc -O2 -o b2a lket_b2a.c
+
+How to use:
+ ./b2a stpd_cpuX [stpd_cpuY ...]
+ or
+ ./b2a stpd_cpu*
+
+The following is a typical output of b2a:
+
+LKET Magic: 0xAEFCDB6B
+InitHdrLen: 4
+Version Major: 0
+Version Minor: 1
+Big endian: YES
+Bits width: 2
+0.0 App1[PID:24456 PPID:24371 TID:24456] CPU:3 HOOKGRP:2 HOOKID:1 HOOKDATA:0 swapper
+0.3 App1[PID:24456 PPID:24371 TID:24456] CPU:3 HOOKGRP:2 HOOKID:1 HOOKDATA:1 init
+...
+0.723810 App9[PID:3345 PPID:1 TID:3345] CPU:7 HOOKGRP:1 HOOKID:1 HOOKDATA:sys_gettimeofday
+0.723814 App9[PID:3345 PPID:1 TID:3345] CPU:7 HOOKGRP:1 HOOKID:2 HOOKDATA:sys_gettimeofday
+0.723820 App9[PID:3345 PPID:1 TID:3345] CPU:7 HOOKGRP:1 HOOKID:1 HOOKDATA:sys_poll
+0.723837 App9[PID:3345 PPID:1 TID:3345] CPU:7 HOOKGRP:4 HOOKID:2 HOOKDATA:3345 c0000000004418c4 c000000007400040 c0000000004418b4 c0000000004433cc c0000000000cce80 c00000000002a408 80d0b2154c 80d2da7b40
+...
+36.365564 App35[PID:24491 PPID:18767 TID:24491] CPU:3 HOOKGRP:6 HOOKID:1 HOOKDATA:268585192 0
+36.365571 App35[PID:24491 PPID:18767 TID:24491] CPU:3 HOOKGRP:1 HOOKID:1 HOOKDATA:compat_sys_execve
+36.365579 App35[PID:24491 PPID:18767 TID:24491] CPU:3 HOOKGRP:2 HOOKID:2 HOOKDATA:/bin/ls
+...
+37.495705 App35[PID:24491 PPID:18767 TID:24491] CPU:4 HOOKGRP:1 HOOKID:1 HOOKDATA:sys_getdents64
+37.495730 App35[PID:24491 PPID:18767 TID:24491] CPU:4 HOOKGRP:3 HOOKID:2 HOOKDATA:anticipatory 8 0
+37.495738 App35[PID:24491 PPID:18767 TID:24491] CPU:4 HOOKGRP:3 HOOKID:1 HOOKDATA:anticipatory -1 -1
+37.495769 App35[PID:24491 PPID:18767 TID:24491] CPU:4 HOOKGRP:5 HOOKID:1 HOOKDATA:8 0 2 c0000000002fd8dc c000000002a52d48 c0000000001f160c
+37.495775 App35[PID:24491 PPID:18767 TID:24491] CPU:4 HOOKGRP:5 HOOKID:1 HOOKDATA:8 0 2
+37.495784 App35[PID:24491 PPID:18767 TID:24491] CPU:4 HOOKGRP:5 HOOKID:2 HOOKDATA:2 1 2 -4611686018331225216 4096 45812
+...
+37.516707 App32[PID:18763 PPID:3079 TID:18763] CPU:5 HOOKGRP:7 HOOKID:2 HOOKDATA:eth0 106 2048 1880
+...
+37.517938 App4[PID:0 PPID:1 TID:0] CPU:1 HOOKGRP:7 HOOKID:1 HOOKDATA:eth0 46 2048 728
+...