mysql_shutdown

mysql_shutdown sends a shutdown request to the MariaDB server over the current connection, requiring the SHUTDOWN privilege for the authenticated user.

Syntax

int mysql_shutdown(MYSQL * mysql,
  enum mysql_enum_shutdown_level);

Parameters

• mysql - a mysql handle, which was previously allocated by mysql_init() or mysql_real_connect().

• mysql_enum_shutdown_level - currently only one shutdown level, SHUTDOWN_DEFAULT is supported.

Description

Sends a shutdown message to the server. To shut down the database server, the user for the current connection must have SHUTDOWN privileges.

Return Value

Returns zero on success, non-zero on failure.

See Also

• mysql_kill()

_{This page is: Copyright © 2026 MariaDB. All rights reserved.}