2018-06-26

GDB vs. LLDB

执行命令（EXECUTION COMMANDS）

执行程序（无参数）

1
2
3

(gdb) run                          | (lldb) process launch
(gdb) r                            | (lldb) run
                                   | (lldb) r

带参数执行程序

$ gdb --args a.out 1 2 3           | $ lldb -- a.out 1 2 3
(gdb) run <args>                   | (lldb) process launch -- <args>
(gdb) r <args>                     | (lldb) r <args>
# 或
(gdb) set args 1 2 3               | (lldb) settings set target.run-args 1 2 3
(gdb) run                          | (lldb) run

在程序运行前设置环境变量

(gdb) set env DEBUG 1              | (lldb) settings set target.env-vars DEBUG=1
                                   | (lldb) set se target.env-vars DEBUG=1
                                     | (lldb) env
# 运行程序时并设置环境变量
                                   | (lldb) process launch -v DEBUG=1

在程序运行前删除环境变量

1 2	(gdb) unset env DEBUG \| (lldb) settings remove target.env-vars DEBUG \| (lldb) set rem target.env-vars DEBUG

显示程序运行时的参数

1 2	(gdb) show args \| (lldb) settings show target.run-args

附加现有进程

# 根据进程ID号
(gdb) attach 123                   | (lldb) process attach --pid 123
                                   | (lldb) attach -p 123
# 根据进程名称
(gdb) attach a.out                 | (lldb) process attach --name a.out
                                   | (lldb) pro at -n a.out
# 根据进程名称并等待运行
(gdb) attach --waitfor a.out       | (lldb) process attach --name a.out --waitfor
                                   | (lldb) pro at -n a.out -w
# 附加到远程支持GDB协议指定地址的进程
(gdb) target remote eorgadd:8000   | (lldb) gdb-remote eorgadd:8000
# 附加到本机支持GDB协议指定地址的进程
(gdb) target remote localhost:8000 | (lldb) gdb-remote 8000
# Attach to a Darwin kernel in kdp mode on system "eorgadd".
(gdb) kdp-reattach eorgadd         | (lldb) kdp-remote eorgadd

调试步骤

# 进入代码级单步调试（当前线程）
(gdb) step                         | (lldb) thread step-in
(gdb) s                            | (lldb) step
                                   | (lldb) s
# 结束代码级单步调试（当前线程）
(gdb) next                         | (lldb) thread step-over
(gdb) n                            | (lldb) next
                                   | (lldb) n
# 进入指令级单步调试（当前线程）
(gdb) stepi                        | (lldb) thread step-inst
(gdb) si                           | (lldb) si
# 结束指令级单步调试（当前线程）
(gdb) nexti                        | (lldb) thread step-inst-over
(gdb) ni                           | (lldb) ni
# 跳出当前帧（frame）
(gdb) finish                       | (lldb) thread step-out
                                   | (lldb) finish
# 从当前帧立即返回，带可选参数
(gdb) return <RETURN EXPRESSION>   | (lldb) thread return <RETURN EXPRESSION>
# 运行函数直到12行或离开当前函数
(gdb) until 12                     | (lldb) thread until 12

断点命令（BREAKPOINT COMMANDS）

根据函数名设置断点

1
2
3

(gdb) break main                           | (lldb) breakpoint set --name main
                                           | (lldb) br s -n main
                                           | (lldb) b main

根据文件和行号设置断点

1
2
3

(gdb) break test.c:12                      | (lldb) breakpoint set --file test.c --line 12
                                           | (lldb) br s -f test.c -l 12
                                           | (lldb) b test.c:12

在C++中，设置所有basename为main处断点

1 2	(gdb) break main \| (lldb) breakpoint set --method main \| (lldb) br s -M main

根据函数名正则表达式

1 2	(gdb) rbreak <regular-expression> \| (lldb) breakpoint set --func-regex <regular-expression> \| (lldb) br s -r <regular-expression>

条件断点

1	(gdb) break foo if strcmp(y, "hello") == 0 \| (lldb) breakpoint set --name foo --condition '(int)strcmp(y, "hello") == 0'

显示所有断点

1 2	(gdb) info break \| (lldb) breakpoint list \| (lldb) br l

删除断点

1 2	(gdb) delete 1 \| (lldb) breakpoint delete 1 \| (lldb) br del 1

监视点命令（WATCHPOINT COMMANDS）

在待写变量设置一个监视点

(gdb) watch global_var           | (lldb) watchpoint set variable global_var
                                 | (lldb) wa s v global_var
(gdb) watch -location g_char_ptr | (lldb) watchpoint set expression -- my_ptr
                                 | (lldb) wa s e -- my_ptr

设置条件监视点

1 2	\| (lldb) watch set var global \| (lldb) watchpoint modify -c '(global==5)'

显示所有监视点

1 2	(gdb) info break \| (lldb) watchpoint list \| (lldb) watch l

删除监视点

1 2	(gdb) delete 1 \| (lldb) watchpoint delete 1 \| (lldb) watch del 1

检查变量（EXAMINING VARIABLES）

显示运行参数或当前帧本地变量

(gdb) info args    | (lldb) frame variable
(gdb) info locals  | (lldb) fr v
                   | (lldb) frame variable --no-args
                   | (lldb) fr v -a

打印变量

1
2
3

(gdb) p bar        | (lldb) frame variable bar
                   | (lldb) fr v bar
                   | (lldb) p bar

打印变量（16进制）

1 2	(gdb) p/x bar \| (lldb) frame variable --format x bar \| (lldb) fr v -f x bar

打印全局变量

1 2	(gdb) p baz \| (lldb) target variable baz \| (lldb) ta v baz

打印当前源文件中所有的全局或静态变量
1
2
| (lldb) target variable
| (lldb) ta v

每次停下来的时候打印变量

(gdb) display argc | (lldb) target stop-hook add --one-liner "frame variable argc argv"
(gdb) display argv | (lldb) ta st a -o "fr v argc argv"
                   | (lldb) display argc
                   | (lldb) display argv

仅当在指定函数中停下来的时候才打印变量

1 2	\| (lldb) target stop-hook add --name main --one-liner "frame variable argc argv" \| (lldb) ta st a -n main -o "fr v argc argv"

在指定类名中停下来的时候打印 `*this` 变量

1 2	\| (lldb) target stop-hook add --classname MyClass --one-liner "frame variable this" \| (lldb) ta st a -c MyClass -o "fr v this"

执行表达式（EVALUATING EXPRESSIONS）

在当前帧执行表达式

1
2

(gdb) print (int)printf("Print nine: %d.", 4 + 5) | (lldb) expr (int)printf("Print nine: %d.", 4 + 5)
(gdb) call (int)printf("Print nine: %d.", 4 + 5)  | (lldb) print (int)printf("Print nine: %d.", 4 + 5)

创建变量并赋值

(gdb) set $foo  = 5                               | # 在 lldb 中执行在 C 语言中的表达式即可
(gdb) set variable $foo = 5                       | (lldb) expr unsigned int $foo = 5
(gdb) print $foo = 5                              |
(gdb) call $foo = 5                               |
# 指定变量类型
(gdb) set $foo = (unsigned int) 5                 |

调用一个包含断点的函数并停下来

1 2	(gdb) set unwindonsignal 0 \| (lldb) expr -i 0 -- function_which_breakpoint() (gdb) p function_which_breakpoint() \|

调用会跪的函数并停下来

1 2	(gdb) set unwindonsignal 0 \| (lldb) expr -u 0 -- function_which_crashes() (gdb) p function_which_crashes() \|

检查线程状态

显示当前程序线程

1	(gdb) info threads \| (lldb) tread list

选择线程

1 2	(gdb) thread 1 \| (lldb) thread select 1 \| (lldb) t 1

显示当前线程堆栈

1 2	(gdb) bt \| (lldb) thread backtrace \| (lldb) bt

显示所有线程的堆栈信息

1 2	(gdb) thread apply all bt \| (lldb) thread backtrace all \| (lldb) bt all

显示当前线程前N帧堆栈信息

1
2
3

(gdb) bt 5                           | (lldb) thread backtrace -c 5
                                     | (lldb) bt 5 # (lldb >= 169)
                                     | (lldb) bt -c 5 # (lldb >= 168)

通过索引选择指定不通栈帧

1
2
3

(gdb) frame 12                       | (lldb) frame set 12
                                     | (lldb) fr s 12
                                     | (lldb) f 12

显示当前栈帧信息
1
| (lldb) frame info

选择调用当前栈帧的帧

1 2	(gdb) up \| (lldb) up (gdb) up 2 \| (lldb) frame select --relative=1

选择被当前栈帧调用的帧

1
2
3

(gdb) down                           | (lldb) down
(gdb) down 3                         | (lldb) frame select --relative=-3
                                     | (lldb) fr s -r=-1

显示当前线程通用寄存器

1	(gdb) info registers \| (lldb) register read

修改当前线程寄存器

1	(gdb) p $rax = 123 \| (lldb) register write rax 123

修改当前线程指令

1	(gdb) jump *$pc+8 \| (lldb) register write pc `$pc+8`

显示当前线程所有寄存器

1 2	(gdb) info all-registers \| (lldb) register read --all \| (lldb) re r -a

显示当前线程指定寄存器

1	(gdb) info all-registers rax rsp rbp \| register read rax rsp rbp

用二进制显示当前线程寄存器

(gdb) p/t $rax                       | (lldb) register read --format binary rax
                                     | (lldb) re r -f b rax
                                     | (lldb) register read/t rax
                                     | (lldb) p/t $rax

反汇编当前栈帧的当前函数

1 2	(gdb) disassemble \| (lldb) disassemble --frame \| (lldb) di -f

反汇编指定函数

1 2	(gdb) disassemble main \| (lldb) disassemble --name main \| (lldb) di -n main

反汇编指定地址

1 2	(gdb) disassemble 0x1eb8 0x1ec3 \| (lldb) disassemble --start-address 0x1eb8 --end-address 0x1ec3 \| (lldb) disassemble -s 0x1eb8 -e 0x1ec3

反汇编N条指令

1 2	(gdb) x/20i 0x1eb8 \| (lldb) disassemble --start-address 0x1eb8 --count 20 \| (lldb) di -s 0x1eb8 -c 20

显示源码及反汇编结果

1 2	\| (lldb) disassemble --frame --mixed \| (lldb) di -f -m

显示反汇编字节码(opcode bytes)

1 2	\| (lldb) disassemble --frame --bytes \| (lldb) di -f -b

反汇编当前行

1 2	\| (lldb) disassemble --line \| (lldb) di -l

共享库查询命令（EXECUTABLE AND SHARED LIBRARY QUERY COMMANDS）

显示依赖
1
(gdb) info shared | (lldb) image list

其他（MISCELLANEOUS）

帮助命令

1	(gdb) apropos keyword \| (lldb) apropos keyword

输出

1	(gdb) echo Here is some text\n \| (lldb) script print "Here is some text"

重新映射源码文件路径

1 2	(gdb) set pathname-substitutions /buildbot/path /my/path \| (lldb) settings set target.source-map /buildbot/path /my/path (gdb) directory \|

执行命令（EXECUTION COMMANDS）

执行程序（无参数）

带参数执行程序

在程序运行前设置环境变量

在程序运行前删除环境变量

显示程序运行时的参数

附加现有进程

调试步骤

断点命令（BREAKPOINT COMMANDS）

根据函数名设置断点

根据文件和行号设置断点

在C++中，设置所有basename为main处断点

根据函数名正则表达式

条件断点

显示所有断点

删除断点

监视点命令（WATCHPOINT COMMANDS）

在待写变量设置一个监视点

设置条件监视点

显示所有监视点

删除监视点

检查变量（EXAMINING VARIABLES）

显示运行参数或当前帧本地变量

打印变量

打印变量（16进制）

打印全局变量

打印当前源文件中所有的全局或静态变量

每次停下来的时候打印变量

仅当在指定函数中停下来的时候才打印变量

在指定类名中停下来的时候打印 *this 变量

执行表达式（EVALUATING EXPRESSIONS）

在当前帧执行表达式

创建变量并赋值

调用一个包含断点的函数并停下来

调用会跪的函数并停下来

检查线程状态

显示当前程序线程

选择线程

显示当前线程堆栈

显示所有线程的堆栈信息

显示当前线程前N帧堆栈信息

通过索引选择指定不通栈帧

显示当前栈帧信息

选择调用当前栈帧的帧

选择被当前栈帧调用的帧

显示当前线程通用寄存器

修改当前线程寄存器

修改当前线程指令

显示当前线程所有寄存器

显示当前线程指定寄存器

用二进制显示当前线程寄存器

反汇编当前栈帧的当前函数

反汇编指定函数

反汇编指定地址

反汇编N条指令

显示源码及反汇编结果

显示反汇编字节码(opcode bytes)

反汇编当前行

共享库查询命令（EXECUTABLE AND SHARED LIBRARY QUERY COMMANDS）

显示依赖

其他（MISCELLANEOUS）

帮助命令

输出

重新映射源码文件路径

在指定类名中停下来的时候打印 `*this` 变量