MySQL源码学习——DBUG调试

本文涉及的产品
云数据库 RDS MySQL,集群系列 2核4GB
推荐场景:
搭建个人博客
RDS MySQL Serverless 基础系列,0.5-2RCU 50GB
云数据库 RDS MySQL,高可用系列 2核4GB
简介: 一、前言         在规模稍微大点的项目中,为了方便快速找到bug的所在,我们往往需要在代码中加入一些调试用的代码,比如加入一些printf,打印出一些重点的信息;加入assert,进行断言判断。

一、前言

         在规模稍微大点的项目中,为了方便快速找到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
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
/*
  * This file is Public Domain
  *
  * Just short example, how Fred Fish's dbug package should be used
  *
  * Tonu Samuel <tonu @spam.ee="">
  *
  */
#include "dbug.h"
 
static  int  sub1 ( void );
static  void  sub2 ( char  *arg);
 
static  int
sub1 ( void )
{
   DBUG_ENTER ( "sub1" );
 
   sub2 ( "Hello world!" );
   sub2 ( "Hello earth!" );
   sub2 ( "Hello programmer!" );
 
   DBUG_RETURN (0);
}
 
 
static  void
sub2 ( char  *arg)
{
   DBUG_ENTER ( "sub2" );
   DBUG_PRINT ( "info" , ( "Got argument: '%s'" , arg));
 
   printf  ( "%s\n" , arg);
 
   DBUG_VOID_RETURN;
}
 
 
int
main ( void )
{
   int  ret = 0;
   DBUG_PUSH ( "d:t:O" );
   DBUG_PROCESS ( "example" );
 
   ret = sub1 ();
   DBUG_PRINT ( "info" , ( "Returned value: %d" , ret));
 
   return  0;
}</tonu>

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

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

运行example输出如下:

1
2
3
4
5
6
7
8
9
10
11
>sub1
| >sub2
| | info: Got argument:  'Hello world!'
Hello world!
| <sub2 |= "" >sub2
| | info: Got argument:  'Hello earth!'
Hello earth!
| <sub2 |= "" >sub2
| | info: Got argument:  'Hello programmer!'
Hello programmer!
| <sub2 pre= ""  0= "" >< value: Returned info: <sub1>< /sub1 >< /sub2 >< /sub2 >< /sub2 >
          结合源码,我们通过打印出来的信息,可以很容易的看出调试信息所表达的意思:

函数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吧~~

踏着落叶,追寻着我的梦想。转载请注明出处
相关实践学习
如何在云端创建MySQL数据库
开始实验后,系统会自动创建一台自建MySQL的 源数据库 ECS 实例和一台 目标数据库 RDS。
全面了解阿里云能为你做什么
阿里云在全球各地部署高效节能的绿色数据中心,利用清洁计算为万物互联的新世界提供源源不断的能源动力,目前开服的区域包括中国(华北、华东、华南、香港)、新加坡、美国(美东、美西)、欧洲、中东、澳大利亚、日本。目前阿里云的产品涵盖弹性计算、数据库、存储与CDN、分析与搜索、云通信、网络、管理与监控、应用服务、互联网中间件、移动服务、视频服务等。通过本课程,来了解阿里云能够为你的业务带来哪些帮助 &nbsp; &nbsp; 相关的阿里云产品:云服务器ECS 云服务器 ECS(Elastic Compute Service)是一种弹性可伸缩的计算服务,助您降低 IT 成本,提升运维效率,使您更专注于核心业务创新。产品详情: https://www.aliyun.com/product/ecs
相关文章
|
8天前
|
存储 SQL 关系型数据库
2024Mysql And Redis基础与进阶操作系列(1)作者——LJS[含MySQL的下载、安装、配置详解步骤及报错对应解决方法]
Mysql And Redis基础与进阶操作系列(1)之[MySQL的下载、安装、配置详解步骤及报错对应解决方法]
|
6月前
|
关系型数据库 MySQL 数据安全/隐私保护
【MySQL】补充和navicat的一些简单使用
【MySQL】补充和navicat的一些简单使用
36 0
|
SQL 安全 关系型数据库
MySQL亲手编写万文复习(二)
MySQL亲手编写万文复习
83 0
MySQL亲手编写万文复习(二)
|
SQL 存储 机器学习/深度学习
MySQL亲手编写万文复习(一)
MySQL亲手编写万文复习
52 0
|
安全 关系型数据库 MySQL
MySQL亲手编写万文复习(三)
MySQL亲手编写万文复习
40 0
|
SQL Oracle 关系型数据库
初识MySQL下载与安装【快速掌握知识点】
初识MySQL下载与安装【快速掌握知识点】
168 0
初识MySQL下载与安装【快速掌握知识点】
|
SQL Oracle 关系型数据库
【JavaWeb入门】:MySQL 基础语句
前面讲过,SQL 分类如下: DDL:数据定义语言,用来定义数据库对象,如数据库,表,列等; DML:数据操作语言,用来对数据库中表的数据进行增删改; DQL:数据查询语言,用来查询数据库中表的记录(数据); DCL:数据控制语言,用来定义数据库的访问权限和安全级别,及创建用户; 下面记录了 MySQL 中常用的 SQL 语句。
86 0
|
关系型数据库 MySQL
mysql下载源码方法
方法一 进入mysql官网:http://dev.mysql.com/downloads/mysql/ 选择相关的平台下载:     3.选择Source Code 选型后,拉倒网页下方,选择要下载的源码包         4.
12324 2
|
NoSQL 关系型数据库 MySQL
|
存储 关系型数据库 MySQL
终于有人将MySQL的安装讲明白了
终于有人将MySQL的安装讲明白了
160 0
终于有人将MySQL的安装讲明白了