gdb 跟踪调试命令整理

内容源自于陈浩CSDN博客的用GDB调试程序一系列文章

• 用GDB调试程序（一）
• 用GDB调试程序（二）
• 用GDB调试程序（三）
• 用GDB调试程序（四）
• 用GDB调试程序（五）
• 用GDB调试程序（六）
• 用GDB调试程序（七）

 

GDB 调试

要进行调试程序首先要生成一个含有调试信息的执行程序命令如下:

• gcc(g++) -g -o 文件名 源文件.c(源文件.cpp)
• gcc(g++) -ggdb3 -o 文件名 源文件.c(源文件.cpp)

此时便会生成一个含有调试信息的可执行文件,然后便可以用 gdb 去调试这个程序了,进入调试程序命令,但是如果用 gdb 去调试一个未包含调试信息的可执行文件则会发生错误

• gdb 执行文件名(含调试信息)

---

运行 GDB

运行 gdb

• gdb -- program也就是你的执行文件,一般在当然目录下.
• gdb core -- 用 gdb 同时调试一个运行程序和 core 文件,core 是程序非法执行后 core dump 后产生的文件.
• gdb -- 调试正在运行的程序. program 为需要调试的程序文件, PID 为当前正在运行的程序.或是先用 gdb 关联上源代码进入 gdb,后用 attach 命令来挂接进程的 PID.并用 detach 来取消挂接的进程

gdb 启动常用的参数

• 从指定文件中读取符号表
  • -symbols
  • -s
• 从指定文件中读取符号表信息,并把他用在可执行文件中
  • -se file
• 调试时 core dump 的 core 文件
  • -core
  • -c
• 加入一个源文件的搜索路径.默认搜索路径是环境变量中 PATH 所定义的路径
  • -directory
  • -d
• 设置启动时候参数
  • --args arglist

gdb 帮助文档

• help -- 查看 gdb 的命令种类
• help -- 查看 CmdType 种类的 gdb 命令
• apropos -- 查看关键字 keyWord 的相关命令
• info -- 查看关键字 keyWord 调试信息
• show -- 查看关键字 keyWord gdb 本身设置信息

gdb 中运行 unix 的 shell 程序

• shell -- 调用 unix 的 shell 来执行 ,环境变量 shell 中定义的 unix 的 shell 将会被用来执行 ,如果 shell 没有定义,那就使用 unix 的标准 shell：/bin/sh.(在 windows 中使用 command.com 或 cmd.exe)
• make -- 等价于 “shell make ”

历史记录

• 当你用 gdb 的 print 查看程序运行时的数据时,你每一个 print 都会被 gdb 记录下来.gdb 会以 $1, $2, $3 ...这样的方式为你每一个 print 命令编上号.于是,你可以使用这个编号访问以前的表达式,如 $1.这个功能所带来的好处是,如果你先前输入了一个比较长的表达式,如果你还想查看这个表达式的值,你可以使用历史记录来访问,省去了重复输入.

启动程序

• run -- 启动程序, 为程序运行时候需要输入的参数.也可用 set args 命令去设置运行参数.简写为 r

---

GDB 环境设置

gdb 设置

• 设置显示选项
  • 地址
    • set print address -- 打开地址输出,当程序显示函数信息时,gdb会显出函数的参数地址.系统默认为打开.
    • show print address -- 查看 print address 选项信息
  • 数组元素单独行显示
    • set print array -- 打开时数组显示时,每个元素占一行,如果不打开的话,每个元素则以逗号分隔.这个选项默认是关闭的.
    • show print array -- 查看 print array 选项信息
  • 显示数组元素显示
    • set print elements -- 设置数组的显示的最大长度,设置为 0,则表示不限制.
    • show print elements -- 查看 print elements 选项信息.
  • 设置字符串显示
    • set print null-stop -- 如果打开那么当显示字符串时,遇到结束符则停止显示.这个选项默认为 off.
    • show print null-stop -- 查看 print null-stop 选项信息
  • 设置结构体变量显示
    • set print pretty -- 结构体优雅显示
    • show print pretty -- 查看 gdb 是如何显示结构体的.
  • 设置字符显示
    • set print sevenbit-strings -- 符显示,是否按“/nnn”的格式显示,如果打开,则字符串或字符数据按/nnn显示,如“/065”.
    • show print sevenbit-strings -- 查看字符显示开关是否打开.
  • 设置联合体显示
    • set print union -- 设置显示结构体时,是否显式其内的联合体数据.
    • show print union -- 查看联合体数据的显示方式
  • 设置对象显示
    • set print object -- 在 C++ 中,如果一个对象指针指向其派生类,如果打开这个选项,gdb 会自动按照虚方法调用的规则显示输出,如果关闭这个选项的话,gdb 就不管虚函数表了.这个选项默认是 off.
    • show print object -- 查看对象选项的设置.
  • 设置静态成员显示
    • set print static-members -- 这个选项表示,当显示一个 C++ 对象中的内容是,是否显示其中的静态数据成员.默认是 on.
    • show print static-members -- 查看静态数据成员选项设置.
  • 设置虚函数表显示
    • set print vtbl -- 当此选项打开时,gdb 将用比较规整的格式来显示虚函数表时.其默认是关闭的.
    • show print vtbl -- 查看虚函数显示格式的选项.
• 设置运行程序的相关环境及其参数
  • 指定源文件的路径
    • directory -- 加一个源文件路径到当前路径的前面.如果你要指定多个路径,UNIX 下你可以使用“:”,Windows 下你可以使用“;”.缩写 dir
    • directory -- 清除所有的自定义的源文件搜索路径信息.
    • show directories -- 显示定义了的源文件搜索路径.
  • 运行参数
    • set args -- 可指定运行时参数
    • show args -- 命令可以查看设置好的运行参数
  • 运行环境
    • path -- 可设定程序的运行路径
    • show paths -- 查看程序的运行路径
    • set environment varname=value -- 设置环境变量
    • show environment [varname] -- 查看环境变量
  • 工作目录
    • cd -- 相当于shell的cd命令
    • pwd -- 显示当前的所在目录
  • 程序的输入输出
    • info terminal -- 显示你程序用到的终端的模式
    • tty -- 命令可以指写输入输出的终端设备
    • 重定向控制程序输出
  • 堆栈帧设置
    • set backtrace -- 设置堆栈帧的最大显示数量,默认是没有限制
  • 调试模式
    • set step-mode [on | off] -- step-mode 模式,于是,在进行单步跟踪时,程序不会因为没有debug信息而不停住.这个参数有很利于查看机器码. 

---

GDB 源码查看

显示源代码

• list -- 显示程序第 linenum 行的周围的源程序.
• list -- 显示函数名为 function 的函数的源程序.
• list -- 哪个文件的哪一行.
• list -- 哪个文件中的哪个函数.
• list -- 当前行号的正/负 offset 偏移量那那行.
• list -- 显示当前行后面的源程序.
• list - -- 显示当前行前面的源程序.
• list , -- 显示从 first 行到 last 行之间的源代码.若无 first 则显示从当前行到 last 之间的源代码.

设置和获得显示源码的行数

• set listsize -- 设置一次显示源代码的行数.
• show listsize -- 查看当前listsize的设置.

搜索源代码

• forward-search -- 向后面搜索.正则表达式为 regexp 的关键字
• search -- 向后面搜索.正则表达式为 regexp 的关键字
• reverse-search -- 向前面搜索.正则表达式为 regexp 的关键字

源代码的内存

• info line -- 查看行号为 linenum 源代码在内存中的地址.
• info line -- 查看函数在源代码在内存中的地址.
• info line -- 查看 filename 文件的第 linenum 行源代码在内存中的地址.
• info line -- 查看 filename 文件的 function 函数在源代码在内存中的地址.

查看汇编代码

• disassemble -- 查看源程序的当前执行时的机器码,这个命令会把目前内存中的指令 dump 出来.

---

GDB 停止点设置及维护

断点(BreakPoint)

• 设置断点:(threadno 指定了线程的 ID,注意,这个 ID 是 gdb 分配的,可以通过 "info threads" 命令来查看正在运行程序中的线程信息)
  • break thread -- break命令没有参数时,表示在下一条指令处停住.
  • break +offset thread -- 在当前行号的后面的 offset 行停住.(offiset 为自然数)
  • break -offset thread -- 在当前行号的前面的 offset 行停住.(offiset 为自然数)
  • break thread -- 在指定行号停住.
  • break filename:linenum thread -- 在源文件filename的linenum行处停住.
  • break thread -- 在进入指定函数时停住.
  • break filename:function thread --在源文件filename的function函数的入口处停住.
  • break *address -- 在程序运行的内存地址处停住.
  • break ... thread if -- ...可以是上述的参数,condition表示条件,在条件成立时停住.比如在循环境体中,可以设置break if i=100,表示当i为100时停住程序.
  • tbreak -- 设置只停止一次的断点.用法和 break 类似
• 查看断点
  • info breakpoints [n]
  • info break [n]

观察点(WatchPoint) -- 观察点一般来观察某个表达式(变量也是一种表达式)的值是否有变化了,如果有变化,马上停住程序.

• 设在观察点
  • watch -- 为表达式(变量)expr设置一个观察点.一量表达式值有变化时,马上停住程序.
  • rwatch -- 当表达式(变量)expr被读时,停住程序.
  • awatch -- 当表达式(变量)的值被读或被写时,停住程序.
• 查看观察点
  • info watchpoints -- 列出当前所设置了的所有观察点.

捕捉点(CatchPoint) -- 设置捕捉点来补捉程序运行时的一些事件.如:载入共享库(动态链接库)或是 C++ 的异常《/p>

• 设置捕捉点
  • catch -- 当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 载入共享库(动态链接库)时.(load 为关键字,目前此功能只在 HP-UX 下有用)
    • unload 或 unload 卸载共享库(动态链接库)时.(unload 为关键字,目前此功能只在 HP-UX 下有用)
  • tcatch -- 只设置一次捕捉点,当程序停住以后,应点被自动删除.

维护停止点

• 清除停止点
  • clear -- 所有的已定义的停止点.
  • clear -- 清除所有设置在函数上的停止点.
  • clear -- 清除所有设置在函数上的停止点.
  • clear -- 清除所有设置在指定行上的停止点.
  • clear -- 清除所有设置在指定行上的停止点.
• 删除停止点
  • 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.
  • condition -- 清除断点号为bnum的停止条件.
• 忽略停止点 N 次
  • ignore -- 表示忽略断点号为 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 在 gdb 中定义一个信号处理.信号 可以以 SIG 开头或不以 SIG 开头,可以用定义一个要处理信号的范围(如：SIGIO-SIGKILL,表示处理从 SIGIO 信号到 SIGKILL 的信号,其中包括 SIGIO, SIGIOT, SIGKILL 三个信号),也可以使用关键字 all 来标明要处理所有的信号.一旦被调试的程序接收到信号,运行程序马上会被 gdb 停住,以供调试.其 可以是以下几种关键字的一个或多个.若没有 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 条语句,不加则默认为 1.
• next -- 同样单步跟踪,如果有函数调用,他不会进入该函数.count 表示执行后面 count 条语句,不加则默认为 1.

跟踪机器指令
       与之一样有相同功能的命令是 “display/i $pc” ,当运行完这个命令后,单步跟踪会在打出程序代码的同时打出机器指令(也就是汇编代码)

• stepi 或 si -- 单步跟踪一条机器指令,简写 si
• nexti 或 ni -- 单步跟踪一条机器指令,简写 ni

函数调试

• finish -- 运行程序,直到当前函数完成返回.并打印函数返回时的堆栈地址和返回值及参数值等信息.
• return -- 使函数以 expression 表达式返回出去,忽略还没有执行的语句.若无返回 void 出去
• call -- 表达式中可以一是函数,以此达到强制调用函数的目的.并显示函数的返回值,如果函数返回值是void,那么就不显示.
• print 与 printf 也可以做到类似的功能和 call 的不同是,如果函数返回 void,call 则不显示,print 则显示函数返回值,并把该值存入历史数据中.

循环体调试

• until -- 可以运行程序直到退出循环体.简写 u

修改变量值

• print varname=var -- 修改被调试程序运行时的变量值
• set var varname=value -- 修改被调试程序运行时的变变量
• whatis varname -- 查看变量的类型

跳转执行

• jump -- 指定下一条语句的运行点. 可以是文件的行号,可以是 file:line 格式,可以是 +num 这种偏移量格式.表式着下一条运行语句从哪里开始.
• jump
  -- 跳转到指定的程序内存地址运行.

  是代码行的内存地址.
• 注意
  • jump 指令不会改变当前的程序栈中的内容,所以,当你从一个函数跳到另一个函数时,当函数运行完返回时进行弹栈操作时必然会发生错误.
  • jump 命令只是改变了指令寄存器中的值.于是可以使用 “set $pc” 来更改跳转执行的地址.如： set $pc = 0x485

产生信号量

• signal -- 产生一个 signal 信号.UNIX 的系统信号量通常从 1 到 15.所以 取值也在这个范围.

---

GDB 运行是数据

查看运行时数据

• print / -- 查看当前程序的运行数据.简写 p.
  • 是表达式
    • @ -- 是一个和数组有关的操作符,在后面会有更详细的说明.在 @ 左边是数组的地址,右边是数组的长度,eg: array@len
    • :: -- 指定一个在文件或是一个函数中的变量.
    • {} --表示一个指向内存地址的类型为type的一个对象.
  • 是输出的格式
    • d -- 按十进制格式显示变量.
    • u -- 按十六进制格式显示无符号整型.
    • o -- 按八进制格式显示变量.
    • t -- 按二进制格式显示变量.
    • a -- 按十六进制格式显示变量.
    • c -- 按字符格式显示变量.
    • f -- 按浮点数格式显示变量.
  • 注意:
    • 1.若出现变量重名,局部变量会隐藏全局变量.若想查看全局变量的值时,可以使用“::”操作符.
    • 2.可以通过这种形式指定你所想查看的变量 eg:
          *'filename'::variable
          *function::variable
• printf "fmt",arg,... -- 打印格式化字符灿 fmt.

查看内存

• examine/ -- 来查看内存地址中的值.简写 x
  • • n 是一个正整数,表示显示内存的长度,也就是说从当前地址向后显示几个地址的内容.
    • f 表示显示的格式
      • s -- 按字符串格式显示内存地址内容.
      • i -- 查看内存地址的机器指令内容
      • x -- 按十六进制格式显示地址内容.
      • d -- 按十进制格式显示地址内容.
      • u -- 按十六进制格式显示无符号整型.
      • o -- 按八进制格式显示地址内容.
      • t -- 按二进制格式显示地址内容.
      • a -- 按十六进制格式显示地址内容.
      • c -- 按字符格式显示地址内容.
      • f -- 按浮点数格式显示地址内容.
    • u 表示从当前地址往后请求的字节数,如果不指定的话,gdb默认是 4 个 bytes.
      • b -- 表示单字节
      • h -- 表示双字节
      • w -- 表示四字节
      • g -- 表示八字节
  • 表示一个内存地址.

自动显示

• 设置自动显示
  • display/ -- 自动显示 expr 表达式
  • display/ -- 自动显示 addr 地址
    • fmt 表示显示的格式
    • i -- 输出格式为机器指令码,也就是汇编.
    • s -- 输出格式为字符串
• 删除自动显示
  • undisplay -- 删除自动显示
  • delete display -- 删除自动显示
• 启用和禁自动显示
  • sable display -- 禁用自动显示
  • enable display -- 启动自动显示

查看栈信息

• backtrace -- 擦看函数栈信息,简写 bt
  • n 若是正数,只打印栈顶上 n 层的栈信息,
  • 若是负数,只打印栈顶下 n 层的栈信息,
  • 若无则打印当前的函数调用栈的所有信息
• frame -- 会打印出这些信息:栈的层编号,当前的函数名,函数参数值,函数所在文件及行号,函数执行到的语句.
• info frame -- 这个命令会打印出更为详细的当前栈层的信息,只不过,大多数都是运行时的内内地址.
• info args -- 打印出当前函数的参数名及其值.
• info locals -- 打印出当前函数中所有局部变量及其值.
• info catch -- 打印出当前的函数中的异常处理信息.

切换函数栈位置

• frame -- 切换到第 n 层函数栈位置,简写 f.
• p -- 表示上面移动 n 层,可以不打 n,表示向上移动一层.
• down -- 表示向栈的下面移动 n 层,可以不打 n,表示向下移动一层.
• select-frame -- 类似 frame 命令.不打印出栈层信息.
• up-silently -- 类似 up 命令.不打印出栈层信息.
• down-silently -- 类似 down 命令.不打印出栈层信息.

查看寄存器

• info registers -- 查看寄存器的情况.(除了浮点寄存器)
• info all-registers -- 查看所有寄存器的情况.(包括浮点寄存器)
• info registers -- 查看所指定的寄存器的情况.

线程查看与切换线程

• info threads -- 查看当前线程
• thread -- 切换到 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 -- 设置用户自定义命令的递归最大深度.