5.4.43 mysql_kill()

int
mysql_kill(MYSQL *mysql,
           unsigned long pid)

Description

Note

mysql_kill() is deprecated and is subject to removal in a future version of MySQL. Instead, use mysql_real_query() or mysql_query() to execute a KILL statement.

Asks the server to kill the thread specified by pid.

mysql_kill() cannot handle values larger than 32 bits; to guard against killing the wrong thread, the function raises CR_INVALID_CONN_HANDLE if given an ID larger than 32 bits.

Return Values

Zero for success. Nonzero if an error occurred.

Errors

• CR_COMMANDS_OUT_OF_SYNC

  Commands were executed in an improper order.

• CR_INVALID_CONN_HANDLE

  The pid was larger than 32 bits.

• 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.