---
name: "mariadb_cancel"
section: "3"
platform: "linux"
package: "mariadb"
version: "13.0.2-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/mariadb_cancel"
---

# mariadb\_cancel(3)

### Name

mariadb\_cancel - Immediately aborts a connection

### Synopsis

-

  ```
  #include <mysql.h>
  int mariadb_cancel(MYSQL * mysql);
  ```

### Description

Immediately aborts a connection by making all subsequent read/write operations fail. `mariadb_cancel()` does not invalidate memory used for `mysql` structure, nor close any communication channels. To free the memory, **[mysql\_close(3)](/mysql_close/3.md)** must be called. `mariadb_cancel()` is useful to break long queries in situations where sending KILL is not possible.

### Parameter

`mysql` - mysql handle, which was previously allocated by **[mysql\_init(3)](/mysql_init/3.md)** and connected by **[mysql\_real\_connect(3)](/mysql_real_connect/3.md)**.

### Return value

Returns zero on success or a non-zero value on error.

### History

`mariadb_cancel()` was added in Connector/C 3.0