1MYSQL_CLIENT_TEST(1) MariaDB Database System MYSQL_CLIENT_TEST(1)
2
3
4
6 mysql_client_test - test client API
7 mysql_client_test_embedded - test client API for embedded server
8
10 mysql_client_test [options] [test_name] ...
11
12 mysql_client_test_embedded [options] [test_name] ...
13
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-2015 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-1301 USA or see
124 http://www.gnu.org/licenses/.
125
126
128 For more information, please refer to the MariaDB Knowledge Base,
129 available online at https://mariadb.com/kb/
130
132 MariaDB Foundation (http://www.mariadb.org/).
133
134
135
136MariaDB 10.3 9 May 2017 MYSQL_CLIENT_TEST(1)