1MARIADB-CLIENT-TEST(1)      MariaDB Database System     MARIADB-CLIENT-TEST(1)
2
3
4

NAME

6       mariadb-client-test - test client API (mysql_client_test is now a
7       symlink to mariadb-client-test)
8       mariadb-client-test-embedded - test client API for embedded server
9       (mysql_client_test_embedded is now a symlink to mariadb-client-test-
10       embedded)
11

SYNOPSIS

13       mysql_client_test [options] [test_name] ...
14
15       mysql_client_test_embedded [options] [test_name] ...
16

DESCRIPTION

18       The mysql_client_test program is used for testing aspects of the
19       MariaDB client API that cannot be tested using mysqltest and its test
20       language.  mysql_client_test_embedded is similar but used for testing
21       the embedded server. Both programs are run as part of the test suite.
22
23       The source code for the programs can be found in in
24       tests/mysql_client_test.c in a source distribution. The program serves
25       as a good source of examples illustrating how to use various features
26       of the client API.
27
28       mysql_client_test is used in a test by the same name in the main tests
29       suite of mysql-test-run.pl but may also be run directly. Unlike the
30       other programs listed here, it does not read an external description of
31       what tests to run. Instead, all tests are coded into the program, which
32       is written to cover all aspects of the C language API.
33
34       mysql_client_test supports the following options:
35
36       •   --help, -?
37
38           Display a help message and exit.
39
40       •   --basedir=dir_name, -b dir_name
41
42           The base directory for the tests.
43
44       •   --count=count, -t count
45
46           The number of times to execute the tests.
47
48       •   --database=db_name, -D db_name
49
50           The database to use.
51
52       •   --debug[=debug_options], -#[debug_options]
53
54           Write a debugging log if MariaDB is built with debugging support.
55           The default debug_options value is
56           ´d:t:o,/tmp/mysql_client_test.trace´.
57
58       •   --getopt-ll-test=option, -g option
59
60           Option to use for testing bugs in the getopt library.
61
62       •   --host=host_name, -h host_name
63
64           Connect to the MariaDB server on the given host.
65
66       •   --password[=password], -p[password]
67
68           The password to use when connecting to the server. If you use the
69           short option form (-p), you cannot have a space between the option
70           and the password. If you omit the password value following the
71           --password or -p option on the command line, you are prompted for
72           one.
73
74       •   --port=port_num, -P port_num
75
76           The TCP/IP port number to use for the connection.
77
78       •   --server-arg=arg, -A arg
79
80           Argument to send to the embedded server.
81
82       •   --show-tests, -T
83
84           Show all test names.
85
86       •   --silent, -s
87
88           Be more silent.
89
90       •   --socket=path, -S path
91
92           The socket file to use when connecting to localhost (which is the
93           default host).
94
95       •   --testcase, -c
96
97           The option is used when called from mysql-test-run.pl, so that
98           mysql_client_test may optionally behave in a different way than if
99           called manually, for example by skipping some tests. Currently,
100           there is no difference in behavior but the option is included in
101           order to make this possible.
102
103       •   --user=user_name, -u user_name
104
105           The MariaDB user name to use when connecting to the server.
106
107       •   -v dir_name, --vardir=dir_name
108
109           The data directory for tests. The default is mysql-test/var.
110

112       Copyright © 2007, 2010, Oracle and/or its affiliates, 2010-2019 MariaDB
113       Foundation
114
115       This documentation is free software; you can redistribute it and/or
116       modify it only under the terms of the GNU General Public License as
117       published by the Free Software Foundation; version 2 of the License.
118
119       This documentation is distributed in the hope that it will be useful,
120       but WITHOUT ANY WARRANTY; without even the implied warranty of
121       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
122       General Public License for more details.
123
124       You should have received a copy of the GNU General Public License along
125       with the program; if not, write to the Free Software Foundation, Inc.,
126       51 Franklin Street, Fifth Floor, Boston, MA 02110-1335 USA or see
127       http://www.gnu.org/licenses/.
128
129

SEE ALSO

131       For more information, please refer to the MariaDB Knowledge Base,
132       available online at https://mariadb.com/kb/
133

AUTHOR

135       MariaDB Foundation (http://www.mariadb.org/).
136
137
138
139MariaDB 10.5                     27 June 2019           MARIADB-CLIENT-TEST(1)
Impressum