GDB调试详解：

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

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

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

此时便会生成一个含有调试信息的可执行文件,然后便可以用 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日志:

set logging file <FILENAME> -- 设置日志文件名文件为FILENAME.txt

set logging <on/off>     -- 打开日志输出,默认文件为gdb.txt.系统默认为关闭.

set logging on [FILENAME]  -- 打开日志输出,日志文件为FILENAME.txt.

show print address -- 查看logging选项信息

--------------------------------------------------------------------------------


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]

info b [n]


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

设在观察点:

watch <expr>    -- 为表达式(变量)expr设置一个观察点.一量表达式值有变化时,马上停住程序.

rwatch <expr>    -- 当表达式(变量)expr被读时,停住程序.

awatch <expr>    -- 当表达式(变量)的值被读或被写时,停住程序.

查看观察点:

info watchpoints  -- 列出当前所设置了的所有观察点.



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

设置捕捉点:

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]-- 为断点号 bnum写一个命令列表.当程序被该断点停住时,gdb 依次运行命令列表中的命令.

... command-list ...

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    --也可以做到类似的功能和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 -- 按浮点数格式显示变量.


printf "fmt",arg,... -- 打印格式化字符串fmt.


数组:

有时候,你需要查看一段连续的内存空间的值。比如数组的一段，或是动态分配的数据的大小。

你可以使用GDB的“@”操作符，"@"的左边是第一个内存的地址的值，"@"的右边则你你想查看内存的长度。

例如，你的程序中有这样的语句：

int *array = (int *) malloc (len * sizeof (int));

在GDB调试过程中，你可以以如下命令显示出这个动态数组的取值:

p *array@len-- @的左边是数组的首地址的值,也就是变量array所指向的内容,右边则是数据的长度;

如果是静态数组的话,可以直接用print数组名,就可以显示数组中所有数据的内容了。


注意:

1.若出现变量重名,局部变量会隐藏全局变量.若想查看全局变量的值时,可以使用"::"操作符.

2.可以通过这种形式指定你所想查看的变局变量值:

eg:

   (1) p 'filename'::variable

   (2) p function::variable


查看内存:

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> 表示一个内存地址.


查看变量的数据类型:

ptype --显示变量的数据类型


自动显示:

设置自动显示:

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.

up <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 cmdName

...

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 max-user-call-depth <limit>    -- 设置用户自定义命令的递归最大深度.



查看当前程序栈的内容: x/10x $sp   -- 打印stack的前10个元素

查看当前程序栈的信息: info frame   -- list general info about the frame

查看当前程序栈的参数: info args    -- lists arguments to the function

查看当前程序栈的局部变量: info locals-- list variables stored in the frame

查看当前寄存器的值：info registers(不包括浮点寄存器) info all-registers(包括浮点寄存器)

查看当前栈帧中的异常处理器：info catch(exception handlers)