25.2.3.62. mysql_shutdown()
int mysql_shutdown(MYSQL *mysql, enum
enum_shutdown_level shutdown_level)
Description
Asks the database server to shut down. The connected user must
have SHUTDOWN privileges. MySQL
5.1 servers support only one type of shutdown;
shutdown_level must be equal to
SHUTDOWN_DEFAULT. Additional shutdown
levels are planned to make it possible to choose the desired
level. Dynamically linked executables which have been compiled
with older versions of the libmysqlclient
headers and call mysql_shutdown() need to
be used with the old libmysqlclient dynamic
library.
The shutdown process is described in
Section 5.2.6, “The MySQL Server Shutdown Process”.
Return Values
Zero for success. Non-zero if an error occurred.
Errors
-
CR_COMMANDS_OUT_OF_SYNC
Commands were executed in an improper order.
-
CR_SERVER_GONE_ERROR
The MySQL server has gone away.
-
CR_SERVER_LOST
The connection to the server was lost during the query.
-
CR_UNKNOWN_ERROR
An unknown error occurred.
