mariadb\_cancel(3) MariaDB Connector/C mariadb\_cancel(3)

## [Name](#Name)

mariadb\_cancel - Immediately aborts a connection

## [Synopsis](#Synopsis)

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

## [Description](#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)**](/man/os/mariadb-13.1/mysql_close.3) must be called. mariadb\_cancel() is useful to break long queries in situations where sending KILL is not possible.

## [Parameter](#Parameter)

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

## [Return value](#Return_value)

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

## [History](#History)

mariadb\_cancel() was added in Connector/C 3.0

Version 3.4

---

Document: mariadb_cancel(3) from mariadb-13.1 13.1.1-r2 (Chainguard OS)