DBUG软件包
MySQL服务器和大多数MySQL客户端使用最初由Fred Fish创建的DBUG包进行编译。当您配置了MySQL进行调试后,该软件包可以获取程序正在执行的跟踪文件。请参见“创建跟踪文件”。
本节总结了您可以在命令行的调试选项中为使用调试支持构建的MySQL程序指定的参数值。
可以通过使用或选项调用程序来使用DBUG软件包。如果指定不带值的or 选项,则大多数MySQL程序都使用默认值。服务器默认值在Unix和 Windows上。此默认设置的效果是:--debug[=debug_options]
-#[debug_options]
--debug
-#
debug_options
d:t:i:o,/tmp/mysqld.trace
d: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
值需要足够的特权来设置受限制的会话系统变量。请参见“系统变量特权”。
该debug_options
值是用冒号分隔的字段的序列:
field_1:field_2:...:field_N
值中的每个字段都包含一个强制性标志字符,可以选择在其前面加上+
或-
字符,并可以选择在其后跟随一个逗号分隔的修饰符列表:
[+|-]flag[,modifier,modifier,...,modifier]
下表描述了允许的标志字符。无法识别的标志字符将被静默忽略。
旗 | 描述 |
---|---|
| 启用来自DBUG_ 在MySQL中,公共调试宏关键字启用是 |
| 每条调试器输出线之后的延迟。参数是延迟(以十分之一秒为单位),取决于机器的功能。例如, |
| 将调试,跟踪和性能分析限制为命名函数的列表。空列表将启用所有功能。仍然必须给出适当的 |
| 标识调试或跟踪输出的每一行的源文件名。 |
| 使用调试或跟踪输出的每一行的PID或线程ID标识进程。 |
| 标识调试或跟踪输出的每一行的源文件行号。 |
| 打印每行调试或跟踪输出的当前函数嵌套深度。 |
| 为调试输出的每一行编号。 |
| 将调试器输出流重定向到指定的文件。默认输出为 |
| 类似于 |
| 将调试器操作限制为指定的进程。必须使用 |
| 为调试或跟踪输出的每一行打印当前进程名称。 |
| 推送新状态时,请勿继承前一状态的功能嵌套级别。当输出从左边距开始时很有用。 |
|
|
| 启用函数调用/退出跟踪线。可能紧随其后的是一个列表(仅包含一个修饰符),该列表给出了最大跟踪级别的数值,超过该级别时,调试或跟踪宏都不会输出。默认值为编译时间选项。 |
修饰符的前导+
或-
字符和尾随列表用于标记字符,例如d
或f
可以为所有适用的修饰符或其中一些修饰符启用调试操作:
- 如果没有前导
+
或-
,则标志值将完全设置为给定的修饰符列表。 - 用
+
或-
开头,列表中的修饰符将添加到当前修饰符列表中或从当前修饰符列表中减去。
以下示例显示了此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 | +----------------- +
当前值的前导+
或-
加或减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 | +--------- + | | +--------- +