5.9.4 DBUG 包_MySQL 8.0 参考手册

MySQL 8.0 参考手册 / 第 5 章 MySQL 服务器管理 / 5.9 调试 MySQL / 5.9.4 DBUG 包

5.9.4 DBUG 包

MySQL 服务器和大多数 MySQL 客户端都是使用最初由 Fred Fish 创建的 DBUG 包编译的。当您配置 MySQL 进行调试时，此包可以获取程序正在执行的操作的跟踪文件。请参阅第 5.9.1.2 节，“创建跟踪文件”。

本节总结了您可以在命令行的调试选项中为已使用调试支持构建的 MySQL 程序指定的参数值。

可以通过使用或选项调用程序来使用 DBUG 包。如果您指定或选项没有值，大多数 MySQL 程序使用默认值。服务器默认在 Unix 和 Windows 上。这个默认的效果是： --debug[=debug_options]-# [debug_options]--debug-#debug_optionsd:t:i:o,/tmp/mysqld.traced:t:i:O,\mysqld.trace

d：为所有调试宏启用输出
t: 跟踪函数调用和退出
i: 添加 PID 到输出线
o,/tmp/mysqld.trace, O,\mysqld.trace: 设置调试输出文件。

无论平台如何，大多数客户端程序都使用默认 debug_options值。d:t:o,/tmp/program_name.trace

以下是一些示例调试控制字符串，因为它们可能在 shell 命令行上指定：

--debug=d:t
--debug=d:f,main,subr1:F:L:t,20
--debug=d,input,output,files:n
--debug=d:t:i:O,\\mysqld.trace

对于mysqld，还可以通过设置 debug系统变量在运行时更改 DBUG 设置。此变量具有全局值和会话值：

mysql> SET GLOBAL debug = 'debug_options';
mysql> SET SESSION debug = 'debug_options';

更改全局debug值需要足够的权限来设置全局系统变量。更改会话debug值需要足够的权限来设置受限会话系统变量。请参阅第 5.1.9.1 节，“系统变量权限”。

该debug_options值是一系列以冒号分隔的字段：

field_1:field_2:...:field_N

值中的每个字段都包含一个强制性标志字符，前面可以有一个+或 -字符，后面可以有一个逗号分隔的修饰符列表：

[+|-]flag[,modifier,modifier,...,modifier]

下表描述了允许的标志字符。无法识别的标志字符将被静默忽略。

旗帜	描述
`d`	`XXX` 为当前状态启用 DBUG_ 宏的输出。可能后跟一个关键字列表，它只为具有该关键字的 DBUG 宏启用输出。空的关键字列表启用所有宏的输出。在 MySQL 中，要启用的常见调试宏关键字是 `enter`、`exit`、 `error`、`warning`、 `info`和`loop`。
`D`	在每个调试器输出行之后延迟。参数是延迟，以十分之一秒为单位，取决于机器的能力。例如，`D,20` 指定两秒的延迟。
`f`	将调试、跟踪和分析限制在命名函数列表中。空列表启用所有功能。仍然必须给出适当的`d`或标志；`t`此标志仅在启用时限制它们的操作。
`F`	确定每行调试或跟踪输出的源文件名。
`i`	使用每行调试或跟踪输出的 PID 或线程 ID 标识进程。
`L`	确定每行调试或跟踪输出的源文件行号。
`n`	打印每行调试或跟踪输出的当前函数嵌套深度。
`N`	对每行调试输出进行编号。
`o`	将调试器输出流重定向到指定文件。默认输出是`stderr`.
`O`	喜欢`o`，但是文件在每次写入之间确实被刷新了。需要时，文件会在每次写入之间关闭并重新打开。
`p`	将调试器操作限制为指定的进程。一个进程必须用 `DBUG_PROCESS`宏标识并与列表中的一个相匹配，以便调试器操作发生。
`P`	打印每行调试或跟踪输出的当前进程名称。
`r`	推送新状态时，不要继承前一个状态的函数嵌套层级。当输出从左边距开始时很有用。
`S`	`_sanity(_file_,_line_)`在每个调试的函数上执行函数，直到`_sanity()` 返回不同于 0 的值。
`t`	启用函数调用/退出跟踪行。可能后跟一个列表（仅包含一个修饰符），给出一个数字最大跟踪级别，超过此级别，调试或跟踪宏都不会出现任何输出。默认是编译时选项。

修饰符的前导+或-字符和尾随列表用于标志字符，例如dorf可以为所有适用的修饰符或其中的一些启用调试操作：

没有前导+or -，标志值被设置为给定的修饰符列表。
使用前导+or -，列表中的修饰符被添加到当前修饰符列表或从中减去。

以下示例显示了这对 d标志的作用。所有调试宏的空d列表启用输出。非空列表只允许输出列表中的宏关键字。

这些语句将d值设置为给定的修饰符列表：

mysql> SET debug = 'd';
mysql> SELECT @@debug;
+---------+
| @@debug |
+---------+
| d       |
+---------+
mysql> SET debug = 'd,error,warning';
mysql> SELECT @@debug;
+-----------------+
| @@debug         |
+-----------------+
| d,error,warning |
+-----------------+

A leading +or-添加到当前值或从当前d值中减去：

mysql> SET debug = '+d,loop';
mysql> SELECT @@debug;
+----------------------+
| @@debug              |
+----------------------+
| d,error,warning,loop |
+----------------------+

mysql> SET debug = '-d,error,loop';
mysql> SELECT @@debug;
+-----------+
| @@debug   |
+-----------+
| d,warning |
+-----------+

添加到“所有启用的宏”结果没有变化：

mysql> SET debug = 'd';
mysql> SELECT @@debug;
+---------+
| @@debug |
+---------+
| d       |
+---------+

mysql> SET debug = '+d,loop';
mysql> SELECT @@debug;
+---------+
| @@debug |
+---------+
| d       |
+---------+

禁用所有启用的宏会d 完全禁用该标志：

mysql> SET debug = 'd,error,loop';
mysql> SELECT @@debug;
+--------------+
| @@debug      |
+--------------+
| d,error,loop |
+--------------+

mysql> SET debug = '-d,error,loop';
mysql> SELECT @@debug;
+---------+
| @@debug |
+---------+
|         |
+---------+