Documentation Home
MySQL 5.6 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 31.6Mb
PDF (A4) - 31.6Mb
PDF (RPM) - 30.5Mb
HTML Download (TGZ) - 7.6Mb
HTML Download (Zip) - 7.6Mb
HTML Download (RPM) - 6.5Mb
Man Pages (TGZ) - 170.7Kb
Man Pages (Zip) - 279.9Kb
Info (Gzip) - 3.0Mb
Info (Zip) - 3.0Mb
Excerpts from this Manual

MySQL 5.6 Reference Manual  /  ...  /  mysqlaccess — Client for Checking Access Privileges

4.6.7 mysqlaccess — Client for Checking Access Privileges


This utility is deprecated in MySQL 5.6.17 and removed in MySQL 5.7

mysqlaccess is a diagnostic tool that Yves Carlier has provided for the MySQL distribution. It checks the access privileges for a host name, user name, and database combination. mysqlaccess checks access using only the user and db tables. It does not check table, column, or routine privileges specified in the tables_priv, columns_priv, or procs_priv tables.

Invoke mysqlaccess like this:

shell> mysqlaccess [host_name [user_name [db_name]]] [options]

When mysqlaccess runs, it loads and executes the contents of its configuration file, mysqlaccess.conf. mysqlaccess looks for the configuration file in these locations, in order:

  • The directory named by the SYSCONFDIR option to CMake when MySQL was built. By default, this is the etc directory located under the compiled-in installation directory.

  • The /etc directory.

mysqlaccess supports the options shown in the following table.

Table 4.17 mysqlaccess Options

--briefGenerate reports in single-line tabular format
--commitCopy the new access privileges from the temporary tables to the original grant tables
--copyReload the temporary grant tables from original ones
--dbSpecify the database name
--debugSpecify the debug level
--helpDisplay help message and exit
--hostConnect to MySQL server on given host
--howtoDisplay some examples that show how to use mysqlaccess
--old_serverAssume that the server is an old MySQL server (prior to MySQL 3.21)
--passwordPassword to use when connecting to server
--planDisplay suggestions and ideas for future releases
--previewShow the privilege differences after making changes to the temporary grant tables
--relnotesDisplay release notes
--rhostConnect to MySQL server on given host
--rollbackUndo the most recent changes to the temporary grant tables.
--spasswordPassword to use when connecting to server as the superuser
--superuserSpecify the user name for connecting as the superuser
--tableGenerate reports in table format
--userMySQL user name to use when connecting to server
--versionDisplay version information and exit

If your MySQL distribution is installed in some nonstandard location, you must change the location where mysqlaccess expects to find the mysql client. Edit the mysqlaccess script at approximately line 18. Search for a line that looks like this:

$MYSQL     = '/usr/local/bin/mysql';    # path to mysql executable

Change the path to reflect the location where mysql actually is stored on your system. If you do not do this, a Broken pipe error will occur when you run mysqlaccess.

User Comments
Sign Up Login You must be logged in to post a comment.