GDB 调试
-------------------------------------------------------------------------------
gdb 帮助文档
help -- 查看 gdb 的命令种类
help <CmdType> -- 查看 CmdType 种类的 gdb 命令
apropos <keyWord> -- 查看关键字 keyWord 的相关命令
info <keyWord> -- 查看关键字 keyWord 调试信息
show <keyWord> -- 查看关键字 keyWord gdb 本身设置信息
gdb 中运行 unix 的 shell 程序
shell <command string> -- 调用 unix 的 shell 来执行 <command string>,环境变量 shell 中定义的 unix 的 shell 将会被用来执行 <command string>,如果 shell 没有定义,那就使用 unix 的标准 shell：/bin/sh.(在 windows 中使用 command.com 或 cmd.exe)
make <make-args> -- 等价于 “shell make <make-args>”
历史记录
当你用 gdb 的 print 查看程序运行时的数据时,你每一个 print 都会被 gdb 记录下来.gdb 会以 $1, $2, $3 ...这样的方式为你每一个 print 命令编上号.于是,你可以使用这个编号访问以前的表达式,如 $1.这个功能所带来的好处是,如果你先前输入了一个比较长的表达式,如果你还想查看这个表达式的值,你可以使用历史记录来访问,省去了重复输入.
启动程序
run <arg ...> -- 启动程序,<arg ...> 为程序运行时候需要输入的参数.也可用 set args 命令去设置运行参数.简写为 r
--------------------------------------------------------------------------------
GDB 环境设置
gdb 设置
设置显示选项 地址 set print address <on/off> -- 打开地址输出,当程序显示函数信息时,gdb会显出函数的参数地址.系统默认为打开.
show print address -- 查看 print address 选项信息
数组元素单独行显示 set print array <on/off> -- 打开时数组显示时,每个元素占一行,如果不打开的话,每个元素则以逗号分隔.这个选项默认是关闭的.
show print array -- 查看 print array 选项信息
显示数组元素显示 set print elements <number-of-elements> -- 设置数组的显示的最大长度,设置为 0,则表示不限制.
show print elements -- 查看 print elements 选项信息.
设置字符串显示 set print null-stop <on/off> -- 如果打开那么当显示字符串时,遇到结束符则停止显示.这个选项默认为 off.
show print null-stop -- 查看 print null-stop 选项信息
设置结构体变量显示 set print pretty <on/off> -- 结构体优雅显示
show print pretty -- 查看 gdb 是如何显示结构体的.
设置字符显示 set print sevenbit-strings <on/off> -- 符显示,是否按“/nnn”的格式显示,如果打开,则字符串或字符数据按/nnn显示,如“/065”.
show print sevenbit-strings -- 查看字符显示开关是否打开.
设置联合体显示 set print union <on/off> -- 设置显示结构体时,是否显式其内的联合体数据.
show print union -- 查看联合体数据的显示方式
设置对象显示 set print object <on/off> -- 在 C++ 中,如果一个对象指针指向其派生类,如果打开这个选项,gdb 会自动按照虚方法调用的规则显示输出,如果关闭这个选项的话,gdb 就不管虚函数表了.这个选项默认是 off.
show print object -- 查看对象选项的设置.
设置静态成员显示 set print static-members <on/off> -- 这个选项表示,当显示一个 C++ 对象中的内容是,是否显示其中的静态数据成员.默认是 on.
show print static-members -- 查看静态数据成员选项设置.
设置虚函数表显示 set print vtbl <on/off> -- 当此选项打开时,gdb 将用比较规整的格式来显示虚函数表时.其默认是关闭的.
show print vtbl -- 查看虚函数显示格式的选项.
设置运行程序的相关环境及其参数 指定源文件的路径 directory <dirname ... > -- 加一个源文件路径到当前路径的前面.如果你要指定多个路径,UNIX 下你可以使用“:”,Windows 下你可以使用“;”.缩写 dir
directory -- 清除所有的自定义的源文件搜索路径信息.
show directories -- 显示定义了的源文件搜索路径.
运行参数 set args -- 可指定运行时参数
show args -- 命令可以查看设置好的运行参数
运行环境 path <dir> -- 可设定程序的运行路径
show paths -- 查看程序的运行路径
set environment varname=value -- 设置环境变量
show environment [varname] -- 查看环境变量
工作目录 cd <dir> -- 相当于shell的cd命令
pwd -- 显示当前的所在目录
程序的输入输出 info terminal -- 显示你程序用到的终端的模式
tty -- 命令可以指写输入输出的终端设备
重定向控制程序输出
堆栈帧设置 set backtrace <limit> -- 设置堆栈帧的最大显示数量,默认是没有限制
调试模式 set step-mode [on | off] -- step-mode 模式,于是,在进行单步跟踪时,程序不会因为没有debug信息而不停住.这个参数有很利于查看机器码.
--------------------------------------------------------------------------------
GDB 源码查看
显示源代码
list <linenum> -- 显示程序第 linenum 行的周围的源程序.
list <function> -- 显示函数名为 function 的函数的源程序.
list <filename:linenum> -- 哪个文件的哪一行.
list <filename:function> -- 哪个文件中的哪个函数.
list <offset> -- 当前行号的正/负 offset 偏移量那那行.
list -- 显示当前行后面的源程序.
list - -- 显示当前行前面的源程序.
list <first>, <last> -- 显示从 first 行到 last 行之间的源代码.若无 first 则显示从当前行到 last 之间的源代码.
设置和获得显示源码的行数
set listsize <count> -- 设置一次显示源代码的行数.
show listsize -- 查看当前listsize的设置.
搜索源代码
forward-search <regexp> -- 向后面搜索.正则表达式为 regexp 的关键字
search <regexp> -- 向后面搜索.正则表达式为 regexp 的关键字
reverse-search <regexp> -- 向前面搜索.正则表达式为 regexp 的关键字
源代码的内存
info line <linenum> -- 查看行号为 linenum 源代码在内存中的地址.
info line <function> -- 查看函数在源代码在内存中的地址.
info line <filename:linenum> -- 查看 filename 文件的第 linenum 行源代码在内存中的地址.
info line <filename:function> -- 查看 filename 文件的 function 函数在源代码在内存中的地址.
查看汇编代码
disassemble -- 查看源程序的当前执行时的机器码,这个命令会把目前内存中的指令 dump 出来.
--------------------------------------------------------------------------------
GDB 停止点设置及维护
断点(BreakPoint)
设置断点:(threadno 指定了线程的 ID,注意,这个 ID 是 gdb 分配的,可以通过 "info threads" 命令来查看正在运行程序中的线程信息) break thread <threadno> -- break命令没有参数时,表示在下一条指令处停住.
break +offset thread <threadno> -- 在当前行号的后面的 offset 行停住.(offiset 为自然数)
break -offset thread <threadno> -- 在当前行号的前面的 offset 行停住.(offiset 为自然数)
break <linenum> thread <threadno> -- 在指定行号停住.
break filename:linenum thread <threadno> -- 在源文件filename的linenum行处停住.
break <function> thread <threadno> -- 在进入指定函数时停住.
break filename:function thread <threadno> --在源文件filename的function函数的入口处停住.
break *address -- 在程序运行的内存地址处停住.
break ... thread <threadno> if <condition> -- ...可以是上述的参数,condition表示条件,在条件成立时停住.比如在循环境体中,可以设置break if i=100,表示当i为100时停住程序.
tbreak -- 设置只停止一次的断点.用法和 break 类似
查看断点 info breakpoints [n]
info break [n]
观察点(WatchPoint) -- 观察点一般来观察某个表达式(变量也是一种表达式)的值是否有变化了,如果有变化,马上停住程序.
设在观察点 watch <expr> -- 为表达式(变量)expr设置一个观察点.一量表达式值有变化时,马上停住程序.
rwatch <expr> -- 当表达式(变量)expr被读时,停住程序.
awatch <expr> -- 当表达式(变量)的值被读或被写时,停住程序.
查看观察点 info watchpoints -- 列出当前所设置了的所有观察点.
捕捉点(CatchPoint) -- 设置捕捉点来补捉程序运行时的一些事件.如:载入共享库(动态链接库)或是 C++ 的异常《/p>
设置捕捉点 catch <event> -- 当event发生时,停住程序.event可以是下面的内容： throw 一个 C++ 抛出的异常.(throw 为关键字)
catch 一个 C++ 捕捉到的异常.(catch 为关键字)
exec 调用系统调用 exec 时.(exec 为关键字,目前此功能只在 HP-UX 下有用)
fork 调用系统调用 fork 时.(fork 为关键字,目前此功能只在 HP-UX 下有用)
vfork 调用系统调用 vfork 时.(vfork 为关键字,目前此功能只在 HP-UX 下有用)
load 或 load <libname> 载入共享库(动态链接库)时.(load 为关键字,目前此功能只在 HP-UX 下有用)
unload 或 unload <libname> 卸载共享库(动态链接库)时.(unload 为关键字,目前此功能只在 HP-UX 下有用)
tcatch <event> -- 只设置一次捕捉点,当程序停住以后,应点被自动删除.
维护停止点
清除停止点 clear -- 所有的已定义的停止点.
clear <function> -- 清除所有设置在函数上的停止点.
clear <filename:function> -- 清除所有设置在函数上的停止点.
clear <linenum> -- 清除所有设置在指定行上的停止点.
clear <filename:linenum> -- 清除所有设置在指定行上的停止点.
删除停止点 delete [range] -- 删除停止点.其简写命令为 d.
禁用停止点 disable [range] -- 禁用停止点
启用停止点 enable [range] -- 启用停止点.
enable once [rang] -- 启用停止点一次,当程序停止后,该停止点马上被 gdb 自动 disable.
enable count [rang] -- 启用停止点 count 次,当程序停止后,该停止点马上被 gdb 自动 disable.
enable delete [rang] -- 启用停止点一次,当程序停止后,该停止点马上被 gdb 自动删除.
停止条件维护 -- 以用 condition 命令来修改断点的条件.(只有break和watch命令支持if,catch目前暂不支持if) condition <bnum> <expression> -- 修改断点号为bnum的停止条件为expression.
condition <bnum> -- 清除断点号为bnum的停止条件.
忽略停止点 N 次 ignore <bnum> <count> -- 表示忽略断点号为 bnum 的停止条件 count 次.
为停止点设定运行命令 格式:
commands [bnum]
... command-list ...
// 为断点号 bnumi写一个命令列表.当程序被该断点停住时,gdb 依次运行命令列表中的命令.
end
例如：
break foo if x>0
commands
printf "x is %d/n",x
continue
end
--------------------------------------------------------------------------------
信号(Signals)
添加信号处理
handle <signal> <keywords...>
在 gdb 中定义一个信号处理.信号 <signal> 可以以 SIG 开头或不以 SIG 开头,可以用定义一个要处理信号的范围(如：SIGIO-SIGKILL,表示处理从 SIGIO 信号到 SIGKILL 的信号,其中包括 SIGIO, SIGIOT, SIGKILL 三个信号),也可以使用关键字 all 来标明要处理所有的信号.一旦被调试的程序接收到信号,运行程序马上会被 gdb 停住,以供调试.其 <keywords> 可以是以下几种关键字的一个或多个.若没有 keywords 则查看奇信号的处理状态 nostop -- 当被调试的程序收到信号时,gdb 不会停住程序的运行,但会打出消息告诉你收到这种信号.
stop -- 当被调试的程序收到信号时,gdb 会停住你的程序.
print -- 当被调试的程序收到信号时,gdb 会显示出一条信息.
noprint -- 当被调试的程序收到信号时,gdb 不会告诉你收到信号的信息.
pass -- 当被调试的程序收到信号时,gdb 不处理信号.这表示,gdb 会把这个信号交给被调试程序会处理.
noignore -- 当被调试的程序收到信号时,gdb 不处理信号.这表示,gdb 会把这个信号交给被调试程序会处理.
nopass -- 当被调试的程序收到信号时,gdb 不处理信号.这表示,gdb 会把这个信号交给被调试程序会处理.
1gnore -- 当被调试的程序收到信号时,gdb 不会让被调试程序来处理这个信号.
查看处理信号
info signals -- 查看有哪些信号在被 gdb 检测中.
info handle -- 查看有哪些信号在被 gdb 检测中.
--------------------------------------------------------------------------------
GDB 程序调试
恢复执行
continue [ignore-count] -- ignore-count 表示忽略其后的断点次数.恢复程序运行,直到程序结束,或是下一个断点到来.缩写 c
fg [ignore-count] -- ignore-count 表示忽略其后的断点次数.恢复程序运行,直到程序结束,或是下一个断点到来.缩写 c
单步调试
step <count> -- 单步跟踪,如果有函数调用,它会进入该函数.count 表示执行后面 count 条语句,不加则默认为 1.
next <count> -- 同样单步跟踪,如果有函数调用,他不会进入该函数.count 表示执行后面 count 条语句,不加则默认为 1.
跟踪机器指令
与之一样有相同功能的命令是 “display/i $pc” ,当运行完这个命令后,单步跟踪会在打出程序代码的同时打出机器指令(也就是汇编代码)
stepi 或 si -- 单步跟踪一条机器指令,简写 si
nexti 或 ni -- 单步跟踪一条机器指令,简写 ni
函数调试
finish -- 运行程序,直到当前函数完成返回.并打印函数返回时的堆栈地址和返回值及参数值等信息.
return <expression> -- 使函数以 expression 表达式返回出去,忽略还没有执行的语句.若无返回 void 出去
call <expr> -- 表达式中可以一是函数,以此达到强制调用函数的目的.并显示函数的返回值,如果函数返回值是void,那么就不显示.
print 与 printf 也可以做到类似的功能和 call 的不同是,如果函数返回 void,call 则不显示,print 则显示函数返回值,并把该值存入历史数据中.
循环体调试
until -- 可以运行程序直到退出循环体.简写 u
修改变量值
print varname=var -- 修改被调试程序运行时的变量值
set var varname=value -- 修改被调试程序运行时的变变量
whatis varname -- 查看变量的类型
跳转执行
jump <linespec> -- 指定下一条语句的运行点.<linespce> 可以是文件的行号,可以是 file:line 格式,可以是 +num 这种偏移量格式.表式着下一条运行语句从哪里开始.
jump <address> -- 跳转到指定的程序内存地址运行.<address> 是代码行的内存地址.
注意 jump 指令不会改变当前的程序栈中的内容,所以,当你从一个函数跳到另一个函数时,当函数运行完返回时进行弹栈操作时必然会发生错误.
jump 命令只是改变了指令寄存器中的值.于是可以使用 “set $pc” 来更改跳转执行的地址.如： set $pc = 0x485
产生信号量
signal <signal> -- 产生一个 signal 信号.UNIX 的系统信号量通常从 1 到 15.所以 <signal> 取值也在这个范围.
--------------------------------------------------------------------------------
GDB 运行是数据
查看运行时数据
print /<f> <expr> -- 查看当前程序的运行数据.简写 p. <expr> 是表达式 @ -- 是一个和数组有关的操作符,在后面会有更详细的说明.在 @ 左边是数组的地址,右边是数组的长度,eg: array@len
:: -- 指定一个在文件或是一个函数中的变量.
{<type>} <addr> --表示一个指向内存地址<addr>的类型为type的一个对象.
<f>是输出的格式 d -- 按十进制格式显示变量.
u -- 按十六进制格式显示无符号整型.
o -- 按八进制格式显示变量.
t -- 按二进制格式显示变量.
a -- 按十六进制格式显示变量.
c -- 按字符格式显示变量.
f -- 按浮点数格式显示变量.
注意: 1.若出现变量重名,局部变量会隐藏全局变量.若想查看全局变量的值时,可以使用“::”操作符.
2.可以通过这种形式指定你所想查看的变量 eg:
*'filename'::variable
*function::variable
printf "fmt",arg,... -- 打印格式化字符灿 fmt.
查看内存
examine/<n/f/u> <addr> -- 来查看内存地址中的值.简写 x <n/f/u> n 是一个正整数,表示显示内存的长度,也就是说从当前地址向后显示几个地址的内容.
f 表示显示的格式 s -- 按字符串格式显示内存地址内容.
i -- 查看内存地址的机器指令内容
x -- 按十六进制格式显示地址内容.
d -- 按十进制格式显示地址内容.
u -- 按十六进制格式显示无符号整型.
o -- 按八进制格式显示地址内容.
t -- 按二进制格式显示地址内容.
a -- 按十六进制格式显示地址内容.
c -- 按字符格式显示地址内容.
f -- 按浮点数格式显示地址内容.
u 表示从当前地址往后请求的字节数,如果不指定的话,gdb默认是 4 个 bytes. b -- 表示单字节
h -- 表示双字节
w -- 表示四字节
g -- 表示八字节
<addr> 表示一个内存地址.
自动显示
设置自动显示 display/<fmt> <expr> -- 自动显示 expr 表达式
display/<fmt> <addr> -- 自动显示 addr 地址 fmt 表示显示的格式
i -- 输出格式为机器指令码,也就是汇编.
s -- 输出格式为字符串
删除自动显示 undisplay <range> -- 删除自动显示
delete display <range> -- 删除自动显示
启用和禁自动显示 sable display <range> -- 禁用自动显示
enable display <range> -- 启动自动显示
查看栈信息
backtrace <n> -- 擦看函数栈信息,简写 bt n 若是正数,只打印栈顶上 n 层的栈信息,
若是负数,只打印栈顶下 n 层的栈信息,
若无则打印当前的函数调用栈的所有信息
frame -- 会打印出这些信息:栈的层编号,当前的函数名,函数参数值,函数所在文件及行号,函数执行到的语句.
info frame -- 这个命令会打印出更为详细的当前栈层的信息,只不过,大多数都是运行时的内内地址.
info args -- 打印出当前函数的参数名及其值.
info locals -- 打印出当前函数中所有局部变量及其值.
info catch -- 打印出当前的函数中的异常处理信息.
切换函数栈位置
frame <n> -- 切换到第 n 层函数栈位置,简写 f.
p <n> -- 表示上面移动 n 层,可以不打 n,表示向上移动一层.
down <n> -- 表示向栈的下面移动 n 层,可以不打 n,表示向下移动一层.
select-frame <n> -- 类似 frame 命令.不打印出栈层信息.
up-silently <n> -- 类似 up 命令.不打印出栈层信息.
down-silently <n> -- 类似 down 命令.不打印出栈层信息.
查看寄存器
info registers -- 查看寄存器的情况.(除了浮点寄存器)
info all-registers -- 查看所有寄存器的情况.(包括浮点寄存器)
info registers <regname> -- 查看所指定的寄存器的情况.
线程查看与切换线程
info threads -- 查看当前线程
thread <threadno> -- 切换到 threadno 的线程,简写 t
--------------------------------------------------------------------------------
自定义命令
定义一个命令
格式
define comdName
...
end
条件语句
if cond_expr
...
else
...
end
循环语句
while cond_expr
...
end
定义一个命令的文档信息（在 help cmdName 的时候显示）
document cmdName
...
end
查看自定命令
help user-define -- 查看所有用户自定义的命令
show user cmdName -- 查看用户定义的 cmdName 的命令.
help cmdName -- 查看用户自定义的 cmdName 的帮助文档
show max-user-call-depth -- 查看用户自定义命令的递归最大深度,缺省是 1024
set-user-call-depth <limit>-- 设置用户自定义命令的递归最大深度.
