← Back to branch summary

~ubuntu-branches/ubuntu/natty/mysql-5.1/natty

« back to all changes in this revision

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

Tags: 5.1.54-1ubuntu1
https://launchpad.net/bugs/316974
https://launchpad.net/bugs/201799
https://launchpad.net/bugs/354188
https://launchpad.net/bugs/513135
https://launchpad.net/bugs/530752
https://launchpad.net/bugs/293258
https://launchpad.net/bugs/590952
https://launchpad.net/bugs/591875
https://launchpad.net/bugs/605021
* Synchronize from Debian Experimental:
* Merge from debian unstable:
  + debian/control:
     * Update maintainer according to spec.
     * Move section from "misc" to "database".
     * Added libmysqlclient16-dev an empty transitional package. 
     * Added mysql-client-core-5.1 package.
     * Suggest mailx for mysql-server-5.1
     * Add mysql-testsuite package so you can run the testsuite seperately.
  + debian/additions/my.cnf:
    * Remove language options. Error message files are located in a different directory in Mysql
      5.0. Setting the language option to use /usr/share/mysql/english breaks Mysql 5.0. Both 5.0
      and 5.1 use a different value that works. (LP: #316974)
  + 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/fore-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
  * Convert the package from sysvinit to upstart:
    + debian/mysql-server-5.1.mysql.upstart: Add upstart script.
    + debian/mysql-server-5.1.mysql.init: Dropped, unused now with upstart.
    + debian/additions/mysqld_safe_syslog.cnf: Dropped, unused now with upstart.
    + debian/additons/my.cnf: Remove pid declaration and setup error logging to /var/log/mysql since
      we're not piping anything around logger anymore.
    + debian/rules, debian/mysql-server-5.1.logcheck.ignore.{paranoid,worstation},
      debian/mysql-server-5.1.logcheck.ignore.server: : Remove references to mysqld_safe
    + debian/patches/38_scripts_mysqld_safe.sh_signals.dpatch: Dropped
  * Added -fno-strict-aliasing to CFLAGS to get around mysql testsuite build failures.
  * Add Apport hook (LP: #354188):
    + debian/mysql-server-5.1.py: apport package hook
    + debian/rules: Make it installable
  * debian/mysql-server-5.1.mysql-server.logrotate: Check to see if mysql is running before
    running logrotate. (LP: #513135)
  * Make the testsuite installable. (LP: #530752)
    + debian/mysql-server-5.1.files, debian/rules: install apport package hook
  * debian/mysql-server-5.1.preinst: Set mysql user's home directory
    to /nonexistent to protect against having the /var/lib/mysql
    user-writeable. If an attacker can trick mysqld into creating
    dot files in the home directory, he could do .rhost-like attacks
    on the system. (LP: #293258)
  * debian/control: mysql-client-5.1 should depend on mysql-core-client-5.1.
    (LP: #590952)
  * debian/mysql-server.5.1.postinst: Specify the mysql user when installing 
    the mysql databases. (LP: #591875)
  * Installing mysql_config_pic in /usr/bin so users of libmysqld-pic
    can extract the appropriate compile flags. (LP: #605021) 

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: 11/29/2010
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" "11/29/2010" "MySQL" "MySQL Database System"
11
11
.\" -----------------------------------------------------------------
12
12
.\" * set default formatting
13
13
.\" -----------------------------------------------------------------
229
229
instead, and may be referred to in tests\&.
230
230
.TS
231
231
allbox tab(:);
232
 
l l
 
232
lB lB.
 
233
T{
 
234
Variable
 
235
T}:T{
 
236
Meaning
 
237
T}
 
238
.T&
233
239
l l
234
240
l l
235
241
l l
242
248
l l
243
249
l l.
244
250
T{
245
 
\fBVariable\fR
246
 
T}:T{
247
 
\fBMeaning\fR
248
 
T}
249
 
T{
250
251
MTR_VERSION
251
252
T}:T{
252
253
If set to 1, will run the older version 1 of
816
817
[ fail ]
817
818
if they fail\&. This option was added in MySQL 5\&.1\&.33\&.
818
819
.sp
819
 
For an example of a file that might be specified via this option, see
 
820
For an example of a file that might be specified using this option, see
820
821
mysql\-test/collections/default\&.experimental\&.
 
822
.sp
 
823
From MySQL 5\&.1\&.51, it\'s possible to supply more than one
 
824
\fB\-\-experimental\fR, test cases listed in all the files will be treated as experimental\&.
821
825
.RE
822
826
.sp
823
827
.RS 4
899
903
.sp -1
900
904
.IP \(bu 2.3
901
905
.\}
 
906
.\" mysql-test-run.pl: force-restart option
 
907
.\" force-restart option: mysql-test-run.pl
 
908
\fB\-\-force\-restart\fR
 
909
.sp
 
910
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\&.
 
911
.sp
 
912
The
 
913
\fB\-\-force\-restart\fR
 
914
option was added in MySQL version 5\&.1\&.52\&.
 
915
.RE
 
916
.sp
 
917
.RS 4
 
918
.ie n \{\
 
919
\h'-04'\(bu\h'+03'\c
 
920
.\}
 
921
.el \{\
 
922
.sp -1
 
923
.IP \(bu 2.3
 
924
.\}
902
925
.\" mysql-test-run.pl: gcov option
903
926
.\" gcov option: mysql-test-run.pl
904
927
\fB\-\-gcov\fR
954
977
.sp -1
955
978
.IP \(bu 2.3
956
979
.\}
 
980
.\" mysql-test-run.pl: include-ndbcluster option
 
981
.\" include-ndbcluster option: mysql-test-run.pl
 
982
\fB\-\-include\-ndbcluster\fR,
 
983
.\" mysql-test-run.pl: include-ndb option
 
984
.\" include-ndb option: mysql-test-run.pl
 
985
\fB\-\-include\-ndb\fR
 
986
.sp
 
987
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\&.
 
988
.RE
 
989
.sp
 
990
.RS 4
 
991
.ie n \{\
 
992
\h'-04'\(bu\h'+03'\c
 
993
.\}
 
994
.el \{\
 
995
.sp -1
 
996
.IP \(bu 2.3
 
997
.\}
957
998
.\" mysql-test-run.pl: manual-ddd option
958
999
.\" manual-ddd option: mysql-test-run.pl
959
1000
\fB\-\-manual\-ddd\fR
1182
1223
.\" noreorder option: mysql-test-run.pl
1183
1224
\fB\-\-noreorder\fR
1184
1225
.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\&.
 
1226
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
1227
.RE
1187
1228
.sp
1188
1229
.RS 4
1453
1494
.\" skip-ndb option: mysql-test-run.pl
1454
1495
\fB\-\-skip\-ndb\fR
1455
1496
.sp
1456
 
Do not start NDB Cluster; skip Cluster test cases\&.
 
1497
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
1498
.RE
1458
1499
.sp
1459
1500
.RS 4
1611
1652
.sp -1
1612
1653
.IP \(bu 2.3
1613
1654
.\}
1614
 
.\" mysql-test-run.pl: start-and-exit option
1615
 
.\" start-and-exit option: mysql-test-run.pl
 
1655
.\" mysql-test-run.pl: start option
 
1656
.\" start option: mysql-test-run.pl
1616
1657
\fB\-\-start\fR
1617
1658
.sp
1618
1659
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
1688
.sp -1
1648
1689
.IP \(bu 2.3
1649
1690
.\}
 
1691
.\" mysql-test-run.pl: start-and-exit option
 
1692
.\" start-and-exit option: mysql-test-run.pl
 
1693
\fB\-\-start\-and\-exit\fR
 
1694
.sp
 
1695
This is similar to
 
1696
\fB\-\-start\fR, but
 
1697
\fBmysql\-test\-run\&.pl\fR
 
1698
terminates once the server has been started, leaving just the server process running\&.
 
1699
.sp
 
1700
Tha
 
1701
\fB\-\-start\-and\-exit\fR
 
1702
was available with version 1 of
 
1703
\fBmysql\-test\-run\&.pl\fR
 
1704
(unlike
 
1705
\fB\-\-start\fR
 
1706
which came with version 2), and is again supported in version 2 from MySQL 5\&.1\&.51\&.
 
1707
.RE
 
1708
.sp
 
1709
.RS 4
 
1710
.ie n \{\
 
1711
\h'-04'\(bu\h'+03'\c
 
1712
.\}
 
1713
.el \{\
 
1714
.sp -1
 
1715
.IP \(bu 2.3
 
1716
.\}
1650
1717
.\" mysql-test-run.pl: start-dirty option
1651
1718
.\" start-dirty option: mysql-test-run.pl
1652
1719
\fB\-\-start\-dirty\fR
1829
1896
.sp -1
1830
1897
.IP \(bu 2.3
1831
1898
.\}
 
1899
.\" mysql-test-run.pl: user-args option
 
1900
.\" user-args option: mysql-test-run.pl
 
1901
\fB\-\-user\-args\fR
 
1902
.sp
 
1903
Drops all non\-essential command line arguments to the
 
1904
\fBmysqld\fR
 
1905
server, except those supplied with
 
1906
\fB\-\-mysqld\fR
 
1907
arguemnts, if any\&. Only works in combination with
 
1908
\fB\-\-start\fR,
 
1909
\fB\-\-start\-and\-exit\fR
 
1910
or
 
1911
\fB\-\-start\-dirty\fR, and only if no test name is given\&.
 
1912
.sp
 
1913
The
 
1914
\fB\-\-user\-args\fR
 
1915
option was added in MySQL 5\&.1\&.51\&.
 
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
.\}
1832
1926
.\" mysql-test-run.pl: valgrind option
1833
1927
.\" valgrind option: mysql-test-run.pl
1834
1928
\fB\-\-valgrind\fR