MySQL Internals Manual  /  ...  /  Debug Sync Activation/Deactivation

24.6.2 Debug Sync Activation/Deactivation

The Debug Sync facility is an optional part of the MySQL server. It is enabled in a debug server by default.

The Debug Sync Facility, when compiled in, is disabled by default. To enable it, start mysqld with the --debug-sync-timeout[=N] option, where N is a timeout value greater than 0. N becomes the default timeout for the WAIT_FOR action of individual synchronization points. If N is 0, Debug Sync stays disabled. If the option is given without a value, the timeout is set to 300 seconds.

The DEBUG_SYNC system variable is the user interface to the Debug Sync facility. If Debug Sync is not compiled in, this variable is not available. If compiled in, the global DEBUG_SYNC value is read only and indicates whether the facility is enabled. By default, Debug Sync is disabled and the value of DEBUG_SYNC is "OFF". If the server is started with --debug-sync-timeout=N, where N is a timeout value greater than 0, Debug Sync is enabled and the value of DEBUG_SYNC is "ON - current signal" followed by the signal name. Also, N becomes the default timeout for individual synchronization points.

The session value can be read by any user and will have the same value as the global variable. The session value can be set by users that have the SUPER privilege to control synchronization points.

Setting the DEBUG_SYNC system variable requires the 'SUPER' privilege. You cannot read back the string that you assigned to the variable, unless you assign the value that the variable does already have. But that would give a parse error. A syntactically correct string is parsed into a debug synchronization point action and stored apart from the variable value.

The Debug Sync facility is enabled by default in the test suite, but can be disabled with:

mysql-test-run.pl ... --debug-sync-timeout=0 ... 

Likewise, the default wait timeout can be set:

mysql-test-run.pl ... --debug-sync-timeout=10 ... 

For test cases that require the Debug Sync facility, include the following line in the test case file:

--source include/have_debug_sync.inc


User Comments
Sign Up Login You must be logged in to post a comment.