lldb: add llgo plugin

2024-09-20 23:40:13 +08:00
parent f71e34fd9f
commit 6adecbd7aa
4 changed files with 409 additions and 4 deletions
--- a/_lldb/README.md
+++ b/_lldb/README.md
@@ -0,0 +1,124 @@
+## LLGo Plugin of LLDB
+
+### Build with debug info
+
+```shell
+llgo build -o cl/_testdata/debug/out -dbg ./cl/_testdata/debug
+```
+
+### Debug with lldb
+
+```shell
+lldb -O "command script import _lldb/llgo_plugin.py" ./cl/_testdata/debug/out
+```
+
+```lldb
+/opt/homebrew/bin/lldb -O "command script import _lldb/llgo_plugin.py" ./cl/_testdata/debug/out
+Breakpoint 1: no locations (pending).
+Breakpoint set in dummy target, will get copied into future targets.
+(lldb) command script import _lldb/llgo_plugin.py
+(lldb) target create "./cl/_testdata/debug/out"
+Current executable set to '/Users/lijie/source/goplus/llgo/cl/_testdata/debug/out' (arm64).
+(lldb) r
+Process 16088 launched: '/Users/lijie/source/goplus/llgo/cl/_testdata/debug/out' (arm64)
+globalInt: 301
+s: 0x100123e40
+0x100123be0
+5 8
+called function with struct
+1 2 3 4 5 6 7 8 9 10 +1.100000e+01 +1.200000e+01 true (+1.300000e+01+1.400000e+01i) (+1.500000e+01+1.600000e+01i) [3/3]0x1001129a0 [3/3]0x100112920 hello 0x1001149b0 0x100123ab0 0x100123d10 0x1001149e0 (0x100116810,0x1001149d0) 0x10011bf00 0x10010fa80 (0x100116840,0x100112940) 0x10001b4a4
+9
+1 (0x1001167e0,0x100112900)
+called function with types
+0x100123e40
+0x1000343d0
+Process 16088 stopped
+* thread #1, queue = 'com.apple.main-thread', stop reason = breakpoint 1.1
+    frame #0: 0x000000010001b3b4 out`main at in.go:225:12
+   222 		//   s.i8: '\x01'
+   223 		//   s.i16: 2
+   224 		s.i8 = 0x12
+-> 225 		println(s.i8)
+   226 		// Expected:
+   227 		//   all variables: globalInt globalStruct globalStructPtr s i err
+   228 		//   s.i8: '\x12'
+(lldb) v
+var i int = <variable not available>
+var s github.com/goplus/llgo/cl/_testdata/debug.StructWithAllTypeFields = {
+  i8: '\x12',
+  i16: 2,
+  i32: 3,
+  i64: 4,
+  i: 5,
+  u8: '\x06',
+  u16: 7,
+  u32: 8,
+  u64: 9,
+  u: 10,
+  f32: 11,
+  f64: 12,
+  b: true,
+  c64: { real: 13, imag: 14 },
+  c128: { real: 15, imag: 16 },
+  slice: []int{
+    21, 22, 23
+  },
+  arr: [3]int{
+    24, 25, 26,
+  },
+  arr2: [3]github.com/goplus/llgo/cl/_testdata/debug.E{
+    { i: 27 }, { i: 28 }, { i: 29 },
+  },
+  s: "hello",
+  e: { i: 30 },
+  pf: 0x0000000100123d10,
+  pi: 0x00000001001149e0,
+  intr: { type: 0x0000000100116810, data: 0x00000001001149d0 },
+  m: { count: 4296130304 },
+  c: {  },
+  err: { type: 0x0000000100116840, data: 0x0000000100112940 },
+  fn: { f: 0x000000010001b4a4, data: 0x00000001001149c0 },
+  pad1: 100,
+  pad2: 200,
+}
+var globalStructPtr *github.com/goplus/llgo/cl/_testdata/debug.StructWithAllTypeFields = <variable not available>
+var globalStruct github.com/goplus/llgo/cl/_testdata/debug.StructWithAllTypeFields = {
+  i8: '\x01',
+  i16: 2,
+  i32: 3,
+  i64: 4,
+  i: 5,
+  u8: '\x06',
+  u16: 7,
+  u32: 8,
+  u64: 9,
+  u: 10,
+  f32: 11,
+  f64: 12,
+  b: true,
+  c64: { real: 13, imag: 14 },
+  c128: { real: 15, imag: 16 },
+  slice: []int{
+    21, 22, 23
+  },
+  arr: [3]int{
+    24, 25, 26,
+  },
+  arr2: [3]github.com/goplus/llgo/cl/_testdata/debug.E{
+    { i: 27 }, { i: 28 }, { i: 29 },
+  },
+  s: "hello",
+  e: { i: 30 },
+  pf: 0x0000000100123d10,
+  pi: 0x00000001001149e0,
+  intr: { type: 0x0000000100116810, data: 0x00000001001149d0 },
+  m: { count: 4296130304 },
+  c: {  },
+  err: { type: 0x0000000100116840, data: 0x0000000100112940 },
+  fn: { f: 0x000000010001b4a4, data: 0x00000001001149c0 },
+  pad1: 100,
+  pad2: 200,
+}
+var globalInt int = 301
+var err error = { type: 0x0000000100112900, data: 0x000000000000001a }
+```