Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
MYSQLTEST(1)		    MariaDB Database System		  MYSQLTEST(1)

       mysqltest - program to run test cases
       mysqltest_embedded - program to run embedded test cases

       mysqltest [options] [db_name]

       mysqltest_embedded [options] [db_name]

       The mysqltest program runs a test case against a	MariaDB	server and
       optionally compares the output with a result file. This program reads
       input written in	a special test language. Typically, you	invoke
       mysqltest via rather than invoking it directly.

       mysqltest_embedded is similar but is built with support for the
       libmysqld embedded server.

       Features	of mysqltest:

       o   Can send SQL	statements to MariaDB servers for execution

       o   Can execute external	shell commands

       o   Can test whether the	result from an SQL statement or	shell command
	   is as expected

       o   Can connect to one or more standalone mysqld	servers	and switch
	   between connections

       o   Can connect to an embedded server (libmysqld), if MariaDB is
	   compiled with support for libmysqld.	(In this case, the executable
	   is named mysqltest_embedded rather than mysqltest.)

       By default, mysqltest reads the test case on the	standard input.	To run
       mysqltest this way, you normally	invoke it like this:

	   shell> mysqltest [options] [db_name]	< test_file

       You can also name the test case file with a --test-file=file_name

       The exit	value from mysqltest is	0 for success, 1 for failure, and 62
       if it skips the test case (for example, if after	checking some
       preconditions it	decides	not to run the test).

       mysqltest supports the following	options:

       o   --help, -?

	   Display a help message and exit.

       o   --basedir=dir_name, -b dir_name

	   The base directory for tests.

       o   --character-sets-dir=path

	   The directory where character sets are installed.

       o   --compress, -C

	   Compress all	information sent between the client and	the server if
	   both	support	compression.

       o   --connect-timeout=num

	   This	can be used to set the MYSQL_OPT_CONNECT_TIMEOUT parameter of
	   mysql_options to change the number of seconds before	an
	   unsuccessful	connection attempt times out.

       o   --continue-on-error

	   Continue test even if we got	an error. This is mostly useful	when
	   testing a storage engine to see what	from a test file it can
	   execute, or to find all syntax errors in a newly created big	test

       o   --cursor-protocol

	   Use cursors for prepared statements.

       o   --database=db_name, -D db_name

	   The default database	to use.

       o   --debug[=debug_options], -#[debug_options]

	   Write a debugging log if MariaDB is built with debugging support.
	   The default debug_options value is

       o   --debug-check

	   Print some debugging	information when the program exits.

       o   --debug-info

	   Print debugging information and memory and CPU usage	statistics
	   when	the program exits.

       o   --host=host_name, -h	host_name

	   Connect to the MariaDB server on the	given host.

       o   --logdir=dir_name

	   The directory to use	for log	files.

       o   --mark-progress

	   Write the line number and elapsed time to test_file.progress.

       o   --max-connect-retries=num

	   The maximum number of connection attempts when connecting to

       o   --max-connections=num

	   The maximum number of simultaneous server connections per client
	   (that is, per test).	If not set, the	maximum	is 128.	Minimum
	   allowed limit is 8, maximum is 5120.

       o   --no-defaults

	   Do not read default options from any	option files. If used, this
	   must	be the first option.

       o   --non-blocking-api

	   Use the non-blocking	client API for communication.

       o   --overlay-dir=dir_name

	   Overlay directory.

       o   --password[=password], -p[password]

	   The password	to use when connecting to the server. If you use the
	   short option	form (-p), you cannot have a space between the option
	   and the password. If	you omit the password value following the
	   --password or -p option on the command line,	you are	prompted for

       o   --plugin-dir=dir_name

	   Directory for client-side plugins.

       o   --port=port_num, -P port_num

	   The TCP/IP port number to use for the connection or 0 for default
	   to, in order	of preference, my.cnf, $MYSQL_TCP_PORT,	/etc/services,
	   built-in default (3306).

       o   --prologue=name

	   Include the contents	of the given file before processing the
	   contents of the test	file. The included file	should have the	same
	   format as other mysqltest test files. This option has the same
	   effect as putting a --source	file_name command as the first line of
	   the test file.

       o   --protocol={TCP|SOCKET|PIPE|MEMORY}

	   The connection protocol to use for connecting to the	server.	It is
	   useful when the other connection parameters normally	would cause a
	   protocol to be used other than the one you want.

       o   --ps-protocol

	   Use the prepared-statement protocol for communication.

       o   --quiet

	   Suppress all	normal output. This is a synonym for --silent.

       o   --record, -r

	   Record the output that results from running the test	file into the
	   file	named by the --result-file option, if that option is given. It
	   is an error to use this option without also using --result-file.

       o   --result-file=file_name, -R file_name

	   This	option specifies the file for test case	expected results.
	   --result-file, together with	--record, determines how mysqltest
	   treats the test actual and expected results for a test case:

	   o   If the test produces no results,	mysqltest exits	with an	error
	       message to that effect, unless --result-file is given and the
	       named file is an	empty file.

	   o   Otherwise, if --result-file is not given, mysqltest sends test
	       results to the standard output.

	   o   With --result-file but not --record, mysqltest reads the
	       expected	results	from the given file and	compares them with the
	       actual results. If the results do not match, mysqltest writes a
	       .reject file in the same	directory as the result	file, outputs
	       a diff of the two files,	and exits with an error.

	   o   With both --result-file and --record, mysqltest updates the
	       given file by writing the actual	test results to	it.

       o   --result-format-version=#

	   Version of the result file format to	use.

       o   --server-arg=value, -A value

	   Pass	the argument as	an argument to the embedded server. For
	   example, --server-arg=--tmpdir=/tmp or --server-arg=--core. Up to
	   64 arguments	can be given.

       o   --server-file=file_name, -F file_name

	   Read	arguments for the embedded server from the given file. The
	   file	should contain one argument per	line.

       o   --silent, -s

	   Suppress all	normal output.

       o   --sleep=num,	-T num

	   Cause all sleep commands in the test	case file to sleep num
	   seconds. This option	does not affect	real_sleep commands.

	   An option value of 0	can be used, which effectively disables	sleep
	   commands in the test	case.

       o   --socket=path, -S path

	   The socket file to use when connecting to localhost (which is the
	   default host).

       o   --sp-protocol

	   Execute DML statements within a stored procedure. For every DML
	   statement, mysqltest	creates	and invokes a stored procedure that
	   executes the	statement rather than executing	the statement

       o   --ssl

	   Enable SSL for connection (automatically enabled with other flags).
	   Disable with	--skip-ssl.

       o   --ssl-ca=name

	   CA file in PEM format (check	OpenSSL	docs, implies --ssl).

       o   --ssl-capath=name

	   CA directory	(check OpenSSL docs, implies --ssl).

       o   --ssl-cert=name

	   X509	cert in	PEM format (check OpenSSL docs,	implies	--ssl).

       o   --ssl-cipher=name

	   SSL cipher to use (check OpenSSL docs, implies --ssl).

       o   --ssl-key=name

	   X509	key in PEM format (check OpenSSL docs, implies --ssl).

       o   --ssl-crl=name

	   Certificate revocation list (check OpenSSL docs, implies --ssl).

       o   --ssl-crlpath=name

	   Certificate revocation list path (check OpenSSL docs, implies

       o   --ssl-verify-server-cert

	   Verify server's "Common Name" in its	cert against hostname used
	   when	connecting. This option	is disabled by default.

       o   --suite-dir=dir_name

	   Suite directory.

       o   --tail-lines=nn

	   Specify how many lines of the result	to include in the output if
	   the test fails because an SQL statement fails. The default is 0,
	   meaning no lines of result printed.

       o   --test-file=file_name, -x file_name

	   Read	test input from	this file. The default is to read from the
	   standard input.

       o   --timer-file=file_name, -m file_name

	   If given, the number	of microseconds	spent running the test will be
	   written to this file. This is used by for its

       o   --tmpdir=dir_name, -t dir_name

	   The temporary directory where socket	files are created.

       o   --user=user_name, -u	user_name

	   The MariaDB user name to use	when connecting	to the server.

       o   --verbose, -v

	   Verbose mode. Print out more	information about what the program

       o   --version, -V

	   Display version information and exit.

       o   --view-protocol

	   Every SELECT	statement is wrapped inside a view.

       Copyright (C) 2007, 2010, Oracle	and/or its affiliates, 2010-2019
       MariaDB Foundation

       This documentation is free software; you	can redistribute it and/or
       modify it only under the	terms of the GNU General Public	License	as
       published by the	Free Software Foundation; version 2 of the License.

       This documentation is distributed in the	hope that it will be useful,
       but WITHOUT ANY WARRANTY; without even the implied warranty of
       General Public License for more details.

       You should have received	a copy of the GNU General Public License along
       with the	program; if not, write to the Free Software Foundation,	Inc.,
       51 Franklin Street, Fifth Floor,	Boston,	MA 02110-1335 USA or see

       For more	information, please refer to the MariaDB Knowledge Base,
       available online	at

       MariaDB Foundation (

MariaDB	10.5			 27 June 2019			  MYSQLTEST(1)


Want to link to this manual page? Use this URL:

home | help