mirror/mariadb
1
0
Fork 0
mirror of https://github.com/MariaDB/server.git synced 2025-03-26 00:48:41 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions1

Update man pages, binary names, version

Browse source
This commit is contained in:
Ian Gilfillan 2024-09-03 19:15:59 +02:00 • committed by Daniel Black
parent 44733aa8cf
commit 9011e3be18
57 changed files with 2924 additions and 2924 deletions

10
man/comp_err.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBCOMP_ERR\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBCOMP_ERR\fR" "1" "4 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -23,7 +23,7 @@ comp_err \- compile MariaDB error message file
creates the
errmsg\&.sys
file that is used by
\fBmysqld\fR
\fBmariadbd\fR
to determine the error messages to display for different error codes\&.
\fBcomp_err\fR
normally is run automatically when MariaDB is built\&. It compiles the
@ -39,7 +39,7 @@ mysqld_ername\&.h, and
sql_state\&.h
header files\&.
.PP
For more information about how error messages are defined, see the MySQL Internals Manual\&.
For more information about how error messages are defined, see the MariaDB Manual\&.
.PP
Invoke
\fBcomp_err\fR
@ -141,7 +141,7 @@ Print some debugging information when the program exits\&.
\fB\-H \fR\fB\fIfile_name\fR\fR
.sp
The name of the error header file\&. The default is
mysqld_error\&.h\&.
mariadbd_error\&.h\&.
.RE
.sp
.RS 4
@ -247,7 +247,7 @@ Display version information and exit\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

2
man/galera_new_cluster.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBGALERA_NEW_CLUSTER\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBGALERA_NEW_CLUSTER\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------

2
man/galera_recovery.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBGALERA_RECOVERY\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBGALERA_RECOVERY\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------

4
man/innochecksum.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBINNOCHECKSUM\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBINNOCHECKSUM\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -303,7 +303,7 @@ Displays version information and exits\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2023 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

122
man/mariadb-access.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADB-ACCESS\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-ACCESS\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,17 +11,17 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysqlaccess
.\" mariadb-access
.SH "NAME"
mariadb-access \- client for checking access privileges (mysqlaccess is now a symlink to mariadb-access)
mariadb-access \- client for checking access privileges (mariadb-access is now a symlink to mariadb-access)
.SH "SYNOPSIS"
.HP \w'\fBmysqlaccess\ [\fR\fB\fIhost_name\fR\fR\fB\ [\fR\fB\fIuser_name\fR\fR\fB\ [\fR\fB\fIdb_name\fR\fR\fB]]]\ [\fR\fB\fIoptions\fR\fR\fB]\fR\ 'u
\fBmysqlaccess [\fR\fB\fIhost_name\fR\fR\fB [\fR\fB\fIuser_name\fR\fR\fB [\fR\fB\fIdb_name\fR\fR\fB]]] [\fR\fB\fIoptions\fR\fR\fB]\fR
.HP \w'\fBmariadb-access\ [\fR\fB\fIhost_name\fR\fR\fB\ [\fR\fB\fIuser_name\fR\fR\fB\ [\fR\fB\fIdb_name\fR\fR\fB]]]\ [\fR\fB\fIoptions\fR\fR\fB]\fR\ 'u
\fBmariadb-access [\fR\fB\fIhost_name\fR\fR\fB [\fR\fB\fIuser_name\fR\fR\fB [\fR\fB\fIdb_name\fR\fR\fB]]] [\fR\fB\fIoptions\fR\fR\fB]\fR
.SH "DESCRIPTION"
.PP
\fBmysqlaccess\fR
\fBmariadb-access\fR
is a diagnostic tool written by Yves Carlier\&. It checks the access privileges for a host name, user name, and database combination\&. Note that
\fBmysqlaccess\fR
\fBmariadb-access\fR
checks access using only the
user,
db, and
@ -33,20 +33,20 @@ procs_priv
tables\&.
.PP
Invoke
\fBmysqlaccess\fR
\fBmariadb-access\fR
like this:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysqlaccess [\fR\fB\fIhost_name\fR\fR\fB [\fR\fB\fIuser_name\fR\fR\fB [\fR\fB\fIdb_name\fR\fR\fB]]] [\fR\fB\fIoptions\fR\fR\fB]\fR
shell> \fBmariadb-access [\fR\fB\fIhost_name\fR\fR\fB [\fR\fB\fIuser_name\fR\fR\fB [\fR\fB\fIdb_name\fR\fR\fB]]] [\fR\fB\fIoptions\fR\fR\fB]\fR
.fi
.if n \{\
.RE
.\}
.PP
\fBmysqlaccess\fR
\fBmariadb-access\fR
supports the following options\&.
.sp
.RS 4
@ -57,8 +57,8 @@ supports the following options\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlaccess: help option
.\" help option: mysqlaccess
.\" mariadb-access: help option
.\" help option: mariadb-access
\fB\-\-help\fR,
\fB\-?\fR
.sp
@ -73,8 +73,8 @@ Display a help message and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlaccess: brief option
.\" brief option: mysqlaccess
.\" mariadb-access: brief option
.\" brief option: mariadb-access
\fB\-\-brief\fR,
\fB\-b\fR
.sp
@ -89,12 +89,12 @@ Generate reports in single\-line tabular format\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlaccess: commit option
.\" commit option: mysqlaccess
.\" mariadb-access: commit option
.\" commit option: mariadb-access
\fB\-\-commit\fR
.sp
Copy the new access privileges from the temporary tables to the original grant tables\&. The grant tables must be flushed for the new privileges to take effect\&. (For example, execute a
\fBmysqladmin reload\fR
\fBmariadb-admin reload\fR
command\&.)
.RE
.sp
@ -106,8 +106,8 @@ command\&.)
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlaccess: copy option
.\" copy option: mysqlaccess
.\" mariadb-access: copy option
.\" copy option: mariadb-access
\fB\-\-copy\fR
.sp
Reload the temporary grant tables from original ones\&.
@ -121,8 +121,8 @@ Reload the temporary grant tables from original ones\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlaccess: db option
.\" db option: mysqlaccess
.\" mariadb-access: db option
.\" db option: mariadb-access
\fB\-\-db=\fR\fB\fIdb_name\fR\fR,
\fB\-d \fR\fB\fIdb_name\fR\fR
.sp
@ -137,8 +137,8 @@ Specify the database name\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlaccess: debug option
.\" debug option: mysqlaccess
.\" mariadb-access: debug option
.\" debug option: mariadb-access
\fB\-\-debug=\fR\fB\fIN\fR\fR
.sp
Specify the debug level\&.
@ -154,8 +154,8 @@ can be an integer from 0 to 3\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlaccess: host option
.\" host option: mysqlaccess
.\" mariadb-access: host option
.\" host option: mariadb-access
\fB\-\-host=\fR\fB\fIhost_name\fR\fR,
\fB\-h \fR\fB\fIhost_name\fR\fR
.sp
@ -170,12 +170,12 @@ The host name to use in the access privileges\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlaccess: howto option
.\" howto option: mysqlaccess
.\" mariadb-access: howto option
.\" howto option: mariadb-access
\fB\-\-howto\fR
.sp
Display some examples that show how to use
\fBmysqlaccess\fR\&.
\fBmariadb-access\fR\&.
.RE
.sp
.RS 4
@ -186,8 +186,8 @@ Display some examples that show how to use
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlaccess: old_server option
.\" old_server option: mysqlaccess
.\" mariadb-access: old_server option
.\" old_server option: mariadb-access
\fB\-\-old_server\fR
.sp
Connect to a very old MySQL server (before MySQL 3\&.21) that does not know how to handle full
@ -202,8 +202,8 @@ WHERE clauses\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlaccess: password option
.\" password option: mysqlaccess
.\" mariadb-access: password option
.\" password option: mariadb-access
\fB\-\-password[=\fR\fB\fIpassword\fR\fR\fB]\fR,
\fB\-p[\fR\fB\fIpassword\fR\fR\fB]\fR
.sp
@ -214,7 +214,7 @@ value following the
or
\fB\-p\fR
option on the command line,
\fBmysqlaccess\fR
\fBmariadb-access\fR
prompts for one\&.
.sp
Specifying a password on the command line should be considered insecure\&. See
@ -229,8 +229,8 @@ Section\ \&5.3.2.2, \(lqEnd-User Guidelines for Password Security\(rq\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlaccess: plan option
.\" plan option: mysqlaccess
.\" mariadb-access: plan option
.\" plan option: mariadb-access
\fB\-\-plan\fR
.sp
Display suggestions and ideas for future releases\&.
@ -244,8 +244,8 @@ Display suggestions and ideas for future releases\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlaccess: preview option
.\" preview option: mysqlaccess
.\" mariadb-access: preview option
.\" preview option: mariadb-access
\fB\-\-preview\fR
.sp
Show the privilege differences after making changes to the temporary grant tables\&.
@ -259,8 +259,8 @@ Show the privilege differences after making changes to the temporary grant table
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlaccess: relnotes option
.\" relnotes option: mysqlaccess
.\" mariadb-access: relnotes option
.\" relnotes option: mariadb-access
\fB\-\-relnotes\fR
.sp
Display the release notes\&.
@ -274,8 +274,8 @@ Display the release notes\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlaccess: rhost option
.\" rhost option: mysqlaccess
.\" mariadb-access: rhost option
.\" rhost option: mariadb-access
\fB\-\-rhost=\fR\fB\fIhost_name\fR\fR,
\fB\-H \fR\fB\fIhost_name\fR\fR
.sp
@ -290,8 +290,8 @@ Connect to the MariaDB server on the given host\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlaccess: rollback option
.\" rollback option: mysqlaccess
.\" mariadb-access: rollback option
.\" rollback option: mariadb-access
\fB\-\-rollback\fR
.sp
Undo the most recent changes to the temporary grant tables\&.
@ -305,8 +305,8 @@ Undo the most recent changes to the temporary grant tables\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlaccess: spassword option
.\" spassword option: mysqlaccess
.\" mariadb-access: spassword option
.\" spassword option: mariadb-access
\fB\-\-spassword[=\fR\fB\fIpassword\fR\fR\fB]\fR,
\fB\-P[\fR\fB\fIpassword\fR\fR\fB]\fR
.sp
@ -317,7 +317,7 @@ value following the
or
\fB\-p\fR
option on the command line,
\fBmysqlaccess\fR
\fBmariadb-access\fR
prompts for one\&.
.sp
Specifying a password on the command line should be considered insecure\&. See
@ -332,8 +332,8 @@ Section\ \&5.3.2.2, \(lqEnd-User Guidelines for Password Security\(rq\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlaccess: superuser option
.\" superuser option: mysqlaccess
.\" mariadb-access: superuser option
.\" superuser option: mariadb-access
\fB\-\-superuser=\fR\fB\fIuser_name\fR\fR,
\fB\-U \fR\fB\fIuser_name\fR\fR
.sp
@ -348,8 +348,8 @@ Specify the user name for connecting as the superuser\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlaccess: table option
.\" table option: mysqlaccess
.\" mariadb-access: table option
.\" table option: mariadb-access
\fB\-\-table\fR,
\fB\-t\fR
.sp
@ -364,8 +364,8 @@ Generate reports in table format\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlaccess: user option
.\" user option: mysqlaccess
.\" mariadb-access: user option
.\" user option: mariadb-access
\fB\-\-user=\fR\fB\fIuser_name\fR\fR,
\fB\-u \fR\fB\fIuser_name\fR\fR
.sp
@ -380,8 +380,8 @@ The user name to use in the access privileges\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlaccess: version option
.\" version option: mysqlaccess
.\" mariadb-access: version option
.\" version option: mariadb-access
\fB\-\-version\fR,
\fB\-v\fR
.sp
@ -389,33 +389,33 @@ Display version information and exit\&.
.RE
.PP
If your MariaDB distribution is installed in some non\-standard location, you must change the location where
\fBmysqlaccess\fR
\fBmariadb-access\fR
expects to find the
\fBmysql\fR
\fBmariadb\fR
client\&. Edit the
mysqlaccess
mariadb-access
script at approximately line 18\&. Search for a line that looks like this:
.sp
.if n \{\
.RS 4
.\}
.nf
$MYSQL = '/usr/local/bin/mysql'; # path to mysql executable
$MYSQL = '/usr/local/bin/mariadb'; # path to mariadb executable
.fi
.if n \{\
.RE
.\}
.PP
Change the path to reflect the location where
\fBmysql\fR
\fBmariadb\fR
actually is stored on your system\&. If you do not do this, a
Broken pipe
error will occur when you run
\fBmysqlaccess\fR\&.
\fBmariadb-access\fR\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

234
man/mariadb-admin.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADB-ADMIN\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-ADMIN\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,34 +11,34 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysqladmin
.\" mariadb-admin
.\" administration: server
.\" server administration
.SH "NAME"
mariadb-admin \- client for administering a MariaDB server (mysqladmin is now a symlink to mariadb-admin)
mariadb-admin \- client for administering a MariaDB server (mariadb-admin is now a symlink to mariadb-admin)
.SH "SYNOPSIS"
.HP \w'\fBmysqladmin\ [\fR\fB\fIoptions\fR\fR\fB]\ \fR\fB\fIcommand\fR\fR\fB\ [\fR\fB\fIcommand\-arg\fR\fR\fB]\ [\fR\fB\fIcommand\fR\fR\fB\ [\fR\fB\fIcommand\-arg\fR\fR\fB]]\ \&.\&.\&.\fR\ 'u
\fBmysqladmin [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIcommand\fR\fR\fB [\fR\fB\fIcommand\-arg\fR\fR\fB] [\fR\fB\fIcommand\fR\fR\fB [\fR\fB\fIcommand\-arg\fR\fR\fB]] \&.\&.\&.\fR
.HP \w'\fBmariadb-admin\ [\fR\fB\fIoptions\fR\fR\fB]\ \fR\fB\fIcommand\fR\fR\fB\ [\fR\fB\fIcommand\-arg\fR\fR\fB]\ [\fR\fB\fIcommand\fR\fR\fB\ [\fR\fB\fIcommand\-arg\fR\fR\fB]]\ \&.\&.\&.\fR\ 'u
\fBmariadb-admin [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIcommand\fR\fR\fB [\fR\fB\fIcommand\-arg\fR\fR\fB] [\fR\fB\fIcommand\fR\fR\fB [\fR\fB\fIcommand\-arg\fR\fR\fB]] \&.\&.\&.\fR
.SH "DESCRIPTION"
.PP
\fBmysqladmin\fR
\fBmariadb-admin\fR
is a client for performing administrative operations\&. You can use it to check the server's configuration and current status, to create and drop databases, and more\&.
.PP
Invoke
\fBmysqladmin\fR
\fBmariadb-admin\fR
like this:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysqladmin [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIcommand\fR\fR\fB [\fR\fB\fIcommand\-arg\fR\fR\fB] [\fR\fB\fIcommand\fR\fR\fB [\fR\fB\fIcommand\-arg\fR\fR\fB]] \&.\&.\&.\fR
shell> \fBmariadb-admin [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIcommand\fR\fR\fB [\fR\fB\fIcommand\-arg\fR\fR\fB] [\fR\fB\fIcommand\fR\fR\fB [\fR\fB\fIcommand\-arg\fR\fR\fB]] \&.\&.\&.\fR
.fi
.if n \{\
.RE
.\}
.PP
\fBmysqladmin\fR
\fBmariadb-admin\fR
supports the following commands\&. Some of the commands take an argument following the command name\&.
.sp
.RS 4
@ -387,9 +387,9 @@ password \fInew\-password\fR
Set a new password\&. This changes the password to
\fInew\-password\fR
for the account that you use with
\fBmysqladmin\fR
\fBmariadb-admin\fR
for connecting to the server\&. Thus, the next time you invoke
\fBmysqladmin\fR
\fBmariadb-admin\fR
(or any other client program) using the same account, you will need to specify the new password\&.
.sp
If the
@ -400,7 +400,7 @@ value contains spaces or other characters that are special to your command inter
.RS 4
.\}
.nf
shell> \fBmysqladmin password "my new password"\fR
shell> \fBmariadb-admin password "my new password"\fR
.fi
.if n \{\
.RE
@ -424,9 +424,9 @@ password
command with
flush\-privileges
on the same command line to re\-enable the grant tables because the flush operation occurs after you connect\&. However, you can use
\fBmysqladmin flush\-privileges\fR
\fBmariadb-admin flush\-privileges\fR
to re\-enable the grant table and then use a separate
\fBmysqladmin password\fR
\fBmariadb-admin password\fR
command to change the password\&.
.sp .5v
.RE
@ -443,7 +443,7 @@ command to change the password\&.
ping
.sp
Check whether the server is alive\&. The return status from
\fBmysqladmin\fR
\fBmariadb-admin\fR
is 0 if the server is running, 1 if it is not\&. This is 0 even in case of an error such as
Access denied, because this means that the server is running but refused the connection, which is different from the server not running\&.
.RE
@ -602,7 +602,7 @@ All commands can be shortened to any unique prefix\&. For example:
.RS 4
.\}
.nf
shell> \fBmysqladmin proc stat\fR
shell> \fBmariadb-admin proc stat\fR
+\-\-\-\-+\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-+\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-+\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
| Id | User | Host | db | Command | Time | State | Info |
+\-\-\-\-+\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-+\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-+\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
@ -619,7 +619,7 @@ Open tables: 19 Queries per second avg: 0\&.0268
.\" status command: results
.PP
The
\fBmysqladmin status\fR
\fBmariadb-admin status\fR
command result displays the following values:
.sp
.RS 4
@ -739,7 +739,7 @@ The number of tables that currently are open\&.
Memory in use
.sp
The amount of memory allocated directly by
\fBmysqld\fR\&. This value is displayed only when MariaDB has been compiled with
\fBmariadbd\fR\&. This value is displayed only when MariaDB has been compiled with
\fB\-\-with\-debug=full\fR\&.
.RE
.sp
@ -755,23 +755,23 @@ The amount of memory allocated directly by
Maximum memory used
.sp
The maximum amount of memory allocated directly by
\fBmysqld\fR\&. This value is displayed only when MariaDB has been compiled with
\fBmariadbd\fR\&. This value is displayed only when MariaDB has been compiled with
\fB\-\-with\-debug=full\fR\&.
.RE
.PP
If you execute
\fBmysqladmin shutdown\fR
\fBmariadb-admin shutdown\fR
when connecting to a local server using a Unix socket file,
\fBmysqladmin\fR
\fBmariadb-admin\fR
waits until the server's process ID file has been removed, to ensure that the server has stopped properly\&.
.\" mysqladmin command options
.\" command options: mysqladmin
.\" options: command-line: mysqladmin
.\" startup parameters: mysqladmin
.\" mariadb-admin command options
.\" command options: mariadb-admin
.\" options: command-line: mariadb-admin
.\" startup parameters: mariadb-admin
.PP
\fBmysqladmin\fR
\fBmariadb-admin\fR
supports the following options, which can be specified on the command line or in the
[mysqladmin]
[mariadb-admin]
and
[client]
option file groups\&.
@ -784,8 +784,8 @@ option file groups\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: help option
.\" help option: mysqladmin
.\" mariadb-admin: help option
.\" help option: mariadb-admin
\fB\-\-help\fR,
\fB\-?\fR
.sp
@ -800,8 +800,8 @@ Display help and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: character-sets-dir option
.\" character-sets-dir option: mysqladmin
.\" mariadb-admin: character-sets-dir option
.\" character-sets-dir option: mariadb-admin
\fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR
.sp
The directory where character sets are installed\&.
@ -815,8 +815,8 @@ The directory where character sets are installed\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: compress option
.\" compress option: mysqladmin
.\" mariadb-admin: compress option
.\" compress option: mariadb-admin
\fB\-\-compress\fR,
\fB\-C\fR
.sp
@ -831,8 +831,8 @@ Compress all information sent between the client and the server if both support
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: connect-timeout option
.\" connect-timeout option: mysqladmin
.\" mariadb-admin: connect-timeout option
.\" connect-timeout option: mariadb-admin
\fB\-\-connect-timeout=\fR\fB\fItimeout\fR\fR
.sp
Equivalent to \fB\-\-connect_timeout\fR, see the end of this section\&.
@ -846,8 +846,8 @@ Equivalent to \fB\-\-connect_timeout\fR, see the end of this section\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: count option
.\" count option: mysqladmin
.\" mariadb-admin: count option
.\" count option: mariadb-admin
\fB\-\-count=\fR\fB\fIN\fR\fR,
\fB\-c \fR\fB\fIN\fR\fR
.sp
@ -864,14 +864,14 @@ option is given\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: debug option
.\" debug option: mysqladmin
.\" mariadb-admin: debug option
.\" debug option: mariadb-admin
\fB\-\-debug[=\fR\fB\fIdebug_options\fR\fR\fB]\fR,
\fB\-# [\fR\fB\fIdebug_options\fR\fR\fB]\fR
.sp
Write a debugging log\&. A typical
\fIdebug_options\fR
string is 'd:t:o,\fIfile_name\fR'. The default is 'd:t:o,/tmp/mysqladmin.trace'.
string is 'd:t:o,\fIfile_name\fR'. The default is 'd:t:o,/tmp/mariadb-admin.trace'.
.RE
.sp
.RS 4
@ -882,8 +882,8 @@ string is 'd:t:o,\fIfile_name\fR'. The default is 'd:t:o,/tmp/mysqladmin.trace'.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: debug-check option
.\" debug-check option: mysqladmin
.\" mariadb-admin: debug-check option
.\" debug-check option: mariadb-admin
\fB\-\-debug\-check\fR
.sp
Check memory and open file usage at exit.\&.
@ -897,8 +897,8 @@ Check memory and open file usage at exit.\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: debug-info option
.\" debug-info option: mysqladmin
.\" mariadb-admin: debug-info option
.\" debug-info option: mariadb-admin
\fB\-\-debug\-info\fR
.sp
Print debugging information and memory and CPU usage statistics when the program exits\&.
@ -912,8 +912,8 @@ Print debugging information and memory and CPU usage statistics when the program
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: default-auth option
.\" default-auth option: mysqladmin
.\" mariadb-admin: default-auth option
.\" default-auth option: mariadb-admin
\fB\-\-default\-auth\fR
.sp
Default authentication client-side plugin to use\&.
@ -927,8 +927,8 @@ Default authentication client-side plugin to use\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: default-character-set option
.\" default-character-set option: mysqladmin
.\" mariadb-admin: default-character-set option
.\" default-character-set option: mariadb-admin
\fB\-\-default\-character\-set=\fR\fB\fIcharset_name\fR\fR
.sp
Use
@ -944,8 +944,8 @@ as the default character set\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: defaults-extra-file option
.\" defaults-extra-file option: mysqladmin
.\" mariadb-admin: defaults-extra-file option
.\" defaults-extra-file option: mariadb-admin
\fB\-\-defaults\-extra\-file=\fR\fB\fIfilename\fR\fR
.sp
Set \fB\fIfilename\fR\fR as the file to read default options from after the global defaults files has been read\&.
@ -960,8 +960,8 @@ Must be given as first option\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: defaults-file option
.\" defaults-file option: mysqladmin
.\" mariadb-admin: defaults-file option
.\" defaults-file option: mariadb-admin
\fB\-\-defaults\-file=\fR\fB\fIfilename\fR\fR
.sp
Set \fB\fIfilename\fR\fR as the file to read default options from, override global defaults files\&. Must be given as first option\&.
@ -975,8 +975,8 @@ Set \fB\fIfilename\fR\fR as the file to read default options from, override glob
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: force option
.\" force option: mysqladmin
.\" mariadb-admin: force option
.\" force option: mariadb-admin
\fB\-\-force\fR,
\fB\-f\fR
.sp
@ -993,8 +993,8 @@ command\&. With multiple commands, continue even if an error occurs\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: host option
.\" host option: mysqladmin
.\" mariadb-admin: host option
.\" host option: mariadb-admin
\fB\-\-host=\fR\fB\fIhost_name\fR\fR,
\fB\-h \fR\fB\fIhost_name\fR\fR
.sp
@ -1009,8 +1009,8 @@ Connect to the MariaDB server on the given host\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: local option
.\" local option: mysqladmin
.\" mariadb-admin: local option
.\" local option: mariadb-admin
\fB\-\-local\fR,
\fB\-l\fR
.sp
@ -1021,8 +1021,8 @@ Suppress the SQL command(s) from being written to the binary log by using FLUSH
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.\" mysqladmin: no-beep option
.\" no-beep option: mysqladmin
.\" mariadb-admin: no-beep option
.\" no-beep option: mariadb-admin
\fB\-\-no\-beep\fR,
\fB\-b\fR
.sp
@ -1037,8 +1037,8 @@ Suppress the warning beep that is emitted by default for errors such as a failur
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: no-defaults option
.\" no-defaults option: mysqladmin
.\" mariadb-admin: no-defaults option
.\" no-defaults option: mariadb-admin
\fB\-\-no\-defaults\fR
.sp
Do not read default options from any option file\&. This must be given as the first argument\&.
@ -1052,8 +1052,8 @@ Do not read default options from any option file\&. This must be given as the fi
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: password option
.\" password option: mysqladmin
.\" mariadb-admin: password option
.\" password option: mariadb-admin
\fB\-\-password[=\fR\fB\fIpassword\fR\fR\fB]\fR,
\fB\-p[\fR\fB\fIpassword\fR\fR\fB]\fR
.sp
@ -1066,7 +1066,7 @@ value following the
or
\fB\-p\fR
option on the command line,
\fBmysqladmin\fR
\fBmariadb-admin\fR
prompts for one\&.
.sp
Specifying a password on the command line should be considered insecure\&.
@ -1080,8 +1080,8 @@ Specifying a password on the command line should be considered insecure\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: pipe option
.\" pipe option: mysqladmin
.\" mariadb-admin: pipe option
.\" pipe option: mariadb-admin
\fB\-\-pipe\fR,
\fB\-W\fR
.sp
@ -1096,8 +1096,8 @@ On Windows, connect to the server via a named pipe\&. This option applies only i
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: port option
.\" port option: mysqladmin
.\" mariadb-admin: port option
.\" port option: mariadb-admin
\fB\-\-port=\fR\fB\fIport_num\fR\fR,
\fB\-P \fR\fB\fIport_num\fR\fR
.sp
@ -1114,8 +1114,8 @@ Forces --protocol=tcp when specified on the command line without other connectio
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: print-defaults option
.\" print-defaults option: mysqladmin
.\" mariadb-admin: print-defaults option
.\" print-defaults option: mariadb-admin
\fB\-\-print\-defaults\fR
.sp
Print the program argument list and exit\&. This must be given as the first argument\&.
@ -1129,8 +1129,8 @@ Print the program argument list and exit\&. This must be given as the first argu
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: protocol option
.\" protocol option: mysqladmin
.\" mariadb-admin: protocol option
.\" protocol option: mariadb-admin
\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\&.
@ -1144,8 +1144,8 @@ The connection protocol to use for connecting to the server\&. It is useful when
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: relative option
.\" relative option: mysqladmin
.\" mariadb-admin: relative option
.\" relative option: mariadb-admin
\fB\-\-relative\fR,
\fB\-r\fR
.sp
@ -1164,8 +1164,8 @@ command\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: shutdown-timeout option
.\" shutdown-timeout option: mysqladmin
.\" mariadb-admin: shutdown-timeout option
.\" shutdown-timeout option: mariadb-admin
\fB\-\-shutdown\-timeout\fR\fB\fItimeout\fR\fR
.sp
Equivalent of \fB\-\-shutdown_timeout\fR, see the end of this section\&.
@ -1179,8 +1179,8 @@ Equivalent of \fB\-\-shutdown_timeout\fR, see the end of this section\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: silent option
.\" silent option: mysqladmin
.\" mariadb-admin: silent option
.\" silent option: mariadb-admin
\fB\-\-silent\fR,
\fB\-s\fR
.sp
@ -1195,8 +1195,8 @@ Exit silently if a connection to the server cannot be established\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: sleep option
.\" sleep option: mysqladmin
.\" mariadb-admin: sleep option
.\" sleep option: mariadb-admin
\fB\-\-sleep=\fR\fB\fIdelay\fR\fR,
\fB\-i \fR\fB\fIdelay\fR\fR
.sp
@ -1207,7 +1207,7 @@ seconds in between\&. The
option determines the number of iterations\&. If
\fB\-\-count\fR
is not given,
\fBmysqladmin\fR
\fBmariadb-admin\fR
executes commands indefinitely until interrupted\&.
.RE
.sp
@ -1219,8 +1219,8 @@ executes commands indefinitely until interrupted\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: socket option
.\" socket option: mysqladmin
.\" mariadb-admin: socket option
.\" socket option: mariadb-admin
\fB\-\-socket=\fR\fB\fIpath\fR\fR,
\fB\-S \fR\fB\fIpath\fR\fR
.sp
@ -1237,8 +1237,8 @@ Forces --protocol=socket when specified on the command line without other connec
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL options
.\" SSL options: mysqladmin
.\" mariadb-admin: SSL options
.\" SSL options: mariadb-admin
\fB\-\-ssl\fR
.sp
Enable SSL for connection (automatically enabled with other flags). Disable with
@ -1253,8 +1253,8 @@ Enable SSL for connection (automatically enabled with other flags). Disable with
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL CA option
.\" SSL CA option: mysqladmin
.\" mariadb-admin: SSL CA option
.\" SSL CA option: mariadb-admin
\fB\-\-ssl\-ca=\fIname\fR
.sp
CA file in PEM format (check OpenSSL docs, implies
@ -1269,8 +1269,8 @@ CA file in PEM format (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL CA Path option
.\" SSL CA Path option: mysqladmin
.\" mariadb-admin: SSL CA Path option
.\" SSL CA Path option: mariadb-admin
\fB\-\-ssl\-capath=\fIname\fR
.sp
CA directory (check OpenSSL docs, implies
@ -1285,8 +1285,8 @@ CA directory (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL Cert option
.\" SSL Cert option: mysqladmin
.\" mariadb-admin: SSL Cert option
.\" SSL Cert option: mariadb-admin
\fB\-\-ssl\-cert=\fIname\fR
.sp
X509 cert in PEM format (check OpenSSL docs, implies
@ -1301,8 +1301,8 @@ X509 cert in PEM format (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL Cipher option
.\" SSL Cipher option: mysqladmin
.\" mariadb-admin: SSL Cipher option
.\" SSL Cipher option: mariadb-admin
\fB\-\-ssl\-cipher=\fIname\fR
.sp
SSL cipher to use (check OpenSSL docs, implies
@ -1317,8 +1317,8 @@ SSL cipher to use (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL Key option
.\" SSL Key option: mysqladmin
.\" mariadb-admin: SSL Key option
.\" SSL Key option: mariadb-admin
\fB\-\-ssl\-key=\fIname\fR
.sp
X509 key in PEM format (check OpenSSL docs, implies
@ -1333,8 +1333,8 @@ X509 key in PEM format (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL Crl option
.\" SSL CRL option: mysqladmin
.\" mariadb-admin: SSL Crl option
.\" SSL CRL option: mariadb-admin
\fB\-\-ssl\-crl=\fIname\fR
.sp
Certificate revocation list (check OpenSSL docs, implies
@ -1349,8 +1349,8 @@ Certificate revocation list (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL Crlpath option
.\" SSL Crlpath option: mysqladmin
.\" mariadb-admin: SSL Crlpath option
.\" SSL Crlpath option: mariadb-admin
\fB\-\-ssl\-crlpath=\fIname\fR
.sp
Certificate revocation list path (check OpenSSL docs, implies
@ -1365,8 +1365,8 @@ Certificate revocation list path (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL Verify Server Cert option
.\" SSL Verify Server Cert option: mysqladmin
.\" mariadb-admin: SSL Verify Server Cert option
.\" SSL Verify Server Cert option: mariadb-admin
\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\&.
@ -1380,8 +1380,8 @@ Verify server's "Common Name" in its cert against hostname used when connecting.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: TLS Version option
.\" TLS Version option: mysqladmin
.\" mariadb-admin: TLS Version option
.\" TLS Version option: mariadb-admin
\fB\-\-tls\-version=\fR\fB\fIname\fR\fR,
.sp
Accepts a comma-separated list of TLS protocol versions\&. A TLS protocol version will only be enabled if it
@ -1396,8 +1396,8 @@ is present in this list\&. All other TLS protocol versions will not be permitted
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: user option
.\" user option: mysqladmin
.\" mariadb-admin: user option
.\" user option: mariadb-admin
\fB\-\-user=\fR\fB\fIuser_name\fR\fR,
\fB\-u \fR\fB\fIuser_name\fR\fR
.sp
@ -1412,8 +1412,8 @@ The MariaDB user name to use when connecting to the server\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: verbose option
.\" verbose option: mysqladmin
.\" mariadb-admin: verbose option
.\" verbose option: mariadb-admin
\fB\-\-verbose\fR,
\fB\-v\fR
.sp
@ -1428,8 +1428,8 @@ Verbose mode\&. Print more information about what the program does\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: version option
.\" version option: mysqladmin
.\" mariadb-admin: version option
.\" version option: mariadb-admin
\fB\-\-version\fR,
\fB\-V\fR
.sp
@ -1444,8 +1444,8 @@ Display version information and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: vertical option
.\" vertical option: mysqladmin
.\" mariadb-admin: vertical option
.\" vertical option: mariadb-admin
\fB\-\-vertical\fR,
\fB\-E\fR
.sp
@ -1461,8 +1461,8 @@ Print output vertically\&. This is similar to
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: wait option
.\" wait option: mysqladmin
.\" mariadb-admin: wait option
.\" wait option: mariadb-admin
\fB\-\-wait[=\fR\fB\fIcount\fR\fR\fB]\fR,
\fB\-w[\fR\fB\fIcount\fR\fR\fB]\fR
.sp
@ -1479,8 +1479,8 @@ value is given, it indicates the number of times to retry\&. The default is one
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: --wait-for-all-slaves option
.\" --wait-for-all-slaves option: mysqladmin
.\" mariadb-admin: --wait-for-all-slaves option
.\" --wait-for-all-slaves option: mariadb-admin
\fB\-\-wait\-for\-all\-slaves\fR
.sp
Wait for the last binlog event to be sent to all connected slaves before shutting down\&.
@ -1522,7 +1522,7 @@ The maximum number of seconds to wait for server shutdown\&. The default value i
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

2
man/mariadb-backup.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIABACKUP\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIABACKUP\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------

334
man/mariadb-binlog.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADB-BINLOG\fR" "1" "14 April 2021" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-BINLOG\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,31 +11,31 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysqlbinlog
.\" mariadb-binlog
.SH "NAME"
mariadb-binlog \- utility for processing binary log files (mysqlbinlog is now a symlink to mariadb-binlog)
mariadb-binlog \- utility for processing binary log files (mariadb-binlog is now a symlink to mariadb-binlog)
.SH "SYNOPSIS"
.HP \w'\fBmysqlbinlog\ [\fR\fBoptions\fR\fB]\ \fR\fB\fIlog_file\fR\fR\fB\ \&.\&.\&.\fR\ 'u
\fBmysqlbinlog [\fR\fBoptions\fR\fB] \fR\fB\fIlog_file\fR\fR\fB \&.\&.\&.\fR
.HP \w'\fBmariadb-binlog\ [\fR\fBoptions\fR\fB]\ \fR\fB\fIlog_file\fR\fR\fB\ \&.\&.\&.\fR\ 'u
\fBmariadb-binlog [\fR\fBoptions\fR\fB] \fR\fB\fIlog_file\fR\fR\fB \&.\&.\&.\fR
.SH "DESCRIPTION"
.PP
The server's binary log consists of files containing
\(lqevents\(rq
that describe modifications to database contents\&. The server writes these files in binary format\&. To display their contents in text format, use the
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
utility\&. You can also use
\fBmysqlbinlog\fR
\fBmariadb-binlog\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\&.
.PP
Invoke
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
like this:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysqlbinlog [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIlog_file\fR\fR\fB \&.\&.\&.\fR
shell> \fBmariadb-binlog [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIlog_file\fR\fR\fB \&.\&.\&.\fR
.fi
.if n \{\
.RE
@ -48,7 +48,7 @@ binlog\&.000003, use this command:
.RS 4
.\}
.nf
shell> \fBmysqlbinlog binlog\&.0000003\fR
shell> \fBmariadb-binlog binlog\&.0000003\fR
.fi
.if n \{\
.RE
@ -90,12 +90,12 @@ error_code
indicates the result from executing the event\&. Zero means that no error occurred\&.
.PP
The output from
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
can be re\-executed (for example, by using it as input to
\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\&.
\fBmariadb\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\&.
.PP
Normally, you use
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
to read binary log files directly and apply them to the local MariaDB server\&. It is also possible to read binary logs from a remote server by using the
\fB\-\-read\-from\-remote\-server\fR
option\&. To read remote binary logs, the connection parameter options can be given to indicate how to connect to the server\&. These options are
@ -108,9 +108,9 @@ option\&. To read remote binary logs, the connection parameter options can be gi
\fB\-\-read\-from\-remote\-server\fR
option\&.
.PP
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
supports the following options, which can be specified on the command line or in the
[mysqlbinlog]
[mariadb-binlog]
and
[client]
option file groups\&.
@ -123,8 +123,8 @@ option file groups\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: help option
.\" help option: mysqlbinlog
.\" mariadb-binlog: help option
.\" help option: mariadb-binlog
\fB\-\-help\fR,
\fB\-?\fR
.sp
@ -139,8 +139,8 @@ Display a help message and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: base64-output option
.\" base64-output option: mysqlbinlog
.\" mariadb-binlog: base64-output option
.\" base64-output option: mariadb-binlog
\fB\-\-base64\-output=\fR\fB\fIvalue\fR\fR\fB\fR
.sp
This option determines when events should be displayed encoded as base\-64 strings using
@ -178,7 +178,7 @@ option is given\&.
Automatic
BINLOG
display is the only safe behavior if you intend to use the output of
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
to re\-execute binary log file contents\&. The other option values are intended only for debugging or testing purposes because they may produce output that does not include all events in executable form\&.
.sp .5v
.RE
@ -196,7 +196,7 @@ NEVER
causes
BINLOG
statements not to be displayed\&.
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
exits with an error if a row event is found that must be displayed using
BINLOG\&.
.RE
@ -211,7 +211,7 @@ BINLOG\&.
.\}
DECODE\-ROWS
specifies to
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
that you intend for row events to be decoded and displayed as commented SQL statements by also specifying the
\fB\-\-verbose\fR
option\&. Like
@ -239,7 +239,7 @@ For examples that show the effect of
and
\fB\-\-verbose\fR
on row event output, see
the section called \(lqMYSQLBINLOG ROW EVENT DISPLAY\(rq\&.
the section called \(lqMARIADB-BINLOG ROW EVENT DISPLAY\(rq\&.
.RE
.RE
.sp
@ -251,8 +251,8 @@ the section called \(lqMYSQLBINLOG ROW EVENT DISPLAY\(rq\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: binlog-row-event-max-size option
.\" binlog-row-event-max-size option: mysqlbinlog
.\" mariadb-binlog: binlog-row-event-max-size option
.\" binlog-row-event-max-size option: mariadb-binlog
\fB\-\-binlog\-row\-event\-max\-size\=\fR\fB\fIpath\fR\fR
.sp
The directory where character sets are installed\&.
@ -266,8 +266,8 @@ The directory where character sets are installed\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: character-sets-dir option
.\" character-sets-dir option: mysqlbinlog
.\" mariadb-binlog: character-sets-dir option
.\" character-sets-dir option: mariadb-binlog
\fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR
.sp
The directory where character sets are installed\&.
@ -281,13 +281,13 @@ The directory where character sets are installed\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: database option
.\" database option: mysqlbinlog
.\" mariadb-binlog: database option
.\" database option: mariadb-binlog
\fB\-\-database=\fR\fB\fIdb_name\fR\fR,
\fB\-d \fR\fB\fIdb_name\fR\fR
.sp
This option causes
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
to output entries from the binary log (local log only) that occur while
\fIdb_name\fR
has been selected as the default database by
@ -296,11 +296,11 @@ USE\&.
The
\fB\-\-database\fR
option for
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
is similar to the
\fB\-\-binlog\-do\-db\fR
option for
\fBmysqld\fR, but can be used to specify only one database\&. If
\fBmariadbd\fR, but can be used to specify only one database\&. If
\fB\-\-database\fR
is given multiple times, only the last instance is used\&.
.sp
@ -378,7 +378,7 @@ INSERT INTO t2 (j) VALUES(203);
.RE
.\}
.sp
\fBmysqlbinlog \-\-database=test\fR
\fBmariadb-binlog \-\-database=test\fR
does not output the first two
INSERT
statements because there is no default database\&. It outputs the three
@ -389,7 +389,7 @@ INSERT
statements following
USE db2\&.
.sp
\fBmysqlbinlog \-\-database=db2\fR
\fBmariadb-binlog \-\-database=db2\fR
does not output the first two
INSERT
statements because there is no default database\&. It does not output the three
@ -401,10 +401,10 @@ statements following
USE db2\&.
.PP
\fBRow-based logging\fR.
\fBmysqlbinlog\fR
\fBmariadb-binlog\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
\fBmariadb-binlog \-\-database=test\fR
outputs only those entries that modify
t1
in the test database, regardless of whether
@ -415,7 +415,7 @@ binlog_format
set to
MIXED
and you want it to be possible to use
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
with the
\fB\-\-database\fR
option, you must ensure that tables that are modified are in the database selected by
@ -433,7 +433,7 @@ USE\&. (In particular, no cross\-database updates should be used\&.)
.ps -1
.br
This option did not work correctly for
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
with row\-based logging prior to MySQL 5\&.1\&.37\&.
.sp .5v
.RE
@ -448,14 +448,14 @@ with row\-based logging prior to MySQL 5\&.1\&.37\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: debug option
.\" debug option: mysqlbinlog
.\" mariadb-binlog: debug option
.\" debug option: mariadb-binlog
\fB\-\-debug[=\fR\fB\fIdebug_options\fR\fR\fB]\fR,
\fB\-# [\fR\fB\fIdebug_options\fR\fR\fB]\fR
.sp
Write a debugging log\&. A typical
\fIdebug_options\fR
string is 'd:t:o,\fIfile_name\fR'. The default is 'd:t:o,/tmp/mysqlbinlog.trace'.
string is 'd:t:o,\fIfile_name\fR'. The default is 'd:t:o,/tmp/mariadb-binlog.trace'.
.RE
.sp
.RS 4
@ -466,8 +466,8 @@ string is 'd:t:o,\fIfile_name\fR'. The default is 'd:t:o,/tmp/mysqlbinlog.trace'
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: debug-check option
.\" debug-check option: mysqlbinlog
.\" mariadb-binlog: debug-check option
.\" debug-check option: mariadb-binlog
\fB\-\-debug\-check\fR
.sp
Print some debugging information when the program exits\&.
@ -481,8 +481,8 @@ Print some debugging information when the program exits\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: debug-info option
.\" debug-info option: mysqlbinlog
.\" mariadb-binlog: debug-info option
.\" debug-info option: mariadb-binlog
\fB\-\-debug\-info\fR
.sp
Print debugging information and memory and CPU usage statistics when the program exits\&.
@ -496,8 +496,8 @@ Print debugging information and memory and CPU usage statistics when the program
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: defaults-extra-file option
.\" defaults-extra-file option: mysqlbinlog
.\" mariadb-binlog: defaults-extra-file option
.\" defaults-extra-file option: mariadb-binlog
\fB\-\-defaults\-extra\-file=\fR\fB\fIname\fR
.sp
Read this file after the global files are read\&.
@ -511,8 +511,8 @@ Read this file after the global files are read\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: defaults-file option
.\" defaults-file option: mysqlbinlog
.\" mariadb-binlog: defaults-file option
.\" defaults-file option: mariadb-binlog
\fB\-\-defaults\-file=\fR\fB\fIname\fR
.sp
Only read default options from the given file\&.
@ -526,8 +526,8 @@ Only read default options from the given file\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: default-auth option
.\" default-auth option: mysqlbinlog
.\" mariadb-binlog: default-auth option
.\" default-auth option: mariadb-binlog
\fB\-\-default\-auth=\fR\fB\fIname\fR
.sp
Default authentication client-side plugin to use\&.
@ -541,8 +541,8 @@ Default authentication client-side plugin to use\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: disable-log-bin option
.\" disable-log-bin option: mysqlbinlog
.\" mariadb-binlog: disable-log-bin option
.\" disable-log-bin option: mariadb-binlog
\fB\-\-disable\-log\-bin\fR,
\fB\-D\fR
.sp
@ -553,7 +553,7 @@ option and are sending the output to the same MariaDB server\&. This option also
This option requires that you have the
SUPER
privilege\&. It causes
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
to include a
SET sql_log_bin = 0
statement in its output to disable binary logging of the remaining output\&. The
@ -571,8 +571,8 @@ privilege\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: flashback option
.\" flashback option: mysqlbinlog
.\" mariadb-binlog: flashback option
.\" flashback option: mariadb-binlog
\fB\-\-flashback\fR,
\fB\-B\fR
.sp
@ -587,8 +587,8 @@ Support flashback mode\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: force-if-open option
.\" force-if-open option: mysqlbinlog
.\" mariadb-binlog: force-if-open option
.\" force-if-open option: mariadb-binlog
\fB\-\-force\-if\-open\fR
.sp
Force if binlog was not closed properly. Defaults to on; use \fB--skip-force-if-open\fR to disable\&.
@ -602,15 +602,15 @@ Force if binlog was not closed properly. Defaults to on; use \fB--skip-force-if-
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: force-read option
.\" force-read option: mysqlbinlog
.\" mariadb-binlog: force-read option
.\" force-read option: mariadb-binlog
\fB\-\-force\-read\fR,
\fB\-f\fR
.sp
With this option, if
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
reads a binary log event that it does not recognize, it prints a warning, ignores the event, and continues\&. Without this option,
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
stops if it reads such an event\&.
.RE
.sp
@ -622,13 +622,13 @@ stops if it reads such an event\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: hexdump option
.\" hexdump option: mysqlbinlog
.\" mariadb-binlog: hexdump option
.\" hexdump option: mariadb-binlog
\fB\-\-hexdump\fR,
\fB\-H\fR
.sp
Display a hex dump of the log in comments, as described in
the section called \(lqMYSQLBINLOG HEX DUMP FORMAT\(rq\&. The hex output can be helpful for replication debugging\&.
the section called \(lqMARIADB-BINLOG HEX DUMP FORMAT\(rq\&. The hex output can be helpful for replication debugging\&.
.RE
.sp
.RS 4
@ -639,8 +639,8 @@ the section called \(lqMYSQLBINLOG HEX DUMP FORMAT\(rq\&. The hex output can be
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: host option
.\" host option: mysqlbinlog
.\" mariadb-binlog: host option
.\" host option: mariadb-binlog
\fB\-\-host=\fR\fB\fIhost_name\fR\fR,
\fB\-h \fR\fB\fIhost_name\fR\fR
.sp
@ -655,8 +655,8 @@ Get the binary log from the MariaDB server on the given host\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: local-load option
.\" local-load option: mysqlbinlog
.\" mariadb-binlog: local-load option
.\" local-load option: mariadb-binlog
\fB\-\-local\-load=\fR\fB\fIpath\fR\fR,
\fB\-l \fR\fB\fIpath\fR\fR
.sp
@ -673,8 +673,8 @@ in the specified directory\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: no-defaults option
.\" no-defaults option: mysqlbinlog
.\" mariadb-binlog: no-defaults option
.\" no-defaults option: mariadb-binlog
\fB\-\-no\-defaults\fR
.sp
Don't read default options from any option file\&.
@ -688,8 +688,8 @@ Don't read default options from any option file\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: offset option
.\" offset option: mysqlbinlog
.\" mariadb-binlog: offset option
.\" offset option: mariadb-binlog
\fB\-\-offset=\fR\fB\fIN\fR\fR,
\fB\-o \fR\fB\fIN\fR\fR
.sp
@ -706,12 +706,12 @@ entries in the log\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: open-files-limit option
.\" open-files-limit option: mysqlbinlog
.\" mariadb-binlog: open-files-limit option
.\" open-files-limit option: mariadb-binlog
\fB\-\-open\-files\-limit=\fR\fB\fINUM\fR\fR
.sp
Sets the open_files_limit variable, which is used to reserve file descriptors for
\fBmysqlbinlog\fR\&.
\fBmariadb-binlog\fR\&.
.RE
.sp
.RS 4
@ -722,8 +722,8 @@ Sets the open_files_limit variable, which is used to reserve file descriptors fo
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: password option
.\" password option: mysqlbinlog
.\" mariadb-binlog: password option
.\" password option: mariadb-binlog
\fB\-\-password[=\fR\fB\fIpassword\fR\fR\fB]\fR,
\fB\-p[\fR\fB\fIpassword\fR\fR\fB]\fR
.sp
@ -736,7 +736,7 @@ value following the
or
\fB\-p\fR
option on the command line,
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
prompts for one\&.
.sp
Specifying a password on the command line should be considered insecure\&. You
@ -751,8 +751,8 @@ can use an option file to avoid giving the password on the command line\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: plugin-dir option
.\" plugin-dir option: mysqlbinlog
.\" mariadb-binlog: plugin-dir option
.\" plugin-dir option: mariadb-binlog
\fB\-\-plugin\-dir=\fIdir_name\fR
.sp
Directory for client-side plugins\&.
@ -766,8 +766,8 @@ Directory for client-side plugins\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: print-defaults option
.\" print-defaults option: mysqlbinlog
.\" mariadb-binlog: print-defaults option
.\" print-defaults option: mariadb-binlog
\fB\-\-print\-defaults\fR
.sp
Print the program argument list from all option files and exit\&.
@ -781,8 +781,8 @@ Print the program argument list from all option files and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: port option
.\" port option: mysqlbinlog
.\" mariadb-binlog: port option
.\" port option: mariadb-binlog
\fB\-\-port=\fR\fB\fIport_num\fR\fR,
\fB\-P \fR\fB\fIport_num\fR\fR
.sp
@ -800,8 +800,8 @@ Forces --protocol=tcp when specified on the command line without other connectio
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: protocol option
.\" protocol option: mysqlbinlog
.\" mariadb-binlog: protocol option
.\" protocol option: mariadb-binlog
\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\&.
@ -815,8 +815,8 @@ The connection protocol to use for connecting to the server\&. It is useful when
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: raw option
.\" raw option: mysqlbinlog
.\" mariadb-binlog: raw option
.\" raw option: mariadb-binlog
\fB\-\-raw\fR
.sp
Requires \fB-R\fR\&. Output raw binlog data instead of SQL statements\&. Output files named after server logs\&.
@ -830,8 +830,8 @@ Requires \fB-R\fR\&. Output raw binlog data instead of SQL statements\&. Output
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: read-from-remote-server option
.\" read-from-remote-server option: mysqlbinlog
.\" mariadb-binlog: read-from-remote-server option
.\" read-from-remote-server option: mariadb-binlog
\fB\-\-read\-from\-remote\-server\fR,
\fB\-R\fR
.sp
@ -854,8 +854,8 @@ This option requires that the remote server be running\&. It works only for bina
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: result-file option
.\" result-file option: mysqlbinlog
.\" mariadb-binlog: result-file option
.\" result-file option: mariadb-binlog
\fB\-\-result\-file=\fR\fB\fIname\fR\fR,
\fB\-r \fR\fB\fIname\fR\fR
.sp
@ -870,8 +870,8 @@ Direct output to the given file\&. With --raw this is a prefix for the file name
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: rewrite-db option
.\" rewrite-db option: mysqlbinlog
.\" mariadb-binlog: rewrite-db option
.\" rewrite-db option: mariadb-binlog
\fB\-\-rewrite\-db=\fR\fB\fIname\fR\fR,
\fB\-r \fR\fB\fIname\fR\fR
.sp
@ -896,8 +896,8 @@ quote the value (e.g. \fB--rewrite-db="oldname->newname"\fR\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: server-id option
.\" server-id option: mysqlbinlog
.\" mariadb-binlog: server-id option
.\" server-id option: mariadb-binlog
\fB\-\-server\-id=\fR\fB\fIid\fR\fR
.sp
Display only those events created by the server having the given server ID\&.
@ -911,8 +911,8 @@ Display only those events created by the server having the given server ID\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: set-charset option
.\" set-charset option: mysqlbinlog
.\" mariadb-binlog: set-charset option
.\" set-charset option: mariadb-binlog
\fB\-\-set\-charset=\fR\fB\fIcharset_name\fR\fR
.sp
Add a
@ -928,8 +928,8 @@ statement to the output to specify the character set to be used for processing l
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: short-form option
.\" short-form option: mysqlbinlog
.\" mariadb-binlog: short-form option
.\" short-form option: mariadb-binlog
\fB\-\-short\-form\fR,
\fB\-s\fR
.sp
@ -947,8 +947,8 @@ base64-output, consider using \fB--base64-output=never\fR instead\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: socket option
.\" socket option: mysqlbinlog
.\" mariadb-binlog: socket option
.\" socket option: mariadb-binlog
\fB\-\-socket=\fR\fB\fIpath\fR\fR,
\fB\-S \fR\fB\fIpath\fR\fR
.sp
@ -965,8 +965,8 @@ Forces --protocol=socket when specified on the command line without other connec
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: start-datetime option
.\" start-datetime option: mysqlbinlog
.\" mariadb-binlog: start-datetime option
.\" start-datetime option: mariadb-binlog
\fB\-\-start\-datetime=\fR\fB\fIdatetime\fR\fR
.sp
Start reading the binary log at the first event having a timestamp equal to or later than the
@ -974,7 +974,7 @@ Start reading the binary log at the first event having a timestamp equal to or l
argument\&. The
\fIdatetime\fR
value is relative to the local time zone on the machine where you run
\fBmysqlbinlog\fR\&. The value should be in a format accepted for the
\fBmariadb-binlog\fR\&. The value should be in a format accepted for the
DATETIME
or
TIMESTAMP
@ -984,7 +984,7 @@ data types\&. For example:
.RS 4
.\}
.nf
shell> \fBmysqlbinlog \-\-start\-datetime="2014\-12\-25 11:25:56" binlog\&.000003\fR
shell> \fBmariadb-binlog \-\-start\-datetime="2014\-12\-25 11:25:56" binlog\&.000003\fR
.fi
.if n \{\
.RE
@ -1001,8 +1001,8 @@ This option is useful for point\-in\-time recovery\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: start-position option
.\" start-position option: mysqlbinlog
.\" mariadb-binlog: start-position option
.\" start-position option: mariadb-binlog
\fB\-\-start\-position=\fR\fB\fIN\fR\fR,
\fB\-j \fR\fB\fIN\fR\fR
.sp
@ -1027,8 +1027,8 @@ This option is useful for point\-in\-time recovery\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: gtid-strict-mode
.\" gtid-strict-mode option: mysqlbinlog
.\" mariadb-binlog: gtid-strict-mode
.\" gtid-strict-mode option: mariadb-binlog
\fB\-\-gtid\-strict\-mode
.sp
Process binlog according to gtid-strict-mode specification\&. The start, stop
@ -1044,8 +1044,8 @@ numbers of any gtid domain must comprise monotically growing sequence\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: stop-datetime option
.\" stop-datetime option: mysqlbinlog
.\" mariadb-binlog: stop-datetime option
.\" stop-datetime option: mariadb-binlog
\fB\-\-stop\-datetime=\fR\fB\fIdatetime\fR\fR
.sp
Stop reading the binary log at the first event having a timestamp equal to or later than the
@ -1067,8 +1067,8 @@ This option is useful for point\-in\-time recovery\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: stop-never option
.\" stop-never option: mysqlbinlog
.\" mariadb-binlog: stop-never option
.\" stop-never option: mariadb-binlog
\fB\-\-stop\-never\fR
.sp
Wait for more data from the server instead of stopping at the end of the last log\&. Implies \fB--to-last-log\fR\&.
@ -1082,8 +1082,8 @@ Wait for more data from the server instead of stopping at the end of the last lo
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: stop-never-slave-server-id option
.\" stop-never-slave-server-id option: mysqlbinlog
.\" mariadb-binlog: stop-never-slave-server-id option
.\" stop-never-slave-server-id option: mariadb-binlog
\fB\-\-stop\-never-slave-server-id\fR
.sp
The slave server_id used for \fB--read-from-remote-server --stop-never\fR\&.
@ -1097,8 +1097,8 @@ The slave server_id used for \fB--read-from-remote-server --stop-never\fR\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: stop-position option
.\" stop-position option: mysqlbinlog
.\" mariadb-binlog: stop-position option
.\" stop-position option: mariadb-binlog
\fB\-\-stop\-position=\fR\fB\fIN\fR\fR
.sp
Stop reading the binary log at the first event having a position equal to or
@ -1120,8 +1120,8 @@ This option is useful for point\-in\-time recovery\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: table option
.\" table option: mysqlbinlog
.\" mariadb-binlog: table option
.\" table option: mariadb-binlog
\fB\-\-table\fR,
\fB\-T\fR
.sp
@ -1137,8 +1137,8 @@ List entries for just this table (local log only)\&.
.IP \(bu 2.3
.\}
.\" mysqlbinlog: to-last-log option
.\" to-last-log option: mysqlbinlog
.\" mariadb-binlog: to-last-log option
.\" to-last-log option: mariadb-binlog
\fB\-\-to\-last\-log\fR,
\fB\-t\fR
.sp
@ -1154,8 +1154,8 @@ Do not stop at the end of the requested binary log from a MariaDB server, but ra
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: user option
.\" user option: mysqlbinlog
.\" mariadb-binlog: user option
.\" user option: mariadb-binlog
\fB\-\-user=\fR\fB\fIuser_name\fR\fR,
\fB\-u \fR\fB\fIuser_name\fR\fR
.sp
@ -1170,8 +1170,8 @@ The MariaDB username to use when connecting to a remote server\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: verbose option
.\" verbose option: mysqlbinlog
.\" mariadb-binlog: verbose option
.\" verbose option: mariadb-binlog
\fB\-\-verbose\fR,
\fB\-v\fR
.sp
@ -1183,7 +1183,7 @@ For examples that show the effect of
and
\fB\-\-verbose\fR
on row event output, see
the section called \(lqMYSQLBINLOG ROW EVENT DISPLAY\(rq\&.
the section called \(lqMARIADB-BINLOG ROW EVENT DISPLAY\(rq\&.
.RE
.sp
.RS 4
@ -1194,8 +1194,8 @@ the section called \(lqMYSQLBINLOG ROW EVENT DISPLAY\(rq\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlbinlog: version option
.\" version option: mysqlbinlog
.\" mariadb-binlog: version option
.\" version option: mariadb-binlog
\fB\-\-version\fR,
\fB\-V\fR
.sp
@ -1221,9 +1221,9 @@ Specify the number of open file descriptors to reserve\&.
.RE
.PP
You can pipe the output of
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
into the
\fBmysql\fR
\fBmariadb\fR
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\&. For example:
.sp
@ -1231,7 +1231,7 @@ backup\&. For example:
.RS 4
.\}
.nf
shell> \fBmysqlbinlog binlog\&.000001 | mysql \-u root \-p\fR
shell> \fBmariadb-binlog binlog\&.000001 | mariadb \-u root \-p\fR
.fi
.if n \{\
.RE
@ -1243,32 +1243,32 @@ Or:
.RS 4
.\}
.nf
shell> \fBmysqlbinlog binlog\&.[0\-9]* | mysql \-u root \-p\fR
shell> \fBmariadb-binlog binlog\&.[0\-9]* | mariadb \-u root \-p\fR
.fi
.if n \{\
.RE
.\}
.PP
You can also redirect the output of
\fBmysqlbinlog\fR
\fBmariadb-binlog\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
\fBmysql\fR
\fBmariadb\fR
program:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysqlbinlog binlog\&.000001 > tmpfile\fR
shell> \fBmariadb-binlog binlog\&.000001 > tmpfile\fR
shell> \&.\&.\&. \fIedit tmpfile\fR \&.\&.\&.
shell> \fBmysql \-u root \-p < tmpfile\fR
shell> \fBmariadb \-u root \-p < tmpfile\fR
.fi
.if n \{\
.RE
.\}
.PP
When
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
is invoked with the
\fB\-\-start\-position\fR
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
@ -1283,8 +1283,8 @@ If you have more than one binary log to execute on the MariaDB server, the safe
.RS 4
.\}
.nf
shell> \fBmysqlbinlog binlog\&.000001 | mysql \-u root \-p # DANGER!!\fR
shell> \fBmysqlbinlog binlog\&.000002 | mysql \-u root \-p # DANGER!!\fR
shell> \fBmariadb-binlog binlog\&.000001 | mariadb \-u root \-p # DANGER!!\fR
shell> \fBmariadb-binlog binlog\&.000002 | mariadb \-u root \-p # DANGER!!\fR
.fi
.if n \{\
.RE
@ -1293,22 +1293,22 @@ shell> \fBmysqlbinlog binlog\&.000002 | mysql \-u root \-p # DANGER!!\fR
Processing binary logs this way using different connections to the server causes problems if the first log file contains a
CREATE TEMPORARY TABLE
statement and the second log contains a statement that uses the temporary table\&. When the first
\fBmysql\fR
\fBmariadb\fR
process terminates, the server drops the temporary table\&. When the second
\fBmysql\fR
\fBmariadb\fR
process attempts to use the table, the server reports
\(lqunknown table\&.\(rq
.PP
To avoid problems like this, use a
\fIsingle\fR
\fBmysql\fR
\fBmariadb\fR
process to execute the contents of all binary logs that you want to process\&. Here is one way to do so:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysqlbinlog binlog\&.000001 binlog\&.000002 | mysql \-u root \-p\fR
shell> \fBmariadb-binlog binlog\&.000001 binlog\&.000002 | mariadb \-u root \-p\fR
.fi
.if n \{\
.RE
@ -1320,19 +1320,19 @@ Another approach is to write all the logs to a single file and then process the
.RS 4
.\}
.nf
shell> \fBmysqlbinlog binlog\&.000001 > /tmp/statements\&.sql\fR
shell> \fBmysqlbinlog binlog\&.000002 >> /tmp/statements\&.sql\fR
shell> \fBmysql \-u root \-p \-e "source /tmp/statements\&.sql"\fR
shell> \fBmariadb-binlog binlog\&.000001 > /tmp/statements\&.sql\fR
shell> \fBmariadb-binlog binlog\&.000002 >> /tmp/statements\&.sql\fR
shell> \fBmariadb \-u root \-p \-e "source /tmp/statements\&.sql"\fR
.fi
.if n \{\
.RE
.\}
.PP
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
can produce output that reproduces a
LOAD DATA INFILE
operation without the original data file\&.
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
copies the data to a temporary file and writes a
LOAD DATA LOCAL INFILE
statement that refers to the file\&. The default location of the directory where these files are written is system\-specific\&. To specify a directory explicitly, use the
@ -1340,7 +1340,7 @@ statement that refers to the file\&. The default location of the directory where
option\&.
.PP
Because
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
converts
LOAD DATA INFILE
statements to
@ -1370,19 +1370,19 @@ automatically deleted because they are needed until you actually execute those s
\fIoriginal_file_name\-#\-#\fR\&.
.sp .5v
.RE
.SH "MYSQLBINLOG HEX DUMP FORMAT"
.SH "MARIADB-BINLOG HEX DUMP FORMAT"
.PP
The
\fB\-\-hexdump\fR
option causes
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
to produce a hex dump of the binary log contents:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysqlbinlog \-\-hexdump master\-bin\&.000001\fR
shell> \fBmariadb-binlog \-\-hexdump master\-bin\&.000001\fR
.fi
.if n \{\
.RE
@ -1772,11 +1772,11 @@ T}
.TE
.sp 1
.RE
.SH "MYSQLBINLOG ROW EVENT DISPLAY"
.\" BINLOG statement: mysqlbinlog output
.SH "MARIADB-BINLOG ROW EVENT DISPLAY"
.\" BINLOG statement: mariadb-binlog output
.PP
The following examples illustrate how
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
displays row events that specify data modifications\&. These correspond to events with the
WRITE_ROWS_EVENT,
UPDATE_ROWS_EVENT, and
@ -1810,7 +1810,7 @@ COMMIT;
.\}
.PP
By default,
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
displays row events encoded as base\-64 strings using
BINLOG
statements\&. Omitting extraneous lines, the output for the row events produced by the preceding statement sequence looks like this:
@ -1819,7 +1819,7 @@ statements\&. Omitting extraneous lines, the output for the row events produced
.RS 4
.\}
.nf
shell> \fBmysqlbinlog \fR\fB\fIlog_file\fR\fR
shell> \fBmariadb-binlog \fR\fB\fIlog_file\fR\fR
\&.\&.\&.
# at 218
#080828 15:03:08 server id 1 end_log_pos 258 Write_rows: table id 17 flags: STMT_END_F
@ -1843,7 +1843,7 @@ fAS3SBkBAAAAKgAAALoBAAAQABEAAAAAAAEAA//4AQAAAARwZWFyIbIP'/*!*/;
To see the row events as comments in the form of
\(lqpseudo\-SQL\(rq
statements, run
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
with the
\fB\-\-verbose\fR
or
@ -1855,7 +1855,7 @@ option\&. The output will contain lines beginning with
.RS 4
.\}
.nf
shell> \fBmysqlbinlog \-v \fR\fB\fIlog_file\fR\fR
shell> \fBmariadb-binlog \-v \fR\fB\fIlog_file\fR\fR
\&.\&.\&.
# at 218
#080828 15:03:08 server id 1 end_log_pos 258 Write_rows: table id 17 flags: STMT_END_F
@ -1905,7 +1905,7 @@ twice to also display data types and some metadata for each column\&. The output
.RS 4
.\}
.nf
shell> \fBmysqlbinlog \-vv \fR\fB\fIlog_file\fR\fR
shell> \fBmariadb-binlog \-vv \fR\fB\fIlog_file\fR\fR
\&.\&.\&.
# at 218
#080828 15:03:08 server id 1 end_log_pos 258 Write_rows: table id 17 flags: STMT_END_F
@ -1946,7 +1946,7 @@ fAS3SBkBAAAAKgAAALoBAAAQABEAAAAAAAEAA//4AQAAAARwZWFyIbIP'/*!*/;
.\}
.PP
You can tell
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
to suppress the
BINLOG
statements for row events by using the
@ -1963,7 +1963,7 @@ provides a convenient way to see row events only as SQL statements:
.RS 4
.\}
.nf
shell> \fBmysqlbinlog \-v \-\-base64\-output=DECODE\-ROWS \fR\fB\fIlog_file\fR\fR
shell> \fBmariadb-binlog \-v \-\-base64\-output=DECODE\-ROWS \fR\fB\fIlog_file\fR\fR
\&.\&.\&.
# at 218
#080828 15:03:08 server id 1 end_log_pos 258 Write_rows: table id 17 flags: STMT_END_F
@ -2013,7 +2013,7 @@ shell> \fBmysqlbinlog \-v \-\-base64\-output=DECODE\-ROWS \fR\fB\fIlog_file\fR\f
You should not suppress
BINLOG
statements if you intend to re\-execute
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
output\&.
.sp .5v
.RE
@ -2115,7 +2115,7 @@ clause\&.
.RE
.PP
Proper interpretation of row events requires the information from the format description event at the beginning of the binary log\&. Because
\fBmysqlbinlog\fR
\fBmariadb-binlog\fR
does not know in advance whether the rest of the log contains row events, by default it displays the format description event using a
BINLOG
statement in the initial part of the output\&.
@ -2128,7 +2128,7 @@ option can be used to prevent this header from being written\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2021 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

302
man/mariadb-check.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADB-CHECK\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-CHECK\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,20 +11,20 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysqlcheck
.\" mariadb-check
.\" maintenance: tables
.\" repair: tables
.\" tables: maintenance
.\" tables: repair
.SH "NAME"
mariadb-check \- a table maintenance program (mysqlcheck is now a symlink to mariadb-check)
mariadb-check \- a table maintenance program (mariadb-check is now a symlink to mariadb-check)
.SH "SYNOPSIS"
.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
\fBmysqlcheck [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIdb_name\fR\fR\fB [\fR\fB\fItbl_name\fR\fR\fB \&.\&.\&.]]\fR
.HP \w'\fBmariadb-check\ [\fR\fB\fIoptions\fR\fR\fB]\ [\fR\fB\fIdb_name\fR\fR\fB\ [\fR\fB\fItbl_name\fR\fR\fB\ \&.\&.\&.]]\fR\ 'u
\fBmariadb-check [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIdb_name\fR\fR\fB [\fR\fB\fItbl_name\fR\fR\fB \&.\&.\&.]]\fR
.SH "DESCRIPTION"
.PP
The
\fBmysqlcheck\fR
\fBmariadb-check\fR
client performs table maintenance: It checks, repairs, optimizes, or analyzes tables\&.
.PP
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
@ -34,26 +34,26 @@ lock only\&. Table maintenance operations can be time\-consuming, particularly f
or
\fB\-\-all\-databases\fR
option to process all tables in one or more databases, an invocation of
\fBmysqlcheck\fR
\fBmariadb-check\fR
might take a long time\&. (This is also true for
\fBmysql_upgrade\fR
\fBmariadb-upgrade\fR
because that program invokes
\fBmysqlcheck\fR
\fBmariadb-check\fR
to check all tables and repair them if necessary\&.)
.PP
\fBmysqlcheck\fR
\fBmariadb-check\fR
is similar in function to
\fBmyisamchk\fR, but works differently\&. The main operational difference is that
\fBmysqlcheck\fR
\fBmariadb-check\fR
must be used when the
\fBmysqld\fR
\fBmariadbd\fR
server is running, whereas
\fBmyisamchk\fR
should be used when it is not\&. The benefit of using
\fBmysqlcheck\fR
\fBmariadb-check\fR
is that you do not have to stop the server to perform table maintenance\&.
.PP
\fBmysqlcheck\fR
\fBmariadb-check\fR
uses the SQL statements
CHECK TABLE,
REPAIR TABLE,
@ -64,7 +64,7 @@ in a convenient way for the user\&. It determines which statements to use for th
The
MyISAM
storage engine supports all four maintenance operations, so
\fBmysqlcheck\fR
\fBmariadb-check\fR
can be used to perform any of them on
MyISAM
tables\&. Other storage engines do not necessarily support all operations\&. In such cases, an error message is displayed\&. For example, if
@ -77,7 +77,7 @@ table, an attempt to check it produces this result:
.RS 4
.\}
.nf
shell> \fBmysqlcheck test t\fR
shell> \fBmariadb-check test t\fR
test\&.t
note : The storage engine for the table doesn't support check
.fi
@ -86,7 +86,7 @@ note : The storage engine for the table doesn't support check
.\}
.PP
If
\fBmysqlcheck\fR
\fBmariadb-check\fR
is unable to repair a table, see the MariaDB Knowledge Base
for manual table repair strategies\&. This will be the case, for example, for
InnoDB
@ -95,7 +95,7 @@ CHECK TABLE, but not repaired with
REPAIR TABLE\&.
.PP
The use of
\fBmysqlcheck\fR
\fBmariadb-check\fR
with partitioned tables is not supported\&.
.if n \{\
.sp
@ -115,15 +115,15 @@ It is best to make a backup of a table before performing a table repair operatio
.RE
.PP
There are three general ways to invoke
\fBmysqlcheck\fR:
\fBmariadb-check\fR:
.sp
.if n \{\
.RS 4
.\}
.nf
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_name\fR\fR\fB \&.\&.\&.\fR
shell> \fBmysqlcheck [\fR\fB\fIoptions\fR\fR\fB] \-\-all\-databases\fR
shell> \fBmariadb-check [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIdb_name\fR\fR\fB [\fR\fB\fItbl_name\fR\fR\fB \&.\&.\&.]\fR
shell> \fBmariadb-check [\fR\fB\fIoptions\fR\fR\fB] \-\-databases \fR\fB\fIdb_name\fR\fR\fB \&.\&.\&.\fR
shell> \fBmariadb-check [\fR\fB\fIoptions\fR\fR\fB] \-\-all\-databases\fR
.fi
.if n \{\
.RE
@ -137,18 +137,18 @@ or
\fB\-\-all\-databases\fR
option, entire databases are checked\&.
.PP
\fBmysqlcheck\fR
\fBmariadb-check\fR
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
\fBmysqlcheck\fR
\fBmariadb-check\fR
named
\fBmysqlrepair\fR, or make a symbolic link to
\fBmysqlcheck\fR
\fBmariadb-repair\fR, or make a symbolic link to
\fBmariadb-check\fR
named
\fBmysqlrepair\fR\&. If you invoke
\fBmysqlrepair\fR, it repairs tables\&.
\fBmariadb-repair\fR\&. If you invoke
\fBmariadb-repair\fR, it repairs tables\&.
.PP
The following names can be used to change
\fBmysqlcheck\fR
\fBmariadb-check\fR
default behavior\&.
.TS
allbox tab(:);
@ -156,7 +156,7 @@ l l
l l
l l.
T{
\fBmysqlrepair\fR
\fBmariadb-repair\fR
T}:T{
The default option is \fB\-\-repair\fR
T}
@ -173,9 +173,9 @@ T}
.TE
.sp 1
.PP
\fBmysqlcheck\fR
\fBmariadb-check\fR
supports the following options, which can be specified on the command line or in the
[mysqlcheck]
[mariadb-check]
and
[client]
option file groups\&.
@ -189,8 +189,8 @@ The \fB-c\fR, \fB-r\fR, \fB-a\fR and \fB-o\fR options are exclusive to each othe
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: help option
.\" help option: mysqlcheck
.\" mariadb-check: help option
.\" help option: mariadb-check
\fB\-\-help\fR,
\fB\-?\fR
.sp
@ -205,8 +205,8 @@ Display a help message and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: all-databases option
.\" all-databases option: mysqlcheck
.\" mariadb-check: all-databases option
.\" all-databases option: mariadb-check
\fB\-\-all\-databases\fR,
\fB\-A\fR
.sp
@ -223,8 +223,8 @@ option and naming all the databases on the command line\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: all-in-1 option
.\" all-in-1 option: mysqlcheck
.\" mariadb-check: all-in-1 option
.\" all-in-1 option: mariadb-check
\fB\-\-all\-in\-1\fR,
\fB\-1\fR
.sp
@ -239,8 +239,8 @@ Instead of issuing a statement for each table, execute a single statement for ea
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: analyze option
.\" analyze option: mysqlcheck
.\" mariadb-check: analyze option
.\" analyze option: mariadb-check
\fB\-\-analyze\fR,
\fB\-a\fR
.sp
@ -255,8 +255,8 @@ Analyze the tables\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: auto-repair option
.\" auto-repair option: mysqlcheck
.\" mariadb-check: auto-repair option
.\" auto-repair option: mariadb-check
\fB\-\-auto\-repair\fR
.sp
If a checked table is corrupted, automatically fix it\&. Any necessary repairs are done after all tables have been checked\&.
@ -270,8 +270,8 @@ If a checked table is corrupted, automatically fix it\&. Any necessary repairs a
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: character-sets-dir option
.\" character-sets-dir option: mysqlcheck
.\" mariadb-check: character-sets-dir option
.\" character-sets-dir option: mariadb-check
\fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR
.sp
The directory where character sets are installed\&.
@ -285,8 +285,8 @@ The directory where character sets are installed\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: check option
.\" check option: mysqlcheck
.\" mariadb-check: check option
.\" check option: mariadb-check
\fB\-\-check\fR,
\fB\-c\fR
.sp
@ -301,8 +301,8 @@ Check the tables for errors\&. This is the default operation\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: check-only-changed option
.\" check-only-changed option: mysqlcheck
.\" mariadb-check: check-only-changed option
.\" check-only-changed option: mariadb-check
\fB\-\-check\-only\-changed\fR,
\fB\-C\fR
.sp
@ -317,8 +317,8 @@ Check only tables that have changed since the last check or that have not been c
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: check-upgrade option
.\" check-upgrade option: mysqlcheck
.\" mariadb-check: check-upgrade option
.\" check-upgrade option: mariadb-check
\fB\-\-check\-upgrade\fR,
\fB\-g\fR
.sp
@ -341,8 +341,8 @@ options\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: compress option
.\" compress option: mysqlcheck
.\" mariadb-check: compress option
.\" compress option: mariadb-check
\fB\-\-compress\fR
.sp
Compress all information sent between the client and the server if both support compression\&.
@ -356,13 +356,13 @@ Compress all information sent between the client and the server if both support
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: databases option
.\" databases option: mysqlcheck
.\" mariadb-check: databases option
.\" databases option: mariadb-check
\fB\-\-databases\fR,
\fB\-B\fR
.sp
Process all tables in the named databases\&. Normally,
\fBmysqlcheck\fR
\fBmariadb-check\fR
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
@ -374,8 +374,8 @@ treats the first name argument on the command line as a database name and follow
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: debug option
.\" debug option: mysqlcheck
.\" mariadb-check: debug option
.\" debug option: mariadb-check
\fB\-\-debug[=\fR\fB\fIdebug_options\fR\fR\fB]\fR,
\fB\-# [\fR\fB\fIdebug_options\fR\fR\fB]\fR
.sp
@ -392,8 +392,8 @@ string is 'd:t:o,\fIfile_name\fR'. The default is 'd:t:o'.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: debug-check option
.\" debug-check option: mysqlcheck
.\" mariadb-check: debug-check option
.\" debug-check option: mariadb-check
\fB\-\-debug\-check\fR
.sp
Print some debugging information when the program exits\&.
@ -407,8 +407,8 @@ Print some debugging information when the program exits\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: debug-info option
.\" debug-info option: mysqlcheck
.\" mariadb-check: debug-info option
.\" debug-info option: mariadb-check
\fB\-\-debug\-info\fR
.sp
Print debugging information and memory and CPU usage statistics when the program exits\&.
@ -422,8 +422,8 @@ Print debugging information and memory and CPU usage statistics when the program
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: default-auth option
.\" default-auth option: mysqlcheck
.\" mariadb-check: default-auth option
.\" default-auth option: mariadb-check
\fB\-\-default\-auth=\fR\fB\fIname\fR\fR
.sp
Default authentication client-side plugin to use\&.
@ -437,8 +437,8 @@ Default authentication client-side plugin to use\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: default-character-set option
.\" default-character-set option: mysqlcheck
.\" mariadb-check: default-character-set option
.\" default-character-set option: mariadb-check
\fB\-\-default\-character\-set=\fR\fB\fIcharset_name\fR\fR
.sp
Use
@ -454,8 +454,8 @@ as the default character set\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: defaults-extra-file option
.\" defaults-extra-file option: mysqlcheck
.\" mariadb-check: defaults-extra-file option
.\" defaults-extra-file option: mariadb-check
\fB\-\-defaults\-extra\-file=\fR\fB\fIfilename\fR\fR
.sp
Set \fB\fIfilename\fR\fR as the file to read default options from after the global defaults files has been read\&.
@ -470,8 +470,8 @@ Must be given as first option\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: defaults-file option
.\" defaults-file option: mysqlcheck
.\" mariadb-check: defaults-file option
.\" defaults-file option: mariadb-check
\fB\-\-defaults\-file=\fR\fB\fIfilename\fR\fR
.sp
Set \fB\fIfilename\fR\fR as the file to read default options from, override global defaults files\&.
@ -486,8 +486,8 @@ Must be given as first option\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: extended option
.\" extended option: mysqlcheck
.\" mariadb-check: extended option
.\" extended option: mariadb-check
\fB\-\-extended\fR,
\fB\-e\fR
.sp
@ -505,8 +505,8 @@ instead of the much faster repair by sorting.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: fast option
.\" fast option: mysqlcheck
.\" mariadb-check: fast option
.\" fast option: mariadb-check
\fB\-\-fast\fR,
\fB\-F\fR
.sp
@ -521,8 +521,8 @@ Check only tables that have not been closed properly\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: fix-db-names option
.\" fix-db-names option: mysqlcheck
.\" mariadb-check: fix-db-names option
.\" fix-db-names option: mariadb-check
\fB\-\-fix\-db\-names\fR
.sp
Convert database names to the format used since MySQL 5\&.1\&. Only database names that contain special characters are affected\&.
@ -536,8 +536,8 @@ Convert database names to the format used since MySQL 5\&.1\&. Only database nam
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: fix-table-names option
.\" fix-table-names option: mysqlcheck
.\" mariadb-check: fix-table-names option
.\" fix-table-names option: mariadb-check
\fB\-\-fix\-table\-names\fR
.sp
Convert table names (including views) to the format used since MySQL 5\&.1\&. Only table names that contain special characters are affected\&.
@ -551,8 +551,8 @@ Convert table names (including views) to the format used since MySQL 5\&.1\&. On
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: flush option
.\" flush option: mysqlcheck
.\" mariadb-check: flush option
.\" flush option: mariadb-check
\fB\-\-flush\fR,
.sp
Flush each table after check. This is useful if you don't
@ -567,8 +567,8 @@ want to have the checked tables take up space in the caches after the check\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: force option
.\" force option: mysqlcheck
.\" mariadb-check: force option
.\" force option: mariadb-check
\fB\-\-force\fR,
\fB\-f\fR
.sp
@ -583,8 +583,8 @@ Continue even if an SQL error occurs\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: host option
.\" host option: mysqlcheck
.\" mariadb-check: host option
.\" host option: mariadb-check
\fB\-\-host=\fR\fB\fIhost_name\fR\fR,
\fB\-h \fR\fB\fIhost_name\fR\fR
.sp
@ -599,8 +599,8 @@ Connect to the MariaDB server on the given host\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: medium-check option
.\" medium-check option: mysqlcheck
.\" mariadb-check: medium-check option
.\" medium-check option: mariadb-check
\fB\-\-medium\-check\fR,
\fB\-m\fR
.sp
@ -617,8 +617,8 @@ operation\&. This finds only 99\&.99% of all errors, which should be good enough
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: no-defaults option
.\" no-defaults option: mysqlcheck
.\" mariadb-check: no-defaults option
.\" no-defaults option: mariadb-check
\fB\-\-no\-defaults\fR
.sp
Do not read default options from any option file\&. This must be given as the first argument\&.
@ -632,8 +632,8 @@ Do not read default options from any option file\&. This must be given as the fi
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: optimize option
.\" optimize option: mysqlcheck
.\" mariadb-check: optimize option
.\" optimize option: mariadb-check
\fB\-\-optimize\fR,
\fB\-o\fR
.sp
@ -648,8 +648,8 @@ Optimize the tables\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: password option
.\" password option: mysqlcheck
.\" mariadb-check: password option
.\" password option: mariadb-check
\fB\-\-password[=\fR\fB\fIpassword\fR\fR\fB]\fR,
\fB\-p[\fR\fB\fIpassword\fR\fR\fB]\fR
.sp
@ -662,7 +662,7 @@ value following the
or
\fB\-p\fR
option on the command line,
\fBmysqlcheck\fR
\fBmariadb-check\fR
prompts for one\&.
.sp
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\&.
@ -676,8 +676,8 @@ Specifying a password on the command line should be considered insecure\&. You c
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: persisent option
.\" persistent option: mysql
.\" mariadb-check: persisent option
.\" persistent option: mariadb-check
\fB\-\-persistent\fR,
\fB\-Z\fR
.sp
@ -692,8 +692,8 @@ Used with ANALYZE TABLE to append the option PERSISENT FOR ALL.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: pipe option
.\" pipe option: mysql
.\" mariadb-check: pipe option
.\" pipe option: mariadb-check
\fB\-\-pipe\fR,
\fB\-W\fR
.sp
@ -708,8 +708,8 @@ On Windows, connect to the server via a named pipe\&. This option applies only i
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: plugin-dir option
.\" plugin-dir option: mysqlcheck
.\" mariadb-check: plugin-dir option
.\" plugin-dir option: mariadb-check
\fB\-\-plugin\-dir=\fR\fB\fIname\fR\fR
.sp
Directory for client-side plugins\&.
@ -723,8 +723,8 @@ On Windows, connect to the server via a named pipe\&. This option applies only i
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: port option
.\" port option: mysqlcheck
.\" mariadb-check: port option
.\" port option: mariadb-check
\fB\-\-port=\fR\fB\fIport_num\fR\fR,
\fB\-P \fR\fB\fIport_num\fR\fR
.sp
@ -740,8 +740,8 @@ Forces --protocol=tcp when specified on the command line without other connectio
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: print-defaults option
.\" print-defaults option: mysqlcheck
.\" mariadb-check: print-defaults option
.\" print-defaults option: mariadb-check
\fB\-\-print\-defaults\fR
.sp
Print the program argument list and exit\&.
@ -756,8 +756,8 @@ This must be given as the first argument\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: process-tables option
.\" process-tables option: mysqlcheck
.\" mariadb-check: process-tables option
.\" process-tables option: mariadb-check
\fB\-\-process\-tables\fR
.sp
Perform the requested operation on tables. Defaults to on; use \fB--skip-process-tables\fR to disable\&.
@ -771,8 +771,8 @@ Perform the requested operation on tables. Defaults to on; use \fB--skip-process
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: process-views option
.\" process-views option: mysqlcheck
.\" mariadb-check: process-views option
.\" process-views option: mariadb-check
\fB\-\-process\-views=\fB\fIval\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\&.
@ -786,8 +786,8 @@ Perform the requested operation (only CHECK VIEW or REPAIR VIEW). Possible value
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: protocol option
.\" protocol option: mysqlcheck
.\" mariadb-check: protocol option
.\" protocol option: mariadb-check
\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\&.
@ -801,8 +801,8 @@ The connection protocol to use for connecting to the server\&. It is useful when
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: quick option
.\" quick option: mysqlcheck
.\" mariadb-check: quick option
.\" quick option: mariadb-check
\fB\-\-quick\fR,
\fB\-q\fR
.sp
@ -819,8 +819,8 @@ If you are using this option to repair tables, it tries to repair only the index
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: repair option
.\" repair option: mysqlcheck
.\" mariadb-check: repair option
.\" repair option: mariadb-check
\fB\-\-repair\fR,
\fB\-r\fR
.sp
@ -835,8 +835,8 @@ Perform a repair that can fix almost anything except unique keys that are not un
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: silent option
.\" silent option: mysqlcheck
.\" mariadb-check: silent option
.\" silent option: mariadb-check
\fB\-\-silent\fR,
\fB\-s\fR
.sp
@ -851,8 +851,8 @@ Silent mode\&. Print only error messages\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: skip-database option
.\" skip-database option: mysqlcheck
.\" mariadb-check: skip-database option
.\" skip-database option: mariadb-check
\fB\-\-skip\-database=\fB\fIdb_name\fR
.sp
Don't process the database (case-sensitive) specified as argument\&.
@ -866,8 +866,8 @@ Don't process the database (case-sensitive) specified as argument\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: socket option
.\" socket option: mysqlcheck
.\" mariadb-check: socket option
.\" socket option: mariadb-check
\fB\-\-socket=\fR\fB\fIpath\fR\fR,
\fB\-S \fR\fB\fIpath\fR\fR
.sp
@ -884,8 +884,8 @@ Forces --protocol=socket when specified on the command line without other connec
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL options
.\" SSL options: mysqladmin
.\" mariadb-check: SSL options
.\" SSL options: mariadb-check
\fB\-\-ssl\fR
.sp
Enable SSL for connection (automatically enabled with other flags). Disable with
@ -900,8 +900,8 @@ Enable SSL for connection (automatically enabled with other flags). Disable with
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL CA option
.\" SSL CA option: mysqladmin
.\" mariadb-check: SSL CA option
.\" SSL CA option: mariadb-check
\fB\-\-ssl\-ca=\fIname\fR
.sp
CA file in PEM format (check OpenSSL docs, implies
@ -916,8 +916,8 @@ CA file in PEM format (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL CA Path option
.\" SSL CA Path option: mysqladmin
.\" mariadb-check: SSL CA Path option
.\" SSL CA Path option: mariadb-check
\fB\-\-ssl\-capath=\fIname\fR
.sp
CA directory (check OpenSSL docs, implies
@ -932,8 +932,8 @@ CA directory (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL Cert option
.\" SSL Cert option: mysqladmin
.\" mariadb-check: SSL Cert option
.\" SSL Cert option: mariadb-check
\fB\-\-ssl\-cert=\fIname\fR
.sp
X509 cert in PEM format (check OpenSSL docs, implies
@ -948,8 +948,8 @@ X509 cert in PEM format (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL Cipher option
.\" SSL Cipher option: mysqladmin
.\" mariadb-check: SSL Cipher option
.\" SSL Cipher option: mariadb-check
\fB\-\-ssl\-cipher=\fIname\fR
.sp
SSL cipher to use (check OpenSSL docs, implies
@ -964,8 +964,8 @@ SSL cipher to use (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL Key option
.\" SSL Key option: mysqladmin
.\" mariadb-check: SSL Key option
.\" SSL Key option: mariadb-check
\fB\-\-ssl\-key=\fIname\fR
.sp
X509 key in PEM format (check OpenSSL docs, implies
@ -980,8 +980,8 @@ X509 key in PEM format (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL Crl option
.\" SSL CRL option: mysqladmin
.\" mariadb-check: SSL Crl option
.\" SSL CRL option: mariadb-check
\fB\-\-ssl\-crl=\fIname\fR
.sp
Certificate revocation list (check OpenSSL docs, implies
@ -996,8 +996,8 @@ Certificate revocation list (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL Crlpath option
.\" SSL Crlpath option: mysqladmin
.\" mariadb-check: SSL Crlpath option
.\" SSL Crlpath option: mariadb-check
\fB\-\-ssl\-crlpath=\fIname\fR
.sp
Certificate revocation list path (check OpenSSL docs, implies
@ -1012,8 +1012,8 @@ Certificate revocation list path (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL Verify Server Cert option
.\" SSL Verify Server Cert option: mysqladmin
.\" mariadb-check: SSL Verify Server Cert option
.\" SSL Verify Server Cert option: mariadb-check
\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\&.
@ -1027,8 +1027,8 @@ Verify server's "Common Name" in its cert against hostname used when connecting.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: tables option
.\" tables option: mysqlcheck
.\" mariadb-check: tables option
.\" tables option: mariadb-check
\fB\-\-tables\fR
.sp
Override the
@ -1046,8 +1046,8 @@ option\&. All name arguments following the option are regarded as table names\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: use-frm option
.\" use-frm option: mysqlcheck
.\" mariadb-check: use-frm option
.\" use-frm option: mariadb-check
\fB\-\-use\-frm\fR
.sp
For repair operations on
@ -1067,8 +1067,8 @@ header is corrupted\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: user option
.\" user option: mysqlcheck
.\" mariadb-check: user option
.\" user option: mariadb-check
\fB\-\-user=\fR\fB\fIuser_name\fR\fR,
\fB\-u \fR\fB\fIuser_name\fR\fR
.sp
@ -1083,13 +1083,13 @@ The MariaDB user name to use when connecting to the server\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: verbose option
.\" verbose option: mysqlcheck
.\" mariadb-check: verbose option
.\" verbose option: mariadb-check
\fB\-\-verbose\fR,
\fB\-v\fR
.sp
Verbose mode\&. Print information about the various stages of program operation\&.
Using one \fB--verbose\fR option will give you more information about what mysqlcheck is
Using one \fB--verbose\fR option will give you more information about what mariadb-check is
doing\&.
.sp
Using two \fB--verbose\fR options will also give you connection information\&.
@ -1106,8 +1106,8 @@ the check phase\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: version option
.\" version option: mysqlcheck
.\" mariadb-check: version option
.\" version option: mariadb-check
\fB\-\-version\fR,
\fB\-V\fR
.sp
@ -1122,8 +1122,8 @@ Display version information and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: write-binlog option
.\" write-binlog option: mysqlcheck
.\" mariadb-check: write-binlog option
.\" write-binlog option: mariadb-check
\fB\-\-write\-binlog\fR
.sp
This option is enabled by default, so that
@ -1131,7 +1131,7 @@ ANALYZE TABLE,
OPTIMIZE TABLE, and
REPAIR TABLE
statements generated by
\fBmysqlcheck\fR
\fBmariadb-check\fR
are written to the binary log\&. Use
\fB\-\-skip\-write\-binlog\fR
to cause
@ -1143,7 +1143,7 @@ when these statements should not be sent to replication slaves or run when using
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

102
man/mariadb-client-test.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADB-CLIENT-TEST\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-CLIENT-TEST\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,37 +11,37 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysql_client_test
.\" mysql_client_test_embedded
.\" mariadb-client-test
.\" mariadb-client-test-embedded
.SH "NAME"
mariadb-client-test \- test client API (mysql_client_test is now a symlink to mariadb-client-test)
mariadb-client-test \- test client API (mariadb-client-test is now a symlink to mariadb-client-test)
.br
mariadb-client-test-embedded \- test client API for embedded server (mysql_client_test_embedded is now a symlink to mariadb-client-test-embedded)
mariadb-client-test-embedded \- test client API for embedded server (mariadb-client-test-embedded is now a symlink to mariadb-client-test-embedded)
.SH "SYNOPSIS"
.HP \w'\fBmysql_client_test\ [\fR\fB\fIoptions\fR\fR\fB]\ [\fR\fB\fItest_name\fR\fR\fB]\ \&.\&.\&.\fR\ 'u
\fBmysql_client_test [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fItest_name\fR\fR\fB] \&.\&.\&.\fR
.HP \w'\fBmysql_client_test_embedded\ [\fR\fB\fIoptions\fR\fR\fB]\ [\fR\fB\fItest_name\fR\fR\fB]\ \&.\&.\&.\fR\ 'u
\fBmysql_client_test_embedded [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fItest_name\fR\fR\fB] \&.\&.\&.\fR
.HP \w'\fBmariadb-client-test\ [\fR\fB\fIoptions\fR\fR\fB]\ [\fR\fB\fItest_name\fR\fR\fB]\ \&.\&.\&.\fR\ 'u
\fBmariadb-client-test [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fItest_name\fR\fR\fB] \&.\&.\&.\fR
.HP \w'\fBmariadb-client-test-embedded\ [\fR\fB\fIoptions\fR\fR\fB]\ [\fR\fB\fItest_name\fR\fR\fB]\ \&.\&.\&.\fR\ 'u
\fBmariadb-client-test-embedded [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fItest_name\fR\fR\fB] \&.\&.\&.\fR
.SH "DESCRIPTION"
.PP
The
\fBmysql_client_test\fR
\fBmariadb-client-test\fR
program is used for testing aspects of the MariaDB client API that cannot be tested using
\fBmysqltest\fR
\fBmariadb-test\fR
and its test language\&.
\fBmysql_client_test_embedded\fR
\fBmariadb-client-test-embedded\fR
is similar but used for testing the embedded server\&. Both programs are run as part of the test suite\&.
.PP
The source code for the programs can be found in in
tests/mysql_client_test\&.c
tests/mariadb-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\&.
.PP
\fBmysql_client_test\fR
\fBmariadb-client-test\fR
is used in a test by the same name in the main tests suite of
\fBmysql\-test\-run\&.pl\fR
\fBmariadb\-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
\fBmariadb-client-test\fR
supports the following options:
.sp
.RS 4
@ -52,8 +52,8 @@ supports the following options:
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_client_test: help option
.\" help option: mysql_client_test
.\" mariadb-client-test: help option
.\" help option: mariadb-client-test
\fB\-\-help\fR,
\fB\-?\fR
.sp
@ -69,8 +69,8 @@ Display a help message and exit\&.
.IP \(bu 2.3
.\}
\fB\-\-basedir=\fR\fB\fIdir_name\fR\fR,
.\" mysql_client_test: basedir option
.\" basedir option: mysql_client_test
.\" mariadb-client-test: basedir option
.\" basedir option: mariadb-client-test
\fB\-b \fR\fB\fIdir_name\fR\fR
.sp
The base directory for the tests\&.
@ -85,8 +85,8 @@ The base directory for the tests\&.
.IP \(bu 2.3
.\}
\fB\-\-count=\fR\fB\fIcount\fR\fR,
.\" mysql_client_test: count option
.\" count option: mysql_client_test
.\" mariadb-client-test: count option
.\" count option: mariadb-client-test
\fB\-t \fR\fB\fIcount\fR\fR
.sp
The number of times to execute the tests\&.
@ -100,8 +100,8 @@ The number of times to execute the tests\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_client_test: database option
.\" database option: mysql_client_test
.\" mariadb-client-test: database option
.\" database option: mariadb-client-test
\fB\-\-database=\fR\fB\fIdb_name\fR\fR,
\fB\-D \fR\fB\fIdb_name\fR\fR
.sp
@ -116,14 +116,14 @@ The database to use\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_client_test: debug option
.\" debug option: mysql_client_test
.\" mariadb-client-test: debug option
.\" debug option: mariadb-client-test
\fB\-\-debug[=\fR\fB\fIdebug_options\fR\fR\fB]\fR,
\fB\-#[\fR\fB\fIdebug_options\fR\fR\fB]\fR
.sp
Write a debugging log if MariaDB is built with debugging support\&. The default
\fIdebug_options\fR
value is 'd:t:o,/tmp/mysql_client_test.trace'.
value is 'd:t:o,/tmp/mariadb-client-test.trace'.
.RE
.sp
.RS 4
@ -135,8 +135,8 @@ value is 'd:t:o,/tmp/mysql_client_test.trace'.
.IP \(bu 2.3
.\}
\fB\-\-getopt\-ll\-test=\fR\fB\fIoption\fR\fR,
.\" mysql_client_test: getopt-ll-test option
.\" getopt-ll-test option: mysql_client_test
.\" mariadb-client-test: getopt-ll-test option
.\" getopt-ll-test option: mariadb-client-test
\fB\-g \fR\fB\fIoption\fR\fR
.sp
Option to use for testing bugs in the
@ -152,8 +152,8 @@ library\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_client_test: host option
.\" host option: mysql_client_test
.\" mariadb-client-test: host option
.\" host option: mariadb-client-test
\fB\-\-host=\fR\fB\fIhost_name\fR\fR,
\fB\-h \fR\fB\fIhost_name\fR\fR
.sp
@ -168,8 +168,8 @@ Connect to the MariaDB server on the given host\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_client_test: password option
.\" password option: mysql_client_test
.\" mariadb-client-test: password option
.\" password option: mariadb-client-test
\fB\-\-password[=\fR\fB\fIpassword\fR\fR\fB]\fR,
\fB\-p[\fR\fB\fIpassword\fR\fR\fB]\fR
.sp
@ -178,8 +178,8 @@ 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
\fIpassword\fR
value following the
.\" mysql_client_test: password option
.\" password option: mysql_client_test
.\" mariadb-client-test: password option
.\" password option: mariadb-client-test
\fB\-\-password\fR
or
\fB\-p\fR
@ -194,8 +194,8 @@ option on the command line, you are prompted for one\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_client_test: port option
.\" port option: mysql_client_test
.\" mariadb-client-test: port option
.\" port option: mariadb-client-test
\fB\-\-port=\fR\fB\fIport_num\fR\fR,
\fB\-P \fR\fB\fIport_num\fR\fR
.sp
@ -211,8 +211,8 @@ The TCP/IP port number to use for the connection\&.
.IP \(bu 2.3
.\}
\fB\-\-server\-arg=\fR\fB\fIarg\fR\fR,
.\" mysql_client_test: server-arg option
.\" server-arg option: mysql_client_test
.\" mariadb-client-test: server-arg option
.\" server-arg option: mariadb-client-test
\fB\-A \fR\fB\fIarg\fR\fR
.sp
Argument to send to the embedded server\&.
@ -240,8 +240,8 @@ Show all test names\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_client_test: silent option
.\" silent option: mysql_client_test
.\" mariadb-client-test: silent option
.\" silent option: mariadb-client-test
\fB\-\-silent\fR,
\fB\-s\fR
.sp
@ -256,8 +256,8 @@ Be more silent\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_client_test: socket option
.\" socket option: mysql_client_test
.\" mariadb-client-test: socket option
.\" socket option: mariadb-client-test
\fB\-\-socket=\fR\fB\fIpath\fR\fR,
\fB\-S \fR\fB\fIpath\fR\fR
.sp
@ -278,8 +278,8 @@ localhost
\fB\-c\fR
.sp
The option is used when called from
\fBmysql\-test\-run\&.pl\fR, so that
\fBmysql_client_test\fR
\fBmariadb\-test\-run\&.pl\fR, so that
\fBmariadb-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
.sp
@ -291,8 +291,8 @@ may optionally behave in a different way than if called manually, for example by
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_client_test: user option
.\" user option: mysql_client_test
.\" mariadb-client-test: user option
.\" user option: mariadb-client-test
\fB\-\-user=\fR\fB\fIuser_name\fR\fR,
\fB\-u \fR\fB\fIuser_name\fR\fR
.sp
@ -308,17 +308,17 @@ The MariaDB user name to use when connecting to the server\&.
.IP \(bu 2.3
.\}
\fB\-v \fR\fB\fIdir_name\fR\fR,
.\" mysql_client_test: vardir option
.\" vardir option: mysql_client_test
.\" mariadb-client-test: vardir option
.\" vardir option: mariadb-client-test
\fB\-\-vardir=\fR\fB\fIdir_name\fR\fR
.sp
The data directory for tests\&. The default is
mysql\-test/var\&.
mariadb\-test/var\&.
.RE
.SH "COPYRIGHT"
.br
.PP
Copyright \(co 2007, 2010, Oracle and/or its affiliates, 2010-2020 MariaDB Foundation
Copyright \(co 2007, 2010, Oracle and/or its affiliates, 2010-2024 MariaDB Foundation
.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

4
man/mariadb-conv.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADB-CONV\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-CONV\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -90,7 +90,7 @@ Treat the specified characters as delimiters\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2020 MariaDB Foundation
Copyright 2024 MariaDB Foundation
.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

62
man/mariadb-convert-table-format.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADB-CONVERT-TABLE-FORMAT\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-CONVERT-TABLE-FORMAT\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,18 +11,18 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysql_convert_table_format
.\" mariadb_convert_table_format
.SH "NAME"
mariadb-convert-table-format \- convert tables to use a given storage engine (mysql_convert_table_format is now a symlink to mariadb-convert-table-format)
mariadb-convert-table-format \- convert tables to use a given storage engine (mariadb-convert-table-format is now a symlink to mariadb-convert-table-format)
.SH "SYNOPSIS"
.HP \w'\fBmysql_convert_table_format\ [\fR\fB\fIoptions\fR\fR\fB]\ \fR\fB\fIdb_name\fR\fR\ 'u
\fBmysql_convert_table_format [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIdb_name\fR\fR
.HP \w'\fBmariadb-convert-table-format\ [\fR\fB\fIoptions\fR\fR\fB]\ \fR\fB\fIdb_name\fR\fR\ 'u
\fBmariadb-convert-table-format [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIdb_name\fR\fR
.SH "DESCRIPTION"
.PP
\fBmysql_convert_table_format\fR
\fBmariadb_convert_table_format\fR
converts the tables in a database to use a particular storage engine (MyISAM
by default)\&.
\fBmysql_convert_table_format\fR
\fBmariadb-convert-table-format\fR
is written in Perl and requires that the
DBI
and
@ -31,14 +31,14 @@ Perl modules be installed (see
Section\ \&2.15, \(lqPerl Installation Notes\(rq)\&.
.PP
Invoke
\fBmysql_convert_table_format\fR
\fBmariadb-convert-table-format\fR
like this:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysql_convert_table_format [\fR\fB\fIoptions\fR\fR\fB]\fR\fB\fIdb_name\fR\fR
shell> \fBmariadb-convert-table-format [\fR\fB\fIoptions\fR\fR\fB]\fR\fB\fIdb_name\fR\fR
.fi
.if n \{\
.RE
@ -48,7 +48,7 @@ The
\fIdb_name\fR
argument indicates the database containing the tables to be converted\&.
.PP
\fBmysql_convert_table_format\fR
\fBmariadb-convert-table-format\fR
supports the options described in the following list\&.
.sp
.RS 4
@ -59,8 +59,8 @@ supports the options described in the following list\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_convert_table_format: help option
.\" help option: mysql_convert_table_format
.\" mariadb-convert-table-format: help option
.\" help option: mariadb-convert-table-format
\fB\-\-help\fR
.sp
Display a help message and exit\&.
@ -74,8 +74,8 @@ Display a help message and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_convert_table_format: force option
.\" force option: mysql_convert_table_format
.\" mariadb-convert-table-format: force option
.\" force option: mariadb-convert-table-format
\fB\-\-force\fR
.sp
Continue even if errors occur\&.
@ -89,8 +89,8 @@ Continue even if errors occur\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_convert_table_format: host option
.\" host option: mysql_convert_table_format
.\" mariadb-convert-table-format: host option
.\" host option: mariadb-convert-table-format
\fB\-\-host=\fR\fB\fIhost_name\fR\fR
.sp
Connect to the MariaDB server on the given host\&.
@ -104,8 +104,8 @@ Connect to the MariaDB server on the given host\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_convert_table_format: password option
.\" password option: mysql_convert_table_format
.\" mariadb-convert-table-format: password option
.\" password option: mariadb-convert-table-format
\fB\-\-password=\fR\fB\fIpassword\fR\fR
.sp
The password to use when connecting to the server\&. Note that the password value is not optional for this option, unlike for other MariaDB programs\&.
@ -121,8 +121,8 @@ Specifying a password on the command line should be considered insecure\&. You c
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_convert_table_format: port option
.\" port option: mysql_convert_table_format
.\" mariadb-convert-table-format: port option
.\" port option: mariadb-convert-table-format
\fB\-\-port=\fR\fB\fIport_num\fR\fR
.sp
The TCP/IP port number to use for the connection\&.
@ -136,8 +136,8 @@ The TCP/IP port number to use for the connection\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_convert_table_format: socket option
.\" socket option: mysql_convert_table_format
.\" mariadb-convert-table-format: socket option
.\" socket option: mariadb-convert-table-format
\fB\-\-socket=\fR\fB\fIpath\fR\fR
.sp
For connections to
@ -152,8 +152,8 @@ localhost, the Unix socket file to use\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_convert_table_format: type option
.\" type option: mysql_convert_table_format
.\" mariadb-convert-table-format: type option
.\" type option: mariadb-convert-table-format
\fB\-\-type=\fR\fB\fIengine_name\fR\fR
.sp
Specify the storage engine that the tables should be converted to use\&. The default is
@ -169,8 +169,8 @@ if this option is not given\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_convert_table_format: user option
.\" user option: mysql_convert_table_format
.\" mariadb-convert-table-format: user option
.\" user option: mariadb-convert-table-format
\fB\-\-user=\fR\fB\fIuser_name\fR\fR
.sp
The MariaDB user name to use when connecting to the server\&.
@ -184,8 +184,8 @@ The MariaDB user name to use when connecting to the server\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_convert_table_format: verbose option
.\" verbose option: mysql_convert_table_format
.\" mariadb-convert-table-format: verbose option
.\" verbose option: mariadb-convert-table-format
\fB\-\-verbose\fR
.sp
Verbose mode\&. Print more information about what the program does\&.
@ -199,8 +199,8 @@ Verbose mode\&. Print more information about what the program does\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_convert_table_format: version option
.\" version option: mysql_convert_table_format
.\" mariadb-convert-table-format: version option
.\" version option: mariadb-convert-table-format
\fB\-\-version\fR
.sp
Display version information and exit\&.
@ -208,7 +208,7 @@ Display version information and exit\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

592
man/mariadb-dump.1
View file

File diff suppressed because it is too large Load diff

40
man/mariadb-dumpslow.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADB-DUMPSLOW\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-DUMPSLOW\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,20 +11,20 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysqldumpslow
.\" mariadb-dumpslow
.SH "NAME"
mariadb-dumpslow \- Summarize slow query log files (mysqldumpslow is now a symlink to mariadb-dumpslow)
mariadb-dumpslow \- Summarize slow query log files (mariadb-dumpslow is now a symlink to mariadb-dumpslow)
.SH "SYNOPSIS"
.HP \w'\fBmysqldumpslow\ [\fR\fBoptions\fR\fB]\ [\fR\fB\fIlog_file\fR\fR\fB\ \&.\&.\&.]\fR\ 'u
\fBmysqldumpslow [\fR\fBoptions\fR\fB] [\fR\fB\fIlog_file\fR\fR\fB \&.\&.\&.]\fR
.HP \w'\fBmariadb-dumpslow\ [\fR\fBoptions\fR\fB]\ [\fR\fB\fIlog_file\fR\fR\fB\ \&.\&.\&.]\fR\ 'u
\fBmariadb-dumpslow [\fR\fBoptions\fR\fB] [\fR\fB\fIlog_file\fR\fR\fB \&.\&.\&.]\fR
.SH "DESCRIPTION"
.PP
The MariaDB slow query log contains information about queries that take a long time to execute\&.
\fBmysqldumpslow\fR
\fBmariadb-dumpslow\fR
parses MariaDB slow query log files and prints a summary of their contents\&.
.PP
Normally,
\fBmysqldumpslow\fR
\fBmariadb-dumpslow\fR
groups queries that are similar except for the particular values of number and string data values\&. It
\(lqabstracts\(rq
these values to N and 'S' when displaying summary output\&. The
@ -34,20 +34,20 @@ and
options can be used to modify value abstracting behavior\&.
.PP
Invoke
\fBmysqldumpslow\fR
\fBmariadb-dumpslow\fR
like this:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysqldumpslow [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIlog_file\fR\fR\fB \&.\&.\&.]\fR
shell> \fBmariadb-dumpslow [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIlog_file\fR\fR\fB \&.\&.\&.]\fR
.fi
.if n \{\
.RE
.\}
.PP
\fBmysqldumpslow\fR
\fBmariadb-dumpslow\fR
supports the following options\&.
.sp
.RS 4
@ -58,8 +58,8 @@ supports the following options\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqldumpslow: help option
.\" help option: mysqldumpslow
.\" mariadb-dumpslow: help option
.\" help option: mariadb-dumpslow
\fB\-\-help\fR
.sp
Display a help message and exit\&.
@ -86,8 +86,8 @@ Do not abstract all numbers to N and strings to 'S'.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqldumpslow: debug option
.\" debug option: mysqldumpslow
.\" mariadb-dumpslow: debug option
.\" debug option: mariadb-dumpslow
\fB\-\-debug\fR,
\fB\-d\fR
.sp
@ -135,7 +135,7 @@ file name\&. The value can contain a wildcard\&. The default is
\fB\-i \fR\fB\fIname\fR\fR
.sp
Name of server instance (if using
\fBmysql\&.server\fR
\fBmariadb\&.server\fR
startup script)\&.
.RE
.sp
@ -289,8 +289,8 @@ queries in the output\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqldumpslow: verbose option
.\" verbose option: mysqldumpslow
.\" mariadb-dumpslow: verbose option
.\" verbose option: mariadb-dumpslow
\fB\-\-verbose\fR,
\fB\-v\fR
.sp
@ -303,8 +303,8 @@ Example of usage:
.RS 4
.\}
.nf
shell> \fBmysqldumpslow\fR
Reading mysql slow query log from /usr/local/mysql/data/mysqld51\-apple\-slow\&.log
shell> \fBmariadb-dumpslow\fR
Reading mariadb slow query log from /usr/local/mysql/data/mysqld51\-apple\-slow\&.log
Count: 1 Time=4\&.32s (4s) Lock=0\&.00s (0s) Rows=0\&.0 (0), root[root]@localhost
insert into t2 select * from t1
Count: 3 Time=2\&.53s (7s) Lock=0\&.00s (0s) Rows=0\&.0 (0), root[root]@localhost
@ -318,7 +318,7 @@ Count: 3 Time=2\&.13s (6s) Lock=0\&.00s (0s) Rows=0\&.0 (0), root[root]@local
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

46
man/mariadb-find-rows.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADB-FIND-ROWS\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-FIND-ROWS\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,15 +11,15 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysql_find_rows
.\" mariadb-find-rows
.SH "NAME"
mariadb-find-rows \- extract SQL statements from files (mysql_find_rows is now a symlink to mariadb-find-rows)
mariadb-find-rows \- extract SQL statements from files (mariadb-find-rows is now a symlink to mariadb-find-rows)
.SH "SYNOPSIS"
.HP \w'\fBmysql_find_rows\ [\fR\fB\fIoptions\fR\fR\fB]\ [\fR\fB\fIfile_name\fR\fR\fB\ \&.\&.\&.]\fR\ 'u
\fBmysql_find_rows [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIfile_name\fR\fR\fB \&.\&.\&.]\fR
.HP \w'\fBmariadb-find-rows\ [\fR\fB\fIoptions\fR\fR\fB]\ [\fR\fB\fIfile_name\fR\fR\fB\ \&.\&.\&.]\fR\ 'u
\fBmariadb-find-rows [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIfile_name\fR\fR\fB \&.\&.\&.]\fR
.SH "DESCRIPTION"
.PP
\fBmysql_find_rows\fR
\fBmariadb-find-rows\fR
reads files containing SQL statements and extracts statements that match a given regular expression or that contain
USE \fIdb_name\fR
or
@ -27,14 +27,14 @@ SET
statements\&. The utility was written for use with update log files (as used prior to MySQL 5\&.0) and as such expects statements to be terminated with semicolon (;) characters\&. It may be useful with other files that contain SQL statements as long as statements are terminated with semicolons\&.
.PP
Invoke
\fBmysql_find_rows\fR
\fBmariadb-find-rows\fR
like this:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysql_find_rows [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIfile_name\fR\fR\fB \&.\&.\&.]\fR
shell> \fBmariadb-find-rows [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIfile_name\fR\fR\fB \&.\&.\&.]\fR
.fi
.if n \{\
.RE
@ -43,7 +43,7 @@ shell> \fBmysql_find_rows [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIfile_name\fR\fR\
Each
\fIfile_name\fR
argument should be the name of file containing SQL statements\&. If no file names are given,
\fBmysql_find_rows\fR
\fBmariadb-find-rows\fR
reads the standard input\&.
.PP
Examples:
@ -52,14 +52,14 @@ Examples:
.RS 4
.\}
.nf
mysql_find_rows \-\-regexp=problem_table \-\-rows=20 < update\&.log
mysql_find_rows \-\-regexp=problem_table update\-log\&.1 update\-log\&.2
mariadb-find-rows \-\-regexp=problem_table \-\-rows=20 < update\&.log
mariadb-find-rows \-\-regexp=problem_table update\-log\&.1 update\-log\&.2
.fi
.if n \{\
.RE
.\}
.PP
\fBmysql_find_rows\fR
\fBmariadb-find-rows\fR
supports the following options:
.sp
.RS 4
@ -70,8 +70,8 @@ supports the following options:
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_find_rows: help option
.\" help option: mysql_find_rows
.\" mariadb-find-rows: help option
.\" help option: mariadb-find-rows
\fB\-\-help\fR,
\fB\-\-Information\fR
.sp
@ -86,8 +86,8 @@ Display a help message and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_find_rows: regexp option
.\" regexp option: mysql_find_rows
.\" mariadb-find-rows: regexp option
.\" regexp option: mariadb-find-rows
\fB\-\-regexp=\fR\fB\fIpattern\fR\fR
.sp
Display queries that match the pattern\&.
@ -101,8 +101,8 @@ Display queries that match the pattern\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_find_rows: rows option
.\" rows option: mysql_find_rows
.\" mariadb-find-rows: rows option
.\" rows option: mariadb-find-rows
\fB\-\-rows=\fR\fB\fIN\fR\fR
.sp
Quit after displaying
@ -118,8 +118,8 @@ queries\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_find_rows: skip-use-db option
.\" skip-use-db option: mysql_find_rows
.\" mariadb-find-rows: skip-use-db option
.\" skip-use-db option: mariadb-find-rows
\fB\-\-skip\-use\-db\fR
.sp
Do not include
@ -135,8 +135,8 @@ statements in the output\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_find_rows: start_row option
.\" start_row option: mysql_find_rows
.\" mariadb-find-rows: start_row option
.\" start_row option: mariadb-find-rows
\fB\-\-start_row=\fR\fB\fIN\fR\fR
.sp
Start output from this row\&.
@ -144,7 +144,7 @@ Start output from this row\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

20
man/mariadb-fix-extensions.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADB-FIX-EXTENSIONS\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-FIX-EXTENSIONS\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,17 +11,17 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysql_fix_extensions
.\" mariadb-fix-extensions
.SH "NAME"
mariadb-fix-extensions \- normalize table file name extensions (mysql_fix_extensions is now a symlink to mariadb-fix-extensions)
mariadb-fix-extensions \- normalize table file name extensions (mariadb-fix-extensions is now a symlink to mariadb-fix-extensions)
.SH "SYNOPSIS"
.HP \w'\fBmysql_fix_extensions\ \fR\fB\fIdata_dir\fR\fR\ 'u
\fBmysql_fix_extensions \fR\fB\fIdata_dir\fR\fR
.HP \w'\fBmariadb-fix-extensions\ \fR\fB\fIdata_dir\fR\fR\ 'u
\fBmariadb-fix-extensions \fR\fB\fIdata_dir\fR\fR
.SH "DESCRIPTION"
.PP
This script is deprecated and will be removed in a later release.
.PP
\fBmysql_fix_extensions\fR
\fBmariadb-fix-extensions\fR
converts the extensions for
MyISAM
(or
@ -39,16 +39,16 @@ and renames them to have extensions of
\&.ISM, respectively\&. This can be useful after transferring the files from a system with case\-insensitive file names (such as Windows) to a system with case\-sensitive file names\&.
.PP
Invoke
\fBmysql_fix_extensions\fR
\fBmariadb-fix-extensions\fR
like this, where
\fIdata_dir\fR
is the path name to the MySQL data directory\&.
is the path name to the MariaDB data directory\&.
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysql_fix_extensions \fR\fB\fIdata_dir\fR\fR
shell> \fBmariadb-fix-extensions \fR\fB\fIdata_dir\fR\fR
.fi
.if n \{\
.RE
@ -56,7 +56,7 @@ shell> \fBmysql_fix_extensions \fR\fB\fIdata_dir\fR\fR
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

134
man/mariadb-hotcopy.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADB-HOTCOPY\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-HOTCOPY\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,19 +11,19 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysqlhotcopy
.\" mariadb-hotcopy
.\" dumping: databases and tables
.\" backups: databases and tables
.\" databases: dumping
.\" tables: dumping
.SH "NAME"
mariadb-hotcopy \- a database backup program (mysqlhotcopy is now a symlink to mariadb-hotcopy)
mariadb-hotcopy \- a database backup program (mariadb-hotcopy is now a symlink to mariadb-hotcopy)
.SH "SYNOPSIS"
.HP \w'\fBmysqlhotcopy\ \fR\fB\fIarguments\fR\fR\ 'u
\fBmysqlhotcopy \fR\fB\fIarguments\fR\fR
.HP \w'\fBmariadb-hotcopy\ \fR\fB\fIarguments\fR\fR\ 'u
\fBmariadb-hotcopy \fR\fB\fIarguments\fR\fR
.SH "DESCRIPTION"
.PP
\fBmysqlhotcopy\fR
\fBmariadb-hotcopy\fR
is a Perl script that was originally written and contributed by Tim Bunce\&. It uses
FLUSH TABLES,
LOCK TABLES, and
@ -31,7 +31,7 @@ cp
or
scp
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
\fBmariadb-hotcopy\fR
works only for backing up
MyISAM
and
@ -39,7 +39,7 @@ ARCHIVE
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
\fBmariadb-hotcopy\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
@ -52,7 +52,7 @@ privilege (to be able to lock the tables)\&.
.RS 4
.\}
.nf
shell> \fBmysqlhotcopy \fR\fB\fIdb_name\fR\fR\fB [\fR\fB\fI/path/to/new_directory\fR\fR\fB]\fR
shell> \fBmariadb-hotcopy \fR\fB\fIdb_name\fR\fR\fB [\fR\fB\fI/path/to/new_directory\fR\fR\fB]\fR
.fi
.if n \{\
.RE
@ -62,7 +62,7 @@ shell> \fBmysqlhotcopy \fR\fB\fIdb_name\fR\fR\fB [\fR\fB\fI/path/to/new_director
.RS 4
.\}
.nf
shell> \fBmysqlhotcopy \fR\fB\fIdb_name_1\fR\fR\fB \&.\&.\&. \fR\fB\fIdb_name_n\fR\fR\fB \fR\fB\fI/path/to/new_directory\fR\fR
shell> \fBmariadb-hotcopy \fR\fB\fIdb_name_1\fR\fR\fB \&.\&.\&. \fR\fB\fIdb_name_n\fR\fR\fB \fR\fB\fI/path/to/new_directory\fR\fR
.fi
.if n \{\
.RE
@ -74,7 +74,7 @@ Back up tables in the given database that match a regular expression:
.RS 4
.\}
.nf
shell> \fBmysqlhotcopy \fR\fB\fIdb_name\fR\fR\fB\&./\fR\fB\fIregex\fR\fR\fB/\fR
shell> \fBmariadb-hotcopy \fR\fB\fIdb_name\fR\fR\fB\&./\fR\fB\fIregex\fR\fR\fB/\fR
.fi
.if n \{\
.RE
@ -86,15 +86,15 @@ The regular expression for the table name can be negated by prefixing it with a
.RS 4
.\}
.nf
shell> \fBmysqlhotcopy \fR\fB\fIdb_name\fR\fR\fB\&./~\fR\fB\fIregex\fR\fR\fB/\fR
shell> \fBmariadb-hotcopy \fR\fB\fIdb_name\fR\fR\fB\&./~\fR\fB\fIregex\fR\fR\fB/\fR
.fi
.if n \{\
.RE
.\}
.PP
\fBmysqlhotcopy\fR
\fBmariadb-hotcopy\fR
supports the following options, which can be specified on the command line or in the
[mysqlhotcopy]
[mariadb-hotcopy]
and
[client]
option file groups\&.
@ -107,8 +107,8 @@ option file groups\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: help option
.\" help option: mysqlhotcopy
.\" mariadb-hotcopy: help option
.\" help option: mariadb-hotcopy
\fB\-\-help\fR,
\fB\-?\fR
.sp
@ -123,8 +123,8 @@ Display a help message and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: addtodest option
.\" addtodest option: mysqlhotcopy
.\" mariadb-hotcopy: addtodest option
.\" addtodest option: mariadb-hotcopy
\fB\-\-addtodest\fR
.sp
Do not rename target directory (if it exists); merely add files to it\&.
@ -138,8 +138,8 @@ Do not rename target directory (if it exists); merely add files to it\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: allowold option
.\" allowold option: mysqlhotcopy
.\" mariadb-hotcopy: allowold option
.\" allowold option: mariadb-hotcopy
\fB\-\-allowold\fR
.sp
Do not abort if a target exists; rename it by adding an
@ -155,8 +155,8 @@ suffix\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: checkpoint option
.\" checkpoint option: mysqlhotcopy
.\" mariadb-hotcopy: checkpoint option
.\" checkpoint option: mariadb-hotcopy
\fB\-\-checkpoint=\fR\fB\fIdb_name\fR\fR\fB\&.\fR\fB\fItbl_name\fR\fR
.sp
Insert checkpoint entries into the specified database
@ -173,20 +173,20 @@ and table
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: chroot option
.\" chroot option: mysqlhotcopy
.\" mariadb-hotcopy: chroot option
.\" chroot option: mariadb-hotcopy
\fB\-\-chroot=\fR\fB\fIpath\fR\fR
.sp
Base directory of the
\fBchroot\fR
jail in which
\fBmysqld\fR
\fBmariadbd\fR
operates\&. The
\fIpath\fR
value should match that of the
\fB\-\-chroot\fR
option given to
\fBmysqld\fR\&.
\fBmariadbd\fR\&.
.RE
.sp
.RS 4
@ -197,8 +197,8 @@ option given to
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: debug option
.\" debug option: mysqlhotcopy
.\" mariadb-hotcopy: debug option
.\" debug option: mariadb-hotcopy
\fB\-\-debug\fR
.sp
Enable debug output\&.
@ -212,8 +212,8 @@ Enable debug output\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: dryrun option
.\" dryrun option: mysqlhotcopy
.\" mariadb-hotcopy: dryrun option
.\" dryrun option: mariadb-hotcopy
\fB\-\-dryrun\fR,
\fB\-n\fR
.sp
@ -228,8 +228,8 @@ Report actions without performing them\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: flushlog option
.\" flushlog option: mysqlhotcopy
.\" mariadb-hotcopy: flushlog option
.\" flushlog option: mariadb-hotcopy
\fB\-\-flushlog\fR
.sp
Flush logs after all tables are locked\&.
@ -243,8 +243,8 @@ Flush logs after all tables are locked\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: host option
.\" host option: mysqlhotcopy
.\" mariadb-hotcopy: host option
.\" host option: mariadb-hotcopy
\fB\-\-host=\fR\fB\fIhost_name\fR\fR,
\fB\-h \fR\fB\fIhost_name\fR\fR
.sp
@ -261,8 +261,8 @@ using a Unix socket file\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: keepold option
.\" keepold option: mysqlhotcopy
.\" mariadb-hotcopy: keepold option
.\" keepold option: mariadb-hotcopy
\fB\-\-keepold\fR
.sp
Do not delete previous (renamed) target when done\&.
@ -276,8 +276,8 @@ Do not delete previous (renamed) target when done\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: method option
.\" method option: mysqlhotcopy
.\" mariadb-hotcopy: method option
.\" method option: mariadb-hotcopy
\fB\-\-method=\fR\fB\fIcommand\fR\fR
.sp
The method for copying files (cp
@ -294,8 +294,8 @@ cp\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: noindices option
.\" noindices option: mysqlhotcopy
.\" mariadb-hotcopy: noindices option
.\" noindices option: mariadb-hotcopy
\fB\-\-noindices\fR
.sp
Do not include full index files for
@ -312,8 +312,8 @@ tables in the backup\&. This makes the backup smaller and faster\&. The indexes
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: old-server option
.\" old-server option: mysqlhotcopy
.\" mariadb-hotcopy: old-server option
.\" old-server option: mariadb-hotcopy
\fB\-\-old\-server\fR
.sp
Connect to old MySQL-server (before v5.5) which doesn't have FLUSH TABLES WITH READ LOCK fully implemented.\&.
@ -327,8 +327,8 @@ Connect to old MySQL-server (before v5.5) which doesn't have FLUSH TABLES WITH R
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: password option
.\" password option: mysqlhotcopy
.\" mariadb-hotcopy: password option
.\" password option: mariadb-hotcopy
\fB\-\-password=\fR\fB\fIpassword\fR\fR,
\fB\-p\fR\fB\fIpassword\fR\fR
.sp
@ -345,8 +345,8 @@ Specifying a password on the command line should be considered insecure\&. You c
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: port option
.\" port option: mysqlhotcopy
.\" mariadb-hotcopy: port option
.\" port option: mariadb-hotcopy
\fB\-\-port=\fR\fB\fIport_num\fR\fR,
\fB\-P \fR\fB\fIport_num\fR\fR
.sp
@ -361,8 +361,8 @@ The TCP/IP port number to use when connecting to the local server\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: quiet option
.\" quiet option: mysqlhotcopy
.\" mariadb-hotcopy: quiet option
.\" quiet option: mariadb-hotcopy
\fB\-\-quiet\fR,
\fB\-q\fR
.sp
@ -377,8 +377,8 @@ Be silent except for errors\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: record_log_pos option
.\" record_log_pos option: mysqlhotcopy
.\" mariadb-hotcopy: record_log_pos option
.\" record_log_pos option: mariadb-hotcopy
\fB\-\-record_log_pos=\fR\fB\fIdb_name\fR\fR\fB\&.\fR\fB\fItbl_name\fR\fR
.sp
Record master and slave status in the specified database
@ -395,8 +395,8 @@ and table
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: regexp option
.\" regexp option: mysqlhotcopy
.\" mariadb-hotcopy: regexp option
.\" regexp option: mariadb-hotcopy
\fB\-\-regexp=\fR\fB\fIexpr\fR\fR
.sp
Copy all databases with names that match the given regular expression\&.
@ -410,8 +410,8 @@ Copy all databases with names that match the given regular expression\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: resetmaster option
.\" resetmaster option: mysqlhotcopy
.\" mariadb-hotcopy: resetmaster option
.\" resetmaster option: mariadb-hotcopy
\fB\-\-resetmaster\fR
.sp
Reset the binary log after locking all the tables\&.
@ -425,8 +425,8 @@ Reset the binary log after locking all the tables\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: resetslave option
.\" resetslave option: mysqlhotcopy
.\" mariadb-hotcopy: resetslave option
.\" resetslave option: mariadb-hotcopy
\fB\-\-resetslave\fR
.sp
Reset the
@ -442,8 +442,8 @@ file after locking all the tables\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: socket option
.\" socket option: mysqlhotcopy
.\" mariadb-hotcopy: socket option
.\" socket option: mariadb-hotcopy
\fB\-\-socket=\fR\fB\fIpath\fR\fR,
\fB\-S \fR\fB\fIpath\fR\fR
.sp
@ -459,8 +459,8 @@ localhost\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: suffix option
.\" suffix option: mysqlhotcopy
.\" mariadb-hotcopy: suffix option
.\" suffix option: mariadb-hotcopy
\fB\-\-suffix=\fR\fB\fIstr\fR\fR
.sp
The suffix to use for names of copied databases\&.
@ -474,8 +474,8 @@ The suffix to use for names of copied databases\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: tmpdir option
.\" tmpdir option: mysqlhotcopy
.\" mariadb-hotcopy: tmpdir option
.\" tmpdir option: mariadb-hotcopy
\fB\-\-tmpdir=\fR\fB\fIpath\fR\fR
.sp
The temporary directory\&. The default is
@ -490,8 +490,8 @@ The temporary directory\&. The default is
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlhotcopy: user option
.\" user option: mysqlhotcopy
.\" mariadb-hotcopy: user option
.\" user option: mariadb-hotcopy
\fB\-\-user=\fR\fB\fIuser_name\fR\fR,
\fB\-u \fR\fB\fIuser_name\fR\fR
.sp
@ -501,7 +501,7 @@ The MariaDB user name to use when connecting to the server\&.
Use
perldoc
for additional
\fBmysqlhotcopy\fR
\fBmariadb-hotcopy\fR
documentation, including information about the structure of the tables needed for the
\fB\-\-checkpoint\fR
and
@ -512,7 +512,7 @@ options:
.RS 4
.\}
.nf
shell> \fBperldoc mysqlhotcopy\fR
shell> \fBperldoc mariadb-hotcopy\fR
.fi
.if n \{\
.RE
@ -520,7 +520,7 @@ shell> \fBperldoc mysqlhotcopy\fR
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

232
man/mariadb-import.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADB-IMPORT\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-IMPORT\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,44 +11,44 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysqlimport
.\" mariadb-import
.\" importing: data
.\" data: importing
.\" files: text
.\" text files: importing
.SH "NAME"
mariadb-import \- a data import program (mysqlimport is now a symlink to mariadb-import)
mariadb-import \- a data import program (mariadb-import is now a symlink to mariadb-import)
.SH "SYNOPSIS"
.HP \w'\fBmysqlimport\ [\fR\fB\fIoptions\fR\fR\fB]\ \fR\fB\fIdb_name\fR\fR\fB\ \fR\fB\fItextfile1\fR\fR\fB\ \&.\&.\&.\fR\ 'u
\fBmysqlimport [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIdb_name\fR\fR\fB \fR\fB\fItextfile1\fR\fR\fB \&.\&.\&.\fR
.HP \w'\fBmariadb-import\ [\fR\fB\fIoptions\fR\fR\fB]\ \fR\fB\fIdb_name\fR\fR\fB\ \fR\fB\fItextfile1\fR\fR\fB\ \&.\&.\&.\fR\ 'u
\fBmariadb-import [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIdb_name\fR\fR\fB \fR\fB\fItextfile1\fR\fR\fB \&.\&.\&.\fR
.SH "DESCRIPTION"
.PP
The
\fBmysqlimport\fR
\fBmariadb-import\fR
client provides a command\-line interface to the
LOAD DATA INFILE
SQL statement\&. Most options to
\fBmysqlimport\fR
\fBmariadb-import\fR
correspond directly to clauses of
LOAD DATA INFILE
syntax\&.
.PP
Invoke
\fBmysqlimport\fR
\fBmariadb-import\fR
like this:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysqlimport [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIdb_name\fR\fR\fB \fR\fB\fItextfile1\fR\fR\fB [\fR\fB\fItextfile2\fR\fR\fB \&.\&.\&.]\fR
shell> \fBmariadb-import [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIdb_name\fR\fR\fB \fR\fB\fItextfile1\fR\fR\fB [\fR\fB\fItextfile2\fR\fR\fB \&.\&.\&.]\fR
.fi
.if n \{\
.RE
.\}
.PP
For each text file named on the command line,
\fBmysqlimport\fR
\fBmariadb-import\fR
strips any extension from the file name and uses the result to determine the name of the table into which to import the file's contents\&. For example, files named
patient\&.txt,
patient\&.text, and
@ -57,13 +57,13 @@ all would be imported into a table named
patient\&.
.PP
.PP
\fBmysqlimport\fR
\fBmariadb-import\fR
supports the following options, which can be specified on the command line or in the
[mysqlimport]
[mariadb-import]
and
[client]
option file groups\&.
\fBmysqlimport\fR
\fBmariadb-import\fR
also supports the options for processing option files\&.
.sp
.RS 4
@ -74,8 +74,8 @@ also supports the options for processing option files\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: help option
.\" help option: mysqlimport
.\" mariadb-import: help option
.\" help option: mariadb-import
\fB\-\-help\fR,
\fB\-?\fR
.sp
@ -90,8 +90,8 @@ Display a help message and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: character-sets-dir option
.\" character-sets-dir option: mysqlimport
.\" mariadb-import: character-sets-dir option
.\" character-sets-dir option: mariadb-import
\fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR
.sp
The directory where character sets are installed\&.
@ -105,8 +105,8 @@ The directory where character sets are installed\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: columns option
.\" columns option: mysqlimport
.\" mariadb-import: columns option
.\" columns option: mariadb-import
\fB\-\-columns=\fR\fB\fIcolumn_list\fR\fR,
\fB\-c \fR\fB\fIcolumn_list\fR\fR
.sp
@ -121,8 +121,8 @@ This option takes a comma\-separated list of column names as its value\&. The or
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: compress option
.\" compress option: mysqlimport
.\" mariadb-import: compress option
.\" compress option: mariadb-import
\fB\-\-compress\fR,
\fB\-C\fR
.sp
@ -137,8 +137,8 @@ Compress all information sent between the client and the server if both support
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: debug option
.\" debug option: mysqlimport
.\" mariadb-import: debug option
.\" debug option: mariadb-import
\fB\-\-debug[=\fR\fB\fIdebug_options\fR\fR\fB]\fR,
\fB\-# [\fR\fB\fIdebug_options\fR\fR\fB]\fR
.sp
@ -155,8 +155,8 @@ string is 'd:t:o,\fIfile_name\fR'. The default is 'd:t:o'.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: debug-check option
.\" debug-check option: mysqlimport
.\" mariadb-import: debug-check option
.\" debug-check option: mariadb-import
\fB\-\-debug\-check\fR
.sp
Print some debugging information when the program exits\&.
@ -170,8 +170,8 @@ Print some debugging information when the program exits\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: debug-info option
.\" debug-info option: mysqlimport
.\" mariadb-import: debug-info option
.\" debug-info option: mariadb-import
\fB\-\-debug\-info\fR
.sp
Print debugging information and memory and CPU usage statistics when the program exits\&.
@ -185,8 +185,8 @@ Print debugging information and memory and CPU usage statistics when the program
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: default-auth option
.\" default-auth option: mysqlimport
.\" mariadb-import: default-auth option
.\" default-auth option: mariadb-import
\fB\-\-default\-auth=\fIplugin_name\fR
.sp
Default authentication client-side plugin to use\&.
@ -200,8 +200,8 @@ Default authentication client-side plugin to use\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: default-character-set option
.\" default-character-set option: mysqlimport
.\" mariadb-import: default-character-set option
.\" default-character-set option: mariadb-import
\fB\-\-default\-character\-set=\fR\fB\fIcharset_name\fR\fR
.sp
Use
@ -217,8 +217,8 @@ as the default character set\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: defaults-extra-file option
.\" defaults-extra-file option: mysqlimport
.\" mariadb-import: defaults-extra-file option
.\" defaults-extra-file option: mariadb-import
\fB\-\-defaults\-extra\-file=\fR\fB\fIfilename\fR\fR
.sp
Set \fB\fIfilename\fR\fR as the file to read default options from after the global defaults files has been
@ -233,8 +233,8 @@ read\&. Must be given as first option\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: defaults-file option
.\" defaults-file option: mysqlimport
.\" mariadb-import: defaults-file option
.\" defaults-file option: mariadb-import
\fB\-\-defaults\-file=\fR\fB\fIfilename\fR\fR
.sp
Set \fB\fIfilename\fR\fR as the file to read default options from, override global defaults files\&.
@ -249,8 +249,8 @@ Must be given as first option\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: delete option
.\" delete option: mysqlimport
.\" mariadb-import: delete option
.\" delete option: mariadb-import
\fB\-\-delete\fR,
\fB\-d\fR
.sp
@ -265,17 +265,17 @@ Empty the table before importing the text file\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: fields-terminated-by option
.\" fields-terminated-by option: mysqlimport
.\" mariadb-import: fields-terminated-by option
.\" fields-terminated-by option: mariadb-import
\fB\-\-fields\-terminated\-by=\&.\&.\&.\fR,
.\" mysqlimport: fields-enclosed-by option
.\" fields-enclosed-by option: mysqlimport
.\" mariadb-import: fields-enclosed-by option
.\" fields-enclosed-by option: mariadb-import
\fB\-\-fields\-enclosed\-by=\&.\&.\&.\fR,
.\" mysqlimport: fields-optionally-enclosed-by option
.\" fields-optionally-enclosed-by option: mysqlimport
.\" mariadb-import: fields-optionally-enclosed-by option
.\" fields-optionally-enclosed-by option: mariadb-import
\fB\-\-fields\-optionally\-enclosed\-by=\&.\&.\&.\fR,
.\" mysqlimport: fields-escaped-by option
.\" fields-escaped-by option: mysqlimport
.\" mariadb-import: fields-escaped-by option
.\" fields-escaped-by option: mariadb-import
\fB\-\-fields\-escaped\-by=\&.\&.\&.\fR
.sp
These options have the same meaning as the corresponding clauses for
@ -290,14 +290,14 @@ LOAD DATA INFILE\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: force option
.\" force option: mysqlimport
.\" mariadb-import: force option
.\" force option: mariadb-import
\fB\-\-force\fR,
\fB\-f\fR
.sp
Ignore errors\&. For example, if a table for a text file does not exist, continue processing any remaining files\&. Without
\fB\-\-force\fR,
\fBmysqlimport\fR
\fBmariadb-import\fR
exits if a table does not exist\&.
.RE
.sp
@ -309,8 +309,8 @@ exits if a table does not exist\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: host option
.\" host option: mysqlimport
.\" mariadb-import: host option
.\" host option: mariadb-import
\fB\-\-host=\fR\fB\fIhost_name\fR\fR,
\fB\-h \fR\fB\fIhost_name\fR\fR
.sp
@ -326,8 +326,8 @@ localhost\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: ignore option
.\" ignore option: mysqlimport
.\" mariadb-import: ignore option
.\" ignore option: mariadb-import
\fB\-\-ignore\fR,
\fB\-i\fR
.sp
@ -344,8 +344,8 @@ option\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: ignore-foreign-keys option
.\" ignore-foreign-keys option: mysqlimport
.\" mariadb-import: ignore-foreign-keys option
.\" ignore-foreign-keys option: mariadb-import
\fB\-\-ignore\-foreign\-keys\fR,
\fB\-k\fR
.sp
@ -360,8 +360,8 @@ Disable foreign key checks while importing the data\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: ignore-lines option
.\" ignore-lines option: mysqlimport
.\" mariadb-import: ignore-lines option
.\" ignore-lines option: mariadb-import
\fB\-\-ignore\-lines=\fR\fB\fIN\fR\fR
.sp
Ignore the first
@ -377,8 +377,8 @@ lines of the data file\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: lines-terminated-by option
.\" lines-terminated-by option: mysqlimport
.\" mariadb-import: lines-terminated-by option
.\" lines-terminated-by option: mariadb-import
\fB\-\-lines\-terminated\-by=\&.\&.\&.\fR
.sp
This option has the same meaning as the corresponding clause for
@ -394,8 +394,8 @@ LOAD DATA INFILE\&. For example, to import Windows files that have lines termina
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: local option
.\" local option: mysqlimport
.\" mariadb-import: local option
.\" local option: mariadb-import
\fB\-\-local\fR,
\fB\-L\fR
.sp
@ -410,8 +410,8 @@ Read input files locally from the client host\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: lock-tables option
.\" lock-tables option: mysqlimport
.\" mariadb-import: lock-tables option
.\" lock-tables option: mariadb-import
\fB\-\-lock\-tables\fR,
\fB\-l\fR
.sp
@ -428,8 +428,8 @@ tables for writing before processing any text files\&. This ensures that all tab
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: low-priority option
.\" low-priority option: mysqlimport
.\" mariadb-import: low-priority option
.\" low-priority option: mariadb-import
\fB\-\-low\-priority\fR
.sp
Use
@ -448,8 +448,8 @@ MERGE)\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: no-defaults option
.\" no-defaults option: mysqlimport
.\" mariadb-import: no-defaults option
.\" no-defaults option: mariadb-import
\fB\-\-no\-defaults\fR
.sp
Do not read default options from any option file\&. This must be given as the
@ -464,8 +464,8 @@ first argument\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: password option
.\" password option: mysqlimport
.\" mariadb-import: password option
.\" password option: mariadb-import
\fB\-\-password[=\fR\fB\fIpassword\fR\fR\fB]\fR,
\fB\-p[\fR\fB\fIpassword\fR\fR\fB]\fR
.sp
@ -478,7 +478,7 @@ value following the
or
\fB\-p\fR
option on the command line,
\fBmysqlimport\fR
\fBmariadb-import\fR
prompts for one\&.
.sp
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\&.
@ -492,8 +492,8 @@ Specifying a password on the command line should be considered insecure\&. You c
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: pipe option
.\" pipe option: mysqlimport
.\" mariadb-import: pipe option
.\" pipe option: mariadb-import
\fB\-\-pipe\fR,
\fB\-W\fR
.sp
@ -508,8 +508,8 @@ On Windows, connect to the server via a named pipe\&. This option applies only i
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: plugin-dir option
.\" plugin-dir option: mysqlimport
.\" mariadb-import: plugin-dir option
.\" plugin-dir option: mariadb-import
\fB\-\-plugin\-dir=\fR\fB\fIname\fR\fR
.sp
Directory for client-side plugins\&.
@ -523,8 +523,8 @@ On Windows, connect to the server via a named pipe\&. This option applies only i
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: port option
.\" port option: mysqlimport
.\" mariadb-import: port option
.\" port option: mariadb-import
\fB\-\-port=\fR\fB\fIport_num\fR\fR,
\fB\-P \fR\fB\fIport_num\fR\fR
.sp
@ -540,8 +540,8 @@ Forces --protocol=tcp when specified on the command line without other connectio
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: protocol option
.\" protocol option: mysqlimport
.\" mariadb-import: protocol option
.\" protocol option: mariadb-import
\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\&.
@ -555,8 +555,8 @@ The connection protocol to use for connecting to the server\&. It is useful when
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: print-defaults option
.\" print-defaults option: mysqlimport
.\" mariadb-import: print-defaults option
.\" print-defaults option: mariadb-import
\fB\-\-print\-defaults\fR
.sp
Print the program argument list and exit\&.
@ -571,8 +571,8 @@ This must be given as the first argument\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: replace option
.\" replace option: mysqlimport
.\" mariadb-import: replace option
.\" replace option: mariadb-import
\fB\-\-replace\fR,
\fB\-r\fR
.sp
@ -593,8 +593,8 @@ options control handling of input rows that duplicate existing rows on unique ke
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: silent option
.\" silent option: mysqlimport
.\" mariadb-import: silent option
.\" silent option: mariadb-import
\fB\-\-silent\fR,
\fB\-s\fR
.sp
@ -609,8 +609,8 @@ Silent mode\&. Produce output only when errors occur\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: socket option
.\" socket option: mysqlimport
.\" mariadb-import: socket option
.\" socket option: mariadb-import
\fB\-\-socket=\fR\fB\fIpath\fR\fR,
\fB\-S \fR\fB\fIpath\fR\fR
.sp
@ -627,8 +627,8 @@ Forces --protocol=socket when specified on the command line without other connec
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL options
.\" SSL options: mysqladmin
.\" mariadb-import: SSL options
.\" SSL options: mariadb-import
\fB\-\-ssl\fR
.sp
Enable SSL for connection (automatically enabled with other flags). Disable with
@ -643,8 +643,8 @@ Enable SSL for connection (automatically enabled with other flags). Disable with
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL CA option
.\" SSL CA option: mysqladmin
.\" mariadb-import: SSL CA option
.\" SSL CA option: mariadb-import
\fB\-\-ssl\-ca=\fIname\fR
.sp
CA file in PEM format (check OpenSSL docs, implies
@ -659,8 +659,8 @@ CA file in PEM format (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL CA Path option
.\" SSL CA Path option: mysqladmin
.\" mariadb-import: SSL CA Path option
.\" SSL CA Path option: mariadb-import
\fB\-\-ssl\-capath=\fIname\fR
.sp
CA directory (check OpenSSL docs, implies
@ -675,8 +675,8 @@ CA directory (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL Cert option
.\" SSL Cert option: mysqladmin
.\" mariadb-import: SSL Cert option
.\" SSL Cert option: mariadb-import
\fB\-\-ssl\-cert=\fIname\fR
.sp
X509 cert in PEM format (check OpenSSL docs, implies
@ -691,8 +691,8 @@ X509 cert in PEM format (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL Cipher option
.\" SSL Cipher option: mysqladmin
.\" mariadb-import: SSL Cipher option
.\" SSL Cipher option: mariadb-import
\fB\-\-ssl\-cipher=\fIname\fR
.sp
SSL cipher to use (check OpenSSL docs, implies
@ -707,8 +707,8 @@ SSL cipher to use (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL Key option
.\" SSL Key option: mysqladmin
.\" mariadb-import: SSL Key option
.\" SSL Key option: mariadb-import
\fB\-\-ssl\-key=\fIname\fR
.sp
X509 key in PEM format (check OpenSSL docs, implies
@ -723,8 +723,8 @@ X509 key in PEM format (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL Crl option
.\" SSL CRL option: mysqladmin
.\" mariadb-import: SSL Crl option
.\" SSL CRL option: mariadb-import
\fB\-\-ssl\-crl=\fIname\fR
.sp
Certificate revocation list (check OpenSSL docs, implies
@ -739,8 +739,8 @@ Certificate revocation list (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL Crlpath option
.\" SSL Crlpath option: mysqladmin
.\" mariadb-import: SSL Crlpath option
.\" SSL Crlpath option: mariadb-import
\fB\-\-ssl\-crlpath=\fIname\fR
.sp
Certificate revocation list path (check OpenSSL docs, implies
@ -755,8 +755,8 @@ Certificate revocation list path (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqladmin: SSL Verify Server Cert option
.\" SSL Verify Server Cert option: mysqladmin
.\" mariadb-import: SSL Verify Server Cert option
.\" SSL Verify Server Cert option: mariadb-import
\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\&.
@ -770,8 +770,8 @@ Verify server's "Common Name" in its cert against hostname used when connecting.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: user option
.\" user option: mysqlimport
.\" mariadb-import: user option
.\" user option: mariadb-import
\fB\-\-user=\fR\fB\fIuser_name\fR\fR,
\fB\-u \fR\fB\fIuser_name\fR\fR
.sp
@ -786,8 +786,8 @@ The MariaDB user name to use when connecting to the server\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: use-threads option
.\" use-threads option: mysqlimport
.\" mariadb-import: use-threads option
.\" use-threads option: mariadb-import
\fB\-\-use\-threads=\fR\fB\fIN\fR\fR
.sp
Load files in parallel using
@ -803,8 +803,8 @@ threads\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: verbose option
.\" verbose option: mysqlimport
.\" mariadb-import: verbose option
.\" verbose option: mariadb-import
\fB\-\-verbose\fR,
\fB\-v\fR
.sp
@ -819,8 +819,8 @@ Verbose mode\&. Print more information about what the program does\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlimport: version option
.\" version option: mysqlimport
.\" mariadb-import: version option
.\" version option: mariadb-import
\fB\-\-version\fR,
\fB\-V\fR
.sp
@ -828,13 +828,13 @@ Display version information and exit\&.
.RE
.PP
Here is a sample session that demonstrates use of
\fBmysqlimport\fR:
\fBmariadb-import\fR:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysql \-e 'CREATE TABLE imptest(id INT, n VARCHAR(30))' test\fR
shell> \fBmariadb \-e 'CREATE TABLE imptest(id INT, n VARCHAR(30))' test\fR
shell> \fBed\fR
a
100 Max Sydow
@ -847,9 +847,9 @@ shell> \fBod \-c imptest\&.txt\fR
0000000 1 0 0 \et M a x S y d o w \en 1 0
0000020 1 \et C o u n t D r a c u l a \en
0000040
shell> \fBmysqlimport \-\-local test imptest\&.txt\fR
shell> \fBmariadb-import \-\-local test imptest\&.txt\fR
test\&.imptest: Records: 2 Deleted: 0 Skipped: 0 Warnings: 0
shell> \fBmysql \-e 'SELECT * FROM imptest' test\fR
shell> \fBmariadb \-e 'SELECT * FROM imptest' test\fR
+\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
| id | n |
+\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
@ -863,7 +863,7 @@ shell> \fBmysql \-e 'SELECT * FROM imptest' test\fR
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

132
man/mariadb-install-db.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADB-INSTALL-DB\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-INSTALL-DB\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,54 +11,54 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysql_install_db
.\" mariadb-install-db
.SH "NAME"
mariadb-install-db \- initialize MariaDB data directory (mysql_install_db is now a symlink to mariadb-install-db)
mariadb-install-db \- initialize MariaDB data directory (mariadb-install-db is now a symlink to mariadb-install-db)
.SH "SYNOPSIS"
.HP \w'\fBmysql_install_db\ [\fR\fB\fIoptions\fR\fR\fB]\fR\ 'u
\fBmysql_install_db [\fR\fB\fIoptions\fR\fR\fB]\fR
.HP \w'\fBmariadb-install-db\ [\fR\fB\fIoptions\fR\fR\fB]\fR\ 'u
\fBmariadb-install-db [\fR\fB\fIoptions\fR\fR\fB]\fR
.SH "DESCRIPTION"
.PP
\fBmysql_install_db\fR
\fBmariadb-install-db\fR
initializes the MariaDB data directory and creates the system tables that it contains, if they do not exist\&.
.PP
To invoke
\fBmysql_install_db\fR, use the following syntax:
\fBmariadb-install-db\fR, use the following syntax:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysql_install_db [\fR\fB\fIoptions\fR\fR\fB]\fR
shell> \fBmariadb-install-db [\fR\fB\fIoptions\fR\fR\fB]\fR
.fi
.if n \{\
.RE
.\}
.PP
Because the MariaDB server,
\fBmysqld\fR, needs to access the data directory when it runs later, you should either run
\fBmysql_install_db\fR
\fBmariadbd\fR, needs to access the data directory when it runs later, you should either run
\fBmariadb-install-db\fR
from the same account that will be used for running
\fBmysqld\fR
\fBmariadbd\fR
or run it as
root
and use the
\fB\-\-user\fR
option to indicate the user name that
\fBmysqld\fR
\fBmariadbd\fR
will run as\&. It might be necessary to specify other options such as
\fB\-\-basedir\fR
or
\fB\-\-datadir\fR
if
\fBmysql_install_db\fR
\fBmariadb-install-db\fR
does not use the correct locations for the installation directory or data directory\&. For example:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBbin/mysql_install_db \-\-user=mysql \e\fR
shell> \fBbin/mariadb-install-db \-\-user=mysql \e\fR
\fB\-\-basedir=/opt/mysql/mysql \e\fR
\fB\-\-datadir=/opt/mysql/mysql/data\fR
.fi
@ -66,9 +66,9 @@ shell> \fBbin/mysql_install_db \-\-user=mysql \e\fR
.RE
.\}
.PP
\fBmysql_install_db\fR
\fBmariadb-install-db\fR
needs to invoke
\fBmysqld\fR
\fBmariadbd\fR
with the
\fB\-\-bootstrap\fR
and
@ -81,17 +81,17 @@ option,
and
\fB\-\-skip\-grant\-tables\fR
will be disabled\&. To handle this, set the
MYSQLD_BOOTSTRAP
mariadbd_BOOTSTRAP
environment variable to the full path name of a server that has all options enabled\&.
\fBmysql_install_db\fR
\fBmariadb-install-db\fR
will use that server\&.
.PP
\fBmysql_install_db\fR
\fBmariadb-install-db\fR
supports the following options, which can be specified on the command line or in the
[mysql_install_db]
[mariadb-install-db]
and (if they are common to
\fBmysqld\fR)
[mysqld]
\fBmariadbd\fR)
[mariadbd]
option file groups\&.
.sp
.RS 4
@ -102,8 +102,8 @@ option file groups\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_install_db: basedir option
.\" basedir option: mysql_install_db
.\" mariadb-install-db: basedir option
.\" basedir option: mariadb-install-db
\fB\-\-basedir=\fR\fB\fIpath\fR\fR
.sp
The path to the MariaDB installation directory\&.
@ -117,8 +117,8 @@ The path to the MariaDB installation directory\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_install_db: builddir option
.\" builddir option: mysql_install_db
.\" mariadb-install-db: builddir option
.\" builddir option: mariadb-install-db
\fB\-\-builddir=\fIpath\fR
.sp
If using \fB--srcdir\fR with out-of-directory builds, you will need to set this
@ -133,8 +133,8 @@ to the location of the build directory where built files reside.\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_install_db: cross-bootstrap option
.\" cross-bootstrap option: mysql_install_db
.\" mariadb-install-db: cross-bootstrap option
.\" cross-bootstrap option: mariadb-install-db
\fB\-\-cross\-bootstrap\fR
.sp
For internal use. Used when building the MariaDB system tables on a different host than the target.\&.
@ -148,10 +148,10 @@ For internal use. Used when building the MariaDB system tables on a different ho
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_install_db: datadir option
.\" datadir option: mysql_install_db
.\" mysql_install_db: ldata option
.\" ldata option: mysql_install_db
.\" mariadb-install-db: datadir option
.\" datadir option: mariadb-install-db
.\" mariadb-install-db: ldata option
.\" ldata option: mariadb-install-db
\fB\-\-datadir=\fR\fB\fIpath\fR\fR,
\fB\-\-ldata=\fR\fB\fIpath\fR\fR
.sp
@ -166,8 +166,8 @@ The path to the MariaDB data directory\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: defaults-extra-file option
.\" defaults-extra-file option: mysqlcheck
.\" mariadb-install-db: defaults-extra-file option
.\" defaults-extra-file option: mariadb-install-db
\fB\-\-defaults\-extra\-file=\fR\fB\fIfilename\fR\fR
.sp
Set \fB\fIfilename\fR\fR as the file to read default options from after the global defaults files has been read\&.
@ -182,8 +182,8 @@ Must be given as first option\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: defaults-file option
.\" defaults-file option: mysqlcheck
.\" mariadb-install-db: defaults-file option
.\" defaults-file option: mariadb-install-db
\fB\-\-defaults\-file=\fR\fB\fIfilename\fR\fR
.sp
Set \fB\fIfilename\fR\fR as the file to read default options from, override global defaults files\&.
@ -198,8 +198,8 @@ Must be given as first option\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_install_db: defaults-group-suffix option
.\" defaults-group-suffix option: mysql_install_db
.\" mariadb-install-db: defaults-group-suffix option
.\" defaults-group-suffix option: mariadb-install-db
\fB\-\-defaults\-group\-suffix=\fR\fB\fIname\fR\fR
.sp
In addition to the given groups, also read groups with this suffix\&.
@ -213,12 +213,12 @@ In addition to the given groups, also read groups with this suffix\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_install_db: force option
.\" force option: mysql_install_db
.\" mariadb-install-db: force option
.\" force option: mariadb-install-db
\fB\-\-force\fR
.sp
Cause
\fBmysql_install_db\fR
\fBmariadb-install-db\fR
to run even if DNS does not work\&. In that case, grant table entries that normally use host names will use IP addresses\&.
.RE
.sp
@ -230,8 +230,8 @@ to run even if DNS does not work\&. In that case, grant table entries that norma
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: help option
.\" help option: mysqlcheck
.\" mariadb-install-db: help option
.\" help option: mariadb-install-db
\fB\-\-help\fR
.sp
Display a help message and exit\&.
@ -245,8 +245,8 @@ Display a help message and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: no-defaults option
.\" no-defaults option: mysqlcheck
.\" mariadb-install-db: no-defaults option
.\" no-defaults option: mariadb-install-db
\fB\-\-no\-defaults\fR
.sp
Do not read default options from any option file\&. This must be given as the first argument\&.
@ -260,8 +260,8 @@ Do not read default options from any option file\&. This must be given as the fi
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlcheck: print-defaults option
.\" print-defaults option: mysqlcheck
.\" mariadb-install-db: print-defaults option
.\" print-defaults option: mariadb-install-db
\fB\-\-print\-defaults\fR
.sp
Print the program argument list and exit\&.
@ -276,8 +276,8 @@ This must be given as the first argument\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_install_db: rpm option
.\" rpm option: mysql_install_db
.\" mariadb-install-db: rpm option
.\" rpm option: mariadb-install-db
\fB\-\-rpm\fR
.sp
For internal use\&. This option is used by RPM files during the MariaDB installation process\&.
@ -291,8 +291,8 @@ For internal use\&. This option is used by RPM files during the MariaDB installa
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_install_db: skip-name-resolve option
.\" skip-name-resolve option: mysql_install_db
.\" mariadb-install-db: skip-name-resolve option
.\" skip-name-resolve option: mariadb-install-db
\fB\-\-skip\-name\-resolve\fR
.sp
Use IP addresses rather than host names when creating grant table entries\&. This option can be useful if your DNS does not work\&.
@ -306,12 +306,12 @@ Use IP addresses rather than host names when creating grant table entries\&. Thi
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_install_db: srcdir option
.\" srcdir option: mysql_install_db
.\" mariadb-install-db: srcdir option
.\" srcdir option: mariadb-install-db
\fB\-\-srcdir=\fR\fB\fIpath\fR\fR
.sp
For internal use\&. The directory under which
\fBmysql_install_db\fR
\fBmariadb-install-db\fR
looks for support files such as the error message file and the file for populating the help tables\&.4\&.
.RE
.sp
@ -323,17 +323,17 @@ looks for support files such as the error message file and the file for populati
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_install_db: user option
.\" user option: mysql_install_db
.\" mariadb-install-db: user option
.\" user option: mariadb-install-db
\fB\-\-user=\fR\fB\fIuser_name\fR\fR
.sp
The login user name to use for running
\fBmysqld\fR\&. Files and directories created by
\fBmysqld\fR
\fBmariadbd\fR\&. Files and directories created by
\fBmariadbd\fR
will be owned by this user\&. You must be
root
to use this option\&. By default,
\fBmysqld\fR
\fBmariadbd\fR
runs using your current login name and files and directories that it creates will be owned by you\&.
.RE
.sp
@ -345,8 +345,8 @@ runs using your current login name and files and directories that it creates wil
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_install_db: extra-file option
.\" extra-file option: mysql_install_db
.\" mariadb-install-db: extra-file option
.\" extra-file option: mariadb-install-db
\fB\-\-extra-file=\fR\fB\fIfile_path\fR\fR
.sp
Add user defined SQL file, to be executed following regular database initialization.
@ -360,8 +360,8 @@ Add user defined SQL file, to be executed following regular database initializat
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_install_db: verbose option
.\" verbose option: mysql_install_db
.\" mariadb-install-db: verbose option
.\" verbose option: mariadb-install-db
\fB\-\-verbose\fR
.sp
Verbose mode\&. Print more information about what the program does\&.
@ -375,8 +375,8 @@ Verbose mode\&. Print more information about what the program does\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_install_db: windows option
.\" windows option: mysql_install_db
.\" mariadb-install-db: windows option
.\" windows option: mariadb-install-db
\fB\-\-windows\fR
.sp
For internal use\&. This option is used for creating Windows distributions\&.
@ -384,7 +384,7 @@ For internal use\&. This option is used for creating Windows distributions\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

100
man/mariadb-plugin.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADB-PLUGIN\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-PLUGIN\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@ -20,16 +20,16 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysql_plugin
.\" mariadb-plugin
.SH "NAME"
mariadb-plugin \- configure MariaDB server plugins (mysql_plugin is now a symlink to mariadb-plugin)
mariadb-plugin \- configure MariaDB server plugins (mariadb-plugin is now a symlink to mariadb-plugin)
.SH "SYNOPSIS"
.HP \w'\fBmysql_plugin\ [\fR\fB\fIoptions\fR\fR\fB]\ \fR\fB\fIplugin\fR\fR\fB\ {ENABLE|DISABLE}\fR\ 'u
\fBmysql_plugin [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIplugin\fR\fR\fB {ENABLE|DISABLE}\fR
.HP \w'\fBmariadb-plugin\ [\fR\fB\fIoptions\fR\fR\fB]\ \fR\fB\fIplugin\fR\fR\fB\ {ENABLE|DISABLE}\fR\ 'u
\fBmariadb-plugin [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIplugin\fR\fR\fB {ENABLE|DISABLE}\fR
.SH "DESCRIPTION"
.PP
The
\fBmysql_plugin\fR
\fBmariadb-plugin\fR
utility enables MariaDB administrators to manage which plugins a MariaDB server loads\&. It provides an alternative to manually specifying the
\fB\-\-plugin\-load\fR
option at server startup or using the
@ -39,11 +39,11 @@ UNINSTALL PLUGIN
statements at runtime\&.
.PP
Depending on whether
\fBmysql_plugin\fR
\fBmariadb-plugin\fR
is invoked to enable or disable plugins, it inserts or deletes rows in the
mysql\&.plugin
table that serves as a plugin registry\&. (To perform this operation,
\fBmysql_plugin\fR
\fBmariadb-plugin\fR
invokes the MariaDB server in bootstrap mode\&. This means that the server must not already be running\&.) For normal server startups, the server loads and enables plugins listed in
mysql\&.plugin
automatically\&. For additional control over plugin activation, use
@ -51,15 +51,15 @@ automatically\&. For additional control over plugin activation, use
options named for specific plugins\&.
.PP
Each invocation of
\fBmysql_plugin\fR
\fBmariadb-plugin\fR
reads a configuration file to determine how to configure the plugins contained in a single plugin library object file\&. To invoke
\fBmysql_plugin\fR, use this syntax:
\fBmariadb-plugin\fR, use this syntax:
.sp
.if n \{\
.RS 4
.\}
.nf
mysql_plugin [\fIoptions\fR] \fIplugin\fR {ENABLE|DISABLE}
mariadb-plugin [\fIoptions\fR] \fIplugin\fR {ENABLE|DISABLE}
.fi
.if n \{\
.RE
@ -89,7 +89,7 @@ myplugins\&. Suppose that this plugin library contains three plugins,
plugin1,
plugin2, and
plugin3, all of which should be configured under
\fBmysql_plugin\fR
\fBmariadb-plugin\fR
control\&. By convention, configuration files have a suffix of
\&.ini
and the same basename as the plugin library, so the default configuration file name for this plugin library is
@ -118,14 +118,14 @@ or
are taken as comments and ignored\&.
.PP
To enable the plugins listed in the configuration file, invoke
\fBmysql_plugin\fR
\fBmariadb-plugin\fR
this way:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysql_plugin myplugins ENABLE\fR
shell> \fBmariadb-plugin myplugins ENABLE\fR
.fi
.if n \{\
.RE
@ -137,25 +137,25 @@ rather than
ENABLE\&.
.PP
An error occurs if
\fBmysql_plugin\fR
\fBmariadb-plugin\fR
cannot find the configuration file or plugin library file, or if
\fBmysql_plugin\fR
\fBmariadb-plugin\fR
cannot start the MariaDB server\&.
.PP
\fBmysql_plugin\fR
\fBmariadb-plugin\fR
supports the following options, which can be specified on the command line or in the
[mysqld]
[mariadbd]
group of any option file\&. For options specified in a
[mysqld]
[mariadbd]
group,
\fBmysql_plugin\fR
\fBmariadb-plugin\fR
recognizes the
\fB\-\-basedir\fR,
\fB\-\-datadir\fR, and
\fB\-\-plugin\-dir\fR
options and ignores others\&.
.PP
mysql_plugin Options
mariadb-plugin Options
.sp
.RS 4
.ie n \{\
@ -165,8 +165,8 @@ mysql_plugin Options
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_plugin: help option
.\" help option: mysql_plugin
.\" mariadb-plugin: help option
.\" help option: mariadb-plugin
\fB\-\-help\fR,
\fB\-?\fR
.sp
@ -181,8 +181,8 @@ Display a help message and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_plugin: basedir option
.\" basedir option: mysql_plugin
.\" mariadb-plugin: basedir option
.\" basedir option: mariadb-plugin
\fB\-\-basedir=\fR\fB\fIpath\fR\fR,
\fB\-b \fR\fB\fIpath\fR\fR
.sp
@ -197,8 +197,8 @@ The server base directory\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_plugin: datadir option
.\" datadir option: mysql_plugin
.\" mariadb-plugin: datadir option
.\" datadir option: mariadb-plugin
\fB\-\-datadir=\fR\fB\fIpath\fR\fR,
\fB\-d \fR\fB\fIpath\fR\fR
.sp
@ -213,8 +213,8 @@ The server data directory\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_plugin: my-print-defaults option
.\" my-print-defaults option: mysql_plugin
.\" mariadb-plugin: my-print-defaults option
.\" my-print-defaults option: mariadb-plugin
\fB\-\-my\-print\-defaults=\fR\fB\fIpath\fR\fR,
\fB\-b \fR\fB\fIpath\fR\fR
.sp
@ -231,13 +231,13 @@ program\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_plugin: mysqld option
.\" mysqld option: mysql_plugin
\fB\-\-mysqld=\fR\fB\fIpath\fR\fR,
.\" mariadb-plugin: mariadbd option
.\" mariadbd option: mariadb-plugin
\fB\-\-mariadbd=\fR\fB\fIpath\fR\fR,
\fB\-b \fR\fB\fIpath\fR\fR
.sp
The path to the
\fBmysqld\fR
\fBmariadbd\fR
server\&.
.RE
.sp
@ -249,15 +249,15 @@ server\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_plugin: no-defaults option
.\" no-defaults option: mysql_plugin
.\" mariadb-plugin: no-defaults option
.\" no-defaults option: mariadb-plugin
\fB\-\-no\-defaults\fR,
\fB\-p\fR
.sp
Do not read values from the configuration file\&. This option enables an administrator to skip reading defaults from the configuration file\&.
.sp
With
\fBmysql_plugin\fR, this option need not be given first on the command line, unlike most other MariaDB programs that support
\fBmariadb-plugin\fR, this option need not be given first on the command line, unlike most other MariaDB programs that support
\fB\-\-no\-defaults\fR\&.
.RE
.sp
@ -269,8 +269,8 @@ With
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_plugin: plugin-dir option
.\" plugin-dir option: mysql_plugin
.\" mariadb-plugin: plugin-dir option
.\" plugin-dir option: mariadb-plugin
\fB\-\-plugin\-dir=\fR\fB\fIpath\fR\fR,
\fB\-p \fR\fB\fIpath\fR\fR
.sp
@ -285,13 +285,13 @@ The server plugin directory\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_plugin: plugin-ini option
.\" plugin-ini option: mysql_plugin
.\" mariadb-plugin: plugin-ini option
.\" plugin-ini option: mariadb-plugin
\fB\-\-plugin\-ini=\fR\fB\fIfile_name\fR\fR,
\fB\-i \fR\fB\fIfile_name\fR\fR
.sp
The
\fBmysql_plugin\fR
\fBmariadb-plugin\fR
configuration file\&. Relative path names are interpreted relative to the current directory\&. If this option is not given, the default is
\fIplugin\fR\&.ini
in the plugin directory, where
@ -309,13 +309,13 @@ argument on the command line\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_plugin: print-defaults option
.\" print-defaults option: mysql_plugin
.\" mariadb-plugin: print-defaults option
.\" print-defaults option: mariadb-plugin
\fB\-\-print\-defaults\fR,
\fB\-P\fR
.sp
Display the default values from the configuration file\&. This option causes
\fBmysql_plugin\fR
\fBmariadb-plugin\fR
to print the defaults for
\fB\-\-basedir\fR,
\fB\-\-datadir\fR, and
@ -323,7 +323,7 @@ to print the defaults for
if they are found in the configuration file\&. If no value for a variable is found, nothing is shown\&.
.sp
With
\fBmysql_plugin\fR, this option need not be given first on the command line, unlike most other MariaDB programs that support
\fBmariadb-plugin\fR, this option need not be given first on the command line, unlike most other MariaDB programs that support
\fB\-\-print\-defaults\fR\&.
.RE
.sp
@ -335,8 +335,8 @@ With
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_plugin: verbose option
.\" verbose option: mysql_plugin
.\" mariadb-plugin: verbose option
.\" verbose option: mariadb-plugin
\fB\-\-verbose\fR,
\fB\-v\fR
.sp
@ -351,8 +351,8 @@ Verbose mode\&. Print more information about what the program does\&. This optio
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_plugin: version option
.\" version option: mysql_plugin
.\" mariadb-plugin: version option
.\" version option: mariadb-plugin
\fB\-\-version\fR,
\fB\-V\fR
.sp
@ -361,7 +361,7 @@ Display version information and exit\&.
.SH "COPYRIGHT"
.br
.PP
Copyright \(co 1997, 2013, Oracle and/or its affiliates. All rights reserved., 2013-2019 MariaDB Foundation
Copyright \(co 1997, 2013, Oracle and/or its affiliates. All rights reserved., 2013-2024 MariaDB Foundation
.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

34
man/mariadb-secure-installation.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADB-SECURE-INSTALLATION\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-SECURE-INSTALLATION\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,12 +11,12 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysql_secure_installation
.\" mariadb-secure-installation
.SH "NAME"
mariadb-secure-installation \- improve MariaDB installation security (mysql_secure_installation is now a symlink to mariadb-secure-installation)
mariadb-secure-installation \- improve MariaDB installation security (mariadb-secure-installation is now a symlink to mariadb-secure-installation)
.SH "SYNOPSIS"
.HP \w'\fBmysql_secure_installation\fR\ 'u
\fBmysql_secure_installation\fR
.HP \w'\fBmariadb-secure-installation\fR\ 'u
\fBmariadb-secure-installation\fR
.SH "DESCRIPTION"
.PP
This program enables you to improve the security of your MariaDB installation in the following ways:
@ -71,14 +71,14 @@ test
database, which by default can be accessed by anonymous users\&.
.RE
.PP
\fBmysql_secure_installation\fR
\fBmariadb-secure-installation\fR
can be invoked without arguments:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysql_secure_installation\fR
shell> \fBmariadb-secure-installation\fR
.fi
.if n \{\
.RE
@ -86,7 +86,7 @@ shell> \fBmysql_secure_installation\fR
.PP
The script will prompt you to determine which actions to perform\&.
.PP
\fBmysql_secure_installation\fR
\fBmariadb-secure-installation\fR
accepts some options:
.sp
.RS 4
@ -97,8 +97,8 @@ accepts some options:
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_secure_installation: basedir option
.\" basedir option: mysql_secure_installation
.\" mariadb-secure-installation: basedir option
.\" basedir option: mariadb-secure-installation
\fB\-\-basedir=\fR\fB\fIdir_name\fR\fR
.sp
Base directory\&.
@ -112,8 +112,8 @@ Base directory\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_secure_installation: defaults-extra-file option
.\" defaults-extra-file option: mysql_secure_installation
.\" mariadb-secure-installation: defaults-extra-file option
.\" defaults-extra-file option: mariadb-secure-installation
\fB\-\-defaults\-extra\-file=\fR\fB\fIfile_name\fR\fR
.sp
Additional option file\&.
@ -127,8 +127,8 @@ Additional option file\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_secure_installation: defaults-file option
.\" defaults-file option: mysql_secure_installation
.\" mariadb-secure-installation: defaults-file option
.\" defaults-file option: mariadb-secure-installation
\fB\-\-defaults\-file=\fR\fB\fIfile_name\fR\fR
.sp
Option file\&.
@ -142,8 +142,8 @@ Option file\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_secure_installation: no-defaults option
.\" no-defaults option: mysql_secure_installation
.\" mariadb-secure-installation: no-defaults option
.\" no-defaults option: mariadb-secure-installation
\fB\-\-no\-defaults\fR
.sp
Don't read any defaults file\&.
@ -153,7 +153,7 @@ Other unrecognized options will be passed on to the server\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

8
man/mariadb-service-convert.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADB-SERVICE-CONVERT\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-SERVICE-CONVERT\fR" "1" "3 September 2024" "MariaDB 10.11" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -9,11 +9,11 @@
.\" disable justification (adjust text to left margin only)
.ad l
.SH NAME
mariadb-service-convert \- generate a mariadb.service file based on the current mysql/mariadb settings
mariadb-service-convert \- generate a mariadb.service file based on the current mariadb settings
.SH DESCRIPTION
Use: Generate a mariadb.service file based on the current mysql/mariadb settings\.
Use: Generate a mariadb.service file based on the current mariadb settings\.
This is to assist distro maintainers in migrating to systemd service definations from
a user mysqld_safe settings in the my.cnf files\.
a user mariadbd-safe settings in the my.cnf files\.
.PP
Redirect output to user directory like /etc/systemd/system/mariadb.service.d/migrated-from-my.cnf-settings.conf
.PP

48
man/mariadb-setpermission.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADB-SETPERMISSION\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-SETPERMISSION\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,17 +11,17 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysql_setpermission
.\" mariadb-setpermission
.SH "NAME"
mariadb-setpermission \- interactively set permissions in grant tables (mysql_setpermission is now a symlink to mariadb-setpermission)
mariadb-setpermission \- interactively set permissions in grant tables (mariadb-setpermission is now a symlink to mariadb-setpermission)
.SH "SYNOPSIS"
.HP \w'\fBmysql_setpermission\ [\fR\fB\fIoptions\fR\fR\fB]\fR\ 'u
\fBmysql_setpermission [\fR\fB\fIoptions\fR\fR\fB]\fR
.HP \w'\fBmariadb-setpermission\ [\fR\fB\fIoptions\fR\fR\fB]\fR\ 'u
\fBmariadb-setpermission [\fR\fB\fIoptions\fR\fR\fB]\fR
.SH "DESCRIPTION"
.PP
\fBmysql_setpermission\fR
\fBmariadb-setpermission\fR
is a Perl script that was originally written and contributed by Luuk de Boer\&. It interactively sets permissions in the MariaDB grant tables\&.
\fBmysql_setpermission\fR
\fBmariadb-setpermission\fR
is written in Perl and requires that the
DBI
and
@ -29,14 +29,14 @@ DBD::MariaDB
Perl modules be installed\&.
.PP
Invoke
\fBmysql_setpermission\fR
\fBmariadb-setpermission\fR
like this:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysql_setpermission [\fR\fB\fIoptions\fR\fR\fB]\fR
shell> \fBmariadb-setpermission [\fR\fB\fIoptions\fR\fR\fB]\fR
.fi
.if n \{\
.RE
@ -47,7 +47,7 @@ should be either
\fB\-\-help\fR
to display the help message, or options that indicate how to connect to the MariaDB server\&. The account used when you connect determines which permissions you have when attempting to modify existing permissions in the grant tables\&.
.PP
\fBmysql_setpermission\fR
\fBmariadb-setpermission\fR
also reads options from the
[client]
and
@ -56,7 +56,7 @@ groups in the
\&.my\&.cnf
file in your home directory, if the file exists\&.
.PP
\fBmysql_setpermission\fR
\fBmariadb-setpermission\fR
supports the following options:
.sp
.RS 4
@ -67,8 +67,8 @@ supports the following options:
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_setpermission: help option
.\" help option: mysql_setpermission
.\" mariadb-setpermission: help option
.\" help option: mariadb-setpermission
\fB\-\-help\fR
.sp
Display a help message and exit\&.
@ -82,8 +82,8 @@ Display a help message and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_setpermission: host option
.\" host option: mysql_setpermission
.\" mariadb-setpermission: host option
.\" host option: mariadb-setpermission
\fB\-\-host=\fR\fB\fIhost_name\fR\fR
.sp
Connect to the MariaDB server on the given host\&.
@ -97,8 +97,8 @@ Connect to the MariaDB server on the given host\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_setpermission: password option
.\" password option: mysql_setpermission
.\" mariadb-setpermission: password option
.\" password option: mariadb-setpermission
\fB\-\-password=\fR\fB\fIpassword\fR\fR
.sp
The password to use when connecting to the server\&. Note that the password value is not optional for this option, unlike for other MariaDB programs\&.
@ -114,8 +114,8 @@ Specifying a password on the command line should be considered insecure\&. You c
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_setpermission: port option
.\" port option: mysql_setpermission
.\" mariadb-setpermission: port option
.\" port option: mariadb-setpermission
\fB\-\-port=\fR\fB\fIport_num\fR\fR
.sp
The TCP/IP port number to use for the connection\&.
@ -129,8 +129,8 @@ The TCP/IP port number to use for the connection\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_setpermission: socket option
.\" socket option: mysql_setpermission
.\" mariadb-setpermission: socket option
.\" socket option: mariadb-setpermission
\fB\-\-socket=\fR\fB\fIpath\fR\fR
.sp
For connections to
@ -145,8 +145,8 @@ localhost, the Unix socket file to use\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_setpermission: user option
.\" user option: mysql_setpermission
.\" mariadb-setpermission: user option
.\" user option: mariadb-setpermission
\fB\-\-user=\fR\fB\fIuser_name\fR\fR
.sp
The MariaDB user name to use when connecting to the server\&.
@ -154,7 +154,7 @@ The MariaDB user name to use when connecting to the server\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

176
man/mariadb-show.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADB-SHOW\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-SHOW\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,39 +11,39 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysqlshow
.\" mariadb-show
.\" databases: displaying
.\" displaying: database information
.\" tables: displaying
.\" columns: displaying
.\" showing: database information
.SH "NAME"
mariadb-show \- display database, table, and column information (mysqlshow is now a symlink to mariadb-show)
mariadb-show \- display database, table, and column information (mariadb-show is now a symlink to mariadb-show)
.SH "SYNOPSIS"
.HP \w'\fBmysqlshow\ [\fR\fB\fIoptions\fR\fR\fB]\ [\fR\fB\fIdb_name\fR\fR\fB\ [\fR\fB\fItbl_name\fR\fR\fB\ [\fR\fB\fIcol_name\fR\fR\fB]]]\fR\ 'u
\fBmysqlshow [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIdb_name\fR\fR\fB [\fR\fB\fItbl_name\fR\fR\fB [\fR\fB\fIcol_name\fR\fR\fB]]]\fR
.HP \w'\fBmariadb-show\ [\fR\fB\fIoptions\fR\fR\fB]\ [\fR\fB\fIdb_name\fR\fR\fB\ [\fR\fB\fItbl_name\fR\fR\fB\ [\fR\fB\fIcol_name\fR\fR\fB]]]\fR\ 'u
\fBmariadb-show [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIdb_name\fR\fR\fB [\fR\fB\fItbl_name\fR\fR\fB [\fR\fB\fIcol_name\fR\fR\fB]]]\fR
.SH "DESCRIPTION"
.PP
The
\fBmysqlshow\fR
\fBmariadb-show\fR
client can be used to quickly see which databases exist, their tables, or a table's columns or indexes\&.
.PP
\fBmysqlshow\fR
\fBmariadb-show\fR
provides a command\-line interface to several SQL
SHOW
statements\&. The same information can be obtained by using those statements directly\&. For example, you can issue them from the
\fBmysql\fR
\fBmariadb\fR
client program\&.
.PP
Invoke
\fBmysqlshow\fR
\fBmariadb-show\fR
like this:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysqlshow [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIdb_name\fR\fR\fB [\fR\fB\fItbl_name\fR\fR\fB [\fR\fB\fIcol_name\fR\fR\fB]]]\fR
shell> \fBmariadb-show [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIdb_name\fR\fR\fB [\fR\fB\fItbl_name\fR\fR\fB [\fR\fB\fIcol_name\fR\fR\fB]]]\fR
.fi
.if n \{\
.RE
@ -98,18 +98,18 @@ and
wildcard characters\&. This might cause some confusion when you try to display the columns for a table with a
\(lq_\(rq
in the name, because in this case,
\fBmysqlshow\fR
\fBmariadb-show\fR
shows you only the table names that match the pattern\&. This is easily fixed by adding an extra
\(lq%\(rq
last on the command line as a separate argument\&.
.PP
\fBmysqlshow\fR
\fBmariadb-show\fR
supports the following options, which can be specified on the command line or in the
[mysqlshow]
[mariadb-show]
and
[client]
option file groups\&.
\fBmysqlshow\fR
\fBmariadb-show\fR
also supports the options for processing option files described.
.sp
.RS 4
@ -120,8 +120,8 @@ also supports the options for processing option files described.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: help option
.\" help option: mysqlshow
.\" mariadb-show: help option
.\" help option: mariadb-show
\fB\-\-help\fR,
\fB\-?\fR
.sp
@ -136,8 +136,8 @@ Display a help message and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: character-sets-dir option
.\" character-sets-dir option: mysqlshow
.\" mariadb-show: character-sets-dir option
.\" character-sets-dir option: mariadb-show
\fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR,
\fB\-c\fR \fIpath\fR\fR
.sp
@ -152,8 +152,8 @@ The directory where character sets are installed\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: compress option
.\" compress option: mysqlshow
.\" mariadb-show: compress option
.\" compress option: mariadb-show
\fB\-\-compress\fR,
\fB\-C\fR
.sp
@ -168,8 +168,8 @@ Compress all information sent between the client and the server if both support
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: count option
.\" count option: mysqlshow
.\" mariadb-show: count option
.\" count option: mariadb-show
\fB\-\-count\fR
.sp
Show the number of rows per table\&. This can be slow for non\-MyISAM
@ -184,8 +184,8 @@ tables\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: debug option
.\" debug option: mysqlshow
.\" mariadb-show: debug option
.\" debug option: mariadb-show
\fB\-\-debug[=\fR\fB\fIdebug_options\fR\fR\fB]\fR,
\fB\-# [\fR\fB\fIdebug_options\fR\fR\fB]\fR
.sp
@ -202,8 +202,8 @@ string is 'd:t:o,\fIfile_name\fR'. The default is 'd:t:o'.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: debug-check option
.\" debug-check option: mysqlshow
.\" mariadb-show: debug-check option
.\" debug-check option: mariadb-show
\fB\-\-debug\-check\fR
.sp
Print some debugging information when the program exits\&.
@ -217,8 +217,8 @@ Print some debugging information when the program exits\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: debug-info option
.\" debug-info option: mysqlshow
.\" mariadb-show: debug-info option
.\" debug-info option: mariadb-show
\fB\-\-debug\-info\fR
.sp
Print debugging information and memory and CPU usage statistics when the program exits\&.
@ -232,8 +232,8 @@ Print debugging information and memory and CPU usage statistics when the program
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: default-auth option
.\" default-auth option: mysqlshow
.\" mariadb-show: default-auth option
.\" default-auth option: mariadb-show
\fB\-\-default\-auth=\fR\fB\fIname\fR
.sp
Default authentication client-side plugin to use\&.
@ -247,8 +247,8 @@ Default authentication client-side plugin to use\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: default-character-set option
.\" default-character-set option: mysqlshow
.\" mariadb-show: default-character-set option
.\" default-character-set option: mariadb-show
\fB\-\-default\-character\-set=\fR\fB\fIcharset_name\fR\fR
.sp
Use
@ -264,8 +264,8 @@ as the default character set\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: defaults-extra-file option
.\" defaults-extra-file option: mysqlshow
.\" mariadb-show: defaults-extra-file option
.\" defaults-extra-file option: mariadb-show
\fB\-\-defaults\-extra\-file=\fR\fB\fIfilename\fR\fR
.sp
Set \fB\fIfilename\fR\fR as the file to read default options from after the global defaults files has been
@ -280,8 +280,8 @@ read\&. Must be given as first option\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: defaults-file option
.\" defaults-file option: mysqlshow
.\" mariadb-show: defaults-file option
.\" defaults-file option: mariadb-show
\fB\-\-defaults\-file=\fR\fB\fIfilename\fR\fR
.sp
Set \fB\fIfilename\fR\fR as the file to read default options from, override global defaults files\&.
@ -296,8 +296,8 @@ Must be given as first option\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: defaults-group-suffix option
.\" defaults-group-suffix option: mysqlshow
.\" mariadb-show: defaults-group-suffix option
.\" defaults-group-suffix option: mariadb-show
\fB\-\-defaults\-group\-suffix=\fR\fB\fIsuffix\fR\fR
.sp
In addition to the groups named on the command line, read groups that have the given suffix\&.
@ -311,8 +311,8 @@ In addition to the groups named on the command line, read groups that have the g
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: host option
.\" host option: mysqlshow
.\" mariadb-show: host option
.\" host option: mariadb-show
\fB\-\-host=\fR\fB\fIhost_name\fR\fR,
\fB\-h \fR\fB\fIhost_name\fR\fR
.sp
@ -327,8 +327,8 @@ Connect to the MariaDB server on the given host\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: keys option
.\" keys option: mysqlshow
.\" mariadb-show: keys option
.\" keys option: mariadb-show
\fB\-\-keys\fR,
\fB\-k\fR
.sp
@ -343,8 +343,8 @@ Show table indexes\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: no-defaults option
.\" no-defaults option: mysqlshow
.\" mariadb-show: no-defaults option
.\" no-defaults option: mariadb-show
\fB\-\-no\-defaults\fR
.sp
Do not read default options from any option file\&. This must be given as the
@ -359,8 +359,8 @@ first argument\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: password option
.\" password option: mysqlshow
.\" mariadb-show: password option
.\" password option: mariadb-show
\fB\-\-password[=\fR\fB\fIpassword\fR\fR\fB]\fR,
\fB\-p[\fR\fB\fIpassword\fR\fR\fB]\fR
.sp
@ -373,7 +373,7 @@ value following the
or
\fB\-p\fR
option on the command line,
\fBmysqlshow\fR
\fBmariadb-show\fR
prompts for one\&.
.sp
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\&.
@ -387,8 +387,8 @@ Specifying a password on the command line should be considered insecure\&. You c
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: pipe option
.\" pipe option: mysqlshow
.\" mariadb-show: pipe option
.\" pipe option: mariadb-show
\fB\-\-pipe\fR,
\fB\-W\fR
.sp
@ -403,8 +403,8 @@ On Windows, connect to the server via a named pipe\&. This option applies only i
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: plugin-dir option
.\" plugin-dir option: mysqlshow
.\" mariadb-show: plugin-dir option
.\" plugin-dir option: mariadb-show
\fB\-\-plugin\-dir=\fIdir_name\fR
.sp
Directory for client-side plugins\&.
@ -418,8 +418,8 @@ Directory for client-side plugins\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: port option
.\" port option: mysqlshow
.\" mariadb-show: port option
.\" port option: mariadb-show
\fB\-\-port=\fR\fB\fIport_num\fR\fR,
\fB\-P \fR\fB\fIport_num\fR\fR
.sp
@ -435,8 +435,8 @@ Forces --protocol=tcp when specified on the command line without other connectio
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: protocol option
.\" protocol option: mysqlshow
.\" mariadb-show: protocol option
.\" protocol option: mariadb-show
\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\&.
@ -450,8 +450,8 @@ The connection protocol to use for connecting to the server\&. It is useful when
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: print-defaults option
.\" print-defaults option: mysqlshow
.\" mariadb-show: print-defaults option
.\" print-defaults option: mariadb-show
\fB\-\-print\-defaults\fR
.sp
Print the program argument list and exit\&.
@ -466,8 +466,8 @@ This must be given as the first argument\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: show-table-type option
.\" show-table-type option: mysqlshow
.\" mariadb-show: show-table-type option
.\" show-table-type option: mariadb-show
\fB\-\-show\-table\-type\fR,
\fB\-t\fR
.sp
@ -486,8 +486,8 @@ VIEW\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: socket option
.\" socket option: mysqlshow
.\" mariadb-show: socket option
.\" socket option: mariadb-show
\fB\-\-socket=\fR\fB\fIpath\fR\fR,
\fB\-S \fR\fB\fIpath\fR\fR
.sp
@ -504,8 +504,8 @@ Forces --protocol=socket when specified on the command line without other connec
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: SSL options
.\" SSL options: mysqlshow
.\" mariadb-show: SSL options
.\" SSL options: mariadb-show
\fB\-\-ssl\fR
.sp
Enable SSL for connection (automatically enabled with other flags). Disable with
@ -520,8 +520,8 @@ Enable SSL for connection (automatically enabled with other flags). Disable with
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: SSL CA option
.\" SSL CA option: mysqlshow
.\" mariadb-show: SSL CA option
.\" SSL CA option: mariadb-show
\fB\-\-ssl\-ca=\fIname\fR
.sp
CA file in PEM format (check OpenSSL docs, implies
@ -536,8 +536,8 @@ CA file in PEM format (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: SSL CA Path option
.\" SSL CA Path option: mysqlshow
.\" mariadb-show: SSL CA Path option
.\" SSL CA Path option: mariadb-show
\fB\-\-ssl\-capath=\fIname\fR
.sp
CA directory (check OpenSSL docs, implies
@ -552,8 +552,8 @@ CA directory (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: SSL Cert option
.\" SSL Cert option: mysqlshow
.\" mariadb-show: SSL Cert option
.\" SSL Cert option: mariadb-show
\fB\-\-ssl\-cert=\fIname\fR
.sp
X509 cert in PEM format (check OpenSSL docs, implies
@ -568,8 +568,8 @@ X509 cert in PEM format (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: SSL Cipher option
.\" SSL Cipher option: mysqlshow
.\" mariadb-show: SSL Cipher option
.\" SSL Cipher option: mariadb-show
\fB\-\-ssl\-cipher=\fIname\fR
.sp
SSL cipher to use (check OpenSSL docs, implies
@ -584,8 +584,8 @@ SSL cipher to use (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: SSL Key option
.\" SSL Key option: mysqlshow
.\" mariadb-show: SSL Key option
.\" SSL Key option: mariadb-show
\fB\-\-ssl\-key=\fIname\fR
.sp
X509 key in PEM format (check OpenSSL docs, implies
@ -600,8 +600,8 @@ X509 key in PEM format (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: SSL Crl option
.\" SSL CRL option: mysqlshow
.\" mariadb-show: SSL Crl option
.\" SSL CRL option: mariadb-show
\fB\-\-ssl\-crl=\fIname\fR
.sp
Certificate revocation list (check OpenSSL docs, implies
@ -616,8 +616,8 @@ Certificate revocation list (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: SSL Crlpath option
.\" SSL Crlpath option: mysqlshow
.\" mariadb-show: SSL Crlpath option
.\" SSL Crlpath option: mariadb-show
\fB\-\-ssl\-crlpath=\fIname\fR
.sp
Certificate revocation list path (check OpenSSL docs, implies
@ -632,8 +632,8 @@ Certificate revocation list path (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: SSL Verify Server Cert option
.\" SSL Verify Server Cert option: mysqlshow
.\" mariadb-show: SSL Verify Server Cert option
.\" SSL Verify Server Cert option: mariadb-show
\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\&.
@ -647,8 +647,8 @@ Verify server's "Common Name" in its cert against hostname used when connecting.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: status option
.\" status option: mysqlshow
.\" mariadb-show: status option
.\" status option: mariadb-show
\fB\-\-status\fR,
\fB\-i\fR
.sp
@ -663,8 +663,8 @@ Display extra information about each table\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: user option
.\" user option: mysqlshow
.\" mariadb-show: user option
.\" user option: mariadb-show
\fB\-\-user=\fR\fB\fIuser_name\fR\fR,
\fB\-u \fR\fB\fIuser_name\fR\fR
.sp
@ -679,8 +679,8 @@ The MariaDB user name to use when connecting to the server\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: verbose option
.\" verbose option: mysqlshow
.\" mariadb-show: verbose option
.\" verbose option: mariadb-show
\fB\-\-verbose\fR,
\fB\-v\fR
.sp
@ -695,8 +695,8 @@ Verbose mode\&. Print more information about what the program does\&. This optio
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: version option
.\" version option: mysqlshow
.\" mariadb-show: version option
.\" version option: mariadb-show
\fB\-\-version\fR,
\fB\-V\fR
.sp
@ -705,7 +705,7 @@ Display version information and exit\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

286
man/mariadb-slap.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADB-SLAP\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-SLAP\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,27 +11,27 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysqlslap
.\" mariadb-slap
.\" load emulation
.SH "NAME"
mariadb-slap \- load emulation client (mysqlslap is now a symlink to mariadb-slap)
mariadb-slap \- load emulation client (mariadb-slap is now a symlink to mariadb-slap)
.SH "SYNOPSIS"
.HP \w'\fBmysqlslap\ [\fR\fB\fIoptions\fR\fR\fB]\fR\ 'u
\fBmysqlslap [\fR\fB\fIoptions\fR\fR\fB]\fR
.HP \w'\fBmariadb-slap\ [\fR\fB\fIoptions\fR\fR\fB]\fR\ 'u
\fBmariadb-slap [\fR\fB\fIoptions\fR\fR\fB]\fR
.SH "DESCRIPTION"
.PP
\fBmysqlslap\fR
\fBmariadb-slap\fR
is a diagnostic program designed to emulate client load for a MariaDB server and to report the timing of each stage\&. It works as if multiple clients are accessing the server\&.
.PP
Invoke
\fBmysqlslap\fR
\fBmariadb-slap\fR
like this:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysqlslap [\fR\fB\fIoptions\fR\fR\fB]\fR
shell> \fBmariadb-slap [\fR\fB\fIoptions\fR\fR\fB]\fR
.fi
.if n \{\
.RE
@ -44,10 +44,10 @@ or
enable you to specify a string containing an SQL statement or a file containing statements\&. If you specify a file, by default it must contain one statement per line\&. (That is, the implicit statement delimiter is the newline character\&.) Use the
\fB\-\-delimiter\fR
option to specify a different delimiter, which enables you to specify statements that span multiple lines or place multiple statements on a single line\&. You cannot include comments in a file;
\fBmysqlslap\fR
\fBmariadb-slap\fR
does not understand them\&.
.PP
\fBmysqlslap\fR
\fBmariadb-slap\fR
runs in three stages:
.sp
.RS 4
@ -91,7 +91,7 @@ Supply your own create and query SQL statements, with 50 clients querying and 20
.RS 4
.\}
.nf
mysqlslap \-\-delimiter=";" \e
mariadb-slap \-\-delimiter=";" \e
\-\-create="CREATE TABLE a (b int);INSERT INTO a VALUES (23)" \e
\-\-query="SELECT * FROM a" \-\-concurrency=50 \-\-iterations=200
.fi
@ -100,7 +100,7 @@ mysqlslap \-\-delimiter=";" \e
.\}
.PP
Let
\fBmysqlslap\fR
\fBmariadb-slap\fR
build the query SQL statement with a table of two
INT
columns and three
@ -111,7 +111,7 @@ columns\&. Use five clients querying 20 times each\&. Do not create the table or
.RS 4
.\}
.nf
mysqlslap \-\-concurrency=5 \-\-iterations=20 \e
mariadb-slap \-\-concurrency=5 \-\-iterations=20 \e
\-\-number\-int\-cols=2 \-\-number\-char\-cols=3 \e
\-\-auto\-generate\-sql
.fi
@ -129,7 +129,7 @@ then run all the queries in the query file with five clients (five times each):
.RS 4
.\}
.nf
mysqlslap \-\-concurrency=5 \e
mariadb-slap \-\-concurrency=5 \e
\-\-iterations=5 \-\-query=query\&.sql \-\-create=create\&.sql \e
\-\-delimiter=";"
.fi
@ -137,13 +137,13 @@ mysqlslap \-\-concurrency=5 \e
.RE
.\}
.PP
\fBmysqlslap\fR
\fBmariadb-slap\fR
supports the following options, which can be specified on the command line or in the
[mysqlslap]
[mariadb-slap]
and
[client]
option file groups\&.
\fBmysqlslap\fR
\fBmariadb-slap\fR
also supports the options for processing option files\&.
.sp
.RS 4
@ -154,8 +154,8 @@ also supports the options for processing option files\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: help option
.\" help option: mysqlslap
.\" mariadb-slap: help option
.\" help option: mariadb-slap
\fB\-\-help\fR,
\fB\-?\fR
.sp
@ -170,8 +170,8 @@ Display a help message and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: auto-generate-sql option
.\" auto-generate-sql option: mysqlslap
.\" mariadb-slap: auto-generate-sql option
.\" auto-generate-sql option: mariadb-slap
\fB\-\-auto\-generate\-sql\fR,
\fB\-a\fR
.sp
@ -186,8 +186,8 @@ Generate SQL statements automatically when they are not supplied in files or via
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: auto-generate-sql-add-autoincrement option
.\" auto-generate-sql-add-autoincrement option: mysqlslap
.\" mariadb-slap: auto-generate-sql-add-autoincrement option
.\" auto-generate-sql-add-autoincrement option: mariadb-slap
\fB\-\-auto\-generate\-sql\-add\-autoincrement\fR
.sp
Add an
@ -203,8 +203,8 @@ column to automatically generated tables\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: auto-generate-sql-execute-number option
.\" auto-generate-sql-execute-number option: mysqlslap
.\" mariadb-slap: auto-generate-sql-execute-number option
.\" auto-generate-sql-execute-number option: mariadb-slap
\fB\-\-auto\-generate\-sql\-execute\-number=\fR\fB\fIN\fR\fR
.sp
Specify how many queries to generate automatically\&.
@ -218,8 +218,8 @@ Specify how many queries to generate automatically\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: auto-generate-sql-guid-primary option
.\" auto-generate-sql-guid-primary option: mysqlslap
.\" mariadb-slap: auto-generate-sql-guid-primary option
.\" auto-generate-sql-guid-primary option: mariadb-slap
\fB\-\-auto\-generate\-sql\-guid\-primary\fR
.sp
Add a GUID\-based primary key to automatically generated tables\&.
@ -233,8 +233,8 @@ Add a GUID\-based primary key to automatically generated tables\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: auto-generate-sql-load-type option
.\" auto-generate-sql-load-type option: mysqlslap
.\" mariadb-slap: auto-generate-sql-load-type option
.\" auto-generate-sql-load-type option: mariadb-slap
\fB\-\-auto\-generate\-sql\-load\-type=\fR\fB\fItype\fR\fR
.sp
Specify the test load type\&. The allowable values are
@ -259,8 +259,8 @@ mixed\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: auto-generate-sql-secondary-indexes option
.\" auto-generate-sql-secondary-indexes option: mysqlslap
.\" mariadb-slap: auto-generate-sql-secondary-indexes option
.\" auto-generate-sql-secondary-indexes option: mariadb-slap
\fB\-\-auto\-generate\-sql\-secondary\-indexes=\fR\fB\fIN\fR\fR
.sp
Specify how many secondary indexes to add to automatically generated tables\&. By default, none are added\&.
@ -274,8 +274,8 @@ Specify how many secondary indexes to add to automatically generated tables\&. B
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: auto-generate-sql-unique-query-number option
.\" auto-generate-sql-unique-query-number option: mysqlslap
.\" mariadb-slap: auto-generate-sql-unique-query-number option
.\" auto-generate-sql-unique-query-number option: mariadb-slap
\fB\-\-auto\-generate\-sql\-unique\-query\-number=\fR\fB\fIN\fR\fR
.sp
How many different queries to generate for automatic tests\&. For example, if you run a
@ -291,8 +291,8 @@ test that performs 1000 selects, you can use this option with a value of 1000 to
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: auto-generate-sql-unique-write-number option
.\" auto-generate-sql-unique-write-number option: mysqlslap
.\" mariadb-slap: auto-generate-sql-unique-write-number option
.\" auto-generate-sql-unique-write-number option: mariadb-slap
\fB\-\-auto\-generate\-sql\-unique\-write\-number=\fR\fB\fIN\fR\fR
.sp
How many different queries to generate for
@ -307,8 +307,8 @@ How many different queries to generate for
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: auto-generate-sql-write-number option
.\" auto-generate-sql-write-number option: mysqlslap
.\" mariadb-slap: auto-generate-sql-write-number option
.\" auto-generate-sql-write-number option: mariadb-slap
\fB\-\-auto\-generate\-sql\-write\-number=\fR\fB\fIN\fR\fR
.sp
How many row inserts to perform on each thread\&. The default is 100\&.
@ -322,8 +322,8 @@ How many row inserts to perform on each thread\&. The default is 100\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: commit option
.\" commit option: mysqlslap
.\" mariadb-slap: commit option
.\" commit option: mariadb-slap
\fB\-\-commit=\fR\fB\fIN\fR\fR
.sp
How many statements to execute before committing\&. The default is 0 (no commits are done)\&.
@ -337,8 +337,8 @@ How many statements to execute before committing\&. The default is 0 (no commits
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: compress option
.\" compress option: mysqlslap
.\" mariadb-slap: compress option
.\" compress option: mariadb-slap
\fB\-\-compress\fR,
\fB\-C\fR
.sp
@ -353,8 +353,8 @@ Compress all information sent between the client and the server if both support
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: concurrency option
.\" concurrency option: mysqlslap
.\" mariadb-slap: concurrency option
.\" concurrency option: mariadb-slap
\fB\-\-concurrency=\fR\fB\fIN\fR\fR,
\fB\-c \fR\fB\fIN\fR\fR
.sp
@ -371,8 +371,8 @@ statement\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: create option
.\" create option: mysqlslap
.\" mariadb-slap: create option
.\" create option: mariadb-slap
\fB\-\-create=\fR\fB\fIvalue\fR\fR
.sp
The file or string containing the statement to use for creating the table\&.
@ -386,8 +386,8 @@ The file or string containing the statement to use for creating the table\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: create-schema option
.\" create-schema option: mysqlslap
.\" mariadb-slap: create-schema option
.\" create-schema option: mariadb-slap
\fB\-\-create\-schema=\fR\fB\fIvalue\fR\fR
.sp
The schema in which to run the tests\&.
@ -401,8 +401,8 @@ The schema in which to run the tests\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: csv option
.\" csv option: mysqlslap
.\" mariadb-slap: csv option
.\" csv option: mariadb-slap
\fB\-\-csv[=\fR\fB\fIfile_name\fR\fR\fB]\fR
.sp
Generate output in comma\-separated values format\&. The output goes to the named file, or to the standard output if no file is given\&.
@ -416,14 +416,14 @@ Generate output in comma\-separated values format\&. The output goes to the name
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: debug option
.\" debug option: mysqlslap
.\" mariadb-slap: debug option
.\" debug option: mariadb-slap
\fB\-\-debug[=\fR\fB\fIdebug_options\fR\fR\fB]\fR,
\fB\-# [\fR\fB\fIdebug_options\fR\fR\fB]\fR
.sp
Write a debugging log\&. A typical
\fIdebug_options\fR
string is 'd:t:o,\fIfile_name\fR'. The default is 'd:t:o,/tmp/mysqlslap.trace'.
string is 'd:t:o,\fIfile_name\fR'. The default is 'd:t:o,/tmp/mariadb-slap.trace'.
.RE
.sp
.RS 4
@ -434,8 +434,8 @@ string is 'd:t:o,\fIfile_name\fR'. The default is 'd:t:o,/tmp/mysqlslap.trace'.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: debug-check option
.\" debug-check option: mysqlslap
.\" mariadb-slap: debug-check option
.\" debug-check option: mariadb-slap
\fB\-\-debug\-check\fR
.sp
Print some debugging information when the program exits\&.
@ -449,8 +449,8 @@ Print some debugging information when the program exits\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: debug-info option
.\" debug-info option: mysqlslap
.\" mariadb-slap: debug-info option
.\" debug-info option: mariadb-slap
\fB\-\-debug\-info\fR,
\fB\-T\fR
.sp
@ -465,8 +465,8 @@ Print debugging information and memory and CPU usage statistics when the program
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: default-auth option
.\" default-auth option: mysqlslap
.\" mariadb-slap: default-auth option
.\" default-auth option: mariadb-slap
\fB\-\-default\-auth=\fR\fB\fIname\fR
.sp
Default authentication client-side plugin to use\&.
@ -480,8 +480,8 @@ Default authentication client-side plugin to use\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: defaults-extra-file option
.\" defaults-extra-file option: mysqlslap
.\" mariadb-slap: defaults-extra-file option
.\" defaults-extra-file option: mariadb-slap
\fB\-\-defaults\-extra\-file=\fR\fB\fIfilename\fR\fR
.sp
Set \fB\fIfilename\fR\fR as the file to read default options from after the global defaults files has been
@ -496,8 +496,8 @@ read\&. Must be given as first option\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: defaults-file option
.\" defaults-file option: mysqlslap
.\" mariadb-slap: defaults-file option
.\" defaults-file option: mariadb-slap
\fB\-\-defaults\-file=\fR\fB\fIfilename\fR\fR
.sp
Set \fB\fIfilename\fR\fR as the file to read default options from, override global defaults files\&.
@ -512,8 +512,8 @@ Must be given as first option\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: delimiter option
.\" delimiter option: mysqlslap
.\" mariadb-slap: delimiter option
.\" delimiter option: mariadb-slap
\fB\-\-delimiter=\fR\fB\fIstr\fR\fR,
\fB\-F \fR\fB\fIstr\fR\fR
.sp
@ -528,8 +528,8 @@ The delimiter to use in SQL statements supplied in files or via command options\
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: detach option
.\" detach option: mysqlslap
.\" mariadb-slap: detach option
.\" detach option: mariadb-slap
\fB\-\-detach=\fR\fB\fIN\fR\fR
.sp
Detach (close and reopen) each connection after each
@ -545,8 +545,8 @@ statements\&. The default is 0 (connections are not detached)\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: engine option
.\" engine option: mysqlslap
.\" mariadb-slap: engine option
.\" engine option: mariadb-slap
\fB\-\-engine=\fR\fB\fIengine_name\fR\fR,
\fB\-e \fR\fB\fIengine_name\fR\fR
.sp
@ -563,8 +563,8 @@ each engine\&. You can also specify an option for an engine after a colon, for e
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: host option
.\" host option: mysqlslap
.\" mariadb-slap: host option
.\" host option: mariadb-slap
\fB\-\-host=\fR\fB\fIhost_name\fR\fR,
\fB\-h \fR\fB\fIhost_name\fR\fR
.sp
@ -579,8 +579,8 @@ Connect to the MariaDB server on the given host\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: init-command option
.\" init-command option: mysqlslap
.\" mariadb-slap: init-command option
.\" init-command option: mariadb-slap
\fB\-\-init\-command=str\fR
.sp
SQL Command to execute when connecting to MariaDB server\&. Will automatically be re\-executed when reconnecting\&.
@ -594,8 +594,8 @@ SQL Command to execute when connecting to MariaDB server\&. Will automatically b
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: iterations option
.\" iterations option: mysqlslap
.\" mariadb-slap: iterations option
.\" iterations option: mariadb-slap
\fB\-\-iterations=\fR\fB\fIN\fR\fR,
\fB\-i \fR\fB\fIN\fR\fR
.sp
@ -610,8 +610,8 @@ The number of times to run the tests\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: no-defaults option
.\" no-defaults option: mysqlslap
.\" mariadb-slap: no-defaults option
.\" no-defaults option: mariadb-slap
\fB\-\-no\-defaults\fR
.sp
Do not read default options from any option file\&. This must be given as the
@ -626,8 +626,8 @@ first argument\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: no-drop option
.\" no-drop option: mysqlslap
.\" mariadb-slap: no-drop option
.\" no-drop option: mariadb-slap
\fB\-\-no\-drop\fR
.sp
Do not drop any schema created during the test after the test is complete\&.
@ -641,8 +641,8 @@ Do not drop any schema created during the test after the test is complete\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: number-char-cols option
.\" number-char-cols option: mysqlslap
.\" mariadb-slap: number-char-cols option
.\" number-char-cols option: mariadb-slap
\fB\-\-number\-char\-cols=\fR\fB\fIN\fR\fR,
\fB\-x \fR\fB\fIN\fR\fR
.sp
@ -661,8 +661,8 @@ is specified\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: number-int-cols option
.\" number-int-cols option: mysqlslap
.\" mariadb-slap: number-int-cols option
.\" number-int-cols option: mariadb-slap
\fB\-\-number\-int\-cols=\fR\fB\fIN\fR\fR,
\fB\-y \fR\fB\fIN\fR\fR
.sp
@ -681,12 +681,12 @@ is specified\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: number-of-queries option
.\" number-of-queries option: mysqlslap
.\" mariadb-slap: number-of-queries option
.\" number-of-queries option: mariadb-slap
\fB\-\-number\-of\-queries=\fR\fB\fIN\fR\fR
.sp
Limit each client to approximately this many queries\&. Query counting takes into account the statement delimiter\&. For example, if you invoke
\fBmysqlslap\fR
\fBmariadb-slap\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\&.
@ -695,7 +695,7 @@ delimiter is recognized so that each instance of the query string counts as two
.RS 4
.\}
.nf
shell> \fBmysqlslap \-\-delimiter=";" \-\-number\-of\-queries=10\fR
shell> \fBmariadb-slap \-\-delimiter=";" \-\-number\-of\-queries=10\fR
\fB\-\-query="use test;insert into t values(null)"\fR
.fi
.if n \{\
@ -711,12 +711,12 @@ shell> \fBmysqlslap \-\-delimiter=";" \-\-number\-of\-queries=10\fR
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: only-print option
.\" only-print option: mysqlslap
.\" mariadb-slap: only-print option
.\" only-print option: mariadb-slap
\fB\-\-only\-print\fR
.sp
Do not connect to databases\&.
\fBmysqlslap\fR
\fBmariadb-slap\fR
only prints what it would have done\&.
.RE
.sp
@ -728,8 +728,8 @@ only prints what it would have done\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: password option
.\" password option: mysqlslap
.\" mariadb-slap: password option
.\" password option: mariadb-slap
\fB\-\-password[=\fR\fB\fIpassword\fR\fR\fB]\fR,
\fB\-p[\fR\fB\fIpassword\fR\fR\fB]\fR
.sp
@ -742,7 +742,7 @@ value following the
or
\fB\-p\fR
option on the command line,
\fBmysqlslap\fR
\fBmariadb-slap\fR
prompts for one\&.
.sp
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\&.
@ -756,8 +756,8 @@ Specifying a password on the command line should be considered insecure\&. You c
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: pipe option
.\" pipe option: mysqlslap
.\" mariadb-slap: pipe option
.\" pipe option: mariadb-slap
\fB\-\-pipe\fR,
\fB\-W\fR
.sp
@ -772,8 +772,8 @@ On Windows, connect to the server via a named pipe\&. This option applies only i
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: plugin-dir option
.\" plugin-dir option: mysqlslap
.\" mariadb-slap: plugin-dir option
.\" plugin-dir option: mariadb-slap
\fB\-\-plugin\-dir=\fIdir_name\fR
.sp
Directory for client-side plugins\&.
@ -787,8 +787,8 @@ Directory for client-side plugins\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: port option
.\" port option: mysqlslap
.\" mariadb-slap: port option
.\" port option: mariadb-slap
\fB\-\-port=\fR\fB\fIport_num\fR\fR,
\fB\-P \fR\fB\fIport_num\fR\fR
.sp
@ -804,8 +804,8 @@ Forces --protocol=tcp when specified on the command line without other connectio
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: post-query option
.\" post-query option: mysqlslap
.\" mariadb-slap: post-query option
.\" post-query option: mariadb-slap
\fB\-\-post\-query=\fR\fB\fIvalue\fR\fR
.sp
The file or string containing the statement to execute after the tests have completed\&. This execution is not counted for timing purposes\&.
@ -819,8 +819,8 @@ The file or string containing the statement to execute after the tests have comp
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: post-system option
.\" post-system option: mysqlslap
.\" mariadb-slap: post-system option
.\" post-system option: mariadb-slap
\fB\-\-post\-system=\fR\fB\fIstr\fR\fR
.sp
The string to execute via
@ -836,8 +836,8 @@ after the tests have completed\&. This execution is not counted for timing purpo
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: pre-query option
.\" pre-query option: mysqlslap
.\" mariadb-slap: pre-query option
.\" pre-query option: mariadb-slap
\fB\-\-pre\-query=\fR\fB\fIvalue\fR\fR
.sp
The file or string containing the statement to execute before running the tests\&. This execution is not counted for timing purposes\&.
@ -851,8 +851,8 @@ The file or string containing the statement to execute before running the tests\
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: pre-system option
.\" pre-system option: mysqlslap
.\" mariadb-slap: pre-system option
.\" pre-system option: mariadb-slap
\fB\-\-pre\-system=\fR\fB\fIstr\fR\fR
.sp
The string to execute via
@ -868,8 +868,8 @@ before running the tests\&. This execution is not counted for timing purposes\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: print-defaults option
.\" print-defaults option: mysqlslap
.\" mariadb-slap: print-defaults option
.\" print-defaults option: mariadb-slap
\fB\-\-print\-defaults\fR
.sp
Print the program argument list and exit\&.
@ -884,8 +884,8 @@ This must be given as the first argument\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: protocol option
.\" protocol option: mysqlslap
.\" mariadb-slap: protocol option
.\" protocol option: mariadb-slap
\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\&.
@ -899,8 +899,8 @@ The connection protocol to use for connecting to the server\&. It is useful when
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: query option
.\" query option: mysqlslap
.\" mariadb-slap: query option
.\" query option: mariadb-slap
\fB\-\-query=\fR\fB\fIvalue\fR\fR,
\fB\-q \fR\fB\fIvalue\fR\fR
.sp
@ -917,8 +917,8 @@ statement to use for retrieving data\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: shared-memory-base-name option
.\" shared-memory-base-name option: mysqlslap
.\" mariadb-slap: shared-memory-base-name option
.\" shared-memory-base-name option: mariadb-slap
\fB\-\-shared\-memory\-base\-name=\fR\fB\fIname\fR\fR
.sp
On Windows, the shared\-memory name to use, for connections made via shared memory to a local server\&. This option applies only if the server supports shared\-memory connections\&.
@ -932,8 +932,8 @@ On Windows, the shared\-memory name to use, for connections made via shared memo
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: silent option
.\" silent option: mysqlslap
.\" mariadb-slap: silent option
.\" silent option: mariadb-slap
\fB\-\-silent\fR,
\fB\-s\fR
.sp
@ -948,8 +948,8 @@ Silent mode\&. No output\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: socket option
.\" socket option: mysqlslap
.\" mariadb-slap: socket option
.\" socket option: mariadb-slap
\fB\-\-socket=\fR\fB\fIpath\fR\fR,
\fB\-S \fR\fB\fIpath\fR\fR
.sp
@ -966,8 +966,8 @@ Forces --protocol=socket when specified on the command line without other connec
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: SSL options
.\" SSL options: mysqlshow
.\" mariadb-slap: SSL options
.\" SSL options: mariadb-slap
\fB\-\-ssl\fR
.sp
Enable SSL for connection (automatically enabled with other flags). Disable with
@ -982,8 +982,8 @@ Enable SSL for connection (automatically enabled with other flags). Disable with
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: SSL CA option
.\" SSL CA option: mysqlshow
.\" mariadb-slap: SSL CA option
.\" SSL CA option: mariadb-slap
\fB\-\-ssl\-ca=\fIname\fR
.sp
CA file in PEM format (check OpenSSL docs, implies
@ -998,8 +998,8 @@ CA file in PEM format (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: SSL CA Path option
.\" SSL CA Path option: mysqlshow
.\" mariadb-slap: SSL CA Path option
.\" SSL CA Path option: mariadb-slap
\fB\-\-ssl\-capath=\fIname\fR
.sp
CA directory (check OpenSSL docs, implies
@ -1014,8 +1014,8 @@ CA directory (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: SSL Cert option
.\" SSL Cert option: mysqlshow
.\" mariadb-slap: SSL Cert option
.\" SSL Cert option: mariadb-slap
\fB\-\-ssl\-cert=\fIname\fR
.sp
X509 cert in PEM format (check OpenSSL docs, implies
@ -1030,8 +1030,8 @@ X509 cert in PEM format (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: SSL Cipher option
.\" SSL Cipher option: mysqlshow
.\" mariadb-slap: SSL Cipher option
.\" SSL Cipher option: mariadb-slap
\fB\-\-ssl\-cipher=\fIname\fR
.sp
SSL cipher to use (check OpenSSL docs, implies
@ -1046,8 +1046,8 @@ SSL cipher to use (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: SSL Key option
.\" SSL Key option: mysqlshow
.\" mariadb-slap: SSL Key option
.\" SSL Key option: mariadb-slap
\fB\-\-ssl\-key=\fIname\fR
.sp
X509 key in PEM format (check OpenSSL docs, implies
@ -1062,8 +1062,8 @@ X509 key in PEM format (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: SSL Crl option
.\" SSL CRL option: mysqlshow
.\" mariadb-slap: SSL Crl option
.\" SSL CRL option: mariadb-slap
\fB\-\-ssl\-crl=\fIname\fR
.sp
Certificate revocation list (check OpenSSL docs, implies
@ -1078,8 +1078,8 @@ Certificate revocation list (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: SSL Crlpath option
.\" SSL Crlpath option: mysqlshow
.\" mariadb-slap: SSL Crlpath option
.\" SSL Crlpath option: mariadb-slap
\fB\-\-ssl\-crlpath=\fIname\fR
.sp
Certificate revocation list path (check OpenSSL docs, implies
@ -1094,8 +1094,8 @@ Certificate revocation list path (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlshow: SSL Verify Server Cert option
.\" SSL Verify Server Cert option: mysqlshow
.\" mariadb-slap: SSL Verify Server Cert option
.\" SSL Verify Server Cert option: mariadb-slap
\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\&.
@ -1109,8 +1109,8 @@ Verify server's "Common Name" in its cert against hostname used when connecting.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: user option
.\" user option: mysqlslap
.\" mariadb-slap: user option
.\" user option: mariadb-slap
\fB\-\-user=\fR\fB\fIuser_name\fR\fR,
\fB\-u \fR\fB\fIuser_name\fR\fR
.sp
@ -1125,8 +1125,8 @@ The MariaDB user name to use when connecting to the server\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: verbose option
.\" verbose option: mysqlslap
.\" mariadb-slap: verbose option
.\" verbose option: mariadb-slap
\fB\-\-verbose\fR,
\fB\-v\fR
.sp
@ -1141,8 +1141,8 @@ Verbose mode\&. Print more information about what the program does\&. This optio
.sp -1
.IP \(bu 2.3
.\}
.\" mysqlslap: version option
.\" version option: mysqlslap
.\" mariadb-slap: version option
.\" version option: mariadb-slap
\fB\-\-version\fR,
\fB\-V\fR
.sp
@ -1151,7 +1151,7 @@ Display version information and exit\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

288
man/mariadb-test.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADB-TEST\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-TEST\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,34 +11,34 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysqltest
.\" mysqltest_embedded
.\" mariadb-test
.\" mariadb-test-embedded
.SH "NAME"
mariadb-test \- program to run test cases (mysqltest is now a symlink to mariadb-test)
mariadb-test \- program to run test cases (mariadb-test is now a symlink to mariadb-test)
.br
mysqltest_embedded \- program to run embedded test cases
mariadb-test-embedded \- program to run embedded test cases
.SH "SYNOPSIS"
.HP \w'\fBmysqltest\ [\fR\fB\fIoptions\fR\fR\fB]\ [\fR\fB\fIdb_name\fR\fR\fB]\fR\ 'u
\fBmysqltest [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIdb_name\fR\fR\fB]\fR
.HP \w'\fBmysqltest_embedded\ [\fR\fB\fIoptions\fR\fR\fB]\ [\fR\fB\fIdb_name\fR\fR\fB]\fR\ 'u
\fBmysqltest_embedded [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIdb_name\fR\fR\fB]\fR
.HP \w'\fBmariadb-test\ [\fR\fB\fIoptions\fR\fR\fB]\ [\fR\fB\fIdb_name\fR\fR\fB]\fR\ 'u
\fBmariadb-test [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIdb_name\fR\fR\fB]\fR
.HP \w'\fBmariadb-test-embedded\ [\fR\fB\fIoptions\fR\fR\fB]\ [\fR\fB\fIdb_name\fR\fR\fB]\fR\ 'u
\fBmariadb-test-embedded [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIdb_name\fR\fR\fB]\fR
.SH "DESCRIPTION"
.PP
The
\fBmysqltest\fR
\fBmariadb-test\fR
program runs a test case against a MariaDB server and optionally compares the output with a result file\&. This program reads input written in a special test language\&. Typically, you invoke
\fBmysqltest\fR
\fBmariadb-test\fR
via
\fBmysql\-test\-run\&.pl\fR
\fBmariadb\-test\-run\&.pl\fR
rather than invoking it directly\&.
.PP
\fBmysqltest_embedded\fR
\fBmariadb-test-embedded\fR
is similar but is built with support for the
libmysqld
libmariadbd
embedded server\&.
.PP
Features of
\fBmysqltest\fR:
\fBmariadb-test\fR:
.sp
.RS 4
.ie n \{\
@ -82,7 +82,7 @@ Can test whether the result from an SQL statement or shell command is as expecte
.IP \(bu 2.3
.\}
Can connect to one or more standalone
\fBmysqld\fR
\fBmariadbd\fR
servers and switch between connections
.RE
.sp
@ -94,24 +94,24 @@ servers and switch between connections
.sp -1
.IP \(bu 2.3
.\}
Can connect to an embedded server (libmysqld), if MariaDB is compiled with support for
libmysqld\&. (In this case, the executable is named
\fBmysqltest_embedded\fR
Can connect to an embedded server (libmariadbd), if MariaDB is compiled with support for
libmariadbd\&. (In this case, the executable is named
\fBmariadb-test-embedded\fR
rather than
\fBmysqltest\fR\&.)
\fBmariadb-test\fR\&.)
.RE
.PP
By default,
\fBmysqltest\fR
\fBmariadb-test\fR
reads the test case on the standard input\&. To run
\fBmysqltest\fR
\fBmariadb-test\fR
this way, you normally invoke it like this:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysqltest [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIdb_name\fR\fR\fB] < \fR\fB\fItest_file\fR\fR
shell> \fBmariadb-test [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIdb_name\fR\fR\fB] < \fR\fB\fItest_file\fR\fR
.fi
.if n \{\
.RE
@ -122,10 +122,10 @@ You can also name the test case file with a
option\&.
.PP
The exit value from
\fBmysqltest\fR
\fBmariadb-test\fR
is 0 for success, 1 for failure, and 62 if it skips the test case (for example, if after checking some preconditions it decides not to run the test)\&.
.PP
\fBmysqltest\fR
\fBmariadb-test\fR
supports the following options:
.sp
.RS 4
@ -136,8 +136,8 @@ supports the following options:
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: help option
.\" help option: mysqltest
.\" mariadb-test: help option
.\" help option: mariadb-test
\fB\-\-help\fR,
\fB\-?\fR
.sp
@ -152,8 +152,8 @@ Display a help message and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: basedir option
.\" basedir option: mysqltest
.\" mariadb-test: basedir option
.\" basedir option: mariadb-test
\fB\-\-basedir=\fR\fB\fIdir_name\fR\fR,
\fB\-b \fR\fB\fIdir_name\fR\fR
.sp
@ -168,8 +168,8 @@ The base directory for tests\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: character-sets-dir option
.\" character-sets-dir option: mysqltest
.\" mariadb-test: character-sets-dir option
.\" character-sets-dir option: mariadb-test
\fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR
.sp
The directory where character sets are installed\&.
@ -183,8 +183,8 @@ The directory where character sets are installed\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: compress option
.\" compress option: mysqltest
.\" mariadb-test: compress option
.\" compress option: mariadb-test
\fB\-\-compress\fR,
\fB\-C\fR
.sp
@ -199,8 +199,8 @@ Compress all information sent between the client and the server if both support
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: connect-timeout option
.\" connect-timeout option: mysqltest
.\" mariadb-test: connect-timeout option
.\" connect-timeout option: mariadb-test
\fB\-\-connect\-timeout=\fInum\fR
.sp
This can be used to set the MYSQL_OPT_CONNECT_TIMEOUT parameter of mysql_options to change the number of seconds before an unsuccessful connection attempt times out\&.
@ -214,8 +214,8 @@ This can be used to set the MYSQL_OPT_CONNECT_TIMEOUT parameter of mysql_options
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: continue-on-error option
.\" continue-on-error option: mysqltest
.\" mariadb-test: continue-on-error option
.\" continue-on-error option: mariadb-test
\fB\-\-continue\-on\-error\fR
.sp
Continue test even if we got an error\&. This is mostly
@ -232,8 +232,8 @@ a newly created big test file\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: cursor-protocol option
.\" cursor-protocol option: mysqltest
.\" mariadb-test: cursor-protocol option
.\" cursor-protocol option: mariadb-test
\fB\-\-cursor\-protocol\fR
.sp
Use cursors for prepared statements\&.
@ -247,8 +247,8 @@ Use cursors for prepared statements\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: database option
.\" database option: mysqltest
.\" mariadb-test: database option
.\" database option: mariadb-test
\fB\-\-database=\fR\fB\fIdb_name\fR\fR,
\fB\-D \fR\fB\fIdb_name\fR\fR
.sp
@ -263,14 +263,14 @@ The default database to use\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: debug option
.\" debug option: mysqltest
.\" mariadb-test: debug option
.\" debug option: mariadb-test
\fB\-\-debug[=\fR\fB\fIdebug_options\fR\fR\fB]\fR,
\fB\-#[\fR\fB\fIdebug_options\fR\fR\fB]\fR
.sp
Write a debugging log if MariaDB is built with debugging support\&. The default
\fIdebug_options\fR
value is 'd:t:S:i:O,/tmp/mysqltest.trace'.
value is 'd:t:S:i:O,/tmp/mariadb-test.trace'.
.RE
.sp
.RS 4
@ -281,8 +281,8 @@ value is 'd:t:S:i:O,/tmp/mysqltest.trace'.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: debug-check option
.\" debug-check option: mysqltest
.\" mariadb-test: debug-check option
.\" debug-check option: mariadb-test
\fB\-\-debug\-check\fR
.sp
Print some debugging information when the program exits\&.
@ -296,8 +296,8 @@ Print some debugging information when the program exits\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: debug-info option
.\" debug-info option: mysqltest
.\" mariadb-test: debug-info option
.\" debug-info option: mariadb-test
\fB\-\-debug\-info\fR
.sp
Print debugging information and memory and CPU usage statistics when the program exits\&.
@ -311,8 +311,8 @@ Print debugging information and memory and CPU usage statistics when the program
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: host option
.\" host option: mysqltest
.\" mariadb-test: host option
.\" host option: mariadb-test
\fB\-\-host=\fR\fB\fIhost_name\fR\fR,
\fB\-h \fR\fB\fIhost_name\fR\fR
.sp
@ -327,8 +327,8 @@ Connect to the MariaDB server on the given host\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: logdir option
.\" logdir option: mysqltest
.\" mariadb-test: logdir option
.\" logdir option: mariadb-test
\fB\-\-logdir=\fR\fB\fIdir_name\fR\fR
.sp
The directory to use for log files\&.
@ -342,8 +342,8 @@ The directory to use for log files\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: mark-progress option
.\" mark-progress option: mysqltest
.\" mariadb-test: mark-progress option
.\" mark-progress option: mariadb-test
\fB\-\-mark\-progress\fR
.sp
Write the line number and elapsed time to
@ -358,8 +358,8 @@ Write the line number and elapsed time to
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: max-connect-retries option
.\" max-connect-retries option: mysqltest
.\" mariadb-test: max-connect-retries option
.\" max-connect-retries option: mariadb-test
\fB\-\-max\-connect\-retries=\fR\fB\fInum\fR\fR
.sp
The maximum number of connection attempts when connecting to server\&.
@ -373,8 +373,8 @@ The maximum number of connection attempts when connecting to server\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: max-connections option
.\" max-connections option: mysqltest
.\" mariadb-test: max-connections option
.\" max-connections option: mariadb-test
\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\&.
@ -388,8 +388,8 @@ The maximum number of simultaneous server connections per client (that is, per t
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: no-defaults option
.\" no-defaults option: mysqltest
.\" mariadb-test: no-defaults option
.\" no-defaults option: mariadb-test
\fB\-\-no\-defaults\fR
.sp
Do not read default options from any option files\&. If used, this must be the first option\&.
@ -403,8 +403,8 @@ Do not read default options from any option files\&. If used, this must be the f
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: non-blocking-api option
.\" non-blocking-api option: mysqltest
.\" mariadb-test: non-blocking-api option
.\" non-blocking-api option: mariadb-test
\fB\-\-non\-blocking\-api\fR
.sp
Use the non-blocking client API for communication\&.
@ -418,8 +418,8 @@ Use the non-blocking client API for communication\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: overlay-dir option
.\" overlay-dir option: mysqltest
.\" mariadb-test: overlay-dir option
.\" overlay-dir option: mariadb-test
\fB\-\-overlay\-dir=\fIdir_name\fR
.sp
Overlay directory\&.
@ -433,8 +433,8 @@ Overlay directory\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: password option
.\" password option: mysqltest
.\" mariadb-test: password option
.\" password option: mariadb-test
\fB\-\-password[=\fR\fB\fIpassword\fR\fR\fB]\fR,
\fB\-p[\fR\fB\fIpassword\fR\fR\fB]\fR
.sp
@ -457,8 +457,8 @@ option on the command line, you are prompted for one\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: plugin-dir option
.\" plugin-dir option: mysqltest
.\" mariadb-test: plugin-dir option
.\" plugin-dir option: mariadb-test
\fB\-\-plugin\-dir=\fIdir_name\fR
.sp
Directory for client-side plugins\&.
@ -472,8 +472,8 @@ Directory for client-side plugins\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: port option
.\" port option: mysqltest
.\" mariadb-test: port option
.\" port option: mariadb-test
\fB\-\-port=\fR\fB\fIport_num\fR\fR,
\fB\-P \fR\fB\fIport_num\fR\fR
.sp
@ -489,12 +489,12 @@ my.cnf, $MYSQL_TCP_PORT, /etc/services, built-in default (3306)\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: prologue option
.\" prologue option: mysqltest
.\" mariadb-test: prologue option
.\" prologue option: mariadb-test
\fB\-\-prologue=\fR\fB\fIname\fR\fR
.sp
Include the contents of the given file before processing the contents of the test file\&. The included file should have the same format as other
\fBmysqltest\fR
\fBmariadb-test\fR
test files\&. This option has the same effect as putting a
\-\-source \fIfile_name\fR
command as the first line of the test file\&.
@ -508,8 +508,8 @@ command as the first line of the test file\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: protocol option
.\" protocol option: mysqltest
.\" mariadb-test: protocol option
.\" protocol option: mariadb-test
\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\&.
@ -523,8 +523,8 @@ The connection protocol to use for connecting to the server\&. It is useful when
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: ps-protocol option
.\" ps-protocol option: mysqltest
.\" mariadb-test: ps-protocol option
.\" ps-protocol option: mariadb-test
\fB\-\-ps\-protocol\fR
.sp
Use the prepared\-statement protocol for communication\&.
@ -538,13 +538,13 @@ Use the prepared\-statement protocol for communication\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: quiet option
.\" quiet option: mysqltest
.\" mariadb-test: quiet option
.\" quiet option: mariadb-test
\fB\-\-quiet\fR
.sp
Suppress all normal output\&. This is a synonym for
.\" mysqltest: silent option
.\" silent option: mysqltest
.\" mariadb-test: silent option
.\" silent option: mariadb-test
\fB\-\-silent\fR\&.
.RE
.sp
@ -556,8 +556,8 @@ Suppress all normal output\&. This is a synonym for
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: record option
.\" record option: mysqltest
.\" mariadb-test: record option
.\" record option: mariadb-test
\fB\-\-record\fR,
\fB\-r\fR
.sp
@ -575,15 +575,15 @@ option, if that option is given\&. It is an error to use this option without als
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: result-file option
.\" result-file option: mysqltest
.\" mariadb-test: result-file option
.\" result-file option: mariadb-test
\fB\-\-result\-file=\fR\fB\fIfile_name\fR\fR,
\fB\-R \fR\fB\fIfile_name\fR\fR
.sp
This option specifies the file for test case expected results\&.
\fB\-\-result\-file\fR, together with
\fB\-\-record\fR, determines how
\fBmysqltest\fR
\fBmariadb-test\fR
treats the test actual and expected results for a test case:
.sp
.RS 4
@ -595,7 +595,7 @@ treats the test actual and expected results for a test case:
.IP \(bu 2.3
.\}
If the test produces no results,
\fBmysqltest\fR
\fBmariadb-test\fR
exits with an error message to that effect, unless
\fB\-\-result\-file\fR
is given and the named file is an empty file\&.
@ -612,7 +612,7 @@ is given and the named file is an empty file\&.
Otherwise, if
\fB\-\-result\-file\fR
is not given,
\fBmysqltest\fR
\fBmariadb-test\fR
sends test results to the standard output\&.
.RE
.sp
@ -628,9 +628,9 @@ With
\fB\-\-result\-file\fR
but not
\fB\-\-record\fR,
\fBmysqltest\fR
\fBmariadb-test\fR
reads the expected results from the given file and compares them with the actual results\&. If the results do not match,
\fBmysqltest\fR
\fBmariadb-test\fR
writes a
\&.reject
file in the same directory as the result file, outputs a diff of the two files, and exits with an error\&.
@ -648,7 +648,7 @@ With both
\fB\-\-result\-file\fR
and
\fB\-\-record\fR,
\fBmysqltest\fR
\fBmariadb-test\fR
updates the given file by writing the actual test results to it\&.
.RE
.RE
@ -661,8 +661,8 @@ updates the given file by writing the actual test results to it\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: result-format-version option
.\" result-format-version option: mysqltest
.\" mariadb-test: result-format-version option
.\" result-format-version option: mariadb-test
\fB\-\-result\-format\-version=\fI#\fR
.sp
Version of the result file format to use\&.
@ -676,8 +676,8 @@ Version of the result file format to use\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: server-arg option
.\" server-arg option: mysqltest
.\" mariadb-test: server-arg option
.\" server-arg option: mariadb-test
\fB\-\-server\-arg=\fR\fB\fIvalue\fR\fR,
\fB\-A \fR\fB\fIvalue\fR\fR
.sp
@ -695,8 +695,8 @@ or
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: server-file option
.\" server-file option: mysqltest
.\" mariadb-test: server-file option
.\" server-file option: mariadb-test
\fB\-\-server\-file=\fR\fB\fIfile_name\fR\fR,
\fB\-F \fR\fB\fIfile_name\fR\fR
.sp
@ -711,8 +711,8 @@ Read arguments for the embedded server from the given file\&. The file should co
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: silent option
.\" silent option: mysqltest
.\" mariadb-test: silent option
.\" silent option: mariadb-test
\fB\-\-silent\fR,
\fB\-s\fR
.sp
@ -727,8 +727,8 @@ Suppress all normal output\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: sleep option
.\" sleep option: mysqltest
.\" mariadb-test: sleep option
.\" sleep option: mariadb-test
\fB\-\-sleep=\fR\fB\fInum\fR\fR,
\fB\-T \fR\fB\fInum\fR\fR
.sp
@ -752,8 +752,8 @@ commands in the test case\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: socket option
.\" socket option: mysqltest
.\" mariadb-test: socket option
.\" socket option: mariadb-test
\fB\-\-socket=\fR\fB\fIpath\fR\fR,
\fB\-S \fR\fB\fIpath\fR\fR
.sp
@ -770,12 +770,12 @@ localhost
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: sp-protocol option
.\" sp-protocol option: mysqltest
.\" mariadb-test: sp-protocol option
.\" sp-protocol option: mariadb-test
\fB\-\-sp\-protocol\fR
.sp
Execute DML statements within a stored procedure\&. For every DML statement,
\fBmysqltest\fR
\fBmariadb-test\fR
creates and invokes a stored procedure that executes the statement rather than executing the statement directly\&.
.RE
.sp
@ -787,8 +787,8 @@ creates and invokes a stored procedure that executes the statement rather than e
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: SSL options
.\" SSL options: mysqltest
.\" mariadb-test: SSL options
.\" SSL options: mariadb-test
\fB\-\-ssl\fR
.sp
Enable SSL for connection (automatically enabled with other flags). Disable with
@ -803,8 +803,8 @@ Enable SSL for connection (automatically enabled with other flags). Disable with
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: SSL CA option
.\" SSL CA option: mysqltest
.\" mariadb-test: SSL CA option
.\" SSL CA option: mariadb-test
\fB\-\-ssl\-ca=\fIname\fR
.sp
CA file in PEM format (check OpenSSL docs, implies
@ -819,8 +819,8 @@ CA file in PEM format (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: SSL CA Path option
.\" SSL CA Path option: mysqltest
.\" mariadb-test: SSL CA Path option
.\" SSL CA Path option: mariadb-test
\fB\-\-ssl\-capath=\fIname\fR
.sp
CA directory (check OpenSSL docs, implies
@ -835,8 +835,8 @@ CA directory (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: SSL Cert option
.\" SSL Cert option: mysqltest
.\" mariadb-test: SSL Cert option
.\" SSL Cert option: mariadb-test
\fB\-\-ssl\-cert=\fIname\fR
.sp
X509 cert in PEM format (check OpenSSL docs, implies
@ -851,8 +851,8 @@ X509 cert in PEM format (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: SSL Cipher option
.\" SSL Cipher option: mysqltest
.\" mariadb-test: SSL Cipher option
.\" SSL Cipher option: mariadb-test
\fB\-\-ssl\-cipher=\fIname\fR
.sp
SSL cipher to use (check OpenSSL docs, implies
@ -867,8 +867,8 @@ SSL cipher to use (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: SSL Key option
.\" SSL Key option: mysqltest
.\" mariadb-test: SSL Key option
.\" SSL Key option: mariadb-test
\fB\-\-ssl\-key=\fIname\fR
.sp
X509 key in PEM format (check OpenSSL docs, implies
@ -883,8 +883,8 @@ X509 key in PEM format (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: SSL Crl option
.\" SSL CRL option: mysqltest
.\" mariadb-test: SSL Crl option
.\" SSL CRL option: mariadb-test
\fB\-\-ssl\-crl=\fIname\fR
.sp
Certificate revocation list (check OpenSSL docs, implies
@ -899,8 +899,8 @@ Certificate revocation list (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: SSL Crlpath option
.\" SSL Crlpath option: mysqltest
.\" mariadb-test: SSL Crlpath option
.\" SSL Crlpath option: mariadb-test
\fB\-\-ssl\-crlpath=\fIname\fR
.sp
Certificate revocation list path (check OpenSSL docs, implies
@ -915,8 +915,8 @@ Certificate revocation list path (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: SSL Verify Server Cert option
.\" SSL Verify Server Cert option: mysqltest
.\" mariadb-test: SSL Verify Server Cert option
.\" SSL Verify Server Cert option: mariadb-test
\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\&.
@ -930,8 +930,8 @@ Verify server's "Common Name" in its cert against hostname used when connecting.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: suite-dir option
.\" suite-dir option: mysqltest
.\" mariadb-test: suite-dir option
.\" suite-dir option: mariadb-test
\fB\-\-suite\-dir=\fIdir_name\fR
.sp
Suite directory\&.
@ -945,8 +945,8 @@ Suite directory\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: tail-lines option
.\" tail-lines option: mysqltest
.\" mariadb-test: tail-lines option
.\" tail-lines option: mariadb-test
\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\&.
@ -960,8 +960,8 @@ Specify how many lines of the result to include in the output if the test fails
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: test-file option
.\" test-file option: mysqltest
.\" mariadb-test: test-file option
.\" test-file option: mariadb-test
\fB\-\-test\-file=\fR\fB\fIfile_name\fR\fR,
\fB\-x \fR\fB\fIfile_name\fR\fR
.sp
@ -976,13 +976,13 @@ Read test input from this file\&. The default is to read from the standard input
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: timer-file option
.\" timer-file option: mysqltest
.\" mariadb-test: timer-file option
.\" timer-file option: mariadb-test
\fB\-\-timer\-file=\fR\fB\fIfile_name\fR\fR,
\fB\-m \fR\fB\fIfile_name\fR\fR
.sp
If given, the number of microseconds spent running the test will be written to this file\&. This is used by
\fBmysql\-test\-run\&.pl\fR
\fBmariadb\-test\-run\&.pl\fR
for its reporting\&.
.RE
.sp
@ -994,8 +994,8 @@ for its reporting\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: tmpdir option
.\" tmpdir option: mysqltest
.\" mariadb-test: tmpdir option
.\" tmpdir option: mariadb-test
\fB\-\-tmpdir=\fR\fB\fIdir_name\fR\fR,
\fB\-t \fR\fB\fIdir_name\fR\fR
.sp
@ -1010,8 +1010,8 @@ The temporary directory where socket files are created\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: user option
.\" user option: mysqltest
.\" mariadb-test: user option
.\" user option: mariadb-test
\fB\-\-user=\fR\fB\fIuser_name\fR\fR,
\fB\-u \fR\fB\fIuser_name\fR\fR
.sp
@ -1026,8 +1026,8 @@ The MariaDB user name to use when connecting to the server\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: verbose option
.\" verbose option: mysqltest
.\" mariadb-test: verbose option
.\" verbose option: mariadb-test
\fB\-\-verbose\fR,
\fB\-v\fR
.sp
@ -1042,8 +1042,8 @@ Verbose mode\&. Print out more information about what the program does\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: version option
.\" version option: mysqltest
.\" mariadb-test: version option
.\" version option: mariadb-test
\fB\-\-version\fR,
\fB\-V\fR
.sp
@ -1058,8 +1058,8 @@ Display version information and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqltest: view-protocol option
.\" view-protocol option: mysqltest
.\" mariadb-test: view-protocol option
.\" view-protocol option: mariadb-test
\fB\-\-view\-protocol\fR
.sp
Every
@ -1069,7 +1069,7 @@ statement is wrapped inside a view\&.
.SH "COPYRIGHT"
.br
.PP
Copyright \(co 2007, 2010, Oracle and/or its affiliates, 2010-2020 MariaDB Foundation
Copyright \(co 2007, 2010, Oracle and/or its affiliates, 2010-2024 MariaDB Foundation
.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

46
man/mariadb-tzinfo-to-sql.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADB-TZINFO-TO-SQL\fR" "1" "22 April 2022" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-TZINFO-TO-SQL\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,17 +11,17 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysql_tzinfo_to_sql
.\" mariadb-tzinfo-to-sql
.\" time zone tables
.SH "NAME"
mariadb-tzinfo-to-sql \- load the time zone tables (mysql_tzinfo_to_sql is now a symlink to mariadb-tzinfo-to-sql)
mariadb-tzinfo-to-sql \- load the time zone tables (mariadb-tzinfo-to-sql is now a symlink to mariadb-tzinfo-to-sql)
.SH "SYNOPSIS"
.HP \w'\fBmysql_tzinfo_to_sql\ \fR\fB\fIarguments\fR\fR\ 'u
\fBmysql_tzinfo_to_sql \fR\fB\fIarguments\fR\fR
.HP \w'\fBmariadb-tzinfo-to-sql\ \fR\fB\fIarguments\fR\fR\ 'u
\fBmariadb-tzinfo-to-sql \fR\fB\fIarguments\fR\fR
.SH "DESCRIPTION"
.PP
The
\fBmysql_tzinfo_to_sql\fR
\fBmariadb-tzinfo-to-sql\fR
program loads the time zone tables in the
mysql
database\&. It is used on systems that have a
@ -31,45 +31,45 @@ database (the set of files describing time zones)\&. Examples of such systems ar
directory (/usr/share/lib/zoneinfo
on Solaris)\&.
.PP
\fBmysql_tzinfo_to_sql\fR
\fBmariadb-tzinfo-to-sql\fR
can be invoked several ways:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysql_tzinfo_to_sql \fR\fB\fItz_dir\fR\fR
shell> \fBmysql_tzinfo_to_sql \fR\fB\fItz_file tz_name\fR\fR
shell> \fBmysql_tzinfo_to_sql \-\-leap \fR\fB\fItz_file\fR\fR
shell> \fBmysql_tzinfo_to_sql \-\-skip\-write\-binlog \fR\fB\fItz_dir\fR\fR
shell> \fBmariadb-tzinfo-to-sql \fR\fB\fItz_dir\fR\fR
shell> \fBmariadb-tzinfo-to-sql \fR\fB\fItz_file tz_name\fR\fR
shell> \fBmariadb-tzinfo-to-sql \-\-leap \fR\fB\fItz_file\fR\fR
shell> \fBmariadb-tzinfo-to-sql \-\-skip\-write\-binlog \fR\fB\fItz_dir\fR\fR
.fi
.if n \{\
.RE
.\}
.PP
For the first invocation syntax, pass the zoneinfo directory path name to
\fBmysql_tzinfo_to_sql\fR
\fBmariadb-tzinfo-to-sql\fR
and send the output into the
\fBmysql\fR
\fBmariadb\fR
program\&. For example:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysql_tzinfo_to_sql /usr/share/zoneinfo | mysql \-u root mysql\fR
shell> \fBmariadb-tzinfo-to-sql /usr/share/zoneinfo | mariadb \-u root mysql\fR
.fi
.if n \{\
.RE
.\}
.PP
\fBmysql_tzinfo_to_sql\fR
\fBmariadb-tzinfo-to-sql\fR
reads your system's time zone files and generates SQL statements from them\&.
\fBmysql\fR
\fBmariadb\fR
processes those statements to load the time zone tables\&.
.PP
The second syntax causes
\fBmysql_tzinfo_to_sql\fR
\fBmariadb-tzinfo-to-sql\fR
to load a single time zone file
\fItz_file\fR
that corresponds to a time zone name
@ -79,14 +79,14 @@ that corresponds to a time zone name
.RS 4
.\}
.nf
shell> \fBmysql_tzinfo_to_sql \fR\fB\fItz_file\fR\fR\fB \fR\fB\fItz_name\fR\fR\fB | mysql \-u root mysql\fR
shell> \fBmariadb-tzinfo-to-sql \fR\fB\fItz_file\fR\fR\fB \fR\fB\fItz_name\fR\fR\fB | mariadb \-u root mysql\fR
.fi
.if n \{\
.RE
.\}
.PP
If your time zone needs to account for leap seconds, invoke
\fBmysql_tzinfo_to_sql\fR
\fBmariadb-tzinfo-to-sql\fR
using the third syntax, which initializes the leap second information\&.
\fItz_file\fR
is the name of your time zone file:
@ -95,21 +95,21 @@ is the name of your time zone file:
.RS 4
.\}
.nf
shell> \fBmysql_tzinfo_to_sql \-\-leap \fR\fB\fItz_file\fR\fR\fB | mysql \-u root mysql\fR
shell> \fBmariadb-tzinfo-to-sql \-\-leap \fR\fB\fItz_file\fR\fR\fB | mariadb \-u root mysql\fR
.fi
.if n \{\
.RE
.\}
.PP
Using the \-\-skip\-write\-binlog option prevents writing of changes to the binary log or to other Galera
cluster members. This can be used with any form of running \fBmysql_tzinfo_to_sql\fR.
cluster members. This can be used with any form of running \fBmariadb-tzinfo-to-sql\fR.
.PP
After running
\fBmysql_tzinfo_to_sql\fR, it is best to restart the server so that it does not continue to use any previously cached time zone data\&.
\fBmariadb-tzinfo-to-sql\fR, it is best to restart the server so that it does not continue to use any previously cached time zone data\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

210
man/mariadb-upgrade.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADB-UPGRADE\fR" "1" "20 July 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-UPGRADE\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,26 +11,26 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysql_upgrade
.\" upgrading MySQL
.\" MySQL: upgrading
.\" mariadb-upgrade
.\" upgrading MariaDB
.\" MariaDB: upgrading
.SH "NAME"
mariadb-upgrade \- check tables for MariaDB upgrade (mysql_upgrade is now a symlink to mariadb-upgrade)
mariadb-upgrade \- check tables for MariaDB upgrade (mariadb-upgrade is now a symlink to mariadb-upgrade)
.SH "SYNOPSIS"
.HP \w'\fBmysql_upgrade\ [\fR\fB\fIoptions\fR\fR\fB]\fR\ 'u
\fBmysql_upgrade [\fR\fB\fIoptions\fR\fR\fB]\fR
.HP \w'\fBmariadb-upgrade\ [\fR\fB\fIoptions\fR\fR\fB]\fR\ 'u
\fBmariadb-upgrade [\fR\fB\fIoptions\fR\fR\fB]\fR
.SH "DESCRIPTION"
.PP
\fBmysql_upgrade\fR
\fBmariadb-upgrade\fR
examines all tables in all databases for incompatibilities with the current version of the MariaDB Server\&.
\fBmysql_upgrade\fR
\fBmariadb-upgrade\fR
also upgrades the system tables so that you can take advantage of new privileges or capabilities that might have been added\&.
.PP
\fBmysql_upgrade\fR
\fBmariadb-upgrade\fR
should be executed each time you upgrade MariaDB\&.
.PP
If a table is found to have a possible incompatibility,
\fBmysql_upgrade\fR
\fBmariadb-upgrade\fR
performs a table check\&. If any problems are found, a table repair is attempted\&.
.if n \{\
.sp
@ -46,7 +46,7 @@ performs a table check\&. If any problems are found, a table repair is attempted
.br
.PP
On Windows Server 2008 and Windows Vista, you must run
\fBmysql_upgrade\fR
\fBmariadb-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
@ -70,31 +70,31 @@ performing an upgrade\&.
.RE
.PP
To use
\fBmysql_upgrade\fR, make sure that the server is running, and then invoke it like this:
\fBmariadb-upgrade\fR, make sure that the server is running, and then invoke it like this:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysql_upgrade [\fR\fB\fIoptions\fR\fR\fB]\fR
shell> \fBmariadb-upgrade [\fR\fB\fIoptions\fR\fR\fB]\fR
.fi
.if n \{\
.RE
.\}
.PP
After running
\fBmysql_upgrade\fR, stop the server and restart it so that any changes made to the system tables take effect\&.
\fBmariadb-upgrade\fR, stop the server and restart it so that any changes made to the system tables take effect\&.
.PP
\fBmysql_upgrade\fR
\fBmariadb-upgrade\fR
executes the following commands to check and repair tables and to upgrade the system tables:
.sp
.if n \{\
.RS 4
.\}
.nf
mysqlcheck \-\-all\-databases \-\-check\-upgrade \-\-auto\-repair
mysql < \fIfix_priv_tables\fR
mysqlcheck \-\-all\-databases \-\-check\-upgrade \-\-fix\-db\-names \-\-fix\-table\-names
mariadb-check \-\-all\-databases \-\-check\-upgrade \-\-auto\-repair
mariadb < \fIfix_priv_tables\fR
mariadb-check \-\-all\-databases \-\-check\-upgrade \-\-fix\-db\-names \-\-fix\-table\-names
.fi
.if n \{\
.RE
@ -111,9 +111,9 @@ Notes about the preceding commands:
.IP \(bu 2.3
.\}
Because
\fBmysql_upgrade\fR
\fBmariadb-upgrade\fR
invokes
\fBmysqlcheck\fR
\fBmariadb-check\fR
with the
\fB\-\-all\-databases\fR
option, it processes all tables in all databases, which might take a long time to complete\&. Each table is locked and therefore unavailable to other sessions while it is being processed\&. Check and repair operations can be time\-consuming, particularly for large tables\&.
@ -146,43 +146,43 @@ statement\&.
.\}
\fIfix_priv_tables\fR
represents a script generated internally by
\fBmysql_upgrade\fR
\fBmariadb-upgrade\fR
that contains SQL statements to upgrade the tables in the
mysql
database\&.
.RE
.PP
All checked and repaired tables are marked with the current MariaDB version number\&. This ensures that next time you run
\fBmysql_upgrade\fR
\fBmariadb-upgrade\fR
with the same version of the server, it can tell whether there is any need to check or repair the table again\&.
.\" mysql_upgrade_info file: mysql_upgrade
.\" mysql_upgrade: mysql_upgrade_info file
.\" mariadb-upgrade_info file: mariadb-upgrade
.\" mariadb-upgrade: mariadb-upgrade_info file
.PP
\fBmysql_upgrade\fR
\fBmariadb-upgrade\fR
also saves the MariaDB version number in a file named
mysql_upgrade_info
mariadb-upgrade_info
in the data directory\&. This is used to quickly check whether all tables have been checked for this release so that table\-checking can be skipped\&. To ignore this file and perform the check regardless, use the
\fB\-\-force\fR
option\&.
.PP
For this reason, \fBmysql_upgrade\fR needs to be run as a user with write access to the data directory\&.
For this reason, \fBmariadb-upgrade\fR needs to be run as a user with write access to the data directory\&.
.PP
If you install MariaDB from RPM packages on Linux, you must install the server and client RPMs\&.
\fBmysql_upgrade\fR
\fBmariadb-upgrade\fR
is included in the server RPM but requires the client RPM because the latter includes
\fBmysqlcheck\fR\&.
\fBmariadb-check\fR\&.
.PP
.PP
\fBmysql_upgrade\fR
\fBmariadb-upgrade\fR
supports the following options, which can be specified on the command line or in the
[mysql_upgrade]
[mariadb-upgrade]
and
[client]
option file groups\&. Other options are passed to
\fBmysqlcheck\fR\&. For example, it might be necessary to specify the
\fBmariadb-check\fR\&. For example, it might be necessary to specify the
\fB\-\-password[=\fR\fB\fIpassword\fR\fR\fB]\fR
option\&.
\fBmysql_upgrade\fR
\fBmariadb-upgrade\fR
also supports the options for processing option files\&.
.sp
.RS 4
@ -193,8 +193,8 @@ also supports the options for processing option files\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: help option
.\" help option: mysql_upgrade
.\" mariadb-upgrade: help option
.\" help option: mariadb-upgrade
\fB\-\-help\fR,
\fB\-?\fR
.sp
@ -209,8 +209,8 @@ Display a short help message and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: basedir option
.\" basedir option: mysql_upgrade
.\" mariadb-upgrade: basedir option
.\" basedir option: mariadb-upgrade
\fB\-\-basedir=\fR\fB\fIpath\fR\fR
.sp
Old option accepted for backward compatibility but ignored\&.
@ -224,8 +224,8 @@ Old option accepted for backward compatibility but ignored\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: character-sets-dir option
.\" character-sets-dir option: mysql_upgrade
.\" mariadb-upgrade: character-sets-dir option
.\" character-sets-dir option: mariadb-upgrade
\fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR
.sp
Old option accepted for backward compatibility but ignored\&.
@ -239,8 +239,8 @@ Old option accepted for backward compatibility but ignored\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: check-if-upgrade-is-needed option
.\" check-if-upgrade-is-needed option: mysql_upgrade
.\" mariadb-upgrade: check-if-upgrade-is-needed option
.\" check-if-upgrade-is-needed option: mariadb-upgrade
\fB\-\-check\-if\-upgrade\-is\-needed\fR
.sp
Exit with a status code indicating if an upgrade is needed\&. Returns 0 if upgrade needed or current version couldn't be determined, 1 when no action required\&.
@ -254,8 +254,8 @@ Exit with a status code indicating if an upgrade is needed\&. Returns 0 if upgra
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: datadir option
.\" datadir option: mysql_upgrade
.\" mariadb-upgrade: datadir option
.\" datadir option: mariadb-upgrade
\fB\-\-datadir=\fR\fB\fIpath\fR\fR
.sp
Old option accepted for backward compatibility but ignored\&.
@ -269,8 +269,8 @@ Old option accepted for backward compatibility but ignored\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: debug option
.\" debug option: mysql_upgrade
.\" mariadb-upgrade: debug option
.\" debug option: mariadb-upgrade
\fB\-\-debug=\fR\fB\fIpath\fR\fR,
\fB\-# \fIpath\fR\fR
.sp
@ -285,8 +285,8 @@ For debug builds, output debug log\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: debug-check option
.\" debug-check option: mysql_upgrade
.\" mariadb-upgrade: debug-check option
.\" debug-check option: mariadb-upgrade
\fB\-\-debug\-check\fR
.sp
Print some debugging information when the program exits\&.
@ -300,8 +300,8 @@ Print some debugging information when the program exits\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: debug-info option
.\" debug-info option: mysql_upgrade
.\" mariadb-upgrade: debug-info option
.\" debug-info option: mariadb-upgrade
\fB\-\-debug\-info\fR,
\fB\-T\fR
.sp
@ -316,8 +316,8 @@ Print debugging information and memory and CPU usage statistics when the program
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: default-character-set option
.\" default-character-set option: mysql_upgrade
.\" mariadb-upgrade: default-character-set option
.\" default-character-set option: mariadb-upgrade
\fB\-\-default\-character\-set=\fR\fB\fIname\fR\fR
.sp
Old option accepted for backward compatibility but ignored\&.
@ -331,16 +331,16 @@ Old option accepted for backward compatibility but ignored\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: force option
.\" force option: mysql_upgrade
.\" mariadb-upgrade: force option
.\" force option: mariadb-upgrade
\fB\-\-force\fR
.sp
Ignore the
mysql_upgrade_info
mariadb-upgrade_info
file and force execution of
\fBmysqlcheck\fR
\fBmariadb-check\fR
even if
\fBmysql_upgrade\fR
\fBmariadb-upgrade\fR
has already been executed for the current version of MariaDB\&.
.RE
.sp
@ -352,8 +352,8 @@ has already been executed for the current version of MariaDB\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: host option
.\" host option: mysql_upgrade
.\" mariadb-upgrade: host option
.\" host option: mariadb-upgrade
\fB\-\-host\fR
.sp
Connect to MariaDB on the given host\&.
@ -367,8 +367,8 @@ Connect to MariaDB on the given host\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: password option
.\" password option: mysql_upgrade
.\" mariadb-upgrade: password option
.\" password option: mariadb-upgrade
\fB\-\-password[=\fR\fB\fIpassword\fR\fR\fB]\fR,
\fB\-p[\fR\fB\fIpassword\fR\fR\fB]\fR
.sp
@ -381,7 +381,7 @@ value following the
or
\fB\-p\fR
option on the command line,
\fBmysql_upgrade\fR
\fBmariadb-upgrade\fR
prompts for one\&.
.sp
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\&.
@ -395,8 +395,8 @@ Specifying a password on the command line should be considered insecure\&. You c
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: port option
.\" port option: mysql_upgrade
.\" mariadb-upgrade: port option
.\" port option: mariadb-upgrade
\fB\-\-port=\fR\fB\fIport_num\fR\fR,
\fB\-P \fR\fB\fIport_num\fR\fR
.sp
@ -411,8 +411,8 @@ The TCP/IP port number to use for the connection\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: protocol option
.\" protocol option: mysql_upgrade
.\" mariadb-upgrade: protocol option
.\" protocol option: mariadb-upgrade
\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\&.
@ -426,8 +426,8 @@ The connection protocol to use for connecting to the server\&. It is useful when
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: silent option
.\" silent option: mysql_upgrade
.\" mariadb-upgrade: silent option
.\" silent option: mariadb-upgrade
\fB\-\-silent\fR
.sp
Print less information\&.
@ -441,8 +441,8 @@ Print less information\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: socket option
.\" socket option: mysql_upgrade
.\" mariadb-upgrade: socket option
.\" socket option: mariadb-upgrade
\fB\-\-socket=\fR\fB\fIpath\fR\fR,
\fB\-S \fR\fB\fIpath\fR\fR
.sp
@ -458,8 +458,8 @@ localhost, the Unix socket file to use, or, on Windows, the name of the named pi
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: SSL options
.\" SSL options: mysql_upgrade
.\" mariadb-upgrade: SSL options
.\" SSL options: mariadb-upgrade
\fB\-\-ssl\fR
.sp
Enable SSL for connection (automatically enabled with other flags). Disable with
@ -474,8 +474,8 @@ Enable SSL for connection (automatically enabled with other flags). Disable with
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: SSL CA option
.\" SSL CA option: mysql_upgrade
.\" mariadb-upgrade: SSL CA option
.\" SSL CA option: mariadb-upgrade
\fB\-\-ssl\-ca=\fIname\fR
.sp
CA file in PEM format (check OpenSSL docs, implies
@ -490,8 +490,8 @@ CA file in PEM format (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: SSL CA Path option
.\" SSL CA Path option: mysql_upgrade
.\" mariadb-upgrade: SSL CA Path option
.\" SSL CA Path option: mariadb-upgrade
\fB\-\-ssl\-capath=\fIname\fR
.sp
CA directory (check OpenSSL docs, implies
@ -506,8 +506,8 @@ CA directory (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: SSL Cert option
.\" SSL Cert option: mysql_upgrade
.\" mariadb-upgrade: SSL Cert option
.\" SSL Cert option: mariadb-upgrade
\fB\-\-ssl\-cert=\fIname\fR
.sp
X509 cert in PEM format (check OpenSSL docs, implies
@ -522,8 +522,8 @@ X509 cert in PEM format (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: SSL Cipher option
.\" SSL Cipher option: mysql_upgrade
.\" mariadb-upgrade: SSL Cipher option
.\" SSL Cipher option: mariadb-upgrade
\fB\-\-ssl\-cipher=\fIname\fR
.sp
SSL cipher to use (check OpenSSL docs, implies
@ -538,8 +538,8 @@ SSL cipher to use (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: SSL Key option
.\" SSL Key option: mysql_upgrade
.\" mariadb-upgrade: SSL Key option
.\" SSL Key option: mariadb-upgrade
\fB\-\-ssl\-key=\fIname\fR
.sp
X509 key in PEM format (check OpenSSL docs, implies
@ -554,8 +554,8 @@ X509 key in PEM format (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: SSL Crl option
.\" SSL CRL option: mysql_upgrade
.\" mariadb-upgrade: SSL Crl option
.\" SSL CRL option: mariadb-upgrade
\fB\-\-ssl\-crl=\fIname\fR
.sp
Certificate revocation list (check OpenSSL docs, implies
@ -570,8 +570,8 @@ Certificate revocation list (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: SSL Crlpath option
.\" SSL Crlpath option: mysql_upgrade
.\" mariadb-upgrade: SSL Crlpath option
.\" SSL Crlpath option: mariadb-upgrade
\fB\-\-ssl\-crlpath=\fIname\fR
.sp
Certificate revocation list path (check OpenSSL docs, implies
@ -586,8 +586,8 @@ Certificate revocation list path (check OpenSSL docs, implies
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: SSL Verify Server Cert option
.\" SSL Verify Server Cert option: mysql_upgrade
.\" mariadb-upgrade: SSL Verify Server Cert option
.\" SSL Verify Server Cert option: mariadb-upgrade
\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\&.
@ -601,8 +601,8 @@ Verify server's "Common Name" in its cert against hostname used when connecting.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: tmpdir option
.\" tmpdir option: mysql_upgrade
.\" mariadb-upgrade: tmpdir option
.\" tmpdir option: mariadb-upgrade
\fB\-\-tmpdir=\fR\fB\fIpath\fR\fR,
\fB\-t \fR\fB\fIpath\fR\fR
.sp
@ -617,8 +617,8 @@ The path name of the directory to use for creating temporary files\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: upgrade-system-tables option
.\" upgrade-system-tables option: mysql_upgrade
.\" mariadb-upgrade: upgrade-system-tables option
.\" upgrade-system-tables option: mariadb-upgrade
\fB\-\-upgrade\-system\-tables\fR\fR,
\fB\-s \fR
.sp
@ -633,8 +633,8 @@ Only upgrade the system tables in the mysql database\&. Tables in other database
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: user option
.\" user option: mysql_upgrade
.\" mariadb-upgrade: user option
.\" user option: mariadb-upgrade
\fB\-\-user=\fR\fB\fIuser_name\fR\fR,
\fB\-u \fR\fB\fIuser_name\fR\fR
.sp
@ -649,15 +649,15 @@ The MariaDB user name to use when connecting to the server and not using the cur
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: verbose option
.\" verbose option: mysql_upgrade
.\" mariadb-upgrade: verbose option
.\" verbose option: mariadb-upgrade
\fB\-\-verbose\fR
.sp
Display more output about the process\&. Using it twice will print connection
arguments; using it 3 times will print out all CHECK, RENAME and ALTER TABLE
commands used during the check phase; using it 4 times (added in MariaDB 10.0.14)
will also write out all mariadb-check commands used; using it 5 times will print all
the mariadb commands used and their results while running mysql_fix_privilege_tables script\&.
the mariadb commands used and their results while running mariadb-fix-privilege-tables script\&.
.RE
.sp
.RS 4
@ -668,8 +668,8 @@ the mariadb commands used and their results while running mysql_fix_privilege_ta
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: version option
.\" version option: mysql_upgrade
.\" mariadb-upgrade: version option
.\" version option: mariadb-upgrade
\fB\-\-version\fR,
\fB\-V\fR
.sp
@ -684,8 +684,8 @@ Output version information and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: version-check option
.\" version-check option: mysql_upgrade
.\" mariadb-upgrade: version-check option
.\" version-check option: mariadb-upgrade
\fB\-\-version\-check\fR,
\fB\-k\fR
.sp
@ -703,18 +703,18 @@ it was built/distributed. Defaults to on; use \fB\-\-skip\-version\-check\fR to
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_upgrade: write-binlog option
.\" write-binlog option: mysql_upgrade
.\" mariadb-upgrade: write-binlog option
.\" write-binlog option: mariadb-upgrade
\fB\-\-write\-binlog\fR
.sp
Cause binary logging to be enabled while
\fBmysql_upgrade\fR
\fBmariadb-upgrade\fR
runs\&.
.RE
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

38
man/mariadb-waitpid.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADB-WAITPID\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-WAITPID\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,34 +11,34 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysql_waitpid
.\" mariadb-waitpid
.SH "NAME"
mariadb-waitpid \- kill process and wait for its termination (mysql_waitpid is now a symlink to mariadb-waitpid)
mariadb-waitpid \- kill process and wait for its termination (mariadb-waitpid is now a symlink to mariadb-waitpid)
.SH "SYNOPSIS"
.HP \w'\fBmysql_waitpid\ [\fR\fB\fIoptions\fR\fR\fB]\ \fR\fB\fIpid\fR\fR\fB\ \fR\fB\fIwait_time\fR\fR\ 'u
\fBmysql_waitpid [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIpid\fR\fR\fB \fR\fB\fIwait_time\fR\fR
.HP \w'\fBmariadb-waitpid\ [\fR\fB\fIoptions\fR\fR\fB]\ \fR\fB\fIpid\fR\fR\fB\ \fR\fB\fIwait_time\fR\fR\ 'u
\fBmariadb-waitpid [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIpid\fR\fR\fB \fR\fB\fIwait_time\fR\fR
.SH "DESCRIPTION"
.PP
\fBmysql_waitpid\fR
\fBmariadb-waitpid\fR
signals a process to terminate and waits for the process to exit\&. It uses the
kill()
system call and Unix signals, so it runs on Unix and Unix\-like systems\&.
.PP
Invoke
\fBmysql_waitpid\fR
\fBmariadb-waitpid\fR
like this:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysql_waitpid [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIpid\fR\fR\fB \fR\fB\fIwait_time\fR\fR
shell> \fBmariadb-waitpid [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIpid\fR\fR\fB \fR\fB\fIwait_time\fR\fR
.fi
.if n \{\
.RE
.\}
.PP
\fBmysql_waitpid\fR
\fBmariadb-waitpid\fR
sends signal 0 to the process identified by
\fIpid\fR
and waits up to
@ -50,16 +50,16 @@ and
must be positive integers\&.
.PP
If process termination occurs within the wait time or the process does not exist,
\fBmysql_waitpid\fR
\fBmariadb-waitpid\fR
returns 0\&. Otherwise, it returns 1\&.
.PP
If the
kill()
system call cannot handle signal 0,
\fBmysql_waitpid()\fR
\fBmariadb-waitpid()\fR
uses signal 1 instead\&.
.PP
\fBmysql_waitpid\fR
\fBmariadb-waitpid\fR
supports the following options:
.sp
.RS 4
@ -70,8 +70,8 @@ supports the following options:
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_waitpid: help option
.\" help option: mysql_waitpid
.\" mariadb-waitpid: help option
.\" help option: mariadb-waitpid
\fB\-\-help\fR,
\fB\-?\fR,
\fB\-I\fR
@ -87,8 +87,8 @@ Display a help message and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_waitpid: verbose option
.\" verbose option: mysql_waitpid
.\" mariadb-waitpid: verbose option
.\" verbose option: mariadb-waitpid
\fB\-\-verbose\fR,
\fB\-v\fR
.sp
@ -103,8 +103,8 @@ Verbose mode\&. Display a warning if signal 0 could not be used and signal 1 is
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_waitpid: version option
.\" version option: mysql_waitpid
.\" mariadb-waitpid: version option
.\" version option: mariadb-waitpid
\fB\-\-version\fR,
\fB\-V\fR
.sp
@ -113,7 +113,7 @@ Display version information and exit\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

692
man/mariadb.1
View file

File diff suppressed because it is too large Load diff

74
man/mariadb_config.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMYSQL_CONFIG\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB-CONFIG\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,18 +11,18 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysql_config
.\" mariadb-dump
.SH "NAME"
mysql_config \- get compile options for compiling clients
mariadb-dump \- get compile options for compiling clients
.SH "SYNOPSIS"
.HP \w'\fBmysql_config\ \fR\fB\fIoptions\fR\fR\ 'u
\fBmysql_config \fR\fB\fIoptions\fR\fR
.HP \w'\fBmariadb-dump\ \fR\fB\fIoptions\fR\fR\ 'u
\fBmariadb-dump \fR\fB\fIoptions\fR\fR
.SH "DESCRIPTION"
.PP
\fBmysql_config\fR
\fBmariadb-dump\fR
provides you with useful information for compiling your MariaDB client and connecting it to MariaDB\&.
.PP
\fBmysql_config\fR
\fBmariadb-dump\fR
supports the following options\&.
.sp
.RS 4
@ -33,8 +33,8 @@ supports the following options\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_config: cflags option
.\" cflags option: mysql_config
.\" mariadb-dump: cflags option
.\" cflags option: mariadb-dump
\fB\-\-cflags\fR
.sp
Compiler flags to find include files and critical compiler flags and defines used when compiling the
@ -52,8 +52,8 @@ for more portable options that contain only include paths\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_config: include option
.\" include option: mysql_config
.\" mariadb-dump: include option
.\" include option: mariadb-dump
\fB\-\-include\fR
.sp
Compiler options to find MariaDB include files\&.
@ -67,10 +67,10 @@ Compiler options to find MariaDB include files\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_config: libmysqld-libs option
.\" libmysqld-libs option: mysql_config
.\" mysql_config: embedded option
.\" embedded option: mysql_config
.\" mariadb-dump: libmysqld-libs option
.\" libmysqld-libs option: mariadb-dump
.\" mariadb-dump: embedded option
.\" embedded option: mariadb-dump
\fB\-\-libmysqld\-libs\fR,
\fB\-\-embedded\fR
.sp
@ -85,8 +85,8 @@ Libraries and options required to link with the MariaDB embedded server\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_config: libs option
.\" libs option: mysql_config
.\" mariadb-dump: libs option
.\" libs option: mariadb-dump
\fB\-\-libs\fR
.sp
Libraries and options required to link with the MariaDB client library\&.
@ -100,8 +100,8 @@ Libraries and options required to link with the MariaDB client library\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_config: libs_r option
.\" libs_r option: mysql_config
.\" mariadb-dump: libs_r option
.\" libs_r option: mariadb-dump
\fB\-\-libs_r\fR
.sp
Libraries and options required to link with the thread\-safe MariaDB client library\&.
@ -115,8 +115,8 @@ Libraries and options required to link with the thread\-safe MariaDB client libr
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_config: plugindir option
.\" plugindir option: mysql_config
.\" mariadb-dump: plugindir option
.\" plugindir option: mariadb-dump
\fB\-\-plugindir\fR
.sp
The default plugin directory path name, defined when configuring MariaDB\&.
@ -130,8 +130,8 @@ The default plugin directory path name, defined when configuring MariaDB\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_config: port option
.\" port option: mysql_config
.\" mariadb-dump: port option
.\" port option: mariadb-dump
\fB\-\-port\fR
.sp
The default TCP/IP port number, defined when configuring MariaDB\&.
@ -145,8 +145,8 @@ The default TCP/IP port number, defined when configuring MariaDB\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_config: socket option
.\" socket option: mysql_config
.\" mariadb-dump: socket option
.\" socket option: mariadb-dump
\fB\-\-socket\fR
.sp
The default Unix socket file, defined when configuring MariaDB\&.
@ -160,8 +160,8 @@ The default Unix socket file, defined when configuring MariaDB\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_config: variable option
.\" variable option: mysql_config
.\" mariadb-dump: variable option
.\" variable option: mariadb-dump
\fB\-\-variable=VAR\fR
.sp
Path to MariaDB include, library and plugin directories\&. \fBVAR\fR is one of
@ -176,23 +176,23 @@ Path to MariaDB include, library and plugin directories\&. \fBVAR\fR is one of
.sp -1
.IP \(bu 2.3
.\}
.\" mysql_config: version option
.\" version option: mysql_config
.\" mariadb-dump: version option
.\" version option: mariadb-dump
\fB\-\-version\fR
.sp
Version number for the MariaDB distribution\&.
.RE
.PP
If you invoke
\fBmysql_config\fR
\fBmariadb-dump\fR
with no options, it displays a list of all options that it supports, and their values:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysql_config\fR
Usage: /usr/local/mysql/bin/mysql_config [options]
shell> \fBmariadb-dump\fR
Usage: /usr/local/mysql/bin/mariadb-dump [options]
Options:
\-\-cflags [\-I/usr/local/mysql/include/mysql \-mcpu=pentiumpro]
\-\-include [\-I/usr/local/mysql/include/mysql]
@ -211,16 +211,16 @@ Options:
.\}
.PP
You can use
\fBmysql_config\fR
\fBmariadb-dump\fR
within a command line to include the value that it displays for a particular option\&. For example, to compile a MariaDB client program, use
\fBmysql_config\fR
\fBmariadb-dump\fR
as follows:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBCFG=/usr/local/mysql/bin/mysql_config\fR
shell> \fBCFG=/usr/local/mysql/bin/mariadb-dump\fR
shell> \fBsh \-c "gcc \-o progname `$CFG \-\-include` progname\&.c `$CFG \-\-libs`"\fR
.fi
.if n \{\
@ -228,12 +228,12 @@ shell> \fBsh \-c "gcc \-o progname `$CFG \-\-include` progname\&.c `$CFG \-\-lib
.\}
.PP
When you use
\fBmysql_config\fR
\fBmariadb-dump\fR
this way, be sure to invoke it within backtick (\(lq`\(rq) characters\&. That tells the shell to execute it and substitute its output into the surrounding command\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

254
man/mariadbd-multi.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADBD-MULTI\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADBD-MULTI\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,25 +11,25 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysqld_multi
.\" tools: mysqld_multi
.\" mariadbd-multi
.\" tools: mariadbd-multi
.\" scripts
.\" multi mysqld
.\" multi mariadbd
.SH "NAME"
mariadbd-multi \- manage multiple MariaDB servers (mysqld_multi is now a symlink to mariadbd-multi)
mariadbd-multi \- manage multiple MariaDB servers (mariadbd-multi is now a symlink to mariadbd-multi)
.SH "SYNOPSIS"
.HP \w'\fBmysqld_multi\ [\fR\fB\fIoptions\fR\fR\fB]\ {start|stop|report}\ [\fR\fB\fIGNR\fR\fR\fB[,\fR\fB\fIGNR\fR\fR\fB]\ \&.\&.\&.]\fR\ 'u
\fBmysqld_multi [\fR\fB\fIoptions\fR\fR\fB] {start|stop|report} [\fR\fB\fIGNR\fR\fR\fB[,\fR\fB\fIGNR\fR\fR\fB] \&.\&.\&.]\fR
.HP \w'\fBmariadbd-multi\ [\fR\fB\fIoptions\fR\fR\fB]\ {start|stop|report}\ [\fR\fB\fIGNR\fR\fR\fB[,\fR\fB\fIGNR\fR\fR\fB]\ \&.\&.\&.]\fR\ 'u
\fBmariadbd-multi [\fR\fB\fIoptions\fR\fR\fB] {start|stop|report} [\fR\fB\fIGNR\fR\fR\fB[,\fR\fB\fIGNR\fR\fR\fB] \&.\&.\&.]\fR
.SH "DESCRIPTION"
.PP
\fBmysqld_multi\fR
\fBmariadbd-multi\fR
is designed to manage several
\fBmysqld\fR
\fBmariadbd\fR
processes that listen for connections on different Unix socket files and TCP/IP ports\&. It can start or stop servers, or report their current status\&.
.PP
\fBmysqld_multi\fR
\fBmariadbd-multi\fR
searches for groups named
[mysqld\fIN\fR]
[mariadbd\fIN\fR]
in
my\&.cnf
(or in the file named by the
@ -38,20 +38,20 @@ option)\&.
\fIN\fR
can be any positive integer\&. This number is referred to in the following discussion as the option group number, or
\fIGNR\fR\&. Group numbers distinguish option groups from one another and are used as arguments to
\fBmysqld_multi\fR
\fBmariadbd-multi\fR
to specify which servers you want to start, stop, or obtain a status report for\&. Options listed in these groups are the same that you would use in the
[mysqld]
[mariadbd]
group used for starting
\fBmysqld\fR\&. However, when using multiple servers, it is necessary that each one use its own value for options such as the Unix socket file and TCP/IP port number\&.
\fBmariadbd\fR\&. However, when using multiple servers, it is necessary that each one use its own value for options such as the Unix socket file and TCP/IP port number\&.
.PP
To invoke
\fBmysqld_multi\fR, use the following syntax:
\fBmariadbd-multi\fR, use the following syntax:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysqld_multi [\fR\fB\fIoptions\fR\fR\fB] {start|stop|report} [\fR\fB\fIGNR\fR\fR\fB[,\fR\fB\fIGNR\fR\fR\fB] \&.\&.\&.]\fR
shell> \fBmariadbd-multi [\fR\fB\fIoptions\fR\fR\fB] {start|stop|report} [\fR\fB\fIGNR\fR\fR\fB[,\fR\fB\fIGNR\fR\fR\fB] \&.\&.\&.]\fR
.fi
.if n \{\
.RE
@ -63,7 +63,7 @@ report
indicate which operation to perform\&. You can perform the designated operation for a single server or multiple servers, depending on the
\fIGNR\fR
list that follows the option name\&. If there is no list,
\fBmysqld_multi\fR
\fBmariadbd-multi\fR
performs the operation for all servers in the option file\&.
.PP
Each
@ -71,44 +71,44 @@ Each
value represents an option group number or range of group numbers\&. The value should be the number at the end of the group name in the option file\&. For example, the
\fIGNR\fR
for a group named
[mysqld17]
[mariadbd17]
is
17\&. To specify a range of numbers, separate the first and last numbers by a dash\&. The
\fIGNR\fR
value
10\-13
represents groups
[mysqld10]
[mariadbd10]
through
[mysqld13]\&. Multiple groups or group ranges can be specified on the command line, separated by commas\&. There must be no whitespace characters (spaces or tabs) in the
[mariadbd13]\&. Multiple groups or group ranges can be specified on the command line, separated by commas\&. There must be no whitespace characters (spaces or tabs) in the
\fIGNR\fR
list; anything after a whitespace character is ignored\&.
.PP
This command starts a single server using option group
[mysqld17]:
[mariadbd17]:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysqld_multi start 17\fR
shell> \fBmariadbd-multi start 17\fR
.fi
.if n \{\
.RE
.\}
.PP
This command stops several servers, using option groups
[mysqld8]
[mariadbd8]
and
[mysqld10]
[mariadbd10]
through
[mysqld13]:
[mariadbd13]:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysqld_multi stop 8,10\-13\fR
shell> \fBmariadbd-multi stop 8,10\-13\fR
.fi
.if n \{\
.RE
@ -120,13 +120,13 @@ For an example of how you might set up an option file, use this command:
.RS 4
.\}
.nf
shell> \fBmysqld_multi \-\-example\fR
shell> \fBmariadbd-multi \-\-example\fR
.fi
.if n \{\
.RE
.\}
.PP
\fBmysqld_multi\fR
\fBmariadbd-multi\fR
searches for option files as follows:
.sp
.RS 4
@ -137,8 +137,8 @@ searches for option files as follows:
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_multi: no-defaults option
.\" no-defaults option: mysqld_multi
.\" mariadbd-multi: no-defaults option
.\" no-defaults option: mariadbd-multi
With
\fB\-\-no\-defaults\fR, no option files are read\&.
.RE
@ -151,8 +151,8 @@ With
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_multi: defaults-file option
.\" defaults-file option: mysqld_multi
.\" mariadbd-multi: defaults-file option
.\" defaults-file option: mariadbd-multi
With
\fB\-\-defaults\-file=\fR\fB\fIfile_name\fR\fR, only the named file is read\&.
.RE
@ -165,43 +165,43 @@ With
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_multi: defaults-extra-file option
.\" defaults-extra-file option: mysqld_multi
.\" mariadbd-multi: defaults-extra-file option
.\" defaults-extra-file option: mariadbd-multi
Otherwise, option files in the standard list of locations are read, including any file named by the
\fB\-\-defaults\-extra\-file=\fR\fB\fIfile_name\fR\fR
option, if one is given\&. (If the option is given multiple times, the last value is used\&.)
.RE
.PP
Option files read are searched for
[mysqld_multi]
[mariadbd-multi]
and
[mysqld\fIN\fR]
[mariadbd\fIN\fR]
option groups\&. The
[mysqld_multi]
[mariadbd-multi]
group can be used for options to
\fBmysqld_multi\fR
\fBmariadbd-multi\fR
itself\&.
[mysqld\fIN\fR]
[mariadbd\fIN\fR]
groups can be used for options passed to specific
\fBmysqld\fR
\fBmariadbd\fR
instances\&.
.PP
The
[mysqld]
[mariadbd]
or
[mysqld_safe]
[mariadbd_safe]
groups can be used for common options read by all instances of
\fBmysqld\fR
\fBmariadbd\fR
or
\fBmysqld_safe\fR\&. You can specify a
\fBmariadbd_safe\fR\&. You can specify a
\fB\-\-defaults\-file=\fR\fB\fIfile_name\fR\fR
option to use a different configuration file for that instance, in which case the
[mysqld]
[mariadbd]
or
[mysqld_safe]
[mariadbd_safe]
groups from that file will be used for that instance\&.
.PP
\fBmysqld_multi\fR
\fBmariadbd-multi\fR
supports the following options\&.
.sp
.RS 4
@ -212,8 +212,8 @@ supports the following options\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_multi: help option
.\" help option: mysqld_multi
.\" mariadbd-multi: help option
.\" help option: mariadbd-multi
\fB\-\-help\fR
.sp
Display a help message and exit\&.
@ -227,8 +227,8 @@ Display a help message and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_multi: example option
.\" example option: mysqld_multi
.\" mariadbd-multi: example option
.\" example option: mariadbd-multi
\fB\-\-example\fR
.sp
Display a sample option file\&.
@ -242,8 +242,8 @@ Display a sample option file\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_multi: log option
.\" log option: mysqld_multi
.\" mariadbd-multi: log option
.\" log option: mariadbd-multi
\fB\-\-log=\fR\fB\fIfile_name\fR\fR
.sp
Specify the name of the log file\&. If the file exists, log output is appended to it\&.
@ -257,12 +257,12 @@ Specify the name of the log file\&. If the file exists, log output is appended t
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_multi: mysqladmin option
.\" mysqladmin option: mysqld_multi
\fB\-\-mysqladmin=\fR\fB\fIprog_name\fR\fR
.\" mariadbd-multi: mariadb-admin option
.\" mariadb-admin option: mariadbd-multi
\fB\-\-mariadb-admin=\fR\fB\fIprog_name\fR\fR
.sp
The
\fBmysqladmin\fR
\fBmariadb-admin\fR
binary to be used to stop servers\&.
.RE
.sp
@ -274,33 +274,33 @@ binary to be used to stop servers\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_multi: mysqld option
.\" mysqld option: mysqld_multi
\fB\-\-mysqld=\fR\fB\fIprog_name\fR\fR
.\" mariadbd-multi: mariadbd option
.\" mariadbd option: mariadbd-multi
\fB\-\-mariadbd=\fR\fB\fIprog_name\fR\fR
.sp
The
\fBmysqld\fR
\fBmariadbd\fR
binary to be used\&. Note that you can specify
\fBmysqld_safe\fR
\fBmariadbd_safe\fR
as the value for this option also\&. If you use
\fBmysqld_safe\fR
\fBmariadbd_safe\fR
to start the server, you can include the
mysqld
mariadbd
or
ledir
options in the corresponding
[mysqld\fIN\fR]
[mariadbd\fIN\fR]
option group\&. These options indicate the name of the server that
\fBmysqld_safe\fR
\fBmariadbd_safe\fR
should start and the path name of the directory where the server is located\&. (See the descriptions for these options in
\fBmysqld_safe\fR(1)\&.) Example:
\fBmariadbd_safe\fR(1)\&.) Example:
.sp
.if n \{\
.RS 4
.\}
.nf
[mysqld38]
mysqld = mysqld\-debug
[mariadbd38]
mariadbd = mariadbd\-debug
ledir = /opt/local/mysql/libexec
.fi
.if n \{\
@ -316,8 +316,8 @@ ledir = /opt/local/mysql/libexec
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_multi: no-log option
.\" no-log option: mysqld_multi
.\" mariadbd-multi: no-log option
.\" no-log option: mariadbd-multi
\fB\-\-no\-log\fR
.sp
Print log information to
@ -333,12 +333,12 @@ rather than to the log file\&. By default, output goes to the log file\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_multi: password option
.\" password option: mysqld_multi
.\" mariadbd-multi: password option
.\" password option: mariadbd-multi
\fB\-\-password=\fR\fB\fIpassword\fR\fR
.sp
The password of the MariaDB account to use when invoking
\fBmysqladmin\fR\&. Note that the password value is not optional for this option, unlike for other MariaDB programs\&.
\fBmariadb-admin\fR\&. Note that the password value is not optional for this option, unlike for other MariaDB programs\&.
.RE
.sp
.RS 4
@ -349,8 +349,8 @@ The password of the MariaDB account to use when invoking
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_multi: silent option
.\" silent option: mysqld_multi
.\" mariadbd-multi: silent option
.\" silent option: mariadbd-multi
\fB\-\-silent\fR
.sp
Silent mode; disable warnings\&.
@ -364,8 +364,8 @@ Silent mode; disable warnings\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_multi: tcp-ip option
.\" tcp-ip option: mysqld_multi
.\" mariadbd-multi: tcp-ip option
.\" tcp-ip option: mariadbd-multi
\fB\-\-tcp\-ip\fR
.sp
Connect to the MariaDB server(s) via the TCP/IP port instead of the UNIX socket\&. This affects stopping
@ -382,12 +382,12 @@ stop and report operations\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_multi: user option
.\" user option: mysqld_multi
.\" mariadbd-multi: user option
.\" user option: mariadbd-multi
\fB\-\-user=\fR\fB\fIuser_name\fR\fR
.sp
The user name of the MariaDB account to use when invoking
\fBmysqladmin\fR\&.
\fBmariadb-admin\fR\&.
.RE
.sp
.RS 4
@ -398,8 +398,8 @@ The user name of the MariaDB account to use when invoking
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_multi: verbose option
.\" verbose option: mysqld_multi
.\" mariadbd-multi: verbose option
.\" verbose option: mariadbd-multi
\fB\-\-verbose\fR
.sp
Be more verbose\&.
@ -413,8 +413,8 @@ Be more verbose\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_multi: version option
.\" version option: mysqld_multi
.\" mariadbd-multi: version option
.\" version option: mariadbd-multi
\fB\-\-version\fR
.sp
Display version information and exit\&.
@ -428,15 +428,15 @@ Display version information and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_multi: wsrep-new-cluster option
.\" wsrep-new-cluster option: mysqld_multi
.\" mariadbd-multi: wsrep-new-cluster option
.\" wsrep-new-cluster option: mariadbd-multi
\fB\-\-wsrep\-new\-cluster\fR
.sp
Bootstrap a cluster\&.
.RE
.PP
Some notes about
\fBmysqld_multi\fR:
\fBmariadbd-multi\fR:
.sp
.RS 4
.ie n \{\
@ -447,15 +447,15 @@ Some notes about
.IP \(bu 2.3
.\}
\fBMost important\fR: Before using
\fBmysqld_multi\fR
\fBmariadbd-multi\fR
be sure that you understand the meanings of the options that are passed to the
\fBmysqld\fR
\fBmariadbd\fR
servers and
\fIwhy\fR
you would want to have separate
\fBmysqld\fR
\fBmariadbd\fR
processes\&. Beware of the dangers of using multiple
\fBmysqld\fR
\fBmariadbd\fR
servers with the same data directory\&. Use separate data directories, unless you
\fIknow\fR
what you are doing\&. Starting multiple servers with the same data directory does
@ -474,7 +474,7 @@ give you extra performance in a threaded system\&.
.IP \(bu 2.3
.\}
\fBImportant\fR: Make sure that the data directory for each server is fully accessible to the Unix account that the specific
\fBmysqld\fR
\fBmariadbd\fR
process is started as\&.
\fIDo not\fR
use the Unix
@ -495,9 +495,9 @@ what you are doing\&.
.IP \(bu 2.3
.\}
Make sure that the MariaDB account used for stopping the
\fBmysqld\fR
\fBmariadbd\fR
servers (with the
\fBmysqladmin\fR
\fBmariadbadmin\fR
program) has the same user name and password for each server\&. Also, make sure that the account has the
SHUTDOWN
privilege\&. If the servers that you want to manage have different user names or passwords for the administrative accounts, you might want to create an account on each server that has the same user name and password\&. For example, you might set up a common
@ -508,9 +508,9 @@ account by executing the following commands for each server:
.RS 4
.\}
.nf
shell> \fBmysql \-u root \-S /tmp/mysql\&.sock \-p\fR
shell> \fBmariadb \-u root \-S /tmp/mariadb\&.sock \-p\fR
Enter password:
mysql> \fBGRANT SHUTDOWN ON *\&.*\fR
mariadb> \fBGRANT SHUTDOWN ON *\&.*\fR
\-> \fBTO 'multi_admin'@'localhost' IDENTIFIED BY 'multipass';\fR
.fi
.if n \{\
@ -520,7 +520,7 @@ mysql> \fBGRANT SHUTDOWN ON *\&.*\fR
Change the connection parameters appropriately when connecting to each one\&. Note that the host name part of the account name must allow you to connect as
multi_admin
from the host where you want to run
\fBmysqld_multi\fR\&.
\fBmariadbd-multi\fR\&.
.RE
.sp
.RS 4
@ -532,7 +532,7 @@ from the host where you want to run
.IP \(bu 2.3
.\}
The Unix socket file and the TCP/IP port number must be different for every
\fBmysqld\fR\&. (Alternatively, if the host has multiple network addresses, you can use
\fBmariadbd\fR\&. (Alternatively, if the host has multiple network addresses, you can use
\fB\-\-bind\-address\fR
to cause different servers to listen to different interfaces\&.)
.RE
@ -548,27 +548,27 @@ to cause different servers to listen to different interfaces\&.)
The
\fB\-\-pid\-file\fR
option is very important if you are using
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
to start
\fBmysqld\fR
\fBmariadbd\fR
(for example,
\fB\-\-mysqld=mysqld_safe\fR) Every
\fBmysqld\fR
\fB\-\-mariadbd=mariadbd-safe\fR) Every
\fBmariadbd\fR
should have its own process ID file\&. The advantage of using
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
instead of
\fBmysqld\fR
\fBmariadbd\fR
is that
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
monitors its
\fBmysqld\fR
\fBmariadbd\fR
process and restarts it if the process terminates due to a signal sent using
kill \-9
or for other reasons, such as a segmentation fault\&. Please note that the
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
script might require that you start it from a certain place\&. This means that you might have to change location to a certain directory before running
\fBmysqld_multi\fR\&. If you have problems starting, please see the
\fBmysqld_safe\fR
\fBmariadbd-multi\fR\&. If you have problems starting, please see the
\fBmariadbd-safe\fR
script\&. Check especially the lines:
.sp
.if n \{\
@ -578,7 +578,7 @@ script\&. Check especially the lines:
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
MY_PWD=`pwd`
# Check if we are starting this relative (for the binary release)
if test \-d $MY_PWD/data/mysql \-a \e
if test \-d $MY_PWD/data/mariadb \-a \e
\-f \&./share/mariadb/english/errmsg\&.sys \-a \e
\-x \&./bin/mariadbd
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
@ -588,7 +588,7 @@ if test \-d $MY_PWD/data/mysql \-a \e
.\}
.sp
The test performed by these lines should be successful, or you might encounter problems\&. See
\fBmysqld_safe\fR(1)\&.
\fBmariadbd-safe\fR(1)\&.
.RE
.sp
.RS 4
@ -602,20 +602,20 @@ The test performed by these lines should be successful, or you might encounter p
You might want to use the
\fB\-\-user\fR
option for
\fBmysqld\fR, but to do this you need to run the
\fBmysqld_multi\fR
\fBmariadbd\fR, but to do this you need to run the
\fBmariadbd-multi\fR
script as the Unix
root
user\&. Having the option in the option file doesn't matter; you just get a warning if you are not the superuser and the
\fBmysqld\fR
\fBmariadbd\fR
processes are started under your own Unix account\&.
.RE
.PP
The following example shows how you might set up an option file for use with
\fBmysqld_multi\fR\&. The order in which the
\fBmysqld\fR
\fBmariadbd-multi\fR\&. The order in which the
\fBmariadbd\fR
programs are started or stopped depends on the order in which they appear in the option file\&. Group numbers need not form an unbroken sequence\&. The first and fifth
[mysqld\fIN\fR]
[mariadbd\fIN\fR]
groups were intentionally omitted from the example to illustrate that you can have
\(lqgaps\(rq
in the option file\&. This gives you more flexibility\&.
@ -627,33 +627,33 @@ in the option file\&. This gives you more flexibility\&.
# This file should probably be in your home dir (~/\&.my\&.cnf)
# or /etc/my\&.cnf
# Version 2\&.1 by Jani Tolonen
[mysqld_multi]
mysqld = /usr/local/bin/mysqld_safe
mysqladmin = /usr/local/bin/mysqladmin
[mariadbd-multi]
mariadbd = /usr/local/bin/mariadbd-safe
mariadb-admin = /usr/local/bin/mariadb-admin
user = multi_admin
password = multipass
[mysqld2]
socket = /tmp/mysql\&.sock2
[mariadbd2]
socket = /tmp/mariadb\&.sock2
port = 3307
pid\-file = /usr/local/mysql/var2/hostname\&.pid2
datadir = /usr/local/mysql/var2
language = /usr/local/share/mariadb/english
user = john
[mysqld3]
[mariadbd3]
socket = /tmp/mysql\&.sock3
port = 3308
pid\-file = /usr/local/mysql/var3/hostname\&.pid3
datadir = /usr/local/mysql/var3
language = /usr/local/share/mariadb/swedish
user = monty
[mysqld4]
[mariadbd4]
socket = /tmp/mysql\&.sock4
port = 3309
pid\-file = /usr/local/mysql/var4/hostname\&.pid4
datadir = /usr/local/mysql/var4
language = /usr/local/share/mariadb/estonia
user = tonu
[mysqld6]
[mariadbd6]
socket = /tmp/mysql\&.sock6
port = 3311
pid\-file = /usr/local/mysql/var6/hostname\&.pid6
@ -668,7 +668,7 @@ user = jani
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

2
man/mariadbd-safe-helper.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADBD-SAFE-HELPER\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADBD-SAFE-HELPER\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------

284
man/mariadbd-safe.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADBD-SAFE\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADBD-SAFE\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,58 +11,58 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysqld_safe
.\" tools: mysqld_safe
.\" mariadbd-safe
.\" tools: mariadbd-safe
.\" scripts
.SH "NAME"
mariadbd-safe \- MariaDB server startup script (mysqld_safe is now a symlink to mariadbd-safe)
mariadbd-safe \- MariaDB server startup script (mariadbd-safe is now a symlink to mariadbd-safe)
.SH "SYNOPSIS"
.HP \w'\fBmysqld_safe\ \fR\fB\fIoptions\fR\fR\ 'u
\fBmysqld_safe \fR\fB\fIoptions\fR\fR
.HP \w'\fBmariadbd-safe\ \fR\fB\fIoptions\fR\fR\ 'u
\fBmariadbd-safe \fR\fB\fIoptions\fR\fR
.SH "DESCRIPTION"
.PP
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
is the recommended way to start a
\fBmysqld\fR
\fBmariadbd\fR
server on Unix\&.
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
adds some safety features such as restarting the server when an error occurs and logging runtime information to an error log file\&. Descriptions of error logging is given later in this section\&.
.sp
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
tries to start an executable named
\fBmysqld\fR\&. To override the default behavior and specify explicitly the name of the server you want to run, specify a
\fB\-\-mysqld\fR
\fBmariadbd\fR\&. To override the default behavior and specify explicitly the name of the server you want to run, specify a
\fB\-\-mariadbd\fR
or
\fB\-\-mysqld\-version\fR
\fB\-\-mariadbd\-version\fR
option to
\fBmysqld_safe\fR\&. You can also use
\fBmariadbd-safe\fR\&. You can also use
\fB\-\-ledir\fR
to indicate the directory where
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
should look for the server\&.
.PP
Many of the options to
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
are the same as the options to
\fBmysqld\fR\&.
\fBmariadbd\fR\&.
.PP
Options unknown to
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
are passed to
\fBmysqld\fR
\fBmariadbd\fR
if they are specified on the command line, but ignored if they are specified in the
[mysqld_safe] or [mariadb_safe]
[mariadbd-safe] or [mariadb_safe]
groups of an option file\&.
.PP
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
reads all options from the
[mysqld],
[mariadbd],
[server],
[mysqld_safe], and [mariadb_safe]
[mariadbd-safe], and [mariadb_safe]
sections in option files\&. For example, if you specify a
[mysqld]
[mariadbd]
section like this,
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
will find and use the
\fB\-\-log\-error\fR
option:
@ -71,7 +71,7 @@ option:
.RS 4
.\}
.nf
[mysqld]
[mariadbd]
log\-error=error\&.log
.fi
.if n \{\
@ -79,14 +79,14 @@ log\-error=error\&.log
.\}
.PP
For backward compatibility,
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
also reads
[safe_mysqld]
[safe_mariadbd]
sections, although you should rename such sections to
[mysqld_safe]
[mariadbd-safe]
in current installations\&.
.PP
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
supports the options in the following list\&. It also reads option files and supports the options for processing them.
.sp
.RS 4
@ -97,8 +97,8 @@ supports the options in the following list\&. It also reads option files and sup
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: help option
.\" help option: mysqld_safe
.\" mariadbd-safe: help option
.\" help option: mariadbd-safe
\fB\-\-help\fR
.sp
Display a help message and exit\&.
@ -112,8 +112,8 @@ Display a help message and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: basedir option
.\" basedir option: mysqld_safe
.\" mariadbd-safe: basedir option
.\" basedir option: mariadbd-safe
\fB\-\-basedir=\fR\fB\fIpath\fR\fR
.sp
The path to the MariaDB installation directory\&.
@ -127,12 +127,12 @@ The path to the MariaDB installation directory\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: core-file-size option
.\" core-file-size option: mysqld_safe
.\" mariadbd-safe: core-file-size option
.\" core-file-size option: mariadbd-safe
\fB\-\-core\-file\-size=\fR\fB\fIsize\fR\fR
.sp
The size of the core file that
\fBmysqld\fR
\fBmariadbd\fR
should be able to create\&. The option value is passed to
\fBulimit \-c\fR\&.
.RE
@ -145,11 +145,11 @@ should be able to create\&. The option value is passed to
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: crash-script option
.\" crash-script option: mysqld_safe
.\" mariadbd-safe: crash-script option
.\" crash-script option: mariadbd-safe
\fB\-\-crash\-script=\fR\fB\fIfile\fR\fR
.sp
Script to call in the event of mysqld crashing\&.
Script to call in the event of mariadbd crashing\&.
.RE
.sp
.RS 4
@ -160,8 +160,8 @@ Script to call in the event of mysqld crashing\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: datadir option
.\" datadir option: mysqld_safe
.\" mariadbd-safe: datadir option
.\" datadir option: mariadbd-safe
\fB\-\-datadir=\fR\fB\fIpath\fR\fR
.sp
The path to the data directory\&.
@ -175,8 +175,8 @@ The path to the data directory\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: defaults-extra-file option
.\" defaults-extra-file option: mysqld_safe
.\" mariadbd-safe: defaults-extra-file option
.\" defaults-extra-file option: mariadbd-safe
\fB\-\-defaults\-extra\-file=\fR\fB\fIpath\fR\fR
.sp
The name of an option file to be read in addition to the usual option files\&. This must be the first option on the command line if it is used\&. If the file does not exist or is otherwise inaccessible, the server will exit with an error\&.
@ -190,8 +190,8 @@ The name of an option file to be read in addition to the usual option files\&. T
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: defaults-file option
.\" defaults-file option: mysqld_safe
.\" mariadbd-safe: defaults-file option
.\" defaults-file option: mariadbd-safe
\fB\-\-defaults\-file=\fR\fB\fIfile_name\fR\fR
.sp
The name of an option file to be read instead of the usual option files\&. This must be the first option on the command line if it is used\&.
@ -205,8 +205,8 @@ The name of an option file to be read instead of the usual option files\&. This
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: flush-caches option
.\" flush-caches option: mysqld_safe
.\" mariadbd-safe: flush-caches option
.\" flush-caches option: mariadbd-safe
\fB\-\-flush\-caches\fR
.sp
Flush and purge buffers/caches before starting the server\&.
@ -220,12 +220,12 @@ Flush and purge buffers/caches before starting the server\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: ledir option
.\" ledir option: mysqld_safe
.\" mariadbd-safe: ledir option
.\" ledir option: mariadbd-safe
\fB\-\-ledir=\fR\fB\fIpath\fR\fR
.sp
If
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
cannot find the server, use this option to indicate the path name to the directory where the server is located\&.
.RE
.sp
@ -237,8 +237,8 @@ cannot find the server, use this option to indicate the path name to the directo
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: log-error option
.\" log-error option: mysqld_safe
.\" mariadbd-safe: log-error option
.\" log-error option: mariadbd-safe
\fB\-\-log\-error=\fR\fB\fIfile_name\fR\fR
.sp
Write the error log to the given file\&.
@ -252,8 +252,8 @@ Write the error log to the given file\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: malloc-lib option
.\" malloc-lib option: mysqld_safe
.\" mariadbd-safe: malloc-lib option
.\" malloc-lib option: mariadbd-safe
\fB\-\-malloc\-lib=\fR\fB\fIlib\fR\fR
.sp
Preload shared library lib if available\&.
@ -267,14 +267,14 @@ Preload shared library lib if available\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: mysqld option
.\" mysqld option: mysqld_safe
\fB\-\-mysqld=\fR\fB\fIprog_name\fR\fR
.\" mariadbd-safe: mariadbd option
.\" mariadbd option: mariadbd-safe
\fB\-\-mariadbd=\fR\fB\fIprog_name\fR\fR
.sp
The name of the server program (in the
ledir
directory) that you want to start\&. This option is needed if you use the MariaDB binary distribution but have the data directory outside of the binary distribution\&. If
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
cannot find the server, use the
\fB\-\-ledir\fR
option to indicate the path name to the directory where the server is located\&.
@ -288,26 +288,26 @@ option to indicate the path name to the directory where the server is located\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: mysqld-version option
.\" mysqld-version option: mysqld_safe
\fB\-\-mysqld\-version=\fR\fB\fIsuffix\fR\fR
.\" mariadbd-safe: mariadbd-version option
.\" mariadbd-version option: mariadbd-safe
\fB\-\-mariadbd\-version=\fR\fB\fIsuffix\fR\fR
.sp
This option is similar to the
\fB\-\-mysqld\fR
\fB\-\-mariadbd\fR
option, but you specify only the suffix for the server program name\&. The basename is assumed to be
\fBmysqld\fR\&. For example, if you use
\fB\-\-mysqld\-version=debug\fR,
\fBmysqld_safe\fR
\fBmariadbd\fR\&. For example, if you use
\fB\-\-mariadbd\-version=debug\fR,
\fBmariadbd-safe\fR
starts the
\fBmysqld\-debug\fR
\fBmariadbd\-debug\fR
program in the
ledir
directory\&. If the argument to
\fB\-\-mysqld\-version\fR
\fB\-\-mariadbd\-version\fR
is empty,
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
uses
\fBmysqld\fR
\fBmariadbd\fR
in the
ledir
directory\&.
@ -321,8 +321,8 @@ directory\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: nice option
.\" nice option: mysqld_safe
.\" mariadbd-safe: nice option
.\" nice option: mariadbd-safe
\fB\-\-nice=\fR\fB\fIpriority\fR\fR
.sp
Use the
@ -338,13 +338,13 @@ program to set the server's scheduling priority to the given value\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: no-auto-restart option
.\" no-auto-restart option: mysqld_safe
.\" mariadbd-safe: no-auto-restart option
.\" no-auto-restart option: mariadbd-safe
\fB\-\-no\-auto\-restart\fR,
\fB\-\-nowatch\fR,
\fB\-\-no\-watch\fR
.sp
Exit after starting mysqld\&.
Exit after starting mariadbd\&.
.RE
.sp
.RS 4
@ -355,8 +355,8 @@ Exit after starting mysqld\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: no-defaults option
.\" no-defaults option: mysqld_safe
.\" mariadbd-safe: no-defaults option
.\" no-defaults option: mariadbd-safe
\fB\-\-no\-defaults\fR
.sp
Do not read any option files\&. This must be the first option on the command line if it is used\&.
@ -370,11 +370,11 @@ Do not read any option files\&. This must be the first option on the command lin
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: numa-interleave option
.\" numa-interleave option: mysqld_safe
.\" mariadbd-safe: numa-interleave option
.\" numa-interleave option: mariadbd-safe
\fB\-\-numa\-interleave\fR
.sp
Run mysqld with its memory interleaved on all NUMA nodes\&.
Run mariadbd with its memory interleaved on all NUMA nodes\&.
.RE
.sp
.RS 4
@ -385,15 +385,15 @@ Run mysqld with its memory interleaved on all NUMA nodes\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: open-files-limit option
.\" open-files-limit option: mysqld_safe
.\" mariadbd-safe: open-files-limit option
.\" open-files-limit option: mariadbd-safe
\fB\-\-open\-files\-limit=\fR\fB\fIcount\fR\fR
.sp
The number of files that
\fBmysqld\fR
\fBmariadbd\fR
should be able to open\&. The option value is passed to
\fBulimit \-n\fR\&. Note that you need to start
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
as
root
for this to work properly!
@ -407,8 +407,8 @@ for this to work properly!
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: pid-file option
.\" pid-file option: mysqld_safe
.\" mariadbd-safe: pid-file option
.\" pid-file option: mariadbd-safe
\fB\-\-pid\-file=\fR\fB\fIfile_name\fR\fR
.sp
The path name of the process ID file\&.
@ -422,8 +422,8 @@ The path name of the process ID file\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: plugin-dir option
.\" plugin-dir option: mysqld_safe
.\" mariadbd-safe: plugin-dir option
.\" plugin-dir option: mariadbd-safe
\fB\-\-plugin\-dir=\fIdir_name\fR
.sp
Directory for client-side plugins\&.
@ -437,8 +437,8 @@ Directory for client-side plugins\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: port option
.\" port option: mysqld_safe
.\" mariadbd-safe: port option
.\" port option: mariadbd-safe
\fB\-\-port=\fR\fB\fIport_num\fR\fR
.sp
The port number that the server should use when listening for TCP/IP connections\&. The port number must be 1024 or higher unless the server is started by the
@ -454,12 +454,12 @@ system user\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: skip-kill-mysqld option
.\" skip-kill-mysqld option: mysqld_safe
\fB\-\-skip\-kill\-mysqld\fR
.\" mariadbd-safe: skip-kill-mariadbd option
.\" skip-kill-mariadbd option: mariadbd-safe
\fB\-\-skip\-kill\-mariadbd\fR
.sp
Do not try to kill stray
\fBmysqld\fR
\fBmariadbd\fR
processes at startup\&. This option works only on Linux\&.
.RE
.sp
@ -471,8 +471,8 @@ processes at startup\&. This option works only on Linux\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: socket option
.\" socket option: mysqld_safe
.\" mariadbd-safe: socket option
.\" socket option: mariadbd-safe
\fB\-\-socket=\fR\fB\fIpath\fR\fR
.sp
The Unix socket file that the server should use when listening for local connections\&.
@ -486,10 +486,10 @@ The Unix socket file that the server should use when listening for local connect
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: syslog option
.\" syslog option: mysqld_safe
.\" mysqld_safe: skip-syslog option
.\" skip-syslog option: mysqld_safe
.\" mariadbd-safe: syslog option
.\" syslog option: mariadbd-safe
.\" mariadbd-safe: skip-syslog option
.\" skip-syslog option: mariadbd-safe
\fB\-\-syslog\fR,
\fB\-\-skip\-syslog\fR
.sp
@ -512,23 +512,23 @@ syslog; messages are written to an error log file\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: syslog-tag option
.\" syslog-tag option: mysqld_safe
.\" mariadbd-safe: syslog-tag option
.\" syslog-tag option: mariadbd-safe
\fB\-\-syslog\-tag=\fR\fB\fItag\fR\fR
.sp
For logging to
syslog, messages from
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
and
\fBmysqld\fR
\fBmariadbd\fR
are written with a tag of
mysqld_safe
mariadbd-safe
and
mysqld, respectively\&. To specify a suffix for the tag, use
mariadbd, respectively\&. To specify a suffix for the tag, use
\fB\-\-syslog\-tag=\fR\fB\fItag\fR\fR, which modifies the tags to be
mysqld_safe\-\fItag\fR
mariadbd-safe\-\fItag\fR
and
mysqld\-\fItag\fR\&.
mariadbd\-\fItag\fR\&.
.RE
.sp
.RS 4
@ -539,8 +539,8 @@ mysqld\-\fItag\fR\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: timezone option
.\" timezone option: mysqld_safe
.\" mariadbd-safe: timezone option
.\" timezone option: mariadbd-safe
\fB\-\-timezone=\fR\fB\fItimezone\fR\fR
.sp
Set the
@ -556,12 +556,12 @@ time zone environment variable to the given option value\&. Consult your operati
.sp -1
.IP \(bu 2.3
.\}
.\" mysqld_safe: user option
.\" user option: mysqld_safe
.\" mariadbd-safe: user option
.\" user option: mariadbd-safe
\fB\-\-user={\fR\fB\fIuser_name\fR\fR\fB|\fR\fB\fIuser_id\fR\fR\fB}\fR
.sp
Run the
\fBmysqld\fR
\fBmariadbd\fR
server as the user having the name
\fIuser_name\fR
or the numeric user ID
@ -570,7 +570,7 @@ in this context refers to a system login account, not a MariaDB user listed in t
.RE
.PP
If you execute
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
with the
\fB\-\-defaults\-file\fR
or
@ -581,7 +581,7 @@ option to name an option file, the option must be the first one given on the com
.RS 4
.\}
.nf
mysql> \fBmysqld_safe \-\-port=\fR\fB\fIport_num\fR\fR\fB \-\-defaults\-file=\fR\fB\fIfile_name\fR\fR
mariadb> \fBmariadbd-safe \-\-port=\fR\fB\fIport_num\fR\fR\fB \-\-defaults\-file=\fR\fB\fIfile_name\fR\fR
.fi
.if n \{\
.RE
@ -593,16 +593,16 @@ Instead, use the following command:
.RS 4
.\}
.nf
mysql> \fBmysqld_safe \-\-defaults\-file=\fR\fB\fIfile_name\fR\fR\fB \-\-port=\fR\fB\fIport_num\fR\fR
mariadb> \fBmariadbd-safe \-\-defaults\-file=\fR\fB\fIfile_name\fR\fR\fB \-\-port=\fR\fB\fIport_num\fR\fR
.fi
.if n \{\
.RE
.\}
.PP
The
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
script is written so that it normally can start a server that was installed from either a source or a binary distribution of MariaDB, even though these types of distributions typically install the server in slightly different locations\&.
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
expects one of the following conditions to be true:
.sp
.RS 4
@ -614,9 +614,9 @@ expects one of the following conditions to be true:
.IP \(bu 2.3
.\}
The server and databases can be found relative to the working directory (the directory from which
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
is invoked)\&. For binary distributions,
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
looks under its working directory for
bin
and
@ -626,7 +626,7 @@ libexec
and
var
directories\&. This condition should be met if you execute
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
from your MariaDB installation directory (for example,
/usr/local/mysql
for a binary distribution)\&.
@ -641,7 +641,7 @@ for a binary distribution)\&.
.IP \(bu 2.3
.\}
If the server and databases cannot be found relative to the working directory,
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
attempts to locate them by absolute path names\&. Typical locations are
/usr/local/libexec
and
@ -649,9 +649,9 @@ and
.RE
.PP
Because
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
tries to find the server and databases relative to its own working directory, you can install a binary distribution of MariaDB anywhere, as long as you run
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
from the MariaDB installation directory:
.sp
.if n \{\
@ -659,14 +659,14 @@ from the MariaDB installation directory:
.\}
.nf
shell> \fBcd \fR\fB\fImysql_installation_directory\fR\fR
shell> \fBbin/mysqld_safe &\fR
shell> \fBbin/mariadbd-safe &\fR
.fi
.if n \{\
.RE
.\}
.PP
If
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
fails, even when invoked from the MariaDB installation directory, you can specify the
\fB\-\-ledir\fR
and
@ -674,16 +674,16 @@ and
options to indicate the directories in which the server and databases are located on your system\&.
.PP
When you use
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
to start
\fBmysqld\fR,
\fBmysqld_safe\fR
\fBmariadbd\fR,
\fBmariadbd-safe\fR
arranges for error (and notice) messages from itself and from
\fBmysqld\fR
\fBmariadbd\fR
to go to the same destination\&.
.PP
There are several
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
options for controlling the destination of these messages:
.sp
.RS 4
@ -754,28 +754,28 @@ are both given, a warning is issued and
takes precedence\&.
.PP
When
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
writes a message, notices go to the logging destination (syslog
or the error log file) and
stdout\&. Errors go to the logging destination and
stderr\&.
.PP
Normally, you should not edit the
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
script\&. Instead, configure
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
by using command\-line options or options in the
[mysqld_safe]
[mariadbd-safe]
section of a
my\&.cnf
option file\&. In rare cases, it might be necessary to edit
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
to get it to start the server properly\&. However, if you do this, your modified version of
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
might be overwritten if you upgrade MariaDB in the future, so you should make a copy of your edited version that you can reinstall\&.
.PP
On NetWare,
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
is a NetWare Loadable Module (NLM) that is ported from the original Unix shell script\&. It starts the server as follows:
.sp
.RS 4
@ -822,7 +822,7 @@ Provides a screen presence for the MariaDB server\&.
.IP " 4." 4.2
.\}
Starts
\fBmysqld\fR, monitors it, and restarts it if it terminates in error\&.
\fBmariadbd\fR, monitors it, and restarts it if it terminates in error\&.
.RE
.sp
.RS 4
@ -834,7 +834,7 @@ Starts
.IP " 5." 4.2
.\}
Sends error messages from
\fBmysqld\fR
\fBmariadbd\fR
to the
\fIhost_name\fR\&.err
file in the data directory\&.
@ -849,7 +849,7 @@ file in the data directory\&.
.IP " 6." 4.2
.\}
Sends
\fBmysqld_safe\fR
\fBmariadbd-safe\fR
screen output to the
\fIhost_name\fR\&.safe
file in the data directory\&.
@ -857,7 +857,7 @@ file in the data directory\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

20
man/mariadbd.8
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMARIADBD\fR" "8" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADBD\fR" "8" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,28 +11,28 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysqld: MariaDB server
.\" MariaDB server: mysqld
.\" mariadbd: MariaDB server
.\" MariaDB server: mariadbd
.SH "NAME"
mariadbd \- the MariaDB server (mysqld is now a symlink to mariadbd)
mariadbd \- the MariaDB server (mariadbd is now a symlink to mariadbd)
.SH "SYNOPSIS"
.HP \w'\fBmysqld\ [\fR\fB\fIoptions\fR\fR\fB]\fR\ 'u
\fBmysqld [\fR\fB\fIoptions\fR\fR\fB]\fR
.HP \w'\fBmariadbd\ [\fR\fB\fIoptions\fR\fR\fB]\fR\ 'u
\fBmariadbd [\fR\fB\fIoptions\fR\fR\fB]\fR
.SH "DESCRIPTION"
.PP
\fBmysqld\fR, also known as MariaDB Server, is the main program that does most of the work in a MariaDB installation\&. MariaDB Server manages access to the MariaDB data directory that contains databases and tables\&. The data directory is also the default location for other information such as log files and status files\&.
\fBmariadbd\fR, also known as MariaDB Server, is the main program that does most of the work in a MariaDB installation\&. MariaDB Server manages access to the MariaDB data directory that contains databases and tables\&. The data directory is also the default location for other information such as log files and status files\&.
.PP
When MariaDB server starts, it listens for network connections from client programs and manages access to databases on behalf of those clients\&.
.PP
The
\fBmysqld\fR
\fBmariadbd\fR
program has many options that can be specified at startup\&. For a complete list of options, run this command:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysqld \-\-verbose \-\-help\fR
shell> \fBmariadbd \-\-verbose \-\-help\fR
.fi
.if n \{\
.RE
@ -45,7 +45,7 @@ the MariaDB Knowledge Base\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

2
man/mbstream.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMBSTREAM\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMBSTREAM\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------

10
man/msql2mysql.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMSQL2MYSQL\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMSQL2MYSQL\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -13,17 +13,17 @@
.\" -----------------------------------------------------------------
.\" msql2mysql
.SH "NAME"
msql2mysql \- convert mSQL programs for use with MySQL
msql2mysql \- convert mSQL programs for use with MariaDB
.SH "SYNOPSIS"
.HP \w'\fBmsql2mysql\fR\fB\fIC\-source\-file\fR\fR\fB\ \&.\&.\&.\fR\ 'u
\fBmsql2mysql\fR\fB\fIC\-source\-file\fR\fR\fB \&.\&.\&.\fR
.SH "DESCRIPTION"
.PP
Initially, the MySQL C API was developed to be very similar to that for the mSQL database system\&. Because of this, mSQL programs often can be converted relatively easily for use with MySQL by changing the names of the C API functions\&.
Initially, the MySQL C API was developed to be very similar to that for the mSQL database system\&. Because of this, mSQL programs often can be converted relatively easily for use with MariaDB by changing the names of the C API functions\&.
.PP
The
\fBmsql2mysql\fR
utility performs the conversion of mSQL C API function calls to their MySQL equivalents\&.
utility performs the conversion of mSQL C API function calls to their MariaDB equivalents\&.
\fBmsql2mysql\fR
converts the input file in place, so make a copy of the original before converting it\&. For example, use
\fBmsql2mysql\fR
@ -53,7 +53,7 @@ utility to make the function name substitutions\&. See
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

18
man/my_print_defaults.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMY_PRINT_DEFAULTS\fR" "1" "18 December 2023" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMY_PRINT_DEFAULTS\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -21,9 +21,9 @@ my_print_defaults \- display options from option files
.PP
\fBmy_print_defaults\fR
displays the options that are present in option groups of option files\&. The output indicates what options will be used by programs that read the specified option groups\&. For example, the
\fBmysqlcheck\fR
\fBmariadb-check\fR
program reads the
[mysqlcheck]
[mariadb-check]
and
[client]
option groups\&. To see what options are present in those groups in the standard option files, invoke
@ -34,7 +34,7 @@ like this:
.RS 4
.\}
.nf
shell> \fBmy_print_defaults mysqlcheck client\fR
shell> \fBmy_print_defaults mariadb-check client\fR
\-\-user=myusername
\-\-password=secret
\-\-host=localhost
@ -162,11 +162,11 @@ Read the same set of groups that the mariadbd binary does.
.IP \(bu 2.3
.\}
.\" my_print_defaults: --mysqld option
.\" mysqld option: my_print_defaults
\fB\-\-mysqld\fR
.\" my_print_defaults: --mariadbd option
.\" mariadbd option: my_print_defaults
\fB\-\-mariadbd\fR
.sp
Read the same set of groups that the mysqld binary does.
Read the same set of groups that the mariadbd binary does.
.RE
.sp
.RS 4
@ -219,7 +219,7 @@ Display version information and exit\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

2
man/my_safe_process.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMY_SAFE_PROCESS\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMY_SAFE_PROCESS\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------

4
man/myisam_ftdump.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMYISAM_FTDUMP\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMYISAM_FTDUMP\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -235,7 +235,7 @@ Verbose mode\&. Print more output about what the program does\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

20
man/myisamchk.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMYISAMCHK\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMYISAMCHK\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -196,13 +196,13 @@ warning: clients are using or haven't closed the table properly
.\}
.PP
This means that you are trying to check a table that has been updated by another program (such as the
\fBmysqld\fR
\fBmariadbd\fR
server) that hasn't yet closed the file or that has died without closing the file properly, which can sometimes lead to the corruption of one or more
MyISAM
tables\&.
.PP
If
\fBmysqld\fR
\fBmariadbd\fR
is running, you must force it to flush any table modifications that are still buffered in memory by using
FLUSH TABLES\&. You should then ensure that no one is using the tables while you are running
\fBmyisamchk\fR
@ -348,7 +348,7 @@ Display version information and exit\&.
\fB\-w\fR
.sp
Instead of terminating with an error if the table is locked, wait until the table is unlocked before continuing\&. If you are running
\fBmysqld\fR
\fBmariadbd\fR
with external locking disabled, the table can be locked only by another
\fBmyisamchk\fR
command\&.
@ -604,7 +604,7 @@ ft_stopword_file
values to
\fBmyisamchk\fR
that you use for
\fBmysqld\fR\&. For example, if you have set the minimum word length to 3, you can repair a table with
\fBmariadbd\fR\&. For example, if you have set the minimum word length to 3, you can repair a table with
\fBmyisamchk\fR
like this:
.sp
@ -621,7 +621,7 @@ shell> \fBmyisamchk \-\-recover \-\-ft_min_word_len=3 \fR\fB\fItbl_name\fR\fR\fB
To ensure that
\fBmyisamchk\fR
and the server use the same values for full\-text parameters, you can place each one in both the
[mysqld]
[mariadbd]
and
[myisamchk]
sections of an option file:
@ -630,7 +630,7 @@ sections of an option file:
.RS 4
.\}
.nf
[mysqld]
[mariadbd]
ft_min_word_len=3
[myisamchk]
ft_min_word_len=3
@ -803,7 +803,7 @@ operation\&. This finds only 99\&.99% of all errors, which should be good enough
Do not mark the table as checked\&. This is useful if you use
\fBmyisamchk\fR
to check a table that is in use by some other application that does not use locking, such as
\fBmysqld\fR
\fBmariadbd\fR
when run with external locking disabled\&.
.RE
.sp
@ -825,7 +825,7 @@ Store information in the
file to indicate when the table was checked and whether the table crashed\&. This should be used to get full benefit of the
\fB\-\-check\-only\-changed\fR
option, but you shouldn't use this option if the
\fBmysqld\fR
\fBmariadbd\fR
server is using the table and you are running it with external locking disabled\&.
.RE
.SH "MYISAMCHK REPAIR OPTIONS"
@ -2505,7 +2505,7 @@ instead of
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

4
man/myisamlog.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMYISAMLOG\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMYISAMLOG\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -218,7 +218,7 @@ Display version information\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

20
man/myisampack.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMYISAMPACK\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMYISAMPACK\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -34,11 +34,11 @@ packs the data file 40%\(en70%\&.
.PP
When the table is used later, the server reads into memory the information needed to decompress columns\&. This results in much better performance when accessing individual rows, because you only have to uncompress exactly one row\&.
.PP
MySQL uses
MariaDB uses
mmap()
when possible to perform memory mapping on compressed tables\&. If
mmap()
does not work, MySQL falls back to normal read/write file operations\&.
does not work, MariaDB falls back to normal read/write file operations\&.
.PP
Please note the following:
.sp
@ -51,7 +51,7 @@ Please note the following:
.IP \(bu 2.3
.\}
If the
\fBmysqld\fR
\fBmariadbd\fR
server was invoked with external locking disabled, it is not a good idea to invoke
\fBmyisampack\fR
if the table might be updated by the server during the packing process\&. It is safest to compress tables with the server stopped\&.
@ -320,7 +320,7 @@ Display version information and exit\&.
\fB\-w\fR
.sp
Wait and retry if the table is in use\&. If the
\fBmysqld\fR
\fBmariadbd\fR
server was invoked with external locking disabled, it is not a good idea to invoke
\fBmyisampack\fR
if the table might be updated by the server during the packing process\&.
@ -798,7 +798,7 @@ The number of bits used in the Huffman tree\&.
After you run
\fBmyisampack\fR, you must run
\fBmyisamchk\fR
to re\-create any indexes\&. At this time, you can also sort the index blocks and create statistics needed for the MySQL optimizer to work more efficiently:
to re\-create any indexes\&. At this time, you can also sort the index blocks and create statistics needed for the MariaDB optimizer to work more efficiently:
.sp
.if n \{\
.RS 4
@ -810,10 +810,10 @@ shell> \fBmyisamchk \-rq \-\-sort\-index \-\-analyze \fR\fB\fItbl_name\fR\fR\fB\
.RE
.\}
.PP
After you have installed the packed table into the MySQL database directory, you should execute
\fBmysqladmin flush\-tables\fR
After you have installed the packed table into the MariaDB database directory, you should execute
\fBmariadb-admin flush\-tables\fR
to force
\fBmysqld\fR
\fBmariadbd\fR
to start using the new table\&.
.PP
To unpack a packed table, use the
@ -823,7 +823,7 @@ option to
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

134
man/mysql-stress-test.pl.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMYSQL\-STRESS\-TEST\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMARIADB\-STRESS\-TEST\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -11,36 +11,36 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mysql-stress-test.pl
.\" mariadb-stress-test.pl
.SH "NAME"
mysql-stress-test.pl \- server stress test program
mariadb-stress-test.pl \- server stress test program
.SH "SYNOPSIS"
.HP \w'\fBmysql\-stress\-test\&.pl\ [\fR\fB\fIoptions\fR\fR\fB]\fR\ 'u
\fBmysql\-stress\-test\&.pl [\fR\fB\fIoptions\fR\fR\fB]\fR
.HP \w'\fBmariadb\-stress\-test\&.pl\ [\fR\fB\fIoptions\fR\fR\fB]\fR\ 'u
\fBmariadb\-stress\-test\&.pl [\fR\fB\fIoptions\fR\fR\fB]\fR
.SH "DESCRIPTION"
.PP
The
\fBmysql\-stress\-test\&.pl\fR
\fBmariadb\-stress\-test\&.pl\fR
Perl script performs stress\-testing of the MariaDB server\&.
.PP
\fBmysql\-stress\-test\&.pl\fR
\fBmariadb\-stress\-test\&.pl\fR
requires a version of Perl that has been built with threads support\&.
.PP
Invoke
\fBmysql\-stress\-test\&.pl\fR
\fBmariadb\-stress\-test\&.pl\fR
like this:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmysql\-stress\-test\&.pl [\fR\fB\fIoptions\fR\fR\fB]\fR
shell> \fBmariadb\-stress\-test\&.pl [\fR\fB\fIoptions\fR\fR\fB]\fR
.fi
.if n \{\
.RE
.\}
.PP
\fBmysql\-stress\-test\&.pl\fR
\fBmariadb\-stress\-test\&.pl\fR
supports the following options:
.sp
.RS 4
@ -51,8 +51,8 @@ supports the following options:
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: help option
.\" help option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: help option
.\" help option: mariadb-stress-test.pl
\fB\-\-help\fR
.sp
Display a help message and exit\&.
@ -66,8 +66,8 @@ Display a help message and exit\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: abort-on-error option
.\" abort-on-error option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: abort-on-error option
.\" abort-on-error option: mariadb-stress-test.pl
\fB\-\-abort\-on\-error=\fR\fB\fIN\fR\fR
.sp
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\&.
@ -81,8 +81,8 @@ Causes the program to abort if an error with severity less than or equal to N wa
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: check-tests-file option
.\" check-tests-file option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: check-tests-file option
.\" check-tests-file option: mariadb-stress-test.pl
\fB\-\-check\-tests\-file\fR
.sp
Periodically check the file that lists the tests to be run\&. If it has been modified, reread the file\&. This can be useful if you update the list of tests to be run during a stress test\&.
@ -96,8 +96,8 @@ Periodically check the file that lists the tests to be run\&. If it has been mod
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: cleanup option
.\" cleanup option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: cleanup option
.\" cleanup option: mariadb-stress-test.pl
\fB\-\-cleanup\fR
.sp
Force cleanup of the working directory\&.
@ -111,8 +111,8 @@ Force cleanup of the working directory\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: log-error-details option
.\" log-error-details option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: log-error-details option
.\" log-error-details option: mariadb-stress-test.pl
\fB\-\-log\-error\-details\fR
.sp
Log error details in the global error log file\&.
@ -126,8 +126,8 @@ Log error details in the global error log file\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: loop-count option
.\" loop-count option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: loop-count option
.\" loop-count option: mariadb-stress-test.pl
\fB\-\-loop\-count=\fR\fB\fIN\fR\fR
.sp
In sequential test mode, the number of loops to execute before exiting\&.
@ -141,12 +141,12 @@ In sequential test mode, the number of loops to execute before exiting\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: mysqltest option
.\" mysqltest option: mysql-stress-test.pl
\fB\-\-mysqltest=\fR\fB\fIpath\fR\fR
.\" mariadb-stress-test.pl: mariadb-test option
.\" mariadb-test option: mariadb-stress-test.pl
\fB\-\-mariadb-test=\fR\fB\fIpath\fR\fR
.sp
The path name to the
\fBmysqltest\fR
\fBmariadb-test\fR
program\&.
.RE
.sp
@ -158,8 +158,8 @@ program\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: server-database option
.\" server-database option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: server-database option
.\" server-database option: mariadb-stress-test.pl
\fB\-\-server\-database=\fR\fB\fIdb_name\fR\fR
.sp
The database to use for the tests\&. The default is
@ -174,8 +174,8 @@ test\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: server-host option
.\" server-host option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: server-host option
.\" server-host option: mariadb-stress-test.pl
\fB\-\-server\-host=\fR\fB\fIhost_name\fR\fR
.sp
The host name of the local host to use for making a TCP/IP connection to the local server\&. By default, the connection is made to
@ -191,8 +191,8 @@ using a Unix socket file\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: server-logs-dir option
.\" server-logs-dir option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: server-logs-dir option
.\" server-logs-dir option: mariadb-stress-test.pl
\fB\-\-server\-logs\-dir=\fR\fB\fIpath\fR\fR
.sp
This option is required\&.
@ -208,8 +208,8 @@ is the directory where all client session logs will be stored\&. Usually this is
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: server-password option
.\" server-password option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: server-password option
.\" server-password option: mariadb-stress-test.pl
\fB\-\-server\-password=\fR\fB\fIpassword\fR\fR
.sp
The password to use when connecting to the server\&.
@ -223,8 +223,8 @@ The password to use when connecting to the server\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: server-port option
.\" server-port option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: server-port option
.\" server-port option: mariadb-stress-test.pl
\fB\-\-server\-port=\fR\fB\fIport_num\fR\fR
.sp
The TCP/IP port number to use for connecting to the server\&. The default is 3306\&.
@ -238,13 +238,13 @@ The TCP/IP port number to use for connecting to the server\&. The default is 330
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: server-socket option
.\" server-socket option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: server-socket option
.\" server-socket option: mariadb-stress-test.pl
\fB\-\-server\-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\&. The default is
/tmp/mysql\&.sock\&.
/tmp/mariadb\&.sock\&.
.RE
.sp
.RS 4
@ -255,8 +255,8 @@ localhost, the Unix socket file to use, or, on Windows, the name of the named pi
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: server-user option
.\" server-user option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: server-user option
.\" server-user option: mariadb-stress-test.pl
\fB\-\-server\-user=\fR\fB\fIuser_name\fR\fR
.sp
The MariaDB user name to use when connecting to the server\&. The default is
@ -271,8 +271,8 @@ root\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: sleep-time option
.\" sleep-time option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: sleep-time option
.\" sleep-time option: mariadb-stress-test.pl
\fB\-\-sleep\-time=\fR\fB\fIN\fR\fR
.sp
The delay in seconds between test executions\&.
@ -286,8 +286,8 @@ The delay in seconds between test executions\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: stress-basedir option
.\" stress-basedir option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: stress-basedir option
.\" stress-basedir option: mariadb-stress-test.pl
\fB\-\-stress\-basedir=\fR\fB\fIpath\fR\fR
.sp
This option is required\&.
@ -303,8 +303,8 @@ is the working directory for the test run\&. It is used as the temporary locatio
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: stress-datadir option
.\" stress-datadir option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: stress-datadir option
.\" stress-datadir option: mariadb-stress-test.pl
\fB\-\-stress\-datadir=\fR\fB\fIpath\fR\fR
.sp
The directory of data files to be used during testing\&. The default location is the
@ -322,8 +322,8 @@ option\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: stress-init-file option
.\" stress-init-file option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: stress-init-file option
.\" stress-init-file option: mariadb-stress-test.pl
\fB\-\-stress\-init\-file[=\fR\fB\fIpath\fR\fR\fB]\fR
.sp
\fIfile_name\fR
@ -340,8 +340,8 @@ in the test suite directory\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: stress-mode option
.\" stress-mode option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: stress-mode option
.\" stress-mode option: mariadb-stress-test.pl
\fB\-\-stress\-mode=\fR\fB\fImode\fR\fR
.sp
This option indicates the test order in stress\-test mode\&. The
@ -362,8 +362,8 @@ random\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: stress-suite-basedir option
.\" stress-suite-basedir option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: stress-suite-basedir option
.\" stress-suite-basedir option: mariadb-stress-test.pl
\fB\-\-stress\-suite\-basedir=\fR\fB\fIpath\fR\fR
.sp
This option is required\&.
@ -387,8 +387,8 @@ option\&.)
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: stress-tests-file option
.\" stress-tests-file option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: stress-tests-file option
.\" stress-tests-file option: mariadb-stress-test.pl
\fB\-\-stress\-tests\-file[=\fR\fB\fIfile_name\fR\fR\fB]\fR
.sp
Use this option to run the stress tests\&.
@ -409,14 +409,14 @@ in the stress suite directory\&. (See
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: suite option
.\" suite option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: suite option
.\" suite option: mariadb-stress-test.pl
\fB\-\-suite=\fR\fB\fIsuite_name\fR\fR
.sp
Run the named test suite\&. The default name is
main
(the regular test suite located in the
mysql\-test
mariadb\-test
directory)\&.
.RE
.sp
@ -428,8 +428,8 @@ directory)\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: test-count option
.\" test-count option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: test-count option
.\" test-count option: mariadb-stress-test.pl
\fB\-\-test\-count=\fR\fB\fIN\fR\fR
.sp
The number of tests to execute before exiting\&.
@ -443,8 +443,8 @@ The number of tests to execute before exiting\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: test-duration option
.\" test-duration option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: test-duration option
.\" test-duration option: mariadb-stress-test.pl
\fB\-\-test\-duration=\fR\fB\fIN\fR\fR
.sp
The duration of stress testing in seconds\&.
@ -458,8 +458,8 @@ The duration of stress testing in seconds\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: threads option
.\" threads option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: threads option
.\" threads option: mariadb-stress-test.pl
\fB\-\-threads=\fR\fB\fIN\fR\fR
.sp
The number of threads\&. The default is 1\&.
@ -473,8 +473,8 @@ The number of threads\&. The default is 1\&.
.sp -1
.IP \(bu 2.3
.\}
.\" mysql-stress-test.pl: verbose option
.\" verbose option: mysql-stress-test.pl
.\" mariadb-stress-test.pl: verbose option
.\" verbose option: mariadb-stress-test.pl
\fB\-\-verbose\fR
.sp
Verbose mode\&. Print more information about what the program does\&.
@ -482,7 +482,7 @@ Verbose mode\&. Print more information about what the program does\&.
.SH "COPYRIGHT"
.br
.PP
Copyright \(co 2007, 2010, Oracle and/or its affiliates, 2010-2020 MariaDB Foundation
Copyright \(co 2007, 2010, Oracle and/or its affiliates, 2010-2024 MariaDB Foundation
.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

646
man/mysql-test-run.pl.1
View file

File diff suppressed because it is too large Load diff

18
man/mysql.server.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBMYSQL\&.SERVER\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBMYSQL\&.SERVER\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -35,7 +35,7 @@ directory with the name
mysql\&. You need not install it manually\&.
.PP
Some vendors provide RPM packages that install a startup script under a different name such as
\fBmysqld\fR\&.
\fBmariadbd\fR\&.
.PP
If you install MariaDB from a source distribution or using a binary distribution format that does not install
\fBmysql\&.server\fR
@ -45,7 +45,7 @@ automatically, you can install it manually\&.
reads options from the
[mysql\&.server]
and
[mysqld]
[mariadbd]
sections of option files\&. For backward compatibility, it also reads
[mysql_server]
sections, although you should rename such sections to
@ -124,12 +124,12 @@ exits with an error\&. The default value is 900\&. A value of 0 means not to wai
.sp -1
.IP \(bu 2.3
.\}
.\" mysql.server: use-mysqld_safe option
.\" use-mysqld_safe option: mysql.server
\fB\-\-use\-mysqld_safe\fR
.\" mysql.server: use-mariadbd_safe option
.\" use-mariadbd_safe option: mysql.server
\fB\-\-use\-mariadbd_safe\fR
.sp
Use
\fBmysqld_safe\fR
\fBmariadbd_safe\fR
to start the server\&. This is the default\&.
.RE
.sp
@ -161,12 +161,12 @@ Use Instance Manager to start the server\&.
\fB\-\-user=\fR\fB\fIuser_name\fR\fR
.sp
The login user name to use for running
\fBmysqld\fR\&.
\fBmariadbd\fR\&.
.RE
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

2
man/mytop.1
View file

@ -1,4 +1,4 @@
.TH MYTOP "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH MYTOP "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.SH NAME
mytop \- display MariaDB server performance info like 'top'
.SH "SEE ALSO"

4
man/perror.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBPERROR\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBPERROR\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -143,7 +143,7 @@ Display version information and exit\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

4
man/replace.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBREPLACE\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBREPLACE\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -153,7 +153,7 @@ Display version information and exit\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

8
man/resolve_stack_dump.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBRESOLVE_STACK_DUMP\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBRESOLVE_STACK_DUMP\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -37,9 +37,9 @@ shell> \fBresolve_stack_dump [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIsymbols_file\f
.\}
.PP
The symbols file should include the output from the
\fBnm \-\-numeric\-sort mysqld\fR
\fBnm \-\-numeric\-sort mariadbd\fR
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\&.
\fBmariadbd\fR\&. If no numeric dump file is named on the command line, the stack trace is read from the standard input\&.
.PP
\fBresolve_stack_dump\fR
supports the following options\&.
@ -110,7 +110,7 @@ Display version information and exit\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

4
man/resolveip.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBRESOLVEIP\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBRESOLVEIP\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@ -92,7 +92,7 @@ Display version information and exit\&.
.SH "COPYRIGHT"
.br
.PP
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2020 MariaDB Foundation
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2024 MariaDB Foundation
.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

2
man/wsrep_sst_backup.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\FBWSREP_SST_BACKUP\FR" "1" "22 May 2022" "MariaDB 10\&.3" "MariaDB Database System"
.TH "\FBWSREP_SST_BACKUP\FR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------

2
man/wsrep_sst_common.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBWSREP_SST_COMMON\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBWSREP_SST_COMMON\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------

2
man/wsrep_sst_mariabackup.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBWSREP_SST_MARIABACKUP\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBWSREP_SST_MARIABACKUP\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------

2
man/wsrep_sst_mysqldump.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBWSREP_SST_MYSQLDUMP\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBWSREP_SST_MYSQLDUMP\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------

2
man/wsrep_sst_rsync.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBWSREP_SST_RSYNC\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBWSREP_SST_RSYNC\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------

2
man/wsrep_sst_rsync_wan.1
View file

@ -1,6 +1,6 @@
'\" t
.\"
.TH "\fBWSREP_SST_RSYNC_WAN\fR" "1" "15 May 2020" "MariaDB 10.11" "MariaDB Database System"
.TH "\fBWSREP_SST_RSYNC_WAN\fR" "1" "3 September 2024" "MariaDB 11.4" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------