OS Manuals

/usr/bin/mariadb-slap

The MariaDB open source relational database

From mariadb-12.3 12.3.3-r2 (os), captured 2026-11-05 by running mariadb-slap --help (exit 0). permalink

/usr/bin/mariadb-slap from 12.3.3-MariaDB, client 1.0 for Linux (x86_64)
Copyright (c) 2005, 2018, Oracle, MariaDB Corporation Ab and others.

Run a query multiple times against the server.

Usage: /usr/bin/mariadb-slap [OPTIONS]

Default options are read from the following files in the given order:
/etc/my.cnf /etc/mysql/my.cnf ~/.my.cnf
The following groups are read: mysqlslap mariadb-slap client client-server client-mariadb
The following options may be given as the first argument:
--print-defaults          Print the program argument list and exit.
--no-defaults             Don't read default options from any option file.
The following specify which files/extra groups are read (specified before remaining options):
--defaults-file=#         Only read default options from the given file #.
--defaults-extra-file=#   Read this file after the global files are read.
--defaults-group-suffix=# Additionally read default groups with # appended as a suffix.

  -?, --help          Display this help and exit.
  -a, --auto-generate-sql
                      Generate SQL where not supplied by file or command line.
  --auto-generate-sql-add-autoincrement
                      Add an AUTO_INCREMENT column to auto-generated tables.
  --auto-generate-sql-execute-number=#
                      Set this number to generate a set number of queries to
                      run.
  --auto-generate-sql-guid-primary
                      Add GUID based primary keys to auto-generated tables.
  --auto-generate-sql-load-type=name
                      Specify test load type: mixed, update, write, key, or
                      read; default is mixed.
  --auto-generate-sql-secondary-indexes=#
                      Number of secondary indexes to add to auto-generated
                      tables.
  --auto-generate-sql-unique-query-number=#
                      Number of unique queries to generate for automatic tests.
  --auto-generate-sql-unique-write-number=#
                      Number of unique queries to generate for
                      auto-generate-sql-write-number.
  --auto-generate-sql-write-number=#
                      Number of row inserts to perform for each thread (default
                      is 100).
  --character-sets-dir=name
                      Directory for character set files.
  --commit=#          Commit records every X number of statements.
  -C, --compress      Use compression in server/client protocol.
  -c, --concurrency=name
                      Number of clients to simulate for query to run.
  --create=name       File or string to use create tables.
  --create-schema=name
                      Schema to run tests in.
  --csv[=name]        Generate CSV output to named file or to stdout if no file
                      is named.
  -#, --debug[=#]     This is a non-debug version. Catch this and exit.
  --debug-check       Check memory and open file usage at exit.
  -T, --debug-info    Print some debug info at exit.
  --default-auth=name Default authentication client-side plugin to use.
  -F, --delimiter=name
                      Delimiter to use in SQL statements supplied in file or
                      command line.
  --detach=#          Detach (close and reopen) connections after X number of
                      requests.
  -e, --engine=name   Comma separated list of storage engines to use for
                      creating the table. The test is run for each engine. You
                      can also specify an option for an engine after a `:',
                      like memory:max_row=2300
  -h, --host=name     Connect to host. Defaults in the following order:
                      $MARIADB_HOST, and then localhost
  --init-command=name SQL Command to execute when connecting to MariaDB server.
                      Will automatically be re-executed when reconnecting.
  -i, --iterations=#  Number of times to run the tests.
  --no-drop           Do not drop the schema after the test.
  -x, --number-char-cols=name
                      Number of VARCHAR columns to create in table if
                      specifying --auto-generate-sql.
  -y, --number-int-cols=name
                      Number of INT columns to create in table if specifying
                      --auto-generate-sql.
  --number-of-queries=#
                      Limit each client to this number of queries (this is not
                      exact).
  --only-print        Do not connect to the databases, but instead print out
                      what would have been done.
  -p, --password[=name]
                      Password to use when connecting to server. If password is
                      not given it's asked from the tty.
  --plugin-dir=name   Directory for client-side plugins.
  -P, --port=#        Port number to use for connection.
  --post-query=name   Query to run or file containing query to execute after
                      tests have completed.
  --post-system=name  system() string to execute after tests have completed.
  --pre-query=name    Query to run or file containing query to execute before
                      running tests.
  --pre-system=name   system() string to execute before running tests.
  --protocol=name     The protocol to use for connection (tcp, socket, pipe).
  -q, --query=name    Query to run or file containing query to run.
  -s, --silent        Run program in silent mode - no output.
  -S, --socket=name   The socket file to use for connection.
  --ssl               Enable SSL for connection (automatically enabled with
                      other flags).
                      (Defaults to on; use --skip-ssl to disable.)
  --ssl-ca=name       CA file in PEM format (check OpenSSL docs, implies
                      --ssl).
  --ssl-capath=name   CA directory (check OpenSSL docs, implies --ssl).
  --ssl-cert=name     X509 cert in PEM format (implies --ssl).
  --ssl-cipher=name   SSL cipher to use (implies --ssl).
  --ssl-key=name      X509 key in PEM format (implies --ssl).
  --ssl-crl=name      Certificate revocation list (implies --ssl).
  --ssl-crlpath=name  Certificate revocation list path (implies --ssl).
  --tls-version=name  TLS protocol version for secure connection.
  --ssl-fp=name       Server certificate fingerprint (implies --ssl).
  --ssl-fplist=name   File with accepted server certificate fingerprints, one
                      per line (implies --ssl).
  --ssl-verify-server-cert
                      Verify server's certificate to prevent man-in-the-middle
                      attacks
                      (Defaults to on; use --skip-ssl-verify-server-cert to disable.)
  -u, --user=name     User for login if not current user.
  -v, --verbose       More verbose output; you can use this multiple times to
                      get even more verbose output.
  -V, --version       Output version information and exit.

Variables (--variable-name=value)
and boolean options {FALSE|TRUE}      Value (after reading options)
------------------------------------- ------------------------------------
auto-generate-sql                     FALSE
auto-generate-sql-add-autoincrement   FALSE
auto-generate-sql-execute-number      0
auto-generate-sql-guid-primary        FALSE
auto-generate-sql-load-type           mixed
auto-generate-sql-secondary-indexes   0
auto-generate-sql-unique-query-number 10
auto-generate-sql-unique-write-number 10
auto-generate-sql-write-number        100
character-sets-dir                    (No default value)
commit                                0
compress                              FALSE
concurrency                           (No default value)
create                                (No default value)
create-schema                         mysqlslap
debug-check                           FALSE
debug-info                            FALSE
default-auth                          (No default value)
delimiter

detach                                0
engine                                (No default value)
host                                  (No default value)
init-command                          (No default value)
iterations                            1
no-drop                               FALSE
number-char-cols                      (No default value)
number-int-cols                       (No default value)
number-of-queries                     0
only-print                            FALSE
plugin-dir                            (No default value)
port                                  3306
post-query                            (No default value)
post-system                           (No default value)
pre-query                             (No default value)
pre-system                            (No default value)
query                                 (No default value)
silent                                FALSE
socket                                (No default value)
ssl                                   TRUE
ssl-ca                                (No default value)
ssl-capath                            (No default value)
ssl-cert                              (No default value)
ssl-cipher                            (No default value)
ssl-key                               (No default value)
ssl-crl                               (No default value)
ssl-crlpath                           (No default value)
tls-version                           (No default value)
ssl-fp                                (No default value)
ssl-fplist                            (No default value)
ssl-verify-server-cert                TRUE
user                                  (No default value)
verbose                               (No default value)
Options (60)
OptionDescriptionSource
--print-defaultsPrint the program argument list and exit.help
--no-defaultsDon't read default options from any option file.help
--defaults-file #Only read default options from the given file #.help
--defaults-extra-file #Read this file after the global files are read.help
-?, --helpDisplay this help and exit.help
-a, --auto-generate-sqlGenerate SQL where not supplied by file or command line.help
--auto-generate-sql-add-autoincrementAdd an AUTO_INCREMENT column to auto-generated tables.help
--auto-generate-sql-execute-number #Set this number to generate a set number of queries to run.help
--auto-generate-sql-guid-primaryAdd GUID based primary keys to auto-generated tables.help
--auto-generate-sql-load-type nameSpecify test load type: mixed, update, write, key, or read;help
--auto-generate-sql-secondary-indexes #Number of secondary indexes to add to auto-generated tables.help
--auto-generate-sql-unique-query-number #Number of unique queries to generate for automatic tests.help
--auto-generate-sql-unique-write-number #Number of unique queries to generate for auto-generate-sql-write-number.help
--auto-generate-sql-write-number #Number of row inserts to perform for each thread (default is 100).help
--character-sets-dir nameDirectory for character set files.help
--commit #Commit records every X number of statements.help
-C, --compressUse compression in server/client protocol.help
-c, --concurrency nameNumber of clients to simulate for query to run.help
--create nameFile or string to use create tables.help
--create-schema nameSchema to run tests in.help
--csv nameGenerate CSV output to named file or to stdout if no file is named.help
-#, --debug #This is a non-debug version.help
--debug-checkCheck memory and open file usage at exit.help
-T, --debug-infoPrint some debug info at exit.help
-F, --delimiter nameDelimiter to use in SQL statements supplied in file or command line.help
--detach #Detach (close and reopen) connections after X number of requests.help
-e, --engine nameComma separated list of storage engines to use for creating the table.help
-h, --host nameConnect to host.help
-i, --iterations #Number of times to run the tests.help
--no-dropDo not drop the schema after the test.help
-x, --number-char-cols nameNumber of VARCHAR columns to create in table if specifying --auto-generate-sql.help
-y, --number-int-cols nameNumber of INT columns to create in table if specifyinghelp
--number-of-queries #Limit each client to this number of queries (this is not exact).help
--only-printDo not connect to the databases, but instead print out what would have been done.help
-p, --password namePassword to use when connecting to server.help
--plugin-dir nameDirectory for client-side plugins.help
-P, --port #Port number to use for connection.help
--post-query nameQuery to run or file containing query to execute after tests have completed.help
--post-system namesystem() string to execute after tests have completed.help
--pre-query nameQuery to run or file containing query to execute before running tests.help
--pre-system namesystem() string to execute before running tests.help
--protocol nameThe protocol to use for connection (tcp, socket, pipe).help
-q, --query nameQuery to run or file containing query to run.help
-s, --silentRun program in silent mode - no output.help
-S, --socket nameThe socket file to use for connection.help
--sslEnable SSL for connection (automatically enabled with other flags).help
--ssl-ca nameCA file in PEM format (check OpenSSL docs, implieshelp
--ssl-capath nameCA directory (check OpenSSL docs, implies --ssl).help
--ssl-cert nameX509 cert in PEM format (implies --ssl).help
--ssl-cipher nameSSL cipher to use (implies --ssl).help
--ssl-key nameX509 key in PEM format (implies --ssl).help
--ssl-crl nameCertificate revocation list (implies --ssl).help
--ssl-crlpath nameCertificate revocation list path (implies --ssl).help
--tls-version nameTLS protocol version for secure connection.help
--ssl-fp nameServer certificate fingerprint (implies --ssl).help
--ssl-fplist nameFile with accepted server certificate fingerprints, one per line (implies --ssl).help
--ssl-verify-server-certVerify server's certificate to prevent man-in-the-middle attacks (Defaults to on;help
-u, --user nameUser for login if not current user.help
-v, --verboseMore verbose output;help
-V, --versionOutput version information and exit.help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.