2009-09-16 14:03:18 +02:00
'\" t
2009-05-25 11:59:47 +02:00
. \"
2019-07-01 17:21:57 +02:00
.TH "\FBMYSQLCHECK\FR" "1" "27 June 2019" "MariaDB 10\&.5" "MariaDB Database System"
2009-09-16 14:03:18 +02:00
. \" -----------------------------------------------------------------
. \" * set default formatting
. \" -----------------------------------------------------------------
2009-05-25 11:59:47 +02:00
. \" disable hyphenation
.nh
. \" disable justification (adjust text to left margin only)
.ad l
2009-09-16 14:03:18 +02:00
. \" -----------------------------------------------------------------
. \" * MAIN CONTENT STARTS HERE *
. \" -----------------------------------------------------------------
. \" mysqlcheck
. \" maintenance: tables
. \" repair: tables
. \" tables: maintenance
. \" tables: repair
2009-05-25 11:59:47 +02:00
.SH "NAME"
2009-09-16 14:03:18 +02:00
mysqlcheck \- a table maintenance program
2009-05-25 11:59:47 +02:00
.SH "SYNOPSIS"
2009-09-16 14:03:18 +02:00
.HP \w '\fBmysqlcheck\ [\fR\fB\fIoptions\fR\fR\fB]\ [\fR\fB\fIdb_name\fR\fR\fB\ [\fR\fB\fItbl_name\fR\fR\fB\ \& .\&.\&.]]\fR\ 'u
\fB mysqlcheck [\fR \fB \fI options\fR \fR \fB ] [\fR \fB \fI db_name\fR \fR \fB [\fR \fB \fI tbl_name\fR \fR \fB \& .\& .\& .]]\fR
2009-05-25 11:59:47 +02:00
.SH "DESCRIPTION"
.PP
The
\fB mysqlcheck\fR
2009-09-16 14:03:18 +02:00
client performs table maintenance: It checks, repairs, optimizes, or analyzes tables\& .
.PP
2009-12-01 08:24:05 +01:00
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
2015-09-09 14:32:52 +02:00
lock only\& . Table maintenance operations can be time\- consuming, particularly for large tables\& . If you use the
2009-09-16 14:03:18 +02:00
\fB \- \- databases\fR
or
\fB \- \- all\- databases\fR
option to process all tables in one or more databases, an invocation of
\fB mysqlcheck\fR
might take a long time\& . (This is also true for
\fB mysql_upgrade\fR
because that program invokes
\fB mysqlcheck\fR
to check all tables and repair them if necessary\& .)
2009-05-25 11:59:47 +02:00
.PP
\fB mysqlcheck\fR
is similar in function to
2009-09-16 14:03:18 +02:00
\fB myisamchk\fR , but works differently\& . The main operational difference is that
2009-05-25 11:59:47 +02:00
\fB mysqlcheck\fR
must be used when the
\fB mysqld\fR
server is running, whereas
\fB myisamchk\fR
2009-09-16 14:03:18 +02:00
should be used when it is not\& . The benefit of using
2009-05-25 11:59:47 +02:00
\fB mysqlcheck\fR
2009-09-16 14:03:18 +02:00
is that you do not have to stop the server to perform table maintenance\& .
2009-05-25 11:59:47 +02:00
.PP
\fB mysqlcheck\fR
uses the SQL statements
CHECK TABLE,
REPAIR TABLE,
ANALYZE TABLE, and
OPTIMIZE TABLE
2015-09-09 14:32:52 +02:00
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\& .
2009-05-25 11:59:47 +02:00
.PP
The
MyISAM
2009-09-16 14:03:18 +02:00
storage engine supports all four maintenance operations, so
2009-05-25 11:59:47 +02:00
\fB mysqlcheck\fR
2009-09-16 14:03:18 +02:00
can be used to perform any of them on
2009-05-25 11:59:47 +02:00
MyISAM
2009-09-16 14:03:18 +02:00
tables\& . Other storage engines do not necessarily support all operations\& . In such cases, an error message is displayed\& . For example, if
test\& .t
2009-05-25 11:59:47 +02:00
is a
MEMORY
table, an attempt to check it produces this result:
.sp
2009-09-16 14:03:18 +02:00
.if n \{ \
.RS 4
. \}
2009-05-25 11:59:47 +02:00
.nf
shell> \fB mysqlcheck test t\fR
2009-09-16 14:03:18 +02:00
test\& .t
note : The storage engine for the table doesn\' t support check
2009-05-25 11:59:47 +02:00
.fi
2009-09-16 14:03:18 +02:00
.if n \{ \
2009-05-25 11:59:47 +02:00
.RE
2009-09-16 14:03:18 +02:00
. \}
.PP
If
\fB mysqlcheck\fR
2015-09-09 14:32:52 +02:00
is unable to repair a table, see the MariaDB Knowledge Base
2009-09-16 14:03:18 +02:00
for manual table repair strategies\& . This will be the case, for example, for
InnoDB
tables, which can be checked with
CHECK TABLE, but not repaired with
REPAIR TABLE\& .
2009-05-25 11:59:47 +02:00
.PP
The use of
\fB mysqlcheck\fR
2015-09-09 14:32:52 +02:00
with partitioned tables is not supported\& .
2009-09-16 14:03:18 +02:00
.if n \{ \
2009-05-25 11:59:47 +02:00
.sp
2009-09-16 14:03:18 +02:00
. \}
.RS 4
2009-05-25 11:59:47 +02:00
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
2009-09-16 14:03:18 +02:00
.ps +1
2009-05-25 11:59:47 +02:00
\fB Caution\fR
2009-09-16 14:03:18 +02:00
.ps -1
.br
2009-05-25 11:59:47 +02:00
.PP
2009-09-16 14:03:18 +02:00
It is best to make a backup of a table before performing a table repair operation; under some circumstances the operation might cause data loss\& . Possible causes include but are not limited to file system errors\& .
.sp .5v
.RE
2009-05-25 11:59:47 +02:00
.PP
There are three general ways to invoke
\fB mysqlcheck\fR :
.sp
2009-09-16 14:03:18 +02:00
.if n \{ \
.RS 4
. \}
2009-05-25 11:59:47 +02:00
.nf
2010-04-28 15:06:11 +02:00
shell> \fB mysqlcheck [\fR \fB \fI options\fR \fR \fB ] \fR \fB \fI db_name\fR \fR \fB [\fR \fB \fI tbl_name\fR \fR \fB \& .\& .\& .]\fR
shell> \fB mysqlcheck [\fR \fB \fI options\fR \fR \fB ] \- \- databases \fR \fB \fI db_name\fR \fR \fB \& .\& .\& .\fR
2009-05-25 11:59:47 +02:00
shell> \fB mysqlcheck [\fR \fB \fI options\fR \fR \fB ] \- \- all\- databases\fR
.fi
2009-09-16 14:03:18 +02:00
.if n \{ \
2009-05-25 11:59:47 +02:00
.RE
2009-09-16 14:03:18 +02:00
. \}
2009-05-25 11:59:47 +02:00
.PP
If you do not name any tables following
\fI db_name\fR
or if you use the
\fB \- \- databases\fR
or
\fB \- \- all\- databases\fR
2009-09-16 14:03:18 +02:00
option, entire databases are checked\& .
2009-05-25 11:59:47 +02:00
.PP
\fB mysqlcheck\fR
2009-09-16 14:03:18 +02:00
has a special feature compared to other client programs\& . The default behavior of checking tables (\fB \- \- check\fR ) can be changed by renaming the binary\& . If you want to have a tool that repairs tables by default, you should just make a copy of
2009-05-25 11:59:47 +02:00
\fB mysqlcheck\fR
named
\fB mysqlrepair\fR , or make a symbolic link to
\fB mysqlcheck\fR
named
2009-09-16 14:03:18 +02:00
\fB mysqlrepair\fR \& . If you invoke
\fB mysqlrepair\fR , it repairs tables\& .
2009-05-25 11:59:47 +02:00
.PP
The following names can be used to change
\fB mysqlcheck\fR
2009-09-16 14:03:18 +02:00
default behavior\& .
2009-05-25 11:59:47 +02:00
.TS
allbox tab(:);
l l
l l
l l.
T{
\fB mysqlrepair\fR
T}:T{
The default option is \fB \- \- repair\fR
T}
T{
\fB mysqlanalyze\fR
T}:T{
The default option is \fB \- \- analyze\fR
T}
T{
\fB mysqloptimize\fR
T}:T{
The default option is \fB \- \- optimize\fR
T}
.TE
2009-09-16 14:03:18 +02:00
.sp 1
2009-05-25 11:59:47 +02:00
.PP
\fB mysqlcheck\fR
2010-04-28 15:06:11 +02:00
supports the following options, which can be specified on the command line or in the
[mysqlcheck]
and
[client]
option file groups\& .
2016-03-22 20:21:49 +01:00
The \fB -c\fR , \fB -r\fR , \fB -a\fR and \fB -o\fR options are exclusive to each other\& .
2009-09-16 14:03:18 +02:00
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: help option
. \" help option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- help\fR ,
\fB \- ?\fR
.sp
2009-09-16 14:03:18 +02:00
Display a help message and exit\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: all-databases option
. \" all-databases option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- all\- databases\fR ,
\fB \- A\fR
.sp
2009-09-16 14:03:18 +02:00
Check all tables in all databases\& . This is the same as using the
2009-05-25 11:59:47 +02:00
\fB \- \- databases\fR
2009-09-16 14:03:18 +02:00
option and naming all the databases on the command line\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: all-in-1 option
. \" all-in-1 option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- all\- in\- 1\fR ,
\fB \- 1\fR
.sp
2009-09-16 14:03:18 +02:00
Instead of issuing a statement for each table, execute a single statement for each database that names all the tables from that database to be processed\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: analyze option
. \" analyze option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- analyze\fR ,
\fB \- a\fR
.sp
2009-09-16 14:03:18 +02:00
Analyze the tables\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: auto-repair option
. \" auto-repair option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- auto\- repair\fR
.sp
2009-09-16 14:03:18 +02:00
If a checked table is corrupted, automatically fix it\& . Any necessary repairs are done after all tables have been checked\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: character-sets-dir option
. \" character-sets-dir option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- character\- sets\- dir=\fR \fB \fI path\fR \fR
.sp
2015-09-09 14:32:52 +02:00
The directory where character sets are installed\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: check option
. \" check option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- check\fR ,
\fB \- c\fR
.sp
2009-09-16 14:03:18 +02:00
Check the tables for errors\& . This is the default operation\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: check-only-changed option
. \" check-only-changed option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- check\- only\- changed\fR ,
\fB \- C\fR
.sp
2009-09-16 14:03:18 +02:00
Check only tables that have changed since the last check or that have not been closed properly\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: check-upgrade option
. \" check-upgrade option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- check\- upgrade\fR ,
\fB \- g\fR
.sp
Invoke
CHECK TABLE
with the
FOR UPGRADE
2009-09-16 14:03:18 +02:00
option to check tables for incompatibilities with the current version of the server\& . This option automatically enables the
2009-05-25 11:59:47 +02:00
\fB \- \- fix\- db\- names\fR
and
\fB \- \- fix\- table\- names\fR
2009-09-16 14:03:18 +02:00
options\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: compress option
. \" compress option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- compress\fR
.sp
2009-09-16 14:03:18 +02:00
Compress all information sent between the client and the server if both support compression\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: databases option
. \" databases option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- databases\fR ,
\fB \- B\fR
.sp
2009-09-16 14:03:18 +02:00
Process all tables in the named databases\& . Normally,
2009-05-25 11:59:47 +02:00
\fB mysqlcheck\fR
2009-09-16 14:03:18 +02:00
treats the first name argument on the command line as a database name and following names as table names\& . With this option, it treats all name arguments as database names\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: debug option
. \" debug option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- debug[=\fR \fB \fI debug_options\fR \fR \fB ]\fR ,
\fB \- # [\fR \fB \fI debug_options\fR \fR \fB ]\fR
.sp
2009-09-16 14:03:18 +02:00
Write a debugging log\& . A typical
2009-05-25 11:59:47 +02:00
\fI debug_options\fR
2009-09-16 14:03:18 +02:00
string is
\' d:t:o,\fI file_name\fR \' \& . The default is
\' d:t:o\' \& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: debug-check option
. \" debug-check option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- debug\- check\fR
.sp
2015-09-09 14:32:52 +02:00
Print some debugging information when the program exits\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: debug-info option
. \" debug-info option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- debug\- info\fR
.sp
2015-09-09 14:32:52 +02:00
Print debugging information and memory and CPU usage statistics when the program exits\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: default-auth option
. \" default-auth option: mysqlcheck
\fB \- \- default\- auth=\fR \fB \fI name\fR \fR
.sp
Default authentication client-side plugin to use\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: default-character-set option
. \" default-character-set option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- default\- character\- set=\fR \fB \fI charset_name\fR \fR
.sp
Use
\fI charset_name\fR
2015-09-09 14:32:52 +02:00
as the default character set\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2013-06-13 00:13:23 +02:00
. \" mysqlcheck: defaults-extra-file option
. \" defaults-extra-file option: mysqlcheck
\fB \- \- defaults\- extra\- file=\fR \fB \fI filename\fR \fR
.sp
Set \fB \fI filename\fR \fR as the file to read default options from after the global defaults files has been read\& .
Must be given as first option\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: defaults-file option
. \" defaults-file option: mysqlcheck
\fB \- \- defaults\- file=\fR \fB \fI filename\fR \fR
.sp
Set \fB \fI filename\fR \fR as the file to read default options from, override global defaults files\& .
Must be given as first option\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2009-09-16 14:03:18 +02:00
. \" mysqlcheck: extended option
. \" extended option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- extended\fR ,
\fB \- e\fR
.sp
2009-09-16 14:03:18 +02:00
If you are using this option to check tables, it ensures that they are 100% consistent but takes a long time\& .
2009-05-25 11:59:47 +02:00
.sp
2015-09-09 14:32:52 +02:00
If you are using this option to repair tables, it will force using the old, slow, repair with keycache method,
instead of the much faster repair by sorting.
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: fast option
. \" fast option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- fast\fR ,
\fB \- F\fR
.sp
2009-09-16 14:03:18 +02:00
Check only tables that have not been closed properly\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: fix-db-names option
. \" fix-db-names option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- fix\- db\- names\fR
.sp
2015-09-09 14:32:52 +02:00
Convert database names to the format used since MySQL 5\& .1\& . Only database names that contain special characters are affected\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: fix-table-names option
. \" fix-table-names option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- fix\- table\- names\fR
.sp
2015-09-09 14:32:52 +02:00
Convert table names (including views) to the format used since MySQL 5\& .1\& . Only table names that contain special characters are affected\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: flush option
. \" flush option: mysqlcheck
\fB \- \- flush\fR ,
.sp
Flush each table after check. This is useful if you don't
want to have the checked tables take up space in the caches after the check\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: force option
. \" force option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- force\fR ,
\fB \- f\fR
.sp
2009-09-16 14:03:18 +02:00
Continue even if an SQL error occurs\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: host option
. \" host option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- host=\fR \fB \fI host_name\fR \fR ,
\fB \- h \fR \fB \fI host_name\fR \fR
.sp
2015-09-09 14:32:52 +02:00
Connect to the MariaDB server on the given host\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: medium-check option
. \" medium-check option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- medium\- check\fR ,
\fB \- m\fR
.sp
Do a check that is faster than an
\fB \- \- extended\fR
2009-09-16 14:03:18 +02:00
operation\& . This finds only 99\& .99% of all errors, which should be good enough in most cases\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2013-06-13 00:13:23 +02:00
. \" mysqlcheck: no-defaults option
. \" no-defaults option: mysqlcheck
\fB \- \- no\- defaults\fR
.sp
Do not read default options from any option file\& . This must be given as the first argument\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2009-09-16 14:03:18 +02:00
. \" mysqlcheck: optimize option
. \" optimize option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- optimize\fR ,
\fB \- o\fR
.sp
2009-09-16 14:03:18 +02:00
Optimize the tables\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: password option
. \" password option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- password[=\fR \fB \fI password\fR \fR \fB ]\fR ,
\fB \- p[\fR \fB \fI password\fR \fR \fB ]\fR
.sp
2009-09-16 14:03:18 +02:00
The password to use when connecting to the server\& . If you use the short option form (\fB \- p\fR ), you
2009-05-25 11:59:47 +02:00
\fI cannot\fR
2009-09-16 14:03:18 +02:00
have a space between the option and the password\& . If you omit the
2009-05-25 11:59:47 +02:00
\fI password\fR
value following the
\fB \- \- password\fR
or
\fB \- p\fR
2010-04-28 15:06:11 +02:00
option on the command line,
\fB mysqlcheck\fR
prompts for one\& .
2009-05-25 11:59:47 +02:00
.sp
2015-09-09 14:32:52 +02:00
Specifying a password on the command line should be considered insecure\& . You can use an option file to avoid giving the password on the command line\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2015-03-11 18:49:31 +01:00
. \" mysqlcheck: persisent option
. \" persistent option: mysql
\fB \- \- persistent\fR ,
\fB \- Z\fR
.sp
Used with ANALYZE TABLE to append the option PERSISENT FOR ALL.
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2009-09-16 14:03:18 +02:00
. \" mysqlcheck: pipe option
. \" pipe option: mysql
2009-05-25 11:59:47 +02:00
\fB \- \- pipe\fR ,
\fB \- W\fR
.sp
2010-04-28 15:06:11 +02:00
On Windows, connect to the server via a named pipe\& . This option applies only if the server supports named\- pipe connections\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2015-09-09 14:32:52 +02:00
. \" mysqlcheck: plugin-dir option
. \" plugin-dir option: mysqlcheck
\fB \- \- plugin\- dir=\fR \fB \fI name\fR \fR
2009-05-25 11:59:47 +02:00
.sp
2015-09-09 14:32:52 +02:00
Directory for client-side plugins\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2015-09-09 14:32:52 +02:00
. \" mysqlcheck: port option
. \" port option: mysqlcheck
\fB \- \- port=\fR \fB \fI port_num\fR \fR ,
\fB \- P \fR \fB \fI port_num\fR \fR
2009-05-25 11:59:47 +02:00
.sp
2015-09-09 14:32:52 +02:00
The TCP/IP port number to use for the connection\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2013-06-13 00:13:23 +02:00
. \" mysqlcheck: print-defaults option
. \" print-defaults option: mysqlcheck
\fB \- \- print\- defaults\fR
.sp
Print the program argument list and exit\& .
This must be given as the first argument\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2015-09-09 14:32:52 +02:00
. \" mysqlcheck: process-tables option
. \" process-tables option: mysqlcheck
\fB \- \- process\- tables\fR
.sp
Perform the requested operation on tables. Defaults to on; use \fB --skip-process-tables\fR to disable\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: process-views option
. \" process-views option: mysqlcheck
\fB \- \- process\- views=\fB \fI val\fR
.sp
Perform the requested operation (only CHECK VIEW or REPAIR VIEW). Possible values are NO, YES (correct the checksum, if necessary, add the mariadb-version field), UPGRADE_FROM_MYSQL (same as YES and toggle the algorithm MERGE<->TEMPTABLE\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: protocol option
. \" protocol option: mysqlcheck
\fB \- \- protocol={TCP|SOCKET|PIPE|MEMORY}\fR
.sp
The connection protocol to use for connecting to the server\& . It is useful when the other connection parameters normally would cause a protocol to be used other than the one you want\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2009-09-16 14:03:18 +02:00
. \" mysqlcheck: quick option
. \" quick option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- quick\fR ,
\fB \- q\fR
.sp
2009-09-16 14:03:18 +02:00
If you are using this option to check tables, it prevents the check from scanning the rows to check for incorrect links\& . This is the fastest check method\& .
2009-05-25 11:59:47 +02:00
.sp
2009-09-16 14:03:18 +02:00
If you are using this option to repair tables, it tries to repair only the index tree\& . This is the fastest repair method\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: repair option
. \" repair option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- repair\fR ,
\fB \- r\fR
.sp
2009-09-16 14:03:18 +02:00
Perform a repair that can fix almost anything except unique keys that are not unique\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: silent option
. \" silent option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- silent\fR ,
\fB \- s\fR
.sp
2009-09-16 14:03:18 +02:00
Silent mode\& . Print only error messages\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2015-09-09 14:32:52 +02:00
. \" mysqlcheck: skip-database option
. \" skip-database option: mysqlcheck
\fB \- \- skip\- database=\fB \fI db_name\fR
\fB \- s\fR
.sp
Don't process the database (case-sensitive) specified as argument\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2009-09-16 14:03:18 +02:00
. \" mysqlcheck: socket option
. \" socket option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- socket=\fR \fB \fI path\fR \fR ,
\fB \- S \fR \fB \fI path\fR \fR
.sp
For connections to
2009-09-16 14:03:18 +02:00
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
. \}
2015-09-09 14:32:52 +02:00
. \" mysqladmin: SSL options
. \" SSL options: mysqladmin
2009-05-25 11:59:47 +02:00
\fB \- \- ssl\fR
2015-09-09 14:32:52 +02:00
.sp
Enable SSL for connection (automatically enabled with other flags). Disable with
\fB \- \- skip-ssl\fR \& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqladmin: SSL CA option
. \" SSL CA option: mysqladmin
\fB \- \- ssl\- ca=\fI name\fR
.sp
CA file in PEM format (check OpenSSL docs, implies
\fB \- \- ssl\fR )\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqladmin: SSL CA Path option
. \" SSL CA Path option: mysqladmin
\fB \- \- ssl\- capath=\fI name\fR
.sp
CA directory (check OpenSSL docs, implies
\fB \- \- ssl\fR )\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqladmin: SSL Cert option
. \" SSL Cert option: mysqladmin
\fB \- \- ssl\- cert=\fI name\fR
.sp
X509 cert in PEM format (check OpenSSL docs, implies
\fB \- \- ssl\fR )\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqladmin: SSL Cipher option
. \" SSL Cipher option: mysqladmin
\fB \- \- ssl\- cipher=\fI name\fR
.sp
SSL cipher to use (check OpenSSL docs, implies
\fB \- \- ssl\fR )\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqladmin: SSL Key option
. \" SSL Key option: mysqladmin
\fB \- \- ssl\- key=\fI name\fR
.sp
X509 key in PEM format (check OpenSSL docs, implies
\fB \- \- ssl\fR )\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqladmin: SSL Crl option
. \" SSL CRL option: mysqladmin
\fB \- \- ssl\- crl=\fI name\fR
.sp
Certificate revocation list (check OpenSSL docs, implies
\fB \- \- ssl\fR )\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqladmin: SSL Crlpath option
. \" SSL Crlpath option: mysqladmin
\fB \- \- ssl\- crlpath=\fI name\fR
.sp
Certificate revocation list path (check OpenSSL docs, implies
\fB \- \- ssl\fR )\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqladmin: SSL Verify Server Cert option
. \" SSL Verify Server Cert option: mysqladmin
\fB \- \- ssl\- verify\- server\- cert\fR
.sp
Verify server's "Common Name" in its cert against hostname used when connecting. This option is disabled by default\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: tables option
. \" tables option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- tables\fR
.sp
2009-09-16 14:03:18 +02:00
Override the
2009-05-25 11:59:47 +02:00
\fB \- \- databases\fR
or
\fB \- B\fR
2009-09-16 14:03:18 +02:00
option\& . All name arguments following the option are regarded as table names\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: use-frm option
. \" use-frm option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- use\- frm\fR
.sp
For repair operations on
MyISAM
tables, get the table structure from the
2009-09-16 14:03:18 +02:00
\& .frm
2009-05-25 11:59:47 +02:00
file so that the table can be repaired even if the
2009-09-16 14:03:18 +02:00
\& .MYI
header is corrupted\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: user option
. \" user option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- user=\fR \fB \fI user_name\fR \fR ,
\fB \- u \fR \fB \fI user_name\fR \fR
.sp
2015-09-09 14:32:52 +02:00
The MariaDB user name to use when connecting to the server\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: verbose option
. \" verbose option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- verbose\fR ,
\fB \- v\fR
.sp
2009-09-16 14:03:18 +02:00
Verbose mode\& . Print information about the various stages of program operation\& .
2015-09-09 14:32:52 +02:00
Using one \fB --verbose\fR option will give you more information about what mysqlcheck is
doing\& .
.sp
Using two \fB --verbose\fR options will also give you connection information\& .
.sp
Using it 3 times will print out all CHECK, RENAME and ALTER TABLE during
the check phase\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlcheck: version option
. \" version option: mysqlcheck
2009-05-25 11:59:47 +02:00
\fB \- \- version\fR ,
\fB \- V\fR
.sp
2009-09-16 14:03:18 +02:00
Display version information and exit\& .
.RE
2010-04-28 15:06:11 +02:00
.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
\fB mysqlcheck\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
2015-09-09 14:32:52 +02:00
when these statements should not be sent to replication slaves or run when using the binary logs for recovery from backup\& .
2010-04-28 15:06:11 +02:00
.RE
2009-05-25 11:59:47 +02:00
.SH "COPYRIGHT"
2009-09-16 14:03:18 +02:00
.br
2009-05-25 11:59:47 +02:00
.PP
2019-07-01 17:21:57 +02:00
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2019 MariaDB Foundation
2009-05-25 11:59:47 +02:00
.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.
.PP
This documentation is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
.PP
2019-05-11 20:29:06 +02:00
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-1335 USA or see http://www.gnu.org/licenses/.
2009-09-16 14:03:18 +02:00
.sp
2009-05-25 11:59:47 +02:00
.SH "SEE ALSO"
2015-09-09 14:32:52 +02:00
For more information, please refer to the MariaDB Knowledge Base, available online at https://mariadb.com/kb/
2009-05-25 11:59:47 +02:00
.SH AUTHOR
2015-09-09 14:32:52 +02:00
MariaDB Foundation (http://www.mariadb.org/).