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 to
98           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, 2011, Oracle and/or its affiliates. All rights
110       reserved.
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

SEE ALSO

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

AUTHOR

133       Oracle Corporation (http://dev.mysql.com/).
134
135
136
137MySQL                             10/19/2011              MYSQL_CLIENT_TEST(1)
Impressum