About MariaDB Connector/C

Latest Releases

About

MariaDB Connector/C is used to connect applications developed in C/C++ to MariaDB and MySQL databases.The client library is LGPL licensed.

Parts of MariaDB Connector/C are derived from PHP's mysqlnd extension and the original LGPL MySQL client library for MySQL 3.23. The rest of the code is written by developers at MariaDB Corporation Ab.

Integration with MariaDB Server

In MariaDB 10.2 and later, MariaDB Connector/C is distributed with MariaDB Server packages. Eventually, it will completely replace the functionality that has traditionally been performed by libmysqlclient in those packages. Currently, MariaDB Connector/C has replaced libmysqlclient as the client library for client utilities that are distributed with MariaDB Server. See MDEV-9055 for more information.

MariaDB Connector/C Release Series included with MariaDB Server Release Series

The following table shows which MariaDB Connector/C release series is included with each MariaDB Server release series.

MariaDB Connector/C Releases included with MariaDB Server Releases

The following tables show which MariaDB Connector/C release is included with each MariaDB Server release.

MariaDB 10.9

MariaDB 10.8

MariaDB 10.7

MariaDB 10.6

MariaDB 10.5

MariaDB 10.4

MariaDB 10.3

MariaDB 10.2

Installing MariaDB Connector/C

MariaDB Connector/C packages can be downloaded by selecting your desired version from the following page:

• https://downloads.mariadb.org/connector-c/

MariaDB Connector/C packages can also be downloaded by selecting C/C++ connector as the Product on the following page:

• https://mariadb.com/downloads/#connectors

See the instructions below for information on how to install the MariaDB Connector/C package for your operating system.

Installing MariaDB Connector/C on Windows

To install MariaDB Connector/C on Windows, we distribute MSI packages. The MSI installation process is fairly straightforward. Both 32-bit and 64-bit MSI packages are available.

Installing MariaDB Connector/C on Linux

MariaDB Connector/C is distributed in binary tarballs on Linux.

Installing with a Package Manager

Since MariaDB Connector/C is now integrated with MariaDB Server, it can also be installed via a package manager on Linux. In order to do so, your system needs to be configured to install from one of the MariaDB repositories. The repository needs to be configured for MariaDB 10.2 or later.

You can configure your package manager to install it from MariaDB Corporation's MariaDB Package Repository by using the MariaDB Package Repository setup script.

You can also configure your package manager to install it from MariaDB Foundation's MariaDB Repository by using the MariaDB Repository Configuration Tool.

Installing with yum/dnf

On RHEL, CentOS, Fedora, and other similar Linux distributions, it is highly recommended to install the relevant RPM package from MariaDB's repository using yum or dnf. Starting with RHEL 8 and Fedora 22, yum has been replaced by dnf, which is the next major version of yum. However, yum commands still work on many systems that use dnf. For example:

sudo yum install MariaDB-shared

If you want to build applications with MariaDB Connector/C, then you will also need to install the development package. For example:

sudo yum install MariaDB-devel

Installing with apt-get

On Debian, Ubuntu, and other similar Linux distributions, it is highly recommended to install the relevant DEB package from MariaDB's repository using apt-get. For example:

sudo apt-get install libmariadb3

If you want to build applications with MariaDB Connector/C, then you will also need to install the development package. For example:

sudo apt-get install libmariadb-dev

Installing with zypper

On SLES, OpenSUSE, and other similar Linux distributions, it is highly recommended to install the relevant RPM package from MariaDB's repository using zypper. For example:

sudo zypper install MariaDB-shared

If you want to build applications with MariaDB Connector/C, then you will also need to install the development package. For example:

sudo zypper install MariaDB-devel

Installing MariaDB Connector/C from Source

See Building Connector/C From Source for information on how to build MariaDB Connector/C from source.

API - Function Reference

MariaDB Connector/C has exactly the same API as the MySQL Connector/C for MySQL 5.5

The function reference is available at:

• MariaDB Client Library for C API Functions
• MariaDB Client Library for C API Prepared Statement Functions

Configuring MariaDB Connector/C with Option Files

Just like MariaDB Server and libmysqlclient, MariaDB Connector/C can also read configuration options from client option groups in option files.

See Configuring MariaDB Connector/C with Option Files for more information.

Known Bugs and Limitations

• double to string conversion for prepared statements doesn't work correctly
• Connector 3.0.7 and below doesn't support the MySQL 8.0 default authentication protocol, caching_sha2_password. This protocol should be supported in Connector/C 3.0.8 and above.

Reporting Bugs

If you find a bug, please report it via the CONC project on MariaDB's Jira bug tracker.

Source Code

The source code is available at the mariadb-connector-c repository on GitHub.

License

GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

For licensing questions, see the Licensing FAQ.