glfs/server/databases/mariadb.xml

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;


  <!ENTITY mariadb-download-http "https://downloads.mariadb.org/interstitial/mariadb-&mariadb-version;/source/mariadb-&mariadb-version;.tar.gz"> 
  <!ENTITY mariadb-download-ftp  "ftp://mirrors.fe.up.pt/pub/mariadb/mariadb-&mariadb-version;/source/mariadb-&mariadb-version;.tar.gz">
  <!ENTITY mariadb-md5sum        "f93cbd5bfde3c0d082994764ff7db580">
  <!ENTITY mariadb-size          "70 MB">
  <!ENTITY mariadb-buildsize     "1.3 GB">
  <!ENTITY mariadb-time          "7.8 SBU (with parallelism=4, add 0.5 SBU for tests)">
]>

<sect1 id="mariadb" xreflabel="MariaDB-&mariadb-version;">
  <?dbhtml filename="mariadb.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>MariaDB-&mariadb-version;</title>

  <indexterm zone="mariadb">
    <primary sortas="a-MariaDB">MariaDB</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to MariaDB</title>

    <para>
      <application>MariaDB</application> is a community-developed fork and a
      drop-in replacement for the <application>MySQL</application> relational
      database management system.
    </para>

    &lfs81_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Download (HTTP): <ulink url="&mariadb-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download (FTP): <ulink url="&mariadb-download-ftp;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download MD5 sum: &mariadb-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Download size: &mariadb-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated disk space required: &mariadb-buildsize;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated build time: &mariadb-time;
        </para>
      </listitem>
    </itemizedlist>

    <note><para>The installed size of MariaDB is 473 MB, but this can be
    reduced by about 200 MB, if desired, by removing the /usr/share/mysql/test
    directory after installation.</para></note>

    <bridgehead renderas="sect3">MariaDB Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="cmake"/> and
      <xref linkend="openssl"/>
    </para>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended">
      <xref linkend="libevent"/>
    </para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional">
      <xref linkend="boost"/>,
      <xref linkend="libxml2"/>,
      <xref linkend="linux-pam"/>,
      <xref linkend="mitkrb"/>,
      <xref linkend="pcre"/>,
      <xref linkend="ruby"/>,
      <xref linkend="unixodbc"/>,
      <xref linkend="valgrind"/>,
      <ulink url="http://groonga.org/">Groonga</ulink>,
      <ulink url="http://www.phontron.com/kytea/">KyTea</ulink>,
      <ulink url="http://sourceforge.net/projects/judy/">Judy</ulink>,
      <ulink url="http://packages.debian.org/source/sid/libaio">libaio</ulink>,
      <ulink url="https://github.com/Cyan4973/lz4">lz4</ulink>,
      <ulink url="http://taku910.github.io/mecab">MeCab</ulink>,
      <ulink url="http://msgpack.org/">MessagePack</ulink>,
      <ulink url="http://www.mruby.org/">mruby</ulink>,
      <ulink url="http://sphinxsearch.com/downloads/">Sphinx</ulink>,
      <ulink url="https://mariadb.com/kb/en/mariadb/tokudb/">TokuDB</ulink>, and
      <ulink url="http://zeromq.org/">ZeroMQ</ulink>
    </para>

    <para condition="html" role="usernotes">User Notes:
      <ulink url="&blfs-wiki;/mariadb"/>
    </para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of MariaDB</title>

    <warning>
      <para>
        MariaDB and MySQL cannot be installed on the same system without
        extensive changes to the build configuration of one of the two applications.
      </para>
    </warning>

    <para>
      For security reasons, running the server as an unprivileged user
      and group is strongly encouraged. Issue the following (as
      <systemitem class="username">root</systemitem>) to create the
      user and group:
    </para>

<screen role="root"><userinput>groupadd -g 40 mysql &amp;&amp;
useradd -c "MySQL Server" -d /srv/mysql -g mysql -s /bin/false -u 40 mysql</userinput></screen>

    <para>
      Install <application>MariaDB</application> by running the
      following commands:
    </para>

<screen><userinput>sed -i "s@data/test@\${INSTALL_MYSQLTESTDIR}@g" sql/CMakeLists.txt &amp;&amp;
sed -i '/void..coc_malloc/{s/char ./&amp;x/; s/int/&amp; y/}' mysys_ssl/openssl.c &amp;&amp;

mkdir build &amp;&amp;
cd build    &amp;&amp;

cmake -DCMAKE_BUILD_TYPE=Release                      \
      -DCMAKE_INSTALL_PREFIX=/usr                     \
      -DINSTALL_DOCDIR=share/doc/mariadb-&mariadb-version;       \
      -DINSTALL_DOCREADMEDIR=share/doc/mariadb-&mariadb-version; \
      -DINSTALL_MANDIR=share/man                      \
      -DINSTALL_MYSQLSHAREDIR=share/mysql             \
      -DINSTALL_MYSQLTESTDIR=share/mysql/test         \
      -DINSTALL_PLUGINDIR=lib/mysql/plugin            \
      -DINSTALL_SBINDIR=sbin                          \
      -DINSTALL_SCRIPTDIR=bin                         \
      -DINSTALL_SQLBENCHDIR=share/mysql/bench         \
      -DINSTALL_SUPPORTFILESDIR=share/mysql           \
      -DMYSQL_DATADIR=/srv/mysql                      \
      -DMYSQL_UNIX_ADDR=/run/mysqld/mysqld.sock       \
      -DWITH_EXTRA_CHARSETS=complex                   \
      -DWITH_EMBEDDED_SERVER=ON                       \
      -DSKIP_TESTS=ON                                 \
      -DTOKUDB_OK=0                                   \
      .. &amp;&amp;
make</userinput></screen>

    <para>
      To test the results, issue: <command>make test</command>.
    </para>

    <note><para>
      A more extensive set of tests can be run with the following:</para>

<screen><userinput>pushd mysql-test
./mtr --parallel &lt;N&gt; --mem --force
popd</userinput></screen>

    <para>
      Where N is the number of tests to run in parallel. A little
      over 3700 tests are run in about 14 SBU with N=4.  Three tests 
      are known to fail due to character set issues.  
    </para></note>

    <para>
      Now, as the <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>make install &amp;&amp;
ln -sfv /usr/include/mysql/{mariadb,mysql}_version.h</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para>
      <command>sed -i ... sql/CMakeLists.txt</command>: Set correct installation
      directory for some components.
    </para>

    <para>
      <command>sed -i ... mysys_ssl/openssl.c</command>: Fix a build problem
      in the current version of the application.
    </para>

    <para>
      <parameter>-DWITH_EMBEDDED_SERVER=ON</parameter>: This switch enables
      compiling the embedded server library needed by certain applications,
      such as <application>Amarok</application>..
    </para>

    <para>
      <parameter>-DWITH_EXTRA_CHARSETS=complex</parameter>: This switch enables
      support for the complex character sets.
    </para>

    <para>
      <parameter>-DSKIP_TESTS=ON</parameter>: This switch disables
      tests for MariaDB Connector/C which are not supported without 
      additional setup.
    </para>

    <para>
      <option>-DWITHOUT_SERVER=ON</option>: Use this
      switch if you don't want the server and would like to build the client
      only.
    </para>

    <note><para>
      There are numerous options available to <command>cmake</command>. Check
      the output of the <command>cmake . -LH</command> for additional
      customization options.
    </para></note>

    <para>
      <command>ln -s /usr/include/mysql/{mariadb,mysql}_version.h</command>: 
      Some applications, for example <xref linkend='qt5'/>, look specifically for 
      mysql_version.h.  This symbolic link ensures the proper file can be found.
    </para>


  </sect2>

  <sect2 role="configuration">
    <title>Configuring MySQL</title>

    <sect3 id="mariadb-config">
      <title>Config Files</title>

      <para>
        <filename>/etc/mysql/my.cnf</filename> and
        <filename>~/.my.cnf</filename>
      </para>

      <indexterm zone="mariadb mariadb-config">
        <primary sortas="e-AA.my.cnf">~/.my.cnf</primary>
      </indexterm>

      <indexterm zone="mariadb mariadb-config">
        <primary sortas="e-etc-mysql-my.cnf">/etc/mysql/my.cnf</primary>
      </indexterm>

    </sect3>

    <sect3>
      <title>Configuration Information</title>

      <para>
        Create basic <filename>/etc/mysql/my.cnf</filename>
        using the following command as the <systemitem
        class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>install -v -dm 755 /etc/mysql &amp;&amp;
cat &gt; /etc/mysql/my.cnf &lt;&lt; "EOF"
<literal># Begin /etc/mysql/my.cnf

# The following options will be passed to all MySQL clients
[client]
#password       = your_password
port            = 3306
socket          = /run/mysqld/mysqld.sock

# The MySQL server
[mysqld]
port            = 3306
socket          = /run/mysqld/mysqld.sock
datadir         = /srv/mysql
skip-external-locking
key_buffer_size = 16M
max_allowed_packet = 1M
sort_buffer_size = 512K
net_buffer_length = 16K
myisam_sort_buffer_size = 8M

# Don't listen on a TCP/IP port at all.
skip-networking

# required unique id between 1 and 2^32 - 1
server-id       = 1

# Uncomment the following if you are using BDB tables
#bdb_cache_size = 4M
#bdb_max_lock = 10000

# InnoDB tables are now used by default
innodb_data_home_dir = /srv/mysql
innodb_log_group_home_dir = /srv/mysql
# All the innodb_xxx values below are the default ones:
innodb_data_file_path = ibdata1:12M:autoextend
# You can set .._buffer_pool_size up to 50 - 80 %
# of RAM but beware of setting memory usage too high
innodb_buffer_pool_size = 128M<!--
This variable has been removed in version 10.2.2:
innodb_additional_mem_pool_size = 2M-->
innodb_log_file_size = 48M
innodb_log_buffer_size = 16M
innodb_flush_log_at_trx_commit = 1
innodb_lock_wait_timeout = 50

[mysqldump]
quick
max_allowed_packet = 16M

[mysql]
no-auto-rehash
# Remove the next comment character if you are not familiar with SQL
#safe-updates

[isamchk]
key_buffer = 20M
sort_buffer_size = 20M
read_buffer = 2M
write_buffer = 2M

[myisamchk]
key_buffer_size = 20M
sort_buffer_size = 20M
read_buffer = 2M
write_buffer = 2M

[mysqlhotcopy]
interactive-timeout

# End /etc/mysql/my.cnf</literal>
EOF</userinput></screen>

      <para>
        You can now install a database and change the ownership to the
        unprivileged user and group (perform as the <systemitem
        class="username">root</systemitem> user):
      </para>

<screen role="root"><userinput>mysql_install_db --basedir=/usr --datadir=/srv/mysql --user=mysql &amp;&amp;
chown -R mysql:mysql /srv/mysql</userinput></screen>

      <para>
        Further configuration requires that the
        <application>MariaDB</application> server is running. Start
        the server using the following commands as the <systemitem
        class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>install -v -m755 -o mysql -g mysql -d /run/mysqld &amp;&amp;
mysqld_safe --user=mysql 2&gt;&amp;1 &gt;/dev/null &amp;</userinput></screen>

      <para>
        A default installation does not set up a password for the
        administrator, so use the following command as the <systemitem
        class="username">root</systemitem> user to set one.
      </para>

<screen role="root"><userinput>mysqladmin -u root password</userinput></screen>

      <para>
        Configuration of the server is now finished. Shut the server
        down using the following command as the <systemitem
        class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>mysqladmin -p shutdown</userinput></screen>

    </sect3>

    <sect3 id="mariadb-init">
      <title><phrase revision="sysv">Boot Script</phrase>
             <phrase revision="systemd">Systemd Unit</phrase></title>

      <para>
        Install the
        <phrase revision="sysv"><filename>/etc/rc.d/init.d/mysql</filename> init
        script</phrase>
        <phrase revision="systemd"><filename>mysqld.service</filename>
        unit</phrase> included in the
        <xref linkend="bootscripts" revision="sysv"/>
        <xref linkend="systemd-units" revision="systemd"/> package as
        the <systemitem class="username">root</systemitem> user to start the
        <application>MariaDB</application> server during system boot-up.
      </para>

      <indexterm zone="mariadb mariadb-init">
        <primary sortas="f-mysql">mysql</primary>
      </indexterm>

<screen role="root" revision="sysv"><userinput>make install-mysql</userinput></screen>

<screen role="root" revision="systemd"><userinput>make install-mysqld</userinput></screen>

    </sect3>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>
          aria_chk, aria_dump_log, aria_ftdump, aria_pack, aria_read_log,
          galara_new_cluster, galara_recovery,
          innochecksum, maria_add_gis_sp.sql, msql2mysql, my_print_defaults,
          myisam_ftdump, myisamchk, myisamlog, myisampack, mysql,
          mysql_client_test, mysql_client_test_embedded, mysql_config,
          mysql_convert_table_format, mysql_embedded, mysql_find_rows,
          mysql_fix_extensions, mysql_install_db, mysql_plugin,
          mysql_secure_installation, mysql_setpermission, mysql_tzinfo_to_sql,
          mysql_upgrade, mysql_waitpid, mysql_zap, mysqlaccess, mysqladmin,
          mysqlbinlog, mysqlbug, mysqlcheck, mysqld, mysqld_multi, mysqld_safe,
          mysqldump, mysqldumpslow, mysqlhotcopy, mysqlimport, mysqlshow,
          mysqlslap, mysqltest, mysqltest_embedded, mytop, perror, replace,
          resolve_stack_dump, resolveip, wsrep_sst_common, wsrep_sst_mysqldump,
          wsrep_sst_rsync, wsrep_sst_xtrabackup, and wsrep_sst_xtrabackup-v2
        </seg>
        <seg>
          libmysqlclient.{so,a},
          libmysqlclient_r.{so,a} (symbolic links to libmysqlclient.{so,a}),
          libmysqld.{so,a}, libmysqlservices.a,
          and several under /usr/lib/mysql/plugin/
        </seg>
        <seg>
          /etc/mysql,
          /usr/{include,lib,share}/mysql, and
          /usr/share/doc/mariadb-&mariadb-version;
        </seg>
      </seglistitem>
    </segmentedlist>

    <bridgehead renderas="sect3">Short Descriptions</bridgehead>

<!--
    <para>
      Descriptions of all the programs and libraries would be several
      pages long. Instead, consult the man pages
      or the online documentation at <ulink
      url="https://mariadb.com/kb/en/mariadb-documentation/"/>.
    </para>
-->
    <para>
      The <application>Perl</application> DBI modules must be installed
      for some of the <application>MariaDB</application> support programs to
      function properly.
    </para>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="aria_chk-mariadb">
        <term><command>aria_chk</command></term>
        <listitem>
          <para>
            is used to check, repair, optimize, sort and get information
            about Aria tables.
          </para>
          <indexterm zone="mariadb aria_chk-mariadb">
            <primary sortas="b-aria_chk-mariadb">aria_chk</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="aria_dump_log-mariadb">
        <term><command>aria_dump_log</command></term>
        <listitem>
          <para>
            is a tool to dump content of Aria log pages.
          </para>
          <indexterm zone="mariadb aria_dump_log-mariadb">
            <primary sortas="b-aria_dump_log-mariadb">aria_dump_log</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="aria_ftdump-mariadb">
        <term><command>aria_ftdump</command></term>
        <listitem>
          <para>
            displays full-text index information.
          </para>
          <indexterm zone="mariadb aria_ftdump-mariadb">
            <primary sortas="b-aria_ftdump-mariadb">aria_ftdump</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="aria_pack-mariadb">
        <term><command>aria_pack</command></term>
        <listitem>
          <para>
            is a tool to generate compressed, read-only Aria tables.
          </para>
          <indexterm zone="mariadb aria_pack-mariadb">
            <primary sortas="b-aria_pack-mariadb">aria_pack</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="aria_read_log-mariadb">
        <term><command>aria_read_log</command></term>
        <listitem>
          <para>
            displays Aria log file contents.
          </para>
          <indexterm zone="mariadb aria_read_log-mariadb">
            <primary sortas="b-aria_read_log-mariadb">aria_read_log</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="innochecksum-mariadb">
        <term><command>innochecksum</command></term>
        <listitem>
          <para>
            prints checksums for InnoDB files.
          </para>
          <indexterm zone="mariadb innochecksum-mariadb">
            <primary sortas="b-innochecksum-mariadb">innochecksum</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="maria_add_gis_sp.sql-mariadb">
        <term><command>maria_add_gis_sp.sql</command></term>
        <listitem>
          <para>
            this script creates stored procedures required by the OpenGIS
            standards, and is prepared to be run with the --bootstrap server
            option.
          </para>
          <indexterm zone="mariadb maria_add_gis_sp.sql-mariadb">
            <primary sortas="b-maria_add_gis_sp.sql-mariadb">maria_add_gis_sp.sql</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="msql2mysql-mariadb">
        <term><command>msql2mysql</command></term>
        <listitem>
          <para>
            is a tool to convert mSQL programs for use with MySQL.
          </para>
          <indexterm zone="mariadb msql2mysql-mariadb">
            <primary sortas="b-msql2mysql-mariadb">msql2mysql</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="my_print_defaults-mariadb">
        <term><command>my_print_defaults</command></term>
        <listitem>
          <para>
            displays the options from option groups of option files.
          </para>
          <indexterm zone="mariadb my_print_defaults-mariadb">
            <primary sortas="b-my_print_defaults-mariadb">my_print_defaults</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="myisam_ftdump-mariadb">
        <term><command>myisam_ftdump</command></term>
        <listitem>
          <para>
            displays information about FULLTEXT indexes in MyISAM tables.
          </para>
          <indexterm zone="mariadb myisam_ftdump-mariadb">
            <primary sortas="b-myisam_ftdump-mariadb">myisam_ftdump</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="myisamchk-mariadb">
        <term><command>myisamchk</command></term>
        <listitem>
          <para>
            gets information about your database tables or checks, repairs,
            or optimizes them.
          </para>
          <indexterm zone="mariadb myisamchk-mariadb">
            <primary sortas="b-myisamchk-mariadb">myisamchk</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="myisamlog-mariadb">
        <term><command>myisamlog</command></term>
        <listitem>
          <para>
            displays MyISAM log file contents.
          </para>
          <indexterm zone="mariadb myisamlog-mariadb">
            <primary sortas="b-myisamlog-mariadb">myisamlog</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="myisampack-mariadb">
        <term><command>myisampack</command></term>
        <listitem>
          <para>
            is a tool for compressing MyISAM tables.
          </para>
          <indexterm zone="mariadb myisampack-mariadb">
            <primary sortas="b-myisampack-mariadb">myisampack</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysql-mariadb">
        <term><command>mysql</command></term>
        <listitem>
          <para>
             is a simple SQL shell with input line editing capabilities.
          </para>
          <indexterm zone="mariadb mysql-mariadb">
            <primary sortas="b-mysql-mariadb">mysql</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysql_client_test-mariadb">
        <term><command>mysql_client_test</command></term>
        <listitem>
          <para>
            is used for testing aspects of the MySQL client API that cannot be
            tested using mysqltest and its test language.
          </para>
          <indexterm zone="mariadb mysql_client_test-mariadb">
            <primary sortas="b-mysql_client_test-mariadb">mysql_client_test</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysql_client_test_embedded-mariadb">
        <term><command>mysql_client_test_embedded</command></term>
        <listitem>
          <para>
            is a tool to test client API for embedded server.
          </para>
          <indexterm zone="mariadb mysql_client_test_embedded-mariadb">
            <primary sortas="b-mysql_client_test_embedded-mariadb">mysql_client_test_embedded</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysql_config-mariadb">
        <term><command>mysql_config</command></term>
        <listitem>
          <para>
            provides you with useful information for compiling your MySQL
            client and connecting it to MySQL.
          </para>
          <indexterm zone="mariadb mysql_config-mariadb">
            <primary sortas="b-mysql_config-mariadb">mysql_config</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysql_convert_table_format-mariadb">
        <term><command>mysql_convert_table_format</command></term>
        <listitem>
          <para>
            converts the tables in a database to use a particular storage
            engine.
          </para>
          <indexterm zone="mariadb mysql_convert_table_format-mariadb">
            <primary sortas="b-mysql_convert_table_format-mariadb">mysql_convert_table_format</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysql_embedded-mariadb">
        <term><command>mysql_embedded</command></term>
        <listitem>
          <para>
            is a MySQL client statically linked to
            libmysqld.
          </para>
          <indexterm zone="mariadb mysql_embedded-mariadb">
            <primary sortas="b-mysql_embedded-mariadb">mysql_embedded</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysql_find_rows-mariadb">
        <term><command>mysql_find_rows</command></term>
        <listitem>
          <para>
            reads files containing SQL statements and extracts statements that
            match a given regular expression or that contain USE db_name or
            SET statements.
          </para>
          <indexterm zone="mariadb mysql_find_rows-mariadb">
            <primary sortas="b-mysql_find_rows-mariadb">mysql_find_rows</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysql_fix_extensions-mariadb">
        <term><command>mysql_fix_extensions</command></term>
        <listitem>
          <para>
            converts the extensions for MyISAM (or ISAM ) table files to
            their canonical forms.
          </para>
          <indexterm zone="mariadb mysql_fix_extensions-mariadb">
            <primary sortas="b-mysql_fix_extensions-mariadb">mysql_fix_extensions</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysql_install_db-mariadb">
        <term><command>mysql_install_db</command></term>
        <listitem>
          <para>
            initializes the MySQL data directory and creates the system
            tables that it contains, if they do not exist.
          </para>
          <indexterm zone="mariadb mysql_install_db-mariadb">
            <primary sortas="b-mysql_install_db-mariadb">mysql_install_db</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysql_plugin-mariadb">
        <term><command>mysql_plugin</command></term>
        <listitem>
          <para>
            is a utility that enable MySQL administrators to manage which
            plugins a MySQL server loads.
          </para>
          <indexterm zone="mariadb mysql_plugin-mariadb">
            <primary sortas="b-mysql_plugin-mariadb">mysql_plugin</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysql_secure_installation-mariadb">
        <term><command>mysql_secure_installation</command></term>
        <listitem>
          <para>
            is a tool to improve MySQL installation security.
          </para>
          <indexterm zone="mariadb mysql_secure_installation-mariadb">
            <primary sortas="b-mysql_secure_installation-mariadb">mysql_secure_installation</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysql_setpermission-mariadb">
        <term><command>mysql_setpermission</command></term>
        <listitem>
          <para>
            sets permissions in the MySQL grant tables.
          </para>
          <indexterm zone="mariadb mysql_setpermission-mariadb">
            <primary sortas="b-mysql_setpermission-mariadb">mysql_setpermission</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysql_tzinfo_to_sql-mariadb">
        <term><command>mysql_tzinfo_to_sql</command></term>
        <listitem>
          <para>
            loads the time zone tables in the mysql database.
          </para>
          <indexterm zone="mariadb mysql_tzinfo_to_sql-mariadb">
            <primary sortas="b-mysql_tzinfo_to_sql-mariadb">mysql_tzinfo_to_sql</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysql_upgrade-mariadb">
        <term><command>mysql_upgrade</command></term>
        <listitem>
          <para>
            examines all tables in all databases for incompatibilities with
            the current version of MySQL Server.
          </para>
          <indexterm zone="mariadb mysql_upgrade-mariadb">
            <primary sortas="b-mysql_upgrade-mariadb">mysql_upgrade</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysql_waitpid-mariadb">
        <term><command>mysql_waitpid</command></term>
        <listitem>
          <para>
            signals a process to terminate and waits for the process to exit.
          </para>
          <indexterm zone="mariadb mysql_waitpid-mariadb">
            <primary sortas="b-mysql_waitpid-mariadb">mysql_waitpid</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysql_zap-mariadb">
        <term><command>mysql_zap</command></term>
        <listitem>
          <para>
            is a tool to kill processes that match a pattern.
          </para>
          <indexterm zone="mariadb mysql_zap-mariadb">
            <primary sortas="b-mysql_zap-mariadb">mysql_zap</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysqlaccess-mariadb">
        <term><command>mysqlaccess</command></term>
        <listitem>
          <para>
            checks the access privileges for a host name, user name, and
            database combination.
          </para>
          <indexterm zone="mariadb mysqlaccess-mariadb">
            <primary sortas="b-mysqlaccess-mariadb">mysqlaccess</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysqladmin-mariadb">
        <term><command>mysqladmin</command></term>
        <listitem>
          <para>
            is a client for performing administrative operations.
          </para>
          <indexterm zone="mariadb mysqladmin-mariadb">
            <primary sortas="b-mysqladmin-mariadb">mysqladmin</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysqlbinlog-mariadb">
        <term><command>mysqlbinlog</command></term>
        <listitem>
          <para>
            read binary log files.
          </para>
          <indexterm zone="mariadb mysqlbinlog-mariadb">
            <primary sortas="b-mysqlbinlog-mariadb">mysqlbinlog</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysqlbug-mariadb">
        <term><command>mysqlbug</command></term>
        <listitem>
          <para>
            is a tool to generate bug report.
          </para>
          <indexterm zone="mariadb mysqlbug-mariadb">
            <primary sortas="b-mysqlbug-mariadb">mysqlbug</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysqlcheck-mariadb">
        <term><command>mysqlcheck</command></term>
        <listitem>
          <para>
            performs table maintenance: It checks, repairs, optimizes,
            or analyzes tables.
          </para>
          <indexterm zone="mariadb mysqlcheck-mariadb">
            <primary sortas="b-mysqlcheck-mariadb">mysqlcheck</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysqld-mariadb">
        <term><command>mysqld</command></term>
        <listitem>
          <para>
            is the MySQL server daemon.
          </para>
          <indexterm zone="mariadb mysqld-mariadb">
            <primary sortas="b-mysqld-mariadb">mysqld</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysqld_multi-mariadb">
        <term><command>mysqld_multi</command></term>
        <listitem>
          <para>
            is designed to manage several mysqld processes that listen for
            connections on different Unix socket files and TCP/IP ports.
          </para>
          <indexterm zone="mariadb mysqld_multi-mariadb">
            <primary sortas="b-mysqld_multi-mariadb">mysqld_multi</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysqld_safe-mariadb">
        <term><command>mysqld_safe</command></term>
        <listitem>
          <para>
             is the recommended way to start a mysqld server on Unix
             and NetWare.
          </para>
          <indexterm zone="mariadb mysqld_safe-mariadb">
            <primary sortas="b-mysqld_safe-mariadb">mysqld_safe</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysqldump-mariadb">
        <term><command>mysqldump</command></term>
        <listitem>
          <para>
            is a backup program.
          </para>
          <indexterm zone="mariadb mysqldump-mariadb">
            <primary sortas="b-mysqldump-mariadb">mysqldump</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysqldumpslow-mariadb">
        <term><command>mysqldumpslow</command></term>
        <listitem>
          <para>
            parses MySQL slow query log files and prints a summary of their
            contents.
          </para>
          <indexterm zone="mariadb mysqldumpslow-mariadb">
            <primary sortas="b-mysqldumpslow-mariadb">mysqldumpslow</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysqlhotcopy-mariadb">
        <term><command>mysqlhotcopy</command></term>
        <listitem>
          <para>
            locks the table, flush the table and then performs a copy of
            the database.
          </para>
          <indexterm zone="mariadb mysqlhotcopy-mariadb">
            <primary sortas="b-mysqlhotcopy-mariadb">mysqlhotcopy</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysqlimport-mariadb">
        <term><command>mysqlimport</command></term>
        <listitem>
          <para>
            reads a range of data formats, and inserts the data into a
            database.
          </para>
          <indexterm zone="mariadb mysqlimport-mariadb">
            <primary sortas="b-mysqlimport-mariadb">mysqlimport</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysqlshow-mariadb">
        <term><command>mysqlshow</command></term>
        <listitem>
          <para>
            shows the structure of a MariaDB database.
          </para>
          <indexterm zone="mariadb mysqlshow-mariadb">
            <primary sortas="b-mysqlshow-mariadb">mysqlshow</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysqlslap-mariadb">
        <term><command>mysqlslap</command></term>
        <listitem>
          <para>
            is a diagnostic program designed to emulate client load for a
            MySQL server and to report the timing of each stage.
          </para>
          <indexterm zone="mariadb mysqlslap-mariadb">
            <primary sortas="b-mysqlslap-mariadb">mysqlslap</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysqltest-mariadb">
        <term><command>mysqltest</command></term>
        <listitem>
          <para>
            runs a test case against a MySQL server and optionally compares
            the output with a result file.
          </para>
          <indexterm zone="mariadb mysqltest-mariadb">
            <primary sortas="b-mysqltest-mariadb">mysqltest</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mysqltest_embedded-mariadb">
        <term><command>mysqltest_embedded</command></term>
        <listitem>
          <para>
            is similar to the <command>mysqltest</command> command but is built
            with support for the libmysqld embedded server.
          </para>
          <indexterm zone="mariadb mysqltest_embedded-mariadb">
            <primary sortas="b-mysqltest_embedded-mariadb">mysqltest_embedded</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mytop-mariadb">
        <term><command>mytop</command></term>
        <listitem>
          <para>
            is a console-based tool for monitoring the threads and overall
            performance of a MySQL server.
          </para>
          <indexterm zone="mariadb mytop-mariadb">
            <primary sortas="b-mytop-mariadb">mytop</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="perror-mariadb">
        <term><command>perror</command></term>
        <listitem>
          <para>
            is a utility that displays descriptions for system or storage
            engine error codes.
          </para>
          <indexterm zone="mariadb perror-mariadb">
            <primary sortas="b-perror-mariadb">perror</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="replace-mariadb">
        <term><command>replace</command></term>
        <listitem>
          <para>
            is a MariaDB/MySQL extension to the SQL standard.
          </para>
          <indexterm zone="mariadb replace-mariadb">
            <primary sortas="b-replace-mariadb">replace</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="resolve_stack_dump-mariadb">
        <term><command>resolve_stack_dump</command></term>
        <listitem>
          <para>
            resolves a numeric stack dump to symbols.
          </para>
          <indexterm zone="mariadb resolve_stack_dump-mariadb">
            <primary sortas="b-resolve_stack_dump-mariadb">resolve_stack_dump</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="resolveip-mariadb">
        <term><command>resolveip</command></term>
        <listitem>
          <para>
            is a utility for resolving IP addresses to host names and
            vice versa.
          </para>
          <indexterm zone="mariadb resolveip-mariadb">
            <primary sortas="b-resolveip-mariadb">resolveip</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>