MYSQL源码 与 DBUG

一、前言

在规模稍微大点的项目中,为了方便快速找到bug的所在,我们往往需要在代码中加入一些调试用的代码,比如加入一些printf,打印出一些重点的信息;加入assert,进行断言判断。这些比较随意的调试代码会使整个系统显得比较凌乱。于是Fred Fish开发了一套用于嵌入代码中的库,开发人员只需要调用相应的函数即可加入调试信息。
          对于MySQL这种多线程的程序来说,调试也是比较困难的,MySQL选择了DBUG作为其调试代码(在原始代码的基础上进行了略微的改造),充分说明了DBUG的实用性,本文就DBUG的原始代码进行介绍。
  二、DBUG下载与使用

这里以linux下的开发进行介绍。
        首先需要下载DBUG源码,下载地址:http://sourceforge.net/projects/dbug/
        解压后在dbug/src下即是debug所需的源码文件:dbug.h dbug.c
        dbug/example.c是一个简单的例子,源码如下:

  1. /*
  2. * This file is Public Domain
  3. *
  4. * Just short example, how Fred Fish's dbug package should be used
  5. *
  6. * Tonu Samuel
  7. *
  8. */
  9. #include "dbug.h"
  10. static int sub1 (void);
  11. static void sub2 (char *arg);
  12. static int
  13. sub1 (void)
  14. {
  15. DBUG_ENTER ("sub1");
  16. sub2 ("Hello world!");
  17. sub2 ("Hello earth!");
  18. sub2 ("Hello programmer!");
  19. DBUG_RETURN (0);
  20. }
  21. static void
  22. sub2 (char *arg)
  23. {
  24. DBUG_ENTER ("sub2");
  25. DBUG_PRINT ("info", ("Got argument: '%s'", arg));
  26. printf ("%s\n", arg);
  27. DBUG_VOID_RETURN;
  28. }
  29. int
  30. main (void)
  31. {
  32. int ret = 0;
  33. DBUG_PUSH ("d:t:O");
  34. DBUG_PROCESS ("example");
  35. ret = sub1 ();
  36. DBUG_PRINT ("info", ("Returned value: %d", ret));
  37. return 0;
  38. }

复制代码

我们将example.c放到src目录下,然后编译example文件:

  1. dbug/src$ gcc -Wall -g dbug.c example.c -o example

复制代码

运行example输出如下:

  1. >sub1
  2. | >sub2
  3. | | info: Got argument: 'Hello world!'
  4. Hello world!
  5. | sub2
  6. | | info: Got argument: 'Hello earth!'
  7. Hello earth!
  8. | sub2
  9. | | info: Got argument: 'Hello programmer!'
  10. Hello programmer!
  11. | < value: Returned info:

复制代码

结合源码,我们通过打印出来的信息,可以很容易的看出调试信息所表达的意思:
函数sub1调用了三次sub2,三次的参数分别是'Hello world!' ,'Hello earth!' ,'Hello programmer!' ,最后return 0.
         下面初略介绍下上面用到的几个宏定义:
DBUG_PUSH ("d:t:O");  设置调试的启动参数,参数列表在MySQL手册上也有:

标记 描述
d         允许对当前状态从DBUG_<N>宏输出。可能跟着一列关键词,这些关键词仅对那些带有          
关键词的DBUG宏选择输出。一个空的关键词列意味着对所有宏输出。
      
D         在每个调试起输出行后延迟。参量一个十分之一秒为单位来延迟的数,它受限于机器的能          
力。比如 -#D,20 指定一个2秒的延迟。
      
f         限制调试和/或跟踪,以及简单设定于列出名字的函数。注意,空列将禁止所用函数。应          
该给出适当的d 或 t 标记,如果它们被允许了,这个标记仅限制它们的动作。
      
F 对调试或跟踪输出的每一行识别源文件名。
i 对调试或跟踪输出的每一行用PID或线程ID识别进程。
g         允许解析,创建名为的dbugmon.out文件,它包含可用来简单设定程序的信息。可能跟着          
一列关键词,它们是选择只对列中的函数做简单设定。一个空列意味着所有函数都要考虑          
到。
      
L 为调试或跟踪输出的每一行识别源文件行号。
n 为调试或跟踪输出的每一行打印当前函数嵌套深度。
N 给调试输出的每一行编号。
o 重定向调试器输出流到指定文件。默认输出是stderr 文件。
O         类似于 o,但是文件在每次写操作之间被冲刷。当需要之时,文件在每次写操作之间被关          
闭然后重新打开。
      
p         限制调试器作用于指定进程。为使调试器动作,一个进程必须用DBUG_PROCESS宏来识          
别,且匹配列表中的一个。
      
P 为调试或跟踪输出的每一行打印当前进程名字。
r         当推出一个新状态时,不继承前状态的操作嵌套深度级别。当输出在左边空白开始时有          
用。
      
S         在每个调试过的函数做_sanity(_file_,_line_)函数直到 _sanity() 返回不同于0的结果。(大多          
数的时候与safemalloc 一起用来找出内存漏洞)。
      
t         允许函数调用/退出跟踪行。可能跟着一个给出最大跟踪级别的数字列(只含一个修改          
量),超过这个数字,调试中或跟踪中的宏不能产生任何输出。 默认为一个编译时间选          
项。
      

DBUG_PROCESS ("example"); 设置进程名为example
        DBUG_ENTER ("sub1"); 表示进入函数sub1
        DBUG_PRINT ("info", ("Got argument: '%s'", arg)); 和printf效果差不多,打印出需要的调试信息。
       DBUG_RETURN (0);  在return 0 的基础上,打印出return 0的调试信息。
三、小结

本文简单介绍了DBUG的使用方法,没有深究,源码很少,却很实用,在源码的注释部分,我看到了是Fred Fish1987年写的,呃,我才刚出生....,没想到现在还在看那时候的代码,可能这就是所谓的经典吧。
       兄弟们,你们还在为复杂环境下的bug调试而苦恼么?还在为堆栈被写乱掉无从下手而凌乱么?淡定吧,一起来用DBUG吧~~

上一篇:jQuery实现全选效果【转】


下一篇:Percona Live 2016 PPT整理-zhaiwx_yinfeng