GDB 调试
要进行调试程序首先要生成一个含有调试信息的执行程序命令如下:
- gcc(g++) -g -o 文件名 源文件.c(源文件.cpp)
- gcc(g++) -ggdb3 -o 文件名 源文件.c(源文件.cpp)
此时便会生成一个含有调试信息的可执行文件,然后便可以用 gdb 去调试这个程序了,进入调试程序命令,但是如果用 gdb 去调试一个未包含调试信息的可执行文件则会发生错误
- gdb 执行文件名(含调试信息)
运行 GDB
运行 gdb
- gdb <program> -- program也就是你的执行文件,一般在当然目录下.
- gdb <program> core -- 用 gdb 同时调试一个运行程序和 core 文件,core 是程序非法执行后 core dump 后产生的文件.
- gdb <program> <PID> -- 调试正在运行的程序. program 为需要调试的程序文件, PID 为当前正在运行的程序.或是先用 gdb <program> 关联上源代码进入 gdb,后用 attach 命令来挂接进程的 PID.并用 detach 来取消挂接的进程
gdb 启动常用的参数
- 从指定文件中读取符号表
- -symbols <file>
- -s <file>
- 从指定文件中读取符号表信息,并把他用在可执行文件中
- -se file
- 调试时 core dump 的 core 文件
- -core <file>
- -c <file>
- 加入一个源文件的搜索路径.默认搜索路径是环境变量中 PATH 所定义的路径
- -directory <directory>
- -d <directory>
- 设置启动时候参数
- --args arglist
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> -- 只设置一次捕捉点,当程序停住以后,应点被自动删除.
- catch <event> -- 当event发生时,停住程序.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
- <expr> 是表达式
- 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> 表示一个内存地址.
- <n/f/u>
自动显示
- 设置自动显示
- 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>-- 设置用户自定义命令的递归最大深度.