← Back to branch summary

~clint-fewbar/ubuntu/lucid/mysql-dfsg-5.1/increase-killtimeout

« back to all changes in this revision

Viewing changes to man/mysql-test-run.pl.1

  • Committer: Bazaar Package Importer
  • Author(s): Mathias Gug, Mathias Gug
  • Date: 2009-08-05 11:40:21 UTC
  • mfrom: (1.1.3 upstream) (0.1.9 sid)
  • Revision ID: james.westby@ubuntu.com-20090805114021-59bj0bgfm2ufllbk
Tags: 5.1.37-1ubuntu1
https://launchpad.net/bugs/259477
https://launchpad.net/bugs/310211
https://launchpad.net/bugs/201799
https://launchpad.net/bugs/316974
http://bugs.debian.org/314785
http://bugs.debian.org/324834
http://bugs.debian.org/435165
http://bugs.debian.org/444216
https://launchpad.net/bugs/344816
https://launchpad.net/bugs/354188
https://launchpad.net/bugs/319843
[ Mathias Gug ]
* Merge from debian unstable and 5.0, remaining changes:
  - debian/control:
    + Properly upgrade libmysqlclient16-dev packages to
    libmysqlclient-dev:
      * Make libmysqlclient16-dev a transitional package depending on
        libmysqlclient-dev.
      * Make libmysqlclient-dev replace libmysqlclient16-dev.
    + Don't provide a libmysqlclient15-dev package as long as there are
      packages still build-depending on libmysqlclient15-dev and
      mysql-dsfg-5.0 is in the archive.
    + Lower mailx from a Recommends to a Suggests to avoid pulling in
      a full MTA on all installs of mysql-server. (LP: #259477)
  - debian/rules:
    + added -fno-strict-aliasing to CFLAGS to get around mysql testsuite
      build failures.
  - debian/additions/debian-start.inc.sh: support ANSI mode (LP: #310211)
  - Add AppArmor profile:
    - debian/apparmor-profile: apparmor profile.
    - debian/rules, debian/mysql-server-5.1.files: install apparmor profile.
    - debian/mysql-server-5.1.dirs: add etc/apparmor.d/force-complain
    - debian/mysql-server-5.1.postrm: remove symlink in force-complain/ on
      purge.
    - debian/mysql-server-5.1.README.Debian: add apparmor documentation.
    - debian/additions/my.cnf: Add warning about apparmor. (LP: #201799)
    - debian/mysql-server-5.1.postinst: reload apparmor profiles.
  - debian/additions/my.cnf: remove language option. Error message files are
    located in a different directory in MySQL 5.0. Setting the language
    option to use /usr/share/mysql/english breaks 5.0. Both 5.0 and 5.1
    use a default value that works. (LP: #316974)
  - debian/mysql-server-5.1.mysql.init:
    + Clearly indicate that we do not support running multiple instances
      of mysqld by duplicating the init script.
      (closes: #314785, #324834, #435165, #444216)
    + Properly parameterize all existing references to the mysql config
      file (/etc/mysql/my.cnf).
  - debian/mysql-server-5.1.postinst: Clear out the second password
    when setting up mysql. (LP: #344816)
  - mysql-server-core-5.1 package for files needed by Akonadi:
    + debian/control: create mysql-server-core-5.1 package.
    + debian/mysql-server-core-5.1.files, debian/mysql-server-5.1.files:
      move core mysqld files to mysql-server-core-5.1 package.
* debian/libmysqlclient16.symbols.amd64: remove amd64 symbols as it has
  not been correctly generated in Debian.
* Add Apport hook: (LP: #354188)
  - debian/mysql-server-5.1.py: apport package hook.
  - debian/mysql-server-5.1.files, debian/rules: install apport package
    hook.
* debian/additions/my.cnf: 
  - drop old_password option.
  - fix commented logging options to use general_log and general_log_file.
* Dropped - accepted in Debian:
  - debian/mysql-server-5.1.config:
    + ask for MySQL root password at priority high instead of medium so
      that the password prompt is seen on a default install. (LP: #319843)
    + don't ask for root password when upgrading from a 5.0 install.

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/mysql-test-run.pl.1
1
 
.\"     Title: \fBmysql\-test\-run.pl\fR
2
 
.\"    Author: 
3
 
.\" Generator: DocBook XSL Stylesheets v1.70.1 <http://docbook.sf.net/>
4
 
.\"      Date: 03/27/2009
 
1
'\" t
 
2
.\"     Title: \fBmysql-test-run.pl\fR
 
3
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
 
4
.\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/>
 
5
.\"      Date: 07/14/2009
5
6
.\"    Manual: MySQL Database System
6
7
.\"    Source: MySQL
 
8
.\"  Language: English
7
9
.\"
8
 
.TH "\fBMYSQL\-TEST\-RUN.PL" "1" "03/27/2009" "MySQL" "MySQL Database System"
 
10
.TH "\FBMYSQL\-TEST\-RUN\" "1" "07/14/2009" "MySQL" "MySQL Database System"
 
11
.\" -----------------------------------------------------------------
 
12
.\" * set default formatting
 
13
.\" -----------------------------------------------------------------
9
14
.\" disable hyphenation
10
15
.nh
11
16
.\" disable justification (adjust text to left margin only)
12
17
.ad l
 
18
.\" -----------------------------------------------------------------
 
19
.\" * MAIN CONTENT STARTS HERE *
 
20
.\" -----------------------------------------------------------------
 
21
.\" mysql-test-run.pl
13
22
.SH "NAME"
14
 
mysql\-test\-run.pl \- run MySQL test suite
 
23
mysql-test-run.pl \- run MySQL test suite
15
24
.SH "SYNOPSIS"
16
 
.HP 28
17
 
\fBmysql\-test\-run.pl [\fR\fB\fIoptions\fR\fR\fB]\fR
 
25
.HP \w'\fBmysql\-test\-run\&.pl\ [\fR\fB\fIoptions\fR\fR\fB]\fR\ 'u
 
26
\fBmysql\-test\-run\&.pl [\fR\fB\fIoptions\fR\fR\fB]\fR
18
27
.SH "DESCRIPTION"
19
28
.PP
20
29
The
21
 
\fBmysql\-test\-run.pl\fR
22
 
Perl script is the main application used to run the MySQL test suite. It invokes
 
30
\fBmysql\-test\-run\&.pl\fR
 
31
Perl script is the main application used to run the MySQL test suite\&. It invokes
23
32
\fBmysqltest\fR
24
 
to run individual test cases. (Prior to MySQL 4.1, a similar shell script,
25
 
\fBmysql\-test\-run\fR, can be used instead.)
 
33
to run individual test cases\&. (Prior to MySQL 4\&.1, a similar shell script,
 
34
\fBmysql\-test\-run\fR, can be used instead\&.)
26
35
.PP
27
36
Invoke
28
 
\fBmysql\-test\-run.pl\fR
 
37
\fBmysql\-test\-run\&.pl\fR
29
38
in the
30
 
\fImysql\-test\fR
 
39
mysql\-test
31
40
directory like this:
32
41
.sp
33
 
.RS 3n
 
42
.if n \{\
 
43
.RS 4
 
44
.\}
34
45
.nf
35
 
shell> \fBmysql\-test\-run.pl [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fItest_name\fR\fR\fB] ...\fR
 
46
shell> \fBmysql\-test\-run\&.pl [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fItest_name\fR\fR\fB] \&.\&.\&.\fR
36
47
.fi
 
48
.if n \{\
37
49
.RE
 
50
.\}
38
51
.PP
39
52
Each
40
53
\fItest_name\fR
41
 
argument names a test case. The test case file that corresponds to the test name is
42
 
\fIt/\fR\fI\fItest_name\fR\fR\fI.test\fR.
 
54
argument names a test case\&. The test case file that corresponds to the test name is
 
55
t/\fItest_name\fR\&.test\&.
43
56
.PP
44
57
For each
45
58
\fItest_name\fR
46
59
argument,
47
 
\fBmysql\-test\-run.pl\fR
48
 
runs the named test case. With no
 
60
\fBmysql\-test\-run\&.pl\fR
 
61
runs the named test case\&. With no
49
62
\fItest_name\fR
50
63
arguments,
51
 
\fBmysql\-test\-run.pl\fR
 
64
\fBmysql\-test\-run\&.pl\fR
52
65
runs all
53
 
\fI.test\fR
 
66
\&.test
54
67
files in the
55
 
\fIt\fR
56
 
subdirectory.
 
68
t
 
69
subdirectory\&.
57
70
.PP
58
71
If no suffix is given for the test name, a suffix of
59
 
\fI.test\fR
60
 
is assumed. Any leading path name is ignored. These commands are equivalent:
 
72
\&.test
 
73
is assumed\&. Any leading path name is ignored\&. These commands are equivalent:
61
74
.sp
62
 
.RS 3n
 
75
.if n \{\
 
76
.RS 4
 
77
.\}
63
78
.nf
64
 
shell> \fBmysql\-test\-run.pl mytest\fR
65
 
shell> \fBmysql\-test\-run.pl mytest.test\fR
66
 
shell> \fBmysql\-test\-run.pl t/mytest.test\fR
 
79
shell> \fBmysql\-test\-run\&.pl mytest\fR
 
80
shell> \fBmysql\-test\-run\&.pl mytest\&.test\fR
 
81
shell> \fBmysql\-test\-run\&.pl t/mytest\&.test\fR
67
82
.fi
 
83
.if n \{\
68
84
.RE
 
85
.\}
69
86
.PP
70
 
As of MySQL 5.1.23, a suite name can be given as part of the test name. That is, the syntax for naming a test is:
 
87
As of MySQL 5\&.1\&.23, a suite name can be given as part of the test name\&. That is, the syntax for naming a test is:
71
88
.sp
72
 
.RS 3n
 
89
.if n \{\
 
90
.RS 4
 
91
.\}
73
92
.nf
74
 
[\fIsuite_name\fR.]\fItest_name\fR[.\fIsuffix\fR]
 
93
[\fIsuite_name\fR\&.]\fItest_name\fR[\&.\fIsuffix\fR]
75
94
.fi
 
95
.if n \{\
76
96
.RE
 
97
.\}
77
98
.PP
78
99
If a suite name is given,
79
 
\fBmysql\-test\-run.pl\fR
80
 
looks in that suite for the test. With no suite name,
81
 
\fBmysql\-test\-run.pl\fR
82
 
looks in the default list of suites for a match and runs the test in any suites where it finds the test. Suppose that the default suite list is
 
100
\fBmysql\-test\-run\&.pl\fR
 
101
looks in that suite for the test\&. With no suite name,
 
102
\fBmysql\-test\-run\&.pl\fR
 
103
looks in the default list of suites for a match and runs the test in any suites where it finds the test\&. Suppose that the default suite list is
83
104
main,
84
105
binlog,
85
106
rpl, and that a test
86
 
\fImytest.test\fR
 
107
mytest\&.test
87
108
exists in the
88
109
main
89
110
and
90
111
rpl
91
 
suites. With an argument of
 
112
suites\&. With an argument of
92
113
mytest
93
114
or
94
 
mytest.test,
95
 
\fBmysql\-test\-run.pl\fR
 
115
mytest\&.test,
 
116
\fBmysql\-test\-run\&.pl\fR
96
117
will run
97
 
\fImytest.test\fR
 
118
mytest\&.test
98
119
from the
99
120
main
100
121
and
101
122
rpl
102
 
suites.
 
123
suites\&.
103
124
.PP
104
125
To run a family of test cases for which the names share a common prefix, use the
105
126
\fB\-\-do\-test=\fR\fB\fIprefix\fR\fR
106
 
option. For example,
 
127
option\&. For example,
107
128
\fB\-\-do\-test=rpl\fR
108
129
runs the replication tests (test cases that have names beginning with
109
 
rpl).
 
130
rpl)\&.
110
131
\fB\-\-skip\-test\fR
111
 
has the opposite effect of skipping test cases for which the names share a common prefix.
 
132
has the opposite effect of skipping test cases for which the names share a common prefix\&.
112
133
.PP
113
 
As of MySQL 5.0.54/5.1.23/6.0.5, the argument for the
 
134
As of MySQL 5\&.0\&.54/5\&.1\&.23/6\&.0\&.5, the argument for the
114
135
\fB\-\-do\-test\fR
115
136
and
116
137
\fB\-\-skip\-test\fR
117
 
options allows more flexible specification of which tests to perform or skip. If the argument contains a pattern metacharacter other than a lone period, it is interpreted as a Perl regular expression and applies to test names that match the pattern. If the argument contains a lone period or does not contain any pattern metacharacters, it is interpreted the same way as previously and matches test names that begin with the argument value. For example,
 
138
options allows more flexible specification of which tests to perform or skip\&. If the argument contains a pattern metacharacter other than a lone period, it is interpreted as a Perl regular expression and applies to test names that match the pattern\&. If the argument contains a lone period or does not contain any pattern metacharacters, it is interpreted the same way as previously and matches test names that begin with the argument value\&. For example,
118
139
\fB\-\-do\-test=testa\fR
119
140
matches tests that begin with
120
141
testa,
121
 
\fB\-\-do\-test=main.testa\fR
 
142
\fB\-\-do\-test=main\&.testa\fR
122
143
matches tests in the
123
144
main
124
145
test suite that begin with
125
146
testa, and
126
 
\fB\-\-do\-test=main.*testa\fR
 
147
\fB\-\-do\-test=main\&.*testa\fR
127
148
matches test names that contain
128
149
main
129
150
followed by
130
151
testa
131
 
with anything in between. In the latter case, the pattern match is not anchored to the beginning of the test name, so it also matches names such as
132
 
xmainytestz.
 
152
with anything in between\&. In the latter case, the pattern match is not anchored to the beginning of the test name, so it also matches names such as
 
153
xmainytestz\&.
133
154
.PP
134
155
To perform setup prior to running tests,
135
 
\fBmysql\-test\-run.pl\fR
 
156
\fBmysql\-test\-run\&.pl\fR
136
157
needs to invoke
137
158
\fBmysqld\fR
138
159
with the
140
161
and
141
162
\fB\-\-skip\-grant\-tables\fR
142
163
options (see
143
 
[1]\&\fITypical \fBconfigure\fR Options\fR). If MySQL was configured with the
 
164
\m[blue]\fBTypical \fBconfigure\fR Options\fR\m[]\&\s-2\u[1]\d\s+2)\&. If MySQL was configured with the
144
165
\fB\-\-disable\-grant\-options\fR
145
166
option,
146
167
\fB\-\-bootstrap\fR,
147
168
\fB\-\-skip\-grant\-tables\fR, and
148
169
\fB\-\-init\-file\fR
149
 
will be disabled. To handle this, set the
 
170
will be disabled\&. To handle this, set the
150
171
MYSQLD_BOOTSTRAP
151
 
environment variable to the full path name of a server that has all options enabled.
152
 
\fBmysql\-test\-run.pl\fR
153
 
will use that server to perform setup; it is not used to run the tests.
 
172
environment variable to the full path name of a server that has all options enabled\&.
 
173
\fBmysql\-test\-run\&.pl\fR
 
174
will use that server to perform setup; it is not used to run the tests\&.
154
175
.PP
155
176
The
156
177
init_file
157
178
test will fail if
158
179
\fB\-\-init\-file\fR
159
 
is disabled. This is an expected failure that can be handled as follows:
 
180
is disabled\&. This is an expected failure that can be handled as follows:
160
181
.sp
161
 
.RS 3n
 
182
.if n \{\
 
183
.RS 4
 
184
.\}
162
185
.nf
163
186
shell> \fBexport MYSQLD_BOOTSTRAP\fR
164
187
shell> \fBMYSQLD_BOOTSTRAP=/full/path/to/mysqld\fR
165
188
shell> \fBmake test force="\-\-skip\-test=init_file"\fR
166
189
.fi
 
190
.if n \{\
167
191
.RE
 
192
.\}
168
193
.PP
169
194
To run
170
 
\fBmysql\-test\-run.pl\fR
171
 
on Windows, you'll need either Cygwin or ActiveState Perl to run it. You may also need to install the modules required by the script. To run the test script, change location into the
172
 
\fImysql\-test\fR
 
195
\fBmysql\-test\-run\&.pl\fR
 
196
on Windows, you\'ll need either Cygwin or ActiveState Perl to run it\&. You may also need to install the modules required by the script\&. To run the test script, change location into the
 
197
mysql\-test
173
198
directory, set the
174
199
MTR_VS_CONFIG
175
200
environment variable to the configuration you selected earlier (or use the
176
201
\fB\-\-vs\-config\fR
177
202
option), and invoke
178
 
\fBmysql\-test\-run.pl\fR. For example (using Cygwin and the
 
203
\fBmysql\-test\-run\&.pl\fR\&. For example (using Cygwin and the
179
204
\fBbash\fR
180
205
shell):
181
206
.sp
182
 
.RS 3n
 
207
.if n \{\
 
208
.RS 4
 
209
.\}
183
210
.nf
184
211
shell> \fBcd mysql\-test\fR
185
 
shell> \fBexport MTS_VS_CONFIG=debug\fR
186
 
shell> \fB./mysqltest\-run.pl \-\-force \-\-timer\fR
187
 
shell> \fB./mysqltest\-run.pl \-\-force \-\-timer \-\-ps\-protocol\fR
 
212
shell> \fBexport MTR_VS_CONFIG=debug\fR
 
213
shell> \fB\&./mysqltest\-run\&.pl \-\-force \-\-timer\fR
 
214
shell> \fB\&./mysqltest\-run\&.pl \-\-force \-\-timer \-\-ps\-protocol\fR
188
215
.fi
 
216
.if n \{\
189
217
.RE
 
218
.\}
190
219
.PP
191
220
If you have a copy of
192
221
\fBmysqld\fR
193
222
running on the machine where you want to run the test suite, you do not have to stop it, as long as it is not using ports
194
223
9306
195
224
or
196
 
9307. If either of those ports is taken, you should set the
 
225
9307\&. If either of those ports is taken, you should set the
197
226
MTR_BUILD_THREAD
198
 
environment variable to an appropriate value, and the test suite will use a different set of ports for master, slave, NDB, and Instance Manager). For example:
 
227
environment variable to an appropriate value, and the test suite will use a different set of ports for master, slave, NDB, and Instance Manager)\&. For example:
199
228
.sp
200
 
.RS 3n
 
229
.if n \{\
 
230
.RS 4
 
231
.\}
201
232
.nf
202
233
shell> \fBexport MTR_BUILD_THREAD=31\fR
203
 
shell> \fB./mysql\-test\-run.pl [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fItest_name\fR\fR\fB]\fR
 
234
shell> \fB\&./mysql\-test\-run\&.pl [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fItest_name\fR\fR\fB]\fR
204
235
.fi
 
236
.if n \{\
205
237
.RE
 
238
.\}
206
239
.PP
207
 
\fBmysql\-test\-run.pl\fR
208
 
defines several environment variables. Some of them are listed in the following table.
 
240
\fBmysql\-test\-run\&.pl\fR
 
241
defines several environment variables\&. Some of them are listed in the following table\&.
209
242
.TS
210
243
allbox tab(:);
211
244
l l
227
260
T{
228
261
MYSQLTEST_VARDIR
229
262
T}:T{
230
 
Path name to the \fIvar\fR directory that is used for
 
263
Path name to the var directory that is used for
231
264
                logs, temporary files, and so forth
232
265
T}
233
266
T{
246
279
???
247
280
T}
248
281
.TE
249
 
.sp
 
282
.sp 1
250
283
.PP
251
 
Tests sometimes rely on certain environment variables being defined. For example, certain tests assume that
 
284
Tests sometimes rely on certain environment variables being defined\&. For example, certain tests assume that
252
285
MYSQL_TEST
253
286
is defined so that
254
287
\fBmysqltest\fR
255
288
can invoke itself with
256
 
exec $MYSQL_TEST.
 
289
exec $MYSQL_TEST\&.
257
290
.PP
258
 
\fBmysql\-test\-run.pl\fR
259
 
supports the options in the following list. An argument of
 
291
\fBmysql\-test\-run\&.pl\fR
 
292
supports the options in the following list\&. An argument of
260
293
\fB\-\-\fR
261
294
tells
262
 
\fBmysql\-test\-run.pl\fR
263
 
not to process any following arguments as options. (A description of differences between the options supported by
264
 
\fBmysql\-test\-run.pl\fR
 
295
\fBmysql\-test\-run\&.pl\fR
 
296
not to process any following arguments as options\&. (A description of differences between the options supported by
 
297
\fBmysql\-test\-run\&.pl\fR
265
298
and
266
299
\fBmysql\-test\-run\fR
267
 
appears following the list.)
268
 
.TP 3n
269
 
\(bu
 
300
appears following the list\&.)
 
301
.sp
 
302
.RS 4
 
303
.ie n \{\
 
304
\h'-04'\(bu\h'+03'\c
 
305
.\}
 
306
.el \{\
 
307
.sp -1
 
308
.IP \(bu 2.3
 
309
.\}
 
310
.\" mysql-test-run.pl: help option
 
311
.\" help option: mysql-test-run.pl
270
312
\fB\-\-help\fR,
271
313
\fB\-h\fR
272
314
.sp
273
 
Display a help message and exit.
274
 
.TP 3n
275
 
\(bu
 
315
Display a help message and exit\&.
 
316
.RE
 
317
.sp
 
318
.RS 4
 
319
.ie n \{\
 
320
\h'-04'\(bu\h'+03'\c
 
321
.\}
 
322
.el \{\
 
323
.sp -1
 
324
.IP \(bu 2.3
 
325
.\}
 
326
.\" mysql-test-run.pl: bench option
 
327
.\" bench option: mysql-test-run.pl
276
328
\fB\-\-bench\fR
277
329
.sp
278
 
Run the benchmark suite.
279
 
.TP 3n
280
 
\(bu
 
330
Run the benchmark suite\&.
 
331
.RE
 
332
.sp
 
333
.RS 4
 
334
.ie n \{\
 
335
\h'-04'\(bu\h'+03'\c
 
336
.\}
 
337
.el \{\
 
338
.sp -1
 
339
.IP \(bu 2.3
 
340
.\}
 
341
.\" mysql-test-run.pl: benchdir option
 
342
.\" benchdir option: mysql-test-run.pl
281
343
\fB\-\-benchdir=\fR\fB\fIpath\fR\fR
282
344
.sp
283
 
The directory where the benchmark suite is located. The default path is
284
 
\fI../../mysql\-bench\fR.
285
 
.TP 3n
286
 
\(bu
 
345
The directory where the benchmark suite is located\&. The default path is
 
346
\&.\&./\&.\&./mysql\-bench\&.
 
347
.RE
 
348
.sp
 
349
.RS 4
 
350
.ie n \{\
 
351
\h'-04'\(bu\h'+03'\c
 
352
.\}
 
353
.el \{\
 
354
.sp -1
 
355
.IP \(bu 2.3
 
356
.\}
 
357
.\" mysql-test-run.pl: big option
 
358
.\" big option: mysql-test-run.pl
287
359
\fB\-\-big\-test\fR
288
360
.sp
289
361
Pass the
290
362
\fB\-\-big\-test\fR
291
363
option to
292
 
\fBmysqltest\fR.
293
 
.TP 3n
294
 
\(bu
 
364
\fBmysqltest\fR\&.
 
365
.RE
 
366
.sp
 
367
.RS 4
 
368
.ie n \{\
 
369
\h'-04'\(bu\h'+03'\c
 
370
.\}
 
371
.el \{\
 
372
.sp -1
 
373
.IP \(bu 2.3
 
374
.\}
 
375
.\" mysql-test-run.pl: check-testcases option
 
376
.\" check-testcases option: mysql-test-run.pl
295
377
\fB\-\-check\-testcases\fR
296
378
.sp
297
 
Check test cases for side effects.
298
 
.TP 3n
299
 
\(bu
 
379
Check test cases for side effects\&.
 
380
.RE
 
381
.sp
 
382
.RS 4
 
383
.ie n \{\
 
384
\h'-04'\(bu\h'+03'\c
 
385
.\}
 
386
.el \{\
 
387
.sp -1
 
388
.IP \(bu 2.3
 
389
.\}
 
390
.\" mysql-test-run.pl: client-bindir option
 
391
.\" client-bindir option: mysql-test-run.pl
300
392
\fB\-\-client\-bindir\fR
301
393
.sp
302
 
The path to the directory where client binaries are located. This option was added in MySQL 5.0.66/5.1.27.
303
 
.TP 3n
304
 
\(bu
 
394
The path to the directory where client binaries are located\&. This option was added in MySQL 5\&.0\&.66/5\&.1\&.27\&.
 
395
.RE
 
396
.sp
 
397
.RS 4
 
398
.ie n \{\
 
399
\h'-04'\(bu\h'+03'\c
 
400
.\}
 
401
.el \{\
 
402
.sp -1
 
403
.IP \(bu 2.3
 
404
.\}
 
405
.\" mysql-test-run.pl: client-ddd option
 
406
.\" client-ddd option: mysql-test-run.pl
305
407
\fB\-\-client\-ddd\fR
306
408
.sp
307
409
Start
308
410
\fBmysqltest\fR
309
411
in the
310
412
\fBddd\fR
311
 
debugger.
312
 
.TP 3n
313
 
\(bu
 
413
debugger\&.
 
414
.RE
 
415
.sp
 
416
.RS 4
 
417
.ie n \{\
 
418
\h'-04'\(bu\h'+03'\c
 
419
.\}
 
420
.el \{\
 
421
.sp -1
 
422
.IP \(bu 2.3
 
423
.\}
 
424
.\" mysql-test-run.pl: client-debugger option
 
425
.\" client-debugger option: mysql-test-run.pl
314
426
\fB\-\-client\-debugger\fR
315
427
.sp
316
428
Start
317
429
\fBmysqltest\fR
318
 
in the named debugger.
319
 
.TP 3n
320
 
\(bu
 
430
in the named debugger\&.
 
431
.RE
 
432
.sp
 
433
.RS 4
 
434
.ie n \{\
 
435
\h'-04'\(bu\h'+03'\c
 
436
.\}
 
437
.el \{\
 
438
.sp -1
 
439
.IP \(bu 2.3
 
440
.\}
 
441
.\" mysql-test-run.pl: client-gdb option
 
442
.\" client-gdb option: mysql-test-run.pl
321
443
\fB\-\-client\-gdb\fR
322
444
.sp
323
445
Start
324
446
\fBmysqltest\fR
325
447
in the
326
448
\fBgdb\fR
327
 
debugger.
328
 
.TP 3n
329
 
\(bu
 
449
debugger\&.
 
450
.RE
 
451
.sp
 
452
.RS 4
 
453
.ie n \{\
 
454
\h'-04'\(bu\h'+03'\c
 
455
.\}
 
456
.el \{\
 
457
.sp -1
 
458
.IP \(bu 2.3
 
459
.\}
 
460
.\" mysql-test-run.pl: client-libdir option
 
461
.\" client-libdir option: mysql-test-run.pl
330
462
\fB\-\-client\-libdir\fR
331
463
.sp
332
 
The path to the directory where client libraries are located. This option was added in MySQL 5.0.66/5.1.27.
333
 
.TP 3n
334
 
\(bu
 
464
The path to the directory where client libraries are located\&. This option was added in MySQL 5\&.0\&.66/5\&.1\&.27\&.
 
465
.RE
 
466
.sp
 
467
.RS 4
 
468
.ie n \{\
 
469
\h'-04'\(bu\h'+03'\c
 
470
.\}
 
471
.el \{\
 
472
.sp -1
 
473
.IP \(bu 2.3
 
474
.\}
 
475
.\" mysql-test-run.pl: combination option
 
476
.\" combination option: mysql-test-run.pl
335
477
\fB\-\-combination=\fR\fB\fIvalue\fR\fR
336
478
.sp
337
479
Extra options to pass to
338
 
\fBmysqld\fR. The value should consist of one or more comma\-separated
 
480
\fBmysqld\fR\&. The value should consist of one or more comma\-separated
339
481
\fBmysqld\fR
340
 
options. This option is similar to
 
482
options\&. This option is similar to
341
483
\fB\-\-mysqld\fR
342
 
but should be given two or more times.
343
 
\fBmysql\-test\-run.pl\fR
 
484
but should be given two or more times\&.
 
485
\fBmysql\-test\-run\&.pl\fR
344
486
executes multiple test runs, using the options for each instance of
345
487
\fB\-\-combination\fR
346
 
in successive runs. If
 
488
in successive runs\&. If
347
489
\fB\-\-combination\fR
348
 
is given only once, it has no effect. For test runs specific to a given test suite, an alternative to the use of
 
490
is given only once, it has no effect\&. For test runs specific to a given test suite, an alternative to the use of
349
491
\fB\-\-combination\fR
350
492
is to create a
351
 
\fIcombinations\fR
352
 
file in the suite directory. The file should contain a section of options for each test run. See
353
 
Section\ 4.9, \(lqPassing Options from \fBmysql\-test\-run.pl\fR to \fBmysqld\fR or \fBmysqltest\fR\(rq.
354
 
.sp
355
 
This option was added in MySQL 5.1.23/6.0.4.
356
 
.TP 3n
357
 
\(bu
 
493
combinations
 
494
file in the suite directory\&. The file should contain a section of options for each test run\&. See
 
495
Section\ \&4.9, \(lqPassing Options from mysql-test-run.pl to mysqld or mysqltest\(rq\&.
 
496
.sp
 
497
This option was added in MySQL 5\&.1\&.23/6\&.0\&.4\&.
 
498
.RE
 
499
.sp
 
500
.RS 4
 
501
.ie n \{\
 
502
\h'-04'\(bu\h'+03'\c
 
503
.\}
 
504
.el \{\
 
505
.sp -1
 
506
.IP \(bu 2.3
 
507
.\}
 
508
.\" mysql-test-run.pl: comment option
 
509
.\" comment option: mysql-test-run.pl
358
510
\fB\-\-comment=\fR\fB\fIstr\fR\fR
359
511
.sp
360
512
Write
361
513
\fIstr\fR
362
 
to the output.
363
 
.TP 3n
364
 
\(bu
 
514
to the output\&.
 
515
.RE
 
516
.sp
 
517
.RS 4
 
518
.ie n \{\
 
519
\h'-04'\(bu\h'+03'\c
 
520
.\}
 
521
.el \{\
 
522
.sp -1
 
523
.IP \(bu 2.3
 
524
.\}
 
525
.\" mysql-test-run.pl: compress option
 
526
.\" compress option: mysql-test-run.pl
365
527
\fB\-\-compress\fR
366
528
.sp
367
 
Compress all information sent between the client and the server if both support compression.
368
 
.TP 3n
369
 
\(bu
 
529
Compress all information sent between the client and the server if both support compression\&.
 
530
.RE
 
531
.sp
 
532
.RS 4
 
533
.ie n \{\
 
534
\h'-04'\(bu\h'+03'\c
 
535
.\}
 
536
.el \{\
 
537
.sp -1
 
538
.IP \(bu 2.3
 
539
.\}
 
540
.\" mysql-test-run.pl: cursor-protocol option
 
541
.\" cursor-protocol option: mysql-test-run.pl
370
542
\fB\-\-cursor\-protocol\fR
371
543
.sp
372
544
Pass the
374
546
option to
375
547
\fBmysqltest\fR
376
548
(implies
377
 
\fB\-\-ps\-protocol\fR).
378
 
.TP 3n
379
 
\(bu
 
549
\fB\-\-ps\-protocol\fR)\&.
 
550
.RE
 
551
.sp
 
552
.RS 4
 
553
.ie n \{\
 
554
\h'-04'\(bu\h'+03'\c
 
555
.\}
 
556
.el \{\
 
557
.sp -1
 
558
.IP \(bu 2.3
 
559
.\}
 
560
.\" mysql-test-run.pl: ddd option
 
561
.\" ddd option: mysql-test-run.pl
380
562
\fB\-\-ddd\fR
381
563
.sp
382
564
Start
383
565
\fBmysqld\fR
384
566
in the
385
567
\fBddd\fR
386
 
debugger.
387
 
.TP 3n
388
 
\(bu
 
568
debugger\&.
 
569
.RE
 
570
.sp
 
571
.RS 4
 
572
.ie n \{\
 
573
\h'-04'\(bu\h'+03'\c
 
574
.\}
 
575
.el \{\
 
576
.sp -1
 
577
.IP \(bu 2.3
 
578
.\}
 
579
.\" mysql-test-run.pl: debug option
 
580
.\" debug option: mysql-test-run.pl
389
581
\fB\-\-debug\fR
390
582
.sp
391
 
Dump trace output for all clients and servers.
392
 
.TP 3n
393
 
\(bu
 
583
Dump trace output for all clients and servers\&.
 
584
.RE
 
585
.sp
 
586
.RS 4
 
587
.ie n \{\
 
588
\h'-04'\(bu\h'+03'\c
 
589
.\}
 
590
.el \{\
 
591
.sp -1
 
592
.IP \(bu 2.3
 
593
.\}
 
594
.\" mysql-test-run.pl: debugger option
 
595
.\" debugger option: mysql-test-run.pl
394
596
\fB\-\-debugger\fR
395
597
.sp
396
598
Start
397
599
\fBmysqld\fR
398
 
using the named debugger.
399
 
.TP 3n
400
 
\(bu
 
600
using the named debugger\&.
 
601
.RE
 
602
.sp
 
603
.RS 4
 
604
.ie n \{\
 
605
\h'-04'\(bu\h'+03'\c
 
606
.\}
 
607
.el \{\
 
608
.sp -1
 
609
.IP \(bu 2.3
 
610
.\}
 
611
.\" mysql-test-run.pl: debug-sync-timeout option
 
612
.\" debug-sync-timeout option: mysql-test-run.pl
401
613
\fB\-\-debug\-sync\-timeout=\fR\fB\fIN\fR\fR
402
614
.sp
403
 
Controls whether the Debug Sync facility for testing and debugging is enabled. The option value is a timeout in seconds. The default value is 300. A value of 0 disables Debug Sync. The value of this option also becomes the default timeout for individual synchronization points.
 
615
Controls whether the Debug Sync facility for testing and debugging is enabled\&. The option value is a timeout in seconds\&. The default value is 300\&. A value of 0 disables Debug Sync\&. The value of this option also becomes the default timeout for individual synchronization points\&.
404
616
.sp
405
 
\fBmysql\-test\-run.pl\fR
 
617
\fBmysql\-test\-run\&.pl\fR
406
618
passes
407
619
\fB\-\-loose\-debug\-sync\-timeout=\fR\fB\fIN\fR\fR
408
620
to
409
 
\fBmysqld\fR. The
 
621
\fBmysqld\fR\&. The
410
622
\fB\-\-loose\fR
411
623
prefix is used so that
412
624
\fBmysqld\fR
413
 
does not fail if Debug Sync is not compiled in.
 
625
does not fail if Debug Sync is not compiled in\&.
414
626
.sp
415
627
For information about using the Debug Sync facility for testing, see
416
 
Section\ 4.14, \(lqThread Synchronization in Test Cases\(rq.
417
 
.sp
418
 
This option was added in MySQL 6.0.6.
419
 
.TP 3n
420
 
\(bu
 
628
Section\ \&4.14, \(lqThread Synchronization in Test Cases\(rq\&.
 
629
.sp
 
630
This option was added in MySQL 6\&.0\&.6\&.
 
631
.RE
 
632
.sp
 
633
.RS 4
 
634
.ie n \{\
 
635
\h'-04'\(bu\h'+03'\c
 
636
.\}
 
637
.el \{\
 
638
.sp -1
 
639
.IP \(bu 2.3
 
640
.\}
 
641
.\" mysql-test-run.pl: do-test option
 
642
.\" do-test option: mysql-test-run.pl
421
643
\fB\-\-do\-test=\fR\fB\fIprefix\fR\fR
422
644
.sp
423
645
Run all test cases having a name that begins with the given
424
646
\fIprefix\fR
425
 
value. This option provides a convenient way to run a family of similarly named tests.
 
647
value\&. This option provides a convenient way to run a family of similarly named tests\&.
426
648
.sp
427
 
As of MySQL 5.0.54/5.1.23/6.0.5, the argument for the
 
649
As of MySQL 5\&.0\&.54/5\&.1\&.23/6\&.0\&.5, the argument for the
428
650
\fB\-\-do\-test\fR
429
 
option allows more flexible specification of which tests to perform. If the argument contains a pattern metacharacter other than a lone period, it is interpreted as a Perl regular expression and applies to test names that match the pattern. If the argument contains a lone period or does not contain any pattern metacharacters, it is interpreted the same way as previously and matches test names that begin with the argument value. For example,
 
651
option allows more flexible specification of which tests to perform\&. If the argument contains a pattern metacharacter other than a lone period, it is interpreted as a Perl regular expression and applies to test names that match the pattern\&. If the argument contains a lone period or does not contain any pattern metacharacters, it is interpreted the same way as previously and matches test names that begin with the argument value\&. For example,
430
652
\fB\-\-do\-test=testa\fR
431
653
matches tests that begin with
432
654
testa,
433
 
\fB\-\-do\-test=main.testa\fR
 
655
\fB\-\-do\-test=main\&.testa\fR
434
656
matches tests in the
435
657
main
436
658
test suite that begin with
437
659
testa, and
438
 
\fB\-\-do\-test=main.*testa\fR
 
660
\fB\-\-do\-test=main\&.*testa\fR
439
661
matches test names that contain
440
662
main
441
663
followed by
442
664
testa
443
 
with anything in between. In the latter case, the pattern match is not anchored to the beginning of the test name, so it also matches names such as
444
 
xmainytestz.
445
 
.TP 3n
446
 
\(bu
 
665
with anything in between\&. In the latter case, the pattern match is not anchored to the beginning of the test name, so it also matches names such as
 
666
xmainytestz\&.
 
667
.RE
 
668
.sp
 
669
.RS 4
 
670
.ie n \{\
 
671
\h'-04'\(bu\h'+03'\c
 
672
.\}
 
673
.el \{\
 
674
.sp -1
 
675
.IP \(bu 2.3
 
676
.\}
 
677
.\" mysql-test-run.pl: embedded-server option
 
678
.\" embedded-server option: mysql-test-run.pl
447
679
\fB\-\-embedded\-server\fR
448
680
.sp
449
681
Use a version of
450
682
\fBmysqltest\fR
451
 
built with the embedded server.
452
 
.TP 3n
453
 
\(bu
 
683
built with the embedded server\&.
 
684
.RE
 
685
.sp
 
686
.RS 4
 
687
.ie n \{\
 
688
\h'-04'\(bu\h'+03'\c
 
689
.\}
 
690
.el \{\
 
691
.sp -1
 
692
.IP \(bu 2.3
 
693
.\}
 
694
.\" mysql-test-run.pl: experimental option
 
695
.\" experimental option: mysql-test-run.pl
454
696
\fB\-\-experimental=\fR\fB\fIfile_name\fR\fR
455
697
.sp
456
698
Specify a file that contains a list of test cases that should be displayed with the
457
699
[ exp\-fail ]
458
700
code rather than
459
701
[ fail ]
460
 
if they fail. This option was added in MySQL 5.1.33/6.0.11.
461
 
.TP 3n
462
 
\(bu
 
702
if they fail\&. This option was added in MySQL 5\&.1\&.33/6\&.0\&.11\&.
 
703
.RE
 
704
.sp
 
705
.RS 4
 
706
.ie n \{\
 
707
\h'-04'\(bu\h'+03'\c
 
708
.\}
 
709
.el \{\
 
710
.sp -1
 
711
.IP \(bu 2.3
 
712
.\}
 
713
.\" mysql-test-run.pl: extern option
 
714
.\" extern option: mysql-test-run.pl
463
715
\fB\-\-extern\fR
464
716
.sp
465
 
Use an already running server.
 
717
Use an already running server\&.
466
718
.sp
467
719
Note: If a test case has an
468
 
\fI.opt\fR
469
 
file that requires the server to be restarted with specific options, the file will not be used. The test case likely will fail as a result.
470
 
.TP 3n
471
 
\(bu
 
720
\&.opt
 
721
file that requires the server to be restarted with specific options, the file will not be used\&. The test case likely will fail as a result\&.
 
722
.RE
 
723
.sp
 
724
.RS 4
 
725
.ie n \{\
 
726
\h'-04'\(bu\h'+03'\c
 
727
.\}
 
728
.el \{\
 
729
.sp -1
 
730
.IP \(bu 2.3
 
731
.\}
 
732
.\" mysql-test-run.pl: fast option
 
733
.\" fast option: mysql-test-run.pl
472
734
\fB\-\-fast\fR
473
735
.sp
474
 
Do not clean up from earlier test runs.
475
 
.TP 3n
476
 
\(bu
 
736
Do not clean up from earlier test runs\&.
 
737
.RE
 
738
.sp
 
739
.RS 4
 
740
.ie n \{\
 
741
\h'-04'\(bu\h'+03'\c
 
742
.\}
 
743
.el \{\
 
744
.sp -1
 
745
.IP \(bu 2.3
 
746
.\}
 
747
.\" mysql-test-run.pl: force option
 
748
.\" force option: mysql-test-run.pl
477
749
\fB\-\-force\fR
478
750
.sp
479
751
Normally,
480
 
\fBmysql\-test\-run.pl\fR
481
 
exits if a test case fails.
 
752
\fBmysql\-test\-run\&.pl\fR
 
753
exits if a test case fails\&.
482
754
\fB\-\-force\fR
483
 
causes execution to continue regardless of test case failure.
484
 
.TP 3n
485
 
\(bu
 
755
causes execution to continue regardless of test case failure\&.
 
756
.RE
 
757
.sp
 
758
.RS 4
 
759
.ie n \{\
 
760
\h'-04'\(bu\h'+03'\c
 
761
.\}
 
762
.el \{\
 
763
.sp -1
 
764
.IP \(bu 2.3
 
765
.\}
 
766
.\" mysql-test-run.pl: gcov option
 
767
.\" gcov option: mysql-test-run.pl
486
768
\fB\-\-gcov\fR
487
769
.sp
488
770
Run tests with the
489
771
\fBgcov\fR
490
 
test coverage tool.
491
 
.TP 3n
492
 
\(bu
 
772
test coverage tool\&.
 
773
.RE
 
774
.sp
 
775
.RS 4
 
776
.ie n \{\
 
777
\h'-04'\(bu\h'+03'\c
 
778
.\}
 
779
.el \{\
 
780
.sp -1
 
781
.IP \(bu 2.3
 
782
.\}
 
783
.\" mysql-test-run.pl: gdb option
 
784
.\" gdb option: mysql-test-run.pl
493
785
\fB\-\-gdb\fR
494
786
.sp
495
787
Start
496
788
\fBmysqld\fR
497
789
in the
498
790
\fBgdb\fR
499
 
debugger.
500
 
.TP 3n
501
 
\(bu
 
791
debugger\&.
 
792
.RE
 
793
.sp
 
794
.RS 4
 
795
.ie n \{\
 
796
\h'-04'\(bu\h'+03'\c
 
797
.\}
 
798
.el \{\
 
799
.sp -1
 
800
.IP \(bu 2.3
 
801
.\}
 
802
.\" mysql-test-run.pl: gprof option
 
803
.\" gprof option: mysql-test-run.pl
502
804
\fB\-\-gprof\fR
503
805
.sp
504
806
Run tests with the
505
807
\fBgprof\fR
506
 
profiling tool.
507
 
.TP 3n
508
 
\(bu
 
808
profiling tool\&.
 
809
.RE
 
810
.sp
 
811
.RS 4
 
812
.ie n \{\
 
813
\h'-04'\(bu\h'+03'\c
 
814
.\}
 
815
.el \{\
 
816
.sp -1
 
817
.IP \(bu 2.3
 
818
.\}
 
819
.\" mysql-test-run.pl: im-mysqld1-port option
 
820
.\" im-mysqld1-port option: mysql-test-run.pl
509
821
\fB\-\-im\-mysqld1\-port\fR
510
822
.sp
511
823
TCP/IP port number to use for the first
512
 
\fBmysqld\fR, controlled by Instance Manager.
513
 
.TP 3n
514
 
\(bu
 
824
\fBmysqld\fR, controlled by Instance Manager\&.
 
825
.RE
 
826
.sp
 
827
.RS 4
 
828
.ie n \{\
 
829
\h'-04'\(bu\h'+03'\c
 
830
.\}
 
831
.el \{\
 
832
.sp -1
 
833
.IP \(bu 2.3
 
834
.\}
 
835
.\" mysql-test-run.pl: im-mysqld2-port option
 
836
.\" im-mysqld2-port option: mysql-test-run.pl
515
837
\fB\-\-im\-mysqld2\-port\fR
516
838
.sp
517
839
TCP/IP port number to use for the second
518
 
\fBmysqld\fR, controlled by Instance Manager.
519
 
.TP 3n
520
 
\(bu
 
840
\fBmysqld\fR, controlled by Instance Manager\&.
 
841
.RE
 
842
.sp
 
843
.RS 4
 
844
.ie n \{\
 
845
\h'-04'\(bu\h'+03'\c
 
846
.\}
 
847
.el \{\
 
848
.sp -1
 
849
.IP \(bu 2.3
 
850
.\}
 
851
.\" mysql-test-run.pl: im-port option
 
852
.\" im-port option: mysql-test-run.pl
521
853
\fB\-\-im\-port\fR
522
854
.sp
523
855
TCP/IP port number to use for
524
 
\fBmysqld\fR, controlled by Instance Manager.
525
 
.TP 3n
526
 
\(bu
 
856
\fBmysqld\fR, controlled by Instance Manager\&.
 
857
.RE
 
858
.sp
 
859
.RS 4
 
860
.ie n \{\
 
861
\h'-04'\(bu\h'+03'\c
 
862
.\}
 
863
.el \{\
 
864
.sp -1
 
865
.IP \(bu 2.3
 
866
.\}
 
867
.\" mysql-test-run.pl: log-warnings option
 
868
.\" log-warnings option: mysql-test-run.pl
527
869
\fB\-\-log\-warnings\fR
528
870
.sp
529
871
Pass the
530
872
\fB\-\-log\-warnings\fR
531
873
option to
532
 
\fBmysqld\fR.
533
 
.TP 3n
534
 
\(bu
 
874
\fBmysqld\fR\&.
 
875
.RE
 
876
.sp
 
877
.RS 4
 
878
.ie n \{\
 
879
\h'-04'\(bu\h'+03'\c
 
880
.\}
 
881
.el \{\
 
882
.sp -1
 
883
.IP \(bu 2.3
 
884
.\}
 
885
.\" mysql-test-run.pl: manual-debug option
 
886
.\" manual-debug option: mysql-test-run.pl
535
887
\fB\-\-manual\-debug\fR
536
888
.sp
537
 
Use a server that has already been started by the user in a debugger.
538
 
.TP 3n
539
 
\(bu
 
889
Use a server that has already been started by the user in a debugger\&.
 
890
.RE
 
891
.sp
 
892
.RS 4
 
893
.ie n \{\
 
894
\h'-04'\(bu\h'+03'\c
 
895
.\}
 
896
.el \{\
 
897
.sp -1
 
898
.IP \(bu 2.3
 
899
.\}
 
900
.\" mysql-test-run.pl: manual-gdb option
 
901
.\" manual-gdb option: mysql-test-run.pl
540
902
\fB\-\-manual\-gdb\fR
541
903
.sp
542
904
Use a server that has already been started by the user in the
543
905
\fBgdb\fR
544
 
debugger.
545
 
.TP 3n
546
 
\(bu
 
906
debugger\&.
 
907
.RE
 
908
.sp
 
909
.RS 4
 
910
.ie n \{\
 
911
\h'-04'\(bu\h'+03'\c
 
912
.\}
 
913
.el \{\
 
914
.sp -1
 
915
.IP \(bu 2.3
 
916
.\}
 
917
.\" mysql-test-run.pl: master-binary option
 
918
.\" master-binary option: mysql-test-run.pl
547
919
\fB\-\-master\-binary=\fR\fB\fIpath\fR\fR
548
920
.sp
549
921
Specify the path of the
550
922
\fBmysqld\fR
551
 
binary to use for master servers.
552
 
.TP 3n
553
 
\(bu
 
923
binary to use for master servers\&.
 
924
.RE
 
925
.sp
 
926
.RS 4
 
927
.ie n \{\
 
928
\h'-04'\(bu\h'+03'\c
 
929
.\}
 
930
.el \{\
 
931
.sp -1
 
932
.IP \(bu 2.3
 
933
.\}
 
934
.\" mysql-test-run.pl: master_port option
 
935
.\" master_port option: mysql-test-run.pl
554
936
\fB\-\-master_port=\fR\fB\fIport_num\fR\fR
555
937
.sp
556
 
Specify the TCP/IP port number for the first master server to use. Observe that the option name has an underscore and not a dash.
557
 
.TP 3n
558
 
\(bu
 
938
Specify the TCP/IP port number for the first master server to use\&. Observe that the option name has an underscore and not a dash\&.
 
939
.RE
 
940
.sp
 
941
.RS 4
 
942
.ie n \{\
 
943
\h'-04'\(bu\h'+03'\c
 
944
.\}
 
945
.el \{\
 
946
.sp -1
 
947
.IP \(bu 2.3
 
948
.\}
 
949
.\" mysql-test-run.pl: mem option
 
950
.\" mem option: mysql-test-run.pl
559
951
\fB\-\-mem\fR
560
952
.sp
561
 
Run the test suite in memory, using tmpfs or ramdisk. This can decrease test times significantly.
562
 
\fBmysql\-test\-run.pl\fR
 
953
Run the test suite in memory, using tmpfs or ramdisk\&. This can decrease test times significantly\&.
 
954
\fBmysql\-test\-run\&.pl\fR
563
955
attempts to find a suitable location using a built\-in list of standard locations for tmpfs and puts the
564
 
\fIvar\fR
565
 
directory there. This option also affects placement of temporary files, which are created in
566
 
\fIvar/tmp\fR.
 
956
var
 
957
directory there\&. This option also affects placement of temporary files, which are created in
 
958
var/tmp\&.
567
959
.sp
568
960
The default list includes
569
 
\fI/dev/shm\fR. You can also enable this option by setting the environment variable
570
 
MTR_MEM[=\fIdir_name\fR]. If
 
961
/dev/shm\&. You can also enable this option by setting the environment variable
 
962
MTR_MEM[=\fIdir_name\fR]\&. If
571
963
\fIdir_name\fR
572
 
is given, it is added to the beginning of the list of locations to search, so it takes precedence over any built\-in locations.
573
 
.sp
574
 
This option was added in MySQL 4.1.22, 5.0.30, and 5.1.13.
575
 
.TP 3n
576
 
\(bu
 
964
is given, it is added to the beginning of the list of locations to search, so it takes precedence over any built\-in locations\&.
 
965
.sp
 
966
This option was added in MySQL 4\&.1\&.22, 5\&.0\&.30, and 5\&.1\&.13\&.
 
967
.RE
 
968
.sp
 
969
.RS 4
 
970
.ie n \{\
 
971
\h'-04'\(bu\h'+03'\c
 
972
.\}
 
973
.el \{\
 
974
.sp -1
 
975
.IP \(bu 2.3
 
976
.\}
 
977
.\" mysql-test-run.pl: mysqld option
 
978
.\" mysqld option: mysql-test-run.pl
577
979
\fB\-\-mysqld=\fR\fB\fIvalue\fR\fR
578
980
.sp
579
981
Extra options to pass to
580
 
\fBmysqld\fR. The value should consist of one or more comma\-separated
 
982
\fBmysqld\fR\&. The value should consist of one or more comma\-separated
581
983
\fBmysqld\fR
582
 
options. See
583
 
Section\ 4.9, \(lqPassing Options from \fBmysql\-test\-run.pl\fR to \fBmysqld\fR or \fBmysqltest\fR\(rq.
584
 
.TP 3n
585
 
\(bu
 
984
options\&. See
 
985
Section\ \&4.9, \(lqPassing Options from mysql-test-run.pl to mysqld or mysqltest\(rq\&.
 
986
.RE
 
987
.sp
 
988
.RS 4
 
989
.ie n \{\
 
990
\h'-04'\(bu\h'+03'\c
 
991
.\}
 
992
.el \{\
 
993
.sp -1
 
994
.IP \(bu 2.3
 
995
.\}
 
996
.\" mysql-test-run.pl: mysqltest option
 
997
.\" mysqltest option: mysql-test-run.pl
586
998
\fB\-\-mysqltest=\fR\fB\fIvalue\fR\fR
587
999
.sp
588
1000
Extra options to pass to
589
 
\fBmysqltest\fR. The value should consist of one or more comma\-separated
 
1001
\fBmysqltest\fR\&. The value should consist of one or more comma\-separated
590
1002
\fBmysqltest\fR
591
 
options. See
592
 
Section\ 4.9, \(lqPassing Options from \fBmysql\-test\-run.pl\fR to \fBmysqld\fR or \fBmysqltest\fR\(rq. This option was added in MySQL 6.0.6.
593
 
.TP 3n
594
 
\(bu
 
1003
options\&. See
 
1004
Section\ \&4.9, \(lqPassing Options from mysql-test-run.pl to mysqld or mysqltest\(rq\&. This option was added in MySQL 6\&.0\&.6\&.
 
1005
.RE
 
1006
.sp
 
1007
.RS 4
 
1008
.ie n \{\
 
1009
\h'-04'\(bu\h'+03'\c
 
1010
.\}
 
1011
.el \{\
 
1012
.sp -1
 
1013
.IP \(bu 2.3
 
1014
.\}
 
1015
.\" mysql-test-run.pl: ndb-connectstring option
 
1016
.\" ndb-connectstring option: mysql-test-run.pl
595
1017
\fB\-\-ndb\-connectstring=\fR\fB\fIstr\fR\fR
596
1018
.sp
597
1019
Pass
598
1020
\fB\-\-ndb\-connectstring=\fR\fB\fIstr\fR\fR
599
 
to the master MySQL server. This option also prevents
600
 
\fBmysql\-test\-run.pl\fR
601
 
from starting a cluster. It is assumed that there is already a cluster running to which the server can connect with the given connectstring.
602
 
.TP 3n
603
 
\(bu
 
1021
to the master MySQL server\&. This option also prevents
 
1022
\fBmysql\-test\-run\&.pl\fR
 
1023
from starting a cluster\&. It is assumed that there is already a cluster running to which the server can connect with the given connectstring\&.
 
1024
.RE
 
1025
.sp
 
1026
.RS 4
 
1027
.ie n \{\
 
1028
\h'-04'\(bu\h'+03'\c
 
1029
.\}
 
1030
.el \{\
 
1031
.sp -1
 
1032
.IP \(bu 2.3
 
1033
.\}
 
1034
.\" mysql-test-run.pl: ndb-connectstring-slave option
 
1035
.\" ndb-connectstring-slave option: mysql-test-run.pl
604
1036
\fB\-\-ndb\-connectstring\-slave=\fR\fB\fIstr\fR\fR
605
1037
.sp
606
1038
Pass
607
1039
\fB\-\-ndb\-connectstring=\fR\fB\fIstr\fR\fR
608
 
to slave MySQL servers. This option also prevents
609
 
\fBmysql\-test\-run.pl\fR
610
 
from starting a cluster. It is assumed that there is already a cluster running to which the server can connect with the given connectstring.
611
 
.TP 3n
612
 
\(bu
 
1040
to slave MySQL servers\&. This option also prevents
 
1041
\fBmysql\-test\-run\&.pl\fR
 
1042
from starting a cluster\&. It is assumed that there is already a cluster running to which the server can connect with the given connectstring\&.
 
1043
.RE
 
1044
.sp
 
1045
.RS 4
 
1046
.ie n \{\
 
1047
\h'-04'\(bu\h'+03'\c
 
1048
.\}
 
1049
.el \{\
 
1050
.sp -1
 
1051
.IP \(bu 2.3
 
1052
.\}
 
1053
.\" mysql-test-run.pl: ndb-extra-test option
 
1054
.\" ndb-extra-test option: mysql-test-run.pl
613
1055
\fB\-\-ndb\-extra\-test\fR
614
1056
.sp
615
 
Unknown.
616
 
.TP 3n
617
 
\(bu
 
1057
Unknown\&.
 
1058
.RE
 
1059
.sp
 
1060
.RS 4
 
1061
.ie n \{\
 
1062
\h'-04'\(bu\h'+03'\c
 
1063
.\}
 
1064
.el \{\
 
1065
.sp -1
 
1066
.IP \(bu 2.3
 
1067
.\}
 
1068
.\" mysql-test-run.pl: ndbcluster-port option
 
1069
.\" ndbcluster-port option: mysql-test-run.pl
 
1070
.\" mysql-test-run.pl: ndbcluster_port option
 
1071
.\" ndbcluster_port option: mysql-test-run.pl
618
1072
\fB\-\-ndbcluster\-port=\fR\fB\fIport_num\fR\fR,
619
1073
\fB\-\-ndbcluster_port=\fR\fB\fIport_num\fR\fR
620
1074
.sp
621
 
Specify the TCP/IP port number that NDB Cluster should use.
622
 
.TP 3n
623
 
\(bu
 
1075
Specify the TCP/IP port number that NDB Cluster should use\&.
 
1076
.RE
 
1077
.sp
 
1078
.RS 4
 
1079
.ie n \{\
 
1080
\h'-04'\(bu\h'+03'\c
 
1081
.\}
 
1082
.el \{\
 
1083
.sp -1
 
1084
.IP \(bu 2.3
 
1085
.\}
 
1086
.\" mysql-test-run.pl: ndbcluster-port-slave option
 
1087
.\" ndbcluster-port-slave option: mysql-test-run.pl
624
1088
\fB\-\-ndbcluster\-port\-slave=\fR\fB\fIport_num\fR\fR
625
1089
.sp
626
 
Specify the TCP/IP port number that the slave NDB Cluster should use.
627
 
.TP 3n
628
 
\(bu
 
1090
Specify the TCP/IP port number that the slave NDB Cluster should use\&.
 
1091
.RE
 
1092
.sp
 
1093
.RS 4
 
1094
.ie n \{\
 
1095
\h'-04'\(bu\h'+03'\c
 
1096
.\}
 
1097
.el \{\
 
1098
.sp -1
 
1099
.IP \(bu 2.3
 
1100
.\}
 
1101
.\" mysql-test-run.pl: netware option
 
1102
.\" netware option: mysql-test-run.pl
629
1103
\fB\-\-netware\fR
630
1104
.sp
631
1105
Run
632
1106
\fBmysqld\fR
633
 
with options needed on NetWare.
634
 
.TP 3n
635
 
\(bu
 
1107
with options needed on NetWare\&.
 
1108
.RE
 
1109
.sp
 
1110
.RS 4
 
1111
.ie n \{\
 
1112
\h'-04'\(bu\h'+03'\c
 
1113
.\}
 
1114
.el \{\
 
1115
.sp -1
 
1116
.IP \(bu 2.3
 
1117
.\}
 
1118
.\" mysql-test-run.pl: notimer option
 
1119
.\" notimer option: mysql-test-run.pl
636
1120
\fB\-\-notimer\fR
637
1121
.sp
638
1122
Cause
639
1123
\fBmysqltest\fR
640
 
not to generate a timing file.
641
 
.TP 3n
642
 
\(bu
643
 
\fB\-\-ps\-protocol\fR
644
 
.sp
645
 
Pass the
646
 
\fB\-\-ps\-protocol\fR
647
 
option to
648
 
\fBmysqltest\fR.
649
 
.TP 3n
650
 
\(bu
651
 
\fB\-\-record\fR
652
 
.sp
653
 
Pass the
654
 
\fB\-\-record\fR
655
 
option to
656
 
\fBmysqltest\fR. This option requires a specific test case to be named on the command line.
657
 
.TP 3n
658
 
\(bu
 
1124
not to generate a timing file\&.
 
1125
.RE
 
1126
.sp
 
1127
.RS 4
 
1128
.ie n \{\
 
1129
\h'-04'\(bu\h'+03'\c
 
1130
.\}
 
1131
.el \{\
 
1132
.sp -1
 
1133
.IP \(bu 2.3
 
1134
.\}
 
1135
.\" mysql-test-run.pl: ps-protocol option
 
1136
.\" ps-protocol option: mysql-test-run.pl
 
1137
\fB\-\-ps\-protocol\fR
 
1138
.sp
 
1139
Pass the
 
1140
\fB\-\-ps\-protocol\fR
 
1141
option to
 
1142
\fBmysqltest\fR\&.
 
1143
.RE
 
1144
.sp
 
1145
.RS 4
 
1146
.ie n \{\
 
1147
\h'-04'\(bu\h'+03'\c
 
1148
.\}
 
1149
.el \{\
 
1150
.sp -1
 
1151
.IP \(bu 2.3
 
1152
.\}
 
1153
.\" mysql-test-run.pl: record option
 
1154
.\" record option: mysql-test-run.pl
 
1155
\fB\-\-record\fR
 
1156
.sp
 
1157
Pass the
 
1158
\fB\-\-record\fR
 
1159
option to
 
1160
\fBmysqltest\fR\&. This option requires a specific test case to be named on the command line\&.
 
1161
.RE
 
1162
.sp
 
1163
.RS 4
 
1164
.ie n \{\
 
1165
\h'-04'\(bu\h'+03'\c
 
1166
.\}
 
1167
.el \{\
 
1168
.sp -1
 
1169
.IP \(bu 2.3
 
1170
.\}
 
1171
.\" mysql-test-run.pl: reorder option
 
1172
.\" reorder option: mysql-test-run.pl
659
1173
\fB\-\-reorder\fR
660
1174
.sp
661
 
Reorder tests to minimize the number of server restarts needed.
662
 
.TP 3n
663
 
\(bu
 
1175
Reorder tests to minimize the number of server restarts needed\&.
 
1176
.RE
 
1177
.sp
 
1178
.RS 4
 
1179
.ie n \{\
 
1180
\h'-04'\(bu\h'+03'\c
 
1181
.\}
 
1182
.el \{\
 
1183
.sp -1
 
1184
.IP \(bu 2.3
 
1185
.\}
 
1186
.\" mysql-test-run.pl: report-features option
 
1187
.\" report-features option: mysql-test-run.pl
664
1188
\fB\-\-report\-features\fR
665
1189
.sp
666
1190
Display the output of
667
1191
SHOW ENGINES
668
1192
and
669
 
SHOW VARIABLES. This can be used to verify that binaries are built with all required features.
670
 
.sp
671
 
This option was added in MySQL 4.1.23, 5.0.30, and 5.1.14.
672
 
.TP 3n
673
 
\(bu
 
1193
SHOW VARIABLES\&. This can be used to verify that binaries are built with all required features\&.
 
1194
.sp
 
1195
This option was added in MySQL 4\&.1\&.23, 5\&.0\&.30, and 5\&.1\&.14\&.
 
1196
.RE
 
1197
.sp
 
1198
.RS 4
 
1199
.ie n \{\
 
1200
\h'-04'\(bu\h'+03'\c
 
1201
.\}
 
1202
.el \{\
 
1203
.sp -1
 
1204
.IP \(bu 2.3
 
1205
.\}
 
1206
.\" mysql-test-run.pl: script-debug option
 
1207
.\" script-debug option: mysql-test-run.pl
674
1208
\fB\-\-script\-debug\fR
675
1209
.sp
676
1210
Enable debug output for
677
 
\fBmysql\-test\-run.pl\fR
678
 
itself.
679
 
.TP 3n
680
 
\(bu
 
1211
\fBmysql\-test\-run\&.pl\fR
 
1212
itself\&.
 
1213
.RE
 
1214
.sp
 
1215
.RS 4
 
1216
.ie n \{\
 
1217
\h'-04'\(bu\h'+03'\c
 
1218
.\}
 
1219
.el \{\
 
1220
.sp -1
 
1221
.IP \(bu 2.3
 
1222
.\}
 
1223
.\" mysql-test-run.pl: skip-im option
 
1224
.\" skip-im option: mysql-test-run.pl
681
1225
\fB\-\-skip\-im\fR
682
1226
.sp
683
 
Do not start Instance Manager; skip Instance Manager test cases.
684
 
.TP 3n
685
 
\(bu
 
1227
Do not start Instance Manager; skip Instance Manager test cases\&.
 
1228
.RE
 
1229
.sp
 
1230
.RS 4
 
1231
.ie n \{\
 
1232
\h'-04'\(bu\h'+03'\c
 
1233
.\}
 
1234
.el \{\
 
1235
.sp -1
 
1236
.IP \(bu 2.3
 
1237
.\}
 
1238
.\" mysql-test-run.pl: skip-master-binlog option
 
1239
.\" skip-master-binlog option: mysql-test-run.pl
686
1240
\fB\-\-skip\-master\-binlog\fR
687
1241
.sp
688
 
Do not enable master server binary logging.
689
 
.TP 3n
690
 
\(bu
 
1242
Do not enable master server binary logging\&.
 
1243
.RE
 
1244
.sp
 
1245
.RS 4
 
1246
.ie n \{\
 
1247
\h'-04'\(bu\h'+03'\c
 
1248
.\}
 
1249
.el \{\
 
1250
.sp -1
 
1251
.IP \(bu 2.3
 
1252
.\}
 
1253
.\" mysql-test-run.pl: skip-ndbcluster option
 
1254
.\" skip-ndbcluster option: mysql-test-run.pl
691
1255
\fB\-\-skip\-ndbcluster\fR,
 
1256
.\" mysql-test-run.pl: skip-ndb option
 
1257
.\" skip-ndb option: mysql-test-run.pl
692
1258
\fB\-\-skip\-ndb\fR
693
1259
.sp
694
 
Do not start NDB Cluster; skip Cluster test cases.
695
 
.TP 3n
696
 
\(bu
 
1260
Do not start NDB Cluster; skip Cluster test cases\&.
 
1261
.RE
 
1262
.sp
 
1263
.RS 4
 
1264
.ie n \{\
 
1265
\h'-04'\(bu\h'+03'\c
 
1266
.\}
 
1267
.el \{\
 
1268
.sp -1
 
1269
.IP \(bu 2.3
 
1270
.\}
 
1271
.\" mysql-test-run.pl: skip-ndbcluster-slave option
 
1272
.\" skip-ndbcluster-slave option: mysql-test-run.pl
697
1273
\fB\-\-skip\-ndbcluster\-slave\fR,
 
1274
.\" mysql-test-run.pl: skip-ndb-slave option
 
1275
.\" skip-ndb-slave option: mysql-test-run.pl
698
1276
\fB\-\-skip\-ndb\-slave\fR
699
1277
.sp
700
 
Do not start an NDB Cluster slave.
701
 
.TP 3n
702
 
\(bu
 
1278
Do not start an NDB Cluster slave\&.
 
1279
.RE
 
1280
.sp
 
1281
.RS 4
 
1282
.ie n \{\
 
1283
\h'-04'\(bu\h'+03'\c
 
1284
.\}
 
1285
.el \{\
 
1286
.sp -1
 
1287
.IP \(bu 2.3
 
1288
.\}
 
1289
.\" mysql-test-run.pl: skip-rpl option
 
1290
.\" skip-rpl option: mysql-test-run.pl
703
1291
\fB\-\-skip\-rpl\fR
704
1292
.sp
705
 
Skip replication test cases.
706
 
.TP 3n
707
 
\(bu
 
1293
Skip replication test cases\&.
 
1294
.RE
 
1295
.sp
 
1296
.RS 4
 
1297
.ie n \{\
 
1298
\h'-04'\(bu\h'+03'\c
 
1299
.\}
 
1300
.el \{\
 
1301
.sp -1
 
1302
.IP \(bu 2.3
 
1303
.\}
 
1304
.\" mysql-test-run.pl: skip-slave-binlog option
 
1305
.\" skip-slave-binlog option: mysql-test-run.pl
708
1306
\fB\-\-skip\-slave\-binlog\fR
709
1307
.sp
710
 
Do not enable master server binary logging.
711
 
.TP 3n
712
 
\(bu
 
1308
Do not enable master server binary logging\&.
 
1309
.RE
 
1310
.sp
 
1311
.RS 4
 
1312
.ie n \{\
 
1313
\h'-04'\(bu\h'+03'\c
 
1314
.\}
 
1315
.el \{\
 
1316
.sp -1
 
1317
.IP \(bu 2.3
 
1318
.\}
 
1319
.\" mysql-test-run.pl: skip-ssl option
 
1320
.\" skip-ssl option: mysql-test-run.pl
713
1321
\fB\-\-skip\-ssl\fR
714
1322
.sp
715
1323
Do not start
716
1324
\fBmysqld\fR
717
 
with support for SSL connections.
718
 
.TP 3n
719
 
\(bu
 
1325
with support for SSL connections\&.
 
1326
.RE
 
1327
.sp
 
1328
.RS 4
 
1329
.ie n \{\
 
1330
\h'-04'\(bu\h'+03'\c
 
1331
.\}
 
1332
.el \{\
 
1333
.sp -1
 
1334
.IP \(bu 2.3
 
1335
.\}
 
1336
.\" mysql-test-run.pl: skip-test option
 
1337
.\" skip-test option: mysql-test-run.pl
720
1338
\fB\-\-skip\-test=\fR\fB\fIregex\fR\fR
721
1339
.sp
722
 
Specify a regular expression to be applied to test case names. Cases with names that match the expression are skipped. tests to skip.
 
1340
Specify a regular expression to be applied to test case names\&. Cases with names that match the expression are skipped\&. tests to skip\&.
723
1341
.sp
724
 
As of MySQL 5.0.54/5.1.23/6.0.5, the argument for the
 
1342
As of MySQL 5\&.0\&.54/5\&.1\&.23/6\&.0\&.5, the argument for the
725
1343
\fB\-\-skip\-test\fR
726
 
option allows more flexible specification of which tests to skip. If the argument contains a pattern metacharacter other than a lone period, it is interpreted as a Perl regular expression and applies to test names that match the pattern. See the description of the
 
1344
option allows more flexible specification of which tests to skip\&. If the argument contains a pattern metacharacter other than a lone period, it is interpreted as a Perl regular expression and applies to test names that match the pattern\&. See the description of the
727
1345
\fB\-\-do\-test\fR
728
 
option for details.
729
 
.TP 3n
730
 
\(bu
 
1346
option for details\&.
 
1347
.RE
 
1348
.sp
 
1349
.RS 4
 
1350
.ie n \{\
 
1351
\h'-04'\(bu\h'+03'\c
 
1352
.\}
 
1353
.el \{\
 
1354
.sp -1
 
1355
.IP \(bu 2.3
 
1356
.\}
731
1357
\fB\-\-skip\-*\fR
732
1358
.sp
733
1359
\fB\-\-skip\-*\fR
734
1360
options not otherwise recognized by
735
 
\fBmysql\-test\-run.pl\fR
736
 
are passed to the master server.
737
 
.TP 3n
738
 
\(bu
 
1361
\fBmysql\-test\-run\&.pl\fR
 
1362
are passed to the master server\&.
 
1363
.RE
 
1364
.sp
 
1365
.RS 4
 
1366
.ie n \{\
 
1367
\h'-04'\(bu\h'+03'\c
 
1368
.\}
 
1369
.el \{\
 
1370
.sp -1
 
1371
.IP \(bu 2.3
 
1372
.\}
 
1373
.\" mysql-test-run.pl: slave-binary option
 
1374
.\" slave-binary option: mysql-test-run.pl
739
1375
\fB\-\-slave\-binary=\fR\fB\fIpath\fR\fR
740
1376
.sp
741
1377
Specify the path of the
742
1378
\fBmysqld\fR
743
 
binary to use for slave servers.
744
 
.TP 3n
745
 
\(bu
 
1379
binary to use for slave servers\&.
 
1380
.RE
 
1381
.sp
 
1382
.RS 4
 
1383
.ie n \{\
 
1384
\h'-04'\(bu\h'+03'\c
 
1385
.\}
 
1386
.el \{\
 
1387
.sp -1
 
1388
.IP \(bu 2.3
 
1389
.\}
 
1390
.\" mysql-test-run.pl: slave_port option
 
1391
.\" slave_port option: mysql-test-run.pl
746
1392
\fB\-\-slave_port=\fR\fB\fIport_num\fR\fR
747
1393
.sp
748
 
Specify the TCP/IP port number for the first master server to use. Observe that the option name has an underscore and not a dash.
749
 
.TP 3n
750
 
\(bu
 
1394
Specify the TCP/IP port number for the first master server to use\&. Observe that the option name has an underscore and not a dash\&.
 
1395
.RE
 
1396
.sp
 
1397
.RS 4
 
1398
.ie n \{\
 
1399
\h'-04'\(bu\h'+03'\c
 
1400
.\}
 
1401
.el \{\
 
1402
.sp -1
 
1403
.IP \(bu 2.3
 
1404
.\}
 
1405
.\" mysql-test-run.pl: sleep option
 
1406
.\" sleep option: mysql-test-run.pl
751
1407
\fB\-\-sleep=\fR\fB\fIN\fR\fR
752
1408
.sp
753
1409
Pass
754
1410
\fB\-\-sleep=\fR\fB\fIN\fR\fR
755
1411
to
756
 
\fBmysqltest\fR.
757
 
.TP 3n
758
 
\(bu
 
1412
\fBmysqltest\fR\&.
 
1413
.RE
 
1414
.sp
 
1415
.RS 4
 
1416
.ie n \{\
 
1417
\h'-04'\(bu\h'+03'\c
 
1418
.\}
 
1419
.el \{\
 
1420
.sp -1
 
1421
.IP \(bu 2.3
 
1422
.\}
 
1423
.\" mysql-test-run.pl: small-bench option
 
1424
.\" small-bench option: mysql-test-run.pl
759
1425
\fB\-\-small\-bench\fR
760
1426
.sp
761
1427
Run the benchmarks with the
762
1428
\fB\-\-small\-tests\fR
763
1429
and
764
1430
\fB\-\-small\-tables\fR
765
 
options.
766
 
.TP 3n
767
 
\(bu
 
1431
options\&.
 
1432
.RE
 
1433
.sp
 
1434
.RS 4
 
1435
.ie n \{\
 
1436
\h'-04'\(bu\h'+03'\c
 
1437
.\}
 
1438
.el \{\
 
1439
.sp -1
 
1440
.IP \(bu 2.3
 
1441
.\}
 
1442
.\" mysql-test-run.pl: socket option
 
1443
.\" socket option: mysql-test-run.pl
768
1444
\fB\-\-socket=\fR\fB\fIfile_name\fR\fR
769
1445
.sp
770
1446
For connections to
771
 
localhost, the Unix socket file to use, or, on Windows, the name of the named pipe to use.
772
 
.TP 3n
773
 
\(bu
 
1447
localhost, the Unix socket file to use, or, on Windows, the name of the named pipe to use\&.
 
1448
.RE
 
1449
.sp
 
1450
.RS 4
 
1451
.ie n \{\
 
1452
\h'-04'\(bu\h'+03'\c
 
1453
.\}
 
1454
.el \{\
 
1455
.sp -1
 
1456
.IP \(bu 2.3
 
1457
.\}
 
1458
.\" mysql-test-run.pl: sp-protocol option
 
1459
.\" sp-protocol option: mysql-test-run.pl
774
1460
\fB\-\-sp\-protocol\fR
775
1461
.sp
776
1462
Pass the
777
1463
\fB\-\-sp\-protocol\fR
778
1464
option to
779
 
\fBmysqltest\fR.
780
 
.TP 3n
781
 
\(bu
 
1465
\fBmysqltest\fR\&.
 
1466
.RE
 
1467
.sp
 
1468
.RS 4
 
1469
.ie n \{\
 
1470
\h'-04'\(bu\h'+03'\c
 
1471
.\}
 
1472
.el \{\
 
1473
.sp -1
 
1474
.IP \(bu 2.3
 
1475
.\}
 
1476
.\" mysql-test-run.pl: ssl option
 
1477
.\" ssl option: mysql-test-run.pl
782
1478
\fB\-\-ssl\fR
783
1479
.sp
784
1480
If
785
 
\fBmysql\-test\-run.pl\fR
 
1481
\fBmysql\-test\-run\&.pl\fR
786
1482
is started with the
787
1483
\fB\-\-ssl\fR
788
 
option, it sets up a secure conection for all test cases. In this case, if
 
1484
option, it sets up a secure conection for all test cases\&. In this case, if
789
1485
\fBmysqld\fR
790
1486
does not support SSL,
791
 
\fBmysql\-test\-run.pl\fR
 
1487
\fBmysql\-test\-run\&.pl\fR
792
1488
exits with an error message:
793
 
Couldn't find support for SSL
794
 
.TP 3n
795
 
\(bu
 
1489
Couldn\'t find support for SSL
 
1490
.RE
 
1491
.sp
 
1492
.RS 4
 
1493
.ie n \{\
 
1494
\h'-04'\(bu\h'+03'\c
 
1495
.\}
 
1496
.el \{\
 
1497
.sp -1
 
1498
.IP \(bu 2.3
 
1499
.\}
 
1500
.\" mysql-test-run.pl: start option
 
1501
.\" start option: mysql-test-run.pl
796
1502
\fB\-\-start\fR
797
1503
.sp
798
 
Initialize and start servers with the startup settings for the first specified test case. For example:
 
1504
Initialize and start servers with the startup settings for the first specified test case\&. For example:
799
1505
.sp
800
 
.RS 3n
 
1506
.if n \{\
 
1507
.RS 4
 
1508
.\}
801
1509
.nf
802
1510
shell> \fBcd mysql\-test\fR
803
 
shell> \fB./mysql\-test\-run.pl \-\-start alias &\fR
 
1511
shell> \fB\&./mysql\-test\-run\&.pl \-\-start alias &\fR
804
1512
.fi
805
 
.RE
806
 
This option was added in MySQL 5.1.32/6.0.11.
807
 
.TP 3n
808
 
\(bu
 
1513
.if n \{\
 
1514
.RE
 
1515
.\}
 
1516
.sp
 
1517
This option was added in MySQL 5\&.1\&.32/6\&.0\&.11\&.
 
1518
.RE
 
1519
.sp
 
1520
.RS 4
 
1521
.ie n \{\
 
1522
\h'-04'\(bu\h'+03'\c
 
1523
.\}
 
1524
.el \{\
 
1525
.sp -1
 
1526
.IP \(bu 2.3
 
1527
.\}
 
1528
.\" mysql-test-run.pl: start-and-exit option
 
1529
.\" start-and-exit option: mysql-test-run.pl
809
1530
\fB\-\-start\-and\-exit\fR
810
1531
.sp
811
 
Initialize and start servers with the startup settings for the specified test case or cases, if any, and then exit. You can use this option to start a server to which you can connect later. For example, after building a source distribution you can start a server and connect to it with the
 
1532
Initialize and start servers with the startup settings for the specified test case or cases, if any, and then exit\&. You can use this option to start a server to which you can connect later\&. For example, after building a source distribution you can start a server and connect to it with the
812
1533
\fBmysql\fR
813
1534
client like this:
814
1535
.sp
815
 
.RS 3n
 
1536
.if n \{\
 
1537
.RS 4
 
1538
.\}
816
1539
.nf
817
1540
shell> \fBcd mysql\-test\fR
818
 
shell> \fB./mysql\-test\-run.pl \-\-start\-and\-exit\fR
819
 
shell> \fB../mysql \-S ./var/tmp/master.sock \-h localhost \-u root\fR
 
1541
shell> \fB\&./mysql\-test\-run\&.pl \-\-start\-and\-exit\fR
 
1542
shell> \fB\&.\&./mysql \-S \&./var/tmp/master\&.sock \-h localhost \-u root\fR
820
1543
.fi
821
 
.RE
822
 
.TP 3n
823
 
\(bu
 
1544
.if n \{\
 
1545
.RE
 
1546
.\}
 
1547
.RE
 
1548
.sp
 
1549
.RS 4
 
1550
.ie n \{\
 
1551
\h'-04'\(bu\h'+03'\c
 
1552
.\}
 
1553
.el \{\
 
1554
.sp -1
 
1555
.IP \(bu 2.3
 
1556
.\}
 
1557
.\" mysql-test-run.pl: start-dirty option
 
1558
.\" start-dirty option: mysql-test-run.pl
824
1559
\fB\-\-start\-dirty\fR
825
1560
.sp
826
 
Start servers (without initialization) for the specified test case or cases, if any, and then exit. You can then manually run the test cases.
827
 
.TP 3n
828
 
\(bu
 
1561
Start servers (without initialization) for the specified test case or cases, if any, and then exit\&. You can then manually run the test cases\&.
 
1562
.RE
 
1563
.sp
 
1564
.RS 4
 
1565
.ie n \{\
 
1566
\h'-04'\(bu\h'+03'\c
 
1567
.\}
 
1568
.el \{\
 
1569
.sp -1
 
1570
.IP \(bu 2.3
 
1571
.\}
 
1572
.\" mysql-test-run.pl: start-from option
 
1573
.\" start-from option: mysql-test-run.pl
829
1574
\fB\-\-start\-from=\fR\fB\fItest_name\fR\fR
830
1575
.sp
831
 
\fBmysql\-test\-run.pl\fR
 
1576
\fBmysql\-test\-run\&.pl\fR
832
1577
sorts the list of names of the test cases to be run, and then begins with
833
 
\fItest_name\fR.
834
 
.TP 3n
835
 
\(bu
 
1578
\fItest_name\fR\&.
 
1579
.RE
 
1580
.sp
 
1581
.RS 4
 
1582
.ie n \{\
 
1583
\h'-04'\(bu\h'+03'\c
 
1584
.\}
 
1585
.el \{\
 
1586
.sp -1
 
1587
.IP \(bu 2.3
 
1588
.\}
 
1589
.\" mysql-test-run.pl: strace-client option
 
1590
.\" strace-client option: mysql-test-run.pl
836
1591
\fB\-\-strace\-client\fR
837
1592
.sp
838
1593
Create
839
1594
\fBstrace\fR
840
1595
output for
841
 
\fBmysqltest\fR.
842
 
.TP 3n
843
 
\(bu
 
1596
\fBmysqltest\fR\&.
 
1597
.RE
 
1598
.sp
 
1599
.RS 4
 
1600
.ie n \{\
 
1601
\h'-04'\(bu\h'+03'\c
 
1602
.\}
 
1603
.el \{\
 
1604
.sp -1
 
1605
.IP \(bu 2.3
 
1606
.\}
 
1607
.\" mysql-test-run.pl: stress option
 
1608
.\" stress option: mysql-test-run.pl
844
1609
\fB\-\-stress\fR
845
1610
.sp
846
 
Run the stress test. The other
 
1611
Run the stress test\&. The other
847
1612
\fB\-\-stress\-\fR\fB\fIxxx\fR\fR
848
 
options apply in this case.
849
 
.TP 3n
850
 
\(bu
 
1613
options apply in this case\&.
 
1614
.RE
 
1615
.sp
 
1616
.RS 4
 
1617
.ie n \{\
 
1618
\h'-04'\(bu\h'+03'\c
 
1619
.\}
 
1620
.el \{\
 
1621
.sp -1
 
1622
.IP \(bu 2.3
 
1623
.\}
 
1624
.\" mysql-test-run.pl: stress-init-file option
 
1625
.\" stress-init-file option: mysql-test-run.pl
851
1626
\fB\-\-stress\-init\-file=\fR\fB\fIfile_name\fR\fR
852
1627
.sp
853
1628
\fIfile_name\fR
854
 
is the location of the file that contains the list of tests. The default file is
855
 
\fIstress_init.txt\fR
856
 
in the test suite directory.
857
 
.TP 3n
858
 
\(bu
 
1629
is the location of the file that contains the list of tests\&. The default file is
 
1630
stress_init\&.txt
 
1631
in the test suite directory\&.
 
1632
.RE
 
1633
.sp
 
1634
.RS 4
 
1635
.ie n \{\
 
1636
\h'-04'\(bu\h'+03'\c
 
1637
.\}
 
1638
.el \{\
 
1639
.sp -1
 
1640
.IP \(bu 2.3
 
1641
.\}
 
1642
.\" mysql-test-run.pl: stress-loop-count option
 
1643
.\" stress-loop-count option: mysql-test-run.pl
859
1644
\fB\-\-stress\-loop\-count=\fR\fB\fIN\fR\fR
860
1645
.sp
861
 
In sequential stress\-test mode, the number of loops to execute before exiting.
862
 
.TP 3n
863
 
\(bu
 
1646
In sequential stress\-test mode, the number of loops to execute before exiting\&.
 
1647
.RE
 
1648
.sp
 
1649
.RS 4
 
1650
.ie n \{\
 
1651
\h'-04'\(bu\h'+03'\c
 
1652
.\}
 
1653
.el \{\
 
1654
.sp -1
 
1655
.IP \(bu 2.3
 
1656
.\}
 
1657
.\" mysql-test-run.pl: stress-mode option
 
1658
.\" stress-mode option: mysql-test-run.pl
864
1659
\fB\-\-stress\-mode=\fR\fB\fImode\fR\fR
865
1660
.sp
866
 
This option indicates the test order in stress\-test mode. The
 
1661
This option indicates the test order in stress\-test mode\&. The
867
1662
\fImode\fR
868
1663
value is either
869
1664
random
870
1665
to select tests in random order or
871
1666
seq
872
 
to run tests in each thread in the order specified in the test list file. The default mode is
873
 
random.
874
 
.TP 3n
875
 
\(bu
 
1667
to run tests in each thread in the order specified in the test list file\&. The default mode is
 
1668
random\&.
 
1669
.RE
 
1670
.sp
 
1671
.RS 4
 
1672
.ie n \{\
 
1673
\h'-04'\(bu\h'+03'\c
 
1674
.\}
 
1675
.el \{\
 
1676
.sp -1
 
1677
.IP \(bu 2.3
 
1678
.\}
 
1679
.\" mysql-test-run.pl: stress-suite option
 
1680
.\" stress-suite option: mysql-test-run.pl
876
1681
\fB\-\-stress\-suite=\fR\fB\fIsuite_name\fR\fR
877
1682
.sp
878
 
The name of the test suite to use for stress testing. The default suite name is
 
1683
The name of the test suite to use for stress testing\&. The default suite name is
879
1684
main
880
1685
(the regular test suite located in the
881
 
\fImysql\-test\fR
882
 
directory).
883
 
.TP 3n
884
 
\(bu
 
1686
mysql\-test
 
1687
directory)\&.
 
1688
.RE
 
1689
.sp
 
1690
.RS 4
 
1691
.ie n \{\
 
1692
\h'-04'\(bu\h'+03'\c
 
1693
.\}
 
1694
.el \{\
 
1695
.sp -1
 
1696
.IP \(bu 2.3
 
1697
.\}
 
1698
.\" mysql-test-run.pl: stress-test-count option
 
1699
.\" stress-test-count option: mysql-test-run.pl
885
1700
\fB\-\-stress\-test\-count=\fR\fB\fIN\fR\fR
886
1701
.sp
887
 
For stress testing, the number of tests to execute before exiting.
888
 
.TP 3n
889
 
\(bu
 
1702
For stress testing, the number of tests to execute before exiting\&.
 
1703
.RE
 
1704
.sp
 
1705
.RS 4
 
1706
.ie n \{\
 
1707
\h'-04'\(bu\h'+03'\c
 
1708
.\}
 
1709
.el \{\
 
1710
.sp -1
 
1711
.IP \(bu 2.3
 
1712
.\}
 
1713
.\" mysql-test-run.pl: stress-test-duration option
 
1714
.\" stress-test-duration option: mysql-test-run.pl
890
1715
\fB\-\-stress\-test\-duration=\fR\fB\fIN\fR\fR
891
1716
.sp
892
 
For stress testing, the duration of stress testing in seconds.
893
 
.TP 3n
894
 
\(bu
 
1717
For stress testing, the duration of stress testing in seconds\&.
 
1718
.RE
 
1719
.sp
 
1720
.RS 4
 
1721
.ie n \{\
 
1722
\h'-04'\(bu\h'+03'\c
 
1723
.\}
 
1724
.el \{\
 
1725
.sp -1
 
1726
.IP \(bu 2.3
 
1727
.\}
 
1728
.\" mysql-test-run.pl: stress-test-file option
 
1729
.\" stress-test-file option: mysql-test-run.pl
895
1730
\fB\-\-stress\-test\-file=\fR\fB\fIfile_name\fR\fR
896
1731
.sp
897
 
The file that contains the list of tests to use in stress testing. The tests should be named without the
898
 
\fI.test\fR
899
 
extension. The default file is
900
 
\fIstress_tests.txt\fR
901
 
in the test suite directory.
902
 
.TP 3n
903
 
\(bu
 
1732
The file that contains the list of tests to use in stress testing\&. The tests should be named without the
 
1733
\&.test
 
1734
extension\&. The default file is
 
1735
stress_tests\&.txt
 
1736
in the test suite directory\&.
 
1737
.RE
 
1738
.sp
 
1739
.RS 4
 
1740
.ie n \{\
 
1741
\h'-04'\(bu\h'+03'\c
 
1742
.\}
 
1743
.el \{\
 
1744
.sp -1
 
1745
.IP \(bu 2.3
 
1746
.\}
 
1747
.\" mysql-test-run.pl: stress-threads option
 
1748
.\" stress-threads option: mysql-test-run.pl
904
1749
\fB\-\-stress\-threads=\fR\fB\fIN\fR\fR
905
1750
.sp
906
 
The number of threads to use in stress testing. The default is 5.
907
 
.TP 3n
908
 
\(bu
 
1751
The number of threads to use in stress testing\&. The default is 5\&.
 
1752
.RE
 
1753
.sp
 
1754
.RS 4
 
1755
.ie n \{\
 
1756
\h'-04'\(bu\h'+03'\c
 
1757
.\}
 
1758
.el \{\
 
1759
.sp -1
 
1760
.IP \(bu 2.3
 
1761
.\}
 
1762
.\" mysql-test-run.pl: suite option
 
1763
.\" suite option: mysql-test-run.pl
909
1764
\fB\-\-suite=\fR\fB\fIsuite_name\fR\fR
910
1765
.sp
911
 
Run the named test suite. The default name is
 
1766
Run the named test suite\&. The default name is
912
1767
main
913
1768
(the regular test suite located in the
914
 
\fImysql\-test\fR
915
 
directory).
916
 
.TP 3n
917
 
\(bu
 
1769
mysql\-test
 
1770
directory)\&.
 
1771
.RE
 
1772
.sp
 
1773
.RS 4
 
1774
.ie n \{\
 
1775
\h'-04'\(bu\h'+03'\c
 
1776
.\}
 
1777
.el \{\
 
1778
.sp -1
 
1779
.IP \(bu 2.3
 
1780
.\}
 
1781
.\" mysql-test-run.pl: suite-timeout option
 
1782
.\" suite-timeout option: mysql-test-run.pl
918
1783
\fB\-\-suite\-timeout=\fR\fB\fIminutes\fR\fR
919
1784
.sp
920
 
Specify the maximum test suite runtime.
921
 
.TP 3n
922
 
\(bu
 
1785
Specify the maximum test suite runtime\&.
 
1786
.RE
 
1787
.sp
 
1788
.RS 4
 
1789
.ie n \{\
 
1790
\h'-04'\(bu\h'+03'\c
 
1791
.\}
 
1792
.el \{\
 
1793
.sp -1
 
1794
.IP \(bu 2.3
 
1795
.\}
 
1796
.\" mysql-test-run.pl: testcase-timeout option
 
1797
.\" testcase-timeout option: mysql-test-run.pl
923
1798
\fB\-\-testcase\-timeout\fR
924
1799
.sp
925
 
Specify the maximum test case runtime.
926
 
.TP 3n
927
 
\(bu
 
1800
Specify the maximum test case runtime\&.
 
1801
.RE
 
1802
.sp
 
1803
.RS 4
 
1804
.ie n \{\
 
1805
\h'-04'\(bu\h'+03'\c
 
1806
.\}
 
1807
.el \{\
 
1808
.sp -1
 
1809
.IP \(bu 2.3
 
1810
.\}
 
1811
.\" mysql-test-run.pl: timer option
 
1812
.\" timer option: mysql-test-run.pl
928
1813
\fB\-\-timer\fR
929
1814
.sp
930
1815
Cause
931
1816
\fBmysqltest\fR
932
 
to generate a timing file. The default file is named
933
 
\fI./var/log/timer\fR.
934
 
.TP 3n
935
 
\(bu
 
1817
to generate a timing file\&. The default file is named
 
1818
\&./var/log/timer\&.
 
1819
.RE
 
1820
.sp
 
1821
.RS 4
 
1822
.ie n \{\
 
1823
\h'-04'\(bu\h'+03'\c
 
1824
.\}
 
1825
.el \{\
 
1826
.sp -1
 
1827
.IP \(bu 2.3
 
1828
.\}
 
1829
.\" mysql-test-run.pl: tmpdir option
 
1830
.\" tmpdir option: mysql-test-run.pl
936
1831
\fB\-\-tmpdir=\fR\fB\fIpath\fR\fR
937
1832
.sp
938
 
The directory where temporary file are stored. The default location is
939
 
\fI./var/tmp\fR.
940
 
.TP 3n
941
 
\(bu
 
1833
The directory where temporary file are stored\&. The default location is
 
1834
\&./var/tmp\&.
 
1835
.RE
 
1836
.sp
 
1837
.RS 4
 
1838
.ie n \{\
 
1839
\h'-04'\(bu\h'+03'\c
 
1840
.\}
 
1841
.el \{\
 
1842
.sp -1
 
1843
.IP \(bu 2.3
 
1844
.\}
 
1845
.\" mysql-test-run.pl: unified-diff option
 
1846
.\" unified-diff option: mysql-test-run.pl
942
1847
\fB\-\-unified\-diff\fR,
943
1848
\fB\-\-udiff\fR
944
1849
.sp
945
 
Use unified diff format when presenting differences between expected and actual test case results.
946
 
.TP 3n
947
 
\(bu
 
1850
Use unified diff format when presenting differences between expected and actual test case results\&.
 
1851
.RE
 
1852
.sp
 
1853
.RS 4
 
1854
.ie n \{\
 
1855
\h'-04'\(bu\h'+03'\c
 
1856
.\}
 
1857
.el \{\
 
1858
.sp -1
 
1859
.IP \(bu 2.3
 
1860
.\}
 
1861
.\" mysql-test-run.pl: use-old-data option
 
1862
.\" use-old-data option: mysql-test-run.pl
948
1863
\fB\-\-use\-old\-data\fR
949
1864
.sp
950
 
Do not install the test databases. (Use existing ones.)
951
 
.TP 3n
952
 
\(bu
 
1865
Do not install the test databases\&. (Use existing ones\&.)
 
1866
.RE
 
1867
.sp
 
1868
.RS 4
 
1869
.ie n \{\
 
1870
\h'-04'\(bu\h'+03'\c
 
1871
.\}
 
1872
.el \{\
 
1873
.sp -1
 
1874
.IP \(bu 2.3
 
1875
.\}
 
1876
.\" mysql-test-run.pl: user-test option
 
1877
.\" user-test option: mysql-test-run.pl
953
1878
\fB\-\-user\-test=\fR\fB\fIval\fR\fR
954
1879
.sp
955
 
Unused.
956
 
.TP 3n
957
 
\(bu
 
1880
Unused\&.
 
1881
.RE
 
1882
.sp
 
1883
.RS 4
 
1884
.ie n \{\
 
1885
\h'-04'\(bu\h'+03'\c
 
1886
.\}
 
1887
.el \{\
 
1888
.sp -1
 
1889
.IP \(bu 2.3
 
1890
.\}
 
1891
.\" mysql-test-run.pl: user option
 
1892
.\" user option: mysql-test-run.pl
958
1893
\fB\-\-user=\fR\fB\fIuser_name\fR\fR
959
1894
.sp
960
 
The MySQL user name to use when connecting to the server.
961
 
.TP 3n
962
 
\(bu
 
1895
The MySQL user name to use when connecting to the server\&.
 
1896
.RE
 
1897
.sp
 
1898
.RS 4
 
1899
.ie n \{\
 
1900
\h'-04'\(bu\h'+03'\c
 
1901
.\}
 
1902
.el \{\
 
1903
.sp -1
 
1904
.IP \(bu 2.3
 
1905
.\}
 
1906
.\" mysql-test-run.pl: valgrind option
 
1907
.\" valgrind option: mysql-test-run.pl
963
1908
\fB\-\-valgrind\fR
964
1909
.sp
965
1910
Run
967
1912
and
968
1913
\fBmysqld\fR
969
1914
with
970
 
\fBvalgrind\fR.
971
 
.TP 3n
972
 
\(bu
 
1915
\fBvalgrind\fR\&.
 
1916
.RE
 
1917
.sp
 
1918
.RS 4
 
1919
.ie n \{\
 
1920
\h'-04'\(bu\h'+03'\c
 
1921
.\}
 
1922
.el \{\
 
1923
.sp -1
 
1924
.IP \(bu 2.3
 
1925
.\}
 
1926
.\" mysql-test-run.pl: valgrind-all option
 
1927
.\" valgrind-all option: mysql-test-run.pl
973
1928
\fB\-\-valgrind\-all\fR
974
1929
.sp
975
1930
Like
978
1933
and
979
1934
\fB\-\-show\-reachable\fR
980
1935
options to
981
 
\fBvalgrind\fR.
982
 
.TP 3n
983
 
\(bu
 
1936
\fBvalgrind\fR\&.
 
1937
.RE
 
1938
.sp
 
1939
.RS 4
 
1940
.ie n \{\
 
1941
\h'-04'\(bu\h'+03'\c
 
1942
.\}
 
1943
.el \{\
 
1944
.sp -1
 
1945
.IP \(bu 2.3
 
1946
.\}
 
1947
.\" mysql-test-run.pl: valgrind-mysqltest option
 
1948
.\" valgrind-mysqltest option: mysql-test-run.pl
984
1949
\fB\-\-valgrind\-mysqltest\fR
985
1950
.sp
986
1951
Run
987
1952
\fBmysqltest\fR
988
1953
with
989
 
\fBvalgrind\fR.
990
 
.TP 3n
991
 
\(bu
 
1954
\fBvalgrind\fR\&.
 
1955
.RE
 
1956
.sp
 
1957
.RS 4
 
1958
.ie n \{\
 
1959
\h'-04'\(bu\h'+03'\c
 
1960
.\}
 
1961
.el \{\
 
1962
.sp -1
 
1963
.IP \(bu 2.3
 
1964
.\}
 
1965
.\" mysql-test-run.pl: valgrind-mysqltest-all option
 
1966
.\" valgrind-mysqltest-all option: mysql-test-run.pl
992
1967
\fB\-\-valgrind\-mysqltest\-all\fR
993
1968
.sp
994
1969
Like
997
1972
and
998
1973
\fB\-\-show\-reachable\fR
999
1974
options to
1000
 
\fBvalgrind\fR.
1001
 
.TP 3n
1002
 
\(bu
 
1975
\fBvalgrind\fR\&.
 
1976
.RE
 
1977
.sp
 
1978
.RS 4
 
1979
.ie n \{\
 
1980
\h'-04'\(bu\h'+03'\c
 
1981
.\}
 
1982
.el \{\
 
1983
.sp -1
 
1984
.IP \(bu 2.3
 
1985
.\}
 
1986
.\" mysql-test-run.pl: valgrind-options option
 
1987
.\" valgrind-options option: mysql-test-run.pl
1003
1988
\fB\-\-valgrind\-options=\fR\fB\fIstr\fR\fR
1004
1989
.sp
1005
1990
Extra options to pass to
1006
 
\fBvalgrind\fR.
1007
 
.TP 3n
1008
 
\(bu
 
1991
\fBvalgrind\fR\&.
 
1992
.RE
 
1993
.sp
 
1994
.RS 4
 
1995
.ie n \{\
 
1996
\h'-04'\(bu\h'+03'\c
 
1997
.\}
 
1998
.el \{\
 
1999
.sp -1
 
2000
.IP \(bu 2.3
 
2001
.\}
 
2002
.\" mysql-test-run.pl: valgrind-path option
 
2003
.\" valgrind-path option: mysql-test-run.pl
1009
2004
\fB\-\-valgrind\-path=\fR\fB\fIpath\fR\fR
1010
2005
.sp
1011
2006
Specify the path name to the
1012
2007
\fBvalgrind\fR
1013
 
executable.
1014
 
.TP 3n
1015
 
\(bu
 
2008
executable\&.
 
2009
.RE
 
2010
.sp
 
2011
.RS 4
 
2012
.ie n \{\
 
2013
\h'-04'\(bu\h'+03'\c
 
2014
.\}
 
2015
.el \{\
 
2016
.sp -1
 
2017
.IP \(bu 2.3
 
2018
.\}
 
2019
.\" mysql-test-run.pl: vardir option
 
2020
.\" vardir option: mysql-test-run.pl
1016
2021
\fB\-\-vardir=\fR\fB\fIpath\fR\fR
1017
2022
.sp
1018
 
Specify the path where files generated during the test run are stored. The default location is
1019
 
\fI./var\fR.
1020
 
.TP 3n
1021
 
\(bu
 
2023
Specify the path where files generated during the test run are stored\&. The default location is
 
2024
\&./var\&.
 
2025
.RE
 
2026
.sp
 
2027
.RS 4
 
2028
.ie n \{\
 
2029
\h'-04'\(bu\h'+03'\c
 
2030
.\}
 
2031
.el \{\
 
2032
.sp -1
 
2033
.IP \(bu 2.3
 
2034
.\}
 
2035
.\" mysql-test-run.pl: view-protocol option
 
2036
.\" view-protocol option: mysql-test-run.pl
1022
2037
\fB\-\-view\-protocol\fR
1023
2038
.sp
1024
2039
Pass the
1025
2040
\fB\-\-view\-protocol\fR
1026
2041
option to
1027
 
\fBmysqltest\fR.
1028
 
.TP 3n
1029
 
\(bu
 
2042
\fBmysqltest\fR\&.
 
2043
.RE
 
2044
.sp
 
2045
.RS 4
 
2046
.ie n \{\
 
2047
\h'-04'\(bu\h'+03'\c
 
2048
.\}
 
2049
.el \{\
 
2050
.sp -1
 
2051
.IP \(bu 2.3
 
2052
.\}
 
2053
.\" mysql-test-run.pl: vs-config option
 
2054
.\" vs-config option: mysql-test-run.pl
1030
2055
\fB\-\-vs\-config=\fR\fB\fIconfig_val\fR\fR
1031
2056
.sp
1032
2057
Specify the configuration used to build MySQL (for example,
1033
2058
\fB\-\-vs\-config=debug\fR
1034
 
\fB\-\-vs\-config=release\fR). This option is for Windows only. It is available as of MySQL 4.1.23, 5.0.30, and 5.1.14.
1035
 
.TP 3n
1036
 
\(bu
 
2059
\fB\-\-vs\-config=release\fR)\&. This option is for Windows only\&. It is available as of MySQL 4\&.1\&.23, 5\&.0\&.30, and 5\&.1\&.14\&.
 
2060
.RE
 
2061
.sp
 
2062
.RS 4
 
2063
.ie n \{\
 
2064
\h'-04'\(bu\h'+03'\c
 
2065
.\}
 
2066
.el \{\
 
2067
.sp -1
 
2068
.IP \(bu 2.3
 
2069
.\}
 
2070
.\" mysql-test-run.pl: wait-timeout option
 
2071
.\" wait-timeout option: mysql-test-run.pl
1037
2072
\fB\-\-wait\-timeout=\fR\fB\fIN\fR\fR
1038
2073
.sp
1039
2074
Unused?
1040
 
.TP 3n
1041
 
\(bu
 
2075
.RE
 
2076
.sp
 
2077
.RS 4
 
2078
.ie n \{\
 
2079
\h'-04'\(bu\h'+03'\c
 
2080
.\}
 
2081
.el \{\
 
2082
.sp -1
 
2083
.IP \(bu 2.3
 
2084
.\}
 
2085
.\" mysql-test-run.pl: warnings option
 
2086
.\" warnings option: mysql-test-run.pl
1042
2087
\fB\-\-warnings\fR
1043
2088
.sp
1044
2089
This option is a synonym for
1045
 
\fB\-\-log\-warnings\fR.
1046
 
.TP 3n
1047
 
\(bu
 
2090
\fB\-\-log\-warnings\fR\&.
 
2091
.RE
 
2092
.sp
 
2093
.RS 4
 
2094
.ie n \{\
 
2095
\h'-04'\(bu\h'+03'\c
 
2096
.\}
 
2097
.el \{\
 
2098
.sp -1
 
2099
.IP \(bu 2.3
 
2100
.\}
 
2101
.\" mysql-test-run.pl: with-ndbcluster option
 
2102
.\" with-ndbcluster option: mysql-test-run.pl
1048
2103
\fB\-\-with\-ndbcluster\fR
1049
2104
.sp
1050
 
Use NDB Cluster and enable test cases that require it.
1051
 
.TP 3n
1052
 
\(bu
 
2105
Use NDB Cluster and enable test cases that require it\&.
 
2106
.RE
 
2107
.sp
 
2108
.RS 4
 
2109
.ie n \{\
 
2110
\h'-04'\(bu\h'+03'\c
 
2111
.\}
 
2112
.el \{\
 
2113
.sp -1
 
2114
.IP \(bu 2.3
 
2115
.\}
 
2116
.\" mysql-test-run.pl: with-ndbcluster-all option
 
2117
.\" with-ndbcluster-all option: mysql-test-run.pl
1053
2118
\fB\-\-with\-ndbcluster\-all\fR
1054
2119
.sp
1055
 
Use NDB Cluster in all tests.
1056
 
.TP 3n
1057
 
\(bu
 
2120
Use NDB Cluster in all tests\&.
 
2121
.RE
 
2122
.sp
 
2123
.RS 4
 
2124
.ie n \{\
 
2125
\h'-04'\(bu\h'+03'\c
 
2126
.\}
 
2127
.el \{\
 
2128
.sp -1
 
2129
.IP \(bu 2.3
 
2130
.\}
 
2131
.\" mysql-test-run.pl: with-ndbcluster-only option
 
2132
.\" with-ndbcluster-only option: mysql-test-run.pl
1058
2133
\fB\-\-with\-ndbcluster\-only\fR
1059
2134
.sp
1060
2135
Run only test cases that have
1061
2136
ndb
1062
 
in their name.
1063
 
.TP 3n
1064
 
\(bu
 
2137
in their name\&.
 
2138
.RE
 
2139
.sp
 
2140
.RS 4
 
2141
.ie n \{\
 
2142
\h'-04'\(bu\h'+03'\c
 
2143
.\}
 
2144
.el \{\
 
2145
.sp -1
 
2146
.IP \(bu 2.3
 
2147
.\}
 
2148
.\" mysql-test-run.pl: with-ndbcluster-slave option
 
2149
.\" with-ndbcluster-slave option: mysql-test-run.pl
1065
2150
\fB\-\-with\-ndbcluster\-slave\fR
1066
2151
.sp
1067
 
Unknown.
1068
 
.TP 3n
1069
 
\(bu
 
2152
Unknown\&.
 
2153
.RE
 
2154
.sp
 
2155
.RS 4
 
2156
.ie n \{\
 
2157
\h'-04'\(bu\h'+03'\c
 
2158
.\}
 
2159
.el \{\
 
2160
.sp -1
 
2161
.IP \(bu 2.3
 
2162
.\}
 
2163
.\" mysql-test-run.pl: with-openssl option
 
2164
.\" with-openssl option: mysql-test-run.pl
1070
2165
\fB\-\-with\-openssl\fR
1071
2166
.sp
1072
2167
This option is a synonym for
1073
 
\fB\-\-ssl\fR.
1074
 
.sp
 
2168
\fB\-\-ssl\fR\&.
1075
2169
.RE
 
2170
.if n \{\
1076
2171
.sp
 
2172
.\}
 
2173
.RS 4
1077
2174
.it 1 an-trap
1078
2175
.nr an-no-space-flag 1
1079
2176
.nr an-break-flag 1
1080
2177
.br
 
2178
.ps +1
1081
2179
\fBNote\fR
 
2180
.ps -1
 
2181
.br
1082
2182
.PP
1083
2183
\fBmysql\-test\-run\fR
1084
2184
supports the following options not supported by
1085
 
\fBmysql\-test\-run.pl\fR:
 
2185
\fBmysql\-test\-run\&.pl\fR:
1086
2186
\fB\-\-local\fR,
1087
2187
\fB\-\-local\-master\fR,
1088
2188
\fB\-\-ndb\-verbose\fR,
1092
2192
\fB\-\-old\-master\fR,
1093
2193
\fB\-\-purify\fR,
1094
2194
\fB\-\-use\-old\-data\fR,
1095
 
\fB\-\-valgrind\-mysqltest\-all\fR.
 
2195
\fB\-\-valgrind\-mysqltest\-all\fR\&.
1096
2196
.PP
1097
2197
Conversely,
1098
 
\fBmysql\-test\-run.pl\fR
 
2198
\fBmysql\-test\-run\&.pl\fR
1099
2199
supports the following options not supported by
1100
2200
\fBmysql\-test\-run\fR:
1101
2201
\fB\-\-benchdir\fR,
1123
2223
\fB\-\-unified\-diff\fR,,
1124
2224
\fB\-\-valgrind\-path\fR,
1125
2225
\fB\-\-vardir\fR,
1126
 
\fB\-\-view\-protocol\fR.
 
2226
\fB\-\-view\-protocol\fR\&.
 
2227
.sp .5v
 
2228
.RE
1127
2229
.SH "COPYRIGHT"
 
2230
.br
1128
2231
.PP
1129
 
Copyright 2007\-2008 MySQL AB, 2009 Sun Microsystems, Inc.
 
2232
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc.
1130
2233
.PP
1131
2234
This documentation is free software; you can redistribute it and/or modify it only under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 of the License.
1132
2235
.PP
1133
2236
This documentation is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
1134
2237
.PP
1135
 
You should have received a copy of the GNU General Public License along with the program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA or see http://www.gnu.org/licenses/.
1136
 
.SH "REFERENCES"
1137
 
.TP 3
1138
 
1.\ Typical configure Options
1139
 
\%http://dev.mysql.com/doc/refman/5.1/en/configure\-options.html
 
2238
You should have received a copy of the GNU General Public License along with the program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA or see http://www.gnu.org/licenses/.
 
2239
.sp
 
2240
.SH "NOTES"
 
2241
.IP " 1." 4
 
2242
Typical \fBconfigure\fR Options
 
2243
.RS 4
 
2244
\%http://dev.mysql.com/doc/refman/5.1/en/configure-options.html
 
2245
.RE
1140
2246
.SH "SEE ALSO"
1141
2247
For more information, please refer to the MySQL Reference Manual,
1142
2248
which may already be installed locally and which is also available
1143
2249
online at http://dev.mysql.com/doc/.
1144
2250
.SH AUTHOR
1145
 
MySQL AB (http://www.mysql.com/).
 
2251
Sun Microsystems, Inc. (http://www.mysql.com/).