1MYSQL_CLIENT_TEST(1)        MariaDB Database System       MYSQL_CLIENT_TEST(1)
2
3
4

NAME

6       mysql_client_test - test client API
7       mysql_client_test_embedded - test client API for embedded server
8

SYNOPSIS

10       mysql_client_test [options] [test_name] ...
11
12       mysql_client_test_embedded [options] [test_name] ...
13

DESCRIPTION

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

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

SEE ALSO

128       For more information, please refer to the MariaDB Knowledge Base,
129       available online at https://mariadb.com/kb/
130

AUTHOR

132       MariaDB Foundation (http://www.mariadb.org/).
133
134
135
136MariaDB 10.5                     27 June 2019             MYSQL_CLIENT_TEST(1)
Impressum