1MYSQL_CLIENT_TEST(1)         MySQL 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 MySQL
16       client API that cannot be tested using mysqltest and its test language.
17       mysql_client_test_embedded is similar but used for testing the embedded
18       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 MySQL is built with debugging support. The
52           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 MySQL 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 MySQL 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
110
111       This documentation is free software; you can redistribute it and/or
112       modify it only under the terms of the GNU General Public License as
113       published by the Free Software Foundation; version 2 of the License.
114
115       This documentation is distributed in the hope that it will be useful,
116       but WITHOUT ANY WARRANTY; without even the implied warranty of
117       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
118       General Public License for more details.
119
120       You should have received a copy of the GNU General Public License along
121       with the program; if not, write to the Free Software Foundation, Inc.,
122       51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA or see
123       http://www.gnu.org/licenses/.
124
125

SEE ALSO

127       For more information, please refer to the MySQL Reference Manual, which
128       may already be installed locally and which is also available online at
129       http://dev.mysql.com/doc/.
130

AUTHOR

132       Sun Microsystems, Inc. (http://www.mysql.com/).
133
134
135
136MySQL                             03/31/2010              MYSQL_CLIENT_TEST(1)
Impressum