nginx源码学习笔记-gdb的使用

Post on Jun 02, 2017 by Lightfish Zhang

前言

本篇学习笔记，实质是笔者对深入剖析Nginx的读后感与调试源码的实践记录

利用gdb调试

修改编译配置

  • 使gcc带上-g -O0，以下方法任选一
    • make CFLAGS=”-g -O0”
    • auto/configure –with–cc-opt=’-g -O0’
  • 宏，如果不事先实现处理宏，在gdb调试中，将无法查看这些宏的定义以及展开形式
    • -g改为-ggdb3

gdb跟踪进程

  • 找到需要调试的进程
    • ps -efH|grep nginx|grep -v grep找到需要调试的进程，可见的进程有nginx master和nginx worker，nignx源码实现给进程加上title
    • 对某一进程调试，gdb -p $pid, 或者在gdb内命令行执行attach $pid
  • nginxfork子进程，如何调试
    • 修改配置项，使ngixn处理请求交付给worker的进程设为1，修改nginx.conf的worker_processes 1;
    • nginx以daemon运行，方式不是屏蔽signal而是制造孤儿进程，也就是创建子进程后把父进程exit(0)，子进程被init收养而成为daemon
    • 在调试daemon程序，可以在gdb内设置set follow-fork-mode child, gdb是默认跟踪fork()之后的父进程，需要做此设置。
    • 但是nginx创建工作进程也是使用fork,使用上一条方法会有些麻烦，如果需要调试master进程，可以修改nginx.conf的daemon off;
    • 灵活变通，切换follow-fork-mode标记，在多处恰当的地方下断点，执行到预想的代码.
    • 由前几条方法，我们可以灵活地调试master与worker进程，当然nginx.conf还有一个配置master_process on\off;，可以设置监控进程逻辑和工作逻辑共同工作在一个进程。

  • nginx指定配置

  • shell执行
# 在编译过的源码文件夹下执行，加`sudo`是因为nginx需要在系统绑定端口以及需要读写/usr/local/nginx/log等文件
sudo gdb --args ./objs/nginx -c `pwd`/conf/nginx.conf
  • 或者在gdb内执行
file ./objs/nginx
set args -c /usr/local/nginx/conf/nginx.conf
r
# or
r -c /usr/local/nginx/conf/nginx.conf

gdb的watch命令使用

  • 打断点b filename.c:1234，在filename.c文件的1234行
  • r, run执行
  • p abc, print输出变量abc的值，如0x1234
  • watch 0x1234, 当地址的值0x1234被修改，执行过程会被停止，且gdb抓取变化前后的值

nginx对gdb的支持

  • nginx.conf配置debug_points stop/abort;
  • 如果nginx遇到严重错误，会调用ngx_debug_point()函数，如果debug_points stop;，nginx进程会进入暂停状态（ts/TASK_STOPPED），此时可使用gdb进入该进程查看上下文信息
  • 命令ps -aux|grep nginx|grep -v grep可看出nginx的状态，或者ps -eo pid,stat,command|grep nginx|grep -v grep
  • 如果debug_points abort;，操作系统有所处理，可以通过core文件调试
# 如果修改源码，主动调用ngx_debug_point()
ulimit -c unlimited
./nginx
gdb ./core -q
# 查看上下文
(gdb) bt\up\list

参考文献