使用gdb调试nginx源码

工欲善其事必先利其器，如何使用调试工具gdb一步步调试nginx是了解nginx的重要手段。

ps：本文的目标人群是像我这样初接触Unix编程的同学，如果有什么地方错误请指正。

熟悉gdb的使用

这里就不说了，谷歌一搜一堆，这里推荐一篇文章：GDB 命令详细解释

请重点看一下step，run，break，list，info，continue命令

下载nginx源码

这里使用nginx-1.0.14

src是源代码，auto文件夹是configure运行时候的各种命令集合

修改config并编译

由于gdb需要gcc的时候加上-g参数，这样生成的文件才能使用gdb调试，因此我们要对源码做一下小改动

（ps：gdb调试release版本程序：http://blog.csdn.net/blade2001/article/details/46563805）

修改auto/cc/conf文件

ngx_compile_opt="-c"

变为

ngx_compile_opt="-c -g"

执行configure

./configure --prefix=/home/yejianfeng/nginx/

确认

发现多出了objs文件夹，里面有Makefile文件

确认一下-g参数是否加上了

vim objs/Makefile

确认已经加上了-g，

make

生成可执行文件

至此，nginx可执行文件已经成功编译了。

生成gdb所需要的core文件

gdb的core文件是为了保证在调试过程中遇到问题可以随时重新启动调试进程，更便于调试。

启动nginx

在objs目录下 ./nginx

ps aux|grep nginx

看到nginx启动了一个master进程（18237）和一个worker进程（18238）

在objs目录下运行命令

gcore 18237

（ps：gcore 实用程序为每个指定的进程创建核心映像。缺省情况下，其进程 ID 为 process-id 的进程的核心映像文件名为 core.process-id。）

看到core.188237生成了。

杀死nginx进程，包括master和worker

./nginx -s stop（或者直接使用kill）

启动调试

[root@localhost objs]# gdb ./nginx core.18237

此时进入gdb模式

gdb打断点并调试

使用l（list）命令查看main 函数，这个main函数是在src/core/nginx.c里面，是nginx的入口函数

(gdb) l #列出源文件，只列出10行，请使用l- 和 l 或者l +行号 或者 l +函数名 进行定位

(gdb) break 215 #在哪行打断点

(gdb) r #run，从main函数开始运行程序

此时进入另一个终端查看进程情况

看到已经启动了一个nginx了

此时在gdb中就可以进行调试了

下面就使用next和step一步一步进行调试吧

调试中可能遇到的问题

nginx是master-worker模式，当fork出现子进程的时候如何进入子进程呢？

（gdb）set follow-fork-mode child

这个命令可以是

set follow-fork-mode parent

set follow-fork-mode child

请参考：Debugging Forks

print（p）能否打印出指针指向的内容呢？

（gdb）p *ptr

当使用attach pid进入某个进程的时候出现错误

(gdb) attach 30721

Attaching to program: /data0/s/bin/s, process 30721

ptrace: Operation not permitted.

这个错误是由于有其他gdb也在调试这个进程

请确定是否有另外的终端或者另外的同事在gdb这个进程

参考资料：

gdb调试nginx的helloworld

Debugging Forks

Nginx源码阅读笔记

专注Web开发50年。请加群：

本文基于署名-非商业性使用 3.0许可协议发布，欢迎转载，演绎，但是必须保留本文的署名叶剑峰（包含链接http://www.cnblogs.com/yjf512/），且不得用于商业目的。如您有任何疑问或者授权方面的协商，请与我联系。