-
--help
, -?
Display a help message and exit.
-
--auto-rehash
Enable automatic rehashing. This option is on by default,
which enables table and column name completion. Use
--skip-auto-rehash
to disable rehashing.
That causes mysql to start faster, but
you must issue the rehash
command if
you want to use table and column name completion.
-
--batch
, -B
Print results using tab as the column separator, with each
row on a new line. With this option,
mysql does not use the history file.
-
--character-sets-dir=path
The directory where character sets are installed. See
Section 5.10.1, “The Character Set Used for Data and Sorting”.
-
--column-names
Write column names in results.
-
--compress
, -C
Compress all information sent between the client and the
server if both support compression.
-
--database=db_name
,
-D db_name
The database to use. This is useful primarily in an option
file.
-
--debug[=debug_options
]
,
-#
[debug_options
]
Write a debugging log. The
debug_options
string often is
'd:t:o,file_name
'
.
The default is
'd:t:o,/tmp/mysql.trace'
.
-
--debug-info
, -T
Print some debugging information when the program exits.
-
--default-character-set=charset_name
Use charset_name
as the default
character set. See Section 5.10.1, “The Character Set Used for Data and Sorting”.
-
--delimiter=str
Set the statement delimiter. The default is the semicolon
character (‘;
’).
-
--execute=statement
,
-e statement
Execute the statement and quit. The default output format
is like that produced with --batch
. See
Section 4.3.1, “Using Options on the Command Line”, for some examples.
-
--force
, -f
Continue even if an SQL error occurs.
-
--host=host_name
,
-h host_name
Connect to the MySQL server on the given host.
-
--html
, -H
Produce HTML output.
-
--ignore-spaces
, -i
Ignore spaces after function names. The effect of this is
described in the discussion for the
IGNORE_SPACE
SQL mode (see
Section 5.2.5, “The Server SQL Mode”).
-
--line-numbers
Write line numbers for errors. Disable this with
--skip-line-numbers
.
-
--local-infile[={0|1}]
Enable or disable LOCAL
capability for
LOAD DATA INFILE
. With no value, the
option enables LOCAL
. The option may be
given as --local-infile=0
or
--local-infile=1
to explicitly disable or
enable LOCAL
. Enabling
LOCAL
has no effect if the server does
not also support it.
-
--named-commands
, -G
Enable named mysql commands.
Long-format commands are allowed, not just short-format
commands. For example, quit
and
\q
both are recognized. Use
--skip-named-commands
to disable named
commands. See Section 8.5.2, “mysql Commands”.
-
--no-auto-rehash
, -A
Deprecated form of -skip-auto-rehash
. See
the description for --auto-rehash
.
-
--no-beep
, -b
Do not beep when errors occur.
-
--no-named-commands
, -g
Disable named commands. Use the \*
form
only, or use named commands only at the beginning of a
line ending with a semicolon
(‘;
’).
mysql starts with this option
enabled by default. However, even
with this option, long-format commands still work from the
first line. See Section 8.5.2, “mysql Commands”.
-
--no-pager
Deprecated form of --skip-pager
. See the
--pager
option.
-
--no-tee
Do not copy output to a file.
Section 8.5.2, “mysql Commands”, discusses tee files
further.
-
--one-database
, -o
Ignore statements except those for the default database
named on the command line. This is useful for skipping
updates to other databases in the binary log.
-
--pager[=command
]
Use the given command for paging query output. If the
command is omitted, the default pager is the value of your
PAGER
environment variable. Valid
pagers are less,
more, cat [>
filename], and so forth. This option works only
on Unix. It does not work in batch mode. To disable
paging, use --skip-pager
.
Section 8.5.2, “mysql Commands”, discusses output paging
further.
-
--password[=password
]
,
-p[password
]
The password to use when connecting to the server. If you
use the short option form (-p
), you
cannot have a space between the
option and the password. If you omit the
password
value following the
--password
or -p
option
on the command line, you are prompted for one.
Specifying a password on the command line should be
considered insecure. See
Section 5.8.6, “Keeping Your Password Secure”.
-
--port=port_num
,
-P port_num
The TCP/IP port number to use for the connection.
-
--prompt=format_str
Set the prompt to the specified format. The default is
mysql>
. The special sequences that
the prompt can contain are described in
Section 8.5.2, “mysql Commands”.
-
--protocol={TCP|SOCKET|PIPE|MEMORY}
The connection protocol to use.
-
--quick
, -q
Do not cache each query result, print each row as it is
received. This may slow down the server if the output is
suspended. With this option, mysql does
not use the history file.
-
--raw
, -r
Write column values without escape conversion. Often used
with the --batch
option.
-
--reconnect
If the connection to the server is lost, automatically try
to reconnect. A single reconnect attempt is made each time
the connection is lost. To suppress reconnection behavior,
use --skip-reconnect
.
-
--safe-updates
,
--i-am-a-dummy
, -U
Allow only those UPDATE
and
DELETE
statements that specify which
rows to modify by using key values. If you have set this
option in an option file, you can override it by using
--safe-updates
on the command line. See
Section 8.5.4, “mysql Tips”, for more information about
this option.
-
--secure-auth
Do not send passwords to the server in old (pre-4.1.1)
format. This prevents connections except for servers that
use the newer password format.
-
--show-warnings
Cause warnings to be shown after each statement if there
are any. This option applies to interactive and batch
mode.
-
--sigint-ignore
Ignore SIGINT
signals (typically the
result of typing Control-C).
-
--silent
, -s
Silent mode. Produce less output. This option can be given
multiple times to produce less and less output.
-
--skip-column-names
, -N
Do not write column names in results.
-
--skip-line-numbers
, -L
Do not write line numbers for errors. Useful when you want
to compare result files that include error messages.
-
--socket=path
,
-S path
For connections to localhost
, the Unix
socket file to use, or, on Windows, the name of the named
pipe to use.
-
--table
, -t
Display output in table format. This is the default for
interactive use, but can be used to produce table output
in batch mode.
-
--tee=file_name
Append a copy of output to the given file. This option
does not work in batch mode. in
Section 8.5.2, “mysql Commands”, discusses tee files
further.
-
--unbuffered
, -n
Flush the buffer after each query.
-
--user=user_name
,
-u user_name
The MySQL username to use when connecting to the server.
-
--verbose
, -v
Verbose mode. Produce more output about what the program
does. This option can be given multiple times to produce
more and more output. (For example, -v -v
-v
produces table output format even in batch
mode.)
-
--version
, -V
Display version information and exit.
-
--vertical
, -E
Print query output rows vertically (one line per coluumn
value). Without this option, you can specify vertical
output for individual statements by terminating them with
\G
.
-
--wait
, -w
If the connection cannot be established, wait and retry
instead of aborting.
-
--xml
, -X
Produce XML output.