Skip to content

M
MariaDB
Commit d923b924 authored by unknown's avatar unknown
Browse files
Options

Imported MySQL documentation files from ../mysql-5.1.46

parent 73b663c1
Hide whitespace changes
Inline Side-by-side
Showing with 1866 additions and 1636 deletions
Docs/INSTALL-BINARY
View file @ d923b924
...@@ -3,9 +3,7 @@ ...@@ -3,9 +3,7 @@
This section covers the installation of MySQL binary distributions This section covers the installation of MySQL binary distributions
that are provided for various platforms in the form of compressed that are provided for various platforms in the form of compressed
tar files (files with a .tar.gz extension). See Section 2.2, tar files (files with a .tar.gz extension).
"Installing MySQL from Generic Binaries on Unix/Linux," for a
detailed list.
To obtain MySQL, see Section 2.1.3, "How to Get MySQL." To obtain MySQL, see Section 2.1.3, "How to Get MySQL."
...@@ -23,7 +21,7 @@ ...@@ -23,7 +21,7 @@
MySQL tar file binary distributions have names of the form MySQL tar file binary distributions have names of the form
mysql-VERSION-OS.tar.gz, where VERSION is a number (for example, mysql-VERSION-OS.tar.gz, where VERSION is a number (for example,
5.1.41), and OS indicates the type of operating system for which 5.1.46), and OS indicates the type of operating system for which
the distribution is intended (for example, pc-linux-i686). the distribution is intended (for example, pc-linux-i686).
In addition to these generic packages, we also offer binaries in In addition to these generic packages, we also offer binaries in
...@@ -48,7 +46,7 @@ ...@@ -48,7 +46,7 @@
first. first.
If you run into problems and need to file a bug report, please use If you run into problems and need to file a bug report, please use
the instructions in Section 1.6, "How to Report Bugs or Problems." the instructions in Section 1.7, "How to Report Bugs or Problems."
The basic commands that you must execute to install and use a The basic commands that you must execute to install and use a
MySQL binary distribution are: MySQL binary distribution are:
......
INSTALL-SOURCE
View file @ d923b924
...@@ -17,8 +17,7 @@ Chapter 2. Installing and Upgrading MySQL ...@@ -17,8 +17,7 @@ Chapter 2. Installing and Upgrading MySQL
platform. platform.
Please note that not all platforms are equally suitable for Please note that not all platforms are equally suitable for
running MySQL, and that not all platforms on which MySQL is running MySQL, and that not all platforms on which MySQL is
known to run are officially supported by Sun Microsystems, known to run are officially supported by Oracle Corporation:
Inc.:
2. Choose which distribution to install. 2. Choose which distribution to install.
Several versions of MySQL are available, and most are Several versions of MySQL are available, and most are
...@@ -77,12 +76,11 @@ Chapter 2. Installing and Upgrading MySQL ...@@ -77,12 +76,11 @@ Chapter 2. Installing and Upgrading MySQL
Important Important
Sun Microsystems, Inc. does not necessarily provide official Oracle Corporation does not necessarily provide official support
support for all the platforms listed in this section. For for all the platforms listed in this section. For information
information about those platforms that are officially supported, about those platforms that are officially supported, see
see MySQL Server Supported Platforms http://www.mysql.com/support/supportedplatforms.html on the MySQL
(http://www.mysql.com/support/supportedplatforms.html) on the Web site.
MySQL Web site.
We use GNU Autoconf, so it is possible to port MySQL to all modern We use GNU Autoconf, so it is possible to port MySQL to all modern
systems that have a C++ compiler and a working implementation of systems that have a C++ compiler and a working implementation of
...@@ -148,7 +146,7 @@ Important ...@@ -148,7 +146,7 @@ Important
by the ability of the file system to deal with large files and by the ability of the file system to deal with large files and
dealing with them efficiently. dealing with them efficiently.
* Our level of expertise here at Sun Microsystems, Inc. with the * Our level of expertise here at Oracle Corporation with the
platform. If we know a platform well, we enable platform. If we know a platform well, we enable
platform-specific optimizations and fixes at compile time. We platform-specific optimizations and fixes at compile time. We
can also provide advice on configuring your system optimally can also provide advice on configuring your system optimally
...@@ -184,17 +182,16 @@ Important ...@@ -184,17 +182,16 @@ Important
new features are being added that could affect stability. new features are being added that could affect stability.
* MySQL 5.0 is the previous stable (production-quality) release * MySQL 5.0 is the previous stable (production-quality) release
series. series. MySQL 5.0 is now at the end of the product lifecycle.
Active development and support for this version has ended.
Extended support for MySQL 5.0 remains available. According to
the http://www.mysql.com/about/legal/lifecycle/, only Security
and Severity Level 1 issues are still being fixed for MySQL
5.0.
* MySQL 4.1, 4.0, and 3.23 are old stable (production-quality) * MySQL 4.1, 4.0, and 3.23 are old stable (production-quality)
release series. MySQL 4.1 is now at the end of the product release series. Active development and support for these
lifecycle. Active development and support for these versions versions has ended.
has ended.
Extended support for MySQL 4.1 remains available. According to
the MySQL Lifecycle Policy
(http://www.mysql.com/about/legal/lifecycle/), only Security
and Severity Level 1 issues are still being fixed for MySQL
4.1.
We do not believe in a complete code freeze because this prevents We do not believe in a complete code freeze because this prevents
us from making bugfixes and other fixes that must be done. By us from making bugfixes and other fixes that must be done. By
...@@ -228,7 +225,7 @@ Important ...@@ -228,7 +225,7 @@ Important
the code on which future releases are to be based. the code on which future releases are to be based.
The MySQL naming scheme uses release names that consist of three The MySQL naming scheme uses release names that consist of three
numbers and a suffix; for example, mysql-5.0.12-beta. The numbers numbers and a suffix; for example, mysql-5.0.14-rc. The numbers
within the release name are interpreted as follows: within the release name are interpreted as follows:
* The first number (5) is the major version and describes the * The first number (5) is the major version and describes the
...@@ -238,7 +235,7 @@ Important ...@@ -238,7 +235,7 @@ Important
the major version and release level constitute the release the major version and release level constitute the release
series number. series number.
* The third number (12) is the version number within the release * The third number (14) is the version number within the release
series. This is incremented for each new release. Usually you series. This is incremented for each new release. Usually you
want the latest version for the series you have chosen. want the latest version for the series you have chosen.
...@@ -307,11 +304,6 @@ Important ...@@ -307,11 +304,6 @@ Important
actually made the code faster. See Section 7.1.3, "The MySQL actually made the code faster. See Section 7.1.3, "The MySQL
Benchmark Suite." Benchmark Suite."
* The crash-me test
This test tries to determine what features the database
supports and what its capabilities and limitations are. See
Section 7.1.3, "The MySQL Benchmark Suite."
We also test the newest MySQL version in our internal production We also test the newest MySQL version in our internal production
environment, on at least one machine. We have more than 100GB of environment, on at least one machine. We have more than 100GB of
data to work with. data to work with.
...@@ -475,8 +467,8 @@ Important ...@@ -475,8 +467,8 @@ Important
shell> md5sum package_name shell> md5sum package_name
Example: Example:
shell> md5sum mysql-standard-5.1.41-linux-i686.tar.gz shell> md5sum mysql-standard-5.1.46-linux-i686.tar.gz
aaab65abbec64d5e907dcd41b8699945 mysql-standard-5.1.41-linux-i686.ta aaab65abbec64d5e907dcd41b8699945 mysql-standard-5.1.46-linux-i686.ta
r.gz r.gz
You should verify that the resulting checksum (the string of You should verify that the resulting checksum (the string of
...@@ -520,8 +512,7 @@ Note ...@@ -520,8 +512,7 @@ Note
named build@mysql.com. Alternatively, you can cut and paste the named build@mysql.com. Alternatively, you can cut and paste the
key directly from the following text: key directly from the following text:
-----BEGIN PGP PUBLIC KEY BLOCK----- -----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG v1.0.6 (GNU/Linux) Version: GnuPG v1.4.5 (GNU/Linux)
Comment: For info see http://www.gnupg.org
mQGiBD4+owwRBAC14GIfUfCyEDSIePvEW3SAFUdJBtoQHH/nJKZyQT7h9bPlUWC3 mQGiBD4+owwRBAC14GIfUfCyEDSIePvEW3SAFUdJBtoQHH/nJKZyQT7h9bPlUWC3
RODjQReyCITRrdwyrKUGku2FmeVGwn2u2WmDMNABLnpprWPkBdCk96+OmSLN9brZ RODjQReyCITRrdwyrKUGku2FmeVGwn2u2WmDMNABLnpprWPkBdCk96+OmSLN9brZ
...@@ -533,81 +524,26 @@ kYpXBACmWpP8NJTkamEnPCia2ZoOHODANwpUkP43I7jsDmgtobZX9qnrAXw+uNDI ...@@ -533,81 +524,26 @@ kYpXBACmWpP8NJTkamEnPCia2ZoOHODANwpUkP43I7jsDmgtobZX9qnrAXw+uNDI
QJEXM6FSbi0LLtZciNlYsafwAPEOMDKpMqAK6IyisNtPvaLd8lH0bPAnWqcyefep QJEXM6FSbi0LLtZciNlYsafwAPEOMDKpMqAK6IyisNtPvaLd8lH0bPAnWqcyefep
rv0sxxqUEMcM3o7wwgfN83POkDasDbs3pjwPhxvhz6//62zQJ7Q7TXlTUUwgUGFj rv0sxxqUEMcM3o7wwgfN83POkDasDbs3pjwPhxvhz6//62zQJ7Q7TXlTUUwgUGFj
a2FnZSBzaWduaW5nIGtleSAod3d3Lm15c3FsLmNvbSkgPGJ1aWxkQG15c3FsLmNv a2FnZSBzaWduaW5nIGtleSAod3d3Lm15c3FsLmNvbSkgPGJ1aWxkQG15c3FsLmNv
bT6IXQQTEQIAHQUCR6yUtAUJDTBYqAULBwoDBAMVAwIDFgIBAheAAAoJEIxxjTtQ bT6IXQQTEQIAHQULBwoDBAMVAwIDFgIBAheABQJLcC5lBQkQ8/JZAAoJEIxxjTtQ
cuH1rpIAn38+BlBI815Dou9VXMIAsQEk4G3tAJ9+Cz69Y/Xwm611lzteJrCAA32+ cuH1oD4AoIcOQ4EoGsZvy06D0Ei5vcsWEy8dAJ4g46i3WEcdSWxMhcBSsPz65sh5
aYhMBBMRAgAMBQI+PqPRBYMJZgC7AAoJEElQ4SqycpHyJOEAn1mxHijft00bKXvu lohMBBMRAgAMBQI+PqPRBYMJZgC7AAoJEElQ4SqycpHyJOEAn1mxHijft00bKXvu
cSo/pECUmppiAJ41M9MRVj5VcdH/KN/KjRtW6tHFPYhMBBMRAgAMBQI+QoIDBYMJ cSo/pECUmppiAJ41M9MRVj5VcdH/KN/KjRtW6tHFPYhMBBMRAgAMBQI+QoIDBYMJ
YiKJAAoJELb1zU3GuiQ/lpEAoIhpp6BozKI8p6eaabzF5MlJH58pAKCu/ROofK8J YiKJAAoJELb1zU3GuiQ/lpEAoIhpp6BozKI8p6eaabzF5MlJH58pAKCu/ROofK8J
Eg2aLos+5zEYrB/LsohGBBARAgAGBQI/rOOvAAoJEK/FI0h4g3QP9pYAoNtSISDD Eg2aLos+5zEYrB/LsrkCDQQ+PqMdEAgA7+GJfxbMdY4wslPnjH9rF4N2qfWsEN/l
AAU2HafyAYlLD/yUC4hKAJ0czMsBLbo0M/xPaJ6Ox9Q5Hmw2uIhGBBARAgAGBQI/ xaZoJYc3a6M02WCnHl6ahT2/tBK2w1QI4YFteR47gCvtgb6O1JHffOo2HfLmRDRi
tEN3AAoJEIWWr6swc05mxsMAnRag9X61Ygu1kbfBiqDku4czTd9pAJ4q5W8KZ0+2 Rjd1DTCHqeyX7CHhcghj/dNRlW2Z0l5QFEcmV9U0Vhp3aFfWC4Ujfs3LU+hkAWzE
ujTrEPN55NdWtnXj4YhGBBARAgAGBQJDW7PqAAoJEIvYLm8wuUtcf3QAnRCyqF0C 7zaD5cH9J7yv/6xuZVw411x0h4UqsTcWMu0iM1BzELqX1DY7LwoPEb/O9Rkbf4fm
pMCTdIGc7bDO5I7CIMhTAJ0UTGx0O1d/VwvdDiKWj45N2tNbYIhGBBMRAgAGBQJE Le11EzIaCa4PqARXQZc4dhSinMt6K3X4BrRsKTfozBu74F47D8Ilbf5vSYHbuE5p
8TMmAAoJEPZJxPRgk1MMCnEAoIm2pP0sIcVh9Yo0YYGAqORrTOL3AJwIbcy+e8HM /1oIDznkg/p8kW+3FxuWrycciqFTcNz215yyX39LXFnlLzKUb/F5GwADBQf+Lwqq
NSoNV5u51RnrVKie34hMBBARAgAMBQJBgcsBBYMGItmLAAoJEBhZ0B9ne6HsQo0A a8CGrRfsOAJxim63CHfty5mUc5rUSnTslGYEIOCR1BeQauyPZbPDsDD9MZ1ZaSaf
nA/LCTQ3P5kvJvDhg1DsfVTFnJxpAJ49WFjg/kIcaN5iP1JfaBAITZI3H4hMBBAR anFvwFG6Llx9xkU7tzq+vKLoWkm4u5xf3vn55VjnSd1aQ9eQnUcXiL4cnBGoTbOW
AgAMBQJBgcs0BYMGItlYAAoJEIHC9+viE7aSIiMAnRVTVVAfMXvJhV6D5uHfWeeD I39EcyzgslzBdC++MPjcQTcA7p6JUVsP6oAB3FQWg54tuUo0Ec8bsM8b3Ev42Lmu
046TAJ4kjwP2bHyd6DjCymq+BdEDz63axohMBBARAgAMBQJBgctiBYMGItkqAAoJ QT5NdKHGwHsXTPtl0klk4bQk4OajHsiy1BMahpT27jWjJlMiJc+IWJ0mghkKHt92
EGtw7Nldw/RzCaoAmwWM6+Rj1zl4D/PIys5nW48Hql3hAJ0bLOBthv96g+7oUy9U 6s/ymfdf5HkdQ1cyvsz5tryVI3Fx78XeSYfQvuuwqp2H139pXGEkg0n6KdUOetdZ
j09Uh41lF4hMBBARAgAMBQJB0JMkBYMF1BFoAAoJEH0lygrBKafCYlUAoIb1r5D6 Whe70YGNPw1yjWJT1IhMBBgRAgAMBQI+PqMdBQkJZgGAAAoJEIxxjTtQcuH17p4A
qMLMPMO1krHk3MNbX5b5AJ4vryx5fw6iJctC5GWJ+Y8ytXab34hMBBARAgAMBQJC n3r1QpVC9yhnW2cSAjq+kr72GX0eAJ4295kl6NxYEuFApmr1+0uUq/SlsQ==
K1u6BYMFeUjSAAoJEOYbpIkV67mr8xMAoJMy+UJC0sqXMPSxh3BUsdcmtFS+AJ9+ =Mski
Z15LpoOnAidTT/K9iODXGViK6ohMBBIRAgAMBQJAKlk6BYMHektSAAoJEDyhHzSU
+vhhJlwAnA/gOdwOThjO8O+dFtdbpKuImfXJAJ0TL53QKp92EzscZSz49lD2YkoE
qohMBBIRAgAMBQJAPfq6BYMHZqnSAAoJEPLXXGPjnGWcst8AoLQ3MJWqttMNHDbl
xSyzXhFGhRU8AJ4ukRzfNJqElQHQ00ZM2WnCVNzOUIhMBBIRAgAMBQJBDgqEBYMG
lpoIAAoJEDnKK/Q9aopf/N0AniE2fcCKO1wDIwusuGVlC+JvnnWbAKDDoUSEYuNn
5qzRbrzWW5zBno/Nb4hMBBIRAgAMBQJCgKU0BYMFI/9YAAoJEAQNwIV8g5+o4yQA
nA9QOFLV5POCddyUMqB/fnctuO9eAJ4sJbLKP/Z3SAiTpKrNo+XZRxauqIhMBBMR
AgAMBQI+TU2EBYMJV1cIAAoJEC27dr+t1MkzBQwAoJU+RuTVSn+TI+uWxUpT82/d
s5NkAJ9bnNodffyMMK7GyMiv/TzifiTD+4hMBBMRAgAMBQJB14B2BYMFzSQWAAoJ
EGbv28jNgv0+P7wAn13uu8YkhwfNMJJhWdpK2/qM/4AQAJ40drnKW2qJ5EEIJwtx
pwapgrzWiYhMBBMRAgAMBQJCGIEOBYMFjCN+AAoJEHbBAxyiMW6hoO4An0Ith3Kx
5/sixbjZR9aEjoePGTNKAJ94SldLiESaYaJx2lGIlD9bbVoHQYhdBBMRAgAdBQJH
rJTPBQkNMFioBQsHCgMEAxUDAgMWAgECF4AACgkQjHGNO1By4fV0KgCgsLpG2wP0
rc3s07Fync9g7MfairMAoIUefSNKrGTsTxvLeyH4DLzJW/QFiHsEMBECADsFAkJ3
NfU0HQBPb3BzLi4uIHNob3VsZCBoYXZlIGJlZW4gbG9jYWwhIEknbSAqc28qIHN0
dXBpZC4uLgAKCRA5yiv0PWqKX+9HAJ0WjTx/rqgouK4QCrOV/2IOU+jMQQCfYSC8
JgsIIeN8aiyuStTdYrk0VWCIjwQwEQIATwUCRW8Av0gdAFNob3VsZCBoYXZlIGJl
ZW4gYSBsb2NhbCBzaWduYXR1cmUsIG9yIHNvbWV0aGluZyAtIFdURiB3YXMgSSB0
aGlua2luZz8ACgkQOcor9D1qil+g+wCfcFWoo5qUl4XTE9K8tH3Q+xGWeYYAnjii
KxjtOXc0ls+BlqXxbfZ9uqBsiQIiBBABAgAMBQJBgcuFBYMGItkHAAoJEKrj5s5m
oURoqC8QAIISudocbJRhrTAROOPoMsReyp46Jdp3iL1oFDGcPfkZSBwWh8L+cJjh
dycIwwSeZ1D2h9S5Tc4EnoE0khsS6wBpuAuih5s//coRqIIiLKEdhTmNqulkCH5m
imCzc5zXWZDW0hpLr2InGsZMuh2QCwAkB4RTBM+r18cUXMLV4YHKyjIVaDhsiPP/
MKUj6rJNsUDmDq1GiJdOjySjtCFjYADlQYSD7zcd1vpqQLThnZBESvEoCqumEfOP
xemNU6xAB0CL+pUpB40pE6Un6Krr5h6yZxYZ/N5vzt0Y3B5UUMkgYDSpjbulNvaU
TFiOxEU3gJvXc1+h0BsxM7FwBZnuMA8LEA+UdQb76YcyuFBcROhmcEUTiducLu84
E2BZ2NSBdymRQKSinhvXsEWlH6Txm1gtJLynYsvPi4B4JxKbb+awnFPusL8W+gfz
jbygeKdyqzYgKj3M79R3geaY7Q75Kxl1UogiOKcbI5VZvg47OQCWeeERnejqEAdx
EQiwGA/ARhVOP/1l0LQA7jg2P1xTtrBqqC2ufDB+v+jhXaCXxstKSW1lTbv/b0d6
454UaOUV7RisN39pE2zFvJvY7bwfiwbUJVmYLm4rWJAEOJLIDtDRtt2h8JahDObm
3CWkpadjw57S5v1c/mn+xV9yTgVx5YUfC/788L1HNKXfeVDq8zbAiQIiBBMBAgAM
BQJCnwocBYMFBZpwAAoJENjCCglaJFfPIT4P/25zvPp8ixqV85igs3rRqMBtBsj+
5EoEW6DJnlGhoi26yf1nasC2frVasWG7i4JIm0U3WfLZERGDjR/nqlOCEqsP5gS3
43N7r4UpDkBsYh0WxH/ZtST5llFK3zd7XgtxvqKL98l/OSgijH2W2SJ9DGpjtO+T
iegq7igtJzw7Vax9z/LQH2xhRQKZR9yernwMSYaJ72i9SyWbK3k0+e95fGnlR5pF
zlGq320rYHgD7v9yoQ2t1klsAxK6e3b7Z+RiJG6cAU8o8F0kGxjWzF4v8D1op7S+
IoRdB0Bap01ko0KLyt3+g4/33/2UxsW50BtfqcvYNJvU4bZns1YSqAgDOOanBhg8
Ip5XPlDxH6J/3997n5JNj/nk5ojfd8nYfe/5TjflWNiput6tZ7frEki1wl6pTNbv
V9C1eLUJMSXfDZyHtUXmiP9DKNpsucCUeBKWRKLqnsHLkLYydsIeUJ8+ciKc+EWh
FxEY+Ml72cXAaz5BuW9L8KHNzZZfez/ZJabiARQpFfjOwAnmhzJ9r++TEKRLEr96
taUI9/8nVPvT6LnBpcM38Td6dJ639YvuH3ilAqmPPw50YvglIEe4BUYD5r52Seqc
8XQowouGOuBX4vs7zgWFuYA/s9ebfGaIw+uJd/56Xl9ll6q5CghqB/yt1EceFEnF
CAjQc2SeRo6qzx22uQINBD4+ox0QCADv4Yl/Fsx1jjCyU+eMf2sXg3ap9awQ3+XF
pmglhzdrozTZYKceXpqFPb+0ErbDVAjhgW15HjuAK+2Bvo7Ukd986jYd8uZENGJG
N3UNMIep7JfsIeFyCGP901GVbZnSXlAURyZX1TRWGndoV9YLhSN+zctT6GQBbMTv
NoPlwf0nvK//rG5lXDjXXHSHhSqxNxYy7SIzUHMQupfUNjsvCg8Rv871GRt/h+Yt
7XUTMhoJrg+oBFdBlzh2FKKcy3ordfgGtGwpN+jMG7vgXjsPwiVt/m9Jgdu4Tmn/
WggPOeSD+nyRb7cXG5avJxyKoVNw3PbXnLJff0tcWeUvMpRv8XkbAAMFB/4vCqpr
wIatF+w4AnGKbrcId+3LmZRzmtRKdOyUZgQg4JHUF5Bq7I9ls8OwMP0xnVlpJp9q
cW/AUbouXH3GRTu3Or68ouhaSbi7nF/e+fnlWOdJ3VpD15CdRxeIvhycEahNs5Yj
f0RzLOCyXMF0L74w+NxBNwDunolRWw/qgAHcVBaDni25SjQRzxuwzxvcS/jYua5B
Pk10ocbAexdM+2XSSWThtCTg5qMeyLLUExqGlPbuNaMmUyIlz4hYnSaCGQoe33bq
z/KZ91/keR1DVzK+zPm2vJUjcXHvxd5Jh9C+67CqnYfXf2lcYSSDSfop1Q5611la
F7vRgY0/DXKNYlPUiEwEGBECAAwFAkeslPwFCQ0wWN8ACgkQjHGNO1By4fWlzgCf
Qj3rkfcljYZOuLOn50J7PFuF7FoAnjwWGhwVi9+Fm2B5RZvpo++BBkdP
=Xquv
-----END PGP PUBLIC KEY BLOCK----- -----END PGP PUBLIC KEY BLOCK-----
To import the build key into your personal public GPG keyring, use To import the build key into your personal public GPG keyring, use
...@@ -650,8 +586,8 @@ pg-signature.html ...@@ -650,8 +586,8 @@ pg-signature.html
signature, which also is available from the download page. The signature, which also is available from the download page. The
signature file has the same name as the distribution file with an signature file has the same name as the distribution file with an
.asc extension, as shown by the examples in the following table. .asc extension, as shown by the examples in the following table.
Distribution file mysql-standard-5.1.41-linux-i686.tar.gz Distribution file mysql-standard-5.1.46-linux-i686.tar.gz
Signature file mysql-standard-5.1.41-linux-i686.tar.gz.asc Signature file mysql-standard-5.1.46-linux-i686.tar.gz.asc
Make sure that both files are stored in the same directory and Make sure that both files are stored in the same directory and
then run the following command to verify the signature for the then run the following command to verify the signature for the
...@@ -659,7 +595,7 @@ pg-signature.html ...@@ -659,7 +595,7 @@ pg-signature.html
shell> gpg --verify package_name.asc shell> gpg --verify package_name.asc
Example: Example:
shell> gpg --verify mysql-standard-5.1.41-linux-i686.tar.gz.asc shell> gpg --verify mysql-standard-5.1.46-linux-i686.tar.gz.asc
gpg: Signature made Tue 12 Jul 2005 23:35:41 EST using DSA key ID 507 gpg: Signature made Tue 12 Jul 2005 23:35:41 EST using DSA key ID 507
2E1F5 2E1F5
gpg: Good signature from "MySQL Package signing key (www.mysql.com) < gpg: Good signature from "MySQL Package signing key (www.mysql.com) <
...@@ -679,8 +615,8 @@ build@mysql.com>" ...@@ -679,8 +615,8 @@ build@mysql.com>"
shell> rpm --checksig package_name.rpm shell> rpm --checksig package_name.rpm
Example: Example:
shell> rpm --checksig MySQL-server-5.1.41-0.glibc23.i386.rpm shell> rpm --checksig MySQL-server-5.1.46-0.glibc23.i386.rpm
MySQL-server-5.1.41-0.glibc23.i386.rpm: md5 gpg OK MySQL-server-5.1.46-0.glibc23.i386.rpm: md5 gpg OK
Note Note
...@@ -705,7 +641,7 @@ shell> rpm --import mysql_pubkey.asc ...@@ -705,7 +641,7 @@ shell> rpm --import mysql_pubkey.asc
This section describes the default layout of the directories This section describes the default layout of the directories
created by installing binary or source distributions provided by created by installing binary or source distributions provided by
Sun Microsystems, Inc. A distribution provided by another vendor Oracle Corporation. A distribution provided by another vendor
might use a layout different from those shown here. might use a layout different from those shown here.
Installations created from our Linux RPM distributions result in Installations created from our Linux RPM distributions result in
...@@ -773,9 +709,7 @@ shell> rpm --import mysql_pubkey.asc ...@@ -773,9 +709,7 @@ shell> rpm --import mysql_pubkey.asc
This section covers the installation of MySQL binary distributions This section covers the installation of MySQL binary distributions
that are provided for various platforms in the form of compressed that are provided for various platforms in the form of compressed
tar files (files with a .tar.gz extension). See Section 2.2, tar files (files with a .tar.gz extension).
"Installing MySQL from Generic Binaries on Unix/Linux," for a
detailed list.
To obtain MySQL, see Section 2.1.3, "How to Get MySQL." To obtain MySQL, see Section 2.1.3, "How to Get MySQL."
...@@ -793,7 +727,7 @@ shell> rpm --import mysql_pubkey.asc ...@@ -793,7 +727,7 @@ shell> rpm --import mysql_pubkey.asc
MySQL tar file binary distributions have names of the form MySQL tar file binary distributions have names of the form
mysql-VERSION-OS.tar.gz, where VERSION is a number (for example, mysql-VERSION-OS.tar.gz, where VERSION is a number (for example,
5.1.41), and OS indicates the type of operating system for which 5.1.46), and OS indicates the type of operating system for which
the distribution is intended (for example, pc-linux-i686). the distribution is intended (for example, pc-linux-i686).
In addition to these generic packages, we also offer binaries in In addition to these generic packages, we also offer binaries in
...@@ -818,7 +752,7 @@ shell> rpm --import mysql_pubkey.asc ...@@ -818,7 +752,7 @@ shell> rpm --import mysql_pubkey.asc
first. first.
If you run into problems and need to file a bug report, please use If you run into problems and need to file a bug report, please use
the instructions in Section 1.6, "How to Report Bugs or Problems." the instructions in Section 1.7, "How to Report Bugs or Problems."
The basic commands that you must execute to install and use a The basic commands that you must execute to install and use a
MySQL binary distribution are: MySQL binary distribution are:
...@@ -987,7 +921,7 @@ Note ...@@ -987,7 +921,7 @@ Note
MySQL source distributions are provided as compressed tar archives MySQL source distributions are provided as compressed tar archives
and have names of the form mysql-VERSION.tar.gz, where VERSION is and have names of the form mysql-VERSION.tar.gz, where VERSION is
a number like 5.1.41. a number like 5.1.46.
You need the following tools to build and install MySQL from You need the following tools to build and install MySQL from
source: source:
...@@ -1005,15 +939,9 @@ Note ...@@ -1005,15 +939,9 @@ Note
systems with a deficient tar, you should install GNU tar systems with a deficient tar, you should install GNU tar
first. first.
* A working ANSI C++ compiler. gcc 2.95.2 or later, SGI C++, and * A working ANSI C++ compiler. GCC 3.2 or later, Sun Studio 10
SunPro C++ are some of the compilers that are known to work. or later, Visual Studio 2005 or later, and many current
libg++ is not needed when using gcc. gcc 2.7.x has a bug that vendor-supplied compilers are known to work.
makes it impossible to compile some perfectly legal C++ files,
such as sql/sql_base.cc. If you have only gcc 2.7.x, you must
upgrade your gcc to be able to compile MySQL. gcc 2.8.1 is
also known to have problems on some platforms, so it should be
avoided if a newer compiler exists for the platform. gcc
2.95.2 or later is recommended.
* A good make program. GNU make is always recommended and is * A good make program. GNU make is always recommended and is
sometimes required. (BSD make fails, and vendor-provided make sometimes required. (BSD make fails, and vendor-provided make
...@@ -1035,7 +963,7 @@ CFLAGS="-O3" CXX=gcc CXXFLAGS="-O3 -felide-constructors \ ...@@ -1035,7 +963,7 @@ CFLAGS="-O3" CXX=gcc CXXFLAGS="-O3 -felide-constructors \
On most systems, this gives you a fast and stable binary. On most systems, this gives you a fast and stable binary.
If you run into problems and need to file a bug report, please use If you run into problems and need to file a bug report, please use
the instructions in Section 1.6, "How to Report Bugs or Problems." the instructions in Section 1.7, "How to Report Bugs or Problems."
2.3.1. Source Installation Overview 2.3.1. Source Installation Overview
...@@ -1121,7 +1049,7 @@ shell> make ...@@ -1121,7 +1049,7 @@ shell> make
from config.log that you think can help solve the problem. from config.log that you think can help solve the problem.
Also include the last couple of lines of output from Also include the last couple of lines of output from
configure. To file a bug report, please use the instructions configure. To file a bug report, please use the instructions
in Section 1.6, "How to Report Bugs or Problems." in Section 1.7, "How to Report Bugs or Problems."
If the compile fails, see Section 2.3.4, "Dealing with If the compile fails, see Section 2.3.4, "Dealing with
Problems Compiling MySQL," for help. Problems Compiling MySQL," for help.
...@@ -1497,10 +1425,9 @@ shell> ./configure --with-charset=CHARSET ...@@ -1497,10 +1425,9 @@ shell> ./configure --with-charset=CHARSET
cp1251, cp1256, cp1257, cp850, cp852, cp866, cp932, dec8, cp1251, cp1256, cp1257, cp850, cp852, cp866, cp932, dec8,
eucjpms, euckr, gb2312, gbk, geostd8, greek, hebrew, hp8, eucjpms, euckr, gb2312, gbk, geostd8, greek, hebrew, hp8,
keybcs2, koi8r, koi8u, latin1, latin2, latin5, latin7, macce, keybcs2, koi8r, koi8u, latin1, latin2, latin5, latin7, macce,
macroman, sjis, swe7, tis620, ucs2, ujis, utf8. See Section macroman, sjis, swe7, tis620, ucs2, ujis, utf8. (Additional
9.2, "The Character Set Used for Data and Sorting." character sets might be available. Check the output from
(Additional character sets might be available. Check the ./configure --help for the current list.)
output from ./configure --help for the current list.)
The default collation may also be specified. MySQL uses the The default collation may also be specified. MySQL uses the
latin1_swedish_ci collation by default. To change this, use latin1_swedish_ci collation by default. To change this, use
the --with-collation option: the --with-collation option:
...@@ -1602,7 +1529,7 @@ shell> ./configure --with-debug ...@@ -1602,7 +1529,7 @@ shell> ./configure --with-debug
* When given with --enable-community-features, the * When given with --enable-community-features, the
--enable-profiling option enables the statement profiling --enable-profiling option enables the statement profiling
capability exposed by the SHOW PROFILE and SHOW PROFILES capability exposed by the SHOW PROFILE and SHOW PROFILES
statements. (See Section 12.5.5.33, "SHOW PROFILES Syntax.") statements. (See Section 12.4.5.33, "SHOW PROFILES Syntax.")
This option was added in MySQL 5.1.24. It is enabled by This option was added in MySQL 5.1.24. It is enabled by
default as of MySQL 5.1.28; to disable it, use default as of MySQL 5.1.28; to disable it, use
--disable-profiling. --disable-profiling.
...@@ -1610,7 +1537,7 @@ shell> ./configure --with-debug ...@@ -1610,7 +1537,7 @@ shell> ./configure --with-debug
* See Section 2.1, "General Installation Guidance," for options * See Section 2.1, "General Installation Guidance," for options
that pertain to particular operating systems. that pertain to particular operating systems.
* See Section 5.5.7.2, "Using SSL Connections," for options that * See Section 5.5.6.2, "Using SSL Connections," for options that
pertain to configuring MySQL to support secure (encrypted) pertain to configuring MySQL to support secure (encrypted)
connections. connections.
...@@ -1664,12 +1591,12 @@ Caution ...@@ -1664,12 +1591,12 @@ Caution
(either a binary or source distribution). (either a binary or source distribution).
To obtain the most recent development source tree, you must have To obtain the most recent development source tree, you must have
Bazaar installed. You can obtain Bazaar from the Bazaar VCS Bazaar installed. You can obtain Bazaar from the Bazaar VCS Web
Website (http://bazaar-vcs.org). Bazaar is supported by any site (http://bazaar-vcs.org). Bazaar is supported by any platform
platform that supports Python, and is therefore compatible with that supports Python, and is therefore compatible with any Linux,
any Linux, Unix, Windows or Mac OS X host. Instructions for Unix, Windows or Mac OS X host. Instructions for downloading and
downloading and installing Bazaar on the different platforms are installing Bazaar on the different platforms are available on the
available on the Bazaar website. Bazaar Web site.
All MySQL projects are hosted on Launchpad All MySQL projects are hosted on Launchpad
(http://launchpad.net/). MySQL projects, including MySQL server, (http://launchpad.net/). MySQL projects, including MySQL server,
...@@ -1752,7 +1679,7 @@ shell> bzr log ...@@ -1752,7 +1679,7 @@ shell> bzr log
page. page.
If you see diffs (changes) or code that you have a question If you see diffs (changes) or code that you have a question
about, do not hesitate to send email to the MySQL internals about, do not hesitate to send email to the MySQL internals
mailing list. See Section 1.5.1, "MySQL Mailing Lists." Also, mailing list. See Section 1.6.1, "MySQL Mailing Lists." Also,
if you think you have a better idea on how to do something, if you think you have a better idea on how to do something,
send an email message to the list with a patch. send an email message to the list with a patch.
...@@ -1816,7 +1743,7 @@ shell> make ...@@ -1816,7 +1743,7 @@ shell> make
6. If you have gotten to the make stage, but the distribution 6. If you have gotten to the make stage, but the distribution
does not compile, please enter the problem into our bugs does not compile, please enter the problem into our bugs
database using the instructions given in Section 1.6, "How to database using the instructions given in Section 1.7, "How to
Report Bugs or Problems." If you have installed the latest Report Bugs or Problems." If you have installed the latest
versions of the required GNU tools, and they crash trying to versions of the required GNU tools, and they crash trying to
process our configuration files, please report that also. process our configuration files, please report that also.
...@@ -2092,7 +2019,7 @@ implicit declaration of function `int strtoul(...)' ...@@ -2092,7 +2019,7 @@ implicit declaration of function `int strtoul(...)'
* Before any upgrade, back up your databases, including the * Before any upgrade, back up your databases, including the
mysql database that contains the grant tables. See Section mysql database that contains the grant tables. See Section
6.1, "Database Backup Methods." 6.2, "Database Backup Methods."
* Read all the notes in Section 2.4.1.1, "Upgrading from MySQL * Read all the notes in Section 2.4.1.1, "Upgrading from MySQL
5.0 to 5.1." These notes enable you to identify upgrade issues 5.0 to 5.1." These notes enable you to identify upgrade issues
...@@ -2117,7 +2044,7 @@ implicit declaration of function `int strtoul(...)' ...@@ -2117,7 +2044,7 @@ implicit declaration of function `int strtoul(...)'
* If you are running MySQL Server on Windows, see Section 2.5.7, * If you are running MySQL Server on Windows, see Section 2.5.7,
"Upgrading MySQL on Windows." "Upgrading MySQL on Windows."
* If you are using replication, see Section 16.3.3, "Upgrading a * If you are using replication, see Section 16.4.3, "Upgrading a
Replication Setup," for information on upgrading your Replication Setup," for information on upgrading your
replication setup. replication setup.
...@@ -2251,7 +2178,7 @@ Note ...@@ -2251,7 +2178,7 @@ Note
done before upgrading. Use of this statement with a version of done before upgrading. Use of this statement with a version of
MySQL different from the one used to create the table (that MySQL different from the one used to create the table (that
is, using it after upgrading) may damage the table. See is, using it after upgrading) may damage the table. See
Section 12.5.2.6, "REPAIR TABLE Syntax." Section 12.4.2.6, "REPAIR TABLE Syntax."
* After you upgrade to a new version of MySQL, run mysql_upgrade * After you upgrade to a new version of MySQL, run mysql_upgrade
(see Section 4.4.8, "mysql_upgrade --- Check Tables for MySQL (see Section 4.4.8, "mysql_upgrade --- Check Tables for MySQL
...@@ -2274,7 +2201,7 @@ Note ...@@ -2274,7 +2201,7 @@ Note
* If you are running MySQL Server on Windows, see Section 2.5.7, * If you are running MySQL Server on Windows, see Section 2.5.7,
"Upgrading MySQL on Windows." "Upgrading MySQL on Windows."
* If you are using replication, see Section 16.3.3, "Upgrading a * If you are using replication, see Section 16.4.3, "Upgrading a
Replication Setup," for information on upgrading your Replication Setup," for information on upgrading your
replication setup. replication setup.
...@@ -2322,13 +2249,13 @@ Note ...@@ -2322,13 +2249,13 @@ Note
upgrading, and reload them into MySQL 5.1 after upgrading. upgrading, and reload them into MySQL 5.1 after upgrading.
* Known issue: The fix for * Known issue: The fix for
Bug#23491: http://bugs.mysql.com/23491 introduced a problem Bug#23491: http://bugs.mysql.com/bug.php?id=23491 introduced a
with SHOW CREATE VIEW, which is used by mysqldump. This causes problem with SHOW CREATE VIEW, which is used by mysqldump.
an incompatibility when upgrading from versions affected by This causes an incompatibility when upgrading from versions
that bug fix (MySQL 5.0.40 through 5.0.43, MySQL 5.1.18 affected by that bug fix (MySQL 5.0.40 through 5.0.43, MySQL
through 5.1.19): If you use mysqldump before upgrading from an 5.1.18 through 5.1.19): If you use mysqldump before upgrading
affected version and reload the data after upgrading to a from an affected version and reload the data after upgrading
higher version, you must drop and recreate your views. to a higher version, you must drop and recreate your views.
* Known issue: Dumps performed by using mysqldump to generate a * Known issue: Dumps performed by using mysqldump to generate a
dump file before the upgrade and reloading the file after dump file before the upgrade and reloading the file after
...@@ -2456,11 +2383,11 @@ RENAME TABLE table_b TO `table b`; ...@@ -2456,11 +2383,11 @@ RENAME TABLE table_b TO `table b`;
* Incompatible change: MySQL 5.1 implements support for a plugin * Incompatible change: MySQL 5.1 implements support for a plugin
API that allows the loading and unloading of components at API that allows the loading and unloading of components at
runtime, without restarting the server. Section 22.2, "The runtime, without restarting the server. Section 22.2, "The
MySQL Plugin Interface." The plugin API requires the MySQL Plugin API." The plugin API requires the mysql.plugin
mysql.plugin table. After upgrading from an older version of table. After upgrading from an older version of MySQL, you
MySQL, you should run the mysql_upgrade command to create this should run the mysql_upgrade command to create this table. See
table. See Section 4.4.8, "mysql_upgrade --- Check Tables for Section 4.4.8, "mysql_upgrade --- Check Tables for MySQL
MySQL Upgrade." Upgrade."
Plugins are installed in the directory named by the plugin_dir Plugins are installed in the directory named by the plugin_dir
system variable. This variable also controls the location from system variable. This variable also controls the location from
which the server loads user-defined functions (UDFs), which is which the server loads user-defined functions (UDFs), which is
...@@ -2718,7 +2645,7 @@ REPAIR TABLE tbl_name QUICK; ...@@ -2718,7 +2645,7 @@ REPAIR TABLE tbl_name QUICK;
specifies the locale that controls the language used to specifies the locale that controls the language used to
display day and month names and abbreviations. This variable display day and month names and abbreviations. This variable
affects the output from the DATE_FORMAT(), DAYNAME() and affects the output from the DATE_FORMAT(), DAYNAME() and
MONTHNAME() functions. See Section 9.8, "MySQL Server Locale MONTHNAME() functions. See Section 9.7, "MySQL Server Locale
Support." Support."
* As of MySQL 5.1.9, mysqld_safe no longer implicitly invokes * As of MySQL 5.1.9, mysqld_safe no longer implicitly invokes
...@@ -2749,7 +2676,7 @@ REPAIR TABLE tbl_name QUICK; ...@@ -2749,7 +2676,7 @@ REPAIR TABLE tbl_name QUICK;
to reload them into an upgraded server. Handlers that contain to reload them into an upgraded server. Handlers that contain
illegal label references will be rejected. illegal label references will be rejected.
For more information about condition handlers and writing them For more information about condition handlers and writing them
to avoid invalid jumps, see Section 12.8.4.2, "DECLARE for to avoid invalid jumps, see Section 12.7.4.2, "DECLARE for
Handlers." Handlers."
* Incompatible change: The parser accepted statements that * Incompatible change: The parser accepted statements that
...@@ -2758,13 +2685,13 @@ REPAIR TABLE tbl_name QUICK; ...@@ -2758,13 +2685,13 @@ REPAIR TABLE tbl_name QUICK;
contain unclosed /*-comments now are rejected with a syntax contain unclosed /*-comments now are rejected with a syntax
error. error.
This fix has the potential to cause incompatibilities. Because This fix has the potential to cause incompatibilities. Because
of Bug#26302: http://bugs.mysql.com/26302, which caused the of Bug#26302: http://bugs.mysql.com/bug.php?id=26302, which
trailing */ to be truncated from comments in views, stored caused the trailing */ to be truncated from comments in views,
routines, triggers, and events, it is possible that objects of stored routines, triggers, and events, it is possible that
those types may have been stored with definitions that now objects of those types may have been stored with definitions
will be rejected as syntactically invalid. Such objects should that now will be rejected as syntactically invalid. Such
be dropped and re-created so that their definitions do not objects should be dropped and re-created so that their
contain truncated comments. definitions do not contain truncated comments.
* Incompatible change: Multiple-table DELETE statements * Incompatible change: Multiple-table DELETE statements
containing ambiguous aliases could have unintended side containing ambiguous aliases could have unintended side
...@@ -2851,21 +2778,20 @@ mysql> source /tmp/triggers.sql // ...@@ -2851,21 +2778,20 @@ mysql> source /tmp/triggers.sql //
mysqldump or mysqlhotcopy can be used as alternatives. mysqldump or mysqlhotcopy can be used as alternatives.
* The LOAD DATA FROM MASTER and LOAD TABLE FROM MASTER * The LOAD DATA FROM MASTER and LOAD TABLE FROM MASTER
statements are deprecated. See Section 12.6.2.2, "LOAD DATA statements are deprecated. See Section 12.5.2.2, "LOAD DATA
FROM MASTER Syntax," for recommended alternatives. FROM MASTER Syntax," for recommended alternatives.
* The INSTALL PLUGIN and UNINSTALL PLUGIN statements that are * The INSTALL PLUGIN and UNINSTALL PLUGIN statements that are
used for the plugin API are new. So is the WITH PARSER clause used for the plugin API are new. So is the WITH PARSER clause
for FULLTEXT index creation that associates a parser plugin for FULLTEXT index creation that associates a parser plugin
with a full-text index. Section 22.2, "The MySQL Plugin with a full-text index. Section 22.2, "The MySQL Plugin API."
Interface."
C API Changes: C API Changes:
* Incompatible change: As of MySQL 5.1.7, the * Incompatible change: As of MySQL 5.1.7, the
mysql_stmt_attr_get() C API function returns a boolean rather mysql_stmt_attr_get() C API function returns a boolean rather
than an unsigned int for STMT_ATTR_UPDATE_MAX_LENGTH. than an unsigned int for STMT_ATTR_UPDATE_MAX_LENGTH.
(Bug#16144: http://bugs.mysql.com/16144) (Bug#16144: http://bugs.mysql.com/bug.php?id=16144)
2.4.2. Downgrading MySQL 2.4.2. Downgrading MySQL
...@@ -2930,10 +2856,10 @@ mysql> source /tmp/triggers.sql // ...@@ -2930,10 +2856,10 @@ mysql> source /tmp/triggers.sql //
5. Reload the dump file into the older server. Your tables should 5. Reload the dump file into the older server. Your tables should
be accessible. be accessible.
It might also be the case that the structure of the system tables It might also be the case that system tables in the mysql database
in the mysql database has changed and that downgrading introduces have changed and that downgrading introduces some loss of
some loss of functionality or requires some adjustments. Here are functionality or requires some adjustments. Here are some
some examples: examples:
* Trigger creation requires the TRIGGER privilege as of MySQL * Trigger creation requires the TRIGGER privilege as of MySQL
5.1. In MySQL 5.0, there is no TRIGGER privilege and SUPER is 5.1. In MySQL 5.0, there is no TRIGGER privilege and SUPER is
...@@ -2944,6 +2870,12 @@ mysql> source /tmp/triggers.sql // ...@@ -2944,6 +2870,12 @@ mysql> source /tmp/triggers.sql //
* Triggers were added in MySQL 5.0, so if you downgrade from 5.0 * Triggers were added in MySQL 5.0, so if you downgrade from 5.0
to 4.1, you cannot use triggers at all. to 4.1, you cannot use triggers at all.
* The mysql.proc.comment column definition changed between MySQL
5.1 and 5.5. After a downgrade from 5.5 to 5.1, this table is
seen as corrupt and in need of repair. To workaround this
problem, execute mysql_upgrade from the version of MySQL to
which you downgraded.
2.4.2.1. Downgrading to MySQL 5.0 2.4.2.1. Downgrading to MySQL 5.0
When downgrading to MySQL 5.0 from MySQL 5.1, you should keep in When downgrading to MySQL 5.0 from MySQL 5.1, you should keep in
...@@ -2979,9 +2911,10 @@ mysql> source /tmp/triggers.sql // ...@@ -2979,9 +2911,10 @@ mysql> source /tmp/triggers.sql //
--all-databases option). Instead, you should run mysqldump --all-databases option). Instead, you should run mysqldump
--routines prior to performing the downgrade and run the --routines prior to performing the downgrade and run the
stored routines DDL statements following the downgrade. stored routines DDL statements following the downgrade.
See Bug#11986: http://bugs.mysql.com/11986, See Bug#11986: http://bugs.mysql.com/bug.php?id=11986,
Bug#30029: http://bugs.mysql.com/30029, and Bug#30029: http://bugs.mysql.com/bug.php?id=30029, and
Bug#30660: http://bugs.mysql.com/30660, for more information. Bug#30660: http://bugs.mysql.com/bug.php?id=30660, for more
information.
* Triggers. Trigger creation requires the TRIGGER privilege as * Triggers. Trigger creation requires the TRIGGER privilege as
of MySQL 5.1. In MySQL 5.0, there is no TRIGGER privilege and of MySQL 5.1. In MySQL 5.0, there is no TRIGGER privilege and
...@@ -3060,10 +2993,10 @@ mysql> source /tmp/triggers.sql // ...@@ -3060,10 +2993,10 @@ mysql> source /tmp/triggers.sql //
report, the bug number is given. report, the bug number is given.
The list applies both for binary upgrades and downgrades. For The list applies both for binary upgrades and downgrades. For
example, Bug#27877: http://bugs.mysql.com/27877 was fixed in MySQL example, Bug#27877: http://bugs.mysql.com/bug.php?id=27877 was
5.1.24 and 5.4.0, so it applies to upgrades from versions older fixed in MySQL 5.1.24 and 5.4.0, so it applies to upgrades from
than 5.1.24 to 5.1.24 or newer, and to downgrades from 5.1.24 or versions older than 5.1.24 to 5.1.24 or newer, and to downgrades
newer to versions older than 5.1.24. from 5.1.24 or newer to versions older than 5.1.24.
In many cases, you can use CHECK TABLE ... FOR UPGRADE to identify In many cases, you can use CHECK TABLE ... FOR UPGRADE to identify
tables for which index rebuilding is required. (It will report: tables for which index rebuilding is required. (It will report:
...@@ -3073,33 +3006,36 @@ mysql> source /tmp/triggers.sql // ...@@ -3073,33 +3006,36 @@ mysql> source /tmp/triggers.sql //
TABLE. However, the use of CHECK TABLE applies only after TABLE. However, the use of CHECK TABLE applies only after
upgrades, not downgrades. Also, CHECK TABLE is not applicable to upgrades, not downgrades. Also, CHECK TABLE is not applicable to
all storage engines. For details about which storage engines CHECK all storage engines. For details about which storage engines CHECK
TABLE supports, see Section 12.5.2.3, "CHECK TABLE Syntax." TABLE supports, see Section 12.4.2.3, "CHECK TABLE Syntax."
Changes that cause index rebuilding to be necessary: Changes that cause index rebuilding to be necessary:
* MySQL 5.0.48, 5.1.21 (Bug#29461: http://bugs.mysql.com/29461) * MySQL 5.0.48, 5.1.21
(Bug#29461: http://bugs.mysql.com/bug.php?id=29461)
Affects indexes for columns that use any of these character Affects indexes for columns that use any of these character
sets: eucjpms, euc_kr, gb2312, latin7, macce, ujis sets: eucjpms, euc_kr, gb2312, latin7, macce, ujis
Affected tables can be detected by CHECK TABLE ... FOR UPGRADE Affected tables can be detected by CHECK TABLE ... FOR UPGRADE
as of MySQL 5.1.29, 5.4.0 (see as of MySQL 5.1.29, 5.4.0 (see
Bug#39585: http://bugs.mysql.com/39585). Bug#39585: http://bugs.mysql.com/bug.php?id=39585).
* MySQL 5.0.48, 5.1.23 (Bug#27562: http://bugs.mysql.com/27562) * MySQL 5.0.48, 5.1.23
(Bug#27562: http://bugs.mysql.com/bug.php?id=27562)
Affects indexes that use the ascii_general_ci collation for Affects indexes that use the ascii_general_ci collation for
columns that contain any of these characters: '`' GRAVE columns that contain any of these characters: '`' GRAVE
ACCENT, '[' LEFT SQUARE BRACKET, '\' REVERSE SOLIDUS, ']' ACCENT, '[' LEFT SQUARE BRACKET, '\' REVERSE SOLIDUS, ']'
RIGHT SQUARE BRACKET, '~' TILDE RIGHT SQUARE BRACKET, '~' TILDE
Affected tables can be detected by CHECK TABLE ... FOR UPGRADE Affected tables can be detected by CHECK TABLE ... FOR UPGRADE
as of MySQL 5.1.29, 5.4.0 (see as of MySQL 5.1.29, 5.4.0 (see
Bug#39585: http://bugs.mysql.com/39585). Bug#39585: http://bugs.mysql.com/bug.php?id=39585).
* MySQL 5.1.24, 5.4.0 (Bug#27877: http://bugs.mysql.com/27877) * MySQL 5.1.24, 5.4.0
(Bug#27877: http://bugs.mysql.com/bug.php?id=27877)
Affects indexes that use the utf8_general_ci or Affects indexes that use the utf8_general_ci or
ucs2_general_ci collation for columns that contain 'ß' LATIN ucs2_general_ci collation for columns that contain 'ß' LATIN
SMALL LETTER SHARP S (German). SMALL LETTER SHARP S (German).
Affected tables can be detected by CHECK TABLE ... FOR UPGRADE Affected tables can be detected by CHECK TABLE ... FOR UPGRADE
as of MySQL 5.1.30, 5.4.0 (see as of MySQL 5.1.30, 5.4.0 (see
Bug#40053: http://bugs.mysql.com/40053). Bug#40053: http://bugs.mysql.com/bug.php?id=40053).
2.4.4. Rebuilding or Repairing Tables or Indexes 2.4.4. Rebuilding or Repairing Tables or Indexes
...@@ -3107,10 +3043,12 @@ mysql> source /tmp/triggers.sql // ...@@ -3107,10 +3043,12 @@ mysql> source /tmp/triggers.sql //
necessitated by changes to MySQL such as how data types are necessitated by changes to MySQL such as how data types are
handled or changes to character set handling. For example, an handled or changes to character set handling. For example, an
error in a collation might have been corrected, necessitating a error in a collation might have been corrected, necessitating a
table rebuild to rebuild the indexes for character columns that table rebuild to update the indexes for character columns that use
use the collation. It might also be that a table repair or upgrade the collation. (For examples, see Section 2.4.3, "Checking Whether
should be done as indicated by a table check operation such as Tables or Indexes Must Be Rebuilt.") It might also be that a table
that performed by CHECK TABLE, mysqlcheck, or mysql_upgrade. repair or upgrade should be done as indicated by a table check
operation such as that performed by CHECK TABLE, mysqlcheck, or
mysql_upgrade.
Methods for rebuilding a table include dumping and reloading it, Methods for rebuilding a table include dumping and reloading it,
or using ALTER TABLE or REPAIR TABLE. or using ALTER TABLE or REPAIR TABLE.
...@@ -3120,26 +3058,25 @@ Note ...@@ -3120,26 +3058,25 @@ Note
If you are rebuilding tables because a different version of MySQL If you are rebuilding tables because a different version of MySQL
will not handle them after a binary (in-place) upgrade or will not handle them after a binary (in-place) upgrade or
downgrade, you must use the dump-and-reload method. Dump the downgrade, you must use the dump-and-reload method. Dump the
tables before upgrading or downgrading (using your original tables before upgrading or downgrading using your original version
version of MySQL), and reload the tables after upgrading or of MySQL. Then reload the tables after upgrading or downgrading.
downgrading (after installing the new version).
If you use the dump-and-reload method of rebuilding tables only If you use the dump-and-reload method of rebuilding tables only
for the purpose of rebuilding indexes, you can perform the dump for the purpose of rebuilding indexes, you can perform the dump
either before or after upgrading or downgrading. Reloading still either before or after upgrading or downgrading. Reloading still
must be done afterward. must be done afterward.
To re-create a table by dumping and reloading it, use mysqldump to To rebuild a table by dumping and reloading it, use mysqldump to
create a dump file and mysql to reload the file: create a dump file and mysql to reload the file:
shell> mysqldump db_name t1 > dump.sql shell> mysqldump db_name t1 > dump.sql
shell> mysql db_name < dump.sql shell> mysql db_name < dump.sql
To recreate all the tables in a single database, specify the To rebuild all the tables in a single database, specify the
database name without any following table name: database name without any following table name:
shell> mysqldump db_name > dump.sql shell> mysqldump db_name > dump.sql
shell> mysql db_name < dump.sql shell> mysql db_name < dump.sql
To recreate all tables in all databases, use the --all-databases To rebuild all tables in all databases, use the --all-databases
option: option:
shell> mysqldump --all-databases > dump.sql shell> mysqldump --all-databases > dump.sql
shell> mysql < dump.sql shell> mysql < dump.sql
...@@ -3165,7 +3102,7 @@ mysql> REPAIR TABLE t1; ...@@ -3165,7 +3102,7 @@ mysql> REPAIR TABLE t1;
the file, as described earlier. the file, as described earlier.
For specifics about which storage engines REPAIR TABLE supports, For specifics about which storage engines REPAIR TABLE supports,
see Section 12.5.2.6, "REPAIR TABLE Syntax." see Section 12.4.2.6, "REPAIR TABLE Syntax."
mysqlcheck --repair provides command-line access to the REPAIR mysqlcheck --repair provides command-line access to the REPAIR
TABLE statement. This can be a more convenient means of repairing TABLE statement. This can be a more convenient means of repairing
...@@ -3447,7 +3384,7 @@ Note ...@@ -3447,7 +3384,7 @@ Note
below for reference: below for reference:
* Windows Essentials --- this package has a file name similar to * Windows Essentials --- this package has a file name similar to
mysql-essential-5.1.41-win32.msi and is supplied as a mysql-essential-5.1.46-win32.msi and is supplied as a
Microsoft Installer (MSI) package. The package includes the Microsoft Installer (MSI) package. The package includes the
minimum set of files needed to install MySQL on Windows, minimum set of files needed to install MySQL on Windows,
including the MySQL Server Instance Config Wizard. This including the MySQL Server Instance Config Wizard. This
...@@ -3458,7 +3395,7 @@ Note ...@@ -3458,7 +3395,7 @@ Note
MySQL with the MSI Package." MySQL with the MSI Package."
* Windows MSI Installer (Complete) --- this package has a file * Windows MSI Installer (Complete) --- this package has a file
name similar to mysql-5.1.41-win32.zip and contains all files name similar to mysql-5.1.46-win32.zip and contains all files
needed for a complete Windows installation, including the needed for a complete Windows installation, including the
MySQL Server Instance Config Wizard. This package includes MySQL Server Instance Config Wizard. This package includes
optional components such as the embedded server and benchmark optional components such as the embedded server and benchmark
...@@ -3467,7 +3404,7 @@ Note ...@@ -3467,7 +3404,7 @@ Note
MySQL with the MSI Package." MySQL with the MSI Package."
* Without installer --- this package has a file name similar to * Without installer --- this package has a file name similar to
mysql-noinstall-5.1.41-win32.zip and contains all the files mysql-noinstall-5.1.46-win32.zip and contains all the files
found in the Complete install package, with the exception of found in the Complete install package, with the exception of
the MySQL Server Instance Config Wizard. This package does not the MySQL Server Instance Config Wizard. This package does not
include an automated installer, and must be manually installed include an automated installer, and must be manually installed
...@@ -3618,7 +3555,7 @@ Note ...@@ -3618,7 +3555,7 @@ Note
feedback of users like you. If you find that the MySQL feedback of users like you. If you find that the MySQL
Installation Wizard is lacking some feature important to you, or Installation Wizard is lacking some feature important to you, or
if you discover a bug, please report it in our bugs database using if you discover a bug, please report it in our bugs database using
the instructions given in Section 1.6, "How to Report Bugs or the instructions given in Section 1.7, "How to Report Bugs or
Problems." Problems."
2.5.3.1.1. Downloading and Starting the MySQL Installation Wizard 2.5.3.1.1. Downloading and Starting the MySQL Installation Wizard
...@@ -3720,7 +3657,7 @@ Note ...@@ -3720,7 +3657,7 @@ Note
directory. In a default installation it contains C:\Program directory. In a default installation it contains C:\Program
Files\MySQL\MySQL Server 5.1\. The Version string contains the Files\MySQL\MySQL Server 5.1\. The Version string contains the
release number. For example, for an installation of MySQL Server release number. For example, for an installation of MySQL Server
5.1.41, the key contains a value of 5.1.41. 5.1.46, the key contains a value of 5.1.46.
These registry keys are used to help external tools identify the These registry keys are used to help external tools identify the
installed location of the MySQL server, preventing a complete scan installed location of the MySQL server, preventing a complete scan
...@@ -3963,8 +3900,8 @@ shell> msiexec /x /quiet mysql-5.1.39.msi ...@@ -3963,8 +3900,8 @@ shell> msiexec /x /quiet mysql-5.1.39.msi
Apart from making changes to the my.ini file by running the MySQL Apart from making changes to the my.ini file by running the MySQL
Server Instance Config Wizard again, you can modify it by opening Server Instance Config Wizard again, you can modify it by opening
it with a text editor and making any necessary changes. You can it with a text editor and making any necessary changes. You can
also modify the server configuration with the MySQL Administrator also modify the server configuration with the
(http://www.mysql.com/products/administrator/) utility. For more http://www.mysql.com/products/administrator/ utility. For more
information about server configuration, see Section 5.1.2, "Server information about server configuration, see Section 5.1.2, "Server
Command Options." Command Options."
...@@ -4262,17 +4199,31 @@ Warning ...@@ -4262,17 +4199,31 @@ Warning
2.5.4.11. The Security Options Dialog 2.5.4.11. The Security Options Dialog
It is strongly recommended that you set a root password for your The content of the security options portion of the MySQL Server
MySQL server, and the MySQL Server Instance Config Wizard requires Instance Configuration Wizard will depend on whether this is a new
by default that you do so. If you do not wish to set a root installation, or modifying an existing installation.
password, uncheck the box next to the Modify Security Settings
option. * Setting the root password for a new installation
MySQL Server Instance Config Wizard: Security It is strongly recommended that you set a root password for
your MySQL server, and the MySQL Server Instance Config Wizard
To set the root password, enter the desired password into both the requires by default that you do so. If you do not wish to set
New root password and Confirm boxes. If you are reconfiguring an a root password, uncheck the box next to the Modify Security
existing server, you need to enter the existing root password into Settings option.
the Current root password box. MySQL Server Instance Config Wizard: Security
* To set the root password, enter the desired password into both
the New root password and Confirm boxes.
Setting the root password for an existing installation
If you are modifying the configuration of an existing
configuration, or you are installing an upgrade and the MySQL
Server Instance Configuration Wizard has detected an existing
MySQL system, then you must enter the existing password for
root before changing the configuration information.
MySQL Server Instance Config Wizard: Security (Existing
Installation)
If you want to change the current root password, enter the
desired new password into both the New root password and
Confirm boxes.
To allow root logins from across the network, check the box next To allow root logins from across the network, check the box next
to the Enable root access from remote machines option. This to the Enable root access from remote machines option. This
...@@ -4718,7 +4669,7 @@ InnoDB: foreign key constraint system tables created ...@@ -4718,7 +4669,7 @@ InnoDB: foreign key constraint system tables created
something like this, which indicates that the server is ready to something like this, which indicates that the server is ready to
service client connections: service client connections:
mysqld: ready for connections mysqld: ready for connections
Version: '5.1.41' socket: '' port: 3306 Version: '5.1.46' socket: '' port: 3306
The server continues to write to the console any further The server continues to write to the console any further
diagnostic output it produces. You can open a new console window diagnostic output it produces. You can open a new console window
...@@ -5104,7 +5055,7 @@ C:\> sc delete mysql ...@@ -5104,7 +5055,7 @@ C:\> sc delete mysql
Windows. Windows.
2. You should always back up your current MySQL installation 2. You should always back up your current MySQL installation
before performing an upgrade. See Section 6.1, "Database before performing an upgrade. See Section 6.2, "Database
Backup Methods." Backup Methods."
3. Download the latest Windows distribution of MySQL from 3. Download the latest Windows distribution of MySQL from
...@@ -5389,7 +5340,7 @@ ROM db" mysql ...@@ -5389,7 +5340,7 @@ ROM db" mysql
names that are compatible with the current ANSI code pages. names that are compatible with the current ANSI code pages.
For example, the following Japanese directory name will not For example, the following Japanese directory name will not
work in the Western locale (code page 1252): work in the Western locale (code page 1252):
datadir="C:/维基百科关于中文维基百科" datadir="C:/私たちのプロジェクトのデータ"
The same limitation applies to directory and file names The same limitation applies to directory and file names
referred to in SQL statements, such as the data file path name referred to in SQL statements, such as the data file path name
in LOAD DATA INFILE. in LOAD DATA INFILE.
...@@ -5451,10 +5402,9 @@ Note ...@@ -5451,10 +5402,9 @@ Note
from the Bazaar tree. For production use, we do not advise using a from the Bazaar tree. For production use, we do not advise using a
MySQL server built by yourself from source. Normally, it is best MySQL server built by yourself from source. Normally, it is best
to use precompiled binary distributions of MySQL that are built to use precompiled binary distributions of MySQL that are built
specifically for optimal performance on Windows by Sun specifically for optimal performance on Windows by Oracle
Microsystems, Inc. Instructions for installing binary Corporation. Instructions for installing binary distributions are
distributions are available in Section 2.5, "Installing MySQL on available in Section 2.5, "Installing MySQL on Windows."
Windows."
To build MySQL on Windows from source, you must satisfy the To build MySQL on Windows from source, you must satisfy the
following system, compiler, and resource requirements: following system, compiler, and resource requirements:
...@@ -5514,8 +5464,8 @@ Note ...@@ -5514,8 +5464,8 @@ Note
You also need a MySQL source distribution for Windows, which can You also need a MySQL source distribution for Windows, which can
be obtained two ways: be obtained two ways:
* Obtain a source distribution packaged by Sun Microsystems, * Obtain a source distribution packaged by Oracle Corporation.
Inc. These are available from http://dev.mysql.com/downloads/. These are available from http://dev.mysql.com/downloads/.
* Package a source distribution yourself from the latest Bazaar * Package a source distribution yourself from the latest Bazaar
developer source tree. For instructions on pulling the latest developer source tree. For instructions on pulling the latest
...@@ -5525,19 +5475,20 @@ Note ...@@ -5525,19 +5475,20 @@ Note
If you find something not working as expected, or you have If you find something not working as expected, or you have
suggestions about ways to improve the current build process on suggestions about ways to improve the current build process on
Windows, please send a message to the win32 mailing list. See Windows, please send a message to the win32 mailing list. See
Section 1.5.1, "MySQL Mailing Lists." Section 1.6.1, "MySQL Mailing Lists."
2.5.10.1. Building MySQL from Source Using CMake and Visual Studio 2.5.10.1. Building MySQL from Source Using CMake and Visual Studio
You can build MySQL on Windows by using a combination of cmake and You can build MySQL on Windows by using a combination of cmake and
Microsoft Visual Studio .NET 2003 (7.1), Microsoft Visual Studio Microsoft Visual Studio .NET 2003 (7.1), Microsoft Visual Studio
2005 (8.0) or Microsoft Visual C++ 2005 Express Edition. You must 2005 (8.0), Microsoft Visual Studio 2008 (9.0) or Microsoft Visual
have the appropriate Microsoft Platform SDK installed. C++ 2005 Express Edition. You must have the appropriate Microsoft
Platform SDK installed.
Note Note
To compile from the source code on Windows you must use the To compile from the source code on Windows you must use the
standard source distribution (for example, mysql-5.1.41.tar.gz). standard source distribution (for example, mysql-5.1.46.tar.gz).
You build from the same distribution as used to build MySQL on You build from the same distribution as used to build MySQL on
Unix, Linux and other platforms. Do not use the Windows Source Unix, Linux and other platforms. Do not use the Windows Source
distributions as they do not contain the necessary configuration distributions as they do not contain the necessary configuration
...@@ -5551,8 +5502,19 @@ Note ...@@ -5551,8 +5502,19 @@ Note
tool that can read .zip files. This directory is the work tool that can read .zip files. This directory is the work
directory in the following instructions. directory in the following instructions.
2. Using a command shell, navigate to the work directory and run Note
the following command: You must run the commands in the win directory from the
top-level source directory. Do not change into the win
directory, as the commands will not be executed correctly.
2. Start a command shell. If you have not configured the PATH and
other environment variables for all command shells, you may be
able to start a command shell from the Start Menu within the
Windows Visual Studio menu that contains the necessary
environment changes.
3. Within the command shell, navigate to the work directory and
run the following command:
C:\workdir>win\configure.js options C:\workdir>win\configure.js options
If you have associated the .js file extension with an If you have associated the .js file extension with an
application such as a text editor, then you may need to use application such as a text editor, then you may need to use
...@@ -5603,16 +5565,19 @@ C:\workdir>cscript win\configure.js options ...@@ -5603,16 +5565,19 @@ C:\workdir>cscript win\configure.js options
C:\workdir>win\configure.js WITH_INNOBASE_STORAGE_ENGINE C:\workdir>win\configure.js WITH_INNOBASE_STORAGE_ENGINE
WITH_PARTITION_STORAGE_ENGINE MYSQL_SERVER_SUFFIX=-pro WITH_PARTITION_STORAGE_ENGINE MYSQL_SERVER_SUFFIX=-pro
3. From the work directory, execute the win\build-vs8.bat or 4. From the work directory, execute the win\build-vs9.bat
win\build-vs71.bat file, depending on the version of Visual (Windows Visual Studio 2008), win\build-vs8.bat (Windows
Visual Studio 2005), or win\build-vs71.bat (Windows Visual
Stidion 2003) script, depending on the version of Visual
Studio you have installed. The script invokes CMake, which Studio you have installed. The script invokes CMake, which
generates the mysql.sln solution file. generates the mysql.sln solution file.
You can also use win\build-vs8_x64.bat to build the 64-bit You can also use the corresponding 64-bit file (for example
version of MySQL. However, you cannot build the 64-bit version win\build-vs8_x64.bat or win\build-vs9_x64.bat) to build the
with Visual Studio Express Edition. You must use Visual Studio 64-bit version of MySQL. However, you cannot build the 64-bit
2005 (8.0) or higher. version with Visual Studio Express Edition. You must use
Visual Studio 2005 (8.0) or higher.
4. From the work directory, open the generated mysql.sln file 5. From the work directory, open the generated mysql.sln file
with Visual Studio and select the proper configuration using with Visual Studio and select the proper configuration using
the Configuration menu. The menu provides Debug, Release, the Configuration menu. The menu provides Debug, Release,
RelwithDebInfo, MinRelInfo options. Then select Solution > RelwithDebInfo, MinRelInfo options. Then select Solution >
...@@ -5621,7 +5586,7 @@ C:\workdir>win\configure.js WITH_INNOBASE_STORAGE_ENGINE ...@@ -5621,7 +5586,7 @@ C:\workdir>win\configure.js WITH_INNOBASE_STORAGE_ENGINE
important later when you run the test script because that important later when you run the test script because that
script needs to know which configuration you used. script needs to know which configuration you used.
5. Test the server. The server built using the preceding 6. Test the server. The server built using the preceding
instructions expects that the MySQL base directory and data instructions expects that the MySQL base directory and data
directory are C:\mysql and C:\mysql\data by default. If you directory are C:\mysql and C:\mysql\data by default. If you
want to test your server using the source tree root directory want to test your server using the source tree root directory
...@@ -5681,29 +5646,36 @@ C:\> mkdir C:\mysql\sql-bench ...@@ -5681,29 +5646,36 @@ C:\> mkdir C:\mysql\sql-bench
Installation Notes." Installation Notes."
2. From the work directory, copy into the C:\mysql directory the 2. From the work directory, copy into the C:\mysql directory the
following directories: following files and directories:
C:\> cd \workdir C:\> cd \workdir
C:\workdir> copy client_release\*.exe C:\mysql\bin C:\workdir> mkdir C:\mysql
C:\workdir> copy client_debug\mysqld.exe C:\mysql\bin\mysqld-debug.ex C:\workdir> mkdir C:\mysql\bin
e C:\workdir> copy client\Release\*.exe C:\mysql\bin
C:\workdir> copy sql\Release\mysqld.exe C:\mysql\bin\mysqld.exe
C:\workdir> xcopy scripts\*.* C:\mysql\scripts /E C:\workdir> xcopy scripts\*.* C:\mysql\scripts /E
C:\workdir> xcopy share\*.* C:\mysql\share /E C:\workdir> xcopy share\*.* C:\mysql\share /E
If you want to compile other clients and link them to MySQL, If you want to compile other clients and link them to MySQL,
you should also copy several libraries and header files: you should also copy several libraries and header files:
C:\workdir> copy lib_debug\mysqlclient.lib C:\mysql\lib\debug C:\workdir> copy lib\Release\mysqlclient.lib C:\mysql\lib\debug
C:\workdir> copy lib_debug\libmysql.* C:\mysql\lib\debug C:\workdir> copy lib\Release\libmysql.* C:\mysql\lib\debug
C:\workdir> copy lib_debug\zlib.* C:\mysql\lib\debug C:\workdir> copy lib\Release\zlib.* C:\mysql\lib\debug
C:\workdir> copy lib_release\mysqlclient.lib C:\mysql\lib\opt C:\workdir> copy lib\Release\mysqlclient.lib C:\mysql\lib\opt
C:\workdir> copy lib_release\libmysql.* C:\mysql\lib\opt C:\workdir> copy lib\Release\libmysql.* C:\mysql\lib\opt
C:\workdir> copy lib_release\zlib.* C:\mysql\lib\opt C:\workdir> copy lib\Release\zlib.* C:\mysql\lib\opt
C:\workdir> copy include\*.h C:\mysql\include C:\workdir> copy include\*.h C:\mysql\include
C:\workdir> copy libmysql\libmysql.def C:\mysql\include C:\workdir> copy libmysql\libmysql.def C:\mysql\include
Note
If you have compiled a Debug, rather than Release solution,
you can replace Release with Debug in the source file names
shown above.
If you want to benchmark MySQL, you should also do this: If you want to benchmark MySQL, you should also do this:
C:\workdir> xcopy sql-bench\*.* C:\mysql\bench /E C:\workdir> xcopy sql-bench\*.* C:\mysql\bench /E
After installation, set up and start the server in the same way as After installation, set up and start the server in the same way as
for binary Windows distributions. See Section 2.5, "Installing for binary Windows distributions. This includes creating the
MySQL on Windows." system tables by running mysql_install_db. For more information,
see Section 2.5, "Installing MySQL on Windows."
2.5.11. Compiling MySQL Clients on Windows 2.5.11. Compiling MySQL Clients on Windows
...@@ -6626,14 +6598,23 @@ DLTLIB LIB(MYSQLINST) ...@@ -6626,14 +6598,23 @@ DLTLIB LIB(MYSQLINST)
Upgrading an existing MySQL instance Upgrading an existing MySQL instance
You need to execute the upgrade command, MYSQLINST/UPGMYSQL. You You need to execute the upgrade command, MYSQLINST/UPGMYSQL.
must specify 6 parameters to perform an upgrade:
Note
You cannot use MYSQLINST/UPGMYSQL to upgrade between major
versions of MySQL (for example from 5.0 to 5.1). For information
and advice on migrating between major versions you can use the
advice provided in Section 2.4.1.1, "Upgrading from MySQL 5.0 to
5.1."
You must specify 6 parameters to perform an upgrade:
* DIR('/QOpenSys/usr/local/') --- sets the installation location * DIR('/QOpenSys/usr/local/') --- sets the installation location
for the MySQL files. The directory will be created if it does for the MySQL files. The directory will be created if it does
not already exist. This is the directory that the MySQL server not already exist. This is the directory that the MySQL server
will be installed into, inside a directory with a name will be installed into, inside a directory with a name
matching the version and release. For example if installing matching the version and release. For example, if installing
MySQL 5.1.39 with the DIR set to /QOpenSys/usr/local/ would MySQL 5.1.39 with the DIR set to /QOpenSys/usr/local/ would
result in /QOpenSys/usr/local/mysql-5.1.39-i5os-power64 and a result in /QOpenSys/usr/local/mysql-5.1.39-i5os-power64 and a
symbolic link to this directory will be created in symbolic link to this directory will be created in
...@@ -7167,7 +7148,7 @@ shell> bin/mysqld_safe --user=mysql & ...@@ -7167,7 +7148,7 @@ shell> bin/mysqld_safe --user=mysql &
logged in to the system as mysql, in which case you can omit logged in to the system as mysql, in which case you can omit
the --user option from the command. the --user option from the command.
Further instructions for running MySQL as an unprivileged user Further instructions for running MySQL as an unprivileged user
are given in Section 5.3.5, "How to Run MySQL as a Normal are given in Section 5.3.6, "How to Run MySQL as a Normal
User." User."
If you neglected to create the grant tables before proceeding If you neglected to create the grant tables before proceeding
to this step, the following message appears in the error log to this step, the following message appears in the error log
...@@ -7185,10 +7166,10 @@ shell> bin/mysqladmin variables ...@@ -7185,10 +7166,10 @@ shell> bin/mysqladmin variables
on your platform and version of MySQL, but should be similar on your platform and version of MySQL, but should be similar
to that shown here: to that shown here:
shell> bin/mysqladmin version shell> bin/mysqladmin version
mysqladmin Ver 14.12 Distrib 5.1.41, for pc-linux-gnu on i686 mysqladmin Ver 14.12 Distrib 5.1.46, for pc-linux-gnu on i686
... ...
Server version 5.1.41 Server version 5.1.46
Protocol version 10 Protocol version 10
Connection Localhost via UNIX socket Connection Localhost via UNIX socket
UNIX socket /var/lib/mysql/mysql.sock UNIX socket /var/lib/mysql/mysql.sock
...@@ -7292,7 +7273,7 @@ shell> mysql -vvf test < ./tests/auto_increment.tst ...@@ -7292,7 +7273,7 @@ shell> mysql -vvf test < ./tests/auto_increment.tst
The MySQL 5.1 installation procedure creates time zone tables in The MySQL 5.1 installation procedure creates time zone tables in
the mysql database. However, you must populate the tables manually the mysql database. However, you must populate the tables manually
using the instructions in Section 9.7, "MySQL Server Time Zone using the instructions in Section 9.6, "MySQL Server Time Zone
Support." Support."
2.13.1.1. Problems Running mysql_install_db 2.13.1.1. Problems Running mysql_install_db
...@@ -7323,7 +7304,7 @@ mysqld ended ...@@ -7323,7 +7304,7 @@ mysqld ended
carefully. The log should be located in the directory XXXXXX carefully. The log should be located in the directory XXXXXX
named by the error message and should indicate why mysqld named by the error message and should indicate why mysqld
didn't start. If you do not understand what happened, include didn't start. If you do not understand what happened, include
the log when you post a bug report. See Section 1.6, "How to the log when you post a bug report. See Section 1.7, "How to
Report Bugs or Problems." Report Bugs or Problems."
* There is a mysqld process running * There is a mysqld process running
...@@ -7972,7 +7953,7 @@ Note ...@@ -7972,7 +7953,7 @@ Note
MYSQL_PS1 The command prompt to use in the mysql command-line MYSQL_PS1 The command prompt to use in the mysql command-line
client. client.
MYSQL_PWD The default password when connecting to mysqld. Note MYSQL_PWD The default password when connecting to mysqld. Note
that using this is insecure. See Section 5.5.6.2, "End-User that using this is insecure. See Section 5.3.2.2, "End-User
Guidelines for Password Security." Guidelines for Password Security."
MYSQL_TCP_PORT The default TCP/IP port number. MYSQL_TCP_PORT The default TCP/IP port number.
MYSQL_UNIX_PORT The default Unix socket file name; used for MYSQL_UNIX_PORT The default Unix socket file name; used for
......
INSTALL-WIN-SOURCE
View file @ d923b924
...@@ -13,10 +13,9 @@ Note ...@@ -13,10 +13,9 @@ Note
from the Bazaar tree. For production use, we do not advise using a from the Bazaar tree. For production use, we do not advise using a
MySQL server built by yourself from source. Normally, it is best MySQL server built by yourself from source. Normally, it is best
to use precompiled binary distributions of MySQL that are built to use precompiled binary distributions of MySQL that are built
specifically for optimal performance on Windows by Sun specifically for optimal performance on Windows by Oracle
Microsystems, Inc. Instructions for installing binary Corporation. Instructions for installing binary distributions are
distributions are available in Section 2.5, "Installing MySQL on available in Section 2.5, "Installing MySQL on Windows."
Windows."
To build MySQL on Windows from source, you must satisfy the To build MySQL on Windows from source, you must satisfy the
following system, compiler, and resource requirements: following system, compiler, and resource requirements:
...@@ -76,8 +75,8 @@ Note ...@@ -76,8 +75,8 @@ Note
You also need a MySQL source distribution for Windows, which can You also need a MySQL source distribution for Windows, which can
be obtained two ways: be obtained two ways:
* Obtain a source distribution packaged by Sun Microsystems, * Obtain a source distribution packaged by Oracle Corporation.
Inc. These are available from http://dev.mysql.com/downloads/. These are available from http://dev.mysql.com/downloads/.
* Package a source distribution yourself from the latest Bazaar * Package a source distribution yourself from the latest Bazaar
developer source tree. For instructions on pulling the latest developer source tree. For instructions on pulling the latest
...@@ -87,19 +86,20 @@ Note ...@@ -87,19 +86,20 @@ Note
If you find something not working as expected, or you have If you find something not working as expected, or you have
suggestions about ways to improve the current build process on suggestions about ways to improve the current build process on
Windows, please send a message to the win32 mailing list. See Windows, please send a message to the win32 mailing list. See
Section 1.5.1, "MySQL Mailing Lists." Section 1.6.1, "MySQL Mailing Lists."
2.5.10.1. Building MySQL from Source Using CMake and Visual Studio 2.5.10.1. Building MySQL from Source Using CMake and Visual Studio
You can build MySQL on Windows by using a combination of cmake and You can build MySQL on Windows by using a combination of cmake and
Microsoft Visual Studio .NET 2003 (7.1), Microsoft Visual Studio Microsoft Visual Studio .NET 2003 (7.1), Microsoft Visual Studio
2005 (8.0) or Microsoft Visual C++ 2005 Express Edition. You must 2005 (8.0), Microsoft Visual Studio 2008 (9.0) or Microsoft Visual
have the appropriate Microsoft Platform SDK installed. C++ 2005 Express Edition. You must have the appropriate Microsoft
Platform SDK installed.
Note Note
To compile from the source code on Windows you must use the To compile from the source code on Windows you must use the
standard source distribution (for example, mysql-5.1.41.tar.gz). standard source distribution (for example, mysql-5.1.46.tar.gz).
You build from the same distribution as used to build MySQL on You build from the same distribution as used to build MySQL on
Unix, Linux and other platforms. Do not use the Windows Source Unix, Linux and other platforms. Do not use the Windows Source
distributions as they do not contain the necessary configuration distributions as they do not contain the necessary configuration
...@@ -113,8 +113,19 @@ Note ...@@ -113,8 +113,19 @@ Note
tool that can read .zip files. This directory is the work tool that can read .zip files. This directory is the work
directory in the following instructions. directory in the following instructions.
2. Using a command shell, navigate to the work directory and run Note
the following command: You must run the commands in the win directory from the
top-level source directory. Do not change into the win
directory, as the commands will not be executed correctly.
2. Start a command shell. If you have not configured the PATH and
other environment variables for all command shells, you may be
able to start a command shell from the Start Menu within the
Windows Visual Studio menu that contains the necessary
environment changes.
3. Within the command shell, navigate to the work directory and
run the following command:
C:\workdir>win\configure.js options C:\workdir>win\configure.js options
If you have associated the .js file extension with an If you have associated the .js file extension with an
application such as a text editor, then you may need to use application such as a text editor, then you may need to use
...@@ -165,16 +176,19 @@ C:\workdir>cscript win\configure.js options ...@@ -165,16 +176,19 @@ C:\workdir>cscript win\configure.js options
C:\workdir>win\configure.js WITH_INNOBASE_STORAGE_ENGINE C:\workdir>win\configure.js WITH_INNOBASE_STORAGE_ENGINE
WITH_PARTITION_STORAGE_ENGINE MYSQL_SERVER_SUFFIX=-pro WITH_PARTITION_STORAGE_ENGINE MYSQL_SERVER_SUFFIX=-pro
3. From the work directory, execute the win\build-vs8.bat or 4. From the work directory, execute the win\build-vs9.bat
win\build-vs71.bat file, depending on the version of Visual (Windows Visual Studio 2008), win\build-vs8.bat (Windows
Visual Studio 2005), or win\build-vs71.bat (Windows Visual
Stidion 2003) script, depending on the version of Visual
Studio you have installed. The script invokes CMake, which Studio you have installed. The script invokes CMake, which
generates the mysql.sln solution file. generates the mysql.sln solution file.
You can also use win\build-vs8_x64.bat to build the 64-bit You can also use the corresponding 64-bit file (for example
version of MySQL. However, you cannot build the 64-bit version win\build-vs8_x64.bat or win\build-vs9_x64.bat) to build the
with Visual Studio Express Edition. You must use Visual Studio 64-bit version of MySQL. However, you cannot build the 64-bit
2005 (8.0) or higher. version with Visual Studio Express Edition. You must use
Visual Studio 2005 (8.0) or higher.
4. From the work directory, open the generated mysql.sln file 5. From the work directory, open the generated mysql.sln file
with Visual Studio and select the proper configuration using with Visual Studio and select the proper configuration using
the Configuration menu. The menu provides Debug, Release, the Configuration menu. The menu provides Debug, Release,
RelwithDebInfo, MinRelInfo options. Then select Solution > RelwithDebInfo, MinRelInfo options. Then select Solution >
...@@ -183,7 +197,7 @@ C:\workdir>win\configure.js WITH_INNOBASE_STORAGE_ENGINE ...@@ -183,7 +197,7 @@ C:\workdir>win\configure.js WITH_INNOBASE_STORAGE_ENGINE
important later when you run the test script because that important later when you run the test script because that
script needs to know which configuration you used. script needs to know which configuration you used.
5. Test the server. The server built using the preceding 6. Test the server. The server built using the preceding
instructions expects that the MySQL base directory and data instructions expects that the MySQL base directory and data
directory are C:\mysql and C:\mysql\data by default. If you directory are C:\mysql and C:\mysql\data by default. If you
want to test your server using the source tree root directory want to test your server using the source tree root directory
...@@ -243,26 +257,33 @@ C:\> mkdir C:\mysql\sql-bench ...@@ -243,26 +257,33 @@ C:\> mkdir C:\mysql\sql-bench
Installation Notes." Installation Notes."
2. From the work directory, copy into the C:\mysql directory the 2. From the work directory, copy into the C:\mysql directory the
following directories: following files and directories:
C:\> cd \workdir C:\> cd \workdir
C:\workdir> copy client_release\*.exe C:\mysql\bin C:\workdir> mkdir C:\mysql
C:\workdir> copy client_debug\mysqld.exe C:\mysql\bin\mysqld-debug.ex C:\workdir> mkdir C:\mysql\bin
e C:\workdir> copy client\Release\*.exe C:\mysql\bin
C:\workdir> copy sql\Release\mysqld.exe C:\mysql\bin\mysqld.exe
C:\workdir> xcopy scripts\*.* C:\mysql\scripts /E C:\workdir> xcopy scripts\*.* C:\mysql\scripts /E
C:\workdir> xcopy share\*.* C:\mysql\share /E C:\workdir> xcopy share\*.* C:\mysql\share /E
If you want to compile other clients and link them to MySQL, If you want to compile other clients and link them to MySQL,
you should also copy several libraries and header files: you should also copy several libraries and header files:
C:\workdir> copy lib_debug\mysqlclient.lib C:\mysql\lib\debug C:\workdir> copy lib\Release\mysqlclient.lib C:\mysql\lib\debug
C:\workdir> copy lib_debug\libmysql.* C:\mysql\lib\debug C:\workdir> copy lib\Release\libmysql.* C:\mysql\lib\debug
C:\workdir> copy lib_debug\zlib.* C:\mysql\lib\debug C:\workdir> copy lib\Release\zlib.* C:\mysql\lib\debug
C:\workdir> copy lib_release\mysqlclient.lib C:\mysql\lib\opt C:\workdir> copy lib\Release\mysqlclient.lib C:\mysql\lib\opt
C:\workdir> copy lib_release\libmysql.* C:\mysql\lib\opt C:\workdir> copy lib\Release\libmysql.* C:\mysql\lib\opt
C:\workdir> copy lib_release\zlib.* C:\mysql\lib\opt C:\workdir> copy lib\Release\zlib.* C:\mysql\lib\opt
C:\workdir> copy include\*.h C:\mysql\include C:\workdir> copy include\*.h C:\mysql\include
C:\workdir> copy libmysql\libmysql.def C:\mysql\include C:\workdir> copy libmysql\libmysql.def C:\mysql\include
Note
If you have compiled a Debug, rather than Release solution,
you can replace Release with Debug in the source file names
shown above.
If you want to benchmark MySQL, you should also do this: If you want to benchmark MySQL, you should also do this:
C:\workdir> xcopy sql-bench\*.* C:\mysql\bench /E C:\workdir> xcopy sql-bench\*.* C:\mysql\bench /E
After installation, set up and start the server in the same way as After installation, set up and start the server in the same way as
for binary Windows distributions. See Section 2.5, "Installing for binary Windows distributions. This includes creating the
MySQL on Windows." system tables by running mysql_install_db. For more information,
see Section 2.5, "Installing MySQL on Windows."
man/comp_err.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBcomp_err\fR .\" Title: \fBcomp_err\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBCOMP_ERR\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBCOMP_ERR\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -63,7 +63,7 @@ shell> \fBcomp_err [\fR\fB\fIoptions\fR\fR\fB]\fR ...@@ -63,7 +63,7 @@ shell> \fBcomp_err [\fR\fB\fIoptions\fR\fR\fB]\fR
.\} .\}
.PP .PP
\fBcomp_err\fR \fBcomp_err\fR
supports the options described in the following list\&. supports the following options\&.
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
...@@ -254,7 +254,7 @@ Display version information and exit\&. ...@@ -254,7 +254,7 @@ Display version information and exit\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/innochecksum.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBinnochecksum\fR .\" Title: \fBinnochecksum\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBINNOCHECKSUM\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBINNOCHECKSUM\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -59,7 +59,7 @@ shell> \fBinnochecksum [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIfile_name\fR\fR ...@@ -59,7 +59,7 @@ shell> \fBinnochecksum [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIfile_name\fR\fR
.\} .\}
.PP .PP
\fBinnochecksum\fR \fBinnochecksum\fR
supports the options described in the following list\&. For options that refer to page numbers, the numbers are zero\-based\&. supports the following options\&. For options that refer to page numbers, the numbers are zero\-based\&.
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
...@@ -141,7 +141,7 @@ Verbose mode; print a progress indicator every five seconds\&. ...@@ -141,7 +141,7 @@ Verbose mode; print a progress indicator every five seconds\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/make_win_bin_dist.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmake_win_bin_dist\fR .\" Title: \fBmake_win_bin_dist\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMAKE_WIN_BIN_DIST" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMAKE_WIN_BIN_DIST" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -67,7 +67,7 @@ bin/mysqld\-max\&.exe=\&.\&./my\-max\-build/sql/release/mysqld\&.exe ...@@ -67,7 +67,7 @@ bin/mysqld\-max\&.exe=\&.\&./my\-max\-build/sql/release/mysqld\&.exe
If you specify a directory, the entire directory will be copied\&. If you specify a directory, the entire directory will be copied\&.
.PP .PP
\fBmake_win_bin_dist\fR \fBmake_win_bin_dist\fR
supports the following options: supports the following options\&.
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
...@@ -169,7 +169,7 @@ directories)\&. ...@@ -169,7 +169,7 @@ directories)\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/msql2mysql.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmsql2mysql\fR .\" Title: \fBmsql2mysql\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMSQL2MYSQL\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMSQL2MYSQL\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -60,7 +60,7 @@ utility to make the function name substitutions\&. See ...@@ -60,7 +60,7 @@ utility to make the function name substitutions\&. See
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/my_print_defaults.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmy_print_defaults\fR .\" Title: \fBmy_print_defaults\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMY_PRINT_DEFAULTS" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMY_PRINT_DEFAULTS" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -53,7 +53,7 @@ shell> \fBmy_print_defaults mysqlcheck client\fR ...@@ -53,7 +53,7 @@ shell> \fBmy_print_defaults mysqlcheck client\fR
The output consists of options, one per line, in the form that they would be specified on the command line\&. The output consists of options, one per line, in the form that they would be specified on the command line\&.
.PP .PP
\fBmy_print_defaults\fR \fBmy_print_defaults\fR
supports the following options: supports the following options\&.
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
...@@ -195,7 +195,7 @@ Display version information and exit\&. ...@@ -195,7 +195,7 @@ Display version information and exit\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/myisam_ftdump.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmyisam_ftdump\fR .\" Title: \fBmyisam_ftdump\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYISAM_FTDUMP\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYISAM_FTDUMP\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -33,7 +33,13 @@ indexes in ...@@ -33,7 +33,13 @@ indexes in
MyISAM MyISAM
tables\&. It reads the tables\&. It reads the
MyISAM MyISAM
index file directly, so it must be run on the server host where the table is located index file directly, so it must be run on the server host where the table is located\&. Before using
\fBmyisam_ftdump\fR, be sure to issue a
FLUSH TABLES
statement first if the server is running\&.
.PP
\fBmyisam_ftdump\fR
scans and dumps the entire index, which is not particularly fast\&. On the other hand, the distribution of words changes infrequently, so it need not be run often\&.
.PP .PP
Invoke Invoke
\fBmyisam_ftdump\fR \fBmyisam_ftdump\fR
...@@ -120,6 +126,20 @@ shell> \fBmyisam_ftdump /usr/local/mysql/data/test/mytexttable 1\fR ...@@ -120,6 +126,20 @@ shell> \fBmyisam_ftdump /usr/local/mysql/data/test/mytexttable 1\fR
.RE .RE
.\} .\}
.PP .PP
You can use
\fBmyisam_ftdump\fR
to generate a list of index entries in order of frequency of occurrence like this:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmyisam_ftdump \-c mytexttable 1 | sort \-r\fR
.fi
.if n \{\
.RE
.\}
.PP
\fBmyisam_ftdump\fR \fBmyisam_ftdump\fR
supports the following options: supports the following options:
.sp .sp
...@@ -222,7 +242,7 @@ Verbose mode\&. Print more output about what the program does\&. ...@@ -222,7 +242,7 @@ Verbose mode\&. Print more output about what the program does\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/myisamchk.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmyisamchk\fR .\" Title: \fBmyisamchk\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYISAMCHK\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYISAMCHK\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -219,12 +219,16 @@ CHECK TABLE ...@@ -219,12 +219,16 @@ CHECK TABLE
instead of instead of
\fBmyisamchk\fR \fBmyisamchk\fR
to check tables\&. See to check tables\&. See
Section\ \&12.5.2.3, \(lqCHECK TABLE Syntax\(rq\&. Section\ \&12.4.2.3, \(lqCHECK TABLE Syntax\(rq\&.
.sp .5v .sp .5v
.RE .RE
.PP .PP
\fBmyisamchk\fR \fBmyisamchk\fR
supports the options in the following table\&. It also reads option files and supports the options for processing them described at supports the following options, which can be specified on the command line or in the
[myisamchk]
option file group\&.
\fBmyisamchk\fR
also supports the options for processing option files described at
Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&. Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&.
.SH "MYISAMCHK GENERAL OPTIONS" .SH "MYISAMCHK GENERAL OPTIONS"
.\" options: myisamchk .\" options: myisamchk
...@@ -521,18 +525,7 @@ system variable\&. For more information, see the description of ...@@ -521,18 +525,7 @@ system variable\&. For more information, see the description of
myisam_stats_method myisam_stats_method
in in
Section\ \&5.1.4, \(lqServer System Variables\(rq, and Section\ \&5.1.4, \(lqServer System Variables\(rq, and
Section\ \&7.4.7, \(lqMyISAM Index Statistics Collection\(rq\&. For MySQL 5\&.1, Section\ \&7.4.7, \(lqMyISAM Index Statistics Collection\(rq\&.
stats_method
was added in MySQL 5\&.0\&.14\&. For older versions, the statistics collection method is equivalent to
nulls_equal\&.
.PP
The
ft_min_word_len
and
ft_max_word_len
variables are available as of MySQL 4\&.0\&.0\&.
ft_stopword_file
is available as of MySQL 4\&.0\&.19\&.
.PP .PP
ft_min_word_len ft_min_word_len
and and
...@@ -824,7 +817,7 @@ file as ...@@ -824,7 +817,7 @@ file as
\fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR \fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR
.sp .sp
The directory where character sets are installed\&. See The directory where character sets are installed\&. See
Section\ \&9.2, \(lqThe Character Set Used for Data and Sorting\(rq\&. Section\ \&9.5, \(lqCharacter Set Configuration\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -981,7 +974,7 @@ and ...@@ -981,7 +974,7 @@ and
\fB\-\-quick\fR, \fB\-\-quick\fR,
\fB\-q\fR \fB\-q\fR
.sp .sp
Achieve a faster repair by not modifying the data file\&. You can specify this option twice to force Achieve a faster repair by modifying only the index file, not the data file\&. You can specify this option twice to force
\fBmyisamchk\fR \fBmyisamchk\fR
to modify the original data file in case of duplicate keys\&. to modify the original data file in case of duplicate keys\&.
.RE .RE
...@@ -1469,7 +1462,11 @@ The format used to store table rows\&. The preceding examples use ...@@ -1469,7 +1462,11 @@ The format used to store table rows\&. The preceding examples use
Fixed length\&. Other possible values are Fixed length\&. Other possible values are
Compressed Compressed
and and
Packed\&. Packed\&. (Packed
corresponds to what
SHOW TABLE STATUS
reports as
Dynamic\&.)
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1585,7 +1582,7 @@ The number of rows in the table\&. ...@@ -1585,7 +1582,7 @@ The number of rows in the table\&.
Deleted blocks Deleted blocks
.sp .sp
How many deleted blocks still have reserved space\&. You can optimize your table to minimize this space\&. See How many deleted blocks still have reserved space\&. You can optimize your table to minimize this space\&. See
Section\ \&6.4.4, \(lqTable Optimization\(rq\&. Section\ \&6.6.4, \(lqMyISAM Table Optimization\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1613,7 +1610,7 @@ Data records\&. ...@@ -1613,7 +1610,7 @@ Data records\&.
Deleted data Deleted data
.sp .sp
How many bytes of unreclaimed deleted data there are\&. You can optimize your table to minimize this space\&. See How many bytes of unreclaimed deleted data there are\&. You can optimize your table to minimize this space\&. See
Section\ \&6.4.4, \(lqTable Optimization\(rq\&. Section\ \&6.6.4, \(lqMyISAM Table Optimization\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -2100,7 +2097,7 @@ The number of rows in the table\&. ...@@ -2100,7 +2097,7 @@ The number of rows in the table\&.
Deleted blocks Deleted blocks
.sp .sp
How many deleted blocks still have reserved space\&. You can optimize your table to minimize this space\&. See How many deleted blocks still have reserved space\&. You can optimize your table to minimize this space\&. See
Section\ \&6.4.4, \(lqTable Optimization\(rq\&. Section\ \&6.6.4, \(lqMyISAM Table Optimization\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -2238,7 +2235,7 @@ What percentage of the data file is unused\&. ...@@ -2238,7 +2235,7 @@ What percentage of the data file is unused\&.
Blocks/Record Blocks/Record
.sp .sp
Average number of blocks per row (that is, how many links a fragmented row is composed of)\&. This is always 1\&.0 for fixed\-format tables\&. This value should stay as close to 1\&.0 as possible\&. If it gets too large, you can reorganize the table\&. See Average number of blocks per row (that is, how many links a fragmented row is composed of)\&. This is always 1\&.0 for fixed\-format tables\&. This value should stay as close to 1\&.0 as possible\&. If it gets too large, you can reorganize the table\&. See
Section\ \&6.4.4, \(lqTable Optimization\(rq\&. Section\ \&6.6.4, \(lqMyISAM Table Optimization\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -2447,7 +2444,7 @@ instead of ...@@ -2447,7 +2444,7 @@ instead of
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/myisamlog.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmyisamlog\fR .\" Title: \fBmyisamlog\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYISAMLOG\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYISAMLOG\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -225,7 +225,7 @@ Display version information\&. ...@@ -225,7 +225,7 @@ Display version information\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/myisampack.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmyisampack\fR .\" Title: \fBmyisampack\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYISAMPACK\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYISAMPACK\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -100,7 +100,7 @@ to rebuild its indexes\&. ...@@ -100,7 +100,7 @@ to rebuild its indexes\&.
\fBmyisamchk\fR(1)\&. \fBmyisamchk\fR(1)\&.
.PP .PP
\fBmyisampack\fR \fBmyisampack\fR
supports the options in the following list\&. It also reads option files and supports the options for processing them described at supports the following options\&. It also reads option files and supports the options for processing them described at
Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&. Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&.
.sp .sp
.RS 4 .RS 4
...@@ -149,7 +149,7 @@ Make a backup of each table\'s data file using the name ...@@ -149,7 +149,7 @@ Make a backup of each table\'s data file using the name
\fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR \fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR
.sp .sp
The directory where character sets are installed\&. See The directory where character sets are installed\&. See
Section\ \&9.2, \(lqThe Character Set Used for Data and Sorting\(rq\&. Section\ \&9.5, \(lqCharacter Set Configuration\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -832,7 +832,7 @@ option to ...@@ -832,7 +832,7 @@ option to
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysql-stress-test.pl.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysql-stress-test.pl\fR .\" Title: \fBmysql-stress-test.pl\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 10/29/2009 .\" Date: 03/31/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL .\" Source: MySQL
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQL\-STRESS\-TE" "1" "10/29/2009" "MySQL" "MySQL Database System" .TH "\FBMYSQL\-STRESS\-TE" "1" "03/31/2010" "MySQL" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -75,9 +75,9 @@ Display a help message and exit\&. ...@@ -75,9 +75,9 @@ Display a help message and exit\&.
.\} .\}
.\" mysql-stress-test.pl: abort-on-error option .\" mysql-stress-test.pl: abort-on-error option
.\" abort-on-error option: mysql-stress-test.pl .\" abort-on-error option: mysql-stress-test.pl
\fB\-\-abort\-on\-error\fR \fB\-\-abort\-on\-error=\fR\fB\fIN\fR\fR
.sp .sp
Unknown\&. Causes the program to abort if an error with severity less than or equal to N was encountered\&. Set to 1 to abort on any error\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -169,7 +169,8 @@ program\&. ...@@ -169,7 +169,8 @@ program\&.
.\" server-database option: mysql-stress-test.pl .\" server-database option: mysql-stress-test.pl
\fB\-\-server\-database=\fR\fB\fIdb_name\fR\fR \fB\-\-server\-database=\fR\fB\fIdb_name\fR\fR
.sp .sp
The database to use for the tests\&. The database to use for the tests\&. The default is
test\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -333,7 +334,7 @@ option\&. ...@@ -333,7 +334,7 @@ option\&.
\fB\-\-stress\-init\-file[=\fR\fB\fIpath\fR\fR\fB]\fR \fB\-\-stress\-init\-file[=\fR\fB\fIpath\fR\fR\fB]\fR
.sp .sp
\fIfile_name\fR \fIfile_name\fR
is the location of the file that contains the list of tests\&. If missing, the default file is is the location of the file that contains the list of tests to be run once to initialize the database for the testing\&. If missing, the default file is
stress_init\&.txt stress_init\&.txt
in the test suite directory\&. in the test suite directory\&.
.RE .RE
...@@ -464,21 +465,6 @@ The duration of stress testing in seconds\&. ...@@ -464,21 +465,6 @@ The duration of stress testing in seconds\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-stress-test.pl: test-suffix option
.\" test-suffix option: mysql-stress-test.pl
\fB\-\-test\-suffix=\fR\fB\fIstr\fR\fR
.sp
Unknown\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: threads option .\" mysql-stress-test.pl: threads option
.\" threads option: mysql-stress-test.pl .\" threads option: mysql-stress-test.pl
\fB\-\-threads=\fR\fB\fIN\fR\fR \fB\-\-threads=\fR\fB\fIN\fR\fR
...@@ -503,7 +489,7 @@ Verbose mode\&. Print more information about what the program does\&. ...@@ -503,7 +489,7 @@ Verbose mode\&. Print more information about what the program does\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright \(co 2007, 2010, Oracle and/or its affiliates. All rights reserved.
.PP .PP
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. 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.
.PP .PP
......
man/mysql-test-run.pl.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysql-test-run.pl\fR .\" Title: \fBmysql-test-run.pl\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 10/29/2009 .\" Date: 03/31/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL .\" Source: MySQL
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQL\-TEST\-RUN\" "1" "10/29/2009" "MySQL" "MySQL Database System" .TH "\FBMYSQL\-TEST\-RUN\" "1" "03/31/2010" "MySQL" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -30,8 +30,7 @@ The ...@@ -30,8 +30,7 @@ The
\fBmysql\-test\-run\&.pl\fR \fBmysql\-test\-run\&.pl\fR
Perl script is the main application used to run the MySQL test suite\&. It invokes Perl script is the main application used to run the MySQL test suite\&. It invokes
\fBmysqltest\fR \fBmysqltest\fR
to run individual test cases\&. (Prior to MySQL 4\&.1, a similar shell script, to run individual test cases\&.
\fBmysql\-test\-run\fR, can be used instead\&.)
.PP .PP
Invoke Invoke
\fBmysql\-test\-run\&.pl\fR \fBmysql\-test\-run\&.pl\fR
...@@ -84,7 +83,7 @@ shell> \fBmysql\-test\-run\&.pl t/mytest\&.test\fR ...@@ -84,7 +83,7 @@ shell> \fBmysql\-test\-run\&.pl t/mytest\&.test\fR
.RE .RE
.\} .\}
.PP .PP
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: A suite name can be given as part of the test name\&. That is, the syntax for naming a test is:
.sp .sp
.if n \{\ .if n \{\
.RS 4 .RS 4
...@@ -98,7 +97,14 @@ As of MySQL 5\&.1\&.23, a suite name can be given as part of the test name\&. Th ...@@ -98,7 +97,14 @@ As of MySQL 5\&.1\&.23, a suite name can be given as part of the test name\&. Th
.PP .PP
If a suite name is given, If a suite name is given,
\fBmysql\-test\-run\&.pl\fR \fBmysql\-test\-run\&.pl\fR
looks in that suite for the test\&. With no suite name, looks in that suite for the test\&. The test file corresponding to a test named
\fIsuite_name\&.test_name\fR
is found in
suite/\fIsuite_name\fR/t/\fItest_name\fR\&.test\&. There is also an implicit suite name
main
for the tests in the top
t
directory\&. With no suite name,
\fBmysql\-test\-run\&.pl\fR \fBmysql\-test\-run\&.pl\fR
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 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
main, main,
...@@ -131,11 +137,11 @@ rpl)\&. ...@@ -131,11 +137,11 @@ rpl)\&.
\fB\-\-skip\-test\fR \fB\-\-skip\-test\fR
has the opposite effect of skipping test cases for which the names share a common prefix\&. has the opposite effect of skipping test cases for which the names share a common prefix\&.
.PP .PP
As of MySQL 5\&.0\&.54/5\&.1\&.23/6\&.0\&.5, the argument for the The argument for the
\fB\-\-do\-test\fR \fB\-\-do\-test\fR
and and
\fB\-\-skip\-test\fR \fB\-\-skip\-test\fR
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, options also 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,
\fB\-\-do\-test=testa\fR \fB\-\-do\-test=testa\fR
matches tests that begin with matches tests that begin with
testa, testa,
...@@ -150,7 +156,7 @@ main ...@@ -150,7 +156,7 @@ main
followed by followed by
testa testa
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 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
xmainytestz\&. xmainytesta\&.
.PP .PP
To perform setup prior to running tests, To perform setup prior to running tests,
\fBmysql\-test\-run\&.pl\fR \fBmysql\-test\-run\&.pl\fR
...@@ -160,8 +166,7 @@ with the ...@@ -160,8 +166,7 @@ with the
\fB\-\-bootstrap\fR \fB\-\-bootstrap\fR
and and
\fB\-\-skip\-grant\-tables\fR \fB\-\-skip\-grant\-tables\fR
options (see options\&. If MySQL was configured with the
\m[blue]\fBTypical \fBconfigure\fR Options\fR\m[]\&\s-2\u[1]\d\s+2)\&. If MySQL was configured with the
\fB\-\-disable\-grant\-options\fR \fB\-\-disable\-grant\-options\fR
option, option,
\fB\-\-bootstrap\fR, \fB\-\-bootstrap\fR,
...@@ -217,28 +222,11 @@ shell> \fB\&./mysqltest\-run\&.pl \-\-force \-\-timer \-\-ps\-protocol\fR ...@@ -217,28 +222,11 @@ shell> \fB\&./mysqltest\-run\&.pl \-\-force \-\-timer \-\-ps\-protocol\fR
.RE .RE
.\} .\}
.PP .PP
If you have a copy of
\fBmysqld\fR
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
9306
or
9307\&. If either of those ports is taken, you should set the
MTR_BUILD_THREAD
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:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBexport MTR_BUILD_THREAD=31\fR
shell> \fB\&./mysql\-test\-run\&.pl [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fItest_name\fR\fR\fB]\fR
.fi
.if n \{\
.RE
.\}
.PP
\fBmysql\-test\-run\&.pl\fR \fBmysql\-test\-run\&.pl\fR
defines several environment variables\&. Some of them are listed in the following table\&. uses several environment variables\&. Some of them are listed in the following table\&. Some of these are set from the outside and used by
\fBmysql\-test\-run\&.pl\fR, others are set by
\fBmysql\-test\-run\&.pl\fR
instead, and may be referred to in tests\&.
.TS .TS
allbox tab(:); allbox tab(:);
l l l l
...@@ -246,6 +234,12 @@ l l ...@@ -246,6 +234,12 @@ l l
l l l l
l l l l
l l l l
l l
l l
l l
l l
l l
l l
l l. l l.
T{ T{
\fBVariable\fR \fBVariable\fR
...@@ -253,15 +247,52 @@ T}:T{ ...@@ -253,15 +247,52 @@ T}:T{
\fBMeaning\fR \fBMeaning\fR
T} T}
T{ T{
MYSQL_TEST MTR_VERSION
T}:T{ T}:T{
Path name to \fBmysqltest\fR binary If set to 1, will run the older version 1 of
\fBmysql\-test\-run\&.pl\fR\&. This will affect
what functionailty is available and what command line
options are supported\&.
T} T}
T{ T{
MYSQLTEST_VARDIR MTR_MEM
T}:T{ T}:T{
Path name to the var directory that is used for If set to anything, will run tests with files in "memory" using tmpfs or
logs, temporary files, and so forth ramdisk\&. Not available on Windows\&. Same as
\fB\-\-mem\fR option
T}
T{
MTR_PARALLEL
T}:T{
If set, defines number of parallel threads executing tests\&. Same as
\fB\-\-parallel\fR option
T}
T{
MTR_BUILD_THREAD
T}:T{
If set, defines which port number range is used for the server
T}
T{
MTR_PORT_BASE
T}:T{
If set, defines which port number range is used for the server
T}
T{
MTR_\fINAME\fR_TIMEOUT
T}:T{
Setting of a timeout in minutes or seconds, corresponding to command
line option
\fB\-\-\fR\fB\fIname\fR\fR\fB\-timeout\fR\&.
Avaliable timeout names are TESTCASE,
SUITE (both in minutes) and
START, SHUTDOWN
(both in seconds)\&. These variables are supported from
MySQL 5\&.1\&.44\&.
T}
T{
MYSQL_TEST
T}:T{
Path name to \fBmysqltest\fR binary
T} T}
T{ T{
MYSQLD_BOOTSTRAP MYSQLD_BOOTSTRAP
...@@ -269,18 +300,31 @@ T}:T{ ...@@ -269,18 +300,31 @@ T}:T{
Full path name to \fBmysqld\fR that has all options enabled Full path name to \fBmysqld\fR that has all options enabled
T} T}
T{ T{
MASTER_MYPORT MYSQLTEST_VARDIR
T}:T{
Path name to the var directory that is used for
logs, temporary files, and so forth
T}
T{
MYSQL_TEST_DIR
T}:T{ T}:T{
??? Full path to the mysql\-test directory where tests
are being run from
T} T}
T{ T{
MASTER_MYSOCK MYSQL_TMP_DIR
T}:T{ T}:T{
??? Path to temp directory used for temporary files during tests
T} T}
.TE .TE
.sp 1 .sp 1
.PP .PP
The variable
MTR_PORT_BASE
was added in MySQL 5\&.1\&.45 as a more logical replacement for
MTR_BUILD_THREAD\&. It gives the actual port number directly (will be rounded down to a multiple of 10)\&. If you use
MTR_BUILD_THREAD, the port number is found by multiplying this by 10 and adding 10000\&.
.PP
Tests sometimes rely on certain environment variables being defined\&. For example, certain tests assume that Tests sometimes rely on certain environment variables being defined\&. For example, certain tests assume that
MYSQL_TEST MYSQL_TEST
is defined so that is defined so that
...@@ -288,16 +332,23 @@ is defined so that ...@@ -288,16 +332,23 @@ is defined so that
can invoke itself with can invoke itself with
exec $MYSQL_TEST\&. exec $MYSQL_TEST\&.
.PP .PP
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
$MYSQL_TMP_DIR/\fIfile_name\fR\&.
.PP
If you are running
\fBmysql\-test\-run\&.pl\fR
version 1 by setting
MTR_VERSION, note that this only affects the test driver, not the test client (and its language) or the tests themselves\&.
.PP
A few tests might not run with version 1 because they depend on some feature of version 2\&. You may have those tests skipped by adding the test name to the file
lib/v1/incompatible\&.tests\&. This feature is available from MySQL 5\&.1\&.40\&.
.PP
\fBmysql\-test\-run\&.pl\fR \fBmysql\-test\-run\&.pl\fR
supports the options in the following list\&. An argument of supports the options in the following list\&. An argument of
\fB\-\-\fR \fB\-\-\fR
tells tells
\fBmysql\-test\-run\&.pl\fR \fBmysql\-test\-run\&.pl\fR
not to process any following arguments as options\&. (A description of differences between the options supported by not to process any following arguments as options\&.
\fBmysql\-test\-run\&.pl\fR
and
\fBmysql\-test\-run\fR
appears following the list\&.)
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
...@@ -323,11 +374,16 @@ Display a help message and exit\&. ...@@ -323,11 +374,16 @@ Display a help message and exit\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: bench option .\" mysql-test-run.pl: big-test option
.\" bench option: mysql-test-run.pl .\" big-test option: mysql-test-run.pl
\fB\-\-bench\fR \fB\-\-big\-test\fR
.sp .sp
Run the benchmark suite\&. Allow tests marked as "big" to run\&. Tests can be thus marked by including the line
\fB\-\-source include/big_test\&.inc\fR, and they will only be run if this option is given, or if the environment variable
BIG_TEST
is set to 1\&.
.sp
This is typically done for tests that take very long to run, or that use very much resources, so that they are not suitable for running as part of a normal test suite run\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -338,12 +394,25 @@ Run the benchmark suite\&. ...@@ -338,12 +394,25 @@ Run the benchmark suite\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: benchdir option .\" mysql-test-run.pl: build-thread option
.\" benchdir option: mysql-test-run.pl .\" build-thread option: mysql-test-run.pl
\fB\-\-benchdir=\fR\fB\fIpath\fR\fR \fB\-\-build\-thread=\fR\fB\fInumber\fR\fR
.sp
Specify a number to calculate port numbers from\&. The formula is 10 *
\fIbuild_thread\fR
+ 10000\&. Instead of a number, it can be set to
auto, which is also the default value, in which case
\fBmysql\-test\-run\&.pl\fR
will allocate a number unique to this host\&.
.sp
The value (number or
auto) can also be set with the
MTR_BUILD_THREAD
environment variable\&.
.sp .sp
The directory where the benchmark suite is located\&. The default path is From MySQL 5\&.1\&.45, the more logical
\&.\&./\&.\&./mysql\-bench\&. \fB\-\-port\-base\fR
is supported as an alternative\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -354,14 +423,14 @@ The directory where the benchmark suite is located\&. The default path is ...@@ -354,14 +423,14 @@ The directory where the benchmark suite is located\&. The default path is
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: big option .\" mysql-test-run.pl: callgrind option
.\" big option: mysql-test-run.pl .\" callgrind option: mysql-test-run.pl
\fB\-\-big\-test\fR \fB\-\-callgrind\fR
.sp .sp
Pass the Instructs
\fB\-\-big\-test\fR \fBvalgrind\fR
option to to use
\fBmysqltest\fR\&. \fBcallgrind\fR\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -376,7 +445,7 @@ option to ...@@ -376,7 +445,7 @@ option to
.\" check-testcases option: mysql-test-run.pl .\" check-testcases option: mysql-test-run.pl
\fB\-\-check\-testcases\fR \fB\-\-check\-testcases\fR
.sp .sp
Check test cases for side effects\&. Check test cases for side effects\&. This is done by checking system state before and after each test case; if there is any difference, a warning to that effect will be written, but the test case will not be marked as failed because of it\&. This check is enabled by default\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -389,9 +458,9 @@ Check test cases for side effects\&. ...@@ -389,9 +458,9 @@ Check test cases for side effects\&.
.\} .\}
.\" mysql-test-run.pl: client-bindir option .\" mysql-test-run.pl: client-bindir option
.\" client-bindir option: mysql-test-run.pl .\" client-bindir option: mysql-test-run.pl
\fB\-\-client\-bindir\fR \fB\-\-client\-bindir=\fR\fB\fIpath\fR\fR
.sp .sp
The path to the directory where client binaries are located\&. This option was added in MySQL 5\&.0\&.66/5\&.1\&.27\&. The path to the directory where client binaries are located\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -423,7 +492,7 @@ debugger\&. ...@@ -423,7 +492,7 @@ debugger\&.
.\} .\}
.\" mysql-test-run.pl: client-debugger option .\" mysql-test-run.pl: client-debugger option
.\" client-debugger option: mysql-test-run.pl .\" client-debugger option: mysql-test-run.pl
\fB\-\-client\-debugger\fR \fB\-\-client\-debugger=\fR\fB\fIdebugger\fR\fR
.sp .sp
Start Start
\fBmysqltest\fR \fBmysqltest\fR
...@@ -459,9 +528,9 @@ debugger\&. ...@@ -459,9 +528,9 @@ debugger\&.
.\} .\}
.\" mysql-test-run.pl: client-libdir option .\" mysql-test-run.pl: client-libdir option
.\" client-libdir option: mysql-test-run.pl .\" client-libdir option: mysql-test-run.pl
\fB\-\-client\-libdir\fR \fB\-\-client\-libdir=\fR\fB\fIpath\fR\fR
.sp .sp
The path to the directory where client libraries are located\&. This option was added in MySQL 5\&.0\&.66/5\&.1\&.27\&. The path to the directory where client libraries are located\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -493,8 +562,6 @@ is to create a ...@@ -493,8 +562,6 @@ is to create a
combinations combinations
file in the suite directory\&. The file should contain a section of options for each test run\&. See file in the suite directory\&. The file should contain a section of options for each test run\&. See
Section\ \&4.9, \(lqPassing Options from mysql-test-run.pl to mysqld or mysqltest\(rq\&. Section\ \&4.9, \(lqPassing Options from mysql-test-run.pl to mysqld or mysqltest\(rq\&.
.sp
This option was added in MySQL 5\&.1\&.23/6\&.0\&.4\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -511,7 +578,8 @@ This option was added in MySQL 5\&.1\&.23/6\&.0\&.4\&. ...@@ -511,7 +578,8 @@ This option was added in MySQL 5\&.1\&.23/6\&.0\&.4\&.
.sp .sp
Write Write
\fIstr\fR \fIstr\fR
to the output\&. to the output within lines filled with
#, as a form of banner\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -593,7 +661,7 @@ Dump trace output for all clients and servers\&. ...@@ -593,7 +661,7 @@ Dump trace output for all clients and servers\&.
.\} .\}
.\" mysql-test-run.pl: debugger option .\" mysql-test-run.pl: debugger option
.\" debugger option: mysql-test-run.pl .\" debugger option: mysql-test-run.pl
\fB\-\-debugger\fR \fB\-\-debugger=\fR\fB\fIdebugger\fR\fR
.sp .sp
Start Start
\fBmysqld\fR \fBmysqld\fR
...@@ -627,7 +695,37 @@ does not fail if Debug Sync is not compiled in\&. ...@@ -627,7 +695,37 @@ does not fail if Debug Sync is not compiled in\&.
For information about using the Debug Sync facility for testing, see For information about using the Debug Sync facility for testing, see
Section\ \&4.14, \(lqThread Synchronization in Test Cases\(rq\&. Section\ \&4.14, \(lqThread Synchronization in Test Cases\(rq\&.
.sp .sp
This option was added in MySQL 5\&.4\&.4/6\&.0\&.6\&. This option was added in MySQL 5\&.1\&.41/5\&.5\&.0/6\&.0\&.6\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: defaults-file option
.\" default-file option: mysql-test-run.pl
\fB\-\-defaults\-file=\fR\fB\fIfile_name\fR\fR
.sp
Use the named file as fixed config file template for all tests\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: defaults_extra_file option
.\" default_extra_file option: mysql-test-run.pl
\fB\-\-defaults_extra_file=\fR\fB\fIfile_name\fR\fR
.sp
Add setting from the named file to all generated configs\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -646,9 +744,9 @@ Run all test cases having a name that begins with the given ...@@ -646,9 +744,9 @@ Run all test cases having a name that begins with the given
\fIprefix\fR \fIprefix\fR
value\&. This option provides a convenient way to run a family of similarly named tests\&. value\&. This option provides a convenient way to run a family of similarly named tests\&.
.sp .sp
As of MySQL 5\&.0\&.54/5\&.1\&.23/6\&.0\&.5, the argument for the The argument for the
\fB\-\-do\-test\fR \fB\-\-do\-test\fR
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, option also 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,
\fB\-\-do\-test=testa\fR \fB\-\-do\-test=testa\fR
matches tests that begin with matches tests that begin with
testa, testa,
...@@ -691,6 +789,23 @@ built with the embedded server\&. ...@@ -691,6 +789,23 @@ built with the embedded server\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: enable-disabled option
.\" enable-disabled option: mysql-test-run.pl
\fB\-\-enable\-disabled\fR
.sp
Ignore any
disabled\&.def
file, and run also tests marked as disbaled\&. Success or failure of those tests will be reported the same way as other tests\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: experimental option .\" mysql-test-run.pl: experimental option
.\" experimental option: mysql-test-run.pl .\" experimental option: mysql-test-run.pl
\fB\-\-experimental=\fR\fB\fIfile_name\fR\fR \fB\-\-experimental=\fR\fB\fIfile_name\fR\fR
...@@ -699,7 +814,7 @@ Specify a file that contains a list of test cases that should be displayed with ...@@ -699,7 +814,7 @@ Specify a file that contains a list of test cases that should be displayed with
[ exp\-fail ] [ exp\-fail ]
code rather than code rather than
[ fail ] [ fail ]
if they fail\&. This option was added in MySQL 5\&.1\&.33/6\&.0\&.11\&. if they fail\&. This option was added in MySQL 5\&.1\&.33\&.
.sp .sp
For an example of a file that might be specified via this option, see For an example of a file that might be specified via this option, see
mysql\-test/collections/default\&.experimental\&. mysql\-test/collections/default\&.experimental\&.
...@@ -716,8 +831,25 @@ mysql\-test/collections/default\&.experimental\&. ...@@ -716,8 +831,25 @@ mysql\-test/collections/default\&.experimental\&.
.\" mysql-test-run.pl: extern option .\" mysql-test-run.pl: extern option
.\" extern option: mysql-test-run.pl .\" extern option: mysql-test-run.pl
\fB\-\-extern\fR \fB\-\-extern\fR
\fIoption\fR=\fIvalue\fR
.sp
Use an already running server\&. The option/value pair is what is needed by the
\fBmysql\fR
client to connect to the server\&. Each
\fB\-\-extern\fR
can only take one option/value pair as argument, so it you need more you need to repeat
\fB\-\-extern\fR
for each of them\&. Example:
.sp .sp
Use an already running server\&. .if n \{\
.RS 4
.\}
.nf
\&./mysql\-test\-run\&.pl \-\-extern socket=var/tmp/mysqld\&.1\&.sock alias
.fi
.if n \{\
.RE
.\}
.sp .sp
Note: If a test case has an Note: If a test case has an
\&.opt \&.opt
...@@ -736,7 +868,8 @@ file that requires the server to be restarted with specific options, the file wi ...@@ -736,7 +868,8 @@ file that requires the server to be restarted with specific options, the file wi
.\" fast option: mysql-test-run.pl .\" fast option: mysql-test-run.pl
\fB\-\-fast\fR \fB\-\-fast\fR
.sp .sp
Do not clean up from earlier test runs\&. Do not perform controlled shutdown when servers need to be restarted or at the end of the test run\&. This is equivalent to using
\-\-shutdown\-timeout=0\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -809,6 +942,8 @@ debugger\&. ...@@ -809,6 +942,8 @@ debugger\&.
Run tests with the Run tests with the
\fBgprof\fR \fBgprof\fR
profiling tool\&. profiling tool\&.
\fB\-\-gprof\fR
was added in 5\&.1\&.45\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -819,12 +954,13 @@ profiling tool\&. ...@@ -819,12 +954,13 @@ profiling tool\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: im-mysqld1-port option .\" mysql-test-run.pl: manual-ddd option
.\" im-mysqld1-port option: mysql-test-run.pl .\" manual-ddd option: mysql-test-run.pl
\fB\-\-im\-mysqld1\-port\fR \fB\-\-manual\-ddd\fR
.sp .sp
TCP/IP port number to use for the first Use a server that has already been started by the user in the
\fBmysqld\fR, controlled by Instance Manager\&. \fBddd\fR
debugger\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -835,12 +971,11 @@ TCP/IP port number to use for the first ...@@ -835,12 +971,11 @@ TCP/IP port number to use for the first
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: im-mysqld2-port option .\" mysql-test-run.pl: manual-debug option
.\" im-mysqld2-port option: mysql-test-run.pl .\" manual-debug option: mysql-test-run.pl
\fB\-\-im\-mysqld2\-port\fR \fB\-\-manual\-debug\fR
.sp .sp
TCP/IP port number to use for the second Use a server that has already been started by the user in a debugger\&.
\fBmysqld\fR, controlled by Instance Manager\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -851,12 +986,13 @@ TCP/IP port number to use for the second ...@@ -851,12 +986,13 @@ TCP/IP port number to use for the second
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: im-port option .\" mysql-test-run.pl: manual-gdb option
.\" im-port option: mysql-test-run.pl .\" manual-gdb option: mysql-test-run.pl
\fB\-\-im\-port\fR \fB\-\-manual\-gdb\fR
.sp .sp
TCP/IP port number to use for Use a server that has already been started by the user in the
\fBmysqld\fR, controlled by Instance Manager\&. \fBgdb\fR
debugger\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -867,14 +1003,12 @@ TCP/IP port number to use for ...@@ -867,14 +1003,12 @@ TCP/IP port number to use for
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: log-warnings option .\" mysql-test-run.pl: mark-progress option
.\" log-warnings option: mysql-test-run.pl .\" mark-progress option: mysql-test-run.pl
\fB\-\-log\-warnings\fR \fB\-\-mark\-progress\fR
.sp .sp
Pass the Marks progress with timing (in milliseconds) and line number in
\fB\-\-log\-warnings\fR var/log/\fItestname\fR\&.progress\&.
option to
\fBmysqld\fR\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -885,11 +1019,14 @@ option to ...@@ -885,11 +1019,14 @@ option to
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: manual-debug option .\" mysql-test-run.pl: max-connections option
.\" manual-debug option: mysql-test-run.pl .\" max-connections option: mysql-test-run.pl
\fB\-\-manual\-debug\fR \fB\-\-max\-connections=\fR\fB\fInum\fR\fR
.sp .sp
Use a server that has already been started by the user in a debugger\&. The maximum number of simultaneous server connections that may be used per test\&. If not set, the maximum is 128\&. Minimum allowed limit is 8, maximum is 5120\&. Corresponds to the same option for
\fBmysqltest\fR\&.
.sp
This option is available from MySQL 5\&.1\&.45\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -900,13 +1037,12 @@ Use a server that has already been started by the user in a debugger\&. ...@@ -900,13 +1037,12 @@ Use a server that has already been started by the user in a debugger\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: manual-gdb option .\" mysql-test-run.pl: max-save-core option
.\" manual-gdb option: mysql-test-run.pl .\" max-save-core option: mysql-test-run.pl
\fB\-\-manual\-gdb\fR \fB\-\-max\-save\-core=\fR\fB\fIN\fR\fR
.sp .sp
Use a server that has already been started by the user in the Limit the number of core files saved, to avoid filling up disks in case of a frequently crashing server\&. Defaults to 5, set to 0 for no limit\&. May also be set with the environment variable
\fBgdb\fR MTR_MAX_SAVE_CORE
debugger\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -917,13 +1053,12 @@ debugger\&. ...@@ -917,13 +1053,12 @@ debugger\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: master-binary option .\" mysql-test-run.pl: max-save-datadir option
.\" master-binary option: mysql-test-run.pl .\" max-save-datadir option: mysql-test-run.pl
\fB\-\-master\-binary=\fR\fB\fIpath\fR\fR \fB\-\-max\-save\-datadir=\fR\fB\fIN\fR\fR
.sp .sp
Specify the path of the Limit the number of data directories saved after failed tests, to avoid filling up disks in case of frequent failures\&. Defaults to 20, set to 0 for no limit\&. May also be set with the environment variable
\fBmysqld\fR MTR_MAX_SAVE_DATADIR
binary to use for master servers\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -934,11 +1069,12 @@ binary to use for master servers\&. ...@@ -934,11 +1069,12 @@ binary to use for master servers\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: master_port option .\" mysql-test-run.pl: max-test-fail option
.\" master_port option: mysql-test-run.pl .\" max-test-fail option: mysql-test-run.pl
\fB\-\-master_port=\fR\fB\fIport_num\fR\fR \fB\-\-max\-test\-fail=\fR\fB\fIN\fR\fR
.sp .sp
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\&. Stop execution after the specified number of tests have failed, to avoid using up resources (and time) in case of massive failures\&. retries are noe counted, nor are failures of tests marked experimental\&. Defaults to 10, set to 0 for no limit\&. May also be set with the environment variable
MTR_MAX_TEST_FAIL
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -953,7 +1089,9 @@ Specify the TCP/IP port number for the first master server to use\&. Observe tha ...@@ -953,7 +1089,9 @@ Specify the TCP/IP port number for the first master server to use\&. Observe tha
.\" mem option: mysql-test-run.pl .\" mem option: mysql-test-run.pl
\fB\-\-mem\fR \fB\-\-mem\fR
.sp .sp
Run the test suite in memory, using tmpfs or ramdisk\&. This can decrease test times significantly\&. This option is not supported on Windows\&.
.sp
Run the test suite in memory, using tmpfs or ramdisk\&. This can decrease test times significantly, in particular if you would otherwise be running over a remote file system\&.
\fBmysql\-test\-run\&.pl\fR \fBmysql\-test\-run\&.pl\fR
attempts to find a suitable location using a built\-in list of standard locations for tmpfs and puts the attempts to find a suitable location using a built\-in list of standard locations for tmpfs and puts the
var var
...@@ -966,7 +1104,14 @@ MTR_MEM[=\fIdir_name\fR]\&. If ...@@ -966,7 +1104,14 @@ MTR_MEM[=\fIdir_name\fR]\&. If
\fIdir_name\fR \fIdir_name\fR
is given, it is added to the beginning of the list of locations to search, so it takes precedence over any built\-in locations\&. is given, it is added to the beginning of the list of locations to search, so it takes precedence over any built\-in locations\&.
.sp .sp
This option was added in MySQL 4\&.1\&.22, 5\&.0\&.30, and 5\&.1\&.13\&. Once you have run tests with
\fB\-\-mem\fR
within a
mysql\-testdirectory, a soflink
var
will have been set up to the temporary directory, and this will be re\-used the next time, until the soflink is deleted\&. Thus, you do not have to repeat the
\fB\-\-mem\fR
option next time\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -996,25 +1141,6 @@ Section\ \&4.9, \(lqPassing Options from mysql-test-run.pl to mysqld or mysqltes ...@@ -996,25 +1141,6 @@ Section\ \&4.9, \(lqPassing Options from mysql-test-run.pl to mysqld or mysqltes
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: mysqltest option
.\" mysqltest option: mysql-test-run.pl
\fB\-\-mysqltest=\fR\fB\fIvalue\fR\fR
.sp
Extra options to pass to
\fBmysqltest\fR\&. The value should consist of one or more comma\-separated
\fBmysqltest\fR
options\&. See
Section\ \&4.9, \(lqPassing Options from mysql-test-run.pl to mysqld or mysqltest\(rq\&. This option was added in MySQL 6\&.0\&.6\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: ndb-connectstring option .\" mysql-test-run.pl: ndb-connectstring option
.\" ndb-connectstring option: mysql-test-run.pl .\" ndb-connectstring option: mysql-test-run.pl
\fB\-\-ndb\-connectstring=\fR\fB\fIstr\fR\fR \fB\-\-ndb\-connectstring=\fR\fB\fIstr\fR\fR
...@@ -1034,15 +1160,13 @@ from starting a cluster\&. It is assumed that there is already a cluster running ...@@ -1034,15 +1160,13 @@ from starting a cluster\&. It is assumed that there is already a cluster running
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: ndb-connectstring-slave option .\" mysql-test-run.pl: nocheck-testcases option
.\" ndb-connectstring-slave option: mysql-test-run.pl .\" nocheck-testcases option: mysql-test-run.pl
\fB\-\-ndb\-connectstring\-slave=\fR\fB\fIstr\fR\fR \fB\-\-nocheck\-testcases\fR
.sp .sp
Pass Disable the check for test case side effects; see
\fB\-\-ndb\-connectstring=\fR\fB\fIstr\fR\fR \fB\-\-check\-testcases\fR
to slave MySQL servers\&. This option also prevents for a description\&.
\fBmysql\-test\-run\&.pl\fR
from starting a cluster\&. It is assumed that there is already a cluster running to which the server can connect with the given connectstring\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1053,11 +1177,11 @@ from starting a cluster\&. It is assumed that there is already a cluster running ...@@ -1053,11 +1177,11 @@ from starting a cluster\&. It is assumed that there is already a cluster running
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: ndb-extra-test option .\" mysql-test-run.pl: noreorder option
.\" ndb-extra-test option: mysql-test-run.pl .\" noreorder option: mysql-test-run.pl
\fB\-\-ndb\-extra\-test\fR \fB\-\-noreorder\fR
.sp .sp
Unknown\&. 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\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1068,14 +1192,13 @@ Unknown\&. ...@@ -1068,14 +1192,13 @@ Unknown\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: ndbcluster-port option .\" mysql-test-run.pl: notimer option
.\" ndbcluster-port option: mysql-test-run.pl .\" notimer option: mysql-test-run.pl
.\" mysql-test-run.pl: ndbcluster_port option \fB\-\-notimer\fR
.\" ndbcluster_port option: mysql-test-run.pl
\fB\-\-ndbcluster\-port=\fR\fB\fIport_num\fR\fR,
\fB\-\-ndbcluster_port=\fR\fB\fIport_num\fR\fR
.sp .sp
Specify the TCP/IP port number that NDB Cluster should use\&. Cause
\fBmysqltest\fR
not to generate a timing file\&. The effect of this is that the report from each test case does not include the timing in milliseconds as it normally does\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1086,11 +1209,11 @@ Specify the TCP/IP port number that NDB Cluster should use\&. ...@@ -1086,11 +1209,11 @@ Specify the TCP/IP port number that NDB Cluster should use\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: ndbcluster-port-slave option .\" mysql-test-run.pl: nowarnings option
.\" ndbcluster-port-slave option: mysql-test-run.pl .\" nowarnings option: mysql-test-run.pl
\fB\-\-ndbcluster\-port\-slave=\fR\fB\fIport_num\fR\fR \fB\-\-nowarnings\fR
.sp .sp
Specify the TCP/IP port number that the slave NDB Cluster should use\&. Do not look for and report errors and warning in the server logs\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1101,13 +1224,16 @@ Specify the TCP/IP port number that the slave NDB Cluster should use\&. ...@@ -1101,13 +1224,16 @@ Specify the TCP/IP port number that the slave NDB Cluster should use\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: netware option .\" mysql-test-run.pl: parallel option
.\" netware option: mysql-test-run.pl .\" parallel option: mysql-test-run.pl
\fB\-\-netware\fR \fB\-\-parallel={\fR\fB\fIN\fR\fR\fB|auto}\fR
.sp .sp
Run Run tests using
\fBmysqld\fR \fIN\fR
with options needed on NetWare\&. parallel threads\&. By default, 1 thread is used\&. Use
\fB\-\-parallel=auto\fR
for auto\-setting of
\fIN\fR\&. The auto value was added in MySQL 5\&.1\&.36\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1118,13 +1244,24 @@ with options needed on NetWare\&. ...@@ -1118,13 +1244,24 @@ with options needed on NetWare\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: notimer option .\" mysql-test-run.pl: port-base option
.\" notimer option: mysql-test-run.pl .\" port-base option: mysql-test-run.pl
\fB\-\-notimer\fR \fB\-\-port\-base=\fR\fB\fIP\fR\fR
.sp .sp
Cause Specify base of port numbers to be used; a block of 10 will be allocated\&.
\fBmysqltest\fR \fIP\fR
not to generate a timing file\&. should be divisible by 10; if it is not, it will be rounded down\&. If running with more than one parallel test thread, thread 2 will use the next block of 10 and so on\&.
.sp
If the port number is given as
auto, which is also the default,
\fBmysql\-test\-run\&.pl\fRwill allocate a number unique to this host\&. The value may also be given with the environment variable
MTR_PORT_BASE\&.
.sp
\fB\-\-port\-base\fR
was added in MySQL 5\&.1\&.45 as a more logical alternative to
\fB\-\-build\-thread\fR\&. If both are used,
\fB\-\-port\-base\fR
takes presedence\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1135,16 +1272,11 @@ not to generate a timing file\&. ...@@ -1135,16 +1272,11 @@ not to generate a timing file\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: parallel option .\" mysql-test-run.pl: print-testcases option
.\" parallel option: mysql-test-run.pl .\" print-testcases option: mysql-test-run.pl
\fB\-\-parallel={\fR\fB\fIN\fR\fR\fB|auto}\fR \fB\-\-print\-testcases\fR
.sp .sp
Run tests using Do not run any tests, but print details about all tests, in the order they would have been run\&.
\fIN\fR
parallel threads\&. By default, 1 thread is used\&. Use
\fB\-\-parallel=auto\fR
for auto\-setting of
\fIN\fR\&. This option was added in MySQL 5\&.1\&.36\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1195,7 +1327,24 @@ option to ...@@ -1195,7 +1327,24 @@ option to
.\" reorder option: mysql-test-run.pl .\" reorder option: mysql-test-run.pl
\fB\-\-reorder\fR \fB\-\-reorder\fR
.sp .sp
Reorder tests to minimize the number of server restarts needed\&. Reorder tests to minimize the number of server restarts needed\&. This is the default behavior\&. There is no guarantee that a particular set of tests will always end up in the same order\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: repeat option
.\" repeat option: mysql-test-run.pl
\fB\-\-repeat=\fR\fB\fIN\fR\fR
.sp
Run each test
\fIN\fR
number of times\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1214,8 +1363,33 @@ Display the output of ...@@ -1214,8 +1363,33 @@ Display the output of
SHOW ENGINES SHOW ENGINES
and and
SHOW VARIABLES\&. This can be used to verify that binaries are built with all required features\&. SHOW VARIABLES\&. This can be used to verify that binaries are built with all required features\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: retry option
.\" retry option: mysql-test-run.pl
\fB\-\-retry=\fR\fB\fIN\fR\fR
.sp
If a test fails, it is retried up to a maximum of
\fIN\fR
runs, but will terminate after 2 failures\&. Default is 3, set to 1 or 0 for no retries\&. This option has no effect unless
\fB\-\-force\fR
is also used; without it, test execution will terminate after the first failure\&.
.sp .sp
This option was added in MySQL 4\&.1\&.23, 5\&.0\&.30, and 5\&.1\&.14\&. The
\fB\-\-retry\fR
and
\fB\-\-retry\-failure\fR
options do not affect how many times a test repeated with
\fB\-\-repeat\fR
may fail in total, as each repetition is considered a new test case, which may in turn be retried if it fails\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1226,13 +1400,11 @@ This option was added in MySQL 4\&.1\&.23, 5\&.0\&.30, and 5\&.1\&.14\&. ...@@ -1226,13 +1400,11 @@ This option was added in MySQL 4\&.1\&.23, 5\&.0\&.30, and 5\&.1\&.14\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: script-debug option .\" mysql-test-run.pl: retry-failure option
.\" script-debug option: mysql-test-run.pl .\" retry-failure option: mysql-test-run.pl
\fB\-\-script\-debug\fR \fB\-\-retry\-failure=\fR\fB\fIN\fR\fR
.sp .sp
Enable debug output for Allow a failed and retried test to fail more than the default 2 times before giving it up\&. Setting it to 0 or 1 effectively turns off retries
\fBmysql\-test\-run\&.pl\fR
itself\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1243,11 +1415,11 @@ itself\&. ...@@ -1243,11 +1415,11 @@ itself\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: skip-im option .\" mysql-test-run.pl: shutdown-timeout option
.\" skip-im option: mysql-test-run.pl .\" shutdown-timeout option: mysql-test-run.pl
\fB\-\-skip\-im\fR \fB\-\-shutdown\-timeout=\fR\fB\fISECONDS\fR\fR
.sp .sp
Do not start Instance Manager; skip Instance Manager test cases\&. Max number of seconds to wait for servers to do controlled shutdown before killing them\&. Default is 10\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1258,11 +1430,11 @@ Do not start Instance Manager; skip Instance Manager test cases\&. ...@@ -1258,11 +1430,11 @@ Do not start Instance Manager; skip Instance Manager test cases\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: skip-master-binlog option .\" mysql-test-run.pl: skip-combinations option
.\" skip-master-binlog option: mysql-test-run.pl .\" skip-combinations option: mysql-test-run.pl
\fB\-\-skip\-master\-binlog\fR \fB\-\-skip\-combinations\fR
.sp .sp
Do not enable master server binary logging\&. Do not apply combinations; ignore combinations file or option\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1324,21 +1496,6 @@ Skip replication test cases\&. ...@@ -1324,21 +1496,6 @@ Skip replication test cases\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: skip-slave-binlog option
.\" skip-slave-binlog option: mysql-test-run.pl
\fB\-\-skip\-slave\-binlog\fR
.sp
Do not enable master server binary logging\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: skip-ssl option .\" mysql-test-run.pl: skip-ssl option
.\" skip-ssl option: mysql-test-run.pl .\" skip-ssl option: mysql-test-run.pl
\fB\-\-skip\-ssl\fR \fB\-\-skip\-ssl\fR
...@@ -1362,7 +1519,7 @@ with support for SSL connections\&. ...@@ -1362,7 +1519,7 @@ with support for SSL connections\&.
.sp .sp
Specify a regular expression to be applied to test case names\&. Cases with names that match the expression are skipped\&. tests to skip\&. Specify a regular expression to be applied to test case names\&. Cases with names that match the expression are skipped\&. tests to skip\&.
.sp .sp
As of MySQL 5\&.0\&.54/5\&.1\&.23/6\&.0\&.5, the argument for the The argument for the
\fB\-\-skip\-test\fR \fB\-\-skip\-test\fR
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 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
\fB\-\-do\-test\fR \fB\-\-do\-test\fR
...@@ -1393,13 +1550,14 @@ are passed to the master server\&. ...@@ -1393,13 +1550,14 @@ are passed to the master server\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: slave-binary option .\" mysql-test-run.pl: sleep option
.\" slave-binary option: mysql-test-run.pl .\" sleep option: mysql-test-run.pl
\fB\-\-slave\-binary=\fR\fB\fIpath\fR\fR \fB\-\-sleep=\fR\fB\fIN\fR\fR
.sp .sp
Specify the path of the Pass
\fBmysqld\fR \fB\-\-sleep=\fR\fB\fIN\fR\fR
binary to use for slave servers\&. to
\fBmysqltest\fR\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1410,82 +1568,14 @@ binary to use for slave servers\&. ...@@ -1410,82 +1568,14 @@ binary to use for slave servers\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: slave_port option .\" mysql-test-run.pl: sp-protocol option
.\" slave_port option: mysql-test-run.pl .\" sp-protocol option: mysql-test-run.pl
\fB\-\-slave_port=\fR\fB\fIport_num\fR\fR \fB\-\-sp\-protocol\fR
.sp .sp
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\&. Pass the
.RE \fB\-\-sp\-protocol\fR
.sp option to
.RS 4 \fBmysqltest\fR\&.
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: sleep option
.\" sleep option: mysql-test-run.pl
\fB\-\-sleep=\fR\fB\fIN\fR\fR
.sp
Pass
\fB\-\-sleep=\fR\fB\fIN\fR\fR
to
\fBmysqltest\fR\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: small-bench option
.\" small-bench option: mysql-test-run.pl
\fB\-\-small\-bench\fR
.sp
Run the benchmarks with the
\fB\-\-small\-tests\fR
and
\fB\-\-small\-tables\fR
options\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: socket option
.\" socket option: mysql-test-run.pl
\fB\-\-socket=\fR\fB\fIfile_name\fR\fR
.sp
For connections to
localhost, the Unix socket file to use, or, on Windows, the name of the named pipe to use\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: sp-protocol option
.\" sp-protocol option: mysql-test-run.pl
\fB\-\-sp\-protocol\fR
.sp
Pass the
\fB\-\-sp\-protocol\fR
option to
\fBmysqltest\fR\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1520,39 +1610,11 @@ Couldn\'t find support for SSL ...@@ -1520,39 +1610,11 @@ Couldn\'t find support for SSL
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: start option
.\" start option: mysql-test-run.pl
\fB\-\-start\fR
.sp
Initialize and start servers with the startup settings for the first specified test case\&. For example:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBcd mysql\-test\fR
shell> \fB\&./mysql\-test\-run\&.pl \-\-start alias &\fR
.fi
.if n \{\
.RE
.\}
.sp
This option was added in MySQL 5\&.1\&.32/6\&.0\&.11\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: start-and-exit option .\" mysql-test-run.pl: start-and-exit option
.\" start-and-exit option: mysql-test-run.pl .\" start-and-exit option: mysql-test-run.pl
\fB\-\-start\-and\-exit\fR \fB\-\-start\fR
.sp .sp
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 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
\fBmysql\fR \fBmysql\fR
client like this: client like this:
.sp .sp
...@@ -1561,12 +1623,19 @@ client like this: ...@@ -1561,12 +1623,19 @@ client like this:
.\} .\}
.nf .nf
shell> \fBcd mysql\-test\fR shell> \fBcd mysql\-test\fR
shell> \fB\&./mysql\-test\-run\&.pl \-\-start\-and\-exit\fR shell> \fB\&./mysql\-test\-run\&.pl \-\-start alias &\fR
shell> \fB\&.\&./mysql \-S \&./var/tmp/master\&.sock \-h localhost \-u root\fR shell> \fB\&.\&./mysql \-S \&./var/tmp/master\&.sock \-h localhost \-u root\fR
.fi .fi
.if n \{\ .if n \{\
.RE .RE
.\} .\}
.sp
If no tests are named on the command line, the server(s) will be started with settings for the first test that would have been run without the
\fB\-\-start\fR
option\&.
.sp
\fBmysql\-test\-run\&.pl\fR
will stop once the server has been started, but will terminate if the server dies\&. If killed, it will also shut down the server\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1581,7 +1650,8 @@ shell> \fB\&.\&./mysql \-S \&./var/tmp/master\&.sock \-h localhost \-u root\fR ...@@ -1581,7 +1650,8 @@ shell> \fB\&.\&./mysql \-S \&./var/tmp/master\&.sock \-h localhost \-u root\fR
.\" start-dirty option: mysql-test-run.pl .\" start-dirty option: mysql-test-run.pl
\fB\-\-start\-dirty\fR \fB\-\-start\-dirty\fR
.sp .sp
Start servers (without initialization) for the specified test case or cases, if any, and then exit\&. You can then manually run the test cases\&. This is similar to
\fB\-\-start\fR, but will skip the database initialization phase and assume that database files are already available\&. Usually this means you must have run another test first\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1627,161 +1697,6 @@ output for ...@@ -1627,161 +1697,6 @@ output for
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: stress option
.\" stress option: mysql-test-run.pl
\fB\-\-stress\fR
.sp
Run the stress test\&. The other
\fB\-\-stress\-\fR\fB\fIxxx\fR\fR
options apply in this case\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: stress-init-file option
.\" stress-init-file option: mysql-test-run.pl
\fB\-\-stress\-init\-file=\fR\fB\fIfile_name\fR\fR
.sp
\fIfile_name\fR
is the location of the file that contains the list of tests\&. The default file is
stress_init\&.txt
in the test suite directory\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: stress-loop-count option
.\" stress-loop-count option: mysql-test-run.pl
\fB\-\-stress\-loop\-count=\fR\fB\fIN\fR\fR
.sp
In sequential stress\-test mode, the number of loops to execute before exiting\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: stress-mode option
.\" stress-mode option: mysql-test-run.pl
\fB\-\-stress\-mode=\fR\fB\fImode\fR\fR
.sp
This option indicates the test order in stress\-test mode\&. The
\fImode\fR
value is either
random
to select tests in random order or
seq
to run tests in each thread in the order specified in the test list file\&. The default mode is
random\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: stress-suite option
.\" stress-suite option: mysql-test-run.pl
\fB\-\-stress\-suite=\fR\fB\fIsuite_name\fR\fR
.sp
The name of the test suite to use for stress testing\&. The default suite name is
main
(the regular test suite located in the
mysql\-test
directory)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: stress-test-count option
.\" stress-test-count option: mysql-test-run.pl
\fB\-\-stress\-test\-count=\fR\fB\fIN\fR\fR
.sp
For stress testing, the number of tests to execute before exiting\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: stress-test-duration option
.\" stress-test-duration option: mysql-test-run.pl
\fB\-\-stress\-test\-duration=\fR\fB\fIN\fR\fR
.sp
For stress testing, the duration of stress testing in seconds\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: stress-test-file option
.\" stress-test-file option: mysql-test-run.pl
\fB\-\-stress\-test\-file=\fR\fB\fIfile_name\fR\fR
.sp
The file that contains the list of tests to use in stress testing\&. The tests should be named without the
\&.test
extension\&. The default file is
stress_tests\&.txt
in the test suite directory\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: stress-threads option
.\" stress-threads option: mysql-test-run.pl
\fB\-\-stress\-threads=\fR\fB\fIN\fR\fR
.sp
The number of threads to use in stress testing\&. The default is 5\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: suite option .\" mysql-test-run.pl: suite option
.\" suite option: mysql-test-run.pl .\" suite option: mysql-test-run.pl
\fB\-\-suite=\fR\fB\fIsuite_name\fR\fR \fB\-\-suite=\fR\fB\fIsuite_name\fR\fR
...@@ -1831,14 +1746,12 @@ Specify the maximum test case runtime\&. ...@@ -1831,14 +1746,12 @@ Specify the maximum test case runtime\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: timer option .\" mysql-test-run.pl: timediff option
.\" timer option: mysql-test-run.pl .\" timediff option: mysql-test-run.pl
\fB\-\-timer\fR \fB\-\-timediff\fR
.sp .sp
Cause Adds to each test report for a test case, the total time in sconds and milliseconds passed since the preceding test ended\&. This option can only be used together with
\fBmysqltest\fR \fB\-\-timestamp\fR, and has no effect without it\&.
to generate a timing file\&. The default file is named
\&./var/log/timer\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1849,28 +1762,14 @@ to generate a timing file\&. The default file is named ...@@ -1849,28 +1762,14 @@ to generate a timing file\&. The default file is named
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: tmpdir option .\" mysql-test-run.pl: timer option
.\" tmpdir option: mysql-test-run.pl .\" timer option: mysql-test-run.pl
\fB\-\-tmpdir=\fR\fB\fIpath\fR\fR \fB\-\-timer\fR
.sp
The directory where temporary file are stored\&. The default location is
\&./var/tmp\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: unified-diff option
.\" unified-diff option: mysql-test-run.pl
\fB\-\-unified\-diff\fR,
\fB\-\-udiff\fR
.sp .sp
Use unified diff format when presenting differences between expected and actual test case results\&. Cause
\fBmysqltest\fR
to generate a timing file\&. The default file is named
\&./var/log/timer\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1881,11 +1780,11 @@ Use unified diff format when presenting differences between expected and actual ...@@ -1881,11 +1780,11 @@ Use unified diff format when presenting differences between expected and actual
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: use-old-data option .\" mysql-test-run.pl: timestamp option
.\" use-old-data option: mysql-test-run.pl .\" timestamp option: mysql-test-run.pl
\fB\-\-use\-old\-data\fR \fB\-\-timestamp\fR
.sp .sp
Do not install the test databases\&. (Use existing ones\&.) Prints a timestamp before the test case name in each test report line, showing when the test ended\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1896,11 +1795,14 @@ Do not install the test databases\&. (Use existing ones\&.) ...@@ -1896,11 +1795,14 @@ Do not install the test databases\&. (Use existing ones\&.)
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: user-test option .\" mysql-test-run.pl: tmpdir option
.\" user-test option: mysql-test-run.pl .\" tmpdir option: mysql-test-run.pl
\fB\-\-user\-test=\fR\fB\fIval\fR\fR \fB\-\-tmpdir=\fR\fB\fIpath\fR\fR
.sp .sp
Unused\&. The directory where temporary file are stored\&. The default location is
\&./var/tmp\&. The environment variable
MYSQL_TMP_DIR
will be set to the path for this directory, whether it has the default value or has been set explicitly\&. This may be referred to in tests\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1935,7 +1837,11 @@ Run ...@@ -1935,7 +1837,11 @@ Run
and and
\fBmysqld\fR \fBmysqld\fR
with with
\fBvalgrind\fR\&. \fBvalgrind\fR\&. Thiks and the following
\fB\-\-valgrind\fR
options require that the executables have been build with
\fBvalgrind\fR
support\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1946,16 +1852,13 @@ with ...@@ -1946,16 +1852,13 @@ with
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: valgrind-all option .\" mysql-test-run.pl: valgrind-mysqld option
.\" valgrind-all option: mysql-test-run.pl .\" valgrind-mysqld option: mysql-test-run.pl
\fB\-\-valgrind\-all\fR \fB\-\-valgrind\-mysqld\fR
.sp .sp
Like Run the
\fB\-\-valgrind\fR, but passes the \fBmysqld\fR
\fB\-\-verbose\fR server with
and
\fB\-\-show\-reachable\fR
options to
\fBvalgrind\fR\&. \fBvalgrind\fR\&.
.RE .RE
.sp .sp
...@@ -1985,30 +1888,9 @@ with ...@@ -1985,30 +1888,9 @@ with
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: valgrind-mysqltest-all option
.\" valgrind-mysqltest-all option: mysql-test-run.pl
\fB\-\-valgrind\-mysqltest\-all\fR
.sp
Like
\fB\-\-valgrind\-mysqltest\fR, but passes the
\fB\-\-verbose\fR
and
\fB\-\-show\-reachable\fR
options to
\fBvalgrind\fR\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: valgrind-options option .\" mysql-test-run.pl: valgrind-options option
.\" valgrind-options option: mysql-test-run.pl .\" valgrind-options option: mysql-test-run.pl
\fB\-\-valgrind\-options=\fR\fB\fIstr\fR\fR \fB\-\-valgrind\-option=\fR\fB\fIstr\fR\fR
.sp .sp
Extra options to pass to Extra options to pass to
\fBvalgrind\fR\&. \fBvalgrind\fR\&.
...@@ -2044,7 +1926,9 @@ executable\&. ...@@ -2044,7 +1926,9 @@ executable\&.
\fB\-\-vardir=\fR\fB\fIpath\fR\fR \fB\-\-vardir=\fR\fB\fIpath\fR\fR
.sp .sp
Specify the path where files generated during the test run are stored\&. The default location is Specify the path where files generated during the test run are stored\&. The default location is
\&./var\&. \&./var\&. The environment variable
MYSQLTEST_VARDIR
will be set to the path for this directory, whether it has the default value or has been set explicitly\&. This may be referred to in tests\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -2055,14 +1939,11 @@ Specify the path where files generated during the test run are stored\&. The def ...@@ -2055,14 +1939,11 @@ Specify the path where files generated during the test run are stored\&. The def
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: view-protocol option .\" mysql-test-run.pl: verbose option
.\" view-protocol option: mysql-test-run.pl .\" verbose option: mysql-test-run.pl
\fB\-\-view\-protocol\fR \fB\-\-verbose\fR
.sp .sp
Pass the Give more verbose output regarding test execution\&. Use the option twice to get even more output\&. Note that the output generated within each test case is not affected\&.
\fB\-\-view\-protocol\fR
option to
\fBmysqltest\fR\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -2073,13 +1954,11 @@ option to ...@@ -2073,13 +1954,11 @@ option to
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: vs-config option .\" mysql-test-run.pl: verbose-restart option
.\" vs-config option: mysql-test-run.pl .\" verbose-restart option: mysql-test-run.pl
\fB\-\-vs\-config=\fR\fB\fIconfig_val\fR\fR \fB\-\-verbose\-restart\fR
.sp .sp
Specify the configuration used to build MySQL (for example, Write when and why servers are restarted between test cases\&.
\fB\-\-vs\-config=debug\fR
\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\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -2090,11 +1969,14 @@ Specify the configuration used to build MySQL (for example, ...@@ -2090,11 +1969,14 @@ Specify the configuration used to build MySQL (for example,
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: wait-timeout option .\" mysql-test-run.pl: view-protocol option
.\" wait-timeout option: mysql-test-run.pl .\" view-protocol option: mysql-test-run.pl
\fB\-\-wait\-timeout=\fR\fB\fIN\fR\fR \fB\-\-view\-protocol\fR
.sp .sp
Unused? Pass the
\fB\-\-view\-protocol\fR
option to
\fBmysqltest\fR\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -2105,12 +1987,13 @@ Unused? ...@@ -2105,12 +1987,13 @@ Unused?
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: warnings option .\" mysql-test-run.pl: vs-config option
.\" warnings option: mysql-test-run.pl .\" vs-config option: mysql-test-run.pl
\fB\-\-warnings\fR \fB\-\-vs\-config=\fR\fB\fIconfig_val\fR\fR
.sp .sp
This option is a synonym for Specify the configuration used to build MySQL (for example,
\fB\-\-log\-warnings\fR\&. \fB\-\-vs\-config=debug\fR
\fB\-\-vs\-config=release\fR)\&. This option is for Windows only\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -2121,11 +2004,17 @@ This option is a synonym for ...@@ -2121,11 +2004,17 @@ This option is a synonym for
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: with-ndbcluster option .\" mysql-test-run.pl: wait-all option
.\" with-ndbcluster option: mysql-test-run.pl .\" wait-all option: mysql-test-run.pl
\fB\-\-with\-ndbcluster\fR \fB\-\-wait\-all\fR
.sp
If
\fB\-\-start\fR
or
\fB\-\-start\-dirty\fR
is used, wait for all servers to exit before termination\&. Otherise, it will terminate if one (of several) servers is restarted\&.
.sp .sp
Use NDB Cluster and enable test cases that require it\&. This option was added in MySQL 5\&.1\&.36\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -2136,11 +2025,12 @@ Use NDB Cluster and enable test cases that require it\&. ...@@ -2136,11 +2025,12 @@ Use NDB Cluster and enable test cases that require it\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysql-test-run.pl: with-ndbcluster-all option .\" mysql-test-run.pl: warnings option
.\" with-ndbcluster-all option: mysql-test-run.pl .\" warnings option: mysql-test-run.pl
\fB\-\-with\-ndbcluster\-all\fR \fB\-\-warnings\fR
.sp .sp
Use NDB Cluster in all tests\&. Search the server log for errors or warning after each test and report any suspicious ones; if any are found, the test will be marked as failed\&. This is the default behavior, it may be turned off with
\fB\-\-nowarnings\fR\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -2159,100 +2049,10 @@ Run only test cases that have ...@@ -2159,100 +2049,10 @@ Run only test cases that have
ndb ndb
in their name\&. in their name\&.
.RE .RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: with-ndbcluster-slave option
.\" with-ndbcluster-slave option: mysql-test-run.pl
\fB\-\-with\-ndbcluster\-slave\fR
.sp
Unknown\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-test-run.pl: with-openssl option
.\" with-openssl option: mysql-test-run.pl
\fB\-\-with\-openssl\fR
.sp
This option is a synonym for
\fB\-\-ssl\fR\&.
.RE
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
\fBmysql\-test\-run\fR
supports the following options not supported by
\fBmysql\-test\-run\&.pl\fR:
\fB\-\-local\fR,
\fB\-\-local\-master\fR,
\fB\-\-ndb\-verbose\fR,
\fB\-\-ndb_mgm\-extra\-opts\fR,
\fB\-\-ndb_mgmd\-extra\-opts\fR,
\fB\-\-ndbd\-extra\-opts\fR,
\fB\-\-old\-master\fR,
\fB\-\-purify\fR,
\fB\-\-use\-old\-data\fR,
\fB\-\-valgrind\-mysqltest\-all\fR\&.
.PP
Conversely,
\fBmysql\-test\-run\&.pl\fR
supports the following options not supported by
\fBmysql\-test\-run\fR:
\fB\-\-benchdir\fR,
\fB\-\-check\-testcases\fR,
\fB\-\-client\-ddd\fR,
\fB\-\-client\-debugger\fR,
\fB\-\-cursor\-protocol\fR,
\fB\-\-debugger\fR,
\fB\-\-im\-mysqld1\-port\fR,
\fB\-\-im\-mysqld2\-port\fR,
\fB\-\-im\-port\fR,
\fB\-\-manual\-debug\fR,
\fB\-\-netware\fR,
\fB\-\-notimer\fR,
\fB\-\-reorder\fR,
\fB\-\-script\-debug\fR,
\fB\-\-skip\-im\fR,
\fB\-\-skip\-ssl\fR,
\fB\-\-sp\-protocol\fR,
\fB\-\-start\-dirty\fR,
\fB\-\-suite\fR,
\fB\-\-suite\-timeout\fR,
\fB\-\-testcase\-timeout\fR,
\fB\-\-udiff\fR,
\fB\-\-unified\-diff\fR,,
\fB\-\-valgrind\-path\fR,
\fB\-\-vardir\fR,
\fB\-\-view\-protocol\fR\&.
.sp .5v
.RE
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright \(co 2007, 2010, Oracle and/or its affiliates. All rights reserved.
.PP .PP
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. 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.
.PP .PP
...@@ -2260,12 +2060,6 @@ This documentation is distributed in the hope that it will be useful, but WITHOU ...@@ -2260,12 +2060,6 @@ This documentation is distributed in the hope that it will be useful, but WITHOU
.PP .PP
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/. 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/.
.sp .sp
.SH "NOTES"
.IP " 1." 4
Typical \fBconfigure\fR Options
.RS 4
\%http://dev.mysql.com/doc/refman/5.1/en/configure-options.html
.RE
.SH "SEE ALSO" .SH "SEE ALSO"
For more information, please refer to the MySQL Reference Manual, For more information, please refer to the MySQL Reference Manual,
which may already be installed locally and which is also available which may already be installed locally and which is also available
......
man/mysql.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysql\fR .\" Title: \fBmysql\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQL\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQL\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -103,7 +103,13 @@ shell> \fBmysql \fR\fB\fIdb_name\fR\fR\fB < \fR\fB\fIscript\&.sql\fR\fR\fB > \fR ...@@ -103,7 +103,13 @@ shell> \fBmysql \fR\fB\fIdb_name\fR\fR\fB < \fR\fB\fIscript\&.sql\fR\fR\fB > \fR
.\" startup parameters: mysql .\" startup parameters: mysql
.PP .PP
\fBmysql\fR \fBmysql\fR
supports the options in the following list\&. It also reads option files and supports the options for processing them described at supports the following options, which can be specified on the command line or in the
[mysql]
and
[client]
option file groups\&.
\fBmysql\fR
also supports the options for processing option files described at
Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&. Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&.
.sp .sp
.RS 4 .RS 4
...@@ -182,7 +188,7 @@ option\&. ...@@ -182,7 +188,7 @@ option\&.
\fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR \fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR
.sp .sp
The directory where character sets are installed\&. See The directory where character sets are installed\&. See
Section\ \&9.2, \(lqThe Character Set Used for Data and Sorting\(rq\&. Section\ \&9.5, \(lqCharacter Set Configuration\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -345,7 +351,7 @@ latin1 ...@@ -345,7 +351,7 @@ latin1
character set by default\&. You can usually fix such issues by using this option to force the client to use the system character set instead\&. character set by default\&. You can usually fix such issues by using this option to force the client to use the system character set instead\&.
.sp .sp
See See
Section\ \&9.2, \(lqThe Character Set Used for Data and Sorting\(rq, for more information\&. Section\ \&9.5, \(lqCharacter Set Configuration\(rq, for more information\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -550,10 +556,8 @@ the section called \(lqMYSQL COMMANDS\(rq\&. ...@@ -550,10 +556,8 @@ the section called \(lqMYSQL COMMANDS\(rq\&.
\fB\-\-no\-auto\-rehash\fR, \fB\-\-no\-auto\-rehash\fR,
\fB\-A\fR \fB\-A\fR
.sp .sp
Deprecated form of This has the same effect as
\fB\-skip\-auto\-rehash\fR\&. Use \fB\-skip\-auto\-rehash\fR\&. See the description for
\fB\-\-disable\-auto\-rehash\fR
instead\&. See the description for
\fB\-\-auto\-rehash\fR\&. \fB\-\-auto\-rehash\fR\&.
.RE .RE
.sp .sp
...@@ -589,6 +593,8 @@ Do not beep when errors occur\&. ...@@ -589,6 +593,8 @@ Do not beep when errors occur\&.
Deprecated, use Deprecated, use
\fB\-\-disable\-named\-commands\fR \fB\-\-disable\-named\-commands\fR
instead\&. instead\&.
\fB\-\-no\-named\-commands\fR
is removed in MySQL 5\&.5\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -607,6 +613,8 @@ Deprecated form of ...@@ -607,6 +613,8 @@ Deprecated form of
\fB\-\-skip\-pager\fR\&. See the \fB\-\-skip\-pager\fR\&. See the
\fB\-\-pager\fR \fB\-\-pager\fR
option\&. option\&.
\fB\-\-no\-pager\fR
is removed in MySQL 5\&.5\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -621,8 +629,12 @@ option\&. ...@@ -621,8 +629,12 @@ option\&.
.\" no-tee option: mysql .\" no-tee option: mysql
\fB\-\-no\-tee\fR \fB\-\-no\-tee\fR
.sp .sp
Do not copy output to a file\&. Deprecated form of
the section called \(lqMYSQL COMMANDS\(rq, discusses tee files further\&. \fB\-\-skip\-tee\fR\&. See the
\fB\-\-tee\fR
option\&.
\fB\-\-no\-tee\fR
is removed in MySQL 5\&.5\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -684,10 +696,12 @@ value following the ...@@ -684,10 +696,12 @@ value following the
\fB\-\-password\fR \fB\-\-password\fR
or or
\fB\-p\fR \fB\-p\fR
option on the command line, you are prompted for one\&. option on the command line,
\fBmysql\fR
prompts for one\&.
.sp .sp
Specifying a password on the command line should be considered insecure\&. See Specifying a password on the command line should be considered insecure\&. See
Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&. Section\ \&5.3.2.2, \(lqEnd-User Guidelines for Password Security\(rq\&. You can use an option file to avoid giving the password on the command line\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -703,7 +717,7 @@ Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&. ...@@ -703,7 +717,7 @@ Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&.
\fB\-\-pipe\fR, \fB\-\-pipe\fR,
\fB\-W\fR \fB\-W\fR
.sp .sp
On Windows, connect to the server via a named pipe\&. This option applies only for connections to a local server, and only if the server supports named\-pipe connections\&. On Windows, connect to the server via a named pipe\&. This option applies only if the server supports named\-pipe connections\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -950,9 +964,7 @@ option\&. ...@@ -950,9 +964,7 @@ option\&.
\fB\-\-skip\-column\-names\fR, \fB\-\-skip\-column\-names\fR,
\fB\-N\fR \fB\-N\fR
.sp .sp
Do not write column names in results\&. The short format, Do not write column names in results\&.
\fB\-N\fR
is deprecated, use the long format instead\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -968,9 +980,7 @@ is deprecated, use the long format instead\&. ...@@ -968,9 +980,7 @@ is deprecated, use the long format instead\&.
\fB\-\-skip\-line\-numbers\fR, \fB\-\-skip\-line\-numbers\fR,
\fB\-L\fR \fB\-L\fR
.sp .sp
Do not write line numbers for errors\&. Useful when you want to compare result files that include error messages\&. The short format, Do not write line numbers for errors\&. Useful when you want to compare result files that include error messages\&.
\fB\-L\fR
is deprecated, use the long format instead\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1005,7 +1015,7 @@ localhost, the Unix socket file to use, or, on Windows, the name of the named pi ...@@ -1005,7 +1015,7 @@ localhost, the Unix socket file to use, or, on Windows, the name of the named pi
Options that begin with Options that begin with
\fB\-\-ssl\fR \fB\-\-ssl\fR
specify whether to connect to the server via SSL and indicate where to find SSL keys and certificates\&. See specify whether to connect to the server via SSL and indicate where to find SSL keys and certificates\&. See
Section\ \&5.5.7.3, \(lqSSL Command Options\(rq\&. Section\ \&5.5.6.3, \(lqSSL Command Options\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1229,7 +1239,7 @@ shell> \fBmysql \-\-xml \-uroot \-e "SHOW VARIABLES LIKE \'version%\'"\fR ...@@ -1229,7 +1239,7 @@ shell> \fBmysql \-\-xml \-uroot \-e "SHOW VARIABLES LIKE \'version%\'"\fR
You can also set the following variables by using You can also set the following variables by using
\fB\-\-\fR\fB\fIvar_name\fR\fR\fB=\fR\fB\fIvalue\fR\fR\&. The \fB\-\-\fR\fB\fIvar_name\fR\fR\fB=\fR\fB\fIvalue\fR\fR\&. The
\fB\-\-set\-variable\fR \fB\-\-set\-variable\fR
format is deprecated\&. format is deprecated and is removed in MySQL 5\&.5\&.
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
...@@ -1325,7 +1335,7 @@ environment variable\&. ...@@ -1325,7 +1335,7 @@ environment variable\&.
The The
\&.mysql_history \&.mysql_history
should be protected with a restrictive access mode because sensitive information might be written to it, such as the text of SQL statements that contain passwords\&. See should be protected with a restrictive access mode because sensitive information might be written to it, such as the text of SQL statements that contain passwords\&. See
Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&. Section\ \&5.3.2.2, \(lqEnd-User Guidelines for Password Security\(rq\&.
.PP .PP
If you do not want to maintain a history file, first remove If you do not want to maintain a history file, first remove
\&.mysql_history \&.mysql_history
...@@ -2805,7 +2815,7 @@ Section\ \&21.9.11, \(lqControlling Automatic Reconnection Behavior\(rq\&. ...@@ -2805,7 +2815,7 @@ Section\ \&21.9.11, \(lqControlling Automatic Reconnection Behavior\(rq\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
...@@ -2817,7 +2827,7 @@ You should have received a copy of the GNU General Public License along with the ...@@ -2817,7 +2827,7 @@ You should have received a copy of the GNU General Public License along with the
.IP " 1." 4 .IP " 1." 4
Bug#25946 Bug#25946
.RS 4 .RS 4
\%http://bugs.mysql.com/25946 \%http://bugs.mysql.com/bug.php?id=25946
.RE .RE
.SH "SEE ALSO" .SH "SEE ALSO"
For more information, please refer to the MySQL Reference Manual, For more information, please refer to the MySQL Reference Manual,
......
man/mysql.server.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysql.server\fR .\" Title: \fBmysql.server\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQL\&.SERVER\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQL\&.SERVER\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -62,7 +62,7 @@ sections, although you should rename such sections to ...@@ -62,7 +62,7 @@ sections, although you should rename such sections to
when using MySQL 5\&.1\&. when using MySQL 5\&.1\&.
.PP .PP
\fBmysql\&.server\fR \fBmysql\&.server\fR
supports the following options: supports the following options\&.
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
...@@ -176,7 +176,7 @@ The login user name to use for running ...@@ -176,7 +176,7 @@ The login user name to use for running
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysql_client_test.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysql_client_test\fR .\" Title: \fBmysql_client_test\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 10/29/2009 .\" Date: 03/31/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL .\" Source: MySQL
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQL_CLIENT_TEST" "1" "10/29/2009" "MySQL" "MySQL Database System" .TH "\FBMYSQL_CLIENT_TEST" "1" "03/31/2010" "MySQL" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -40,10 +40,15 @@ and its test language\&. ...@@ -40,10 +40,15 @@ and its test language\&.
is similar but used for testing the embedded server\&. Both programs are run as part of the test suite\&. is similar but used for testing the embedded server\&. Both programs are run as part of the test suite\&.
.PP .PP
The source code for the programs can be found in in The source code for the programs can be found in in
test/mysql_client_test\&.c tests/mysql_client_test\&.c
in a source distribution\&. The program serves as a good source of examples illustrating how to use various features of the client API\&. in a source distribution\&. The program serves as a good source of examples illustrating how to use various features of the client API\&.
.PP .PP
\fBmysql_client_test\fR \fBmysql_client_test\fR
is used in a test by the same name in the main tests suite of
\fBmysql\-test\-run\&.pl\fR
but may also be run directly\&. Unlike the other programs listed here, it does not read an external description of what tests to run\&. Instead, all tests are coded into the program, which is written to cover all aspects of the C language API\&.
.PP
\fBmysql_client_test\fR
supports the following options: supports the following options:
.sp .sp
.RS 4 .RS 4
...@@ -70,10 +75,10 @@ Display a help message and exit\&. ...@@ -70,10 +75,10 @@ Display a help message and exit\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
\fB\-b \fR\fB\fIdir_name\fR\fR, \fB\-\-basedir=\fR\fB\fIdir_name\fR\fR,
.\" mysql_client_test: basedir option .\" mysql_client_test: basedir option
.\" basedir option: mysql_client_test .\" basedir option: mysql_client_test
\fB\-\-basedir=\fR\fB\fIdir_name\fR\fR \fB\-b \fR\fB\fIdir_name\fR\fR
.sp .sp
The base directory for the tests\&. The base directory for the tests\&.
.RE .RE
...@@ -86,10 +91,10 @@ The base directory for the tests\&. ...@@ -86,10 +91,10 @@ The base directory for the tests\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
\fB\-t \fR\fB\fIcount\fR\fR, \fB\-\-count=\fR\fB\fIcount\fR\fR,
.\" mysql_client_test: count option .\" mysql_client_test: count option
.\" count option: mysql_client_test .\" count option: mysql_client_test
\fB\-\-count=\fR\fB\fIcount\fR\fR \fB\-t \fR\fB\fIcount\fR\fR
.sp .sp
The number of times to execute the tests\&. The number of times to execute the tests\&.
.RE .RE
...@@ -137,10 +142,10 @@ value is ...@@ -137,10 +142,10 @@ value is
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
\fB\-g \fR\fB\fIoption\fR\fR, \fB\-\-getopt\-ll\-test=\fR\fB\fIoption\fR\fR,
.\" mysql_client_test: getopt-ll-test option .\" mysql_client_test: getopt-ll-test option
.\" getopt-ll-test option: mysql_client_test .\" getopt-ll-test option: mysql_client_test
\fB\-\-getopt\-ll\-test=\fR\fB\fIoption\fR\fR \fB\-g \fR\fB\fIoption\fR\fR
.sp .sp
Option to use for testing bugs in the Option to use for testing bugs in the
getopt getopt
...@@ -213,10 +218,10 @@ The TCP/IP port number to use for the connection\&. ...@@ -213,10 +218,10 @@ The TCP/IP port number to use for the connection\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
\fB\-A \fR\fB\fIarg\fR\fR, \fB\-\-server\-arg=\fR\fB\fIarg\fR\fR,
.\" mysql_client_test: server-arg option .\" mysql_client_test: server-arg option
.\" server-arg option: mysql_client_test .\" server-arg option: mysql_client_test
\fB\-\-server\-arg=\fR\fB\fIarg\fR\fR \fB\-A \fR\fB\fIarg\fR\fR
.sp .sp
Argument to send to the embedded server\&. Argument to send to the embedded server\&.
.RE .RE
...@@ -229,8 +234,8 @@ Argument to send to the embedded server\&. ...@@ -229,8 +234,8 @@ Argument to send to the embedded server\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
\fB\-T\fR, \fB\-\-show\-tests\fR,
\fB\-\-show\-tests\fR \fB\-T\fR
.sp .sp
Show all test names\&. Show all test names\&.
.RE .RE
...@@ -277,12 +282,13 @@ localhost ...@@ -277,12 +282,13 @@ localhost
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
\fB\-c\fR, \fB\-\-testcase\fR,
\fB\-\-testcase\fR \fB\-c\fR
.sp .sp
The option may disable some code when run as a The option is used when called from
\fBmysql\-test\-run\&.pl\fR \fBmysql\-test\-run\&.pl\fR, so that
test case\&. \fBmysql_client_test\fR
may optionally behave in a different way than if called manually, for example by skipping some tests\&. Currently, there is no difference in behavior but the option is included in order to make this possible\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -320,7 +326,7 @@ mysql\-test/var\&. ...@@ -320,7 +326,7 @@ mysql\-test/var\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright \(co 2007, 2010, Oracle and/or its affiliates. All rights reserved.
.PP .PP
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. 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.
.PP .PP
......
man/mysql_config.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysql_config\fR .\" Title: \fBmysql_config\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQL_CONFIG\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQL_CONFIG\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -30,7 +30,7 @@ mysql_config \- get compile options for compiling clients ...@@ -30,7 +30,7 @@ mysql_config \- get compile options for compiling clients
provides you with useful information for compiling your MySQL client and connecting it to MySQL\&. provides you with useful information for compiling your MySQL client and connecting it to MySQL\&.
.PP .PP
\fBmysql_config\fR \fBmysql_config\fR
supports the following options: supports the following options\&.
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
...@@ -224,7 +224,7 @@ this way, be sure to invoke it within backtick (\(lq`\(rq) characters\&. That te ...@@ -224,7 +224,7 @@ this way, be sure to invoke it within backtick (\(lq`\(rq) characters\&. That te
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysql_convert_table_format.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysql_convert_table_format\fR .\" Title: \fBmysql_convert_table_format\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQL_CONVERT_TAB" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQL_CONVERT_TAB" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -115,10 +115,10 @@ Connect to the MySQL server on the given host\&. ...@@ -115,10 +115,10 @@ Connect to the MySQL server on the given host\&.
.\" password option: mysql_convert_table_format .\" password option: mysql_convert_table_format
\fB\-\-password=\fR\fB\fIpassword\fR\fR \fB\-\-password=\fR\fB\fIpassword\fR\fR
.sp .sp
The password to use when connecting to the server\&. Note that the password value is not optional for this option, unlike for other MySQL programs\&. You can use an option file to avoid giving the password on the command line\&. The password to use when connecting to the server\&. Note that the password value is not optional for this option, unlike for other MySQL programs\&.
.sp .sp
Specifying a password on the command line should be considered insecure\&. See Specifying a password on the command line should be considered insecure\&. See
Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&. Section\ \&5.3.2.2, \(lqEnd-User Guidelines for Password Security\(rq\&. You can use an option file to avoid giving the password on the command line\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -216,7 +216,7 @@ Display version information and exit\&. ...@@ -216,7 +216,7 @@ Display version information and exit\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysql_find_rows.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysql_find_rows\fR .\" Title: \fBmysql_find_rows\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQL_FIND_ROWS\F" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQL_FIND_ROWS\F" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -151,7 +151,7 @@ Start output from this row\&. ...@@ -151,7 +151,7 @@ Start output from this row\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysql_fix_extensions.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysql_fix_extensions\fR .\" Title: \fBmysql_fix_extensions\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQL_FIX_EXTENSI" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQL_FIX_EXTENSI" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -61,7 +61,7 @@ shell> \fBmysql_fix_extensions \fR\fB\fIdata_dir\fR\fR ...@@ -61,7 +61,7 @@ shell> \fBmysql_fix_extensions \fR\fB\fIdata_dir\fR\fR
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysql_fix_privilege_tables.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysql_fix_privilege_tables\fR .\" Title: \fBmysql_fix_privilege_tables\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQL_FIX_PRIVILE" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQL_FIX_PRIVILE" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -131,7 +131,9 @@ mysql> \fBSOURCE share/mysql_fix_privilege_tables\&.sql\fR ...@@ -131,7 +131,9 @@ mysql> \fBSOURCE share/mysql_fix_privilege_tables\&.sql\fR
.ps -1 .ps -1
.br .br
.PP .PP
Prior to version 5\&.1\&.17, this script is found in the Prior to version 5\&.1\&.17, the
mysql_fix_privilege_tables\&.sql
script is found in the
scripts scripts
directory\&. directory\&.
.sp .5v .sp .5v
...@@ -157,7 +159,7 @@ After running the script, stop the server and restart it\&. ...@@ -157,7 +159,7 @@ After running the script, stop the server and restart it\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysql_install_db.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysql_install_db\fR .\" Title: \fBmysql_install_db\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQL_INSTALL_DB\" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQL_INSTALL_DB\" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -94,8 +94,12 @@ environment variable to the full path name of a server that has all options enab ...@@ -94,8 +94,12 @@ environment variable to the full path name of a server that has all options enab
will use that server\&. will use that server\&.
.PP .PP
\fBmysql_install_db\fR \fBmysql_install_db\fR
supports the options in the following list\&. It also reads option files and supports the options for processing them described at supports the following options, which can be specified on the command line or in the
Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&. [mysql_install_db]
and (if they are common to
\fBmysqld\fR)
[mysqld]
option file groups\&.
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
...@@ -248,7 +252,7 @@ For internal use\&. This option is used for creating Windows distributions\&. ...@@ -248,7 +252,7 @@ For internal use\&. This option is used for creating Windows distributions\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysql_secure_installation.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysql_secure_installation\fR .\" Title: \fBmysql_secure_installation\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQL_SECURE_INST" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQL_SECURE_INST" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -96,7 +96,7 @@ The script will prompt you to determine which actions to perform\&. ...@@ -96,7 +96,7 @@ The script will prompt you to determine which actions to perform\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysql_setpermission.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysql_setpermission\fR .\" Title: \fBmysql_setpermission\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQL_SETPERMISSI" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQL_SETPERMISSI" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -109,10 +109,10 @@ Connect to the MySQL server on the given host\&. ...@@ -109,10 +109,10 @@ Connect to the MySQL server on the given host\&.
.\" password option: mysql_setpermission .\" password option: mysql_setpermission
\fB\-\-password=\fR\fB\fIpassword\fR\fR \fB\-\-password=\fR\fB\fIpassword\fR\fR
.sp .sp
The password to use when connecting to the server\&. Note that the password value is not optional for this option, unlike for other MySQL programs\&. You can use an option file to avoid giving the password on the command line\&. The password to use when connecting to the server\&. Note that the password value is not optional for this option, unlike for other MySQL programs\&.
.sp .sp
Specifying a password on the command line should be considered insecure\&. See Specifying a password on the command line should be considered insecure\&. See
Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&. Section\ \&5.3.2.2, \(lqEnd-User Guidelines for Password Security\(rq\&. You can use an option file to avoid giving the password on the command line\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -163,7 +163,7 @@ The MySQL user name to use when connecting to the server\&. ...@@ -163,7 +163,7 @@ The MySQL user name to use when connecting to the server\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysql_tzinfo_to_sql.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysql_tzinfo_to_sql\fR .\" Title: \fBmysql_tzinfo_to_sql\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQL_TZINFO_TO_S" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQL_TZINFO_TO_S" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -33,11 +33,11 @@ program loads the time zone tables in the ...@@ -33,11 +33,11 @@ program loads the time zone tables in the
mysql mysql
database\&. It is used on systems that have a database\&. It is used on systems that have a
zoneinfo zoneinfo
database (the set of files describing time zones)\&. Examples of such systems are Linux, FreeBSD, Sun Solaris, and Mac OS X\&. One likely location for these files is the database (the set of files describing time zones)\&. Examples of such systems are Linux, FreeBSD, Solaris, and Mac OS X\&. One likely location for these files is the
/usr/share/zoneinfo /usr/share/zoneinfo
directory (/usr/share/lib/zoneinfo directory (/usr/share/lib/zoneinfo
on Solaris)\&. If your system does not have a zoneinfo database, you can use the downloadable package described in on Solaris)\&. If your system does not have a zoneinfo database, you can use the downloadable package described in
Section\ \&9.7, \(lqMySQL Server Time Zone Support\(rq\&. Section\ \&9.6, \(lqMySQL Server Time Zone Support\(rq\&.
.PP .PP
\fBmysql_tzinfo_to_sql\fR \fBmysql_tzinfo_to_sql\fR
can be invoked several ways: can be invoked several ways:
...@@ -113,7 +113,7 @@ After running ...@@ -113,7 +113,7 @@ After running
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysql_upgrade.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysql_upgrade\fR .\" Title: \fBmysql_upgrade\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQL_UPGRADE\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQL_UPGRADE\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -52,6 +52,24 @@ for manual table repair strategies\&. ...@@ -52,6 +52,24 @@ for manual table repair strategies\&.
.nr an-break-flag 1 .nr an-break-flag 1
.br .br
.ps +1 .ps +1
\fBNote\fR
.ps -1
.br
.PP
On Windows Server 2008 and Windows Vista, you must run
\fBmysql_upgrade\fR
with administrator privileges\&. You can do this by running a Command Prompt as Administrator and running the command\&. Failure to do so may result in the upgrade failing to execute correctly\&.
.sp .5v
.RE
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBCaution\fR \fBCaution\fR
.ps -1 .ps -1
.br .br
...@@ -59,7 +77,7 @@ for manual table repair strategies\&. ...@@ -59,7 +77,7 @@ for manual table repair strategies\&.
You should always back up your current MySQL installation You should always back up your current MySQL installation
\fIbefore\fR \fIbefore\fR
performing an upgrade\&. See performing an upgrade\&. See
Section\ \&6.1, \(lqDatabase Backup Methods\(rq\&. Section\ \&6.2, \(lqDatabase Backup Methods\(rq\&.
.PP .PP
Some upgrade incompatibilities may require special handling before you upgrade your MySQL installation and run Some upgrade incompatibilities may require special handling before you upgrade your MySQL installation and run
\fBmysql_upgrade\fR\&. See \fBmysql_upgrade\fR\&. See
...@@ -132,7 +150,7 @@ FOR UPGRADE ...@@ -132,7 +150,7 @@ FOR UPGRADE
option of the option of the
CHECK TABLE CHECK TABLE
statement (see statement (see
Section\ \&12.5.2.3, \(lqCHECK TABLE Syntax\(rq)\&. Section\ \&12.4.2.3, \(lqCHECK TABLE Syntax\(rq)\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -144,7 +162,7 @@ Section\ \&12.5.2.3, \(lqCHECK TABLE Syntax\(rq)\&. ...@@ -144,7 +162,7 @@ Section\ \&12.5.2.3, \(lqCHECK TABLE Syntax\(rq)\&.
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
\fIfix_priv_tables\fR \fIfix_priv_tables\fR
represents a script generated interally by represents a script generated internally by
\fBmysql_upgrade\fR \fBmysql_upgrade\fR
that contains SQL statements to upgrade the tables in the that contains SQL statements to upgrade the tables in the
mysql mysql
...@@ -198,15 +216,17 @@ was added as a shell script and worked only for Unix systems\&. As of MySQL 5\&. ...@@ -198,15 +216,17 @@ was added as a shell script and worked only for Unix systems\&. As of MySQL 5\&.
is an executable binary and is available on all systems\&. is an executable binary and is available on all systems\&.
.PP .PP
\fBmysql_upgrade\fR \fBmysql_upgrade\fR
supports the options in the following list\&. It also reads option files (the supports the following options, which can be specified on the command line or in the
[mysql_upgrade] [mysql_upgrade]
and and
[client] [client]
groups) and supports the options for processing them described at option file groups\&. Other options are passed to
Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&. Other options are passed to
\fBmysqlcheck\fR\&. For example, it might be necessary to specify the \fBmysqlcheck\fR\&. For example, it might be necessary to specify the
\fB\-\-password[=\fR\fB\fIpassword\fR\fR\fB]\fR \fB\-\-password[=\fR\fB\fIpassword\fR\fR\fB]\fR
option\&. option\&.
\fBmysql_upgrade\fR
also supports the options for processing option files described at
Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&.
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
...@@ -375,7 +395,7 @@ This option was introduced in MySQL 5\&.1\&.40\&. ...@@ -375,7 +395,7 @@ This option was introduced in MySQL 5\&.1\&.40\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysql_waitpid.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysql_waitpid\fR .\" Title: \fBmysql_waitpid\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQL_WAITPID\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQL_WAITPID\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -120,7 +120,7 @@ Display version information and exit\&. ...@@ -120,7 +120,7 @@ Display version information and exit\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysql_zap.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysql_zap\fR .\" Title: \fBmysql_zap\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQL_ZAP\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQL_ZAP\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -116,7 +116,7 @@ Test mode\&. Display information about each process but do not kill it\&. ...@@ -116,7 +116,7 @@ Test mode\&. Display information about each process but do not kill it\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysqlaccess.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysqlaccess\fR .\" Title: \fBmysqlaccess\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQLACCESS\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQLACCESS\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -54,7 +54,7 @@ shell> \fBmysqlaccess [\fR\fB\fIhost_name\fR\fR\fB [\fR\fB\fIuser_name\fR\fR\fB ...@@ -54,7 +54,7 @@ shell> \fBmysqlaccess [\fR\fB\fIhost_name\fR\fR\fB [\fR\fB\fIuser_name\fR\fR\fB
.\} .\}
.PP .PP
\fBmysqlaccess\fR \fBmysqlaccess\fR
supports the following options: supports the following options\&.
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
...@@ -221,10 +221,12 @@ value following the ...@@ -221,10 +221,12 @@ value following the
\fB\-\-password\fR \fB\-\-password\fR
or or
\fB\-p\fR \fB\-p\fR
option on the command line, you are prompted for one\&. option on the command line,
\fBmysqlaccess\fR
prompts for one\&.
.sp .sp
Specifying a password on the command line should be considered insecure\&. See Specifying a password on the command line should be considered insecure\&. See
Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&. Section\ \&5.3.2.2, \(lqEnd-User Guidelines for Password Security\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -319,13 +321,15 @@ Undo the most recent changes to the temporary grant tables\&. ...@@ -319,13 +321,15 @@ Undo the most recent changes to the temporary grant tables\&.
The password to use when connecting to the server as the superuser\&. If you omit the The password to use when connecting to the server as the superuser\&. If you omit the
\fIpassword\fR \fIpassword\fR
value following the value following the
\fB\-\-password\fR \fB\-\-spassword\fR
or or
\fB\-p\fR \fB\-p\fR
option on the command line, you are prompted for one\&. option on the command line,
\fBmysqlaccess\fR
prompts for one\&.
.sp .sp
Specifying a password on the command line should be considered insecure\&. See Specifying a password on the command line should be considered insecure\&. See
Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&. Section\ \&5.3.2.2, \(lqEnd-User Guidelines for Password Security\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -419,7 +423,7 @@ error will occur when you run ...@@ -419,7 +423,7 @@ error will occur when you run
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysqladmin.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysqladmin\fR .\" Title: \fBmysqladmin\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQLADMIN\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQLADMIN\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -46,7 +46,7 @@ shell> \fBmysqladmin [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIcommand\fR\fR\fB [\fR\ ...@@ -46,7 +46,7 @@ shell> \fBmysqladmin [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIcommand\fR\fR\fB [\fR\
.\} .\}
.PP .PP
\fBmysqladmin\fR \fBmysqladmin\fR
supports the commands described in the following list\&. Some of the commands take an argument following the command name\&. supports the following commands\&. Some of the commands take an argument following the command name\&.
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
...@@ -211,7 +211,7 @@ old\-password \fInew\-password\fR ...@@ -211,7 +211,7 @@ old\-password \fInew\-password\fR
This is like the This is like the
password password
command but stores the password using the old (pre\-4\&.1) password\-hashing format\&. (See command but stores the password using the old (pre\-4\&.1) password\-hashing format\&. (See
Section\ \&5.5.6.3, \(lqPassword Hashing in MySQL\(rq\&.) Section\ \&5.3.2.3, \(lqPassword Hashing in MySQL\(rq\&.)
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -304,7 +304,7 @@ statement\&. If the ...@@ -304,7 +304,7 @@ statement\&. If the
\fB\-\-verbose\fR \fB\-\-verbose\fR
option is given, the output is like that of option is given, the output is like that of
SHOW FULL PROCESSLIST\&. (See SHOW FULL PROCESSLIST\&. (See
Section\ \&12.5.5.31, \(lqSHOW PROCESSLIST Syntax\(rq\&.) Section\ \&12.4.5.31, \(lqSHOW PROCESSLIST Syntax\(rq\&.)
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -586,7 +586,13 @@ waits until the server\'s process ID file has been removed, to ensure that the s ...@@ -586,7 +586,13 @@ waits until the server\'s process ID file has been removed, to ensure that the s
.\" startup parameters: mysqladmin .\" startup parameters: mysqladmin
.PP .PP
\fBmysqladmin\fR \fBmysqladmin\fR
supports the options in the following list\&. It also reads option files and supports the options for processing them described at supports the following options, which can be specified on the command line or in the
[mysqladmin]
and
[client]
option file groups\&.
\fBmysqladmin\fR
also supports the options for processing option files described at
Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&. Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&.
.sp .sp
.RS 4 .RS 4
...@@ -618,7 +624,7 @@ Display a help message and exit\&. ...@@ -618,7 +624,7 @@ Display a help message and exit\&.
\fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR \fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR
.sp .sp
The directory where character sets are installed\&. See The directory where character sets are installed\&. See
Section\ \&9.2, \(lqThe Character Set Used for Data and Sorting\(rq\&. Section\ \&9.5, \(lqCharacter Set Configuration\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -720,7 +726,7 @@ Print debugging information and memory and CPU usage statistics when the program ...@@ -720,7 +726,7 @@ Print debugging information and memory and CPU usage statistics when the program
Use Use
\fIcharset_name\fR \fIcharset_name\fR
as the default character set\&. See as the default character set\&. See
Section\ \&9.2, \(lqThe Character Set Used for Data and Sorting\(rq\&. Section\ \&9.5, \(lqCharacter Set Configuration\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -794,10 +800,12 @@ value following the ...@@ -794,10 +800,12 @@ value following the
\fB\-\-password\fR \fB\-\-password\fR
or or
\fB\-p\fR \fB\-p\fR
option on the command line, you are prompted for one\&. option on the command line,
\fBmysqladmin\fR
prompts for one\&.
.sp .sp
Specifying a password on the command line should be considered insecure\&. See Specifying a password on the command line should be considered insecure\&. See
Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&. Section\ \&5.3.2.2, \(lqEnd-User Guidelines for Password Security\(rq\&. You can use an option file to avoid giving the password on the command line\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -813,7 +821,7 @@ Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&. ...@@ -813,7 +821,7 @@ Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&.
\fB\-\-pipe\fR, \fB\-\-pipe\fR,
\fB\-W\fR \fB\-W\fR
.sp .sp
On Windows, connect to the server via a named pipe\&. This option applies only for connections to a local server, and only if the server supports named\-pipe connections\&. On Windows, connect to the server via a named pipe\&. This option applies only if the server supports named\-pipe connections\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -940,7 +948,7 @@ localhost, the Unix socket file to use, or, on Windows, the name of the named pi ...@@ -940,7 +948,7 @@ localhost, the Unix socket file to use, or, on Windows, the name of the named pi
Options that begin with Options that begin with
\fB\-\-ssl\fR \fB\-\-ssl\fR
specify whether to connect to the server via SSL and indicate where to find SSL keys and certificates\&. See specify whether to connect to the server via SSL and indicate where to find SSL keys and certificates\&. See
Section\ \&5.5.7.3, \(lqSSL Command Options\(rq\&. Section\ \&5.5.6.3, \(lqSSL Command Options\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1030,7 +1038,7 @@ You can also set the following variables by using ...@@ -1030,7 +1038,7 @@ You can also set the following variables by using
\fB\-\-\fR\fB\fIvar_name\fR\fR\fB=\fR\fB\fIvalue\fR\fR \fB\-\-\fR\fB\fIvar_name\fR\fR\fB=\fR\fB\fIvalue\fR\fR
The The
\fB\-\-set\-variable\fR \fB\-\-set\-variable\fR
format is deprecated\&. syntax: format is deprecated and is removed in MySQL 5\&.5\&. syntax:
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
...@@ -1064,7 +1072,7 @@ The maximum number of seconds to wait for server shutdown\&. The default value i ...@@ -1064,7 +1072,7 @@ The maximum number of seconds to wait for server shutdown\&. The default value i
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysqlbinlog.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysqlbinlog\fR .\" Title: \fBmysqlbinlog\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQLBINLOG\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQLBINLOG\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -34,7 +34,7 @@ utility\&. You can also use ...@@ -34,7 +34,7 @@ utility\&. You can also use
\fBmysqlbinlog\fR \fBmysqlbinlog\fR
to display the contents of relay log files written by a slave server in a replication setup because relay logs have the same format as binary logs\&. The binary log and relay log are discussed further in to display the contents of relay log files written by a slave server in a replication setup because relay logs have the same format as binary logs\&. The binary log and relay log are discussed further in
Section\ \&5.2.4, \(lqThe Binary Log\(rq, and Section\ \&5.2.4, \(lqThe Binary Log\(rq, and
Section\ \&16.4.2, \(lqReplication Relay and Status Files\(rq\&. Section\ \&16.2.2, \(lqReplication Relay and Status Files\(rq\&.
.PP .PP
Invoke Invoke
\fBmysqlbinlog\fR \fBmysqlbinlog\fR
...@@ -64,18 +64,52 @@ shell> \fBmysqlbinlog binlog\&.0000003\fR ...@@ -64,18 +64,52 @@ shell> \fBmysqlbinlog binlog\&.0000003\fR
.\} .\}
.PP .PP
The output includes events contained in The output includes events contained in
binlog\&.000003\&. Event information includes the statement, the ID of the server on which it was executed, the timestamp when the statement was executed, how much time it took, and so forth\&. binlog\&.000003\&. For statement\-based logging, event information includes the SQL statement, the ID of the server on which it was executed, the timestamp when the statement was executed, how much time it took, and so forth\&. For row\-based logging, the event indicates a row change rather than an SQL statement\&. See
Section\ \&16.1.2, \(lqReplication Formats\(rq, for information about logging modes\&.
.PP
Events are preceded by header comments that provide additional information\&. For example:
.sp
.if n \{\
.RS 4
.\}
.nf
# at 141
#100309 9:28:36 server id 123 end_log_pos 245
Query thread_id=3350 exec_time=11 error_code=0
.fi
.if n \{\
.RE
.\}
.PP
In the first line, the number following
at
indicates the starting position of the event in the binary log file\&.
.PP
The second line starts with a date and time indicating when the statement started on the server where the event originated\&. For replication, this timestamp is propagated to slave servers\&.
server id
is the
server_id
value of the server where the event originated\&.
end_log_pos
indicates where the next event starts (that is, it is the end position of the current event + 1)\&.
thread_id
indicates which thread executed the event\&.
exec_time
is the time spent executing the event, on a master server\&. On a slave, it is the difference of the end execution time on the slave minus the beginning execution time on the master\&. The difference serves as an indicator of how much replication lags behind the master\&.
error_code
indicates the result from executing the event\&. Zero means that no error occurred\&.
.PP .PP
The output from The output from
\fBmysqlbinlog\fR \fBmysqlbinlog\fR
can be re\-executed (for example, by using it as input to can be re\-executed (for example, by using it as input to
\fBmysql\fR) to reapply the statements in the log\&. This is useful for recovery operations after a server crash\&. For other usage examples, see the discussion later in this section\&. \fBmysql\fR) to redo the statements in the log\&. This is useful for recovery operations after a server crash\&. For other usage examples, see the discussion later in this section and
Section\ \&6.5, \(lqPoint-in-Time (Incremental) Recovery Using the Binary Log\(rq\&.
.PP .PP
Normally, you use Normally, you use
\fBmysqlbinlog\fR \fBmysqlbinlog\fR
to read binary log files directly and apply them to the local MySQL server\&. It is also possible to read binary logs from a remote server by using the to read binary log files directly and apply them to the local MySQL server\&. It is also possible to read binary logs from a remote server by using the
\fB\-\-read\-from\-remote\-server\fR \fB\-\-read\-from\-remote\-server\fR
option\&. When you read remote binary logs, the connection parameter options can be given to indicate how to connect to the server\&. These options are option\&. To read remote binary logs, the connection parameter options can be given to indicate how to connect to the server\&. These options are
\fB\-\-host\fR, \fB\-\-host\fR,
\fB\-\-password\fR, \fB\-\-password\fR,
\fB\-\-port\fR, \fB\-\-port\fR,
...@@ -86,7 +120,13 @@ option\&. When you read remote binary logs, the connection parameter options can ...@@ -86,7 +120,13 @@ option\&. When you read remote binary logs, the connection parameter options can
option\&. option\&.
.PP .PP
\fBmysqlbinlog\fR \fBmysqlbinlog\fR
supports the following options\&. It also reads option files and supports the options for processing them described at supports the following options, which can be specified on the command line or in the
[mysqlbinlog]
and
[client]
option file groups\&.
\fBmysqlbinlog\fR
also supports the options for processing option files described at
Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&. Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&.
.sp .sp
.RS 4 .RS 4
...@@ -248,7 +288,7 @@ the section called \(lqMYSQLBINLOG ROW EVENT DISPLAY\(rq\&. ...@@ -248,7 +288,7 @@ the section called \(lqMYSQLBINLOG ROW EVENT DISPLAY\(rq\&.
\fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR \fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR
.sp .sp
The directory where character sets are installed\&. See The directory where character sets are installed\&. See
Section\ \&9.2, \(lqThe Character Set Used for Data and Sorting\(rq\&. Section\ \&9.5, \(lqCharacter Set Configuration\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -264,15 +304,140 @@ Section\ \&9.2, \(lqThe Character Set Used for Data and Sorting\(rq\&. ...@@ -264,15 +304,140 @@ Section\ \&9.2, \(lqThe Character Set Used for Data and Sorting\(rq\&.
\fB\-\-database=\fR\fB\fIdb_name\fR\fR, \fB\-\-database=\fR\fB\fIdb_name\fR\fR,
\fB\-d \fR\fB\fIdb_name\fR\fR \fB\-d \fR\fB\fIdb_name\fR\fR
.sp .sp
List entries for just this database (local log only)\&. You can only specify one database with this option \- if you specify multiple This option causes
\fBmysqlbinlog\fR
to output entries from the binary log (local log only) that occur while
\fIdb_name\fR
is been selected as the default database by
USE\&.
.sp
The
\fB\-\-database\fR \fB\-\-database\fR
options, only the last one is used\&. This option forces option for
\fBmysqlbinlog\fR \fBmysqlbinlog\fR
to output entries from the binary log where the default database (that is, the one selected by is similar to the
USE) is \fB\-\-binlog\-do\-db\fR
\fIdb_name\fR\&. Note that this does not replicate cross\-database statements such as option for
UPDATE \fIsome_db\&.some_table\fR SET foo=\'bar\' \fBmysqld\fR, but can be used to specify only one database\&. If
while having selected a different database or no database\&. \fB\-\-database\fR
is given multiple times, only the last instance is used\&.
.sp
The effects of this option depend on whether the statement\-based or row\-based logging format is in use, in the same way that the effects of
\fB\-\-binlog\-do\-db\fR
depend on whether statement\-based or row\-based logging is in use\&.
.PP
\fBStatement-based logging\fR. The
\fB\-\-database\fR
option works as follows:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
While
\fIdb_name\fR
is the default database, statements are output whether they modify tables in
\fIdb_name\fR
or a different database\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Unless
\fIdb_name\fR
is selected as the default database, statements are not output, even if they modify tables in
\fIdb_name\fR\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
There is an exception for
CREATE DATABASE,
ALTER DATABASE, and
DROP DATABASE\&. The database being
\fIcreated, altered, or dropped\fR
is considered to be the default database when determining whether to output the statement\&.
.RE
.RS 4
Suppose that the binary log was created by executing these statements using statement\-based\-logging:
.sp
.if n \{\
.RS 4
.\}
.nf
INSERT INTO test\&.t1 (i) VALUES(100);
INSERT INTO db2\&.t2 (j) VALUES(200);
USE test;
INSERT INTO test\&.t1 (i) VALUES(101);
INSERT INTO t1 (i) VALUES(102);
INSERT INTO db2\&.t2 (j) VALUES(201);
USE db2;
INSERT INTO test\&.t1 (i) VALUES(103);
INSERT INTO db2\&.t2 (j) VALUES(202);
INSERT INTO t2 (j) VALUES(203);
.fi
.if n \{\
.RE
.\}
.sp
\fBmysqlbinlog \-\-database=test\fR
does not output the first two
INSERT
statements because there is no default database\&. It outputs the three
INSERT
statements following
USE test, but not the three
INSERT
statements following
USE db2\&.
.sp
\fBmysqlbinlog \-\-database=db2\fR
does not output the first two
INSERT
statements because there is no default database\&. It does not output the three
INSERT
statements following
USE test, but does output the three
INSERT
statements following
USE db2\&.
.PP
\fBRow-based logging\fR.
\fBmysqlbinlog\fR
outputs only entries that change tables belonging to
\fIdb_name\fR\&. The default database has no effect on this\&. Suppose that the binary log just described was created using row\-based logging rather than statement\-based logging\&.
\fBmysqlbinlog \-\-database=test\fR
outputs only those entries that modify
t1
in the test database, regardless of whether
USE
was issued or what the default database is\&.
If a server is running with
binlog_format
set to
MIXED
and you want it to be possible to use
\fBmysqlbinlog\fR
with the
\fB\-\-database\fR
option, you must ensure that tables that are modified are in the database selected by
USE\&. (In particular, no cross\-database updates should be used\&.)
.if n \{\ .if n \{\
.sp .sp
.\} .\}
...@@ -406,7 +571,7 @@ stops if it reads such an event\&. ...@@ -406,7 +571,7 @@ stops if it reads such an event\&.
\fB\-H\fR \fB\-H\fR
.sp .sp
Display a hex dump of the log in comments, as described in Display a hex dump of the log in comments, as described in
the section called \(lqMYSQLBINLOG HEX DUMP FORMAT\(rq\&. This output can be helpful for replication debugging\&. This option was added in MySQL 5\&.1\&.2\&. the section called \(lqMYSQLBINLOG HEX DUMP FORMAT\(rq\&. The hex output can be helpful for replication debugging\&. This option was added in MySQL 5\&.1\&.2\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -482,10 +647,12 @@ value following the ...@@ -482,10 +647,12 @@ value following the
\fB\-\-password\fR \fB\-\-password\fR
or or
\fB\-p\fR \fB\-p\fR
option on the command line, you are prompted for one\&. option on the command line,
\fBmysqlbinlog\fR
prompts for one\&.
.sp .sp
Specifying a password on the command line should be considered insecure\&. See Specifying a password on the command line should be considered insecure\&. See
Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&. Section\ \&5.3.2.2, \(lqEnd-User Guidelines for Password Security\(rq\&. You can use an option file to avoid giving the password on the command line\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -514,12 +681,13 @@ The TCP/IP port number to use for connecting to a remote server\&. ...@@ -514,12 +681,13 @@ The TCP/IP port number to use for connecting to a remote server\&.
.\} .\}
.\" mysqlbinlog: position option .\" mysqlbinlog: position option
.\" position option: mysqlbinlog .\" position option: mysqlbinlog
\fB\-\-position=\fR\fB\fIN\fR\fR, \fB\-\-position=\fR\fB\fIN\fR\fR
\fB\-j \fR\fB\fIN\fR\fR
.sp .sp
Deprecated\&. Use Deprecated\&. Use
\fB\-\-start\-position\fR \fB\-\-start\-position\fR
instead\&. instead\&.
\fB\-\-position\fR
is removed in MySQL 5\&.5\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -590,7 +758,7 @@ Direct output to the given file\&. ...@@ -590,7 +758,7 @@ Direct output to the given file\&.
.\" server-id option: mysqlbinlog .\" server-id option: mysqlbinlog
\fB\-\-server\-id=\fR\fB\fIid\fR\fR \fB\-\-server\-id=\fR\fB\fIid\fR\fR
.sp .sp
Extract only those events created by the server having the given server ID\&. This option is available as of MySQL 5\&.1\&.4\&. Display only those events created by the server having the given server ID\&. This option is available as of MySQL 5\&.1\&.4\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -677,7 +845,7 @@ shell> \fBmysqlbinlog \-\-start\-datetime="2005\-12\-25 11:25:56" binlog\&.00000 ...@@ -677,7 +845,7 @@ shell> \fBmysqlbinlog \-\-start\-datetime="2005\-12\-25 11:25:56" binlog\&.00000
.\} .\}
.sp .sp
This option is useful for point\-in\-time recovery\&. See This option is useful for point\-in\-time recovery\&. See
Section\ \&6.2, \(lqExample Backup and Recovery Strategy\(rq\&. Section\ \&6.3, \(lqExample Backup and Recovery Strategy\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -690,10 +858,14 @@ Section\ \&6.2, \(lqExample Backup and Recovery Strategy\(rq\&. ...@@ -690,10 +858,14 @@ Section\ \&6.2, \(lqExample Backup and Recovery Strategy\(rq\&.
.\} .\}
.\" mysqlbinlog: start-position option .\" mysqlbinlog: start-position option
.\" start-position option: mysqlbinlog .\" start-position option: mysqlbinlog
\fB\-\-start\-position=\fR\fB\fIN\fR\fR \fB\-\-start\-position=\fR\fB\fIN\fR\fR,
\fB\-j \fR\fB\fIN\fR\fR
.sp .sp
Start reading the binary log at the first event having a position equal to or greater than Start reading the binary log at the first event having a position equal to or greater than
\fIN\fR\&. This option applies to the first log file named on the command line\&. \fIN\fR\&. This option applies to the first log file named on the command line\&.
.sp
This option is useful for point\-in\-time recovery\&. See
Section\ \&6.3, \(lqExample Backup and Recovery Strategy\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -715,6 +887,9 @@ argument\&. This option is useful for point\-in\-time recovery\&. See the descri ...@@ -715,6 +887,9 @@ argument\&. This option is useful for point\-in\-time recovery\&. See the descri
option for information about the option for information about the
\fIdatetime\fR \fIdatetime\fR
value\&. value\&.
.sp
This option is useful for point\-in\-time recovery\&. See
Section\ \&6.3, \(lqExample Backup and Recovery Strategy\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -731,6 +906,9 @@ value\&. ...@@ -731,6 +906,9 @@ value\&.
.sp .sp
Stop reading the binary log at the first event having a position equal to or greater than Stop reading the binary log at the first event having a position equal to or greater than
\fIN\fR\&. This option applies to the last log file named on the command line\&. \fIN\fR\&. This option applies to the last log file named on the command line\&.
.sp
This option is useful for point\-in\-time recovery\&. See
Section\ \&6.3, \(lqExample Backup and Recovery Strategy\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -779,7 +957,7 @@ The MySQL user name to use when connecting to a remote server\&. ...@@ -779,7 +957,7 @@ The MySQL user name to use when connecting to a remote server\&.
\fB\-\-verbose\fR, \fB\-\-verbose\fR,
\fB\-v\fR \fB\-v\fR
.sp .sp
Reconstruct row events and display them as commented SQL statements\&. If given twice, the output includes comments to indicate column data types and some metadata\&. This option was added in MySQL 5\&.1\&.28\&. Reconstruct row events and display them as commented SQL statements\&. If this option is given twice, the output includes comments to indicate column data types and some metadata\&. This option was added in MySQL 5\&.1\&.28\&.
.sp .sp
For examples that show the effect of For examples that show the effect of
\fB\-\-base64\-output\fR \fB\-\-base64\-output\fR
...@@ -804,33 +982,6 @@ the section called \(lqMYSQLBINLOG ROW EVENT DISPLAY\(rq\&. ...@@ -804,33 +982,6 @@ the section called \(lqMYSQLBINLOG ROW EVENT DISPLAY\(rq\&.
.sp .sp
Display version information and exit\&. Display version information and exit\&.
.RE .RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: write-binlog option
.\" write-binlog option: mysqlbinlog
\fB\-\-write\-binlog\fR
.sp
This option is enabled by default, so that
ANALYZE TABLE,
OPTIMIZE TABLE, and
REPAIR TABLE
statements generated by
\fBmysqlcheck\fR
are written to the binary log\&. Use
\fB\-\-skip\-write\-binlog\fR
to cause
NO_WRITE_TO_BINLOG
to be added to the statements so that they are not logged\&. Use the
\fB\-\-skip\-write\-binlog\fR
when these statements should not be sent to replication slaves or run when using the binary logs for recovery from backup\&. This option was added in MySQL 5\&.1\&.18\&.
.RE
.PP .PP
You can also set the following variable by using You can also set the following variable by using
\fB\-\-\fR\fB\fIvar_name\fR\fR\fB=\fR\fB\fIvalue\fR\fR \fB\-\-\fR\fB\fIvar_name\fR\fR\fB=\fR\fB\fIvalue\fR\fR
...@@ -854,14 +1005,14 @@ You can pipe the output of ...@@ -854,14 +1005,14 @@ You can pipe the output of
\fBmysqlbinlog\fR \fBmysqlbinlog\fR
into the into the
\fBmysql\fR \fBmysql\fR
client to execute the statements contained in the binary log\&. This is used to recover from a crash when you have an old backup (see client to execute the events contained in the binary log\&. This technique is used to recover from a crash when you have an old backup (see
Section\ \&6.1, \(lqDatabase Backup Methods\(rq)\&. For example: Section\ \&6.5, \(lqPoint-in-Time (Incremental) Recovery Using the Binary Log\(rq)\&. For example:
.sp .sp
.if n \{\ .if n \{\
.RS 4 .RS 4
.\} .\}
.nf .nf
shell> \fBmysqlbinlog binlog\&.000001 | mysql\fR shell> \fBmysqlbinlog binlog\&.000001 | mysql \-u root \-p\fR
.fi .fi
.if n \{\ .if n \{\
.RE .RE
...@@ -873,7 +1024,7 @@ Or: ...@@ -873,7 +1024,7 @@ Or:
.RS 4 .RS 4
.\} .\}
.nf .nf
shell> \fBmysqlbinlog binlog\&.[0\-9]* | mysql\fR shell> \fBmysqlbinlog binlog\&.[0\-9]* | mysql \-u root \-p\fR
.fi .fi
.if n \{\ .if n \{\
.RE .RE
...@@ -883,12 +1034,25 @@ You can also redirect the output of ...@@ -883,12 +1034,25 @@ You can also redirect the output of
\fBmysqlbinlog\fR \fBmysqlbinlog\fR
to a text file instead, if you need to modify the statement log first (for example, to remove statements that you do not want to execute for some reason)\&. After editing the file, execute the statements that it contains by using it as input to the to a text file instead, if you need to modify the statement log first (for example, to remove statements that you do not want to execute for some reason)\&. After editing the file, execute the statements that it contains by using it as input to the
\fBmysql\fR \fBmysql\fR
program\&. program:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysqlbinlog binlog\&.000001 > tmpfile\fR
shell> \&.\&.\&. \fIedit tmpfile\fR \&.\&.\&.
shell> \fBmysql \-u root \-p < tmpfile\fR
.fi
.if n \{\
.RE
.\}
.PP .PP
When
\fBmysqlbinlog\fR \fBmysqlbinlog\fR
has the is invoked with the
\fB\-\-start\-position\fR \fB\-\-start\-position\fR
option, which prints only those statements with an offset in the binary log greater than or equal to a given position (the given position must match the start of one event)\&. It also has options to stop and start when it sees an event with a given date and time\&. This enables you to perform point\-in\-time recovery using the option, it displays only those events with an offset in the binary log greater than or equal to a given position (the given position must match the start of one event)\&. It also has options to stop and start when it sees an event with a given date and time\&. This enables you to perform point\-in\-time recovery using the
\fB\-\-stop\-datetime\fR \fB\-\-stop\-datetime\fR
option (to be able to say, for example, option (to be able to say, for example,
\(lqroll forward my databases to how they were today at 10:30 a\&.m\&.\(rq)\&. \(lqroll forward my databases to how they were today at 10:30 a\&.m\&.\(rq)\&.
...@@ -900,8 +1064,8 @@ If you have more than one binary log to execute on the MySQL server, the safe me ...@@ -900,8 +1064,8 @@ If you have more than one binary log to execute on the MySQL server, the safe me
.RS 4 .RS 4
.\} .\}
.nf .nf
shell> \fBmysqlbinlog binlog\&.000001 | mysql # DANGER!!\fR shell> \fBmysqlbinlog binlog\&.000001 | mysql \-u root \-p # DANGER!!\fR
shell> \fBmysqlbinlog binlog\&.000002 | mysql # DANGER!!\fR shell> \fBmysqlbinlog binlog\&.000002 | mysql \-u root \-p # DANGER!!\fR
.fi .fi
.if n \{\ .if n \{\
.RE .RE
...@@ -918,13 +1082,14 @@ process attempts to use the table, the server reports ...@@ -918,13 +1082,14 @@ process attempts to use the table, the server reports
.PP .PP
To avoid problems like this, use a To avoid problems like this, use a
\fIsingle\fR \fIsingle\fR
connection to execute the contents of all binary logs that you want to process\&. Here is one way to do so: \fBmysql\fR
process to execute the contents of all binary logs that you want to process\&. Here is one way to do so:
.sp .sp
.if n \{\ .if n \{\
.RS 4 .RS 4
.\} .\}
.nf .nf
shell> \fBmysqlbinlog binlog\&.000001 binlog\&.000002 | mysql\fR shell> \fBmysqlbinlog binlog\&.000001 binlog\&.000002 | mysql \-u root \-p\fR
.fi .fi
.if n \{\ .if n \{\
.RE .RE
...@@ -938,7 +1103,7 @@ Another approach is to write all the logs to a single file and then process the ...@@ -938,7 +1103,7 @@ Another approach is to write all the logs to a single file and then process the
.nf .nf
shell> \fBmysqlbinlog binlog\&.000001 > /tmp/statements\&.sql\fR shell> \fBmysqlbinlog binlog\&.000001 > /tmp/statements\&.sql\fR
shell> \fBmysqlbinlog binlog\&.000002 >> /tmp/statements\&.sql\fR shell> \fBmysqlbinlog binlog\&.000002 >> /tmp/statements\&.sql\fR
shell> \fBmysql \-e "source /tmp/statements\&.sql"\fR shell> \fBmysql \-u root \-p \-e "source /tmp/statements\&.sql"\fR
.fi .fi
.if n \{\ .if n \{\
.RE .RE
...@@ -962,10 +1127,10 @@ LOAD DATA INFILE ...@@ -962,10 +1127,10 @@ LOAD DATA INFILE
statements to statements to
LOAD DATA LOCAL INFILE LOAD DATA LOCAL INFILE
statements (that is, it adds statements (that is, it adds
LOCAL), both the client and the server that you use to process the statements must be configured to allow LOCAL), both the client and the server that you use to process the statements must be configured with the
LOCAL LOCAL
capability\&. See capability enabled\&. See
Section\ \&5.3.4, \(lqSecurity Issues with LOAD DATA LOCAL\(rq\&. Section\ \&5.3.5, \(lqSecurity Issues with LOAD DATA LOCAL\(rq\&.
.if n \{\ .if n \{\
.sp .sp
.\} .\}
...@@ -991,7 +1156,9 @@ automatically deleted because they are needed until you actually execute those s ...@@ -991,7 +1156,9 @@ automatically deleted because they are needed until you actually execute those s
.PP .PP
The The
\fB\-\-hexdump\fR \fB\-\-hexdump\fR
option produces a hex dump of the log contents: option causes
\fBmysqlbinlog\fR
to produce a hex dump of the binary log contents:
.sp .sp
.if n \{\ .if n \{\
.RS 4 .RS 4
...@@ -1029,7 +1196,8 @@ ROLLBACK; ...@@ -1029,7 +1196,8 @@ ROLLBACK;
.RE .RE
.\} .\}
.PP .PP
Hex dump output currently contains the following elements\&. This format is subject to change\&. Hex dump output currently contains the elements in the following list\&. This format is subject to change\&. (For more information about binary log format, see
\m[blue]\fB\%http://forge.mysql.com/wiki/MySQL_Internals_Binary_Log\fR\m[]\&.)
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
...@@ -1796,7 +1964,7 @@ option can be used to prevent this header from being written\&. ...@@ -1796,7 +1964,7 @@ option can be used to prevent this header from being written\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
...@@ -1808,7 +1976,7 @@ You should have received a copy of the GNU General Public License along with the ...@@ -1808,7 +1976,7 @@ You should have received a copy of the GNU General Public License along with the
.IP " 1." 4 .IP " 1." 4
Bug#42941 Bug#42941
.RS 4 .RS 4
\%http://bugs.mysql.com/42941 \%http://bugs.mysql.com/bug.php?id=42941
.RE .RE
.SH "SEE ALSO" .SH "SEE ALSO"
For more information, please refer to the MySQL Reference Manual, For more information, please refer to the MySQL Reference Manual,
......
man/mysqlbug.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysqlbug\fR .\" Title: \fBmysqlbug\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQLBUG\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQLBUG\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -26,7 +26,7 @@ mysqlbug \- generate bug report ...@@ -26,7 +26,7 @@ mysqlbug \- generate bug report
\fBmysqlbug\fR \fBmysqlbug\fR
.SH "DESCRIPTION" .SH "DESCRIPTION"
.PP .PP
This program enables you to generate a bug report and send it to Sun Microsystems, Inc\&. It is a shell script and runs on Unix\&. This program enables you to generate a bug report and send it to Oracle Corporation\&. It is a shell script and runs on Unix\&.
.PP .PP
The normal way to report bugs is to visit The normal way to report bugs is to visit
\m[blue]\fB\%http://bugs.mysql.com/\fR\m[], which is the address for our bugs database\&. This database is public and can be browsed and searched by anyone\&. If you log in to the system, you can enter new reports\&. If you have no Web access, you can generate a bug report by using the \m[blue]\fB\%http://bugs.mysql.com/\fR\m[], which is the address for our bugs database\&. This database is public and can be browsed and searched by anyone\&. If you log in to the system, you can enter new reports\&. If you have no Web access, you can generate a bug report by using the
...@@ -62,7 +62,7 @@ will send the report by email\&. ...@@ -62,7 +62,7 @@ will send the report by email\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysqlcheck.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysqlcheck\fR .\" Title: \fBmysqlcheck\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQLCHECK\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQLCHECK\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -37,7 +37,7 @@ client performs table maintenance: It checks, repairs, optimizes, or analyzes ta ...@@ -37,7 +37,7 @@ client performs table maintenance: It checks, repairs, optimizes, or analyzes ta
Each table is locked and therefore unavailable to other sessions while it is being processed, although for check operations, the table is locked with a Each table is locked and therefore unavailable to other sessions while it is being processed, although for check operations, the table is locked with a
READ READ
lock only (see lock only (see
Section\ \&12.4.5, \(lqLOCK TABLES and UNLOCK TABLES Syntax\(rq, for more information about Section\ \&12.3.5, \(lqLOCK TABLES and UNLOCK TABLES Syntax\(rq, for more information about
READ READ
and and
WRITE WRITE
...@@ -72,7 +72,7 @@ REPAIR TABLE, ...@@ -72,7 +72,7 @@ REPAIR TABLE,
ANALYZE TABLE, and ANALYZE TABLE, and
OPTIMIZE TABLE OPTIMIZE TABLE
in a convenient way for the user\&. It determines which statements to use for the operation you want to perform, and then sends the statements to the server to be executed\&. For details about which storage engines each statement works with, see the descriptions for those statements in in a convenient way for the user\&. It determines which statements to use for the operation you want to perform, and then sends the statements to the server to be executed\&. For details about which storage engines each statement works with, see the descriptions for those statements in
Section\ \&12.5.2, \(lqTable Maintenance Statements\(rq\&. Section\ \&12.4.2, \(lqTable Maintenance Statements\(rq\&.
.PP .PP
The The
MyISAM MyISAM
...@@ -135,8 +135,8 @@ There are three general ways to invoke ...@@ -135,8 +135,8 @@ There are three general ways to invoke
.RS 4 .RS 4
.\} .\}
.nf .nf
shell> \fBmysqlcheck [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIdb_name\fR\fR\fB [\fR\fB\fItables\fR\fR\fB]\fR shell> \fBmysqlcheck [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIdb_name\fR\fR\fB [\fR\fB\fItbl_name\fR\fR\fB \&.\&.\&.]\fR
shell> \fBmysqlcheck [\fR\fB\fIoptions\fR\fR\fB] \-\-databases \fR\fB\fIdb_name1\fR\fR\fB [\fR\fB\fIdb_name2\fR\fR\fB \fR\fB\fIdb_name3\fR\fR\fB\&.\&.\&.]\fR shell> \fBmysqlcheck [\fR\fB\fIoptions\fR\fR\fB] \-\-databases \fR\fB\fIdb_name\fR\fR\fB \&.\&.\&.\fR
shell> \fBmysqlcheck [\fR\fB\fIoptions\fR\fR\fB] \-\-all\-databases\fR shell> \fBmysqlcheck [\fR\fB\fIoptions\fR\fR\fB] \-\-all\-databases\fR
.fi .fi
.if n \{\ .if n \{\
...@@ -188,7 +188,13 @@ T} ...@@ -188,7 +188,13 @@ T}
.sp 1 .sp 1
.PP .PP
\fBmysqlcheck\fR \fBmysqlcheck\fR
supports the options in the following list\&. It also reads option files and supports the options for processing them described at supports the following options, which can be specified on the command line or in the
[mysqlcheck]
and
[client]
option file groups\&.
\fBmysqlcheck\fR
also supports the options for processing option files described at
Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&. Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&.
.sp .sp
.RS 4 .RS 4
...@@ -285,7 +291,7 @@ If a checked table is corrupted, automatically fix it\&. Any necessary repairs a ...@@ -285,7 +291,7 @@ If a checked table is corrupted, automatically fix it\&. Any necessary repairs a
\fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR \fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR
.sp .sp
The directory where character sets are installed\&. See The directory where character sets are installed\&. See
Section\ \&9.2, \(lqThe Character Set Used for Data and Sorting\(rq\&. Section\ \&9.5, \(lqCharacter Set Configuration\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -444,7 +450,7 @@ Print debugging information and memory and CPU usage statistics when the program ...@@ -444,7 +450,7 @@ Print debugging information and memory and CPU usage statistics when the program
Use Use
\fIcharset_name\fR \fIcharset_name\fR
as the default character set\&. See as the default character set\&. See
Section\ \&9.2, \(lqThe Character Set Used for Data and Sorting\(rq\&. Section\ \&9.5, \(lqCharacter Set Configuration\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -598,10 +604,12 @@ value following the ...@@ -598,10 +604,12 @@ value following the
\fB\-\-password\fR \fB\-\-password\fR
or or
\fB\-p\fR \fB\-p\fR
option on the command line, you are prompted for one\&. option on the command line,
\fBmysqlcheck\fR
prompts for one\&.
.sp .sp
Specifying a password on the command line should be considered insecure\&. See Specifying a password on the command line should be considered insecure\&. See
Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&. Section\ \&5.3.2.2, \(lqEnd-User Guidelines for Password Security\(rq\&. You can use an option file to avoid giving the password on the command line\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -617,7 +625,7 @@ Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&. ...@@ -617,7 +625,7 @@ Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&.
\fB\-\-pipe\fR, \fB\-\-pipe\fR,
\fB\-W\fR \fB\-W\fR
.sp .sp
On Windows, connect to the server via a named pipe\&. This option applies only for connections to a local server, and only if the server supports named\-pipe connections\&. On Windows, connect to the server via a named pipe\&. This option applies only if the server supports named\-pipe connections\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -734,7 +742,7 @@ localhost, the Unix socket file to use, or, on Windows, the name of the named pi ...@@ -734,7 +742,7 @@ localhost, the Unix socket file to use, or, on Windows, the name of the named pi
Options that begin with Options that begin with
\fB\-\-ssl\fR \fB\-\-ssl\fR
specify whether to connect to the server via SSL and indicate where to find SSL keys and certificates\&. See specify whether to connect to the server via SSL and indicate where to find SSL keys and certificates\&. See
Section\ \&5.5.7.3, \(lqSSL Command Options\(rq\&. Section\ \&5.5.6.3, \(lqSSL Command Options\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -824,10 +832,37 @@ Verbose mode\&. Print information about the various stages of program operation\ ...@@ -824,10 +832,37 @@ Verbose mode\&. Print information about the various stages of program operation\
.sp .sp
Display version information and exit\&. Display version information and exit\&.
.RE .RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: write-binlog option
.\" write-binlog option: mysqlcheck
\fB\-\-write\-binlog\fR
.sp
This option is enabled by default, so that
ANALYZE TABLE,
OPTIMIZE TABLE, and
REPAIR TABLE
statements generated by
\fBmysqlcheck\fR
are written to the binary log\&. Use
\fB\-\-skip\-write\-binlog\fR
to cause
NO_WRITE_TO_BINLOG
to be added to the statements so that they are not logged\&. Use the
\fB\-\-skip\-write\-binlog\fR
when these statements should not be sent to replication slaves or run when using the binary logs for recovery from backup\&. This option was added in MySQL 5\&.1\&.18\&.
.RE
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysqld.8
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysqld\fR .\" Title: \fBmysqld\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQLD\FR" "8" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQLD\FR" "8" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -53,7 +53,7 @@ Chapter\ \&2, Installing and Upgrading MySQL\&. ...@@ -53,7 +53,7 @@ Chapter\ \&2, Installing and Upgrading MySQL\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysqld_multi.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysqld_multi\fR .\" Title: \fBmysqld_multi\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQLD_MULTI\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQLD_MULTI\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -227,7 +227,7 @@ pass the ...@@ -227,7 +227,7 @@ pass the
options to instances, so these techniques are inapplicable\&. options to instances, so these techniques are inapplicable\&.
.PP .PP
\fBmysqld_multi\fR \fBmysqld_multi\fR
supports the following options: supports the following options\&.
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
...@@ -258,6 +258,8 @@ Display a help message and exit\&. ...@@ -258,6 +258,8 @@ Display a help message and exit\&.
.sp .sp
As of MySQL 5\&.1\&.18, this option is deprecated\&. If given, it is treated the same way as As of MySQL 5\&.1\&.18, this option is deprecated\&. If given, it is treated the same way as
\fB\-\-defaults\-extra\-file\fR, described earlier\&. \fB\-\-defaults\-extra\-file\fR, described earlier\&.
\fB\-\-config\-file\fR
is removed in MySQL 5\&.5\&.
.sp .sp
Before MySQL 5\&.1\&.18, this option specifies the name of an extra option file\&. It affects where Before MySQL 5\&.1\&.18, this option specifies the name of an extra option file\&. It affects where
\fBmysqld_multi\fR \fBmysqld_multi\fR
...@@ -534,7 +536,7 @@ use the Unix ...@@ -534,7 +536,7 @@ use the Unix
account for this, unless you account for this, unless you
\fIknow\fR \fIknow\fR
what you are doing\&. See what you are doing\&. See
Section\ \&5.3.5, \(lqHow to Run MySQL as a Normal User\(rq\&. Section\ \&5.3.6, \(lqHow to Run MySQL as a Normal User\(rq\&.
.sp .5v .sp .5v
.RE .RE
.RE .RE
...@@ -726,7 +728,7 @@ Section\ \&4.2.3.3, \(lqUsing Option Files\(rq\&. ...@@ -726,7 +728,7 @@ Section\ \&4.2.3.3, \(lqUsing Option Files\(rq\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysqld_safe.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysqld_safe\fR .\" Title: \fBmysqld_safe\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQLD_SAFE\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQLD_SAFE\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -842,7 +842,7 @@ file in the data directory\&. ...@@ -842,7 +842,7 @@ file in the data directory\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysqldump.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysqldump\fR .\" Title: \fBmysqldump\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQLDUMP\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQLDUMP\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -50,8 +50,8 @@ There are three general ways to invoke ...@@ -50,8 +50,8 @@ There are three general ways to invoke
.RS 4 .RS 4
.\} .\}
.nf .nf
shell> \fBmysqldump [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIdb_name\fR\fR\fB [\fR\fB\fItables\fR\fR\fB]\fR shell> \fBmysqldump [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIdb_name\fR\fR\fB [\fR\fB\fItbl_name\fR\fR\fB \&.\&.\&.]\fR
shell> \fBmysqldump [\fR\fB\fIoptions\fR\fR\fB] \-\-databases \fR\fB\fIdb_name1\fR\fR\fB [\fR\fB\fIdb_name2\fR\fR\fB \fR\fB\fIdb_name3\fR\fR\fB\&.\&.\&.]\fR shell> \fBmysqldump [\fR\fB\fIoptions\fR\fR\fB] \-\-databases \fR\fB\fIdb_name\fR\fR\fB \&.\&.\&.\fR
shell> \fBmysqldump [\fR\fB\fIoptions\fR\fR\fB] \-\-all\-databases\fR shell> \fBmysqldump [\fR\fB\fIoptions\fR\fR\fB] \-\-all\-databases\fR
.fi .fi
.if n \{\ .if n \{\
...@@ -69,36 +69,70 @@ option, entire databases are dumped\&. ...@@ -69,36 +69,70 @@ option, entire databases are dumped\&.
\fBmysqldump\fR \fBmysqldump\fR
does not dump the does not dump the
INFORMATION_SCHEMA INFORMATION_SCHEMA
database\&. If you name that database explicitly on the command line, database by default\&. As of MySQL 5\&.1\&.38,
\fBmysqldump\fR \fBmysqldump\fR
silently ignores it\&. dumps
INFORMATION_SCHEMA
if you name it explicitly on the command line, although currently you must also use the
\fB\-\-skip\-lock\-tables\fR
option\&. Before 5\&.1\&.38,
\fBmysqldump\fR
silently ignores
INFORMATION_SCHEMA
even if you name it explicitly on the command line\&.
.PP .PP
To get a list of the options your version of To see a list of the options your version of
\fBmysqldump\fR \fBmysqldump\fR
supports, execute supports, execute
\fBmysqldump \-\-help\fR\&. \fBmysqldump \-\-help\fR\&.
.PP .PP
Some Some
\fBmysqldump\fR \fBmysqldump\fR
options are shorthand for groups of other options\&. options are shorthand for groups of other options:
\fB\-\-opt\fR .sp
and .RS 4
\fB\-\-compact\fR .ie n \{\
fall into this category\&. For example, use of \h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Use of
\fB\-\-opt\fR \fB\-\-opt\fR
is the same as specifying is the same as specifying
\fB\-\-add\-drop\-table\fR \fB\-\-add\-drop\-table\fR,
\fB\-\-add\-locks\fR \fB\-\-add\-locks\fR,
\fB\-\-create\-options\fR \fB\-\-create\-options\fR,
\fB\-\-disable\-keys\fR \fB\-\-disable\-keys\fR,
\fB\-\-extended\-insert\fR \fB\-\-extended\-insert\fR,
\fB\-\-lock\-tables\fR \fB\-\-lock\-tables\fR,
\fB\-\-quick\fR \fB\-\-quick\fR, and
\fB\-\-set\-charset\fR\&. Note that all of the options that \fB\-\-set\-charset\fR\&. All of the options that
\fB\-\-opt\fR \fB\-\-opt\fR
stands for also are on by default because stands for also are on by default because
\fB\-\-opt\fR \fB\-\-opt\fR
is on by default\&. is on by default\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Use of
\fB\-\-compact\fR
is the same as specifying
\fB\-\-skip\-add\-drop\-table\fR,
\fB\-\-skip\-add\-locks\fR,
\fB\-\-skip\-comments\fR,
\fB\-\-skip\-disable\-keys\fR, and
\fB\-\-skip\-set\-charset\fR
options\&.
.RE
.PP .PP
To reverse the effect of a group option, uses its To reverse the effect of a group option, uses its
\fB\-\-skip\-\fR\fB\fIxxx\fR\fR \fB\-\-skip\-\fR\fB\fIxxx\fR\fR
...@@ -118,10 +152,10 @@ To select the effect of ...@@ -118,10 +152,10 @@ To select the effect of
\fB\-\-opt\fR \fB\-\-opt\fR
except for some features, use the except for some features, use the
\fB\-\-skip\fR \fB\-\-skip\fR
option for each feature\&. For example, to disable extended inserts and memory buffering, use option for each feature\&. To disable extended inserts and memory buffering, use
\fB\-\-opt\fR \fB\-\-opt\fR
\fB\-\-skip\-extended\-insert\fR \fB\-\-skip\-extended\-insert\fR
\fB\-\-skip\-quick\fR\&. (As of MySQL 5\&.1, \fB\-\-skip\-quick\fR\&. (Actually,
\fB\-\-skip\-extended\-insert\fR \fB\-\-skip\-extended\-insert\fR
\fB\-\-skip\-quick\fR \fB\-\-skip\-quick\fR
is sufficient because is sufficient because
...@@ -161,7 +195,7 @@ option (or ...@@ -161,7 +195,7 @@ option (or
\fB\-\-quick\fR)\&. The \fB\-\-quick\fR)\&. The
\fB\-\-opt\fR \fB\-\-opt\fR
option (and hence option (and hence
\fB\-\-quick\fR) is enabled by default in MySQL 5\&.1; to enable memory buffering, use \fB\-\-quick\fR) is enabled by default, so to enable memory buffering, use
\fB\-\-skip\-quick\fR\&. \fB\-\-skip\-quick\fR\&.
.PP .PP
If you are using a recent version of If you are using a recent version of
...@@ -187,12 +221,18 @@ instead\&. ...@@ -187,12 +221,18 @@ instead\&.
.br .br
.PP .PP
\fBmysqldump\fR \fBmysqldump\fR
from the MySQL 5\&.1\&.21 distribution cannot be used to create dumps from MySQL server versions 5\&.1\&.20 and older\&. This issue is fixed in MySQL 5\&.1\&.22\&. (\m[blue]\fBBug#30123\fR\m[]\&\s-2\u[1]\d\s+2) from MySQL 5\&.1\&.21 cannot be used to create dumps from MySQL server 5\&.1\&.20 and older\&. This issue is fixed in MySQL 5\&.1\&.22\&. (\m[blue]\fBBug#30123\fR\m[]\&\s-2\u[1]\d\s+2)
.sp .5v .sp .5v
.RE .RE
.PP .PP
\fBmysqldump\fR \fBmysqldump\fR
supports the options in the following list\&. It also reads option files and supports the options for processing them described at supports the following options, which can be specified on the command line or in the
[mysqldump]
and
[client]
option file groups\&.
\fBmysqldump\fR
also supports the options for processing option files described at
Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&. Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&.
.sp .sp
.RS 4 .RS 4
...@@ -227,7 +267,13 @@ Add a ...@@ -227,7 +267,13 @@ Add a
DROP DATABASE DROP DATABASE
statement before each statement before each
CREATE DATABASE CREATE DATABASE
statement\&. statement\&. This option is typically used in conjunction with the
\fB\-\-all\-databases\fR
or
\fB\-\-databases\fR
option because no
CREATE DATABASE
statements are written unless one of those options is specified\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -336,7 +382,7 @@ Allow creation of column names that are keywords\&. This works by prefixing each ...@@ -336,7 +382,7 @@ Allow creation of column names that are keywords\&. This works by prefixing each
\fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR \fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR
.sp .sp
The directory where character sets are installed\&. See The directory where character sets are installed\&. See
Section\ \&9.2, \(lqThe Character Set Used for Data and Sorting\(rq\&. Section\ \&9.5, \(lqCharacter Set Configuration\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -368,7 +414,7 @@ Write additional information in the dump file such as program version, server ve ...@@ -368,7 +414,7 @@ Write additional information in the dump file such as program version, server ve
.\" compact option: mysqldump .\" compact option: mysqldump
\fB\-\-compact\fR \fB\-\-compact\fR
.sp .sp
Produce less verbose output\&. This option enables the Produce more compact output\&. This option enables the
\fB\-\-skip\-add\-drop\-table\fR, \fB\-\-skip\-add\-drop\-table\fR,
\fB\-\-skip\-add\-locks\fR, \fB\-\-skip\-add\-locks\fR,
\fB\-\-skip\-comments\fR, \fB\-\-skip\-comments\fR,
...@@ -387,7 +433,7 @@ options\&. ...@@ -387,7 +433,7 @@ options\&.
\fBNote\fR \fBNote\fR
.ps -1 .ps -1
.br .br
Prior to release 5\&.1\&.21, this option did not create valid SQL if the database dump contained views\&. The recreation of views requires the creation and removal of temporary tables and this option suppressed the removal of those temporary tables\&. As a workaround, use Prior to MySQL 5\&.1\&.21, this option did not create valid SQL if the database dump contained views\&. The recreation of views requires the creation and removal of temporary tables and this option suppressed the removal of those temporary tables\&. As a workaround, use
\fB\-\-compact\fR \fB\-\-compact\fR
with the with the
\fB\-\-add\-drop\-table\fR \fB\-\-add\-drop\-table\fR
...@@ -409,7 +455,7 @@ option and then manually adjust the dump file\&. ...@@ -409,7 +455,7 @@ option and then manually adjust the dump file\&.
\fB\-\-compatible=\fR\fB\fIname\fR\fR \fB\-\-compatible=\fR\fB\fIname\fR\fR
.sp .sp
Produce output that is more compatible with other database systems or with older MySQL servers\&. The value of Produce output that is more compatible with other database systems or with older MySQL servers\&. The value of
name \fIname\fR
can be can be
ansi, ansi,
mysql323, mysql323,
...@@ -569,7 +615,7 @@ Print debugging information and memory and CPU usage statistics when the program ...@@ -569,7 +615,7 @@ Print debugging information and memory and CPU usage statistics when the program
Use Use
\fIcharset_name\fR \fIcharset_name\fR
as the default character set\&. See as the default character set\&. See
Section\ \&9.2, \(lqThe Character Set Used for Data and Sorting\(rq\&. If no character set is specified, Section\ \&9.5, \(lqCharacter Set Configuration\(rq\&. If no character set is specified,
\fBmysqldump\fR \fBmysqldump\fR
uses uses
utf8, and earlier versions use utf8, and earlier versions use
...@@ -611,7 +657,9 @@ statements\&. ...@@ -611,7 +657,9 @@ statements\&.
.\" delete-master-logs option: mysqldump .\" delete-master-logs option: mysqldump
\fB\-\-delete\-master\-logs\fR \fB\-\-delete\-master\-logs\fR
.sp .sp
On a master replication server, delete the binary logs after performing the dump operation\&. This option automatically enables On a master replication server, delete the binary logs by sending a
PURGE BINARY LOGS
statement to the server after performing the dump operation\&. This option automatically enables
\fB\-\-master\-data\fR\&. \fB\-\-master\-data\fR\&.
.RE .RE
.sp .sp
...@@ -651,12 +699,23 @@ tables\&. ...@@ -651,12 +699,23 @@ tables\&.
.\" dump-date option: mysqldump .\" dump-date option: mysqldump
\fB\-\-dump\-date\fR \fB\-\-dump\-date\fR
.sp .sp
If the
\fB\-\-comments\fR
option is given,
\fBmysqldump\fR \fBmysqldump\fR
produces a produces a comment at the end of the dump of the following form:
.sp
.if n \{\
.RS 4
.\}
.nf
\-\- Dump completed on \fIDATE\fR \-\- Dump completed on \fIDATE\fR
comment at the end of the dump if the .fi
\fB\-\-comments\fR .if n \{\
option is given\&. However, the date causes dump files for identical data take at different times to appear to be different\&. .RE
.\}
.sp
However, the date causes dump files taken at different times to appear to be different, even if the data are otherwise identical\&.
\fB\-\-dump\-date\fR \fB\-\-dump\-date\fR
and and
\fB\-\-skip\-dump\-date\fR \fB\-\-skip\-dump\-date\fR
...@@ -680,7 +739,7 @@ suppresses date printing\&. This option was added in MySQL 5\&.1\&.23\&. ...@@ -680,7 +739,7 @@ suppresses date printing\&. This option was added in MySQL 5\&.1\&.23\&.
\fB\-\-events\fR, \fB\-\-events\fR,
\fB\-E\fR \fB\-E\fR
.sp .sp
Dump events from the dumped databases\&. This option was added in MySQL 5\&.1\&.8\&. Include Event Scheduler events for the dumped databases in the output\&. This option was added in MySQL 5\&.1\&.8\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -725,8 +784,10 @@ lists\&. This results in a smaller dump file and speeds up inserts when the file ...@@ -725,8 +784,10 @@ lists\&. This results in a smaller dump file and speeds up inserts when the file
\fB\-\-fields\-escaped\-by=\&.\&.\&.\fR \fB\-\-fields\-escaped\-by=\&.\&.\&.\fR
.sp .sp
These options are used with the These options are used with the
\fB\-T\fR \fB\-\-tab\fR
option and have the same meaning as the corresponding clauses for option and have the same meaning as the corresponding
FIELDS
clauses for
LOAD DATA INFILE\&. See LOAD DATA INFILE\&. See
Section\ \&12.2.6, \(lqLOAD DATA INFILE Syntax\(rq\&. Section\ \&12.2.6, \(lqLOAD DATA INFILE Syntax\(rq\&.
.RE .RE
...@@ -741,11 +802,13 @@ Section\ \&12.2.6, \(lqLOAD DATA INFILE Syntax\(rq\&. ...@@ -741,11 +802,13 @@ Section\ \&12.2.6, \(lqLOAD DATA INFILE Syntax\(rq\&.
.\} .\}
.\" mysqldump: first-slave option .\" mysqldump: first-slave option
.\" first-slave option: mysqldump .\" first-slave option: mysqldump
\fB\-\-first\-slave\fR, \fB\-\-first\-slave\fR
\fB\-x\fR
.sp .sp
Deprecated\&. Now renamed to Deprecated\&. Use
\fB\-\-lock\-all\-tables\fR\&. \fB\-\-lock\-all\-tables\fR
instead\&.
\fB\-\-first\-slave\fR
is removed in MySQL 5\&.5\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -763,10 +826,9 @@ Deprecated\&. Now renamed to ...@@ -763,10 +826,9 @@ Deprecated\&. Now renamed to
.sp .sp
Flush the MySQL server log files before starting the dump\&. This option requires the Flush the MySQL server log files before starting the dump\&. This option requires the
RELOAD RELOAD
privilege\&. Note that if you use this option in combination with the privilege\&. If you use this option in combination with the
\fB\-\-all\-databases\fR \fB\-\-all\-databases\fR
(or option, the logs are flushed
\fB\-A\fR) option, the logs are flushed
\fIfor each database dumped\fR\&. The exception is when using \fIfor each database dumped\fR\&. The exception is when using
\fB\-\-lock\-all\-tables\fR \fB\-\-lock\-all\-tables\fR
or or
...@@ -790,9 +852,9 @@ or ...@@ -790,9 +852,9 @@ or
.\" flush-privileges option: mysqldump .\" flush-privileges option: mysqldump
\fB\-\-flush\-privileges\fR \fB\-\-flush\-privileges\fR
.sp .sp
Emit a Send a
FLUSH PRIVILEGES FLUSH PRIVILEGES
statement after dumping the statement to the server after dumping the
mysql mysql
database\&. This option should be used any time the dump contains the database\&. This option should be used any time the dump contains the
mysql mysql
...@@ -861,8 +923,9 @@ Dump binary columns using hexadecimal notation (for example, ...@@ -861,8 +923,9 @@ Dump binary columns using hexadecimal notation (for example,
becomes becomes
0x616263)\&. The affected data types are 0x616263)\&. The affected data types are
BINARY, BINARY,
VARBINARY, VARBINARY, the
BLOB, and BLOB
types, and
BIT\&. BIT\&.
.RE .RE
.sp .sp
...@@ -894,10 +957,10 @@ Do not dump the given table, which must be specified using both the database and ...@@ -894,10 +957,10 @@ Do not dump the given table, which must be specified using both the database and
\fB\-\-insert\-ignore\fR \fB\-\-insert\-ignore\fR
.sp .sp
Write Write
INSERT IGNORE
statements rather than
INSERT INSERT
statements with the statements\&.
IGNORE
option\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -913,8 +976,10 @@ option\&. ...@@ -913,8 +976,10 @@ option\&.
\fB\-\-lines\-terminated\-by=\&.\&.\&.\fR \fB\-\-lines\-terminated\-by=\&.\&.\&.\fR
.sp .sp
This option is used with the This option is used with the
\fB\-T\fR \fB\-\-tab\fR
option and has the same meaning as the corresponding clause for option and has the same meaning as the corresponding
LINES
clause for
LOAD DATA INFILE\&. See LOAD DATA INFILE\&. See
Section\ \&12.2.6, \(lqLOAD DATA INFILE Syntax\(rq\&. Section\ \&12.2.6, \(lqLOAD DATA INFILE Syntax\(rq\&.
.RE .RE
...@@ -951,18 +1016,20 @@ and ...@@ -951,18 +1016,20 @@ and
\fB\-\-lock\-tables\fR, \fB\-\-lock\-tables\fR,
\fB\-l\fR \fB\-l\fR
.sp .sp
Lock all tables before dumping them\&. The tables are locked with For each dumped database, lock all tables to be dumped before dumping them\&. The tables are locked with
READ LOCAL READ LOCAL
to allow concurrent inserts in the case of to allow concurrent inserts in the case of
MyISAM MyISAM
tables\&. For transactional tables such as tables\&. For transactional tables such as
InnoDB, InnoDB,
\fB\-\-single\-transaction\fR \fB\-\-single\-transaction\fR
is a much better option, because it does not need to lock the tables at all\&. is a much better option than
\fB\-\-lock\-tables\fR
because it does not need to lock the tables at all\&.
.sp .sp
Please note that when dumping multiple databases, Because
\fB\-\-lock\-tables\fR \fB\-\-lock\-tables\fR
locks tables for each database separately\&. Therefore, this option does not guarantee that the tables in the dump file are logically consistent between databases\&. Tables in different databases may be dumped in completely different states\&. locks tables for each database separately, this option does not guarantee that the tables in the dump file are logically consistent between databases\&. Tables in different databases may be dumped in completely different states\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -977,7 +1044,7 @@ locks tables for each database separately\&. Therefore, this option does not gua ...@@ -977,7 +1044,7 @@ locks tables for each database separately\&. Therefore, this option does not gua
.\" log-error option: mysqldump .\" log-error option: mysqldump
\fB\-\-log\-error=\fR\fB\fIfile_name\fR\fR \fB\-\-log\-error=\fR\fB\fIfile_name\fR\fR
.sp .sp
Append warnings and errors to the named file\&. This option was added in MySQL 5\&.1\&.18\&. Log warnings and errors by appending them to the named file\&. The default is to do no logging\&. This option was added in MySQL 5\&.1\&.18\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -994,11 +1061,11 @@ Append warnings and errors to the named file\&. This option was added in MySQL 5 ...@@ -994,11 +1061,11 @@ Append warnings and errors to the named file\&. This option was added in MySQL 5
.sp .sp
Use this option to dump a master replication server to produce a dump file that can be used to set up another server as a slave of the master\&. It causes the dump output to include a Use this option to dump a master replication server to produce a dump file that can be used to set up another server as a slave of the master\&. It causes the dump output to include a
CHANGE MASTER TO CHANGE MASTER TO
statement that indicates the binary log coordinates (file name and position) of the dumped server\&. These are the master server coordinates from which the slave should start replicating\&. statement that indicates the binary log coordinates (file name and position) of the dumped server\&. These are the master server coordinates from which the slave should start replicating after you load the dump file into the slave\&.
.sp .sp
If the option value is 2, the If the option value is 2, the
CHANGE MASTER TO CHANGE MASTER TO
statement is written as an SQL comment, and thus is informative only; it has no effect when the dump file is reloaded\&. If the option value is 1, the statement takes effect when the dump file is reloaded\&. If the option value is not specified, the default value is 1\&. statement is written as an SQL comment, and thus is informative only; it has no effect when the dump file is reloaded\&. If the option value is 1, the statement is not written as a comment and takes effect when the dump file is reloaded\&. If no option value is specified, the default value is 1\&.
.sp .sp
This option requires the This option requires the
RELOAD RELOAD
...@@ -1045,7 +1112,16 @@ mysql> \fBSHOW SLAVE STATUS;\fR ...@@ -1045,7 +1112,16 @@ mysql> \fBSHOW SLAVE STATUS;\fR
.sp -1 .sp -1
.IP " 2." 4.2 .IP " 2." 4.2
.\} .\}
From the output of the SHOW SLAVE STATUS statement, get the binary log coordinates of the master server from which the new slave should start replicating\&. These coordinates are the values of the Relay_Master_Log_File and Exec_Master_Log_Pos values\&. Denote those values as file_name and file_pos\&. From the output of the
SHOW SLAVE STATUS
statement, the binary log coordinates of the master server from which the new slave should start replicating are the values of the
Relay_Master_Log_File
and
Exec_Master_Log_Pos
fields\&. Denote those values as
\fIfile_name\fR
and
\fIfile_pos\fR\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1098,7 +1174,7 @@ mysql> \fBSTART SLAVE;\fR ...@@ -1098,7 +1174,7 @@ mysql> \fBSTART SLAVE;\fR
.sp -1 .sp -1
.IP " 5." 4.2 .IP " 5." 4.2
.\} .\}
On the new slave, reload the dump file: On the new slave, load the dump file:
.sp .sp
.if n \{\ .if n \{\
.RS 4 .RS 4
...@@ -1126,7 +1202,7 @@ On the new slave, set the replication coordinates to those of the master server ...@@ -1126,7 +1202,7 @@ On the new slave, set the replication coordinates to those of the master server
.\} .\}
.nf .nf
mysql> \fBCHANGE MASTER TO\fR mysql> \fBCHANGE MASTER TO\fR
\-> \fBMASTER_LOG_FILE = \'file_name\', MASTER_LOG_POS = file_pos;\fR \-> \fBMASTER_LOG_FILE = \'\fR\fB\fIfile_name\fR\fR\fB\', MASTER_LOG_POS = \fR\fB\fIfile_pos\fR\fR\fB;\fR
.fi .fi
.if n \{\ .if n \{\
.RE .RE
...@@ -1214,9 +1290,9 @@ statements that re\-create each dumped table\&. ...@@ -1214,9 +1290,9 @@ statements that re\-create each dumped table\&.
\fB\-\-no\-data\fR, \fB\-\-no\-data\fR,
\fB\-d\fR \fB\-d\fR
.sp .sp
Do not write any table row information (that is, do not dump table contents)\&. This is very useful if you want to dump only the Do not write any table row information (that is, do not dump table contents)\&. This is useful if you want to dump only the
CREATE TABLE CREATE TABLE
statement for the table\&. statement for the table (for example, to create an empty copy of the table by loading the dump file)\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1229,11 +1305,11 @@ statement for the table\&. ...@@ -1229,11 +1305,11 @@ statement for the table\&.
.\} .\}
.\" mysqldump: no-set-names option .\" mysqldump: no-set-names option
.\" no-set-names option: mysqldump .\" no-set-names option: mysqldump
\fB\-\-no\-set\-names\fR \fB\-\-no\-set\-names\fR,
\fB\-N\fR
.sp .sp
This option is deprecated\&. Use This has the same effect as
\fB\-\-skip\-set\-charset\fR \fB\-\-skip\-set\-charset\fR\&.
instead\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1248,7 +1324,7 @@ instead\&. ...@@ -1248,7 +1324,7 @@ instead\&.
.\" opt option: mysqldump .\" opt option: mysqldump
\fB\-\-opt\fR \fB\-\-opt\fR
.sp .sp
This option is shorthand; it is the same as specifying This option is shorthand\&. It is the same as specifying
\fB\-\-add\-drop\-table\fR \fB\-\-add\-drop\-table\fR
\fB\-\-add\-locks\fR \fB\-\-add\-locks\fR
\fB\-\-create\-options\fR \fB\-\-create\-options\fR
...@@ -1259,7 +1335,7 @@ This option is shorthand; it is the same as specifying ...@@ -1259,7 +1335,7 @@ This option is shorthand; it is the same as specifying
\fB\-\-set\-charset\fR\&. It should give you a fast dump operation and produce a dump file that can be reloaded into a MySQL server quickly\&. \fB\-\-set\-charset\fR\&. It should give you a fast dump operation and produce a dump file that can be reloaded into a MySQL server quickly\&.
.sp .sp
\fIThe \fR\fI\fB\-\-opt\fR\fR\fI option is enabled by default\&. Use \fR\fI\fB\-\-skip\-opt\fR\fR\fI to disable it\&.\fR \fIThe \fR\fI\fB\-\-opt\fR\fR\fI option is enabled by default\&. Use \fR\fI\fB\-\-skip\-opt\fR\fR\fI to disable it\&.\fR
See the discussion at the beginning of this section for information about selectively enabling or disabling certain of the options affected by See the discussion at the beginning of this section for information about selectively enabling or disabling a subset of the options affected by
\fB\-\-opt\fR\&. \fB\-\-opt\fR\&.
.RE .RE
.sp .sp
...@@ -1275,11 +1351,11 @@ See the discussion at the beginning of this section for information about select ...@@ -1275,11 +1351,11 @@ See the discussion at the beginning of this section for information about select
.\" order-by-primary option: mysqldump .\" order-by-primary option: mysqldump
\fB\-\-order\-by\-primary\fR \fB\-\-order\-by\-primary\fR
.sp .sp
Sort each table\'s rows by its primary key, or by its first unique index, if such an index exists\&. This is useful when dumping a Dump each table\'s rows sorted by its primary key, or by its first unique index, if such an index exists\&. This is useful when dumping a
MyISAM MyISAM
table to be loaded into an table to be loaded into an
InnoDB InnoDB
table, but will make the dump itself take considerably longer\&. table, but will make the dump operation take considerably longer\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1303,10 +1379,12 @@ value following the ...@@ -1303,10 +1379,12 @@ value following the
\fB\-\-password\fR \fB\-\-password\fR
or or
\fB\-p\fR \fB\-p\fR
option on the command line, you are prompted for one\&. option on the command line,
\fBmysqldump\fR
prompts for one\&.
.sp .sp
Specifying a password on the command line should be considered insecure\&. See Specifying a password on the command line should be considered insecure\&. See
Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&. Section\ \&5.3.2.2, \(lqEnd-User Guidelines for Password Security\(rq\&. You can use an option file to avoid giving the password on the command line\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1322,7 +1400,7 @@ Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&. ...@@ -1322,7 +1400,7 @@ Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&.
\fB\-\-pipe\fR, \fB\-\-pipe\fR,
\fB\-W\fR \fB\-W\fR
.sp .sp
On Windows, connect to the server via a named pipe\&. This option applies only for connections to a local server, and only if the server supports named\-pipe connections\&. On Windows, connect to the server via a named pipe\&. This option applies only if the server supports named\-pipe connections\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1388,11 +1466,11 @@ to retrieve rows for a table from the server a row at a time rather than retriev ...@@ -1388,11 +1466,11 @@ to retrieve rows for a table from the server a row at a time rather than retriev
\fB\-\-quote\-names\fR, \fB\-\-quote\-names\fR,
\fB\-Q\fR \fB\-Q\fR
.sp .sp
Quote database, table, and column names within Quote identifiers (such as database, table, and column names) within
\(lq`\(rq \(lq`\(rq
characters\&. If the characters\&. If the
ANSI_QUOTES ANSI_QUOTES
SQL mode is enabled, names are quoted within SQL mode is enabled, identifiers are quoted within
\(lq"\(rq \(lq"\(rq
characters\&. This option is enabled by default\&. It can be disabled with characters\&. This option is enabled by default\&. It can be disabled with
\fB\-\-skip\-quote\-names\fR, but this option should be given after any option such as \fB\-\-skip\-quote\-names\fR, but this option should be given after any option such as
...@@ -1417,7 +1495,7 @@ Write ...@@ -1417,7 +1495,7 @@ Write
REPLACE REPLACE
statements rather than statements rather than
INSERT INSERT
statements\&. Available as of MySQL 5\&.1\&.3\&. statements\&. This option was added in MySQL 5\&.1\&.3\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1437,7 +1515,7 @@ Direct output to a given file\&. This option should be used on Windows to preven ...@@ -1437,7 +1515,7 @@ Direct output to a given file\&. This option should be used on Windows to preven
\(lq\en\(rq \(lq\en\(rq
characters from being converted to characters from being converted to
\(lq\er\en\(rq \(lq\er\en\(rq
carriage return/newline sequences\&. The result file is created and its contents overwritten, even if an error occurs while generating the dump\&. The previous contents are lost\&. carriage return/newline sequences\&. The result file is created and its previous contents overwritten, even if an error occurs while generating the dump\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1453,7 +1531,7 @@ carriage return/newline sequences\&. The result file is created and its contents ...@@ -1453,7 +1531,7 @@ carriage return/newline sequences\&. The result file is created and its contents
\fB\-\-routines\fR, \fB\-\-routines\fR,
\fB\-R\fR \fB\-R\fR
.sp .sp
Dump stored routines (procedures and functions) from the dumped databases\&. Use of this option requires the Included stored routines (procedures and functions) for the dumped databases in the output\&. Use of this option requires the
SELECT SELECT
privilege for the privilege for the
mysql\&.proc mysql\&.proc
...@@ -1511,9 +1589,9 @@ statement, use ...@@ -1511,9 +1589,9 @@ statement, use
.\" single-transaction option: mysqldump .\" single-transaction option: mysqldump
\fB\-\-single\-transaction\fR \fB\-\-single\-transaction\fR
.sp .sp
This option issues a This option sends a
BEGIN START TRANSACTION
SQL statement before dumping data from the server\&. It is useful only with transactional tables such as SQL statement to the server before dumping data\&. It is useful only with transactional tables such as
InnoDB, because then it dumps the consistent state of the database at the time when InnoDB, because then it dumps the consistent state of the database at the time when
BEGIN BEGIN
was issued without blocking any applications\&. was issued without blocking any applications\&.
...@@ -1528,16 +1606,25 @@ tables dumped while using this option may still change state\&. ...@@ -1528,16 +1606,25 @@ tables dumped while using this option may still change state\&.
.sp .sp
While a While a
\fB\-\-single\-transaction\fR \fB\-\-single\-transaction\fR
dump is in process, to ensure a valid dump file (correct table contents and binary log position), no other connection should use the following statements: dump is in process, to ensure a valid dump file (correct table contents and binary log coordinates), no other connection should use the following statements:
ALTER TABLE, ALTER TABLE,
CREATE TABLE,
DROP TABLE, DROP TABLE,
RENAME TABLE, RENAME TABLE,
TRUNCATE TABLE\&. A consistent read is not isolated from those statements, so use of them on a table to be dumped can cause the TRUNCATE TABLE\&. A consistent read is not isolated from those statements, so use of them on a table to be dumped can cause the
SELECT SELECT
performed by that is performed by
\fBmysqldump\fR \fBmysqldump\fR
to retrieve the table contents to obtain incorrect contents or fail\&. to retrieve the table contents to obtain incorrect contents or fail\&.
.sp .sp
The
\fB\-\-single\-transaction\fR
option and the
\fB\-\-lock\-tables\fR
option are mutually exclusive because
LOCK TABLES
causes any pending transactions to be committed implicitly\&.
.sp
This option is not supported for MySQL Cluster tables; the results cannot be guaranteed to be consistent due to the fact that the This option is not supported for MySQL Cluster tables; the results cannot be guaranteed to be consistent due to the fact that the
NDBCLUSTER NDBCLUSTER
storage engine supports only the storage engine supports only the
...@@ -1546,15 +1633,9 @@ transaction isolation level\&. You should always use ...@@ -1546,15 +1633,9 @@ transaction isolation level\&. You should always use
NDB NDB
backup and restore instead\&. backup and restore instead\&.
.sp .sp
The To dump large tables, you should combine the
\fB\-\-single\-transaction\fR \fB\-\-single\-transaction\fR
option and the option with
\fB\-\-lock\-tables\fR
option are mutually exclusive, because
LOCK TABLES
causes any pending transactions to be committed implicitly\&.
.sp
To dump large tables, you should combine this option with
\fB\-\-quick\fR\&. \fB\-\-quick\fR\&.
.RE .RE
.sp .sp
...@@ -1624,7 +1705,7 @@ localhost, the Unix socket file to use, or, on Windows, the name of the named pi ...@@ -1624,7 +1705,7 @@ localhost, the Unix socket file to use, or, on Windows, the name of the named pi
Options that begin with Options that begin with
\fB\-\-ssl\fR \fB\-\-ssl\fR
specify whether to connect to the server via SSL and indicate where to find SSL keys and certificates\&. See specify whether to connect to the server via SSL and indicate where to find SSL keys and certificates\&. See
Section\ \&5.5.7.3, \(lqSSL Command Options\(rq\&. Section\ \&5.5.6.3, \(lqSSL Command Options\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1640,29 +1721,15 @@ Section\ \&5.5.7.3, \(lqSSL Command Options\(rq\&. ...@@ -1640,29 +1721,15 @@ Section\ \&5.5.7.3, \(lqSSL Command Options\(rq\&.
\fB\-\-tab=\fR\fB\fIpath\fR\fR, \fB\-\-tab=\fR\fB\fIpath\fR\fR,
\fB\-T \fR\fB\fIpath\fR\fR \fB\-T \fR\fB\fIpath\fR\fR
.sp .sp
Produce tab\-separated data files\&. For each dumped table, Produce tab\-separated text\-format data files\&. For each dumped table,
\fBmysqldump\fR \fBmysqldump\fR
creates a creates a
\fItbl_name\fR\&.sql \fItbl_name\fR\&.sql
file that contains the file that contains the
CREATE TABLE CREATE TABLE
statement that creates the table, and a statement that creates the table, and the server writes a
\fItbl_name\fR\&.txt \fItbl_name\fR\&.txt
file that contains its data\&. The option value is the directory in which to write the files\&. file that contains its data\&. The option value is the directory in which to write the files\&.
.sp
By default, the
\&.txt
data files are formatted using tab characters between column values and a newline at the end of each line\&. The format can be specified explicitly using the
\fB\-\-fields\-\fR\fB\fIxxx\fR\fR
and
\fB\-\-lines\-terminated\-by\fR
options\&.
.sp
As of MySQL 5\&.1\&.38, column values are written converted to the character set specified by the
\fB\-\-default\-character\-set\fR
option\&. Prior to 5\&.1\&.38 or if no such option is present, values are dumped using the
binary
character set\&. In effect, there is no character set conversion\&. If a table contains columns in several character sets, the output data file will as well and you may not be able to reload the file correctly\&.
.if n \{\ .if n \{\
.sp .sp
.\} .\}
...@@ -1684,6 +1751,19 @@ FILE ...@@ -1684,6 +1751,19 @@ FILE
privilege, and the server must have permission to write files in the directory that you specify\&. privilege, and the server must have permission to write files in the directory that you specify\&.
.sp .5v .sp .5v
.RE .RE
By default, the
\&.txt
data files are formatted using tab characters between column values and a newline at the end of each line\&. The format can be specified explicitly using the
\fB\-\-fields\-\fR\fB\fIxxx\fR\fR
and
\fB\-\-lines\-terminated\-by\fR
options\&.
.sp
As of MySQL 5\&.1\&.38, column values are converted to the character set specified by the
\fB\-\-default\-character\-set\fR
option\&. Prior to 5\&.1\&.38 or if no such option is present, values are dumped using the
binary
character set\&. In effect, there is no character set conversion\&. If a table contains columns in several character sets, the output data file will as well and you may not be able to reload the file correctly\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -1719,7 +1799,7 @@ regards all name arguments following the option as table names\&. ...@@ -1719,7 +1799,7 @@ regards all name arguments following the option as table names\&.
.\" triggers option: mysqldump .\" triggers option: mysqldump
\fB\-\-triggers\fR \fB\-\-triggers\fR
.sp .sp
Dump triggers for each dumped table\&. This option is enabled by default; disable it with Include triggers for each dumped table in the output\&. This option is enabled by default; disable it with
\fB\-\-skip\-triggers\fR\&. \fB\-\-skip\-triggers\fR\&.
.RE .RE
.sp .sp
...@@ -1743,7 +1823,7 @@ sets its connection time zone to UTC and adds ...@@ -1743,7 +1823,7 @@ sets its connection time zone to UTC and adds
SET TIME_ZONE=\'+00:00\' SET TIME_ZONE=\'+00:00\'
to the dump file\&. Without this option, to the dump file\&. Without this option,
TIMESTAMP TIMESTAMP
columns are dumped and reloaded in the time zones local to the source and destination servers, which can cause the values to change\&. columns are dumped and reloaded in the time zones local to the source and destination servers, which can cause the values to change if the servers are in different time zones\&.
\fB\-\-tz\-utc\fR \fB\-\-tz\-utc\fR
also protects against changes due to daylight saving time\&. also protects against changes due to daylight saving time\&.
\fB\-\-tz\-utc\fR \fB\-\-tz\-utc\fR
...@@ -1846,7 +1926,7 @@ Examples: ...@@ -1846,7 +1926,7 @@ Examples:
.sp .sp
Write dump output as well\-formed XML\&. Write dump output as well\-formed XML\&.
.sp .sp
\fBNULL\fR\fB, \fR\fB\'NULL\'\fR\fB, and Empty Values\fR: For some column named \fBNULL\fR\fB, \fR\fB\'NULL\'\fR\fB, and Empty Values\fR: For a column named
\fIcolumn_name\fR, the \fIcolumn_name\fR, the
NULL NULL
value, an empty string, and the string value value, an empty string, and the string value
...@@ -1884,7 +1964,7 @@ Beginning with MySQL 5\&.1\&.12, the output from the ...@@ -1884,7 +1964,7 @@ Beginning with MySQL 5\&.1\&.12, the output from the
\fBmysql\fR \fBmysql\fR
client when run using the client when run using the
\fB\-\-xml\fR \fB\-\-xml\fR
option also follows these rules\&. (See option also follows the preceding rules\&. (See
the section called \(lqMYSQL OPTIONS\(rq\&.) the section called \(lqMYSQL OPTIONS\(rq\&.)
.sp .sp
Beginning with MySQL 5\&.1\&.18, XML output from Beginning with MySQL 5\&.1\&.18, XML output from
...@@ -1905,11 +1985,13 @@ shell> \fBmysqldump \-\-xml \-u root world City\fR ...@@ -1905,11 +1985,13 @@ shell> \fBmysqldump \-\-xml \-u root world City\fR
<field Field="CountryCode" Type="char(3)" Null="NO" Key="" Default="" Extra="" /> <field Field="CountryCode" Type="char(3)" Null="NO" Key="" Default="" Extra="" />
<field Field="District" Type="char(20)" Null="NO" Key="" Default="" Extra="" /> <field Field="District" Type="char(20)" Null="NO" Key="" Default="" Extra="" />
<field Field="Population" Type="int(11)" Null="NO" Key="" Default="0" Extra="" /> <field Field="Population" Type="int(11)" Null="NO" Key="" Default="0" Extra="" />
<key Table="City" Non_unique="0" Key_name="PRIMARY" Seq_in_index="1" Column_name="ID" Collation="A" Cardinality="4079" <key Table="City" Non_unique="0" Key_name="PRIMARY" Seq_in_index="1" Column_name="ID"
Null="" Index_type="BTREE" Comment="" /> Collation="A" Cardinality="4079" Null="" Index_type="BTREE" Comment="" />
<options Name="City" Engine="MyISAM" Version="10" Row_format="Fixed" Rows="4079" Avg_row_length="67" Data_length="27329 <options Name="City" Engine="MyISAM" Version="10" Row_format="Fixed" Rows="4079"
3" Max_data_length="18858823439613951" Index_length="43008" Data_free="0" Auto_increment="4080" Create_time="2007\-03\-31 01:47:01" Updat Avg_row_length="67" Data_length="273293" Max_data_length="18858823439613951"
e_time="2007\-03\-31 01:47:02" Collation="latin1_swedish_ci" Create_options="" Comment="" /> Index_length="43008" Data_free="0" Auto_increment="4080"
Create_time="2007\-03\-31 01:47:01" Update_time="2007\-03\-31 01:47:02"
Collation="latin1_swedish_ci" Create_options="" Comment="" />
</table_structure> </table_structure>
<table_data name="City"> <table_data name="City">
<row> <row>
...@@ -1964,10 +2046,13 @@ The maximum size of the buffer for client/server communication\&. The maximum is ...@@ -1964,10 +2046,13 @@ The maximum size of the buffer for client/server communication\&. The maximum is
.\} .\}
net_buffer_length net_buffer_length
.sp .sp
The initial size of the buffer for client/server communication\&. When creating multiple\-row\-insert statements (as with option The initial size of the buffer for client/server communication\&. When creating multiple\-row
INSERT
statements (as with the
\fB\-\-extended\-insert\fR \fB\-\-extended\-insert\fR
or or
\fB\-\-opt\fR), \fB\-\-opt\fR
option),
\fBmysqldump\fR \fBmysqldump\fR
creates rows up to creates rows up to
net_buffer_length net_buffer_length
...@@ -1976,9 +2061,9 @@ net_buffer_length ...@@ -1976,9 +2061,9 @@ net_buffer_length
variable in the MySQL server is at least this large\&. variable in the MySQL server is at least this large\&.
.RE .RE
.PP .PP
The most common use of A common use of
\fBmysqldump\fR \fBmysqldump\fR
is probably for making a backup of an entire database: is for making a backup of an entire database:
.sp .sp
.if n \{\ .if n \{\
.RS 4 .RS 4
...@@ -1990,7 +2075,7 @@ shell> \fBmysqldump \fR\fB\fIdb_name\fR\fR\fB > \fR\fB\fIbackup\-file\&.sql\fR\f ...@@ -1990,7 +2075,7 @@ shell> \fBmysqldump \fR\fB\fIdb_name\fR\fR\fB > \fR\fB\fIbackup\-file\&.sql\fR\f
.RE .RE
.\} .\}
.PP .PP
You can read the dump file back into the server like this: You can load the dump file back into the server like this:
.sp .sp
.if n \{\ .if n \{\
.RS 4 .RS 4
...@@ -2072,7 +2157,7 @@ shell> \fBmysqldump \-\-all\-databases \-\-single\-transaction > all_databases\& ...@@ -2072,7 +2157,7 @@ shell> \fBmysqldump \-\-all\-databases \-\-single\-transaction > all_databases\&
This backup acquires a global read lock on all tables (using This backup acquires a global read lock on all tables (using
FLUSH TABLES WITH READ LOCK) at the beginning of the dump\&. As soon as this lock has been acquired, the binary log coordinates are read and the lock is released\&. If long updating statements are running when the FLUSH TABLES WITH READ LOCK) at the beginning of the dump\&. As soon as this lock has been acquired, the binary log coordinates are read and the lock is released\&. If long updating statements are running when the
FLUSH FLUSH
statement is issued, the MySQL server may get stalled until those statements finish\&. After that, the dump becomes lock\-free and does not disturb reads and writes on the tables\&. If the update statements that the MySQL server receives are short (in terms of execution time), the initial lock period should not be noticeable, even with many updates\&. statement is issued, the MySQL server may get stalled until those statements finish\&. After that, the dump becomes lock free and does not disturb reads and writes on the tables\&. If the update statements that the MySQL server receives are short (in terms of execution time), the initial lock period should not be noticeable, even with many updates\&.
.PP .PP
For point\-in\-time recovery (also known as For point\-in\-time recovery (also known as
\(lqroll\-forward,\(rq \(lqroll\-forward,\(rq
...@@ -2106,13 +2191,13 @@ The ...@@ -2106,13 +2191,13 @@ The
\fB\-\-master\-data\fR \fB\-\-master\-data\fR
and and
\fB\-\-single\-transaction\fR \fB\-\-single\-transaction\fR
options can be used simultaneously, which provides a convenient way to make an online backup suitable for point\-in\-time recovery if tables are stored using the options can be used simultaneously, which provides a convenient way to make an online backup suitable for use prior to point\-in\-time recovery if tables are stored using the
InnoDB InnoDB
storage engine\&. storage engine\&.
.PP .PP
For more information on making backups, see For more information on making backups, see
Section\ \&6.1, \(lqDatabase Backup Methods\(rq, and Section\ \&6.2, \(lqDatabase Backup Methods\(rq, and
Section\ \&6.2, \(lqExample Backup and Recovery Strategy\(rq\&. Section\ \&6.3, \(lqExample Backup and Recovery Strategy\(rq\&.
.\" mysqldump: views .\" mysqldump: views
.\" mysqldump: problems .\" mysqldump: problems
.\" mysqldump: workarounds .\" mysqldump: workarounds
...@@ -2122,7 +2207,7 @@ Section\ \&D.4, \(lqRestrictions on Views\(rq\&. ...@@ -2122,7 +2207,7 @@ Section\ \&D.4, \(lqRestrictions on Views\(rq\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
...@@ -2134,7 +2219,7 @@ You should have received a copy of the GNU General Public License along with the ...@@ -2134,7 +2219,7 @@ You should have received a copy of the GNU General Public License along with the
.IP " 1." 4 .IP " 1." 4
Bug#30123 Bug#30123
.RS 4 .RS 4
\%http://bugs.mysql.com/30123 \%http://bugs.mysql.com/bug.php?id=30123
.RE .RE
.SH "SEE ALSO" .SH "SEE ALSO"
For more information, please refer to the MySQL Reference Manual, For more information, please refer to the MySQL Reference Manual,
......
man/mysqldumpslow.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysqldumpslow\fR .\" Title: \fBmysqldumpslow\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQLDUMPSLOW\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQLDUMPSLOW\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -60,7 +60,7 @@ shell> \fBmysqldumpslow [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIlog_file\fR\fR\fB ...@@ -60,7 +60,7 @@ shell> \fBmysqldumpslow [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIlog_file\fR\fR\fB
.\} .\}
.PP .PP
\fBmysqldumpslow\fR \fBmysqldumpslow\fR
supports the following options: supports the following options\&.
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
...@@ -309,7 +309,7 @@ Count: 3 Time=2\&.13s (6s) Lock=0\&.00s (0s) Rows=0\&.0 (0), root[root]@local ...@@ -309,7 +309,7 @@ Count: 3 Time=2\&.13s (6s) Lock=0\&.00s (0s) Rows=0\&.0 (0), root[root]@local
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysqlhotcopy.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysqlhotcopy\fR .\" Title: \fBmysqlhotcopy\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQLHOTCOPY\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQLHOTCOPY\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -32,18 +32,28 @@ mysqlhotcopy \- a database backup program ...@@ -32,18 +32,28 @@ mysqlhotcopy \- a database backup program
.PP .PP
\fBmysqlhotcopy\fR \fBmysqlhotcopy\fR
is a Perl script that was originally written and contributed by Tim Bunce\&. It uses is a Perl script that was originally written and contributed by Tim Bunce\&. It uses
LOCK TABLES, FLUSH TABLES,
FLUSH TABLES, and LOCK TABLES, and
cp cp
or or
scp scp
to make a database backup quickly\&. It is the fastest way to make a backup of the database or single tables, but it can be run only on the same machine where the database directories are located\&. to make a database backup\&. It is a fast way to make a backup of the database or single tables, but it can be run only on the same machine where the database directories are located\&.
\fBmysqlhotcopy\fR \fBmysqlhotcopy\fR
works only for backing up works only for backing up
MyISAM MyISAM
and and
ARCHIVE ARCHIVE
tables\&. It runs on Unix and NetWare\&. tables\&. It runs on Unix and NetWare\&.
.PP
To use
\fBmysqlhotcopy\fR, you must have read access to the files for the tables that you are backing up, the
SELECT
privilege for those tables, the
RELOAD
privilege (to be able to execute
FLUSH TABLES), and the
LOCK TABLES
privilege (to be able to lock the tables)\&.
.sp .sp
.if n \{\ .if n \{\
.RS 4 .RS 4
...@@ -90,7 +100,11 @@ shell> \fBmysqlhotcopy \fR\fB\fIdb_name\fR\fR\fB\&./~\fR\fB\fIregex\fR\fR\fB/\fR ...@@ -90,7 +100,11 @@ shell> \fBmysqlhotcopy \fR\fB\fIdb_name\fR\fR\fB\&./~\fR\fB\fIregex\fR\fR\fB/\fR
.\} .\}
.PP .PP
\fBmysqlhotcopy\fR \fBmysqlhotcopy\fR
supports the following options: supports the following options, which can be specified on the command line or in the
[mysqlhotcopy]
and
[client]
option file groups\&.
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
...@@ -275,7 +289,8 @@ Do not delete previous (renamed) target when done\&. ...@@ -275,7 +289,8 @@ Do not delete previous (renamed) target when done\&.
.sp .sp
The method for copying files (cp The method for copying files (cp
or or
scp)\&. scp)\&. The default is
cp\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -290,7 +305,9 @@ scp)\&. ...@@ -290,7 +305,9 @@ scp)\&.
.\" noindices option: mysqlhotcopy .\" noindices option: mysqlhotcopy
\fB\-\-noindices\fR \fB\-\-noindices\fR
.sp .sp
Do not include full index files in the backup\&. This makes the backup smaller and faster\&. The indexes for reloaded tables can be reconstructed later with Do not include full index files for
MyISAM
tables in the backup\&. This makes the backup smaller and faster\&. The indexes for reloaded tables can be reconstructed later with
\fBmyisamchk \-rq\fR\&. \fBmyisamchk \-rq\fR\&.
.RE .RE
.sp .sp
...@@ -307,10 +324,10 @@ Do not include full index files in the backup\&. This makes the backup smaller a ...@@ -307,10 +324,10 @@ Do not include full index files in the backup\&. This makes the backup smaller a
\fB\-\-password=\fR\fB\fIpassword\fR\fR, \fB\-\-password=\fR\fB\fIpassword\fR\fR,
\fB\-p\fR\fB\fIpassword\fR\fR \fB\-p\fR\fB\fIpassword\fR\fR
.sp .sp
The password to use when connecting to the server\&. Note that the password value is not optional for this option, unlike for other MySQL programs\&. You can use an option file to avoid giving the password on the command line\&. The password to use when connecting to the server\&. The password value is not optional for this option, unlike for other MySQL programs\&.
.sp .sp
Specifying a password on the command line should be considered insecure\&. See Specifying a password on the command line should be considered insecure\&. See
Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&. Section\ \&5.3.2.2, \(lqEnd-User Guidelines for Password Security\(rq\&. You can use an option file to avoid giving the password on the command line\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -423,7 +440,8 @@ file after locking all the tables\&. ...@@ -423,7 +440,8 @@ file after locking all the tables\&.
\fB\-\-socket=\fR\fB\fIpath\fR\fR, \fB\-\-socket=\fR\fB\fIpath\fR\fR,
\fB\-S \fR\fB\fIpath\fR\fR \fB\-S \fR\fB\fIpath\fR\fR
.sp .sp
The Unix socket file to use for the connection\&. The Unix socket file to use for connections to
localhost\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -438,7 +456,7 @@ The Unix socket file to use for the connection\&. ...@@ -438,7 +456,7 @@ The Unix socket file to use for the connection\&.
.\" suffix option: mysqlhotcopy .\" suffix option: mysqlhotcopy
\fB\-\-suffix=\fR\fB\fIstr\fR\fR \fB\-\-suffix=\fR\fB\fIstr\fR\fR
.sp .sp
The suffix for names of copied databases\&. The suffix to use for names of copied databases\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -473,23 +491,6 @@ The temporary directory\&. The default is ...@@ -473,23 +491,6 @@ The temporary directory\&. The default is
The MySQL user name to use when connecting to the server\&. The MySQL user name to use when connecting to the server\&.
.RE .RE
.PP .PP
\fBmysqlhotcopy\fR
reads the
[client]
and
[mysqlhotcopy]
option groups from option files\&.
.PP
To execute
\fBmysqlhotcopy\fR, you must have access to the files for the tables that you are backing up, the
SELECT
privilege for those tables, the
RELOAD
privilege (to be able to execute
FLUSH TABLES), and the
LOCK TABLES
privilege (to be able to lock the tables)\&.
.PP
Use Use
perldoc perldoc
for additional for additional
...@@ -512,7 +513,7 @@ shell> \fBperldoc mysqlhotcopy\fR ...@@ -512,7 +513,7 @@ shell> \fBperldoc mysqlhotcopy\fR
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysqlimport.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysqlimport\fR .\" Title: \fBmysqlimport\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQLIMPORT\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQLIMPORT\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -64,8 +64,18 @@ patient ...@@ -64,8 +64,18 @@ patient
all would be imported into a table named all would be imported into a table named
patient\&. patient\&.
.PP .PP
\fBmysqlimport\fR For additional information about
supports the options in the following list\&. It also reads option files and supports the options for processing them described at \fBmysqldump\fR, see
Section\ \&6.4, \(lqUsing mysqldump for Backups\(rq\&.
.PP
\fBmysqldump\fR
supports the following options, which can be specified on the command line or in the
[mysqldump]
and
[client]
option file groups\&.
\fBmysqldump\fR
also supports the options for processing option files described at
Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&. Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&.
.sp .sp
.RS 4 .RS 4
...@@ -97,7 +107,7 @@ Display a help message and exit\&. ...@@ -97,7 +107,7 @@ Display a help message and exit\&.
\fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR \fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR
.sp .sp
The directory where character sets are installed\&. See The directory where character sets are installed\&. See
Section\ \&9.2, \(lqThe Character Set Used for Data and Sorting\(rq\&. Section\ \&9.5, \(lqCharacter Set Configuration\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -197,7 +207,7 @@ Print debugging information and memory and CPU usage statistics when the program ...@@ -197,7 +207,7 @@ Print debugging information and memory and CPU usage statistics when the program
Use Use
\fIcharset_name\fR \fIcharset_name\fR
as the default character set\&. See as the default character set\&. See
Section\ \&9.2, \(lqThe Character Set Used for Data and Sorting\(rq\&. Section\ \&9.5, \(lqCharacter Set Configuration\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -379,8 +389,9 @@ tables for writing before processing any text files\&. This ensures that all tab ...@@ -379,8 +389,9 @@ tables for writing before processing any text files\&. This ensures that all tab
.sp .sp
Use Use
LOW_PRIORITY LOW_PRIORITY
when loading the table\&. This affects only storage engines that use only table\-level locking (MyISAM, when loading the table\&. This affects only storage engines that use only table\-level locking (such as
MEMORY, MyISAM,
MEMORY, and
MERGE)\&. MERGE)\&.
.RE .RE
.sp .sp
...@@ -405,10 +416,12 @@ value following the ...@@ -405,10 +416,12 @@ value following the
\fB\-\-password\fR \fB\-\-password\fR
or or
\fB\-p\fR \fB\-p\fR
option on the command line, you are prompted for one\&. option on the command line,
\fBmysqlimport\fR
prompts for one\&.
.sp .sp
Specifying a password on the command line should be considered insecure\&. See Specifying a password on the command line should be considered insecure\&. See
Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&. Section\ \&5.3.2.2, \(lqEnd-User Guidelines for Password Security\(rq\&. You can use an option file to avoid giving the password on the command line\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -424,7 +437,7 @@ Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&. ...@@ -424,7 +437,7 @@ Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&.
\fB\-\-pipe\fR, \fB\-\-pipe\fR,
\fB\-W\fR \fB\-W\fR
.sp .sp
On Windows, connect to the server via a named pipe\&. This option applies only for connections to a local server, and only if the server supports named\-pipe connections\&. On Windows, connect to the server via a named pipe\&. This option applies only if the server supports named\-pipe connections\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -529,7 +542,7 @@ localhost, the Unix socket file to use, or, on Windows, the name of the named pi ...@@ -529,7 +542,7 @@ localhost, the Unix socket file to use, or, on Windows, the name of the named pi
Options that begin with Options that begin with
\fB\-\-ssl\fR \fB\-\-ssl\fR
specify whether to connect to the server via SSL and indicate where to find SSL keys and certificates\&. See specify whether to connect to the server via SSL and indicate where to find SSL keys and certificates\&. See
Section\ \&5.5.7.3, \(lqSSL Command Options\(rq\&. Section\ \&5.5.6.3, \(lqSSL Command Options\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -633,7 +646,7 @@ shell> \fBmysql \-e \'SELECT * FROM imptest\' test\fR ...@@ -633,7 +646,7 @@ shell> \fBmysql \-e \'SELECT * FROM imptest\' test\fR
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysqlmanager.8
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysqlmanager\fR .\" Title: \fBmysqlmanager\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQLMANAGER\FR" "8" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQLMANAGER\FR" "8" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -153,7 +153,7 @@ in the directory where Instance Manager is installed\&. On Unix, the standard fi ...@@ -153,7 +153,7 @@ in the directory where Instance Manager is installed\&. On Unix, the standard fi
option\&. option\&.
.PP .PP
\fBmysqlmanager\fR \fBmysqlmanager\fR
supports the options described in the following list\&. The options for managing entries in the password file are described further in supports the following options\&. The options for managing entries in the password file are described further in
the section called \(lqINSTANCE MANAGER USER AND PASSWORD MANAGEMENT\(rq\&. the section called \(lqINSTANCE MANAGER USER AND PASSWORD MANAGEMENT\(rq\&.
.sp .sp
.RS 4 .RS 4
...@@ -2062,7 +2062,7 @@ Query OK, 0 rows affected (0\&.04 sec) ...@@ -2062,7 +2062,7 @@ Query OK, 0 rows affected (0\&.04 sec)
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysqlshow.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysqlshow\fR .\" Title: \fBmysqlshow\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQLSHOW\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQLSHOW\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -39,7 +39,7 @@ client can be used to quickly see which databases exist, their tables, or a tabl ...@@ -39,7 +39,7 @@ client can be used to quickly see which databases exist, their tables, or a tabl
provides a command\-line interface to several SQL provides a command\-line interface to several SQL
SHOW SHOW
statements\&. See statements\&. See
Section\ \&12.5.5, \(lqSHOW Syntax\(rq\&. The same information can be obtained by using those statements directly\&. For example, you can issue them from the Section\ \&12.4.5, \(lqSHOW Syntax\(rq\&. The same information can be obtained by using those statements directly\&. For example, you can issue them from the
\fBmysql\fR \fBmysql\fR
client program\&. client program\&.
.PP .PP
...@@ -112,7 +112,13 @@ shows you only the table names that match the pattern\&. This is easily fixed by ...@@ -112,7 +112,13 @@ shows you only the table names that match the pattern\&. This is easily fixed by
last on the command line as a separate argument\&. last on the command line as a separate argument\&.
.PP .PP
\fBmysqlshow\fR \fBmysqlshow\fR
supports the options in the following list\&. It also reads option files and supports the options for processing them described at supports the following options, which can be specified on the command line or in the
[mysqlshow]
and
[client]
option file groups\&.
\fBmysqlshow\fR
also supports the options for processing option files described at
Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&. Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&.
.sp .sp
.RS 4 .RS 4
...@@ -144,7 +150,7 @@ Display a help message and exit\&. ...@@ -144,7 +150,7 @@ Display a help message and exit\&.
\fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR \fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR
.sp .sp
The directory where character sets are installed\&. See The directory where character sets are installed\&. See
Section\ \&9.2, \(lqThe Character Set Used for Data and Sorting\(rq\&. Section\ \&9.5, \(lqCharacter Set Configuration\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -244,7 +250,7 @@ Print debugging information and memory and CPU usage statistics when the program ...@@ -244,7 +250,7 @@ Print debugging information and memory and CPU usage statistics when the program
Use Use
\fIcharset_name\fR \fIcharset_name\fR
as the default character set\&. See as the default character set\&. See
Section\ \&9.2, \(lqThe Character Set Used for Data and Sorting\(rq\&. Section\ \&9.5, \(lqCharacter Set Configuration\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -300,10 +306,12 @@ value following the ...@@ -300,10 +306,12 @@ value following the
\fB\-\-password\fR \fB\-\-password\fR
or or
\fB\-p\fR \fB\-p\fR
option on the command line, you are prompted for one\&. option on the command line,
\fBmysqlshow\fR
prompts for one\&.
.sp .sp
Specifying a password on the command line should be considered insecure\&. See Specifying a password on the command line should be considered insecure\&. See
Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&. Section\ \&5.3.2.2, \(lqEnd-User Guidelines for Password Security\(rq\&. You can use an option file to avoid giving the password on the command line\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -319,7 +327,7 @@ Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&. ...@@ -319,7 +327,7 @@ Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&.
\fB\-\-pipe\fR, \fB\-\-pipe\fR,
\fB\-W\fR \fB\-W\fR
.sp .sp
On Windows, connect to the server via a named pipe\&. This option applies only for connections to a local server, and only if the server supports named\-pipe connections\&. On Windows, connect to the server via a named pipe\&. This option applies only if the server supports named\-pipe connections\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -406,7 +414,7 @@ localhost, the Unix socket file to use, or, on Windows, the name of the named pi ...@@ -406,7 +414,7 @@ localhost, the Unix socket file to use, or, on Windows, the name of the named pi
Options that begin with Options that begin with
\fB\-\-ssl\fR \fB\-\-ssl\fR
specify whether to connect to the server via SSL and indicate where to find SSL keys and certificates\&. See specify whether to connect to the server via SSL and indicate where to find SSL keys and certificates\&. See
Section\ \&5.5.7.3, \(lqSSL Command Options\(rq\&. Section\ \&5.5.6.3, \(lqSSL Command Options\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -475,7 +483,7 @@ Display version information and exit\&. ...@@ -475,7 +483,7 @@ Display version information and exit\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysqlslap.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysqlslap\fR .\" Title: \fBmysqlslap\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQLSLAP\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBMYSQLSLAP\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -151,7 +151,13 @@ mysqlslap \-\-concurrency=5 \e ...@@ -151,7 +151,13 @@ mysqlslap \-\-concurrency=5 \e
.\} .\}
.PP .PP
\fBmysqlslap\fR \fBmysqlslap\fR
supports the options in the following list\&. It also reads option files and supports the options for processing them described at supports the following options, which can be specified on the command line or in the
[mysqlslap]
and
[client]
option file groups\&.
\fBmysqlslap\fR
also supports the options for processing option files described at
Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&. Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&.
.sp .sp
.RS 4 .RS 4
...@@ -615,7 +621,24 @@ is specified\&. ...@@ -615,7 +621,24 @@ is specified\&.
.\" number-of-queries option: mysqlslap .\" number-of-queries option: mysqlslap
\fB\-\-number\-of\-queries=\fR\fB\fIN\fR\fR \fB\-\-number\-of\-queries=\fR\fB\fIN\fR\fR
.sp .sp
Limit each client to approximately this number of queries\&. This option was added in MySQL 5\&.1\&.5\&. Limit each client to approximately this many queries\&. Query counting takes into account the statement delimiter\&. For example, if you invoke
\fBmysqlslap\fR
as follows, the
;
delimiter is recognized so that each instance of the query string counts as two queries\&. As a result, 5 rows (not 10) are inserted\&.
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysqlslap \-\-delimiter=";" \-\-number\-of\-queries=10\fR
\fB\-\-query="use test;insert into t values(null)"\fR
.fi
.if n \{\
.RE
.\}
.sp
This option was added in MySQL 5\&.1\&.5\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -653,15 +676,15 @@ The password to use when connecting to the server\&. If you use the short option ...@@ -653,15 +676,15 @@ The password to use when connecting to the server\&. If you use the short option
have a space between the option and the password\&. If you omit the have a space between the option and the password\&. If you omit the
\fIpassword\fR \fIpassword\fR
value following the value following the
.\" mysqlslap: password option
.\" password option: mysqlslap
\fB\-\-password\fR \fB\-\-password\fR
or or
\fB\-p\fR \fB\-p\fR
option on the command line, you are prompted for one\&. option on the command line,
\fBmysqlslap\fR
prompts for one\&.
.sp .sp
Specifying a password on the command line should be considered insecure\&. See Specifying a password on the command line should be considered insecure\&. See
Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&. Section\ \&5.3.2.2, \(lqEnd-User Guidelines for Password Security\(rq\&. You can use an option file to avoid giving the password on the command line\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -677,7 +700,7 @@ Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&. ...@@ -677,7 +700,7 @@ Section\ \&5.5.6.2, \(lqEnd-User Guidelines for Password Security\(rq\&.
\fB\-\-pipe\fR, \fB\-\-pipe\fR,
\fB\-W\fR \fB\-W\fR
.sp .sp
On Windows, connect to the server via a named pipe\&. This option applies only for connections to a local server, and only if the server supports named\-pipe connections\&. On Windows, connect to the server via a named pipe\&. This option applies only if the server supports named\-pipe connections\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -897,7 +920,7 @@ localhost, the Unix socket file to use, or, on Windows, the name of the named pi ...@@ -897,7 +920,7 @@ localhost, the Unix socket file to use, or, on Windows, the name of the named pi
Options that begin with Options that begin with
\fB\-\-ssl\fR \fB\-\-ssl\fR
specify whether to connect to the server via SSL and indicate where to find SSL keys and certificates\&. See specify whether to connect to the server via SSL and indicate where to find SSL keys and certificates\&. See
Section\ \&5.5.7.3, \(lqSSL Command Options\(rq\&. Section\ \&5.5.6.3, \(lqSSL Command Options\(rq\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -971,7 +994,7 @@ Display version information and exit\&. ...@@ -971,7 +994,7 @@ Display version information and exit\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/mysqltest.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBmysqltest\fR .\" Title: \fBmysqltest\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 10/29/2009 .\" Date: 03/31/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL .\" Source: MySQL
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBMYSQLTEST\FR" "1" "10/29/2009" "MySQL" "MySQL Database System" .TH "\FBMYSQLTEST\FR" "1" "03/31/2010" "MySQL" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -175,31 +175,11 @@ The base directory for tests\&. ...@@ -175,31 +175,11 @@ The base directory for tests\&.
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysqltest: big-test option
.\" big-test option: mysqltest
\fB\-\-big\-test\fR,
\fB\-B\fR
.sp
Define the
\fBmysqltest\fR
variable
$BIG_TEST
as 1\&. This option was removed in MySQL 4\&.1\&.23, 5\&.0\&.30, and 5\&.1\&.13\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: character-sets-dir option .\" mysqltest: character-sets-dir option
.\" character-sets-dir option: mysqltest .\" character-sets-dir option: mysqltest
\fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR \fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR
.sp .sp
The directory where character sets are installed\&. This option was added in MySQL 4\&.1\&.23, 5\&.0\&.32, and 5\&.1\&.13\&. The directory where character sets are installed\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -226,12 +206,11 @@ Compress all information sent between the client and the server if both support ...@@ -226,12 +206,11 @@ Compress all information sent between the client and the server if both support
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
.\" mysqltest: cursor-protocol option .\" mysqltest: currsor-protocol option
.\" cursor-protocol option: mysqltest .\" cursor-protocol option: mysqltest
\fB\-\-cursor\-protocol\fR \fB\-\-cursor\-protocol\fR
.sp .sp
Use cursors for prepared statements (implies Use cursors for prepared statements\&.
\fB\-\-ps\-protocol\fR)\&. This option was added in MySQL 5\&.0\&.19\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -281,7 +260,7 @@ value is ...@@ -281,7 +260,7 @@ value is
.\" debug-check option: mysqltest .\" debug-check option: mysqltest
\fB\-\-debug\-check\fR \fB\-\-debug\-check\fR
.sp .sp
Print some debugging information when the program exits\&. This option was added in MySQL 5\&.1\&.21\&. Print some debugging information when the program exits\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -296,7 +275,7 @@ Print some debugging information when the program exits\&. This option was added ...@@ -296,7 +275,7 @@ Print some debugging information when the program exits\&. This option was added
.\" debug-info option: mysqltest .\" debug-info option: mysqltest
\fB\-\-debug\-info\fR \fB\-\-debug\-info\fR
.sp .sp
Print debugging information and memory and CPU usage statistics when the program exits\&. This option was added in MySQL 5\&.1\&.14\&. Print debugging information and memory and CPU usage statistics when the program exits\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -332,7 +311,7 @@ Include the contents of the given file before processing the contents of the tes ...@@ -332,7 +311,7 @@ Include the contents of the given file before processing the contents of the tes
\fBmysqltest\fR \fBmysqltest\fR
test files\&. This option has the same effect as putting a test files\&. This option has the same effect as putting a
\-\-source \fIfile_name\fR \-\-source \fIfile_name\fR
command as the first line of the test file\&. This option was added in MySQL 4\&.1\&.23, 5\&.0\&.30, and 5\&.1\&.7\&. command as the first line of the test file\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -347,7 +326,7 @@ command as the first line of the test file\&. This option was added in MySQL 4\& ...@@ -347,7 +326,7 @@ command as the first line of the test file\&. This option was added in MySQL 4\&
.\" logdir option: mysqltest .\" logdir option: mysqltest
\fB\-\-logdir=\fR\fB\fIdir_name\fR\fR \fB\-\-logdir=\fR\fB\fIdir_name\fR\fR
.sp .sp
The directory to use for log files\&. This option was added in MySQL 5\&.1\&.14\&. The directory to use for log files\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -363,7 +342,7 @@ The directory to use for log files\&. This option was added in MySQL 5\&.1\&.14\ ...@@ -363,7 +342,7 @@ The directory to use for log files\&. This option was added in MySQL 5\&.1\&.14\
\fB\-\-mark\-progress\fR \fB\-\-mark\-progress\fR
.sp .sp
Write the line number and elapsed time to Write the line number and elapsed time to
\fItest_file\fR\&.progress\&. This option was added in MySQL 4\&.1\&.23, 5\&.0\&.30, and 5\&.1\&.12\&. \fItest_file\fR\&.progress\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -378,7 +357,24 @@ Write the line number and elapsed time to ...@@ -378,7 +357,24 @@ Write the line number and elapsed time to
.\" max-connect-retries option: mysqltest .\" max-connect-retries option: mysqltest
\fB\-\-max\-connect\-retries=\fR\fB\fInum\fR\fR \fB\-\-max\-connect\-retries=\fR\fB\fInum\fR\fR
.sp .sp
The maximum number of connection attempts when connecting to server\&. This option was added in MySQL 4\&.1\&.23, 5\&.0\&.23, and 5\&.1\&.11\&. The maximum number of connection attempts when connecting to server\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: max-connections option
.\" max-connections option: mysqltest
\fB\-\-max\-connections=\fR\fB\fInum\fR\fR
.sp
The maximum number of simultaneous server connections per client (that is, per test)\&. If not set, the maximum is 128\&. Minimum allowed limit is 8, maximum is 5120\&.
.sp
This option is available from MySQL 5\&.1\&.45\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -393,7 +389,7 @@ The maximum number of connection attempts when connecting to server\&. This opti ...@@ -393,7 +389,7 @@ The maximum number of connection attempts when connecting to server\&. This opti
.\" no-defaults option: mysqltest .\" no-defaults option: mysqltest
\fB\-\-no\-defaults\fR \fB\-\-no\-defaults\fR
.sp .sp
Do not read default options from any option files\&. Do not read default options from any option files\&. If used, this must be the first option\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -484,7 +480,8 @@ Suppress all normal output\&. This is a synonym for ...@@ -484,7 +480,8 @@ Suppress all normal output\&. This is a synonym for
.sp .sp
Record the output that results from running the test file into the file named by the Record the output that results from running the test file into the file named by the
\fB\-\-result\-file\fR \fB\-\-result\-file\fR
option, if that option is given\&. option, if that option is given\&. It is an error to use this option without also using
\fB\-\-result\-file\fR\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -516,7 +513,9 @@ treats the test actual and expected results for a test case: ...@@ -516,7 +513,9 @@ treats the test actual and expected results for a test case:
.\} .\}
If the test produces no results, If the test produces no results,
\fBmysqltest\fR \fBmysqltest\fR
exits with an error message to that effect\&. exits with an error message to that effect, unless
\fB\-\-result\-file\fR
is given and the named file is an empty file\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -551,7 +550,7 @@ reads the expected results from the given file and compares them with the actual ...@@ -551,7 +550,7 @@ reads the expected results from the given file and compares them with the actual
\fBmysqltest\fR \fBmysqltest\fR
writes a writes a
\&.reject \&.reject
file in the same directory as the result file and exits with an error\&. file in the same directory as the result file, outputs a diff of the two files, and exits with an error\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -695,7 +694,22 @@ localhost ...@@ -695,7 +694,22 @@ localhost
.sp .sp
Execute DML statements within a stored procedure\&. For every DML statement, Execute DML statements within a stored procedure\&. For every DML statement,
\fBmysqltest\fR \fBmysqltest\fR
creates and invokes a stored procedure that executes the statement rather than executing the statement directly\&. This option was added in MySQL 5\&.0\&.19\&. creates and invokes a stored procedure that executes the statement rather than executing the statement directly\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: tail-lines option
.\" tail-lines option: mysqltest
\fB\-\-tail\-lines=\fR\fB\fInn\fR\fR
.sp
Specify how many lines of the result to include in the output if the test fails because an SQL statement fails\&. The default is 0, meaning no lines of result printed\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -727,7 +741,9 @@ Read test input from this file\&. The default is to read from the standard input ...@@ -727,7 +741,9 @@ Read test input from this file\&. The default is to read from the standard input
\fB\-\-timer\-file=\fR\fB\fIfile_name\fR\fR, \fB\-\-timer\-file=\fR\fB\fIfile_name\fR\fR,
\fB\-m \fR\fB\fIfile_name\fR\fR \fB\-m \fR\fB\fIfile_name\fR\fR
.sp .sp
The file where the timing in microseconds is written\&. If given, the number of millisecond spent running the test will be written to this file\&. This is used by
\fBmysql\-test\-run\&.pl\fR
for its reporting\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -743,7 +759,7 @@ The file where the timing in microseconds is written\&. ...@@ -743,7 +759,7 @@ The file where the timing in microseconds is written\&.
\fB\-\-tmpdir=\fR\fB\fIdir_name\fR\fR, \fB\-\-tmpdir=\fR\fB\fIdir_name\fR\fR,
\fB\-t \fR\fB\fIdir_name\fR\fR \fB\-t \fR\fB\fIdir_name\fR\fR
.sp .sp
The temporary directory where socket files are put\&. The temporary directory where socket files are created\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -775,7 +791,7 @@ The MySQL user name to use when connecting to the server\&. ...@@ -775,7 +791,7 @@ The MySQL user name to use when connecting to the server\&.
\fB\-\-verbose\fR, \fB\-\-verbose\fR,
\fB\-v\fR \fB\-v\fR
.sp .sp
Verbose mode\&. Print out more information what the program does\&. Verbose mode\&. Print out more information about what the program does\&.
.RE .RE
.sp .sp
.RS 4 .RS 4
...@@ -813,7 +829,7 @@ statement is wrapped inside a view\&. This option was added in MySQL 5\&.0\&.19\ ...@@ -813,7 +829,7 @@ statement is wrapped inside a view\&. This option was added in MySQL 5\&.0\&.19\
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright \(co 2007, 2010, Oracle and/or its affiliates. All rights reserved.
.PP .PP
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. 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.
.PP .PP
......
man/ndbd.8
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBndbd\fR .\" Title: \fBndbd\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBNDBD\FR" "8" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBNDBD\FR" "8" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -93,7 +93,7 @@ T}:T{ ...@@ -93,7 +93,7 @@ T}:T{
5\&.1\&.12 5\&.1\&.12
T} T}
T{ T{
\fBCommand Line Format\fR \fBCommand\-Line Format\fR
T}:T{ T}:T{
\-\-bind\-address=name \-\-bind\-address=name
T} T}
...@@ -137,7 +137,7 @@ l l s ...@@ -137,7 +137,7 @@ l l s
^ l l ^ l l
^ l l. ^ l l.
T{ T{
\fBCommand Line Format\fR \fBCommand\-Line Format\fR
T}:T{ T}:T{
\-\-daemon \-\-daemon
T} T}
...@@ -189,7 +189,7 @@ l l s ...@@ -189,7 +189,7 @@ l l s
^ l l ^ l l
^ l l. ^ l l.
T{ T{
\fBCommand Line Format\fR \fBCommand\-Line Format\fR
T}:T{ T}:T{
\-\-initial \-\-initial
T} T}
...@@ -298,7 +298,7 @@ Backup files that have already been created by the affected node ...@@ -298,7 +298,7 @@ Backup files that have already been created by the affected node
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
MySQL Cluster Disk Data files (see MySQL Cluster Disk Data files (see
Section\ \&17.5.9, \(lqMySQL Cluster Disk Data Tables\(rq)\&. Section\ \&17.5.10, \(lqMySQL Cluster Disk Data Tables\(rq)\&.
.RE .RE
.RS 4 .RS 4
.sp .sp
...@@ -334,7 +334,7 @@ T}:T{ ...@@ -334,7 +334,7 @@ T}:T{
5\&.1\&.11 5\&.1\&.11
T} T}
T{ T{
\fBCommand Line Format\fR \fBCommand\-Line Format\fR
T}:T{ T}:T{
\-\-initial\-start \-\-initial\-start
T} T}
...@@ -358,20 +358,27 @@ T} ...@@ -358,20 +358,27 @@ T}
This option is used when performing a partial initial start of the cluster\&. Each node should be started with this option, as well as This option is used when performing a partial initial start of the cluster\&. Each node should be started with this option, as well as
\fB\-\-nowait\-nodes\fR\&. \fB\-\-nowait\-nodes\fR\&.
.sp .sp
For example, suppose you have a 4\-node cluster whose data nodes have the IDs 2, 3, 4, and 5, and you wish to perform a partial initial start using only nodes 2, 4, and 5 \(em that is, omitting node 3: Suppose that you have a 4\-node cluster whose data nodes have the IDs 2, 3, 4, and 5, and you wish to perform a partial initial start using only nodes 2, 4, and 5 \(em that is, omitting node 3:
.sp .sp
.if n \{\ .if n \{\
.RS 4 .RS 4
.\} .\}
.nf .nf
ndbd \-\-ndbd\-nodeid=2 \-\-nowait\-nodes=3 \-\-initial\-start shell> \fBndbd \-\-ndb\-nodeid=2 \-\-nowait\-nodes=3 \-\-initial\-start\fR
ndbd \-\-ndbd\-nodeid=4 \-\-nowait\-nodes=3 \-\-initial\-start shell> \fBndbd \-\-ndb\-nodeid=4 \-\-nowait\-nodes=3 \-\-initial\-start\fR
ndbd \-\-ndbd\-nodeid=5 \-\-nowait\-nodes=3 \-\-initial\-start shell> \fBndbd \-\-ndb\-nodeid=5 \-\-nowait\-nodes=3 \-\-initial\-start\fR
.fi .fi
.if n \{\ .if n \{\
.RE .RE
.\} .\}
.sp .sp
Prior to MySQL 5\&.1\&.19, it was not possible to perform DDL operations involving Disk Data tables on a partially started cluster\&. (See
\m[blue]\fBBug#24631\fR\m[]\&\s-2\u[1]\d\s+2\&.)
.sp
When using this option, you must also specify the node ID for the data node being started with the
\fB\-\-ndb\-nodeid\fR
option\&.
.sp
This option was added in MySQL 5\&.1\&.11\&. This option was added in MySQL 5\&.1\&.11\&.
.if n \{\ .if n \{\
.sp .sp
...@@ -385,8 +392,11 @@ This option was added in MySQL 5\&.1\&.11\&. ...@@ -385,8 +392,11 @@ This option was added in MySQL 5\&.1\&.11\&.
\fBImportant\fR \fBImportant\fR
.ps -1 .ps -1
.br .br
Prior to MySQL 5\&.1\&.19, it was not possible to perform DDL operations involving Disk Data tables on a partially started cluster\&. (See Do not confuse this option with the
\m[blue]\fBBug#24631\fR\m[]\&\s-2\u[1]\d\s+2\&.) \fB\-\-nowait\-nodes\fR
option added for
\fBndb_mgmd\fR
in MySQL Cluster NDB 7\&.0\&.10, which can be used to allow a cluster configured with multiple management servers to be started without all management servers being online\&.
.sp .5v .sp .5v
.RE .RE
.RE .RE
...@@ -412,10 +422,10 @@ l l s ...@@ -412,10 +422,10 @@ l l s
T{ T{
\fBVersion Introduced\fR \fBVersion Introduced\fR
T}:T{ T}:T{
5\&.1\&.11 5\&.1\&.9
T} T}
T{ T{
\fBCommand Line Format\fR \fBCommand\-Line Format\fR
T}:T{ T}:T{
\-\-nowait\-nodes=list \-\-nowait\-nodes=list
T} T}
...@@ -470,9 +480,12 @@ allbox tab(:); ...@@ -470,9 +480,12 @@ allbox tab(:);
l l s l l s
l l s l l s
^ l l ^ l l
^ l l
l l s
^ l l
^ l l. ^ l l.
T{ T{
\fBCommand Line Format\fR \fBCommand\-Line Format\fR
T}:T{ T}:T{
\-\-nodaemon \-\-nodaemon
T} T}
...@@ -491,6 +504,21 @@ T} ...@@ -491,6 +504,21 @@ T}
T}:T{ T}:T{
FALSE FALSE
T} T}
T{
\ \&
T}:T{
\fBPermitted Values \fR
T}
:T{
\fBType\fR (windows)
T}:T{
boolean
T}
:T{
\fBDefault\fR
T}:T{
TRUE
T}
.TE .TE
.sp 1 .sp 1
Instructs Instructs
...@@ -527,7 +555,7 @@ l l s ...@@ -527,7 +555,7 @@ l l s
^ l l ^ l l
^ l l. ^ l l.
T{ T{
\fBCommand Line Format\fR \fBCommand\-Line Format\fR
T}:T{ T}:T{
\-\-nostart \-\-nostart
T} T}
...@@ -759,7 +787,7 @@ Section\ \&17.1.5, \(lqKnown Limitations of MySQL Cluster\(rq\&. ...@@ -759,7 +787,7 @@ Section\ \&17.1.5, \(lqKnown Limitations of MySQL Cluster\(rq\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
...@@ -771,12 +799,12 @@ You should have received a copy of the GNU General Public License along with the ...@@ -771,12 +799,12 @@ You should have received a copy of the GNU General Public License along with the
.IP " 1." 4 .IP " 1." 4
Bug#24631 Bug#24631
.RS 4 .RS 4
\%http://bugs.mysql.com/24631 \%http://bugs.mysql.com/bug.php?id=24631
.RE .RE
.IP " 2." 4 .IP " 2." 4
Bug#45588 Bug#45588
.RS 4 .RS 4
\%http://bugs.mysql.com/45588 \%http://bugs.mysql.com/bug.php?id=45588
.RE .RE
.IP " 3." 4 .IP " 3." 4
ndbd Error Messages ndbd Error Messages
......
man/ndbd_redo_log_reader.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBndbd_redo_log_reader\fR .\" Title: \fBndbd_redo_log_reader\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBNDBD_REDO_LOG_REA" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBNDBD_REDO_LOG_REA" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -77,7 +77,7 @@ l l s ...@@ -77,7 +77,7 @@ l l s
^ l l ^ l l
^ l l. ^ l l.
T{ T{
\fBCommand Line Format\fR \fBCommand\-Line Format\fR
T}:T{ T}:T{
\-noprint \-noprint
T} T}
...@@ -116,7 +116,7 @@ l l s ...@@ -116,7 +116,7 @@ l l s
^ l l ^ l l
^ l l. ^ l l.
T{ T{
\fBCommand Line Format\fR \fBCommand\-Line Format\fR
T}:T{ T}:T{
\-nocheck \-nocheck
T} T}
...@@ -154,7 +154,7 @@ must be run on a cluster data node, since it accesses the data node file system ...@@ -154,7 +154,7 @@ must be run on a cluster data node, since it accesses the data node file system
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/ndbmtd.8
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBndbmtd\fR .\" Title: \fBndbmtd\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBNDBMTD\FR" "8" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBNDBMTD\FR" "8" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -74,7 +74,7 @@ Prior to MySQL Cluster NDB 7\&.0\&.6, there were known issues when using ...@@ -74,7 +74,7 @@ Prior to MySQL Cluster NDB 7\&.0\&.6, there were known issues when using
\fBndbmtd\fR \fBndbmtd\fR
with MySQL Cluster Disk Data tables\&. If you wish to use multi\-threaded data nodes with disk\-based with MySQL Cluster Disk Data tables\&. If you wish to use multi\-threaded data nodes with disk\-based
NDB NDB
tables, you should insure that you are running MySQL Cluster NDB 7\&.0\&.6 or later\&. (\m[blue]\fBBug#41915\fR\m[]\&\s-2\u[1]\d\s+2, tables, you should ensure that you are running MySQL Cluster NDB 7\&.0\&.6 or later\&. (\m[blue]\fBBug#41915\fR\m[]\&\s-2\u[1]\d\s+2,
\m[blue]\fBBug#44915\fR\m[]\&\s-2\u[2]\d\s+2) \m[blue]\fBBug#44915\fR\m[]\&\s-2\u[2]\d\s+2)
.PP .PP
Using Using
...@@ -356,7 +356,7 @@ concurrently on different data nodes in the same MySQL Cluster\&. However, such ...@@ -356,7 +356,7 @@ concurrently on different data nodes in the same MySQL Cluster\&. However, such
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
...@@ -368,12 +368,12 @@ You should have received a copy of the GNU General Public License along with the ...@@ -368,12 +368,12 @@ You should have received a copy of the GNU General Public License along with the
.IP " 1." 4 .IP " 1." 4
Bug#41915 Bug#41915
.RS 4 .RS 4
\%http://bugs.mysql.com/41915 \%http://bugs.mysql.com/bug.php?id=41915
.RE .RE
.IP " 2." 4 .IP " 2." 4
Bug#44915 Bug#44915
.RS 4 .RS 4
\%http://bugs.mysql.com/44915 \%http://bugs.mysql.com/bug.php?id=44915
.RE .RE
.IP " 3." 4 .IP " 3." 4
ndbd Error Messages ndbd Error Messages
......
man/perror.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBperror\fR .\" Title: \fBperror\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBPERROR\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBPERROR\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -96,7 +96,7 @@ shell> \fBperror \-\-ndb \fR\fB\fIerrorcode\fR\fR ...@@ -96,7 +96,7 @@ shell> \fBperror \-\-ndb \fR\fB\fIerrorcode\fR\fR
Note that the meaning of system error messages may be dependent on your operating system\&. A given error code may mean different things on different operating systems\&. Note that the meaning of system error messages may be dependent on your operating system\&. A given error code may mean different things on different operating systems\&.
.PP .PP
\fBperror\fR \fBperror\fR
supports the following options: supports the following options\&.
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
...@@ -181,7 +181,7 @@ Display version information and exit\&. ...@@ -181,7 +181,7 @@ Display version information and exit\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/replace.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBreplace\fR .\" Title: \fBreplace\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBREPLACE\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBREPLACE\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -90,7 +90,7 @@ program is used by ...@@ -90,7 +90,7 @@ program is used by
\fBmsql2mysql\fR(1)\&. \fBmsql2mysql\fR(1)\&.
.PP .PP
\fBreplace\fR \fBreplace\fR
supports the following options: supports the following options\&.
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
...@@ -160,7 +160,7 @@ Display version information and exit\&. ...@@ -160,7 +160,7 @@ Display version information and exit\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/resolve_stack_dump.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBresolve_stack_dump\fR .\" Title: \fBresolve_stack_dump\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBRESOLVE_STACK_DUM" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBRESOLVE_STACK_DUM" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -49,7 +49,7 @@ command\&. The numeric dump file should contain a numeric stack track from ...@@ -49,7 +49,7 @@ command\&. The numeric dump file should contain a numeric stack track from
\fBmysqld\fR\&. If no numeric dump file is named on the command line, the stack trace is read from the standard input\&. \fBmysqld\fR\&. If no numeric dump file is named on the command line, the stack trace is read from the standard input\&.
.PP .PP
\fBresolve_stack_dump\fR \fBresolve_stack_dump\fR
supports the options described in the following list\&. supports the following options\&.
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
...@@ -117,7 +117,7 @@ Display version information and exit\&. ...@@ -117,7 +117,7 @@ Display version information and exit\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
man/resolveip.1
View file @ d923b924
...@@ -2,12 +2,12 @@ ...@@ -2,12 +2,12 @@
.\" Title: \fBresolveip\fR .\" Title: \fBresolveip\fR
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\" Date: 11/04/2009 .\" Date: 04/06/2010
.\" Manual: MySQL Database System .\" Manual: MySQL Database System
.\" Source: MySQL 5.1 .\" Source: MySQL 5.1
.\" Language: English .\" Language: English
.\" .\"
.TH "\FBRESOLVEIP\FR" "1" "11/04/2009" "MySQL 5\&.1" "MySQL Database System" .TH "\FBRESOLVEIP\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * set default formatting .\" * set default formatting
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
...@@ -45,7 +45,7 @@ shell> \fBresolveip [\fR\fB\fIoptions\fR\fR\fB] {\fR\fB\fIhost_name\fR\fR\fB|\fR ...@@ -45,7 +45,7 @@ shell> \fBresolveip [\fR\fB\fIoptions\fR\fR\fB] {\fR\fB\fIhost_name\fR\fR\fB|\fR
.\} .\}
.PP .PP
\fBresolveip\fR \fBresolveip\fR
supports the options described in the following list\&. supports the following options\&.
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
...@@ -99,7 +99,7 @@ Display version information and exit\&. ...@@ -99,7 +99,7 @@ Display version information and exit\&.
.SH "COPYRIGHT" .SH "COPYRIGHT"
.br .br
.PP .PP
Copyright 2007-2008 MySQL AB, 2009 Sun Microsystems, Inc. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
.PP .PP
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. 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.
.PP .PP
......
scripts/fill_help_tables.sql
View file @ d923b924
This source diff could not be displayed because it is too large. You can view the blob instead.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment
GitLab Nexedi Edition | About GitLab | About Nexedi | 沪ICP备2021021310号-2 | 沪ICP备2021021310号-7