← Back to branch summary

~ubuntu-branches/ubuntu/maverick/mysql-5.1/maverick-proposed

« back to all changes in this revision

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

  • Committer: Package Import Robot
  • Author(s): Marc Deslauriers
  • Date: 2012-02-22 14:16:05 UTC
  • mto: This revision was merged to the branch mainline in revision 20.
  • Revision ID: package-import@ubuntu.com-20120222141605-nxlu9yzc6attylc2
Tags: upstream-5.1.61
Import upstream version 5.1.61

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/mysql-test-run.pl.1
2
2
.\"     Title: \fBmysql-test-run.pl\fR
3
3
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
4
4
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
5
 
.\"      Date: 07/02/2010
 
5
.\"      Date: 12/13/2011
6
6
.\"    Manual: MySQL Database System
7
7
.\"    Source: MySQL
8
8
.\"  Language: English
9
9
.\"
10
 
.TH "\FBMYSQL\-TEST\-RUN\" "1" "07/02/2010" "MySQL" "MySQL Database System"
 
10
.TH "\FBMYSQL\-TEST\-RUN\" "1" "12/13/2011" "MySQL" "MySQL Database System"
11
11
.\" -----------------------------------------------------------------
12
12
.\" * set default formatting
13
13
.\" -----------------------------------------------------------------
168
168
\fB\-\-skip\-grant\-tables\fR
169
169
options\&. If MySQL was configured with the
170
170
\fB\-\-disable\-grant\-options\fR
171
 
option,
 
171
option (only MySQL 5\&.1) or with the compiler flag
 
172
\fB\-DDISABLE_GRANT_OPTIONS\fR, then
172
173
\fB\-\-bootstrap\fR,
173
174
\fB\-\-skip\-grant\-tables\fR, and
174
175
\fB\-\-init\-file\fR
182
183
init_file
183
184
test will fail if
184
185
\fB\-\-init\-file\fR
185
 
is disabled\&. This is an expected failure that can be handled as follows:
186
 
.sp
187
 
.if n \{\
188
 
.RS 4
189
 
.\}
190
 
.nf
191
 
shell> \fBexport MYSQLD_BOOTSTRAP\fR
192
 
shell> \fBMYSQLD_BOOTSTRAP=/full/path/to/mysqld\fR
193
 
shell> \fBmake test force="\-\-skip\-test=init_file"\fR
194
 
.fi
195
 
.if n \{\
196
 
.RE
197
 
.\}
 
186
is disabled\&. This is an expected failure in this case\&.
198
187
.PP
199
188
To run
200
189
\fBmysql\-test\-run\&.pl\fR
229
218
instead, and may be referred to in tests\&.
230
219
.TS
231
220
allbox tab(:);
 
221
lB lB.
 
222
T{
 
223
Variable
 
224
T}:T{
 
225
Meaning
 
226
T}
 
227
.T&
 
228
l l
 
229
l l
232
230
l l
233
231
l l
234
232
l l
242
240
l l
243
241
l l.
244
242
T{
245
 
\fBVariable\fR
246
 
T}:T{
247
 
\fBMeaning\fR
248
 
T}
249
 
T{
250
243
MTR_VERSION
251
244
T}:T{
252
245
If set to 1, will run the older version 1 of
300
293
Full path name to \fBmysqld\fR that has all options enabled
301
294
T}
302
295
T{
 
296
MYSQLD_BOOTSTRAP_CMD
 
297
T}:T{
 
298
Full command line used for initial database setup for this test batch
 
299
T}
 
300
T{
 
301
MYSQLD
 
302
T}:T{
 
303
Full path to server executable used in tests\&. Supported from MySQL
 
304
                5\&.5\&.17\&.
 
305
T}
 
306
T{
 
307
MYSQLD_CMD
 
308
T}:T{
 
309
Command line for starting server as used in tests, with the minimum set
 
310
                of required arguments\&. Supported from MySQL 5\&.5\&.17\&.
 
311
T}
 
312
T{
303
313
MYSQLTEST_VARDIR
304
314
T}:T{
305
315
Path name to the var directory that is used for
332
342
can invoke itself with
333
343
exec $MYSQL_TEST\&.
334
344
.PP
335
 
Other tests may refer to the last three variables listed in the preceeding table, to locate files to read or write\&. For example, tests that need to create files will typically put them in
 
345
Other tests may refer to the last three variables listed in the preceding table, to locate files to read or write\&. For example, tests that need to create files will typically put them in
336
346
$MYSQL_TMP_DIR/\fIfile_name\fR\&.
337
347
.PP
 
348
The variable
 
349
$MYSQLD_CMD
 
350
will include any server options added with the
 
351
\fB\-\-mysqld\fR
 
352
option to
 
353
\fBmysql\-test\-run\&.pl\fR, but will not include server options added specifically for the currently running test\&.
 
354
.PP
338
355
If you are running
339
356
\fBmysql\-test\-run\&.pl\fR
340
357
version 1 by setting
394
411
.sp -1
395
412
.IP \(bu 2.3
396
413
.\}
 
414
.\" mysql-test-run.pl: boot-dbx option
 
415
.\" boot-dbx option: mysql-test-run.pl
 
416
\fB\-\-boot\-dbx\fR
 
417
.sp
 
418
Run the
 
419
\fBmysqld\fR
 
420
server used for bootstrapping the database through the
 
421
\fBdbx\fR
 
422
debugger\&. This option is available from MySQL 5\&.5\&.17\&.
 
423
.RE
 
424
.sp
 
425
.RS 4
 
426
.ie n \{\
 
427
\h'-04'\(bu\h'+03'\c
 
428
.\}
 
429
.el \{\
 
430
.sp -1
 
431
.IP \(bu 2.3
 
432
.\}
 
433
.\" mysql-test-run.pl: boot-ddd option
 
434
.\" boot-ddd option: mysql-test-run.pl
 
435
\fB\-\-boot\-ddd\fR
 
436
.sp
 
437
Run the
 
438
\fBmysqld\fR
 
439
server used for bootstrapping the database through the
 
440
\fBddd\fR
 
441
debugger\&. This option is available from MySQL 5\&.5\&.17\&.
 
442
.RE
 
443
.sp
 
444
.RS 4
 
445
.ie n \{\
 
446
\h'-04'\(bu\h'+03'\c
 
447
.\}
 
448
.el \{\
 
449
.sp -1
 
450
.IP \(bu 2.3
 
451
.\}
 
452
.\" mysql-test-run.pl: boot-gdb option
 
453
.\" boot-gdb option: mysql-test-run.pl
 
454
\fB\-\-boot\-gdb\fR
 
455
.sp
 
456
Run the
 
457
\fBmysqld\fR
 
458
server used for bootstrapping the database through the
 
459
\fBgdb\fR
 
460
debugger\&. This option is available from MySQL 5\&.5\&.17\&.
 
461
.RE
 
462
.sp
 
463
.RS 4
 
464
.ie n \{\
 
465
\h'-04'\(bu\h'+03'\c
 
466
.\}
 
467
.el \{\
 
468
.sp -1
 
469
.IP \(bu 2.3
 
470
.\}
397
471
.\" mysql-test-run.pl: build-thread option
398
472
.\" build-thread option: mysql-test-run.pl
399
473
\fB\-\-build\-thread=\fR\fB\fInumber\fR\fR
456
530
.sp -1
457
531
.IP \(bu 2.3
458
532
.\}
 
533
.\" mysql-test-run.pl: clean-vardir option
 
534
.\" clean-vardir option: mysql-test-run.pl
 
535
\fB\-\-clean\-vardir\fR
 
536
.sp
 
537
Clean up the
 
538
var
 
539
directory with logs and test results etc\&. after the test run, but only if there were no test failures\&. This option only has effect if also running with option
 
540
\fB\-\-mem\fR\&. The intent is to alleviate the problem of using up memory for test results, in cases where many different test runs are being done on the same host\&.
 
541
.sp
 
542
The
 
543
\fB\-\-clean\-vardir\fR
 
544
option is available from MySQL 5\&.5\&.
 
545
.RE
 
546
.sp
 
547
.RS 4
 
548
.ie n \{\
 
549
\h'-04'\(bu\h'+03'\c
 
550
.\}
 
551
.el \{\
 
552
.sp -1
 
553
.IP \(bu 2.3
 
554
.\}
459
555
.\" mysql-test-run.pl: client-bindir option
460
556
.\" client-bindir option: mysql-test-run.pl
461
557
\fB\-\-client\-bindir=\fR\fB\fIpath\fR\fR
471
567
.sp -1
472
568
.IP \(bu 2.3
473
569
.\}
 
570
.\" mysql-test-run.pl: client-dbx option
 
571
.\" client-dbx option: mysql-test-run.pl
 
572
\fB\-\-client\-dbx\fR
 
573
.sp
 
574
Start
 
575
\fBmysqltest\fR
 
576
in the
 
577
\fBdbx\fR
 
578
debugger\&. Support for dbx is available from MySQL 5\&.5\&.12\&.
 
579
.RE
 
580
.sp
 
581
.RS 4
 
582
.ie n \{\
 
583
\h'-04'\(bu\h'+03'\c
 
584
.\}
 
585
.el \{\
 
586
.sp -1
 
587
.IP \(bu 2.3
 
588
.\}
474
589
.\" mysql-test-run.pl: client-ddd option
475
590
.\" client-ddd option: mysql-test-run.pl
476
591
\fB\-\-client\-ddd\fR
625
740
.sp -1
626
741
.IP \(bu 2.3
627
742
.\}
 
743
.\" mysql-test-run.pl: dbx option
 
744
.\" gdb option: mysql-test-run.pl
 
745
\fB\-\-dbx\fR
 
746
.sp
 
747
Start
 
748
\fBmysqld\fR
 
749
in the
 
750
\fBdbx\fR
 
751
debugger\&. Support for dbx is available from MySQL 5\&.5\&.12\&.
 
752
.RE
 
753
.sp
 
754
.RS 4
 
755
.ie n \{\
 
756
\h'-04'\(bu\h'+03'\c
 
757
.\}
 
758
.el \{\
 
759
.sp -1
 
760
.IP \(bu 2.3
 
761
.\}
628
762
.\" mysql-test-run.pl: ddd option
629
763
.\" ddd option: mysql-test-run.pl
630
764
\fB\-\-ddd\fR
676
810
.sp -1
677
811
.IP \(bu 2.3
678
812
.\}
 
813
.\" mysql-test-run.pl: debug-server option
 
814
.\" debug-server option: mysql-test-run.pl
 
815
\fB\-\-debug\-server\fR
 
816
.sp
 
817
Runs
 
818
mysqld\&.debug
 
819
(if available) instead of
 
820
mysqld
 
821
as server\&. If it does find
 
822
mysqld\&.debug, it will search for plugin libraries in a subdirectory
 
823
debug
 
824
under the directory where it\'s normally located\&. This option does not turn on trace output and is independt of the
 
825
\fBdebug\fR
 
826
option\&.
 
827
.sp
 
828
The
 
829
\fBdebug\-server\fR
 
830
option was added in MySQL 5\&.1\&.56 and 5\&.5\&.10\&.
 
831
.RE
 
832
.sp
 
833
.RS 4
 
834
.ie n \{\
 
835
\h'-04'\(bu\h'+03'\c
 
836
.\}
 
837
.el \{\
 
838
.sp -1
 
839
.IP \(bu 2.3
 
840
.\}
679
841
.\" mysql-test-run.pl: debug-sync-timeout option
680
842
.\" debug-sync-timeout option: mysql-test-run.pl
681
843
\fB\-\-debug\-sync\-timeout=\fR\fB\fIN\fR\fR
695
857
For information about using the Debug Sync facility for testing, see
696
858
Section\ \&4.14, \(lqThread Synchronization in Test Cases\(rq\&.
697
859
.sp
698
 
This option was added in MySQL 5\&.1\&.41/5\&.5\&.0/6\&.0\&.6\&.
 
860
This option was added in MySQL 5\&.1\&.41\&.
 
861
.RE
 
862
.sp
 
863
.RS 4
 
864
.ie n \{\
 
865
\h'-04'\(bu\h'+03'\c
 
866
.\}
 
867
.el \{\
 
868
.sp -1
 
869
.IP \(bu 2.3
 
870
.\}
 
871
.\" mysql-test-run.pl: default-myisam option
 
872
.\" default-myisam option: mysql-test-run.pl
 
873
\fB\-\-default\-myisam\fR
 
874
.sp
 
875
Use MyISAM as default engine for all except InnoDB\-specific tests\&. This option was added in MySQL 5\&.5 and is on by default\&. It may be changed to off by default in a later release\&. See also
 
876
\fB\-\-nodefault\-myisam\fR\&.
699
877
.RE
700
878
.sp
701
879
.RS 4
816
994
[ fail ]
817
995
if they fail\&. This option was added in MySQL 5\&.1\&.33\&.
818
996
.sp
819
 
For an example of a file that might be specified via this option, see
 
997
For an example of a file that might be specified using this option, see
820
998
mysql\-test/collections/default\&.experimental\&.
 
999
.sp
 
1000
From MySQL 5\&.1\&.51, it\'s possible to supply more than one
 
1001
\fB\-\-experimental\fR, test cases listed in all the files will be treated as experimental\&.
821
1002
.RE
822
1003
.sp
823
1004
.RS 4
899
1080
.sp -1
900
1081
.IP \(bu 2.3
901
1082
.\}
 
1083
.\" mysql-test-run.pl: force-restart option
 
1084
.\" force-restart option: mysql-test-run.pl
 
1085
\fB\-\-force\-restart\fR
 
1086
.sp
 
1087
Always restart the server(s) between each tast case, whether it\'s needed or not\&. Will also restart between repeated runs of the same test case\&. This may be useful e\&.g\&. when looking for the source of a memory leak, as there will only have been one test run before the server exits\&.
 
1088
.sp
 
1089
The
 
1090
\fB\-\-force\-restart\fR
 
1091
option was added in MySQL version 5\&.1\&.52\&.
 
1092
.RE
 
1093
.sp
 
1094
.RS 4
 
1095
.ie n \{\
 
1096
\h'-04'\(bu\h'+03'\c
 
1097
.\}
 
1098
.el \{\
 
1099
.sp -1
 
1100
.IP \(bu 2.3
 
1101
.\}
902
1102
.\" mysql-test-run.pl: gcov option
903
1103
.\" gcov option: mysql-test-run.pl
904
1104
\fB\-\-gcov\fR
954
1154
.sp -1
955
1155
.IP \(bu 2.3
956
1156
.\}
 
1157
.\" mysql-test-run.pl: include-ndbcluster option
 
1158
.\" include-ndbcluster option: mysql-test-run.pl
 
1159
\fB\-\-include\-ndbcluster\fR,
 
1160
.\" mysql-test-run.pl: include-ndb option
 
1161
.\" include-ndb option: mysql-test-run.pl
 
1162
\fB\-\-include\-ndb\fR
 
1163
.sp
 
1164
Run also tests that need Cluster\&. This is the default behavior up to MySQL 5\&.1\&.51\&. From MySQL 5\&.1\&.52 this option has been added to re\-enable running Cluster tests\&.
 
1165
.RE
 
1166
.sp
 
1167
.RS 4
 
1168
.ie n \{\
 
1169
\h'-04'\(bu\h'+03'\c
 
1170
.\}
 
1171
.el \{\
 
1172
.sp -1
 
1173
.IP \(bu 2.3
 
1174
.\}
 
1175
.\" mysql-test-run.pl: manual-dbx option
 
1176
.\" manual-dbx option: mysql-test-run.pl
 
1177
\fB\-\-manual\-dbx\fR
 
1178
.sp
 
1179
Use a server that has already been started by the user in the
 
1180
\fBdbx\fR
 
1181
debugger\&. Support for dbx is available from MySQL 5\&.5\&.12\&.
 
1182
.RE
 
1183
.sp
 
1184
.RS 4
 
1185
.ie n \{\
 
1186
\h'-04'\(bu\h'+03'\c
 
1187
.\}
 
1188
.el \{\
 
1189
.sp -1
 
1190
.IP \(bu 2.3
 
1191
.\}
957
1192
.\" mysql-test-run.pl: manual-ddd option
958
1193
.\" manual-ddd option: mysql-test-run.pl
959
1194
\fB\-\-manual\-ddd\fR
1142
1377
.sp -1
1143
1378
.IP \(bu 2.3
1144
1379
.\}
 
1380
.\" mysql-test-run.pl: mysqld-env option
 
1381
.\" mysqld-env option: mysql-test-run.pl
 
1382
\fB\-\-mysqld\-env=\fR\fB\fIvariable\fR\fR\fB=\fR\fB\fIvalue\fR\fR
 
1383
.sp
 
1384
Sets (or changes) an environment variable before starting
 
1385
\fBmysqld\fR\&. Varibles set in the environment from which you run
 
1386
\fBmysql\-test\-run\&.pl\fR
 
1387
will normally also be propagated to
 
1388
\fBmysqld\fR, but there may be cases where you want a setting just for a single run, or you may not want the setting to affect other programs\&. You may use additional
 
1389
\fB\-\-mysqld\-env\fR
 
1390
options to set more than one variable\&.
 
1391
.sp
 
1392
The
 
1393
\fB\-\-mysqld\-env\fR
 
1394
option is available from MySQL 5\&.5\&.10\&.
 
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
.\}
1145
1405
.\" mysql-test-run.pl: ndb-connectstring option
1146
1406
.\" ndb-connectstring option: mysql-test-run.pl
1147
1407
\fB\-\-ndb\-connectstring=\fR\fB\fIstr\fR\fR
1178
1438
.sp -1
1179
1439
.IP \(bu 2.3
1180
1440
.\}
 
1441
.\" mysql-test-run.pl: nodefault-myisam option
 
1442
.\" nodefault-myisam option: mysql-test-run.pl
 
1443
\fB\-\-nodefault\-myisam\fR
 
1444
.sp
 
1445
Do not override the build\-in default engine to use MyISAM instead for non\-InnoDB tests\&. This option was added in MySQL 5\&.5\&. Since the existing collection of tests were originally adapted for MyISAM as default, many tests will fail when this option is used, because the test behaves differently or produces different output when the engine switches to InnoDB\&.
 
1446
.RE
 
1447
.sp
 
1448
.RS 4
 
1449
.ie n \{\
 
1450
\h'-04'\(bu\h'+03'\c
 
1451
.\}
 
1452
.el \{\
 
1453
.sp -1
 
1454
.IP \(bu 2.3
 
1455
.\}
1181
1456
.\" mysql-test-run.pl: noreorder option
1182
1457
.\" noreorder option: mysql-test-run.pl
1183
1458
\fB\-\-noreorder\fR
1184
1459
.sp
1185
 
Do not reorder tests to reduce number of restarts, but run them in exactly the order given\&. If a whole suite is to be run, the tests are run in alphabetical order, though similiar combinations will be grouped together\&. If more than one suite is listed, the tests are run one suite at a time, in the order listed\&.
 
1460
Do not reorder tests to reduce number of restarts, but run them in exactly the order given\&. If a whole suite is to be run, the tests are run in alphabetic order, though similiar combinations will be grouped together\&. If more than one suite is listed, the tests are run one suite at a time, in the order listed\&.
1186
1461
.RE
1187
1462
.sp
1188
1463
.RS 4
1210
1485
.sp -1
1211
1486
.IP \(bu 2.3
1212
1487
.\}
 
1488
.\" mysql-test-run.pl: nounit-tests option
 
1489
.\" nounit-tests option: mysql-test-run.pl
 
1490
\fB\-\-nounit\-tests\fR
 
1491
.sp
 
1492
Do not run unit tests, overriding default behaviour or setting of the
 
1493
MTR_UNIT_TESTS
 
1494
variable\&.
 
1495
.sp
 
1496
Running of unit tests was enabled from MySQL 5\&.5\&.11\&.
 
1497
.RE
 
1498
.sp
 
1499
.RS 4
 
1500
.ie n \{\
 
1501
\h'-04'\(bu\h'+03'\c
 
1502
.\}
 
1503
.el \{\
 
1504
.sp -1
 
1505
.IP \(bu 2.3
 
1506
.\}
1213
1507
.\" mysql-test-run.pl: nowarnings option
1214
1508
.\" nowarnings option: mysql-test-run.pl
1215
1509
\fB\-\-nowarnings\fR
1374
1668
.sp -1
1375
1669
.IP \(bu 2.3
1376
1670
.\}
 
1671
.\" mysql-test-run.pl: report-times option
 
1672
.\" report-times option: mysql-test-run.pl
 
1673
\fB\-\-report\-times\fR
 
1674
.sp
 
1675
At the end of the test run, write a summary of how much time was spent in various phases of execution\&. If you run with
 
1676
\fB\-\-parallel\fR, the total will exceed the wall clock time passed, since it will be summed over all threads\&.
 
1677
.sp
 
1678
The times reported should only be treated as approximations, and the exact points where the time is taken may also change between releases\&. If the test run is aborted, including if a test fails and
 
1679
\fB\-\-force\fR
 
1680
is not in use, the time report will not be produced\&.
 
1681
.sp
 
1682
The
 
1683
\fB\-\-report\-times\fR
 
1684
is available from MySQL 5\&.5\&.
 
1685
.RE
 
1686
.sp
 
1687
.RS 4
 
1688
.ie n \{\
 
1689
\h'-04'\(bu\h'+03'\c
 
1690
.\}
 
1691
.el \{\
 
1692
.sp -1
 
1693
.IP \(bu 2.3
 
1694
.\}
1377
1695
.\" mysql-test-run.pl: retry option
1378
1696
.\" retry option: mysql-test-run.pl
1379
1697
\fB\-\-retry=\fR\fB\fIN\fR\fR
1453
1771
.\" skip-ndb option: mysql-test-run.pl
1454
1772
\fB\-\-skip\-ndb\fR
1455
1773
.sp
1456
 
Do not start NDB Cluster; skip Cluster test cases\&.
 
1774
Do not start NDB Cluster; skip Cluster test cases\&. From MySQL 5\&.1\&.52, this is the default and so this option does not do anything but is kept for backwards compatibility\&.
1457
1775
.RE
1458
1776
.sp
1459
1777
.RS 4
1535
1853
.sp -1
1536
1854
.IP \(bu 2.3
1537
1855
.\}
 
1856
.\" mysql-test-run.pl: skip-test-list option
 
1857
.\" skip-test-list option: mysql-test-run.pl
 
1858
\fB\-\-skip\-test\-list=\fR\fB\fIfile\fR\fR
 
1859
.sp
 
1860
Specify a file listing tests that should be skipped (disabled)\&.
 
1861
.sp
 
1862
The file has the same format as the
 
1863
disabled\&.def
 
1864
file listing disabled tests\&. With this option, disabling can be done on a case by case basis\&. The
 
1865
\fB\-\-skip\-test\-list\fR
 
1866
option is supported from MySQL 5\&.5\&.
 
1867
.RE
 
1868
.sp
 
1869
.RS 4
 
1870
.ie n \{\
 
1871
\h'-04'\(bu\h'+03'\c
 
1872
.\}
 
1873
.el \{\
 
1874
.sp -1
 
1875
.IP \(bu 2.3
 
1876
.\}
1538
1877
\fB\-\-skip\-*\fR
1539
1878
.sp
1540
1879
\fB\-\-skip\-*\fR
1595
1934
\fBmysql\-test\-run\&.pl\fR
1596
1935
is started with the
1597
1936
\fB\-\-ssl\fR
1598
 
option, it sets up a secure conection for all test cases\&. In this case, if
 
1937
option, it sets up a secure connection for all test cases\&. In this case, if
1599
1938
\fBmysqld\fR
1600
1939
does not support SSL,
1601
1940
\fBmysql\-test\-run\&.pl\fR
1611
1950
.sp -1
1612
1951
.IP \(bu 2.3
1613
1952
.\}
1614
 
.\" mysql-test-run.pl: start-and-exit option
1615
 
.\" start-and-exit option: mysql-test-run.pl
 
1953
.\" mysql-test-run.pl: start option
 
1954
.\" start option: mysql-test-run.pl
1616
1955
\fB\-\-start\fR
1617
1956
.sp
1618
1957
Initialize and start servers with the startup settings for the specified test case\&. 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
1647
1986
.sp -1
1648
1987
.IP \(bu 2.3
1649
1988
.\}
 
1989
.\" mysql-test-run.pl: start-and-exit option
 
1990
.\" start-and-exit option: mysql-test-run.pl
 
1991
\fB\-\-start\-and\-exit\fR
 
1992
.sp
 
1993
This is similar to
 
1994
\fB\-\-start\fR, but
 
1995
\fBmysql\-test\-run\&.pl\fR
 
1996
terminates once the server has been started, leaving just the server process running\&.
 
1997
.sp
 
1998
Tha
 
1999
\fB\-\-start\-and\-exit\fR
 
2000
was available with version 1 of
 
2001
\fBmysql\-test\-run\&.pl\fR
 
2002
(unlike
 
2003
\fB\-\-start\fR
 
2004
which came with version 2), and is again supported in version 2 from MySQL 5\&.1\&.51\&.
 
2005
.RE
 
2006
.sp
 
2007
.RS 4
 
2008
.ie n \{\
 
2009
\h'-04'\(bu\h'+03'\c
 
2010
.\}
 
2011
.el \{\
 
2012
.sp -1
 
2013
.IP \(bu 2.3
 
2014
.\}
1650
2015
.\" mysql-test-run.pl: start-dirty option
1651
2016
.\" start-dirty option: mysql-test-run.pl
1652
2017
\fB\-\-start\-dirty\fR
1698
2063
.sp -1
1699
2064
.IP \(bu 2.3
1700
2065
.\}
 
2066
.\" mysql-test-run.pl: stress option
 
2067
.\" stress option: mysql-test-run.pl
 
2068
\fB\-\-stress=\fR\fB\fIstress options\fR\fR
 
2069
.sp
 
2070
Start a server, but instead of running a test, run
 
2071
\fBmysql\-stress\-test\&.pl\fR
 
2072
with the supplied arguments\&. Arguments needed to communicate with the server will be automatically provided, the rest should be given as arguments to this option\&. Command line options for
 
2073
\fBmysql\-stress\-test\&.pl\fR
 
2074
should be separeted by a comma\&.
 
2075
.sp
 
2076
The
 
2077
\fBstress\fR
 
2078
option was added in MySQL 5\&.5\&.17, it is not a direct replacement for the option of the same name that exists in version 1 of
 
2079
\fBmysql\-test\-run\&.pl\fR\&.
 
2080
.RE
 
2081
.sp
 
2082
.RS 4
 
2083
.ie n \{\
 
2084
\h'-04'\(bu\h'+03'\c
 
2085
.\}
 
2086
.el \{\
 
2087
.sp -1
 
2088
.IP \(bu 2.3
 
2089
.\}
1701
2090
.\" mysql-test-run.pl: suite option
1702
2091
.\" suite option: mysql-test-run.pl
1703
2092
\fB\-\-suite=\fR\fB\fIsuite_name\fR\fR
1814
2203
.sp -1
1815
2204
.IP \(bu 2.3
1816
2205
.\}
 
2206
.\" mysql-test-run.pl: unit-tests option
 
2207
.\" unit-tests option: mysql-test-run.pl
 
2208
\fB\-\-unit\-tests\fR
 
2209
.sp
 
2210
Force running of unit tests, overriding default behaviour or setting of the
 
2211
MTR_UNIT_TESTS
 
2212
variable\&.
 
2213
.sp
 
2214
Running of unit tests was enabled from MySQL 5\&.5\&.11\&.
 
2215
.RE
 
2216
.sp
 
2217
.RS 4
 
2218
.ie n \{\
 
2219
\h'-04'\(bu\h'+03'\c
 
2220
.\}
 
2221
.el \{\
 
2222
.sp -1
 
2223
.IP \(bu 2.3
 
2224
.\}
1817
2225
.\" mysql-test-run.pl: user option
1818
2226
.\" user option: mysql-test-run.pl
1819
2227
\fB\-\-user=\fR\fB\fIuser_name\fR\fR
1829
2237
.sp -1
1830
2238
.IP \(bu 2.3
1831
2239
.\}
 
2240
.\" mysql-test-run.pl: user-args option
 
2241
.\" user-args option: mysql-test-run.pl
 
2242
\fB\-\-user\-args\fR
 
2243
.sp
 
2244
Drops all non\-essential command line arguments to the
 
2245
\fBmysqld\fR
 
2246
server, except those supplied with
 
2247
\fB\-\-mysqld\fR
 
2248
arguemnts, if any\&. Only works in combination with
 
2249
\fB\-\-start\fR,
 
2250
\fB\-\-start\-and\-exit\fR
 
2251
or
 
2252
\fB\-\-start\-dirty\fR, and only if no test name is given\&.
 
2253
.sp
 
2254
The
 
2255
\fB\-\-user\-args\fR
 
2256
option was added in MySQL 5\&.1\&.51\&.
 
2257
.RE
 
2258
.sp
 
2259
.RS 4
 
2260
.ie n \{\
 
2261
\h'-04'\(bu\h'+03'\c
 
2262
.\}
 
2263
.el \{\
 
2264
.sp -1
 
2265
.IP \(bu 2.3
 
2266
.\}
1832
2267
.\" mysql-test-run.pl: valgrind option
1833
2268
.\" valgrind option: mysql-test-run.pl
1834
2269
\fB\-\-valgrind\fR
1838
2273
and
1839
2274
\fBmysqld\fR
1840
2275
with
1841
 
\fBvalgrind\fR\&. Thiks and the following
 
2276
\fBvalgrind\fR\&. This and the following
1842
2277
\fB\-\-valgrind\fR
1843
2278
options require that the executables have been build with
1844
2279
\fBvalgrind\fR
1845
2280
support\&.
 
2281
.sp
 
2282
When the server is run with valgrind, an extra pass over the server log file(s) will be performed after all tests are run, and any report with problems that have been reported at server shutdown will be extracted and printed\&. The most common warnings are memory leaks\&. With each report will also be listed all tests that were run since previous server restart; one of these is likely to have caused the problem\&. This reporting was added in MySQL 5\&.1\&.45\&.
 
2283
.sp
 
2284
From MySQL 5\&.5\&.13, a final "pseudo" test named
 
2285
valgrind_report
 
2286
is added to the list of tests when the server is run in valgrind\&. This test is reported as failed if any such shutdown warnings were produced by valgrind\&. Pass or failure of this test is also added to the total test count reported\&.
1846
2287
.RE
1847
2288
.sp
1848
2289
.RS 4
2053
2494
.SH "COPYRIGHT"
2054
2495
.br
2055
2496
.PP
2056
 
Copyright \(co 2007, 2010, Oracle and/or its affiliates. All rights reserved.
 
2497
Copyright \(co 2007, 2011, Oracle and/or its affiliates. All rights reserved.
2057
2498
.PP
2058
2499
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.
2059
2500
.PP